Installing instrumented iOS applications

Before you can test an iOS application, the application must first be instrumented, added to the test workbench, and installed on the device.

Prerequisites

Be sure to complete the following tasks before you install an iOS application on a device:

Install IBM® Rational® Test Workbench Eclipse Client on a Macintosh or Windows computer and ensure that Rational Test Workbench Extension for Mobile is selected. For details, see Installing the product software.
Verify that you have USB cables for the iOS devices on which you plan to install the application under test (AUT).
Verify that Apple iTunes is installed on the Macintosh or Windows computer. iTunes is included by default on Macintosh computers but must be downloaded and installed manually on Windows computers.
Verify that you have a valid Apple Developer or Enterprise License.
Verify that you have a valid provisioning profile (.mobileprovision) on each device that you use for testing. To view the provisioning profiles, tap Settings > General > Profiles.

If the application source code is available

If you or a co-located developer has the Xcode project for the application under test (AUT), you can complete all of the steps needed to install the app on a device by running the rtwBuildXcode.sh script. For details, see Instrumenting iOS applications.

Installation methods if the application source code is not available

If you do not have the Xcode project for the AUT, you can use one of the following methods to install the instrumented application on an iOS device. The method that you choose depends on the versions of the test workbench and iOS.

Method 1: Use the Install push button in the browser-based Web client on the device.

Method 2: Use the Mobile and Web UI Applications editor in the test workbench.

Method 3: Run the InstallAppInDevice script from the Windows or Macintosh command line.

Method 4: Use iTunes on a Windows or Macintosh computer.

The following table shows the installation methods that are available for different versions of the test workbench and iOS:

Table 1.
Rational Test Workbench version	iOS 6.x	iOS 7.0	iOS 7.1 or newer
8.6 or newer	All	All	2, 3, 4
8.5.1.3	1, 3, 4	1, 3, 4	3, 4
8.5	1, 4	1, 4	4

Recommendations

The following table lists the recommended installation methods for each version of the test workbench and iOS. In all cases, it is possible to use the iTunes method.

Table 2.
Rational Test Workbench and iOS version	Recommendation
RTW 8.6 or newer, iOS 6 or newer	Use method 2, the Rational Test Workbench UI. For details, see Installing instrumented iOS applications from the test workbench. For a video tutorial that includes a demo of this method, see Instrumenting and Installing iOS apps in IBM Rational Test Workbench v8.6.
RTW 8.5.1.3, iOS 6 or newer	Use method 3, the command line script on a Macintosh or Windows computer. See Using a script to install instrumented iOS applications.
RTW 8.5, iOS 6 or 7.0	Use method 1, the Install button in the mobile test client. See Installing with the Install button on the device.
RTW 8.5, iOS 7.1 or newer	Use method 4, iTunes. For details, see Using iTunes to install instrumented iOS applications.

Feedback