Manual Uninstallation
IMPORTANT: Device settings configured by EHS such as USB debugging, System Settings Restricted (restricting user access to Display and Sound settings, and the "About phone" panel only), disabling apps and recent apps button and so on, DO NOT revert to their former state when EHS is uninstalled. To restore a device to its former state, all such settings MUST BE REVERSED prior to the removal of EHS. This can be done prior to uninstalling EHS by pushing to the device anenterprisehomescreen.xmlfile properly configured to unrestrict the settings.
1. From the Admin Mode screen, Select Settings:
2. Tap Apps to bring up the Android App Manager:
3. Locate and Tap Enterprise Home Screen:
4. Tap the Uninstall button:
5. Click OK to confirm:
Remove Config File (optional)
The steps above do not remove the enterprisehomescreen.xml configuration file from the /enterprise/usr folder, which could effect the behavior of EHS versions installed later.
To remove an old version of the enterprisehomescreen.xml file:
6. Connect the device to a computer with Android Debug Bridge (ADB) installed.
7. At a command prompt, execute the following command:
adb shell rm /enterprise/usr/enterprisehomescreen.xml
Manual uninstallation of EHS is now complete.
Automated Uninstallation
These instructions apply to remote uninstallation using an organization's own EMM server to remove EHS from multiple managed devices. This task also can be accomplished through Zebra's EMDK or StageNow tools using the App Manager service.
IMPORTANT: Device settings configured by EHS such as USB debugging, System Settings Restricted (restricting user access to Display and Sound settings, and the "About phone" panel only), disabling apps and recent apps button and so on, DO NOT revert to their former state when EHS is uninstalled. To restore a device to its former state, all such settings MUST BE REVERSED prior to the removal of EHS. This can be done prior to uninstalling EHS by pushing to the device anenterprisehomescreen.xmlfile properly configured to unrestrict the settings.
CRASH WARNING: On ET50 and ET55 devices with GMS, a permanent system UI crash could occur if EHS is uninstalled remotely (i.e. via EMM) while in User Mode. Before uninstalling EHS, Zebra recommends pushing to the device an EHS configuration file (enterprisehomescreen.xml) with the Search app enabled. See the Advanced Settings section for configuration file usage.
To uninstall EHS using an EMM, instruct the EMM to do the following:
1. Uninstall (remove) the EHS app, referencing the package and activity names as indicated in the table below.
|
Deployed file |
Package name |
Main activity/class name |
|
EHS_xxxxxx.apk |
com.symbol.enterprisehomescreen |
com.symbol.enterprisehomescreen.HomeScreenActivity |
2. OPTIONAL: If a new enterprisehomescreen.xml configuration file will be deployed with the new version of EHS, skip to Step 3. Otherwise, instruct the EMM to remove the file /enterprise/usr/enterprisehomescreen.xml from the device. This will clear configuration settings from the previously installed EHS app.
Warning: Do not remove the
/enterprise/usrfolder; it could effect the behavior of other apps.
3. It is sometimes necessary to reboot the device to complete the uninstallation.
Remote uninstallation of EHS is now complete.
Note: Capabilities of EMM systems vary. Please refer to the EMM documentation for specific information about command usage.
Change the Default Launcher
Removing EHS as the default launcher on a device can be done with a simple change in the Settings panel or by uninstalling EHS. Either of these scenarios can be accomplished manually on the device, programmatically through EMDK or remotely using StageNow or an EMM (if supported).
If EHS is removed from the device and the Android Launcher is the only remaining launcher on the device, it will become the default launcher. If more than one launcher will remain on the device after EHS is removed, a new default launcher should be selected to ensure desired operation.
To manually change the default launcher on a device without removing EHS:
1. In Admin Mode open the Settings panel and tap Home:
2. Tap on the Android Launcher to select it as the default launcher and Home screen.
Note: The trash can icon seen here offers an alternative means of uninstalling EHS and restoring the Android Launcher.
Battery and Wi-Fi Quick View
In addition to the separate panels for viewing Battery and Wi-Fi status provided in the menus of Admin- and User-Mode Launcher screens, EHS provides Quick View, an alternate way of accessing real-time status of these critical devices from a single screen.
Note: SSID and BSSID information do not appear in the "Wireless Info" or "Battery and Wi-Fi Quick View" screens on devices running Oreo if Location services (Settings -> Security & Location -> Location) are turned off.
To view Battery and Wi-Fi status:
From Admin or User Mode, tap the "i" icon as indicated below:
The Battery/Wi-Fi Quick View panels appears, displaying real-time status of both devices:
