Using a script to install instrumented iOS applications

You can use the InstallAppInDevice script on a Windows or Macintosh computer to install an instrumented iOS application on one or more iOS devices. This task applies to people who have the instrumented app installed in the test workbench but might not have access to the Xcode project that contains the application source code.

Before you begin

Be sure to review the prerequisites described at Installing instrumented iOS applications. In particular, verify that Apple iTunes is installed. iTunes is included by default on Macintosh computers but must be downloaded and installed manually on Windows computers.

Procedure

In IBM® Rational® Test Workbench Eclipse Client click the Display Workbench URL icon and copy the Workbench URL.
You need the Workbench URL to connect the mobile device to the test workbench.
On a Windows computer, download RTW-iOS-Install-Archive.zip. On a Macintosh computer, download RTW-iOS-Build-Archive.zip.
1. On the Windows or Macintosh computer, open a browser and enter the Workbench URL in the following format:
  http://Workbench_URL:port/mobile
  
  For example, http://192.0.2.24:7878/mobile
  
  The Rational Test Workbench - Mobile Welcome Page opens in the browser.
2. Follow the online instructions to download the archive.
3. When the download is complete, unpack the archive.
  On a Windows computer, the InstallAppInDevice.cmd installation script is included in a folder named iOS-install-script.
  
  On a Macintosh computer, the InstallAppInDevice.sh installation script is located in the build-script folder.
Install the instrumented AUT by running InstallAppInDevice.cmd on the Windows computer or InstallAppInDevice.sh on the Macintosh computer.
1. Open a Windows Command Prompt or a Macintosh Terminal window.
2. Type the following command to install the AUT:
  iOS-install-script\InstallAppInDevice.cmd <path to AUT file> on Windows
  
  build-script/InstallAppInDevice.sh <path to AUT file> on OS X
  
  The AUT can have any of the following extensions: .app, .ipa, .ma, or .zip.
  
  Here is a command line example on a Macintosh computer to install an AUT named UICatalog on an iOS device:
```
./InstallAppInDevice.sh /Users/mario/iOSApps/UICatalog.ipa
```
  A message is displayed if multiple devices are connected.
3. Enter the number corresponding to the device to use for the installation, or enter a for all devices available.
  A message is displayed when the AUT is installed on a device. You can then choose another device to install the application.

Results

After you complete these steps, you can start recording a test.

Feedback