Overview

Browser

The BlueFletch Browser is a configurable replacement for the device's default browser. The purpose of the BlueFletch Browser is to provide a more secure browsing experience and to make the settings adjustable. These adjustable settings allow for viewing the url, viewing the webpage title, viewing the cookies for the current url, lock the orientation of the view, and block access to insecure sites and hardware.

Features

Show URL: The ability to show/hide the web url to the user.

Show Title: The ability to show/hide the webpage title to the user. If a Shortcut Object is being used, the "label" value is the title that will be displayed.

Cookie Preview: The ability to allow/disallow the user to display the cookies for the current url. If this cookie display is allowed, a lock icon will appear in the top right corner. Selecting this icon will display the cookies.

Fix Orientation: The ability to lock the orientation of the view to portrait. Otherwise, the orientation of the view can flow between landscape and portrait based on the way the device is being held.

URL Editing: The ability to allow/disallow the user to edit the url when using the browser.

Default Homepage: The ability to set a default homepage when the browser is launched by clicking on the app.

Pinch To Zoom: The ability to allow/disallow pinching to zoom on webpages.

Allow Insecure Sites: The ability to allow/disallow access to insecure websites. By default, access to insecure websites are not allowed.

Camera Access: The ability to allow/disallow the browser access to the camera. By default, websites are not allowed to access the camera.

Audio Capture Access: The ability to allow/disallow the browser access to the microphone. By default, websites are not allowed to access the microphone.

Printer Access: The ability to allow/disallow the browser access to any printers. By default, websites are not allowed to access any printers.

Popup Windows: The ability to allow pop-up windows to display over webpage content within the browser.

Log Level: The ability to define the level of logs sent to Support Agent as "verbose", "debug", "info", or "error". If set, only that level of logs and below will be logged. By default, the browser sends "info" level logs.

Open in Desktop Mode: The ability to set a browser shortcut to open that website in desktop mode.

Third Party Cookies: The ability to allow/disallow websites to use/store third-party cookies.

Native APIs: Built-in Javascript APIs are accessible when enableEmsApi is true. Enables a web app to receive scan events for devices running Zebra Datawedge, and to call actions on Launcher Provider (e.g. returning a JSON of the current session) and the keyboard (e.g. starting and hiding keyboard).

User Agent: An optional replacement user agent string to send to the server; the server will process data from the application as if it was coming from a different web browser, as defined by the string. If not specified, will default to the device-provided user agent string.

Custom Script: Run custom Javascript functions that can be triggered on page load for a given URL or set of URLs. Please contact your BlueFletch representative for assistance implementing this.

Create DataWedge Profile: The ability to allow/disallow the automatic creation of a DataWedge profile on a Zebra device for the browser when it is first launched. By default, a DataWedge profile will be automatically created.

Examples

With All Settings Enabled

Settings Enabled

With All Settings Disabled

Settings Disabled

Configuration

The configuration settings to control the url display, title display, cookie display, fixed orientation, pinch to zoom, and blocking access are initially set with the Shortcut Object that is passed to the browser. If no settings are found within the Shortcut Object, the settings are pulled from the browser config settings. Descriptions of the various options can be found in the configuration page.

Example Default Browser Config Settings

This section in the launcher.json defines the default settings for browser instances on the device.

"browser": {
    "showUrl": false,
    "showTitle": false,
    "allowCookiePreview": false,
    "fixOrientation": false,
    "allowUrlEdit": false,
    "defaultHomepage": "https://bluefletch.com",
    "enablePinchToZoom": false,
    "allowInsecureSites": false,
    "allowCameraAccess": false,
    "allowAudioCapture": false,
    "allowPrinterAccess": false,
    "enableEmsApi": true,
    "logLevel": "info",
    "createDataWedgeProfile": true   
}

The above settings can be overriden for a given URL if defined within the Shortcut object in the application layouts. All above browser settings can be overriden for a Shortcut when specified within a browserOverrides object in the shortcut (starting Launcher 3.8.x). An example is shown below:

Example Layout Shortcut Object

"layouts" : {
    "AppGroupA" : [
        ...
        {
            "label" : "BlueFletch",
            "url" : "https://bluefletch.com",
            "icon" : "/sdcard/DCIM/icons/bluefletch_logo.png",
            "browser" : "com.bluefletch.ems.browser",
            "browserOverrides" : {
                "showTitle" : true,
                "fixOrientation" : true,
                "enablePinchToZoom" : true
            }
        },
        ...
    ]
}

Shortcut & Browser Config Settings:

Key	Description
showUrl	boolean Determines if the URL will be displayed to the user. Defaults to `false`.
showTitle	boolean Determines if the webpage title is displayed to the user. Defaults to `false`.
allowCookiePreview	boolean Determines if user can view the cookies for the current URL. This is used for development purposes. Defaults to `false`.
fixOrientation	boolean Determines if the view is fixed to portrait. Defaults to `false`.
allowUrlEdit	boolean Determines if the user is allowed to edit the URL. Defaults to `false`.
defaultHomepage	string URL of the website to be visited when the browser application is clicked. Defaults to a blank URL.
enablePinchToZoom	boolean Determines if the user is allowed to pinch to zoom within the webpage. Defaults to `false`.
allowInsecureSites	boolean Determines if the user is allowed to visit insecure websites. Defaults to `false`.
allowCameraAccess	boolean Determines if the website can access the camera. Defaults to `false`.
allowAudioCapture	boolean Determines if the website can access the microphone. Defaults to `false`.
allowPrinterAccess	boolean Determines if the website can access the printers. Defaults to `false`.
allowPopupWindows	boolean Determines if the website can display pop-up windows over webpage content within the browser. Defaults to `false`.
logLevel	string Determines the level of log to be logged in Support Agent. Valid values are `verbose`, `debug`, `info`, or `error`. If set, only the level of logs set and below will be logged. Defaults to `info`.
openInDesktopMode	boolean If used in a `browserOverrides` object and set to `true`, the browser will open the website with a user agent to tell the browser to render it in desktop mode. Defaults to `false`.
allowThirdPartyCookies	boolean Determines if the website can use/store third-party cookies. Defaults to `false`.
enableEmsApi	boolean Enable the Launcher Provider, Keyboard, and Scanner APIs to be used from a webpage. Defaults to `true`.
userAgent	string A replacement user agent string to send to the server; the server will process data from the application as if it was coming from a different web browser, as defined by the string. If not specified, will default to the device-provided user agent string. Can be overridden by the value in a shortcut's `browserOverrides`.
customScriptPath	string The file location, using the file path on the device or an asset, of a Javascript file applied to implement a custom behavior on the BlueFletch Browser.
createDataWedgeProfile	boolean Determines whether or not a DataWedge profile will be automatically created for the BlueFletch Browser when the application is first launched. Defaults to `true` (profile is automatically created). Applicable to Zebra devices only.

Notes

If the "allowCameraAccess" or "allowCookiePreview" is set to true, the overflow menu and title will be shown. If both are set to false, the overflow menu will be hidden.
If the "showUrl" or "showTitle" or "allowUrlEdit" is set to true, the toolbar will be shown. If all three are set to false, the toolbar will be hidden.
If the "defaultHomepage" is not set, the browser will not launch when the user clicks on the browser application and an error will be displayed.

Application Details

Package: com.bluefletch.ems.browser

After installing the application, set as default browser.