Playing back mobile tests on an Android device or emulator connected to a remote computer

After you record a mobile test, you can play back the recorded mobile test on an Android device or emulator connected to a remote computer that has an Appium server installed and running. You can then generate the test result in your local computer to analyze and evaluate the result.

Before you begin

You must have completed the following tasks:
  • Created a mobile test.
  • The Appium server must be started and running on the remote computer.
  • The Android device or emulator must be started and running on the remote computer.

About this task

You can play back the mobile test only on a single Android device or emulator connected to the remote computer at a time.

Procedure

  1. Go to the Web UI Test perspective in Rational® Functional Tester.
  2. Open the mobile test from the Test Navigator pane.
    The test window is displayed.
  3. Click Run Test play back a Web UI test.
    The Run Configuration dialog box is displayed.
  4. Click Configure Web UI Playback preferences.
    The Web UI Playback pane is displayed in the Preferences window.
    Note: You can also navigate to the Web UI Playback pane by clicking Windows > Preferences > Test > Test Execution > Web UI Playback from the menu bar.
  5. Click the Mobile Device tab and perform the following actions:
    OptionAction
    Appium server host Select the check box and enter the IP address of the remote computer that has the Appium server.

    For example, 10.115.50.62
    Port Enter the port number that is used to communicate with the Appium server.

    For example, 4723
    Android Device Select the check box and enter the name of the emulator or Android device on which you want to play back the test.

    For example, Pixel_API_30
    Is real device Select the check box only if you enter the name of a real Android device in the Android Device field.
  6. Click Apply and Close.
    The Android device or emulator is displayed in the Run using drop-down list in the Run Configuration dialog box.
  7. Select the Android device or emulator from the Run using drop-down list.
  8. Click Next and Finish.
    The play back of the test starts on the Android device or emulator on the remote computer.
    Note: You can also include mobile tests in a Compound Test and run each mobile test on a different Android device or emulator connected to a different remote computer. You can specify the Android device or Emulator on which you want you want to run each mobile test by using the Run using drop-down list in the Run Configuration dialog box of a Compound Test.

Results

The play back of the test completes 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 following details from the unified report of the mobile test:
  • The details and screen capture that are associated with each test step. To view these details, you can click each test step in the Details pane.
  • Android device or emulator on which the test was played back. To view the device or emulator, you can click the icon.
  • Test information such as AUT, host computer, and duration of the test. To view such information, you can click the icon.
  • All the screen captures in a slide show format. To view the screen captures, you can click the icon.