Command line used to instrument an iOS application via a script

To instrument an iOS application, you must run the rtwBuildXcode.sh script with the appropriate parameters. Optionally you can push the instrumented application to the test workbench and install it on an iOS device, the iOS Simulator, or both by using the same build script.
Note: Before using the shell scripts, be sure that you have permission to execute shell scripts. If necessary, use chmod to update your permissions.
To run the script, enter the following command line in your Macintosh terminal with the parameters adapted to your work context.
<unpack_dir>/build-script/rtwBuildXcode.sh <.xcodeproj file> <Workbench URL> <simu|device|both> 
Where:
  • unpack_dir is the directory where you extracted the downloaded archive.
  • .xcodeproj file is the absolute or relative path to the .xcodeproj project created for the application under test. If the name or the path to the Xcodeproj file contains spaces, enclose the full path with double quotes (" "), or replace all spaces by backslashes (\).
  • Workbench URL indicates the Workbench URL copied from the Mobile Device editor. Including the Workbench URL is highly recommended, because this is the easiest way to register an application to the test workbench. The test workbench needs to know the application when it receives the recording log in order to produce a complete test. In a context in which the Workbench URL is used from the rtwBuildXcode.sh shell-script, do not include mobile at the end of the Workbench URL. As an example, indicate http://<ip-address>:7878 only.
    Note: If you specify the Workbench URL in the command line, the instrumented application is automatically pushed to the test workbench. If you do not specify the Workbench URL in the command line, you can add the application under test to the test workbench by clicking Add applications to list in the Mobile Applications editor.
  • simu|device|both are optional parameters to indicate that you want to upload the instrumented application to the iOS Simulators on the Macintosh computer, to an iOS device, or to both. The Simulators will be automatically restarted to use this new application. To upload to a device, the device must be connected to the Mac via USB.

Feedback