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:

Procedure

  1. Open the UI Test perspective in Rational® Functional Tester, 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 Appium server host checkbox, and then enter the IP address of the remote agent computer in the Appium server host field.
    2. Enter the port number that is used to communicate with the Appium server in the Port field.
    3. Select the Android Device checkbox, and then enter the name of the Android device or emulator that is connected to the remote agent computer in the Android Device field.

      The Is real device checkbox is enabled.

    4. Perform any of following actions:
      • If you are using an Android device, select the Is real device checkbox.
      • If you are using an emulator, do not select the Is real device checkbox or clear the selection, if selected.
    5. Click Apply and Close.
  5. Click the Run Test play back a Web UI test icon.
    The Run Configuration dialog box 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 box is displayed.
    Note: There is no action to be performed by you for mobile tests.
  7. Click Finish.

Results

The test runs on the Android device or emulator connected to the remote computer. The test result is displayed as a unified report in Rational® Functional Tester.

What to do next

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