Parameters for iOS script instrumentation

Learn more about the parameters you can use when instrumenting iOS apps via script, including required parameters, instrumentation flags, and optional parameters.

Required parameters

Parameter Description
-i (IPA)

The .ipa file to instrument
-o (OUTPUT_FILE)

The name of the instrumented .ipa file
-p PROVISIONING_PROFILE

The .mobileprovision profile file to use
-c CERTIFICATE_NAME

The name of the certificate to use
-t TOKEN A text file containing a valid security token
-u URL The Perfecto cloud URL

Instrumentation flags

At least one of the following instrumentation flags is required.

Flag Description
-ih  Enables hybrid instrumentation
-is Enables sensor instrumentation

Optional parameters

Parameter Description

-ent

Entitlements file. Add a prepared entitlements plist profile in place of the generic entitlements section generated by the script, based on the information provided.

-v VERSION

The Perfecto cloud version. If omitted, Perfecto automatically selects the version matching the target cloud version.

-crp

Specifies a custom resign paths definition file in .plist format. Use this parameter to sign individual components of the app (such as plug-ins) with different provisioning profiles and certificates.

Copy 
python3 customInstrumentWrapper.py -crp /path/to/customResignPaths.plist

The .plist file must define a dictionary with the key CustomResignPaths. Each entry specifies:

  • The relative path to the component within the app bundle

  • The absolute path to the provisioning profile

  • The name of the certificate to use

For details and an example file structure, see Use custom re-sign paths for component-specific signing.