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.

You must have completed the following tasks:

Read and completed the prerequiste tasks listed in Prerequisite tasks for recording iOS tests.
Ran the UI Test Agent on the default port to connect to your mobile devices or simulators.

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.

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.

Note: If you recorded any user action on the container instead of the actual control due to an overlay of an element, you must manually modify the test step to use the actual control before playing back the test.

If the port number of the computer on which you run the UI Test Agent is not the default port, then you must specify the port number. To specify the port number, you must perform the following tasks:

Click Windows > Preferences > Test Execution > UI Test Playback > Mobile Device tab.
Select theHost check box.
Enter the port number in the Port field.

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

Go to the UI Test perspective in Test UI.
Click the New Test from Recording icon in the toolbar and select Mobile Test.

The New Mobile Test From Recording dialog is displayed.
Select a directory to save the test.
Enter the name of the test in the Test name field, and click Next.
The Select mobile application page displays the list of all mobile applications that you configured in the Application Configuration page.
Select the iOS application that you want to test.

Note: The real devices or the simulators that are connected to the computer are listed and you can select any device or simulator from the list.
Select the device from the Select mobile device list.

Click Next, and then click Finish.

The application is displayed in a virtual client of both, the real mobile device or the emulator.

The recording is started in a web browser.

You can perform the actions on the selected mobile application by using the virtual client. The actions that you perform are imitated on the device or emulator and are captured as test steps in the test.

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:


Option	Action when clicked
Stop recording	Stops the recording and generates the mobile test recording
Screen lock	Performs the lock screen action on the mobile device or simulator
Refresh	Refreshes the virtual client if the actions that you perform on the virtual client is not synchronized with the mobile device
Volume up	Increases the volume on the mobile device or simulator
Volume down	Decreases the volume on the mobile device or simulator
Home	Navigates to the home screen

Click Stop recording.
The recording of the test is stopped and the browser window is closed. The Test Generation dialog is displayed in the UI Test perspective.

You have recorded a test for an iOS mobile application.

You can perform any of the following tasks:

You can click Open Test in the Test Generation dialog to view the recorded test and edit the test, if you want to change or add the test steps or verification points. See Editing a mobile test.
You can run the recorded test. See Running mobile tests for iOS mobile applications.