Recording mobile tests for iOS applications

You can record a mobile test to capture the actions that you perform on iOS applications. The actions are captured as test steps to a mobile test recording.

Before you begin

You must perform the following tasks:
  • Read and completed the prerequiste tasks listed in Prerequisite tasks for recording iOS tests.
  • Run the Appium server on the default port to connect to your mobile devices or simulators.
  • Installed the application under test on your mobile device or simulator.

About this task

After you install the Xcode and the command line tools for Xcode, you can connect the iOS device or simulator to your computer, you can then record the user interface and hardware actions in the iOS application that you want to test.

You can perform the actions that you want to record by using a virtual client of the mobile device. The actions that you perform are captured as test steps in the test recording. You can perform the following actions in the test steps of a mobile test recording:
  • Insert user actions.
  • Insert navigation actions.
  • Assign variables.
  • Insert verification points.
  • Substitute data by using custom code or datasets.

Generally, when you record actions on the iOS application, the controls on the application are identified by using one of the control properties which is a unique identifier for that control. The input fields on the iOS applications are identified by using the Label property also.

If the port number of the computer on which you run the Appium server is not the default port, then you must specify the port number. To specify the port number, you must perform the following tasks:
  1. Click Windows > Preferences > Test Execution > Web UI Playback > Mobile Device tab.
  2. Select the Appium server host check box.
  3. Enter the port number in the Port field.

You can then perform the following steps to record a mobile test on the iOS application.

Procedure

  1. Go to the Web UI Test perspective in Rational® Functional Tester.
  2. Click the New Test from Recording icon in the toolbar and select Mobile Test.

    The New Mobile Test From Recording dialog box is displayed.

  3. Select a directory to save the test.
  4. Enter the name of the test in the Test name field, and click Next.
    The Select mobile application page displays the list of all iOS and Android applications that you configured in the Application Configuration window.
  5. Select the iOS application that you want to test.

    The iOS devices that are connected to the local computer are displayed in the Select mobile list.

  6. Select the mobile device from the Select mobile device list.
  7. Click Finish.
    The application is displayed in a virtual client of the selected mobile device in the browser window, and the recording is started.

    You can perform the actions on the selected mobile application through the virtual client of the actual device or simulator. The actions that you perform on the selected mobile application are displayed live in the virtual client. The test steps are displayed on the Test Steps pane of the virtual client window.

    The following table lists the options of the actions that you can perform in the virtual client of the mobile device or simulator:
    Option Action when clicked
    Stop recording stop mobile recording Stops the recording and generates the mobile test recording
    Screen lock Performs screen lock action Performs the lock screen action on the mobile device or simulator
    Refresh refreshes the virtual client Refreshes the virtual client if the actions that you perform on the virtual client is not synchronized with the mobile device
    Volume up increase volume level Increases the volume on the mobile device or simulator
    Volume down Reduces the volume in the device or emulator Decreases the volume on the mobile device or simulator
    Home Navigates to the home screen Navigates to the home screen
  8. Click Stop recording.
    The test recording stops and the browser window is closed. The Test Generation dialog box is displayed in the Web UI Test perspective.

Results

The mobile test recording is completed.

What to do next

You can click Open Test in the Test Generation dialog box to view the test and edit the test if required.