Installing an instrumented iOS application when the test workbench runs on Linux

It is also possible to install an iOS application on an iOS device when your test workbench is running on Linux.

Before you begin

If you run the test workbench on Linux, you can install an instrumented iOS app on an iOS device by attaching the device via USB to a Macintosh computer when you or someone else runs the rtwBuildXcode.sh script on the Macintosh computer.

Install IBM® Rational® Test Workbench Eclipse Client on a Linux computer 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 Workbench project for the application under test (AUT) or create a project by clicking File > New > Test Workbench Project.
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.
1. 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
2. In the Rational Test Workbench - Mac OS Welcome page, follow the online instructions to download the archive.
3. 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 application under test (AUT) by running the rtwBuildXcode.sh script.
To instrument the AUT, attach the iOS device to the Macintosh computer. Then, use the device option to the rtwBuildXcode.sh script and specify the Workbench URL of your Linux computer.

Note: The rtwBuildXcode.sh script provides support for Xcode projects and Xcode workspaces. For details about Xcode workspaces, see rtwBuildXcode.sh.
1. On the Macintosh computer, open the Macintosh Terminal application.
2. Type the following command to instrument the AUT and send it to the test workbench on the Linux computer as an incoming application.
```
unpack_dir/build-script/rtwBuildXcode.sh .xcodeproj file Linux 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 on your Linux computer and to all USB-connected devices:
```
./rtwBuildXcode.sh /Users/mario/iOSApps/UICatalog/UICatalog.xcodeproj/ http://9.54.119.136:7878 device
```
Add the instrumented version of the AUT to a project in the test workbench.
After you run the rtwBuildXcode.sh 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.

Results

After you complete these steps and the instrumented app is installed on the iOS device, you can start recording tests. For details, see Creating mobile tests.

Feedback