Zebra Enterprise Home Screen is a free Android app from Zebra Technologies that provides a simple way for administrators to control access to apps and settings on a Zebra device without the need to write custom code. Using a simple touch interface, EHS easily limits usage to one or more specified applications, prevents changes to device settings and locks down the file system. It can be configured in seconds, and settings can be deployed via MDM. EHS settings are stored in a simple XML file that's easy to read and edit by hand, if necessary.
EHS works by inserting itself in place of the stock Android app launcher and home screen. When first run, it presents a screen like the one below, offering a choice of which home app to open and whether to make the selection permanent. EHS also can be installed as the default launcher, bypassing the selector dialog.
Note: 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 the capabilities into a single tool, but does NOT provide a complete lockdown for securing devices. For maximum security, Zebra recommends using EHS with additional security options provided by Android and Zebra’s MX (via EMDK or StageNow).
Enterprise Home Screen supports the following languages:
- US English
- Simplified Chinese
The first time it's installed*, EHS presents the admin with this simple choice:
Selecting "Always" locks EHS in as the default home app and locks users out of the following device features by default:
- USB debugging
- Access to the file system
- Access to the Search app
- Keyguard-screen camera and search functions
- Full access to the System Settings panel
- Recent apps button
Administrators can grant or restrict access to individual features or hide the settings panel entirely.
* Applies only to devices running Android 11. For more info, see Android 13 Notes.
After selecting "Always," wait 10 seconds before restarting to ensure the change remains persistent.
- Now supports Zebra devices running Android 13† (support remains for devices running Android 11)
- Support terminated for Android 10.0. EHS 5.0 was the final version supporting devices running Android 10.0 and earlier.
- NEW GUIDE: Using Managed Configurations with EHS
† See important Android 13 Notes, below.
EHS 6.0 adds support for Zebra devices running Android 13, which currently includes TC21, TC53 and TC73.
The WS50 is a full-featured wearable touch computer with a two-inch screen.
Part of the EHS User Screen retracts (above, right) when scrolling on the WS50.
Click image to enlarge; ESC to exit.
- Privileged Settings feature not supported on WS50 devices. See Zebra Recommendations, below.
- A WS50-specific
enterprisehomescreen.xmlconfig file is NOT required; a single file can be created and deployed to all supported devices.
- Config-file destination folder is the same for all devices:
enterprisehomescreen.xmlfile cannot be edited or viewed on the WS50.
- The following EHS features are deactivated when running on WS50:
- Quick view
- Wireless info
- Battery info
- Icon Settings (App Icon Size "medium" by default)
- Tools -> Export Config
- Tools -> Privileged settings
- Before installing EHS on a WS50 for the first time, push a config file to the device to enable USB debugging, the System settings panel and Android Quick Search. This manually enables Privileged Settings to simplify administration after EHS is installed. See below for config-file details.
- To prevent user access to the Settings panel, push a second config file to the device that includes removal of the System settings app from the enabled apps list before deployment to users.
- Configure settings intended for WS50 targets on a device with a full-sized display, then deploy to and test on a WS50 before wider deployment.
<preferences> <usb_debugging_disabled>0</usb_debugging_disabled> </preferences>
<preferences> <system_settings_restricted>0</system_settings_restricted> </preferences>
<preferences> <apps_enabled> <application package="com.android.settings"/> </apps_enabled> </preferences>
<preferences> <apps_enabled> <application package="com.android.quicksearchbox"/> </apps_enabled> </preferences>
- About the WS50 | Description, use cases, specs
- WS50 Programmer's Guide | Guidelines for writing small-screen apps with limited device resources
- Additional WS50 Resources | Using WS50 with DataWedge; Demo App
Applies to devices running Android 13.x and later.
- Before upgrading a device to Android 13, any previous EHS version MUST BE REMOVED. Failure to do so might cause the device to become unusable.
- After installation, EHS must be designated as the default Home app (launcher).
To set the default Home app:
- Long-press EHS App icon and select App Info
- Go to Settings > Apps > Default apps > Home app
- Long-press EHS App icon and select App Info
Also see other Upgrade Notes in Setup Guide.
Applies to devices running Android 11.x and later.
- On devices with OSX 11.5.21 or later, Reduced Access to Android system settings also enables Accessibility features. Learn more.
- Use of the split screen feature requires the Recent Apps button to be unblocked. Learn more about Android multi-window features.
- On devices running Android 11, split-screen mode cannot be accessed directly by long-pressing the Recent Apps button.
To run two apps side-by-side:
- Set the Recent Apps Access Disabled parameter to "Disabled" (unchecked in UI; "0" in config file)
- Select "Enable both" in the Recent Apps Button Actions parameter ("0" in config file)
- Short-press the Recent Apps button on device to display list of recent apps
- Long-press one of the apps desired for split screen to display its options, then select "Split Screen"
- Now available from Google Play or the Zebra Support Portal
- Now supports Managed Configurations for remote configuration through an EMM system.
- System Setting Restricted feature now supports:
- Restricted system settings with or without Android accessibility features (Requires Android 11+. See device requirements)
- Enhances Recent App Button behavior:
- Short press lists recently launched apps (default behavior)
- Long press enables split screen, allowing two apps to be displayed side by side
- New package name (requires uninstallation of any prior version)
- Older EHS versions and package names are deprecated
- Device OS image update might be required (see below)
- EHS 5.0 requires the following Android version-specific LifeGuard updates:
- Devices running Android 10:
- Devices running Android 11:
- Devices running Android 10:
EHS 5.0 adds support for TC58, TC73 and TC78 devices running Android 11.
- Adds support for ET40 and ET45 devices running Android 11 (or later)
- Numerous enhancements and bug fixes
- EHS 4.2 now fully supports Google TalkBack , which helps with device interaction for the visually impaired. TalkBack behavior is now consistent with that of Google when identifying app icons and labels in the EHS launcher.
- Now supports Zebra TC53 and WS50 devices running Android 11. See WS50 Notes
EHS 4.2 adds support for TC53 and WS50 devices running Android 11.
- New Screen Blanking feature disables touch input when the device is in motion, adding a measure of safety when EHS is used in vehicle applications.
- Supports devices running Android 11.
No new supported devices added.
- Now supports Zebra devices running Android 10 as well as Android 9.x Pie and 8.x Oreo.
- To enhance device and network security, EHS by default now hides potentially sensitive wireless device info in User Mode.
Optionally, an administrator can display wireless settings, if desired.
- Recently Launched Apps can now be shown or hidden from the User as desired by an administrator.
EHS 4.0 adds support for the following devices running Android 10:
- Now supports ONLY Android 8.x (Oreo) and Android 9.x (Pie).
- EHS 3.2 download package contains a single .apk file compatible with all supported devices running Oreo and Pie.
- Bypass user confirmation dialog when adding Pinned shortcuts is a configurable option designed to aid automated shortcut creation by suppressing the dialog that appears when a shortcut is added. Disabled by default.
- EHS can now launch links that reference local files though a “URL” tag (i.e. "file://*.html") on devices running Android 8.x Oreo (and later) if files reside on internal or external storage (i.e. SD card).
Support for Android 7.x Nougat is dropped. Use EHS 3.1 if Nougat support is required.
Support for Install Shortcuts is dropped. This feature was coupled with Android Nougat, and is no longer supported with the termination of Nougat support. As an alternative, Zebra recommends the use of Pinned Shortcuts, which are supported in devices running Android Oreo and later.
Support ends for the following devices running Nougat: MC33, TC20, TC25, TC51, TC56, TC70x, TC75x, VC80x, WT6000
- Now supports ONLY Android 8.x (Oreo) and Android 7.x (Nougat).
- New Lockout Recovery mode allows an admin to quickly return a device to service that is locked after exceeding the maximum number of unsuccessful admin login attempts and to set the period of time (in minutes) the device must be locked before Lockout Recovery is possible.
- Now supports Android Multi-user mode, which allows administrators to create Primary and Secondary device users, any of which can share a single EHS global configuration. Applies to devices running Android 8.1.0 and higher only.
- Compatible with GMS Restricted Mode - an optional state on Zebra devices that disables GMS applications and services (i.e. Gmail, Google Maps, etc.) on the device based on administrator preferences. See the Special Features section for important information about related EHS behaviors.
- Support for Android 6.x Marshmallow is dropped. Use EHS 3.0 if Marshmallow support is required.
Applies to devices running Android 8.x Oreo and later.
- SSID and BSSID information do not appear in the "Wireless Info" or "Battery and Wi-Fi Quick View" screens on Oreo devices if Location services (Settings -> Security & Location -> Location) are turned off.
- If the operating system on a device (except TC20/TC25) is being upgraded to Android 8.1 Oreo from Marshmallow or Nougat, the previous EHS installation must be removed before EHS 3.1 is installed. Follow instructions to uninstall EHS before installing EHS on an Oreo device. Prior configuration settings, if any, are re-applied automatically.
Applies to devices running Android Nougat 7.x and later:
- Disabling access to the camera and/or search apps from the lock screen also might disable them from the User-Mode screen, even if camera/search usage is permitted on the device. This occurs on some devices running Android N (and later) if the device is rebooted from the lock screen. To prevent this issue, use the Screen Lock Type parameter of DevAdmin CSP and disable the lock screen by selecting the "None" option.
- When referencing a file stored on a removable SD Card in a device running Android N (and later), references to that card must include its symbolic link rather than its direct path. For example, while the file path on pre-M devices might be visible as
/storage/sdcard1/image.png, the same path on M and N devices might appear in the file browser something like
/storage/0097-B7BA/image.png. The symbolic link (which in this case is "0097-B7BA") is unique to the device. Therefore, Zebra recommends avoiding the use of removable storage in mass-deployment scenarios.
- Airplane Option Disabled feature cannot be controlled through EHS on devices running Android N. For devices on which the "Airplane option disabled" feature appears "grayed out" in the Admin-Mode Preferences panel, it might still be possible to access the feature using the Power Key Manager through Zebra EMDK or StageNow tools.
- Some devices retain the "Recent Apps" list after device reboot, posing a potential security risk. EHS disables the Recent Apps button on Nougat (and later) devices to help address this risk. For all devices, the list can be cleared using App Manager through Zebra EMDK, StageNow or a third-party MDM system. For more information, see Security Notes in the Special Features section.
- Kiosk Mode should not be used with Screen Pinning, an Android feature that works in a similar way.
- Screen orientation can be changed through the Quick Settings panel on devices only when EHS is configured to accept the System orientation setting (the EHS default). If an EHS administrator sets the orientation to landscape or portrait mode, the device user will no longer be able to change the orientation setting.
- Support added for devices running Android 8.1 Oreo.
- Supports Pinned Shortcuts feature of Oreo similar to traditional shortcuts.
- Foreground services can now be auto-launched in devices running Oreo.
- VectorDrawable format supported for app launcher icons. Learn more.
- Privileged Settings feature requires manual activation of certain settings when entering Admin Mode on a device.
- The default
Config.xmlfile now places the DataWedge Demo app in the User screen, replacing the Calculator app found in prior versions.
ABOUT OREO UPGRADES: If the operating system on a device (except TC20/TC25) is being upgraded to Android 8.1 Oreo from Marshmallow or Nougat, the previous EHS installation must be removed before EHS 3.0 is installed. Follow instructions to uninstall EHS before installing EHS on an Oreo device.
Note: Prior configuration settings, if any, are re-applied automatically.
EHS 3.0 now supports these devices running Android 8.1 Oreo
- PS20 Personal Shopper
- Support for Android 5.x Lollipop is dropped. Use EHS 2.8 if Lollipop support is required.
- Bypass Keyguard feature is dropped - Use DevAdmin through Zebra EMDK or StageNow tools to configure this setting. NOTE: Bypassing the keyguard in this way requires the Settings app (com.android.settings) to be enabled on the device; EHS disables it by default. Therefore, Zebra recommends bypassing the keyguard before EHS is installed or launched for the first time.
- Secure Mode feature is dropped - Log files are no longer designated as "SECURED" or "UNSECURED" in log entries.
EHS 2.8 adds support for the following devices running Android Nougat:
Simplified Chinese - EHS has been approved to run on device operating systems localized for the Simplified Chinese language.
Enhanced Device Identifier Options - Information to uniquely identify a device—its serial number, MAC address, network host name, Bluetooth address, Bluetooth name or IMEI number—can be displayed as the title bar text of the EHS home screen.
Custom EHS icon no longer limited to home screen - When a custom icon is used to replace the stock EHS icon, the icon can optionally be set to also display on other screens, including those for Battery Info, Wireless Info, Preferences and the Tools menu.
File browsing in Preferences panel - When selecting a title-bar icon or wallpaper image through the Preferences panel, tap-navigation is now possible to locate the image file and specify its path. File location is no longer limited to
Airplane mode enable/disable option is displayed in the Preferences panel only on devices on which it is supported.
Disabling access to the camera and/or search apps from the lock screen no longer disables them from the User-Mode screen if camera and/or search usage are permitted on the device. This issue arose when rebooting from the lock screen, and has been fixed for TC20 and TC25 models as well as devices running KitKat, Lollipop, Marshmallow. See Android Nougat Notes.
Password encryption has been enhanced for the Admin login. See important notes.
A colored screen is displayed while EHS is starting up.
Wallpaper and Title Bar Icon features now support .bmp, .gif, .jpg, .png and .webp file formats and file location is no longer limited to
- Secure Mode remains supported but is no longer being advanced
- The following features have been removed from EHS 2.8 and later:
- Enable/disable status bar pull-down
- Enable/disable status bar settings icon
- Enable/disable "exit instead of reboot"
- The discontinued features listed above can be accessed using Zebra's StageNow administrative tools or EMDK developer tools.
- A config file that contains settings for discontinued features generates an error in the EHS log file.
This version does not support Android KitKat.
EHS 2.7 supports Zebra devices running Android Lollipop and later only. Zebra continues to support earlier versions of EHS for use on devices running KitKat. To use EHS on a device running KitKat, please download EHS 2.6 or an earlier version.
EHS 2.7 adds support for the following devices running Android Nougat:
( * ) Requires a device-specific .apk file. See download page for details.
- Enable/Disable Recent Apps button on Android Nougat devices
- Enable/Disable EHS Logging and set a maximum log file size
- Battery Health Percentage now displayed on Battery info and Quick info screens on devices equipped with Zebra Power Precision Plus battery
- Enable/Disable wallpaper stretching to expand an image to fill the device screen
- Support for ET50/ET55 tablet computers running Marshmallow
- MC32 running Android 5.1.1 Lollipop
- TC51/TC56 and TC75x Touch Computers running Android Marshmallow 6.0.1
- ET50/ET55 Tablet Computers running Android Lollipop 5.1.1
- TC8000 Touch Mobile Computer and Scanner running Android Lollipop 5.1.1
- TC70/TC75 Touch Computers running Android Lollipop 5.1.1
- The MC67 Mobile Computer Series running Android 4.4 KitKat
- Devices with Android 4.1.2 Jelly Bean
- TC70 with Android 4.4.2 KitKat (BSP version 112414)
Zebra continues to support EHS on the TC70 with Android 4.4.2 KitKat and on Zebra devices running Jelly Bean. Download EHS 2.4 to target these devices.
Easier download and installation. The EHS 2.5 download package now includes a single APK for installing on all supported Zebra devices; no more multi-APK installer.
Now links to TechDocs, Zebra's premier web site for user-facing documentation--now a standard component on every EHS installation.
Support for the Zebra WT6000 - wearable terminal running Android 5.0 Lollipop.
Bundle Data Option - allows injection of app parameters, user data or other key-value pairs into an app on launch.
App Launch Flags - permit one or more Android Intent flags to be specified when an application is launched, directing launch behavior as required.
Service Auto-Launch - permits one or more Android services to be started whenever EHS launches.
Wildcard Character - reduces the lines of code required in the EHS config file to specify apps for display in User Mode.
Custom App Icons - permits customized icons for apps and links, overriding the default system icons.
Custom Title-bar Icons - permits a custom icon to be displayed in the EHS Title Bar, overriding the default EHS icon.
App Icon Size - provides five sizes for Admin- and User-mode application icons.
Battery and Wi-Fi Quick View - displays real-time status of the device battery and Wi-Fi signal on a single screen.
App Icon Label Text Color - is now white on a transparent background to improve readability.
- Enable/disable device reboot when EHS is first launched after installation.
- TC8000 KitKat version 4.4 support (added January, 2016)