Instrumenting iOS applications on the iOS Simulator

Once the mobile test client is installed on the iOS Simulator, you must run a supplied build script on an OS X computer to be able to instrument the iOS application under test (AUT). The instrumented app can be optionally pushed to the test workbench and installed on the iOS Simulator.

Before you begin

You must have Xcode installed on your Macintosh computer running OS X v.10.8 (Mountain Lion) or newer, and an Xcode project created. The project must contain the source code of the application to be tested. Moreover, the rtwBuildXcode.sh script must be locally downloaded. It can be found in the build-script directory.

Procedure

  1. In Rational® Test Workbench Mobile Test Edition click the Display Workbench URL icon Workbench URL and copy the Workbench URL.
  2. On the Macintosh computer, open the web browser, paste in the Workbench URL and click the download link. This task downloads the RTW-iOS-Build-Archive.zip. Extract the zip file that contains the build-script folder with the rtwBuildXcode.sh shell script file.
  3. Open the Macintosh terminal application, point to the build-script folder, and enter the required command line to launch the rtwBuildXcode.sh script with the appropriate parameters. For details, see the Command line to launch the rtwBuildXcode.sh script topic. The script is used to automatically run compilations and links in Xcode from an Xcode project file and create an instrumented application.
  4. Run the script. This results in an instrumented application, and it is optionally pushed to the test workbench and to the iOS Simulator if you have indicated the required parameters on the command line. Otherwise, an instrumented .zip file is generated locally when the script is launched. In that case, you must manually import the instrumented file into the test workbench using the add application menu in the Mobile Application editor. Then, you must run another script to install the app into the iOS Simulator. Alternatively, you can push the application to an iOS device. To do so, see Installing an instrumented iOS application on devices.

Results

The incoming mobile application is displayed in the test workbench Eclipse client, in the navigation view. You must save the incoming application file in a Test Workbench project. Then, when the instrumented application is pushed to a simulator or to a mobile device, you can start recording a test.

Feedback