commit | 4f63d1cb200ced32bd5b62cb01b1c8d5ffead706 | [log] [tgz] |
---|---|---|
author | Tony de Luna <tonydeluna@chromium.org> | Tue Mar 19 10:40:54 2019 -0700 |
committer | chrome-bot <chrome-bot@chromium.org> | Wed Apr 24 15:51:44 2019 -0700 |
tree | f38ba059a22a71fc46e416ccbaa7243034c55666 | |
parent | b34d50f242c880dad22c11bc616333367e678b38 [diff] |
Enable chrome.automation in autotests and add documentation chrome.automation extension can be used effectively in tests to easily interact with the views hierarchy. This cl enables access to chrome.automation APIs through the autotest_ext extension that is used on autotests. This cl also adds a simple codelab that explains how to set up your device and explore the UI hierarchy and find the UI elements you need. BUG=837343 TEST=tested locally Change-Id: I7534b5e38574bf54b2119a3987649347a067b8c5 Reviewed-on: https://chromium-review.googlesource.com/1531141 Commit-Ready: ChromeOS CL Exonerator Bot <chromiumos-cl-exonerator@appspot.gserviceaccount.com> Tested-by: Tony De Luna <tonydeluna@chromium.org> Reviewed-by: Ruben Zakarian <rzakarian@chromium.org>
Autotest is a framework for fully automated testing. It was originally designed to test the Linux kernel, and expanded by the Chrome OS team to validate complete system images of Chrome OS and Android.
Autotest is composed of a number of modules that will help you to do stand alone tests or setup a fully automated test grid, depending on what you are up to. A non extensive list of functionality is:
A body of code to run tests on the device under test. In this setup, test logic executes on the machine being tested, and results are written to files for later collection from a development machine or lab infrastructure.
A body of code to run tests against a remote device under test. In this setup, test logic executes on a development machine or piece of lab infrastructure, and the device under test is controlled remotely via SSH/adb/some combination of the above.
Developer tools to execute one or more tests. test_that
for Chrome OS and test_droid
for Android allow developers to run tests against a device connected to their development machine on their desk. These tools are written so that the same test logic that runs in the lab will run at their desk, reducing the number of configurations under which tests are run.
Lab infrastructure to automate the running of tests. This infrastructure is capable of managing and running tests against thousands of devices in various lab environments. This includes code for both synchronous and asynchronous scheduling of tests. Tests are run against this hardware daily to validate every build of Chrome OS.
Infrastructure to set up miniature replicas of a full lab. A full lab does entail a certain amount of administrative work which isn't appropriate for a work group interested in automated tests against a small set of devices. Since this scale is common during device bringup, a special setup, called Moblab, allows a natural progressing from desk -> mini lab -> full lab.
See the guides to test_that
and test_droid
:
See the best practices guide, existing tests, and comments in the code.
git clone https://chromium.googlesource.com/chromiumos/third_party/autotest
See the coding style guide for guidance on submitting patches.
You need to run utils/build_externals.py
to set up the dependencies for pre-upload hook tests.