Audience

 

Overview

This blog details a technique to manually add fullscreen Chromium shortcuts to the EnterpriseHomeScreen launcher running on the WS50. This will allow any suitable webapp to run without showing the address bar i.e. the user will be locked into the selected webpage/webapp. It also provides an alternative to Enterprise Browser which is not currently supported on the WS50. (A PDF version of this blog is attached for reference.) 

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. A PDF of this blog with images is attached. 

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

Alternatively, you can install EHS for WS50 via the StageNow barcode below (requires a pre-configured internet connection) which already has the required configuration changes made:

A picture containing text, indoor, white</p>
<p>Description automatically generated

  1. Zebra.com already has the required ="mobile-web-app-capable" so will run fullscreen from a pinned shortcut .  Run Chromium from EHS either by using the supplied WebApps shortcut or creating a new shortcut via the Add Apps link . Optionally enter a test URL such as zebra.com (not required if you use the WebApps icon as shown below ) and then from the 3 dot menu at top right, select ‘Add to Home screen’.

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

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). If necessary, 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, application</p>
<p>Description automatically generated 

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

Graphical 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 ).

Timeline</p>
<p>Description automatically generated with medium confidence Text</p>
<p>Description automatically generated

  1. By default the Notification bar will not be visible but is enabled can be accessed via dragging from the top down – this behaviour can be modified using Mx to either lock the Notification bar (pulldown disabled) or remove it completely (not recommended).  

  1. Barcode scanning support can be provided using Datawedge i.e. create a profile for Chromium on another Zebra device such as TC52 , edit the profile as required e.g. to add an Enter to each scanned barcode and then export the profile and re-import it on the WS50 by pushing it via ADB to the autoimport folder:

Adb push dwprofile_HelixWeb.db /enterprise/device/settings/datawedge/autoimport

  1. Sample webapps formatted for WS50: