Browser Manager

EMDK For Xamarin - 2.5

Overview

The Browser Manager permits the configuration of password retention, default home page and other settings on the Android Open Source Project (AOSP) browser, which is the default browser on many Zebra Android devices and has been modified for this purpose.

Main Functionality

  • Set the Default Home Page
  • Remember Passwords enable/disable
  • Save Form Data enable/disable

Set Default Home Page

Used to set the Default Home Page in the form of a Universal Resource Locator (URL) for the default Android web browser on the device. Each time the default browser is opened without a URL explicitly requested by the user, it will use the URL provided by this parameter. Should be a full, valid URL (including the protocol) such as "http://www.google.com" corresponding to the desired default web page. This could be used to launch a specific web-based application or to direct users to an internal company web site or portal as a starting point for browsing. Specifying an empty (length of zero) value or the absence of this parm from the XML will cause no change; any previously specified Default Home Page will be retained.

Parm value input rules:

  • String from 0-2000 characters

Parm Name: SetDefaultHomepage

Requires:

  • OSX: 1.3- 3.9
  • NOT IN OSX: 4.0
  • MX: 4.3+

Remember Passwords Enable/Disable

Used to enable/disable the Remember Passwords Option for the default Android web browser.

Enabling Remember Passwords can make browsing more convenient by eliminating the need for the device user to enter a password on subsequent visits to a web site. Disabling Remember Passwords is generally more secure, especially on a device that might be shared, since it would prevent an unauthorized user from logging in using a password that was previously entered by an authorized user.

Note: This feature is available only on Jelly Bean devices; it has been depreciated on Android KitKat and higher.

Parm Name: SetRememberPasswords

Option Name Description Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no change to the Remember Passwords Option; any previously selected setting will be retained.

OSX: 1.3 - 3.9

NOT IN OSX: 4.0

MX: 4.3+

1 Turn On Enables the Remember Passwords option, which will prompt the user to save any password entered.

OSX: 1.3 - 3.9

NOT IN OSX: 4.0

MX: 4.3+

2 Turn Off Disables the Remember Passwords option, preventing any saving of passwords.

OSX: 1.3 - 3.9

NOT IN OSX: 4.0

MX: 4.4+

Save Form Data Enable/Disable

Used to enable/disable the Save Form Data Option of the default Android web browser.

Enabling Save Form Data can make browsing more convenient by eliminating the need for the device user to re-enter information on subsequent visits to a form. Disabling Save Form Data is generally more secure, especially on a device that might be shared, since it would prevent an unauthorized user viewing or re-entering sensitive information that was previously entered by an authorized user.

Parm Name: SetSaveFormData

Option Name Description Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no change to the Save Form Data Option; any previously selected setting will be retained.

OSX: 1.3 - 3.9

NOT IN OSX: 4.0

MX: 4.3+

1 Turn On Enables the Save Form Data option, which will prompt the device user to save form data.

OSX: 1.3 - 3.9

MX: 4.3+

2 Turn Off Disables the Save Form Data option, preventing any form data from being saved.

OSX: 1.3 - 3.9

NOT IN OSX: 4.0

MX: 4.3+

Examples

Queries

Get All Browser Settings

Input


<wap-provisioningdoc>
    <characteristic-query type = "BrowserMgr"/>
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="BrowserMgr" version="4.3">
        <parm name="SetDefaultHomepage" value="http://www.google.com"/>
        <parm name="SetRememberPasswords" value="1"/>
        <parm name="SetSaveFormData" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Get Default Homepage Setting

Input


<wap-provisioningdoc>
    <characteristic type = "BrowserMgr">
        <parm-query name="SetDefaultHomepage"/>
    </characteristic>    
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="BrowserMgr" version="4.3">
        <parm name="SetDefaultHomepage" value="http://www.google.com"/>
    </characteristic>
</wap-provisioningdoc>

Get Remember Password Setting

Input


<wap-provisioningdoc>
    <characteristic type = "BrowserMgr">
        <parm-query name="SetRememberPasswords"/>
    </characteristic>    
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="BrowserMgr" version="4.3">
        <parm name="SetRememberPasswords" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Get Save Form Data Setting

Input


<wap-provisioningdoc>
    <characteristic type = "BrowserMgr">
        <parm-query name="SetSaveFormData"/>
    </characteristic>    
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="BrowserMgr" version="4.3">
        <parm name="SetSaveFormData" value="1"/>
    </characteristic>
</wap-provisioningdoc>