You can use the InstallAppInDevice script
on a Windows or Macintosh
computer to install an instrumented iOS application on one or more
iOS devices. This task applies to people who have the instrumented
app installed in the test workbench but
might not have access to the Xcode project that contains the application
source code.
Before you begin
Note: This procedure requires Rational® Test Workbench
v.8.5.1.3.
- Attach one or more iOS devices to the USB ports on the Windows or Macintosh computer
that is used to launch the script.
- 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 an instrumented version of the application under test
(AUT) has been installed in the test workbench. For details about
importing the instrumented AUT to the test workbench, see Importing applications to test in the workbench.
- Verify that you have a valid provisioning profile (.mobileprovision)
on each device that you use for testing. To verify that you have a
provisioning profile, tap
Procedure
- In click the Display Workbench URL icon
and
copy the Workbench URL. You need the Workbench URL to
connect the mobile device to the test workbench.
- On a Windows computer,
download RTW-iOS-Install-Archive.zip. On a Macintosh
computer, download RTW-iOS-Build-Archive.zip.
- On the Windows or
Macintosh computer, open a browser and enter the Workbench URL in
the following format:
http://Workbench_URL:port/mobile
For
example, http://192.0.2.24:7878/mobile
The Rational Test
Workbench - Mobile Welcome Page opens in the browser.
- Follow the online instructions to download the archive.
- When the download is complete, unpack the archive.
On a Windows computer,
the InstallAppInDevice.cmd installation script
is included in a folder named iOS-install-script.
On
a Macintosh computer, the InstallAppInDevice.sh installation
script is located in the build-script folder.
- Install the instrumented AUT by running InstallAppInDevice.cmd on
the Windows computer or InstallAppInDevice.sh on
the Macintosh computer.
- Open a Windows Command
Prompt or a Macintosh Terminal window.
- Type the following command to install the AUT:
iOS-install-script\InstallAppInDevice.cmd <path
to AUT file> on Windows
build-script/InstallAppInDevice.sh <path
to AUT file> on OS X
The AUT can have any of the following extensions: .app, .ipa, .ma,
or .zip.
Here is a command line example
on a Macintosh computer to install an AUT named UICatalog on
an iOS device:
./InstallAppInDevice.sh /Users/mario/iOSApps/UICatalog.ipa
A message is displayed if multiple devices are connected.
- Enter the number corresponding to the device to use
for the installation, or enter a for all devices
available.
A message is displayed when the AUT
is installed on a device. You can then choose another device to install
the application.
Results
After you complete these steps, you can start recording a
test.