The Add Tested Application wizard assists you in adding applications to the Tested Applications collection of your project. On this page of the wizard, you add iOS application archive files (.ipa) to the list of tested applications.

The application’s .ipa file must be stored on the local computer (where TestComplete is installed) or in a network share.

In the iOS application archive file text box, enter the path to the desired archive file (.ipa) or click the button and browse for the desired file.

You can control the format of the paths to the application’s archive file on the local computer. The target path can be specified as an absolute path, a relative path or by using environment variables (if the path includes any standard system path for which environment variables are set). Click the drop-down button in the desired text box and choose the needed representation from the drop-down list.
If you want your application to be deployed to the device on each start, enable the Deploy to the device on start option.

You Are Adding an Instrumented Application

This page is shown when the application has already been prepared for testing.

In this case, the other pages of the wizard are not displayed, as no further actions are needed.

Instrument Your iOS Application

This page is shown when the application was not prepared for testing. The page suggests two options:

If you want to get access to the application’s controls and their methods, fields and properties, select the Instrument the application option. TestComplete will later modify the application as required and recompile it. See Instrumenting iOS Applications in TestComplete UI.
If the application cannot be recompiled or you do not want to modify the application, select Add an uninstrumented application.

Back Up the Original .ipa File

This page is shown if you decided to instrument the application.

Since the instrumentation cannot be undone, we recommend that you make a backup of the original version of your application.

The page suggests creating a backup copy of the application and specifying a location where it will be stored.

Sign Your iOS Application

This page is shown if you decided to instrument the application.

On this page, you need to specify the paths to the certificate files for signing the recompiled application.

You will need to export them from the Mac computer you use for development as described in Get Certificate Files topic.

Click Finish to close the dialog and add the specified application to the Tested Applications collection. Click Cancel to close the dialog without adding the application.

Add Tested Application Wizard - Add iOS Application Page

You Are Adding an Instrumented Application

Instrument Your iOS Application

Back Up the Original .ipa File

Sign Your iOS Application

See Also