Recording tests from the iOS mobile test client

Mobile tests are typically created by recording a session on the mobile device or simulator that runs the app being tested. At the end of the recording session, you close the app and the IBM® Rational® Test Workbench Mobile Client uploads the recorded session to the IBM Rational Test Workbench Mobile Test Edition, where it is used to generate a test.

Before you begin

To record tests:
  • The mobile test client must be running on an iOS device or simulator and be connected to . For more information, see Configuring the iOS mobile test client on the iOS Simulator if you do your testing in the iOS simulator using the native mobile test client. If you do your testing on a simulator or device using the browser-based client, you must type the Workbench URL in the Safari or Chrome browser on your device, or in the Safari browser on your simulator to run the client:

    http://Workbench_URL:port/mobile

    Carefully read the iOS testing overview for more details.
  • Native applications under test must be instrumented, and then pushed to the test workbench and simulator or installed on a device. For more details, see Instrumenting iOS applications on the iOS Simulator and Instrumenting iOS applications for each use case.
  • If you are testing web applications, the IBM Rational Test Workbench Mobile Web Recorder is required to record user actions. You must download it from the Apple App Store on to your mobile device.

About this task

This task applies to testing iOS native applications, hybrid applications or web applications.

With the mobile test client for iOS, GPS hardware actions are supported.

Procedure

To record a session on the mobile device or simulator from an iOS app:

  1. In the IBM Rational Test Workbench Mobile Client, tap Manage applications to record a test for a native application, or tap Manage web applications to record a test for a web application.
  2. Tap the application for which a test must be recorded. You might have to refresh the list to see the application. Then tap Record.
  3. When the app starts, you can interact with the device using the iOS device or simulator. All your actions on the device and responses from the app are recorded.
  4. To end the recording, tap Home. The recording is uploaded to the test workbench. Depending on the size of the recording, the upload might take a few seconds to several minutes. Recordings are displayed in the test navigator under Mobile Incoming Recordings with a name and a timestamp.
    Note: If your session involves switching between apps, including multiple apps, a new recording is uploaded each time you switch apps. This action produces multiple recording logs in the Mobile Incoming Recordings folder. You can combine these multiple recordings to generate a single test.
  5. In the test workbench Test Navigator, expand Mobile Incoming Recordings, right-click a recording, and select Generate Test. Alternatively, click the link in the message that warns you that there is a new incoming recording. The New Test from Incoming Recordings window opens.
  6. Select a project folder and a name for the new test. If necessary, you can click New > Test Workbench Project to create a new project folder.
  7. Optional: If you want to generate a test with multiple recordings (for example, if your session involves switching between multiple apps), click Next and select the recordings that you want to use to generate the test.
  8. Click Finish and Open test. The test editor opens in Rational Test Workbench and displays the generated test.

Feedback