iOS Application Parameters

Applies to TestComplete 15.64, last modified on May 16, 2024

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.


  • 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.

This property has effect only if you signed your iOS application with a provisioning profile of the appropriate type. See Notes above.

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.

This property has effect if you signed your tested iOS application with a provisioning profile that enables installing the application on your test device. See Notes above.

See Also

About Tested Applications
Testing Mobile Applications
Adding iOS Applications to the List of Tested Applications (Legacy)
TestedApps Editor
Using Variables in Tested Application Paths

Highlight search results