Config.xml Reference - Zebra Technologies TechDocs

Sets the path to an existing directory for storage of web storage databases. Case sensitive.

Possible Values:

Fully qualified local path

Note: The file systems of some operating systems are case-sensitive. For cross-platform compatibility, letter case for URL, file and path references in the Config.xml file should be identical to those of the sources.

Example


<WebStorageDBPath value="file:///path-to-web-storage"/>

WebSQLDBQuota

Applies only to Windows Mobile/CE using the Zebra Webkit. Sets the maximum per-database quota for Web SQL databases.

Possible Values:

Size in bytes

Example


<WebSQLDBQuota value="20000"/>

WebSQLDBPath

Applies only to Windows Mobile/CE using the Zebra Webkit. Path to an existing directory to store Web SQL databases. Case sensitive.

Possible Values:

Fully qualified local path

Note: The file systems of some operating systems are case-sensitive. For cross-platform compatibility, letter case for URL, file and path references in the Config.xml file should be identical to those of the sources.

Example


<WebSQLDBPath value="file:///path-to-sql-db"/>

ApplicationCache

ApplicationCacheEnabled

Applies to only to Android devices running KitKat and higher. Allows an HTML5 app to be stored locally for off-line operation, improved speed and reduced server load. Disabled by default. Note: This is unrelated to the web cache feature.

Possible Values:

0 - Do not cache (default)
1 - Cache HTML5 apps

Example


<ApplicationCacheEnabled value="0"/>

ApplicationCacheOnExit

Applies only to Android devices running KitKat and higher. Erases the HTML5 Application Cache app upon exiting the app. Note: This is unrelated to the web cache feature. Disabled by default.

Possible Values:

0 - Do not clear the cache on exit (default)
1 - Clear the HTML5 app cache on exit

Example


<ApplicationCacheOnExit value="0"/>

ApplicationCacheQuota

Applies to Windows Mobile/CE using the Zebra Webkit only. Application Cache data maximum quota per application.

Possible Values:

Integer specifying cache size (in bytes)

Example


<ApplicationCacheQuota value="20000"/>

ApplicationCachePath

Applies only to Windows Mobile/CE using the Zebra Webkit. Path to an existing directory to store Application Cache data.

Possible Values:

Fully qualified local path

Example


<ApplicationCachePath value="file:///path-to-app-cache"/>

NPAPI

NPAPIDirectory

Not applicable to the Enterprise Tablet:

Path to an existing directory containing the NPAPI Plug-ins. Not applicable to the Enterprise Tablet. Case sensitive.

Possible Values:

Fully qualified local path

Note: The file systems of some operating systems are case-sensitive. For cross-platform compatibility, letter case for URL, file and path references in the Config.xml file should be identical to those of the sources.

Example


<NPAPIDirectory value="file:///path-to-NPAPI-dir"/>

Preloads

Preload

Defines plug-ins to be pre-loaded rather than loading as needed by a program function. Pre-loading prevents application lag when a program function is called for the first time. For example, when Barcode.enable is called by an app, a slight lag will be seen as the Barcode DLL loads into memory. Specify a Preload tag for each module to be loaded when Enterprise Browser starts up. While multiple modules may be defined in the same DLL, list all pre-loaded modules for maximum benefit. For memory-constrained devices, pre-load all required modules to prevent an out-of-memory condition during execution. Does not apply to the Enterprise Tablet; plug-ins are integral to Enterprise Browser on this platform.

Possible Values:

Module name

Example


<Preload value="MyModule"/>

PreloadLegacyActiveX

Applies only to Windows Mobile/CE with the Zebra Webkit. Determines whether to pre-load the ActiveX object in webkit. Use this for backward compatibility with code written in PocketBrowser that used the ActiveXObject.

Possible Values:

0 - Do Not Preload
1 - Preload

Example


<PreloadLegacyActiveX value="1"/>

PreloadLegacyGeneric

Applies to Windows Mobile/CE with the Zebra Webkit only. Determines whether to preload the NPAPI plugin to mimic the Generic ActiveX object in Webkit. On the Enterprise Tablet this plug-in is automatically loaded when the JSObjects plug-in is preloaded.

Possible Values:

0 - Do Not Preload
1 - Preload

Example


<PreloadLegacyGeneric value="1"/>

PreloadLegacyODAX

Not applicable to the Enterprise Tablet. Determines whether to pre-load the NPAPI plug-in to mimic the ODAX ActiveX object in Webkit.

Possible Values:

0 - Do Not Preload
1 - Preload

Example


<PreloadLegacyODAX value="1"/>

PreloadLegacyAirBeam

Not applicable to the Enterprise Tablet. Determines whether to pre-load the NPAPI plug-in to mimic the AirBeam ActiveX object in Webkit.

Possible Values:

0 - Do Not Preload
1 - Preload

Example


<PreloadLegacyAirBeam value="1"/>

PreloadLegacyAPD

Determines whether to pre-load the NPAPI plug-in to mimic the APD ActiveX object in Webkit.

Possible Values:

0 - Do Not Preload
1 - Preload

Example


<PreloadLegacyAPD value="1"/>

PreloadJSObjects

Determines whether to pre-load the NPAPI plug-in to provide native JavaScript objects for each of the modules. On the Enterprise Tablet, this plug-in will be included if the JSObjects plug-in is preloaded.

Possible Values:

0 - Do Not Preload
1 - Preload

Example


<PreloadJSObjects value="1"/>

Scrolling

ScrollTechnique

Not supported on Android or on Windows CE devices that use the IE rendering engine. Specifies the technique used to scroll the viewport. The FingerScroll setting permits scrolling around a page with finger swiping (may interfere with drawing on a Canvas element). Scrollbars will be presented when the page is too large to fit the viewport. A value of "None" will display no scrollbars and cause the page to be unresponsive to finger swipes.

Possible Values:

FingerScroll
Scrollbars
None

Example


<ScrollTechnique value="FingerScroll"/>

Application

MixedContentMode

Applies only to Android devices running Lollipop and higher. Controls loading of content from insecure sites based on the security level of the originating app. For example, if the app is loaded from a site secured with https://, MIXED_CONTENT_NEVER_ALLOW mode will block subsequent content requests that do not originate from similarly secured sites.

MIXED_CONTENT_NEVER_ALLOW - Most secure option. WebView prevents apps loaded from a secure origin to load content from an insecure origin.
MIXED_CONTENT_ALWAYS_ALLOW - Least secure option. WebView allows an app from a secure origin to load content from all origins, secure or insecure.
MIXED_CONTENT_COMPATIBILITY_MODE - Security not explicitly defined. Depending on its origin, some content will be allowed and some will be blocked. This mode is designed to provide a measure of security for apps that cannot predict or control the origin of content to be rendered.

Zebra recommends using MIXED_CONTENT_NEVER_ALLOW for maximum security.

Possible Values:

MIXED_CONTENT_ALWAYS_ALLOW
MIXED_CONTENT_NEVER_ALLOW
MIXED_CONTENT_COMPATIBILITY_MODE

Example


<MixedContentModevalue="MIXED_CONTENT_NEVER_ALLOW"/>

NavigateToHomePage

Applies only to Android devices running KitKat and higher. Causes an app to display its StartPage (aka "HomePage") when the app returns to the foreground after the HOME key has been pressed. When disabled (value=0), app will resume its most recent activity when returning to the foreground. Disabled by default. See also ClearWebData.

Possible Values:

0 - Do not return to StartPage (default)
1 - Return to StartPage

Example


<BackgroundOnHomeKeyPressed>
    <NavigateToHomePage value="0"/>
</BackgroundOnHomeKeyPressed>

ClearWebData

Applies only to Android devices running KitKat and higher. Determines whether cookies and other WebView data stored by the app will be erased when app returns to the foreground after the device HOME key is pressed. Disabled by default. See also NavigateToHomePage.

Possible Values:

0 - Do not erase web data (default)
1 - Erase web data when app returns to foreground

Example


<BackgroundOnHomeKeyPressed>
    <ClearWebData value="0"/>
</BackgroundOnHomeKeyPressed>

WebFilteringEnabled

Applies only to Android devices. Controls whether web sites will be filtered by URIs specified in the related WhileListingUrls (explicitly allowed) and BlackListingUrls (explicitly blocked) configuration tags. Disabled by default. If this parameter is enabled (value=1) and no URIs are specified in the related parameters, no web addresses will be blocked.

Other important rules apply. See related parameters, below.

Possible Values:

0 - Disabled (default)
1 - Enabled

Example


<WebFiltering>
    <WebFilteringEnabled value="0"/>
</WebFiltering>

WhiteListingUrls

Applies only to Android devices. Explicitly allows one or more websites to be visited by an app when WebFilteringEnabled tag is enabled (value =1). If WebFilteringEnabled is enabled and this parameter is left blank, users will have access to all URIs except those specified in the BlackListingUrls parameter. Failure to specify URIs according to regular expressions, or attempting to access a page that is blacklisted (or not whitelisted, as applicable) will display the BadLinkURI message.

Possible Values:

One or more Uniform Resource Identifiers (URIs) and/or protocol identifiers (i.e. http://)
Multiple entries can be separated by a semicolon (;)
Wildcard character (*) supported (i.e. https://*.*; *.MySite.com; www.*)

Example


<WebFiltering>
    <WhiteListingUrls value="https://127.0.0.1;www.gmail.com"/>
</WebFiltering>

BlackListingUrls

Applies only to Android devices. Explicitly blocks one or more websites when WebFilteringEnabled is enabled (value=1). If WebFilteringEnabled is enabled and this parameter is left blank, apps will have access only to URIs specified in the WhiteListingUrls parameter. Failure to specify URIs according to regular expressions, or attempting to access a page that is blacklisted (or not whitelisted, as applicable) will display the BadLinkURI message.

Possible Values:

One or more Uniform Resource Identifiers (URIs) with or without protocol identifiers (such as http://)
Multiple entries can be separated by a semicolon (;)
Wildcard character (*) supported (i.e. https://*.*; *.MySite.com; www.*)

Example


<WebFiltering>
    <BlackListingUrls value="www.yahoo.com;https://www.rstudio.com/"/>
</WebFiltering>

HTTP_Proxy

Applies to the Zebra Webkit engine on WM/CE devices and to the stock webkit on Android. Specifies the URL and port number for the HTTP proxy. Leave this field blank if no proxy is to be used. Supported on WM/CE only when Zebra Webkit is used; proxy settings for Internet Explorer are picked up from the Windows connection manager.

Possible Values:

URL: PortNo

Example


<HTTP_Proxy value="http://my.proxy.com:8080"/>

HTTPS_Proxy

Applies to the Zebra Webkit engine on WM/CE devices and to the stock webkit on Android. Specifies the URL and port number for the HTTPS proxy. Leave this field blank if no proxy is to be used. Supported on WM/CE only when Zebra Webkit is used. Not otherwise supported on WM/CE; use HTTP_Proxy instead.

Possible Values:

URL:PortNo

Example


<HTTPS_Proxy value="https://my.proxy.com:8181"/>

No_Proxy

Applies to Windows Mobile/CE only. Used to specify sites to be accessed directly rather than through a proxy. Accepts a comma-separated list of host names, domain names (beginning with a dot), IP addresses, or CIDR-format IP network addresses. Examples: myhost, .mydomain.com, 192.168.1.1 and 192.168.0.0/24.

Possible Values:

Comma-separated list of direct access addresses

Example


<No_Proxy value="*.my_app.com,http://internal.site.com"/>

isWindowsKey

Applies to Android devices with PocketBrowser or RhoElements 2.x or 4.x KeyCapture API only. Allows hardware keys of an Android device running Enterprise Browser 1.2 (or later) to mimic Windows Mobile keycodes when used with the KeyCapture API of PocketBrowser or RhoElements 2.x or 4.x. When enabled, the application will substitute normal Android keycodes with the Windows Mobile function keycode values for all keys. This can be useful for supporting both Android and Windows device platforms with a single codebase. If set to 0 or not present, the application will receive Android function keycode values.

Possible Values:

0 - Disabled (default); Android keycodes are used for all function keys
1 - Enabled; Windows Mobile keycodes are substituted for all Android function keys

Example


<isWindowsKey value="1"/>

usedwforscanning

Applies to Android only. Controls whether to 'use DataWedge (DW) for scanning' or to go through Enterprise Browser APIs. Additional settings adjustments might be required to use this tag. See the DataWedge Usage Guide for important details about DataWedge configuration and potential conflicts with Enterprise Browser.

Possible Values:

0 - Enable scanning through Enterprise Browser APIs (default; DataWedge disabled)
1 - Enable scanning through DataWedge (Enterprise Browser scanning disabled)

Example


<useDWforScanning value="0"/>

DisableHardwareAcceleration

Applies to Android KitKat and higher only. Controls whether hardware acceleration at WebView level within an Enterprise Browser app is disabled. By default, acceleration is enabled (tag value=0).

Possible Values:

0 - Enable hardware acceleration at WebView level (default)
1 - Disable hardware acceleration at WebView level

Example


<DisableHardwareAcceleration value="0"/>

Authentication

Username

WARNING: Free-form text fields (i.e. username and password) can accept alpha-numeric characters only. Entering non-text characters (< > \ / " ') in these fields will corrupt the Config.xml file.

Applies to Android and Windows Mobile/CE. Specifies the username to be provided automatically when Enterprise Browser is instructed to navigate to a page that requires basic or digest HTTP authentication. If this setting is absent, a login prompt will be displayed with a username of (“”). Enterprise Browser will permit multiple incorrect entries before presenting the 'HTTP 401 Unauthorized' page.

Possible Values:

Username string

Example


<Username value="username"/>

Password

WARNING: Free-form text fields (i.e. username and password) can accept alpha-numeric characters only. Entering non-text characters (< > \ / " ') in these fields will corrupt the Config.xml file.

Applies to Android and Windows Mobile/CE. Specifies the password to be provided automatically when Enterprise Browser is instructed to navigate to any page that requires basic or digest HTTP authentication. If this setting is absent, a login prompt will be displayed with a password of (“”). Enterprise Browser will permit multiple incorrect entries before presenting the 'HTTP 401 Unauthorized' page. When used with IE engine, will permit multiple incorrect entries.

Possible Values:

Password string (alpha-numeric characters only)

Example


<Password value="password"/>

ExitPasswordEnabled

When enabled, prompts for a password when quitting an Enterprise Browser app. Password is stored using the ExitPasswordValue tag. Disabled by default.

Possible Values:

0 - Disabled (default)
1 - Enabled

Example


<ExitPasswordEnabled value="0"/>

ExitPasswordValue

WARNING: Free-form text fields (i.e. username and password) can accept alpha-numeric characters only. Entering non-text characters (< > \ / " ') in these fields will corrupt the Config.xml file.

Contains the password for quitting Enterprise Browser when function is enabled using the ExitPasswordEnabled tag. Can be edited only when ExitPasswordEnabled tag is set to "1" and cannot be left empty.

Possible Values:

Password string (alpha-numeric characters only)

Example


<ExitPasswordValue value="zebra123"/>

SettingsButtonEnabled

When enabled, places a settings button at the bottom right corner of all screens that routes to the settings page. NOTE: When the IE engine is used on a Windows CE device, this feature might cause screen distortion when scrolling.

Possible Values:

0 - Disabled (default)
1 - Enabled

Example


<SettingsButtonEnabled value="1"/>

SettingsPageProtectionEnabled

When enabled, prompts for a password before allowing access to the Settings page. Password is stored using the SettingsPagePassword tag. Default password = "admin" if none is entered.

Possible Values:

0 - Disabled
1 - Enabled

Example


<SettingsPageProtectionEnabled value="0"/>

SettingsPagePassword

WARNING: Free-form text fields (i.e. username and password) can accept alpha-numeric characters only. Entering non-text characters (< > \ / " ') in these fields will corrupt the Config.xml file.

Contains the password for accessing the Settings page when password function is enabled using the SettingsPageProtectionEnabled tag. Can be edited only when SettingsPageProtectionEnabled tag is set to "1" and cannot be left empty. Default password = "admin" if password is enabled and no password is entered.

Possible Values:

string (password, empty by default)

Example


<SettingsPagePassword value="zebra"/>

HTMLStyles

BackgroundColor

Applies only to Android devices running KitKat and higher. Controls the color of the screen in areas other than those of the app (if not already set by app HTML).

Possible Values:

Any 32-bit hexadecimal HTML color code value

Examples


//Set background color to BLACK 
<BackgroundColorvalue="0xff000000"/> 

//Set background color to YELLOW
<BackgroundColorvalue="0xffffff00"/>

//Make background TRANSPARENT
<BackgroundColorvalue="0x00000000"/>

DomStorageEnabled

Applies only to Android devices running KitKat and higher. Controls whether application data is stored locally using HTML5 Web Storage. Enabled by default.

Possible Values:

0 - Disabled
1 - Enabled (default)

Example


<DomStorageEnabled value="1"/>

DatabaseEnabled

Applies only to Android devices running KitKat and higher. Controls whether to enable the Web SQL database, an HTML5-specific feature that implements a set of APIs to manipulate client-side databases using SQL within a single transaction. Disabled by default.

Enterprise Browser can use Web SQL to sequentially process:

A single SQL statement string
An array of SQL statement strings
An array of SQL statement objects
A string containing multiple SQL statements (separated by semicolons)
SQL statements from a file stored on the device

The following Web SQL methods are supported:

openDatabase creates a database object using a new or existing database
transaction controls a transaction and/or perform a commit or roll-back
executeSql executes one or more SQL queries

Possible Values:

0 - Disabled (default)
1 - Enabled

Example


<DatabaseEnabledvalue="0"/>

GeoLocationEnabled

For Android, applies only to GMS devices running KitKat and higher. Controls HTML5 Geolocation functionality. When enabled on a device that supports geolocation and the device is in range of a GPS network, the geolocation data is returned to the defined JavaScript callback. When disabled, the defined JavaScript error callback is called, notifying the app that the permission to use geolocation is denied. Note the upper-case "L" in the Android version of the tag.

Possible Values:

0 - Disabled
1 - Enabled

Android Example


<HTMLStyles>
    ...
    <GeoLocationEnabled value="0"/>
    ...
</HTMLStyles>

Windows Mobile/CE Example


...
<Geolocation>
    <GeolocationEnabled value="1"/>
</Geolocation
...

CaretWidth

Applies only to Windows Mobile/CE with Webkit. Specifies the width (in pixels) of the textbox / text-area caret. Accepts values from 1-5. If unspecified, a default value of "1" will be entered.

Possible Values:

Integer values from 1-5 for caret width (in pixels)

Example


<CaretWidth value="3"/>

ClearTypeEnabled

Applies to Windows Mobile only. Controls whether ClearType is used.

Possible Values:

0 - Disabled
1 - Enabled

Example


<ClearTypeEnabled value="0"/>

FitToScreenEnabled

Applies to Windows Mobile with IE rendering engine only. Automatically expands the application window to fit the screen.

Possible Values:

0 - Disabled
1 - Enabled

Example


<FitToScreenEnabled value="0"/>

FontFamily

Applies to Android and WM/CE. Specifies the default font to use when rendering text in web pages. Should be a TrueType font present on the device. Default font for all Zebra Technologies WM/CE devices is preset to ‘Tahoma’ and on Android--including Enterprise Tablet--is 'Droid Sans Fallback.' The specified font must be stored in \Windows for WM/CE, and /system/fonts for Android, Enterprise Tablet. Note that Tahoma has no italic or oblique variants.

Possible Values:

Font name

Example


<FontFamily value="Tahoma"/>

FontDirectory

Specifies the location of TrueType fonts on the device. For Zebra Technologies WM/CE devices, the default font directory is \Windows. Does not apply to Enterprise Tablet.

Possible Values:

Relative directory containing the font files

Example


<FontDirectory value="\\Windows"/>

AutoPlayMediaElements

Applies to Android KitKat and higher only. Controls whether media elements will automatically play with no requirement for a user gesture (i.e. pressing PLAY). Enabled by default. A setting of "0" will disable AutoPlay and require a user action to play media.

Possible Values:

0 - Disabled
1 - Enabled (default)

Example


<AutoPlayMediaElements  VALUE="1"/>

JavascriptEnabled

Controls whether JavaScript is enabled on the device. JavaScript is enabled by default.

Possible Values:

0 - Disabled
1 - Enabled (default)

Example


<JavascriptEnabled value="0"/>

TextSelectionEnabled

Applies only to WM/CE with Zebra Webkit. Controls whether text selection is enabled when dragging the stylus on the screen. When enabled, the scroll bar is recommended for scrolling the page. Should be set to '1' for access to Copy (Ctrl+C) and Paste (Ctrl+V) functions on Webkit for WM/CE.

Possible Values:

0 - Disabled
1 - Enabled

Example


<TextSelectionEnabled value="0"/>

UseNativeFonts

Applies to Windows Mobile and Windows CE only. Controls which fonts will be used. When set to ‘0’ (default) the FreeType library will be used as on apps built with RMS 2.x. When set to ‘1’ the native font engine on the device is used. A setting of ‘1’ overrides the ‘FontFamily’ setting. On localized devices from 4.1 and higher, the native font engine will be used by default. The FreeType library cannot render localized characters such as Asian and some accented European characters. The log file displays the font engine in use on launch. Some early BSPs of CE7 do not support the native font render. This config element is not currently available on the MC92, VC70 or WT41N0 devices.

Possible Values:

0 - Use FontFamily Setting
1 - Use FreeType font library

Example


<UseNativeFonts value="1"/>

Soft Input Panel (SIP)

ResizeOnSIP

Applies to Android and Windows Mobile only. Controls window resizing when the soft input panel (SIP, or on-screen keyboard) is displayed. When enabled, the browser window will resize to accommodate the SIP, when displayed. If the SIP has been moved to the top half of the screen, the browser window will reduce in size from the top. Requires SIP module pre-load. Not compatible with Windows CE or the IE rendering engine. Not compatible with Finger Scrolling. The SIP always appears at the bottom of the screen. See also WebViewLayout.

Note: On Windows Mobile devices, screen rotation from portrait to landscape mode can sometimes cause the SIP to be hidden from view, and/or on Windows Mobile/CE to behave abnormally. To avoid this issue, Zebra recommends that the AutoRotate parameter for screen orientation be disabled.

Possible Values:

0 - Disabled
1 - Enabled

Example


<ResizeOnSIP value="1"/>

EnableSIP

Applies to Enterprise Browser 1.2 for Android only. Controls display of soft input panel (SIP, or on-screen keyboard). On EB 1.3 and higher for Android, use the SIP API. On Windows Mobile/CE, use the top and left position parameters of the SIP module to position it off the screen and make it inaccessible to the user.

Note: On devices running Windows CE 6, screen distortion might be displayed when scrolling while the SIP module is enabled.

Possible Values:

0 - Disabled
1 - Enabled

Example


<EnableSIP value="1"/>

System

LowBatteryScan

Applies to Android and Windows Mobile/CE. Controls whether the scanner can be used when battery charge level is low. Set to ‘0’ to disable scanning with low battery and ‘1’ to enable. Can be overridden by calling Barcode.enable.

Possible Values:

0 - Disabled
1 - Enabled

Example


<LowBatteryScan value="0"/>

Scanner

DisableScannerDuringNavigation

Applies to Android and WM/CE. Controls whether scanner will be automatically disabled when navigating away from a page on which it was enabled. A setting of '0' will override this default behavior. Once enabled, the scanner will remain enabled in the foreground application until manually disabled.

Possible Values:

0 - The scanner will remain enabled during page navigation
1 - The scanner will be disabled during page navigation

Example


<DisableScannerDuringNavigation value="1"/>

DisableScannerInApp

Used to disable barcode scanning capabilities for a previous scanner API. Does not apply to the common Barcode API, and will not effect the behavior of barcode scanning in the License dialog. Supported on WM/CE with IE or Zebra Webkit. Note: The scanner will not be disabled if this parameter does not exist or does not contain a value.

Supported Platforms

Windows Mobile/CE (IE or Zebra Webkit installation)

Possible Values:

0 - does not disable the scanner
1 - disables the scanner (DefaultMetaTags, Meta Tags in HTML, JavaScript API, ActiveXObject)

Example


<DisableScannerInApp value="1"/>

Sound

DecodeVolume

Controls the volume of the device beeper when a barcode is scanned. This feature is applicable to WM/CE platform & Android KitKat and above platform only.

Possible Values:

0 – 5 (0 = off; 1 – 5 = lowest to loudest)

Example


<DecodeVolume value="3"/>

DecodeFrequency

Controls the frequency of the device beeper when a barcode is successfully decoded. Must be within the range of the beeper. This feature is applicable to WM/CE platform & Android KitKat and above platform only.

Possible Values:

0 to 0xFFFF

Example


<DecodeFrequency value="0xFFFF"/>

DecodeDuration

Controls the duration (in milliseconds) of the device beeper sound when a barcode is scanned. This feature is applicable to WM/CE platform & Android KitKat and above platform only.

Possible Values:

0 to 5000 (number of milliseconds)

Example


<DecodeDuration value="1000"/>

InvalidDecodeFrequency

Controls the frequency of the device beeper sound when a scanned barcode is not successfully decoded. This value (in hex) must be a frequency within the range of the device beeper. Not applicable to Android platform.

Possible Values:

0 to 0xFFFF

Example


<InvalidDecodeFrequency value="0xFFFF"/>

ScanDecodeWav

Specifies a '.wav'/'.ogg' file to be played when a scanned barcode is successfully decoded. File must be resident on the device. Overrides all scanner beeper settings. Case sensitive. '.ogg' file is supported on Android platform only. The ScanDecodeWav config tag does not rely on DecodeDuration, DecodeFrequency and DecodeVolume config tags. Applies only to Windows Mobile/CE and Android KitKat and above. Also see remarks section below.

Possible Values:

Fully qualified path and file name

Example


For WM/CE - If alarm.wav file is present under '\Program Files\EnterpriseBrowser' directory in the device.
<ScanDecodeWav value="file://%INSTALLDIR%/alarm.wav"/>

For Android - If alarm.ogg file is present under '/sdcard' directory in the device.
<ScanDecodeWav value="file:///sdcard/alarm.ogg"/>

ScanInvalidWav

Specifies a .wav file to be played when a scanned barcode is not successfully decoded. File must be resident on the device. Overrides all scanner beeper settings. Not applicable to Android platform.Case sensitive.

Possible Values:

Fully qualified path and file name

Example


<ScanInvalidWav value="file://path-to-fail-wav-file"/>

ImagerCaptureWav

Specifies a .wav file to be played when the Imager captures an image. File must be resident on the device. Case sensitive.

Possible Values:

Fully qualified path and file name

Example


<ImageCaptureWav value="file://path-to-capture-wav-file"/>

GUI

SignalRefresh

Specifies the refresh rate (in milliseconds) of the signal display. See the Signal API for more information.

Possible Values:

Refresh rate in milliseconds

Example


<SignalRefresh value="1000"/>

BatteryRefresh

Specifies the refresh rate (in milliseconds) of the battery display. See the Battery API for more information. Does not apply to the Enterprise Tablet. Note: Not supported on Android devices, which employ an asynchronous battery notification scheme that fires a batteryEvent only when the battery level changes, and is more power-efficient than polling.

Possible Values:

Refresh rate in milliseconds

Example


<BatteryRefresh value="1000"/>

HourglassEnabled

Controls whether the Hourglass icon will be displayed while navigating between pages (enabled by default).

Possible Values:

0 - Disabled
1 - Enabled

Example


<HourglassEnabled value="1"/>

HourglassLeft

Controls the horizontal position of the Hourglass icon, which is displayed by default while navigating between pages. If not specified, the Hourglass will appear at the center of the screen.

Possible Values:

Horizontal position in pixels

Example


<HourglassLeft value="100"/>

HourglassTop

Controls the vertical position of the Hourglass icon, which is displayed by default while navigating between pages. If not specified, the Hourglass will appear at the center of the screen.

Possible Values:

Vertical position in pixels

Example


<HourglassTop value="200"/>

DOM injection

CustomDOMElements

Applies to Android and Windows Mobile/CE Webkit engines. Specifies the path of a device-resident file containing data for injected DOM elements. This feature permits the injection of one or more DOM elements (i.e. JavaScript, CSS or meta tags) into a running application without modifying the underlying application. Injected JavaScript can be local or server-based. For more information, please refer to the DOM Injection guide.

Possible Values:

fully qualified path and file name

Example


<CustomDOMElements value="file://%INSTALLDIR%\rho\apps\app\mytags.txt"/>

BlockNetworkImage

Applies only to Android devices running KitKat and higher. Controls whether an Enterprise Browser app is permitted to load images over a network. Disabled by default (network images are not blocked). Note: This setting effects only images. To block all network loads, see BlockNetworkLoads.

0 - Do not block network image loads (default)
1 - Block network image loads

Example


<BlockNetworkImage="0"/>

BlockNetworkLoads

Applies only to Android devices running KitKat and higher. Controls whether an Enterprise Browser app can load network resources, including images. Disabled by default (all network loads permitted unless prevented by BlockNetworkImage).

0 - Do not block (default)
1 - Block

Example


<BlockNetworkLoads="0"/>

SaveFormData

Applies only to Android devices running KitKat and higher. Controls whether an app will retain data entered by a user into forms, checkboxes and other input elements. Disabled by default. See also: Cookies.

0 - Do not save form data (default)
1 - Save form data

Example


<SaveFormDatavalue="0"/>

Cookies

Applies only to Android devices running KitKat and higher. Controls whether cookies can be used by Enterprise Browser apps to persist user-entered form data such as login names, credit card numbers, etc. on the device. Enabled by default. To erase cookies automatically, use DeleteCookiesOnExit parameter.

Possible Values:

0 - Do Not Allow Cookies
1 - Allow Cookies (default)

Example


<Cookies value="1"/>

DeleteCookiesOnExit

Applies only to Android devices running KitKat and higher. Automatically erases cookies stored by Enterprise Browser when an EB app is exited gracefully. Disabled by default.

Possible Values:

0 - Do not erase cookies (default)
1 - Erase cookies when exiting an app

Example


<DeleteCookiesOnExit value="0"/>

BadLinkURI

Specifies the "badlink" URI file to be displayed when:

An error occurs when attempting to navigate to a page (i.e. there's no network connection)
A page times out (according to the timeout interval set in NavTimeout)
The user presses the stop button.

The browser will automatically append the query string value "badlink" containing the URL of the page that could not be reached, and 'stop=true' if the page was loaded because the user pressed the stop button. The page specified in the badlink setting should be a device-resident file using the file:// protocol so it’s accessible by the browser.

Known issues: If the device has no network connection, a navigation timeout message may be displayed on Windows Mobile devices that use the IE engine. On CE5 and CE6, the IE engine will truncate the request variables when navigation to a badlink occurs and the reason for the failure might not be displayed.

Possible Values:

Fully qualified path and file name

Note: The file systems of some operating systems are case-sensitive. For cross-platform compatibility, letter case for URL, file and path references in the Config.xml file should be identical to those of the sources.

Example


<BadLinkURI value="file://%INSTALLDIR%/badlink.html"/>

EnableSSL3

Applies to WM/CE with Zebra Webkit only. Controls whether Secure Sockets Layer v3.0 will be used. The Zebra Webkit is shipped with SSL3 disabled by default to protect against the POODLE attack vulnerability.

Possible Values:

0 – Disabled
1 – Enabled

Example


<EnableSSL3 value="1"/>

UserAgent

Stores information about the device’s operating environment to allow web sites to tailor content for optimal presentation. UserAgent data can be specified as true values, variables, or in any combination of the two. Variables differ by platform and by Android version.

Warning: This parameter can present "spoofing" or other security concerns when the UserAgent values reported to a server do not match those of the device. For example, false data could allow a mobile device to view content intended only for desktop computers.

Possible Values:

String (as defined in examples below); accepts true values, variables or a combination

Android UserAgent

The <UserAgent> tag values are extracted from system information on the device and used by Android to configure the Android UserAgent string. Zebra highly recommends following the version-specific syntax, specifications and substitution variables for UserAgent values detailed here. If the <UserAgent> tag is left unspecified or not present in the Config.xml file, the UserAgent string will be populated with the default Android WebView settings. Notice that the user-agent string syntax varies from one Android version to another. Variables are defined in the section that follows.

KitKat and higher


<UserAgent value="Mozilla/5.0 (Linux; Android %%AndroidVersion%%; %%DeviceModel%% Build/%%BuildNumber%%) AppleWebKit/%w (KHTML, like Gecko) Version/%e Chrome/%c Mobile Safari/%w MAC=%%MAC%% ESN=%%ESN%%" />

Jelly Bean


<UserAgent value="Mozilla/5.0 (Linux; U; Android %%AndroidVersion%%; %%Locale%%; %%DeviceModel%% Build/%%BuildNumber%%) AppleWebKit/%w (KHTML, like Gecko) Version/%e Mobile Safari/%w"/>

Android Variables

%%AndroidVersion%% - Android version on the device (i.e. "4.4.3")
%%DeviceModel%% - device model (i.e. "TC700H")
Build/%%BuildNumber%% - BSP/Build version on the device
%%Locale%% - locale currently selected on the device (i.e. "en_US")
AppleWebKit/%w - AppleWebkit webkit version
Version/%e - KHTML webkit version
Chrome/%c - Chrome webkit version
Mobile Safari /%w- Mobile Safari webkit version

In addition, the custom-defined values listed below can be added to the end of the UserAgent string. Zebra recommends using the example strings below.

%%MAC%% - Wi-Fi MAC address on the device
%%ESN%% - serial number (ESN) of the device

KitKat and higher


<UserAgent value="Mozilla/5.0 (Linux; Android %%AndroidVersion%%; %%DeviceModel%% Build/%%BuildNumber%%) AppleWebKit/%w (KHTML, like Gecko) Version/%e Chrome/%c Mobile Safari/%w MAC=%%MAC%% ESN=%%ESN%%" />

Jelly Bean


<UserAgent value="Mozilla/5.0 (Linux; U; Android %%AndroidVersion%%; %%Locale%%; %%DeviceModel%% Build/%%BuildNumber%%) AppleWebKit/%w (KHTML, like Gecko) Version/%e Mobile Safari/%w MAC=%%MAC%% ESN=%%ESN%%"/>

Android Notes

To detect the platform, it is necessary to have platform information in the UserAgent string.
If platform information is not found, Enterprise Browser device capability APIs might be inoperable.
In such cases, Enterprise Browser will add "Android" to the end of the user-defined UserAgent string.
If the <UserAgent> tag is left unspecified or not present in the Config.xml file, the UserAgent string will be populated with the default Android WebView settings.
Also see General Notes, below.

Windows Mobile/CE UserAgent

Example WM/CE


<UserAgent value="Mozilla/5.0 (WebKit; U; /%p) AppleWebKit/%w (KHTML, like Gecko) Version/%e Mobile Safari/%w" />

Windows Mobile/CE UserAgent String

Variables are extracted from the system information on the device (as defined below) and used at runtime to create the UserAgent string.

Windows Mobile/CE Variables

%p – Platform name (i.e. “Windows CE" + version number)
%w – Webkit version
%e – Zebra WebKit version

PocketBrowser 2.1+

The default UserAgent values for PocketBrowser 2.1 and higher was changed to work with a greater number of server configurations. Prior to PocketBrowser 2.1, the default UserAgent values were “Mozilla/5.0, AppleWebKit (KHTML, i.e. Gecko), Motorola Webkit, Safari.” Apps that the IE rendering engine must use the older default value; the UserAgent cannot be set to a custom value.

General Notes

Zebra recommends strict adherence to the platform-specific UserAgent settings and substitution variables detailed here.
The order and format of the UserAgent string should not vary from those recommended above.
True (non-variable) values can be used in combination with substitution variables.
If true values are used, take extra care to ensure that values are correct.
Some servers implement the UserAgent string based on the string provided by a visiting client, thereby helping to ensure server-side compatibility with as many client-side UserAgents as possible.

ViewportEnabled

Applies to Windows Mobile/CE only. Controls viewport meta tag processing (enabled by default). Must be greater than zero.

Possible Values:

0 - Disabled
1 - Enabled

Example


<ViewportEnabled value="1"/>

ViewportWidth

Applies to Windows Mobile/CE only. Sets the default viewport width for pages that do not have a viewport meta tag. If not specified, uses 1:1 scaling.

Possible Values:

A number > 0 specifying the width scale

Example


<ViewportWidth value="1"/>

CaFile

Applies to Windows Mobile/CE only. Specifies the location of a device-resident file containing CA certificates in PEM format for authentication of a server. Please refer to openSSL for more information.

Note: Enterprise Browser supports only a single PEM certificate file. If multiple certificates must be passed to the Webkit browser on WM/CE, the contents of multiple .pem certificates can be combined into a single file using a text editor. The combined file can then be specified in the CaFile parameter.

Possible Values:

file name

Example


<CaFile value="cert-file-name"/>

VerifyPeerCertificate

Controls whether server certificates will be verified against the internal certificates. Enabled by default. Useful for debugging, a value of 0 (disabled) is equivalent to automatically clicking ‘OK’ on a web browser’s dialog when requesting approval for an untrusted certificate. It is strongly recommended that this feature be enabled for deployment.

Possible Values:

0 - Disable Peer certificate verification
1 - Enable Peer certificate verification

Example


<VerifyPeerCertificate value="1"/>

ClientCertPath

Applies to Enterprise Browser 1.5 and higher on Windows Mobile/CE with Webkit engine only. Specifies the path to certificate (.pem) file(s) requested by a server for client authentication when connecting via https://. Certificate files should contain no more than one certificate each. Expired certificates are ignored. See the Certificates guide for help creating certificates.

Possible Values:

fully qualified path to client certificate (.pem) file(s)

Example


<ClientCertPath value="\Program Files\EnterpriseBrowser\Certs"/>

NetworkCookieDatabase

Specifies the location of the database to hold persistent cookies, if desired. If the specified file does not exist, one will be created. Persistent cookies will be loaded from this file and saved back to it when Enterprise Browser exits. If the file is read-only, it will not be overwritten. If not specified, cookies will not persist. Case sensitive.

Possible Values:

Fully qualified local path

Note: The file systems of some operating systems are case-sensitive. For cross-platform compatibility, letter case for URL, file and path references in the Config.xml file should be identical to those of the sources.

Example


<NetworkCookieDatabase value="file:///my-cookie-db"/>

Cache

The browser cache size, in whole MBs.

Possible Values:

Cache size in whole MBs

Example


<Cache value="5"/>

SetCacheMode

Applies only to Android devices running KitKat and higher. Sets the desired caching mode (for pages that are not cache-restricted) as described below. If left unspecified, "LOAD_DEFAULT" setting will be used.

Possible Values:

LOAD_DEFAULT - use cache unless expired; then load from network (default)
LOAD_CACHE_ELSE_NETWORK - use available cache even if expired; otherwise use network
LOAD_CACHE_ONLY - use cache only; do not load from network
LOAD_NO_CACHE - load from network only; do not use cache

Example


<SetCacheMode value="LOAD_DEFAULT"/>

DeleteCacheOnExit

Applies only to Android devices running KitKat and higher. Controls whether to erase contents of browser cache when exiting the app. Disabled by default.

Possible Values:

0 - Disabled (default)
1 - Enabled

Example


<DeleteCacheOnExit value="0"/>

DiskCache

Applies to Windows Mobile/CE with Webkit engine only. Specifies the maximum amount of device storage (in MB) to be used for the web-page cache, which can improve page-access times on subsequent visits to a site. The disk cache persists after EB quits. Enabled by default in Enterprise Browser 1.5 and higher. To disable, remove or comment this tag.

Note: Cached pages expire. See the DiskCacheExpTimeFactor parameter for more information.

Possible Values:

Whole integer values to specify cache size (in MBs)

Example


<DiskCache  VALUE="5MB"/>

DiskCachePath

Applies to Windows Mobile/CE with Webkit engine only. Allows the storage location for cached browser pages and resources to be changed from the default setting. Use this parameter only to change the cache directory from its default of \Program Files\EnterpriseBrowser\. Disabled by default. If a directory in the specified path does not exist, it will be created.

Possible Values:

Fully qualified path to the desired disk cache directory

Example


// Default location of cached WM/CE Webkit resources: 
<DiskCachePath  VALUE="file://%INSTALLDIR%\EnterpriseBrowser\" />

DiskCacheExpTimeFactor

Applies to Windows Mobile/CE with Webkit engine only. Specifies the acceptable span of time past which a cached resource is no longer considered "fresh" by Enterprise Browser. Applies only if the RFC-standard method is indeterminate (see Note). This value is expressed as a percentage (from 0-100) calculated using the difference between the "Last-Modified" value of the cached resource and the date and time the resource is accessed by Enterprise Browser. Larger numbers keep cached resources fresh longer; smaller numbers cause them to be reloaded more often. A value of "0" causes all resources to reload with every access, effectively disabling the disk cache. Default value is 10 (percent).

Note: To determine the freshness of a resource, Enterprise Browser first reads the "max-age" response directive or "Expires" field in the server response header. If one of those parameters indicates that a cached resource has expired, EB requests a refresh by sending an "If-Modified-Since" request to the server and reloads the resource based on the response. If neither attribute is configured, EB looks for a "Last-Modified" header for calculating the freshness lifetime using the heuristic time factor described above. For more information, please refer to the IETF's definition of Freshness.

Possible Values:

Whole integer values from 0-100

Example


// Default value of 10% is shown:
<DiskCacheExpTimeFactor  VALUE="10" />

Device keys

EnableCtrlKey_X

Specifies which control-key combinations (copy, paste, etc.) should be enabled. To enable a control-key combination, define a tag using EnableCtrlKey_X, replacing the ‘X’ with the key being enabled. For example, to enable copying with control-C, the tag should include EnableCtrlKey_C as below. See the sample Config.xml file in user guide for correct branch placement. All CTRL key combinations are disabled on Windows CE by default.

Possible Values:

0 - Disabled
1 - Enabled

Example


<EnableCtrlKey_C value="1"/>

Default MetaTags

MetaTag

Permits a default meta tag to be specified so that a tag required by the application need not be present on every HTML page. Set a default tag by specifying the tag’s module, followed by the tilde character (~) and the properties of the module to set, as specified in EMML 1.1. If the meta tag is present in both the configuration and a loaded page, the page will take priority. Only persistent tags can be set logically in the configuration. Tag persistence is covered in the "additional information" section in the help file. Meta tag properties and their possible values are explained in the corresponding API.

Possible Values:

[Module]~[property to set]

Example


// Make the "Quit" button visible on every page: 
<DefaultMetaTags>
...
    <MetaTag value="QuitButton~visibility:visible;width:50;"/>
...
</DefaultMetaTags>

Engine

EngineInUse

Applies to Windows Mobile/CE only. Permits the selection of a rendering engine (IE or Webkit) when deploying a Webkit installation of Enterprise Browser to Windows CE6 or Windows Mobile 6.5 and above. If deploying an IE-only installation, Webkit will not be available as an option.

Possible Values:

IE - Use the IE engine
Webkit - Use the webkit engine (webkit installation only)

Example


<EngineInUse value="IE"/>

Tab instance

NewTabPhysicalMemLimit

Controls whether a new Tab will be created using the NativeTabbar.create API when physical memory percentage hits a specific threshold. For example, if set to 80, new tabs will stop being created when physical memory usage on the device reaches or exceeds 80 percent of the total available. Once the defined limit is reached, the NativeTabbar.create API callback will contain tabEvent = onTabNewError.

Possible Values:

0 - 100 (percent; 100 = unlimited)

Example


<NewTabPhysicalMemLimit value="50"/>

NewTabVirtualMemLimit

Controls whether a new Tab will be created using the NativeTabbar.create API when a virtual memory usage percentage is hit. For example, if set to 80, new tabs will stop being created when the virtual memory usage reaches or exceeds 80 percent of the total available. Once the defined limit is reached, the NativeTabbar.create API callback will contain tabEvent = onTabNewError.

Possible Values:

0 - 100 (percent; 100 = unlimited).

Example


<NewTabVirtualMemLimit value="50"/>

ZoomKey

ZoomInKey

Applies to Android with stock webkit and WM/CE with IE or Zebra Webkit. Controls zoom-IN behavior for application text using function key(s) configured with the EnableFunctionKey_X parameter. This setting will not be applied if the parameter is missing, left blank or contains an invalid keycode. Note: The function keys used for Zoom-IN or Zoom-OUT operation will not be accessible via the current or previous Key Capture APIs. Other requirements are detailed in the Remarks section at the bottom of this guide.

Possible Values:

Hexadecimal keycode for any function key (F1 to F24)

Example


<ZoomInKey value="0x70"/>

ZoomOutKey

Applies to Android with stock webkit and WM/CE with IE or Zebra Webkit. Controls zoom-OUT behavior for application text using function key(s) configured with the EnableFunctionKey_X parameter. This setting will not be applied if the parameter is missing, left blank or contains an invalid keycode. Note: The function keys used for Zoom-IN or Zoom-OUT operation will not be accessible via the current or previous Key Capture APIs. Other requirements are detailed in the Remarks section at the bottom of this guide.

Possible Values:

Hexadecimal keycode for any function key (F1 to F24)

Example


<ZoomOutKey value="0x71"/>

Shortcut Creation

ShortcutCreationEnabled

Applicable only when using the Enterprise Browser Shortcut Creator utility; otherwise ignored. Controls automatic creation of app shortcuts on Android and Windows Mobile/CE target devices when Enterprise Browser is launched. When option 1 is selected, checks for and creates new shortcuts at every launch. Setting persists following EB uninstall/re-install. Setting is lost after cold reboot. Disabled by default. For more information, please refer to the Shortcut Creator guide.

Possible Values:

0 - Shortcut creation disabled (default)
1 - Shortcuts created at every launch
2 - Shortcuts created on initial launch only

Example


<ShortcutCreationEnabled value="1"/>

KeepAlive

Applies to Windows Mobile/CE with Webkit engine only. Controls whether HTTP connections will be maintained between requests. When enabled (default), maintains a connection between the web server and client. When disabled, connection is closed when the request is complete. Possible Values:

0 - Disabled
1 - Enabled (default)

Example


<KeepAlive value="1"/>

Remarks

ScanDecodeWav on Android Platform

If ScanDecodeWav configuration paramater contains '.wav'/'.ogg' filename same as system filename, then the system '.wav'/'.ogg' file will be selected for playing when a scanned barcode is successfully decoded.

Battery Polling on Enterprise Tablet

Due to its asynchronous battery notification, the Enterprise Tablet does not support BatteryRefresh. This has the effect of launching a bateryEvent only when the battery level changes. This functionality has been implemented in place of polling as a means of maximizing battery power.

Case Sensitivity

Note: The file systems of some operating systems are case-sensitive. For cross-platform compatibility, letter case for URL, file and path references in the Config.xml file should be identical to those of the sources.

DataWedge-Enterprise Browser Conflicts

This issue applies to Android only. Under certain conditions involving Enterprise Browser, scanning with the DataWedge application on Zebra Android devices is disabled. For complete details, see the DataWedge Usage Guide.

FunctionKeysCapturable-EnableFunctionKey Interaction

Applies to only Windows Mobile/CE devices.

On Windows Mobile/CE, full control is given to the developer over how the application handles function keys, but such settings persist only until the next warm boot. Also, the default behavior of function keys will vary from one device to another. On the MC75a, for example, the red and green phone keys also represent F3 and F4 keys, and on many devices the volume keys also can be mapped as function keys.

Not all function keys will revert to default operating system behavior, however, and unblocking certain function keys might expose the underlying operating system. For example, exposing the red and green phone keys on some devices will grant access to the WM/CE Start menu.

The table below shows the behavior of Enterprise Browser when function keys are pressed given certain configuration settings:

	Function Keys Capturable = TRUE	Function Keys Capturable = FALSE
Enable Function Key = TRUE	All Function Keys can be captured by the Key Capture Module Function Key will not have its default Operating system behavior	Function Keys with default OS behavior can not be captured by the Key Capture Module Function Keys without default OS behavior can be captured by the Key Capture Module Function Key will have its default Operating system behavior (if any)
Enable Function Key = FALSE	All Function Keys can be captured by the Key Capture Module Function Key will not have its default Operating system behavior	All Function Keys can not be captured by the Key Capture Module Function Key will not have its default Operating system behavior (if any)

This table applies to Windows Mobile and Windows CE devices only.

IntentReceiver

The IntentReciever tag includes parameters to enable/disable the Intent function and to define the Action and Category of the Intent itself. The syntax for these parameters is as follows:


<IntentReceiver>
    <EnableReceiver value="1"/>
    <IntentAction   value="com.zebra.sample.action"/>
    <IntentCategory value="android.intent.category.LAUNCHER"/>
</IntentReceiver>

From the target side, here's what the relevant JavaScript code for sending an intent might look like:

    
    Intent intent = new Intent("com.zebra.sample.action");
    intent.putExtra("key", "intent");
    sendBroadcast(intent);

Learn more about Intent at the Android Developer Forum.

Open and Print Key Commands

For apps that enable the Open (Ctrl+O) or Print (Ctrl+P) key combinations, such functions are inoperable on Windows CE7 devices.

-->