Install application (FR)
Perfecto Command
mobile:application:install
Purpose
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 resolving device application installation issues, such as application size limitations, see Handle application installation and launch issues on iOS devices | Troubleshooting.
For Android devices
- 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.
Parameters
Name |
Type |
Possible Values |
Description |
---|---|---|---|
certificate.file |
Multimedia |
|
The repository path, including directory and file name, of the certificate for certifying the application after instrumentation. This is the Keystore file in Android devices. Example - PRIVATE:dir1/dir2/name.jks |
certificate.user |
String |
|
The user for certifying the application after instrumentation. This is the Key Alias in Android devices. The user can be encoded using the String Encoder. |
certificate.params |
String |
|
The key password parameter for certifying the application after instrumentation. This is the Key Password in Android devices. The param can be encoded using the String Encoder. |
certificate.password |
String |
|
The password for certifying the application after instrumentation. This is the Keystore Password in Android devices. The password can be encoded using the String Encoder. |
file (Mandatory) |
Multimedia |
|
The full repository path, including directory and file name, where to locate the application. Example - PRIVATE:dir1/dir2/name.apk |
instrument |
String |
noinstrument | instrument |
Performs instrumentation. instrument - perform Object tree instrumentation noinstrument (default) - no instrumentation performed, use visual analysis to identify DOM objects. |
securedScreenInstrument |
String |
true | false |
When set to true, turns on instrumentation of secured screens on devices running Android 12 and later. In this case, calls on the app that use FLAG_SECURE will be removed (only |
sensorInstrument |
String |
nosensor | sensor |
Enables data input via device sensors (for example, camera or fingerprint) for the application. sensor- sensor reads data from the appropriate injection command |
Return Value
None
Exceptions
None
Examples
Java example
//declare the Map for script parameters
Map<String, Object> params = new HashMap<>();
params.put("file", "PRIVATE:applications/Errands.ipa");
params.put("instrument", "noinstrument");
driver.executeScript("mobile:application:install", params);
C# sample
//declare the Map for script parameters
Dictionary<String, Object> pars = new Dictionary<String, Object>();
pars.Add("file", "PRIVATE:applications/Errands.ipa");
pars.Add("instrument", "noinstrument");
driver.ExecuteScript("mobile:application:install", pars);