Enterprise Browser supports RhoElements 2.x applications, which in many cases will run in EB with just a few small changes. This guide explains the changes that will always be required for migration to EB, and a few others that might be.
These instructions require a development host (desktop or laptop) connected to a Zebra device, both containing the Enterprise Browser software, as well as a familiarity with the process of editing the Enterprise Browser
Config.xml file. For help, see the guides below.
The single change that is always necessary when migrating to Enterprise Browser from any other platform is to specify the StartPage of the app in the Enterprise Browser
- On Android devices:
- On Windows devices:
1. Set the StartPage of the app. This will be the first page that loads with Enterprise Browser, and can be on a server (specify the URL) or local to the device (specify the full path), as below:
<Configuration> <Applications> <Application> <General> <Name value="Menu"/> <StartPage value="file://%INSTALLDIR%/menu.html" name="Menu"/> </General>
2. Copy any required off-line files (i.e. "BadLink" pages, etc.) to the device, take note of their paths and specify those paths in the relevant sections of the
Config.xml file, as necessary.
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.xmlfile should be identical to those of the sources.
3. If the app requires access to RhoElements APIs, see the Deploy Legacy APIs section below.
See the Config.xml Reference Guide for more information about settings, parameters and other requirements.
RhoElements 2.x and Enterprise Browser both support the configuration of app functionality "on-the-fly" through the use of meta tags. Enterprise Browser was engineered to be backward compatible with this feature, and therefore should implement RE 2.x meta tags for Android and Windows Mobile/CE with no changes required. As a precaution, confirm that the tags are specified properly, as below.
Example meta-tag specification:
<META HTTP-Equiv="scanner" Content="Enable"> <META HTTP-Equiv="scanner" Content="AutoEnter:Enabled"> <META HTTP-Equiv="scanner" Content="Start">
Applies to most migration scenarios. If migrating from a Windows device to one running Android, or from Windows Mobile to Windows CE or vice-versa, adjustments to some display settings will likely be necessary since those migrations involve the use of different webkits. Other considerations might include display of the soft input panel, controlling its position on the screen and the ability to hide it, if desired. The relevant parameters are listed below; all should be checked as part of the migration process.
- Enable SIP
- Engine In Use
- Fit To Screen
- Font Family
- Page Zoom
- Resize on SIP
- Scroll Technique
- Use Native Fonts
Applies to Android devices only. Running a RhoElements2.x app in Enterprise Browser for Android requires that the legacy APIs (contained in the
elements.js file) be available to any HTML page rendered on the device that needs access to an API. For example, if a page exists for controlling the device scanner, that page's HTML must contain a reference to
elements.js. The file should generally be located in the same place as the HTML pages themselves, which can be on the device or a server. See the API Usage Guide for more information.
To Deploy the
1. Locate the
elements.js file, which by default is located in the following directory on the development host:
2. Place a copy of
elements.js on the device or a server accessible by all of the app's HTML pages.
3. Add a reference to the API file in every HTML page that will access the APIs, as below:
Applies to Windows Mobile/CE devices only. If the RhoElements app uses ActiveX controls, the legacy ActiveX and generic objects must be preloaded when EB initializes.
<NPAPI> <NPAPIDirectory value="file://%INSTALLDIR%/NPAPI/" /> <Preloads> <PreloadLegacyActiveX value="1" /> <PreloadLegacyGeneric value="1" />
- The generic methods RasConnect and RasDisconnect are not supported.
- The NOSIP control for preventing display of the soft input panel is not supported. See the SIP API's hide() method for an alternative.
- The FitToScreenEnabled parameter of EB is not supported on Android or Windows CE.
- EMML profiles are not supported on Android.
- If the app is to perform scanning, check for hardware contention issues and other potential conflicts with DataWedge and other Android-native apps that use the device's scanning hardware.