Instrument Android Application Wizard

Applies to TestComplete 14.30, last modified on November 21, 2019

This wizard assists you in instrumenting Android applications that have already been added to the Tested Applications collection of your project. This could be useful, for example, in the following cases:

  • You have replaced the instrumented version of the application with its newer version.

  • You have earlier added an unprepared application and then decided to instrument it for object-based testing.

The wizard is called when you press the Instrument button in the Tested Apps editor.

The wizard consists of several pages:

Select the .apk File to be Instrumented

On this page of the wizard, you can specify the path to the application to be instrumented.

  • In the Android application package file text box, specify the path to the Android application package. You can enter the path manually or click the button and browse for the desired file.

    You can control the format of the path to the application’s package 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.

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

Back Up the Original .apk File

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 Android Application

On this page, you can specify the certificate data for signing the application. The page suggests two options:

  • If you want to generate a debug key and sign the application automatically, select Sign the application using the debug certificate.

  • If you want to sign your application with your own certificate, select Sign the application using the following certificate and then specify the keystore file, alias and their passwords.

Working with the Wizard

After specifying the needed options and parameters, click Finish to close the wizard and instrument the application. Click Cancel to close the wizard without modifying the application.

See Also

About TestedApps Editor
Instrumenting Android Applications in TestComplete UI

Highlight search results