Install application command

Installs a single application on the device, using automation. To use this command, the application must first be uploaded to the Perfecto repository. The PerfectoLabUtils class provides the uploadMedia method to upload a file to the Repository.The Install application function performs the same operation as the Install widget in the Manual testing view (see Manage apps).

For Android devices, the following applies:

The application manifest.xml file must include internet access permission: <uses-permission android:name="android.permission.INTERNET"/>
The application will automatically be signed with an Android debug key to enable native object automation.

Expand the section you are interested in.

Parameters

Name	Type	Possible values	Description
Device ID^*	String		The device for this command. By default, this is the device under test (DUT).
Repository key^*	Media		The full repository path, including directory and file name, of the application file. When using commands that utilize files from the repository, the paths to the files are specified as repository keys. A repository key consists of the subarea and the path to the file. For example, to specify a file called myImage.jpg stored in the images folder located in the PRIVATE subarea, specify the key as `PRIVATE:images/myImage.jpg`. You can select a file that already resides in the Perfecto repository or select a file from your computer that is then uploaded to the Perfecto repository. To learn more about the Perfecto repository, see Manage the repository. Click the Select media link, browse to the file, and then click SELECT. Example: `Public:2364030/db7575532d124db0b67e476a52e98736.js`
Application instrumentation	String	true \| false	Specifies if the application will be instrumented as part of the installation process. Application instrumentation adds additional code into an app to enable tracing, debugging, or testing capabilities, for example for fingerprint or image injection. To learn more, see Instrumentation.
Sensor instrumentation	String	True \| False	Enables data input through device sensors (for example camera or fingerprint) for the application. To learn more, see Sensor instrumentation. Set to True to enable sensors to read data from the appropriate injection command. Set to False (default) to not prime sensors for program input.
Secured screen instrumentation	String	True \| False	Enables data input into secured screens. To learn more, see Secured screen instrumentation.
Certificate key	String		The certificate file. This file certifies the application after instrumentation. On Android devices, this is the Keystore file. You can select a file on your local machine or in the Perfecto repository.
Certificate user	String		The user for certifying the application after instrumentation. On Android devices, this is the Key Alias.
Certificate password	String		The password for certifying the application after instrumentation. On Android devices, this is the *Keystore Password*.
Certificate params	String		The key password parameter for certifying the application after instrumentation. On Android devices, this is the Key Password. The value must be preceded with "keypass". Example: `keypass 3f51s6`
Reset data	String	True \| False	Indicates if the application data on the device should be cleaned prior to installation. `True` indicates that all application data should be cleaned and the application starts with a clean slate. `False` indicates that existing application data should be kept on the device. The application will be able to access the existing data.
Reset keychain	String	True \| False	Resets the keychain assigned during instrumentation
Re-sign	String	True \| False	Re-signs the app with a Perfecto code-signing certificate that has the cloud device provisioned. To learn more, see Re-sign an application \| iOS.
Do not use cache	String
Comment	String		Adds a comment to the script
On-fail Result^*	Condition	Ignore \| Break \| Continue \| Abort \| Catch	The behavior when the command fails.

^* Mandatory parameter