Install application (FR)
Perfecto Command
mobile:application:install
Purpose
To use, the application must first be uploaded to the Lab 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 appplication 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 |
Perform instrumentation. instrument - perform Object tree instrumentation noinstrument (default) - no instrumentation performed, use visual analysis to identify DOM objects. |
securedScreenInstrument |
String |
true | false |
Set to |
sensorInstrument |
String |
nosensor | sensor |
Enable device sensor (for example camera or fingerprint) data input for the application. sensor- sensor reads data from the appropriate injection command |
The certificate.x parameters are relevant for Android devices only. And used only if the instrumentation parameter is set to instrument.
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);