< Previous | Next >

Lesson 3: Installing an instrumented application on an iOS device

In this lesson, you learn how to add an instrumented iOS application to the test workbench and install it on an iOS device. This procedure assumes that you do not have access to the Xcode project that contains the source code for the application under test (AUT). You can use either an Apple Macintosh or a Windows computer. After you install the instrumented application on an iOS device, you can begin testing.

Before you start this lesson, be sure to complete the steps in Lesson 1: Setting up the test environment. Verify that you have started the test workbench, connected at least one iOS device to the USB port of your computer, and that at least one iOS device is listed in the Mobile Devices editor, as shown in the following figure:

To install the instrumented iOS application on an iOS device:

  1. Verify that Apple iTunes is installed. iTunes is included by default on Macintosh computers but must be downloaded and installed manually on Windows computers.
  2. Obtain a copy of the instrumented version of the AUT and add it to a project in the test workbench.

    The instrumented version of the AUT must be generated on a Macintosh computer using the rtwBuildXcode.sh build script. One way to obtain the instrumented application is to ask the person running the rtwBuildXcode.sh script to specify your test workbench in the command line arguments. (See Lesson 2: Preparing the application under test for testing).

    When the script completes, you see the instrumented AUT in the Mobile and Web UI Applications editor and a message on the right that says Incoming applications must be managed to be used in a test. Hit button on the right to manage application..

    Click the incoming application button to add the AUT as a managed application, that is, an application that is managed in an Eclipse project.

  3. From the Mobile and Web UI Applications editor, right-click the application that was added and click Install application on iOS device, or select the application and click the Install application on iOS device icon Install application on iOS device, as shown below:

    Picture of Install application on iOS device icon

  4. From the iOS Device window, select the device on which to install the iOS application and click OK.
The iOS application should now be installed on the device, and you can begin testing.

Lesson checkpoint

In this lesson, you learned one way to install an instrumented version of the AUT on an iOS device. To do this, someone with the source code for the AUT ran the rtwBuildXcode.sh script and specified that the script output, in this case the RmotUICatalogs.zip file, be sent to your test workbench.

If you are part of a team, this process must be repeated for each member of the team. Alternatively, the person instrumenting the AUT can post the RmotUICatalogs.zip file to a shared directory where everyone on the team can access it. Another method is to mail the file to all team members.

After the file becomes available, team members can click the Add applications to list icon Add applications to list in the Mobile and Web UI Applications window to add the AUT to the test workbench, where it can then be installed on an iOS device.

< Previous | Next >

Feedback