Running compound tests on Android devices or emulators connected to a computer that runs DevOps Test UI

You can run compound tests that contain mobile tests on Android mobile devices or emulators that are connected to a computer that runs IBM® DevOps Test UI (Test UI).

You must have completed the following tasks:

Recorded mobile tests. See Recording mobile tests for Android applications.
Created a compound test that contains mobile tests, see Creating a compound test.
Installed the Android SDK on the computer that you want to use for testing Android mobile applications.
Set or changed the value of the ANDROID_HOME environment variable on the computer that you want to use for testing Android mobile applications for the following operating systems:
- Windows operating systems, see Setting or changing the ANDROID_HOME path in Windows operating systems.
- Linux operating systems, see Setting or changing the ANDROID_HOME path in Linux operating systems.
- Mac operating systems, see Setting or changing the ANDROID_HOME path in Mac operating systems.
Installed the Android application that you want to test on the Android device or emulator. You can connect the Android device to the computer through a USB cable.
Connected and started the Android device or emulator to the computer that you want to use for testing Android mobile applications.

When you run mobile tests, you can enable Test UI to collect metrics for certain parameters of the resources used by the mobile applications or devices. You can select the Resource Monitoring option and set the time intervals for the collection of the metrics during the test run.

Important: The collection of Resource Monitoring metrics and display of the data graphically is supported only when you run a compound test on a single device.

Open the UI Test perspective in Test UI if it is not already open.
Select the compound test that contains the mobile tests from the Test Navigator pane.
The test window is displayed.
Click the Run Compound Test icon.
The Run Configuration dialog is displayed.
Perform any of the following actions:
- To run mobile tests that are in the compound test on a specific device or emulator, go to step 4.
- To simultaneously run the mobile tests that are in the compound test on multiple devices or emulators, go to step 5.
Clear the Run on several devices and browsers in parallel option, if selected, and then perform the following actions:
1. Click the Run using option for each test, to view the mobile devices or emulators that are connected.
2. Select a device or emulator from the list.
3. Select the device or emulator for each of the tests by repeating the action in Step 4.a and Step 4.b.
4. Click Next.
  
  The Advanced Playback Options dialog is displayed.
  Note: There is no action to be performed by you for mobile tests.
5. Go to step 6.
Select the Run on several devices and browsers in parallel option, if it is not already selected.

Mobile devices and emulators that are connected to the computer are displayed.

You must perform the following steps:
1. Select the devices on which you want to run the compound test.
2. Click Next.
  
  The Advanced Playback Options dialog is displayed.
  
  Note: There is no action to be performed by you for mobile tests.
3. Go to step 6.
Click Next.

The Performance Measurement dialog is displayed.
Perform the following steps if you want Test UI to collect the Resource Monitoring metrics during the test run:
1. Select the Resource Monitoring option.
2. Set the interval to collect the metrics by entering a number in the Polling interval field.
  
  Note: The minimum value that you can enter in the Polling interval field is 1000 milliseconds.
Click Finish.

The test runs on the selected mobile devices or emulators. The test result is displayed as a unified report in Test UI.

You can view the unified report for the mobile tests and choose to export the unified report. See Unified reports.

If you opted to collect the Resource Monitoring metrics, you can view the metrics displayed graphically in the UI Test Statistical report. You can analyze the Resource Monitoring metrics to manage the resources of the device or the mobile application under test. See UI Test Statistical report.