Skip to main content

Instrumenting iOS Applications

info

Please note that this tool is classified as a Legacy tool. We recommend transitioning to our updated solutions to maintain optimal performance and security in your workflows. For more information on this matter, please reach out to technical support .

The .ipa file should not be one that you downloaded from iTunes. Such files have DRM restrictions which will not allow instrumenting the application. The application should be a production build version without DRM restrictions.

To illustrate the process of instrumenting iOS applications, we provide two non-instrumented demo applications for iOS devices which can be found in the installation folder under .../bin/ipas:

(The links can be opened only from iOS devices.)

  • EriBankO.ipa (bundle identifier: com.experitest.ExperiBankO)
  • BrowserO.ipa (bundle identifier: com.experitest.BrowserO)

In the same folder are copies of the same files already after instrumentation. They will automatically be available in the Application manager.

info

You can use distribution profiles for the instrumentation process.

info

By default, the provisioning profile that will be used for signing is automatically selected. To select a specific provision profile do one of the following:

Instrumentation Process​

  1. In the studio UI, click Help →  iOS Provision Profile Management.

  2. Perform the steps shown in AS - iOS Sign Configuration to configure the needed files for the instrumentation.

  3. Import the .IPA file (should be available on your local disk) via the Application manager.

  4. Under Applicaiton Capabilities, select Instrumented.

  5. Click the Install button.

  6. When prompted, click Yes.

    The application is launched.

This shows how an instrumented app is displayed in object spy mode.

info

You can instrument your application with basic capabilities only (doesn't include features like Simulate Capture, Mock Authentication). This option is recommended only when experiencing problems with the default instrumentation. To set Basic Instrumentation, add the following line to the app.properties file: ios.instrument.with.basic.frameworks=true

info

For advanced usage, you can import entitlements to your application during the installation process. This option is recommended only when experiencing problems with entitlements. You must supply valid entitlements.plist file for your application. To instrument applications with custom entitlements.plist add the property:
override.entitlements.file.path_<BundleID>=<Pathe_To_entitelments.plist> to the app.properties file. For more information, contact technical support .

Last updated on