Enterprise Home Screen | Add a Full Screen Link to a Chrome Webpage

Ian Hatton -
3 MIN READ

Overview

This blog details a technique to manually add full screen Chrome shortcuts to the EnterpriseHomeScreen launcher. Unfortunately, this method can only work when manually configured on each device due to Google restrictions on creating pinned shortcuts . If the modified EHS XML file is re-deployed onto another device, the pinned shortcuts will not be present unless the same manual configuration is made (which will then create duplicate icons for any existing pinned shortcuts). For this reason it will require a one-off manual creation of the required shortcut(s) on each device.

Method

  1. Enable pinned shortcuts in enterprisehomescreen.xml – add the following tags to the existing file if not already present:
<pin_shortcuts>
    <pin_shortcuts_enabled>1</pin_shortcuts_enabled> <!-- 1=allow, 0=disable (default) -->
    <bypass_confirmation>0</bypass_confirmation> <!-- 1=bypass, 0=confirm (default) -->
</pin_shortcuts>

  1. Modify HTML source of starting webpage to make it full screen when run from a pinned shortcut by editing the <head> section to include the following :

<head>
    <!-- this is the text which will appear underneath the pinned shortcut -->
    <TITLE>MyWebApp</TITLE>
    <!-- this is the tag which Chrome looks for in order to run full screen (otherwise it will show the address bar by default) -->
    <meta name="mobile-web-app-capable" content="yes">
</head>

  1. To test on a clean-booted device, first install EHS, enable ADB and then copy the existing enterprisehomescreen.xml file to a PC e.g.

adb pull /enterprise/usr/enterprisehomescreen.xml

  1. Edit  enterprisehomescreen.xml on the PC to add the pin_shortcuts configuration section above and re-deploy it to the device under /enterprise/usr e.g.

adb push enterprisehomescreen.xml /enterprise/usr

  1. Zebra.com already has the required ="mobile-web-app-capable" so will run full screen from a pinned shortcut . Add Chrome to the EHS home screen in Admin mode and then run Chrome, browse to zebra.com, access the top right menu and select ‘Add to Home screen’

Graphical user interface, application</p>
<p>Description automatically generated

  1. The text shown above the line will be displayed under the pinned shortcut icon (shown on the right side). Edit the text to reduce the length in order to avoid formatting issues with other EHS icons after this shortcut is added to EHS.

Graphical user interface, text, application, chat or text message</p>
<p>Description automatically generated

  1. In this case the text is shortened to ‘Zebra’ – press Add to add the pinned shortcut and then OK to confirm that it should be added to EHS

A screenshot of a phone</p>
<p>Description automatically generated with medium confidenceGraphical user interface, application</p>
<p>Description automatically generated

  1. Icon and text are now added to EHS launcher – press icon to launch and Chrome will load the embedded URL in full screen mode (provided the "mobile-web-app-capable" tag is present).