Running mobile tests on an iOS device or simulator connected to a computer that runs HCL OneTest UI

You can run mobile tests on iOS mobile devices or simulators that are connected to a computer that runs HCL OneTest UI.

Before you begin

You must have completed the following tasks:
  • Recorded mobile tests. See Recording mobile tests for iOS applications.
  • Installed the Xcode and the CLI tools for Xcode on the computer that you want to use for testing iOS mobile applications.
  • Installed the iOS mobile application that you want to test on the iOS device or simulator.
  • Connected and started the iOS device that you want to use for testing iOS mobile applications.
  • Ensured that you started the Execution Agent and it is running on the computer that runs Rational® Functional Tester.
  • Entered the following information in the Mobile Device tab if you want to test real devices on the local computer:
    • Apple Team ID
    • Port
      Note: This is required only when the port is not the default port.
    • iOS Device

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 iOS Device checkbox in the iOS Device panel, and then enter the name of the iOS device or simulator that is connected to the computer in the iOS Device field.

      The Platform Version field is enabled.

    4. Enter the version of the platform in the Platform Version field.
    5. Select the Apple Team ID checkbox in the iOS Device panel, and then enter the name of the Apple Developer Team ID provided by Apple in the Apple Team ID field.
    6. Enter the role that you are assigned by the Apple Developer Team in the Role field.
    7. 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 simulator to play back the test for each mobile test.
  6. Select the mobile device or simulator 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 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.