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 recorded session is uploaded to HCL OneTest™ UI, where it is used to generate a test.

Before you begin

To record tests:
  • The mobile test client must be running and be connected to HCL OneTest UI. To use 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 iOS Simulator. See Testing Web applications on iOS Simulators: overview for details about running the browser-based client.
  • For testing Web applications, the mobile web recorder is required to record user actions. You can download it from the Apple App Store on to your mobile device. If you are testing with the iOS Simulator, you must install the mobile web recorder manually because the iOS Simulator does not have access to the Apple App Store. See Installing the mobile web recorder on the iOS Simulator for details.

About this task

With the HCL OneTest UI for iOS, GPS hardware actions are supported.


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

  1. In the mobile test client, 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 HCL OneTest UI. 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 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 HCL OneTest UI and displays the generated test.