Application¶
The Application category allows the administrator to manage Android applications on devices. From this category, you can perform the following actions:
- Install app from APK
- Install app from Play Store
- Uninstall applications
- Restore application backup
- Set application or service
- Run ADB commands
- Wait for application installation
- Allow unknown sources
- Replay sequence
Install app from APK¶
Define the Android applications to be installed on devices from APK files stored in the Genydeploy host computer.
To add an application:
- Click Add and Install app from APK.
-
Select your application in either of the following ways:
- Click Select from computer and browse for your APK file.
- Click Select from device and select the device from which you wish to retrieve an application, as well as its application package name.
-
Since Android 6.0, permissions are requested upon first use. To allow all permissions during installation, check the Grant permissions box.
- If you want to display a shortcut on the home screen of devices, check the Shortcut box.
- Click Apply.
You must then define scripts that correspond to the device models you wish to configure:
- Select the tab of the device model you wish to configure.
- In Script Library, select the script with the match rate closest to your device model1.
-
Create or complete the script using commands listed in the right-hand panel. The use of each command is detailed in section Script Commands.
Tip
- When a command is added, you can drag and drop it to run the script in the order of your choice.
- The Expert mode allows users with good knowledge of script edition to write their script directly in XML.
-
At anytime during script creation, you can test all or part of the script by selecting the commands to be tested and clicking Test. Commands being tested are then highlighted. You can abort the test by clicking Stop.
- If your script runs properly, click Add to script library.
- Repeat those steps for other device models.
- Click Apply.
Install app from Play Store¶
Define the Android applications to be installed on devices from Google Play Store.
To add an application, click Add and Install app from Play Store. Then, select your application in either of the following ways:
- Click Select from device and select the device from which you wish to retrieve an application, as well as its application package name.
-
Enter the package name of the application to install. From Google Play Store, it corresponds to the value shown into brackets:
https://play.google.com/store/apps/details?id=[com.example.myapp]
You must then define scripts that correspond to the device models you wish to configure:
- Select the tab of the device model you wish to configure.
- In Script Library, select the script with the match rate closest to your device model1.
-
Create or complete the script using commands listed in the right-hand panel. The use of each command is detailed in section Scripts Commands.
Tip
- When a command is added, you can drag and drop it to run the script in the order of your choice.
- The Expert mode allows users with good knowledge of script edition to write their script directly in XML.
-
At anytime during script creation, you can test all or part of the script by selecting the commands to be tested and clicking Test. Commands being tested are then highlighted. You can abort the test by clicking Stop.
- If your script runs properly, click Add to script library.
- Repeat those steps for other device models.
- Click Apply.
Uninstall applications¶
Uninstall an Android application from devices.
Some system or manufacturer applications cannot be uninstalled from devices. In this case, Genydeploy disables them.
To uninstall an application, click Add > Uninstall app and select your application in either of the following ways:
- Click Select from device and select the device from which you wish to select an application to uninstall, as well as its application package name.
-
Enter the package name of the application to uninstall. From Google Play Store, it corresponds to the value shown into brackets:
https://play.google.com/store/apps/details?id=[com.example.myapp]
Click Apply to validate.
Restore application backup¶
Backup the settings of an application from a connected device in order to further restore it on devices:
- Click Add and Restore app backup.
- Click Browse and select the device from which you want to back up the settings of an application.
- From the Application package name drop-down list, select the application from which you want to back up the settings.
- Check Back up the entire application to install the application prior to restoring its settings if it is not already installed on the device.
- Click Back up.
- On the device, confirm the backup by clicking Back up my data.
-
To protect the backup file and thus avoid a backup restoration by an unauthorized person and the risk of having your data stolen, you can add a password in Password (optional).2
If the password entered in this field does not match the password entered manually in the device when creating the backup, the backup restoration will fail in a silent way.
-
Click Apply.
Set application or service¶
Configure an application already installed on devices or a device parameter using a custom script.
To configure an application or a parameter:
- Click Add and Set app or service.
- In Name, give the script a relevant name.
- Select the tab of the device model you wish to configure.
-
Configure the script using commands listed in the right-hand panel. The use of each command is detailed in section Scripts Commands.
Tip
- When a command is added, you can drag and drop it to run the script in the order of your choice.
- The Expert mode allows users with good knowledge of script edition to write their script directly in XML.
-
At anytime during script creation, you can test all or part of the script by selecting the commands to be tested and clicking Test. Commands being tested are then highlighted. You can abort the test by clicking Stop.
- If your script runs properly, click Add to script library.
- Repeat those steps for other device models.
- Click Apply.
Run ADB commands¶
During the creation of your configuration, you may need to perform an action specific to your needs, not covered by the scope of Genydeploy. Genydeploy uses the ADB communication protocol. Therefore, this feature allows you to customize a command in order to perform a specific action.
To run a specific command:
- Click Add and Run ADB command.
-
In the ADB command field, enter the command you wish to run.
Example: Set a specific application as DeviceOwner
shell dpm set-device-owner com.example.kiosk_mode/.AdminReceiver
-
Click Apply.
Wait for application installation¶
When you install an application (e.g. an EMM application), it can require you to download other applications in parallel. This feature checks that one of those applications is actually installed before moving on to the deployment of the next feature.
To define the applications to be checked prior to proceeding with the deployment of the configuration:
- Click Add and Wait for app installation.
- In Application package name, enter the name of the application for which the installation must be checked.
-
Select the application for which the installation must be checked in either of the following ways:
- Click Select from device and select the device from which you wish to select an application, as well as its application package name.
- Enter the package name of the application. From Google Play Store, it corresponds to the value shown into brackets:
https://play.google.com/store/apps/details?id=[com.example.myapp]
-
Click Apply.
Allow unknown sources¶
By default, Android forbids installation of applications from outside of the Google Play Store. This feature will allow the installation of these applications in the parameters.
To enable or disable this settings during the deployment of the configuration:
- Click Add and Allow unknown sources.
- Set the Allow unknown sources switch to choose if you want to allow or forbid it.
- Click Apply.
Replay sequence¶
Automate a series of actions before having enabled ADB. To do so, you record a series of actions performed via a USB-connected mouse. The series of actions is then replayed on all devices.
For example, when you start a device for the first time, the setup wizard requests to click various options. You can record those actions in order not to repeat them on all devices.
This feature is available on Linux only.
To automate actions using the mouse:
- Click Add and Replay sequence.
- Connect your mouse to a USB port.
-
Fill the following fields:
- Name: Specify a name for the sequence to automate.
- Mouse: Select your mouse.
- Device: Select the device on which the sequence will be recorded.
-
Click Record.
- From the device, perform the actions to automate.
- Press Q to stop recording.
- Click Apply.