Run offline instrumentation on iOS apps

To run offline instrumentation on iOS apps, perform the following steps.

Step 1 | Install the tool

Repeat the following steps whenever a new version of the tool becomes available.

  1. Contact Perfecto Support to request the offline instrumentation tool. The Perfecto Support team will send you the offline instrumentation installation package (a file called iOS_offlineInstrumentation.zip).

  2. Extract the offline instrumentation installation package.

  3. From the folder to which you extracted the package, open a command line window and run the following command, where -t [path] is the destination folder.

    Copy

     

    setup.sh -t [path]

Step 2 | Perform offline instrumentation

Repeat the following step for each app you want to instrument.

During the execution, the script reports its progress. Upon completion, the fully instrumented and signed .ipa file is generated.

  • From the destination folder, run the following command, making sure to specify the path to the input .ipa file, the output .ipa file, and the .mobileprovision profile file to use.

    To learn more about the available parameters, see Parameters for iOS offline instrumentation.

    Copy

    Example for files located in the current folder

    python3 offlineInstrument.py -i ./inputIPA.ipa -o ./outputIPA.ipa -p ./provision.mobileprovision -c "certificate name" -is -v

    Copy

    Example for files located on the desktop

    python3 offlineInstrument.py -i ~/Desktop/inputIPA.ipa -o ~/Desktop/outputIPA.ipa -p ~/Desktop/provision.mobileprovision -c "certificate name" -is -v

Step 3 | Upload the app to Perfecto

How you upload the instrumented application to Perfecto depends on whether you are a manual tester or an automation tester.

Make sure not to instrument the app again during the app installation process.

What's next?

When the app is instrumented, installed, and running on the device, you can inject sensory input. To learn more, see: