An iOS application must be instrumented before
you can use it to record or play back a test. The application can
be instrumented for testing on an iOS device or an iOS Simulator.
To instrument an application, you must have the Xcode project for
the application under test (AUT) on a Macintosh computer.
Before you begin
- Install IBM® Rational® Test Workbench Mobile Test Edition and ensure that the Extension for Mobile
is selected. For details, see Installing
the product software.
- Install Xcode 4.6 or newer on a Macintosh computer running OS
X v10.8 Mountain Lion or newer. Then, create an Xcode project that
contains the source code of the application under test.
Procedure
- From the test workbench,
select a test project for the application under test (AUT). If necessary,
create a test project by clicking .
- In the test workbench, click the Display
Workbench URL icon
and make note of the Workbench URL. You need the Workbench URL to connect the Macintosh computer
and mobile devices to the test workbench.
- Download
the RTW-iOS-Build-Archive.zip build archive.
The build archive contains scripts that are needed to prepare
the app for testing.
- Open a browser on the Macintosh computer and enter the
Workbench URL in the following format:
http://Workbench_URL:port/mobile
For
example, http://192.0.2.24:7878/mobile
- In the Rational Test Workbench - Mac OS Welcome page,
follow the online instructions to download the archive.
- When the download finishes, unpack the build archive.
The following folders are included in the build archive: browser,
build-script, client, runtime, runtime-bundle.
- Attach an iOS device to a USB port on the Macintosh computer.
Attaching the iOS device via USB allows you to install the
instrumented application on an iOS device at the end of the instrumentation
process. You can attach multiple, compatible iOS devices to the USB
ports.
- Instrument the AUT by running the rtwBuildXcode.sh script.
Instrumentation augments the AUT with code that
allows you to record and play back a test.
You can install
the instrumented AUT on the device automatically by running the script
with the device option.
Note: You must have the
appropriate permissions to run the script. If necessary, run the chmod command
to change permissions.
- On the Macintosh computer, open the Macintosh Terminal
application.
- Type the following command to instrument the AUT and
send it to the test workbench as
an incoming application.
<unpack_dir>/build-script/rtwBuildXcode.sh <.xcodeproj file> <Workbench URL> <options>
where options include device, simu,
and both.
Here is an example of the command
line syntax to instrument an AUT named UICatalog and
send it to the test workbench and
to all USB-connected devices:
./rtwBuildXcode.sh /Users/mario/iOSApps/UICatalog/UICatalog.xcodeproj/ http://9.54.119.136:7878 device
If
you specify the Workbench URL in the command line, the instrumented
application is automatically pushed to the test workbench. If you omit the
Workbench URL, the script generates a .zip file
that you can send to a tester for testing. The tester can add the
AUT to the test workbench by
clicking the Add applications to list icon
in
the Mobile Applications editor.
You can also replace the device option
with simu to install the instrumented AUT in
an iOS Simulator, or use the both option to install
on all USB-connected devices and the iOS Simulator.
For details
about the command line arguments for rtwBuildXcode.sh,
see Command line to launch the rtwBuildXcode.sh script.
- Add the instrumented version of the AUT
to a project in the test workbench.
Incoming applications must be managed to be used in a test.
After you run the rtwBuildXcode.sh shell-script,
do one of the following actions to manage the application:
- Click the incoming application button in the test workbench.
- In the Test Navigator, right-click an incoming application
under Mobile Incoming Applications and click Generate Managed
Application.
Note: If you do not add the AUT as a managed app at this time,
it will be done for you automatically when you generate a test at
the end of the recording process for the AUT.
For details,
see Importing applications to test in the workbench.
- If
you did not use the device or both option
with the rtwBuildXcode.sh script, you can still
add the instrumented version of the AUT to a mobile device later.
For details, see Installing instrumented iOS applications.