TestComplete lets you automatically install and launch applications on iOS devices. To do this, you need to add the application’s IPA file to the Tested Applications collection of your test project (see Adding iOS Applications to the List of Tested Applications (Legacy)). This topic describes parameters of iOS applications in the Tested Applications collection.
NotesNotes
-
Your iOS application must be compiled and signed as explained in the Preparing iOS Applications (Legacy) section.
-
It is important to sign your tested iOS application with the appropriate provisioning profile:
-
If you use a development or an ad-hoc distribution profile, it must include all of your test devices. An in-house distribution profile lets you install your application on any iOS device, without having to add devices to the profile.
-
Provisioning profiles of the production type can cause difficulties for test commands that start your application on a device.
If you instrument the application in TestComplete, download the distribution provisioning profile from Apple’s Member Center and use it to instrument your application. See Getting Certificate Files.
-
-
The IPA file must be located on the TestComplete computer or a shared network location accessible from the TestComplete computer.
Basic Parameters
| Parameter | Description |
|---|---|
| Name | The unique name of the tested application in the Tested Applications collection. This name is used to refer to the application in tests, for example, in the Run TestedApp keyword test operation. |
| Autorun application on recording | Select this check box if you want the application to be launched on your mobile device when you start test recording. Note that the application should be installed on your iOS device before you start recording |
| Launch application from tests | If selected, TestComplete both installs and launches the application on the device. If unselected, TestComplete just installs the application on the device, but does not launch it.
|
Run-Mode Parameters
| Parameter | Description |
|---|---|
| iOS application archive file | The name and path of the IPA file on the TestComplete computer or in a network share. You can enter the path manually or click the  button and browse for this file.The path can be fully-qualified or it can be relative to the project folder. To switch between the fully-qualified and relative path representations, click the drop-down button and select the desired path in the drop-down box. The file path can include environment variables, such as %USERPROFILE%, as well as project and project suite variables in the format $(VarName). For more information, see Using Variables in Tested Application Paths. |
| Deploy to the device on start | If selected, TestComplete installs (or reinstalls) the application on the device before launching it. If unselected, TestComplete launches an already installed copy of the application.
|
See Also
About Tested Applications
Testing Mobile Applications
Adding iOS Applications to the List of Tested Applications (Legacy)
About TestedApps Editor
Using Variables in Tested Application Paths