Parameters for Android script instrumentation

Learn more about the parameters you can use when instrumenting Android apps via script.

On this page:

Required parameters

The following table lists the available required parameters.

Parameter	Description
`-h`	Help message with available options.
`-i`	Path to the input APK or AAB file to instrument. Verify that the file path does not include white spaces.
`-o`	The output folder. Where to place the output APK. Should be in a different place than the input APK or AAB file.
`-t`	A text file that contains a valid security token.
`-u`	Cloud URL.

Instrumentation parameters

The following table lists the available instrumentation parameters. At least one of the instrumentation parameters must be true. If a parameter is not included, its value defaults to false.

Parameter	Description
`-ih`	Enable hybrid instrumentation (webview instrumentation).
`-is`	Enable sensor instrumentation (camera, finger print, and activity).
`-iscr`	Enables instrumentation of secured screens on devices running Android 12 or later.

Optional parameters

The following table lists the available optional parameters

Parameter	Description
`-cu`	The certificate user
`-cp`	The certificate password. If empty, use the certificate user.
`-kp`	The key store password.
`-cf`	The path to the Android certificate file.
`-dc`	Set if you don't want to save the APK or AAB file in the cloud
`-f`	Force fresh instrumentation even if a cached version exists. Optionally accepts a custom label to avoid overwriting cached versions. Example: `-f unique1` or `--force-instrument=unique1`