Enterprise Home Screen Setup

Enterprise Home Screen 2.5

Overview

These instructions provide a basic understanding of the installation, configuration, usage and essential workings of Enterprise Home Screen, and are recommended for anyone unfamiliar with first-time EHS setup. Please note that everything detailed here also can be automated through a Mobile Device Management (MDM) system and with direct manipulation of the EHS config file, which is documented in the Advanced Settings section.

Many of the capabilities of EHS can be accomplished manually on the device, programmatically through EMDK or remotely using StageNow or a third-party mobile device management (MDM) system (if supported by that MDM system). EHS simply puts these capabilities into a single, convenient tool.

Note: Installation and setup requires that EHS be present on a PC or Mac that can communicate with the target device and write to all storage areas. If necessary, please download EHS and establish connectivity between the computer and device. Then resume from here.

Manual Installation

These instructions apply to direct installation (from a computer to a single device) using the EHS_020501.apk EHS 2.5 installer file.

Read about how to uninstall EHS later in this guide.

To install EHS manually:

1. Connect the device via USB to a PC or Mac.

2. Copy the APK file from the PC to any writable device folder.

3. On the device, launch File Browser from the App Drawer:


4. Locate and launch the APK file:


5. Tap Install:


6. After installation, tap Open:

If "Done" was accidentally selected instead of "Open," launch "Enterprise Home Screen" from the App Drawer and proceed.

7. Tap or press the HOME key. A screen like the image below will appear:


8. Select Enterprise Home Screen and tap "Just once" for now. This will allow easy switching between EHS and the Android launcher during setup. This choice will be presented every time the HOME key is tapped until selecting "Always" makes the selection permanent.

Note: On ET50 and ET55 devices with Google Mobile Services (GMS), the Launcher selection pop-up does not appear when the HOME button is pressed while in User Mode. To avoid this issue, switch to Admin Mode and press the HOME button; the pop-up appears and the default Launcher app can be selected.

9. A restart is required to complete the installation (for first-time EHS installations). Again, a screen like the one above will appear. Select Enterprise Home Screen and tap Just once to continue or select "Always" to make the selection permanent. To undo this choice, see Change the Default Launcher section below.

Select Apps for User Mode

EHS is now ready to use. The next steps are for selecting which apps to display (and which to hide) while in User Mode, and for configuring the level of user access to device settings. When first run, EHS always defaults to User Mode, and will display a screen similar to the image below:

EHS User Mode

Note: EHS selects apps for display in User Mode from apps installed on the device. All apps intended for use must be installed on the device before proceeding.

Enter Admin Mode and select which apps will be displayed to users:

10. Tap the menu icon and open the Tools menu:


11. Select Admin Login and tap OK (the default password is blank):


After hitting OK, the admin version of the Tools menu will be displayed.

12. Tap the BACK button to dismiss the Tools menu. The Admin Mode screen similar to the image below will show all apps installed on the device.


Note: If an app intended for use is not displayed, it must be installed before proceeding.

13. Long-press an app icon to alternatively display or hide it from the User Mode screen. Depending on the app's status when long-pressed, one of the following messages will appear:

Repeat this step until desired apps are selected for display. To confirm selections, switch between Admin and User Modes by logging in and out of Admin Mode from the Tools menu.

User Access to Settings

EHS provides extensive control over which device settings (such as networking) and resources (such as cameras and the file system) will be available to users when the device is in User Mode. Administrators can allow complete control of all device settings, limit access to just a few settings, or hide device settings completely.

In User Mode, the following features are disabled by default:

  • Airplane mode
  • USB debugging
  • Access to the file system
  • Keyguard (for unlocking the screen)
  • Keyguard-screen camera and search functions
  • The status-bar Settings icon
  • Full access to the System Settings panel

To select which settings will be available while the device is in User Mode and/or to modify other User Mode preferences:

14. While in Admin Mode, Select Preferences from the menu:


15. Scroll the Preferences panel and select the desired settings:

For scenarios that require even more security, EHS offers Secure and Kiosk modes, which are documented in the Advanced Features section. For a complete usage reference for the enterprisehomescreen.xml configuration file, please see the Advanced Settings section.

Automated Installation

These instructions apply to remote installation of EHS, an enterprisehomescreen.xml config file, or both, from an organization's own MDM server to multiple managed devices. Alternatively, remote deployment and management can be accomplished through Zebra's EMDK or StageNow tools using the App Manager service.

To install EHS using an MDM, instruct the MDM to do the following, in this order:

1. If desired, create an enterprisehomescreen.xml file containing the desired user apps and settings. Otherwise, EHS will be installed with its default settings and apps. See the Advanced Settings section for detailed instructions on the creation and editing of config files.

2. Deploy EHS and the config file (if any) to the device(s). This includes the .apk file and the XML file (if any) created in the previous step.

3. Launch the app using the following package and activity commands:

Deployed file

Package name

Main activity/class name

EHS_020xxx.apk

com.symbol.enterprisehomescreen

com.symbol.enterprisehomescreen.HomeScreenActivity


4. Set Enterprise Home Screen as the default home application on the device.

5. Reboot the device to complete the installation. This is a required step.

The capabilities of MDM systems vary. Please refer to the MDM documentation for specific information about how to configure these commands.

Note: App installation, uninstallation, setting the default launcher and other operations can be achieved using the App Manager through Zebra's EMDK or StageNow tools.

Uninstallation

Important

On ET50/ET55 devices running Android 5.x Lollipop with GMS, a permanent system UI crash could occur if EHS is uninstalled 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.

Manual Uninstallation

Important: Device settings configured by EHS such as USB Debugging, System Settings Restricted, and some others might not revert to the state they were in prior to EHS installation. Zebra recommends reconfiguring the device as required prior to the removal of EHS.

To remove EHS, simply use the Android App Manager to uninstall the EHS app.

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:

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 MDM 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

  • On ET50 and ET55 devices with GMS, a permanent system UI crash could occur if EHS is uninstalled remotely (i.e. via MDM) 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.

  • Device settings configured by EHS such as USB Debugging, System Settings Restricted, and some others might not revert to the state they were in prior to EHS installation. Zebra recommends reconfiguring the device as required prior to the removal of EHS.

To uninstall EHS using an MDM, instruct the MDM 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_020xxx.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 MDM to remove the /enterprise/usr folder. This will remove any previous config file.

3. It is sometimes necessary to reboot the device to complete the uninstallation.

Remote uninstallation of EHS is now complete.

The capabilities of MDM systems vary. Please refer to the MDM documentation for specific information about how to configure these commands.

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 MDM (if supported). If EHS is removed from the device, the Android Launcher in most cases will be the only remaining launcher on the device, and therefore will become the default launcher.

The following process applies only to Android 4.4.3 and higher. to remove EHS as the default launcher on Android versions prior to 4.4.3, follow the instructions (above) for manually uninstalling EHS using Android App Manager.

To manually change the default launcher on a device without removing EHS: (Android 4.4.3 and higher)

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.

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: