Zebra Workstation Connect Usage

Enterprise Browser 4.0

Overview

Apps using Enterprise Browser 3.3.0.5 (or later) can run on the secondary screen of supported devices using Zebra Workstation Connect, Zebra's enterprise solution that provides a desktop-like experience from a mobile device. The ZWC experience includes use of an external keyboard, mouse and secondary monitor with a Desktop separate from that of the device.

Requirements

  • One or more devices compatible with ZWC running Android 11 or later
  • Zebra Workstation Cradle (corresponding to device(s) in use)
  • LifeGuard OS update 11-20-18.00-RG-U00-STD-HEL-04 (or later) installed
  • Workstation Connect 1.3 (or later) installed
  • Enterprise Browser (com.zebra.mdna.enterprisebrowser_signed.apk) installed
  • HTML5-compliant EB app(s)
  • Touch-capable monitor (if app implements touch input)

See the following sections for important compatibility and runtime restrictions.
This solution supports the Zebra DS9308 USB scanner.

Usage Notes

  • An EB app running on the ZWC Desktop...
    • Closes when its top-left corner is clicked.
    • Goes to the background when its title bar is clicked.
    • Snaps to the Desktop's upper-left corner if device is undocked.
      To correct, dock device and re-launch app.
    • If moved to the device with soft input panel open, fails to invoke SIP on the device when an input fields gains focus.
      To correct, close SIP before moving app (also applies when moving from primary to secondary display).
  • The SAP bundle is NOT supported for running EB apps on the secondary screen.
  • The Enterprise Browser Feature Demo app cannot be run on the secondary screen.
  • Scrolling by dragging up/down with left mouse button is NOT supported.
  • Touch gestures are NOT supported for scrolling.
  • On-device debugging is NOT applicable to apps running on the Desktop.
  • Any app content relating to settings for screen resolution and/or user agent must be controlled internally by the app.
  • This solution supports the Zebra DS9308 USB scanner.

Unsupported Config Tags

The following configurable elements of the Config.xml file are not supported on (or do not apply to) apps running on the Zebra Workstation Connect Desktop.

Unsupported APIs

The following Enterprise Browser APIs are not supported on (or do not apply to) apps running on the Zebra Workstation Connect Desktop.

App ScrollBar Support

The <ScrollBar> attribute allows for a vertical scrollbar to be created and customized for apps running on the ZWC Desktop. Selection of scrollbar width (in pixels) and color are supported. When enabled, users can scroll by clicking on the scrollbar itself or on its up/down arrows, or by using a mouse wheel, if present.

Scrolling by dragging up/down with a mouse or finger is NOT supported.

Possible Values:

  • 0 - Disabled (default; scrollbar hidden)
  • 1 – Enabled (scrollbar shown)

See Config.xml reference for more information about this parameter's options.

Example


<ScrollBar>
    <ScrollBarEnable value ="1"/> 
    <ScrollBarWidth value  ="200"/>
    <ScrollBarColor value = ="#FF5733"/> 
</ScrollBar>

User Agent Info

The <UserAgent> attribute of the Config.xml file is supported for apps running on the ZWC Desktop. This parameter can be used to store information about the device’s operating environment to allow web sites to tailor content for optimal presentation. More info.

Example


<UserAgent value = “ Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/96.0.4664.45 Safari/537.36 "/>

APIs for ZWC

EB 3.4 (and later) includes the following API updates for use with Zebra Workstation Connect.

getConfigurationChangeNotification

Used for reading the displayID of the currently attached secondary display, as well as its screen height, width and density values. Optionally allows for registration for a JavaScript callback whenever changes occur to displayID or monitor orientation, allowing execution of additional JavaScript for adapting to the change.

See WebView API for details.

setUserAgent

Used to modify the default user agent of the current WebView instance.

See WebView API for details.

Also See