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:

- You must have an instrumented version of the application under
test. (See Lesson 2: Preparing the application under test for testing. This version of
the AUT is generated on a Macintosh computer by using the rtwBuildXcode.sh build
script. Typically, you will obtain the instrumented AUT from a developer.
- If you are running the test workbench on
a Windows computer, the iOS
device must be running iOS 7 or later. On a Macintosh computer, any
iOS version later than iOS 6 can be used.
To
install the instrumented iOS application on an iOS device:
- Verify that Apple iTunes is installed. iTunes is included
by default on Macintosh computers but must be downloaded and installed
manually on Windows computers.
- 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.
- 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
, as shown below: 
- 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.