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.