Running mobile tests on an Android device or emulator connected to a remote agent computer

You can run mobile tests on an Android device or emulator that is connected to a remote agent computer.

Before you begin

You must have completed the following tasks:

About this task

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.

Procedure

  1. Open the UI Test perspective in Test UI if it is not already open.
  2. Select the mobile test from the Test Navigator pane.

    The test window is displayed.

  3. Click Window > Preferences > Test > Test Execution > UI Test Playback.

    The UI Test Playback pane is displayed.

  4. Click the Mobile Device tab, and then perform the following steps:
    1. Select the Host check box in the UI Test Agent panel, and then enter the IP address of the remote computer in the Host field.
      Note: The port in use by the UI Test Agent on the computer is automatically populated in the Port field.
    2. Select the Android Device check box in the Android Device panel, and then enter the name of the Android device or emulator that is connected to the computer in the Android Device field.

      The Is real device check box is enabled.

    3. Perform any of following actions:
      • If you are using an Android device, select the Is real device check box.
      • If you are using an emulator, retain the Is real device check box as deselected or clear the selection, if selected.
    4. Click Apply and Close.
  5. Click the Run Test play back a Web UI test icon.
    The Run Configuration dialog is displayed.
    Note: If you are using a compound test that contains mobile tests, you can specify the mobile device or emulator to play back the test for each mobile test.
  6. Select the mobile device or emulator to play back the test from the Run using list and click Next.
    The Advanced Playback Options dialog is displayed.
    Note: There is no action to be performed by you for mobile tests.
  7. Click Next.

    The Performance Measurement dialog is displayed.

  8. 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.
  9. Click Finish.

Results

The test runs on the Android device or emulator that is connected to the remote computer. The test result is displayed as a unified report in Test UI.

What to do next

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.