Starting March 27, 2025, we recommend using android-latest-release instead of aosp-main to build and contribute to AOSP. For more information, see Changes to AOSP.
Stay organized with collections
Save and categorize content based on your preferences.
Android UIConductor
(UICD) is a tool that lets users create testing workflows by recording UI
interactions and validating the screen content. OmniLab ATS supports running
tests exported from UICD.
Setup
To run UICD tests with OmniLab ATS, you must import the UIConductor
configuration, which contains the necessary test suites and device actions.
Open Settings and navigate to the Config Sets tab.
Click Import and select the UIConductor config set. You might need to
authorize OmniLab ATS to access Google Cloud Storage.
Figure 1. Importing the UIConductor configuration
Run tests
Schedule a UIConductor Test test run (under Test Suites >
UIConductor). This test suite can be used to run any exported UICD tests.
Figure 2. Scheduling a UICD test run
Add the Install UIConductor to install the necessary UICD drivers.
Figure 3. Adding the required device action
Select the UICD tests to run. By default, the file is expected to be a zip
archive containing JSON test files exported from UICD.
Figure 4. Selecting the test files to execute
Start the test run and wait for completion. Screenshots, XML dumps, and logs
generated during the run will be available in the output files.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-08-29 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[],[],null,["# Run UIConductor tests with OmniLab ATS\n\n[Android UIConductor](https://github.com/google/android-uiconductor)\n(UICD) is a tool that lets users create testing workflows by recording UI\ninteractions and validating the screen content. OmniLab ATS supports running\ntests exported from UICD.\n| **Note:** Avoid sharing the same host machine for both OmniLab ATS and UICD as this could introduce unnecessary conflict.\n\nSetup\n-----\n\nTo run UICD tests with OmniLab ATS, you must import the **UIConductor**\nconfiguration, which contains the necessary test suites and device actions.\n\n1. Open **Settings** and navigate to the **Config Sets** tab.\n\n2. Click **Import** and select the **UIConductor** config set. You might need to\n authorize OmniLab ATS to access Google Cloud Storage.\n\n **Figure 1.** Importing the UIConductor configuration\n\nRun tests\n---------\n\n1. Schedule a **UIConductor Test** test run (under **Test Suites** \\\u003e\n **UIConductor**). This test suite can be used to run any exported UICD tests.\n\n **Figure 2.** Scheduling a UICD test run\n | **Note:** UICD global variables can be set by adding `--global-variables default \"`\u003cvar translate=\"no\"\u003ekey=value,key2=value2,...\u003c/var\u003e`\"` to the command line. Do not include the $ prefix in the key names.\n2. Add the **Install UIConductor** to install the necessary UICD drivers.\n\n **Figure 3.** Adding the required device action\n3. Select the UICD tests to run. By default, the file is expected to be a zip\n archive containing JSON test files exported from UICD.\n\n **Figure 4.** Selecting the test files to execute\n | **Note:** To export your test files from UICD, either right-click a test case or folder and **Download** or click **Project** \\\u003e **Export Zip** to download all test cases marked as \"top level.\"\n4. Start the test run and wait for completion. Screenshots, XML dumps, and logs\n generated during the run will be available in the output files."]]
