To instrument an iOS application, you must run the rtwBuildXcode.sh script
with the appropriate parameters. You can also 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.
The rtwBuildXcode.sh script provides
support for both Xcode projects and Xcode workspaces. An Xcode workspace
lets you group together multiple Xcode projects and other files to
make it easier to work on them together.
To run the script,
enter one of the following command lines in your Macintosh terminal
with the parameters adapted to your work context.
unpack_dir/build-script/rtwBuildXcode.sh app.xcodeproj Workbench URL simu|device|both
unpack_dir/build-script/rtwBuildXcode.sh app.xcworkspace scheme Workbench URL simu|device|both
Where:
- unpack_dir is the directory where you extracted
the downloaded archive.
- app.xcodeproj is the absolute or relative path
to the .xcodeproj 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
(\).
- app.xcworkspace is the absolute or relative path
to the .xcworkspace that includes the .xcodeproj for the application
under test. If the name or the path contains spaces, enclose the full
path with double quotes (" "), or replace all spaces by backslashes
(\). For details, see the Apple Developer documentation at Xcode workspaces.
- scheme is a collection of Xcode settings that
include project build targets, a build configuration, and the executable
environment for running the product. For details, see the Apple Developer
documentation at Xcode schemes.
- 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.