UI Manager

Overview

The UI Manager (UiMgr) provides control of miscellaneous UI configuration settings, such as those for language and locale, the device notification pull-down, Quick Settings controls, default input device and Clipboard behavior.

Android devices contain a variety of System applications that access UI elements spread throughout the OS. In some cases, one or more of these "standard" UI elements were deemed undesirable by Zebra customers and/or partners for devices deployed in an enterprise. The UiMgr provides control over these UI elements and the option of disabling Android behaviors or features with the potential to hinder the productivity of device users engaged in specific business tasks.

Security Warning: The UiMgr permits the "Network may be monitored..." message to be suppressed. This important safeguard is intended to warn device users of a potential security risk. Administrators should not suppress this message unless CA certificates have been properly vetted before installation on a device, and should ensure that no untrusted certificates can be subsequently installed while the message remains suppressed.

Main Functionality

• Enable/Disable:
  • Configuration of Accessibility Options
  • Configuration of Workflow apps
  • Pop-up warning of an app attempting to enter Immersive Mode
  • Configuration of external keyboard settings
  • Quick Settings controls for user access to Wi-Fi, Bluetooth and other settings
  • Clipboard
  • Android Clipboard Share
  • AutoCorrect function
  • HOME Key function
  • The Bluetooth Pairing pop-up
  • "The network may be monitored..." message
  • "Recent Apps" button
  • Navigation Bar
  • The Status Bar
  • Display of the virtual keyboard
  • Screen magnification gesture
  • Split-screen mode
  • Multi-user mode
  • Do Not Disturb mode
  • The On-screen Power Button
  • The Large Key Indicator pop-up
• User access to:
  • The Large Key Indicator display settings
  • Battery Saver settings
  • Quick Settings tile display and layout settings
• Configure localization settings to:
  • Set the Current Locale for a desired language and region
  • Set the Default Input Method to enhance entry of localized data
  • Manage layouts (languages) for external physical keyboard(s)
  • Select Home screen wallpaper
  • Select the preferred assistant app
• Set the Touch-and-Hold Delay for keys
• Clear the Clipboard, which discards any prior data that might have been copied
• Add, Replace, external keyboards and keyboard mappings
• Remove individual or all external keyboards and keyboard mappings
• Select a preferred pre-installed or custom Assistant app for the device
• Select which Quick Settings tiles are displayed
• Select custom Quick Settings tile(s) to be displayed
• Assign external keyboard shortcut key events and handling

Clipboard Usage

Controls whether the Clipboard function can be used, potentially enabling a device user to move data from one app to another.

Parm Name: ClipBoardUsage

Clear Clipboard (checkbox)

Used to immediately clear the contents of the Clipboard, preventing data that was stored there from being pasted at any time thereafter. If Clipboard functions are allowed by an app that handles sensitive data, Zebra recommends using this parameter to clear sensitive data from Clipboard upon exiting the app to prevent the data from later being pasted elsewhere.

Parm Name: ClipBoardClear

Clipboard Share

Controls whether a device user has access to Android Clipboard Share, features that automate Clipboard data sharing among apps on and off the device. Disabling Clipboard Share does NOT prevent a user from manually pasting Clipboard data from one app to another on the device. To prevent this action, see Clipboard Usage.

Note: Supported only on devices running Android 10 or later. Android 11 requires MX 11.3 or later.

Parm Name: ClipboardShare

Configure External KB (checkbox)

Used to select whether external keyboard settings can be configured.

Parm Name: ConfigExternalKeyboard

External KB Num-lock

Used to configure the Num-lock key setting on an external keyboard connected to the device.

Shown if: Config External Keyboard is "checked"

Parm Name: ExternalKeyboardNumLock

External KB Shortcut Action

Used to define how the device handles shortcut-key events coming from the external keyboard.

Shown if: Config External Keyboard is "checked"

Parm Name: ExternalKeyboardShortcutKeyAction

External KB Shortcut ID

Used to select the identifier of the shortcut key for the Action.

Shown if: Config External Keyboard is "checked" and External Keyboard Shortcut Key Action is NOT "Do not change"

Parm Name: ExternalKeyboardShortcutKeyId

External KB Action

Used to select an Action to perform on the named external keyboard specified in the External Keyboard Name parameter.

Note: If the named keyboard is not connected when configuration settings are deployed, settings are applied the next time the keyboard is plugged in. If multiple StageNow Profiles containing different layout names are created, the layout in the last applied Profile becomes the default.

Parm Name: ExternalKeyboard

External Optional KB Name

Used to enter a Keyboard Name from which to remove a Keyboard Layout (language). The Keyboard Name entered must be among those listed in the Input Settings panel on the device. Keyboard names are NOT case sensitive.

Parm value input rules:

• String of at least one alphanumeric character

Shown if: Config External Keyboard is "checked" and External Keyboard Action is "Remove Keyboard Layout Mapping"

Parm Name: ExternalOptionalKeyboardName

Requires:

• MX: 10.5+
• Android API: 30+

External KB Layout

Used to enter the name of the Keyboard Layout being configured. This is a required field and MUST contain the name of a layout listed in the "Keyboard layouts" panel on the device. NOTE: Layout Names ARE case sensitive.

To view a list of Keyboard Layouts:

1. Go to the Android Settings panel.
2. Select System > Languages & input > Physical keyboard.
3. Tap the name of the connected external keyboard. The name of the currently selected layout is displayed.
4. Tap "SET UP KEYBOARD LAYOUTS" to display a list of alternalive layouts (languages).

Parm value input rules:

• String of at least one alphanumeric character

Note: If the named keyboard is not connected when configuration settings are deployed, settings are applied the next time the keyboard is plugged in. If multiple StageNow Profiles containing different layout names are created, the layout in the last applied Profile becomes the default.

Shown if: Config External Keyboard is "checked" and External Keyboard Action is "Add/Replace Keyboard Layout Mapping"

Parm Name: ExternalKeyboardLayout

Requires:

• MX: 10.5+
• Android API: 30+

Set Accessibility Options (checkbox)

Used to select whether to configure Accessibility Options, which can help simplify device usage for those with physical and/or visual impairments.

Parm Name: Config_Accessibility_Options

Touch and Hold Delay

Used to select the length of time a device key must be held before being considered a long-press.

Shown if: Config Accessibility Options checkbox is "checked"

Parm Name: TouchHoldDelay

AutoCorrect Usage Enable/Disable

Controls whether AutoCorrect functionality is accessible on the device. AutoCorrect can be used to save commonly entered words or industry-specific words or phrases and offer them as corrections to potentially mistyped words. Such functionality could present a security risk by exposing sensitive information to subsequent device users that are not authorized to view or reuse that information.

Note: This parameter does not turn the AutoCorrect function on or off or configure any of its functions. When AutoCorrect is enabled, an administrator or device user must still use the System Settings panel turn the function on or off and configure its functions. When disabled, AutoCorrect functionality cannot be used on the device.

Parm Name: AutoCorrectUsage

HOME Key Enable/Disable

Used to prevent use of the HOME key to exit the current app and run the Home Screen app. This might be desirable when the device is devoted to running a single application, such as that of a kiosk. By blocking use of the HOME key, a common method of navigating away from the application (whether intentional or not) can be eliminated.

Note: Enabling this parameter does not affect the "long press" behavior of the HOME key. To completely prevent all HOME key functionality, use the Key Mapping Manager (on supported devices) to disable the HOME key or map it to a desired behavior.

Parm Name: HomeKeyUsage

Long-Press HOME Key Enable/Disable

This is the On/Off switch for device response to a "long-press" of the HOME key, which launches the Google Assistant.

Parm Name: LongPressHomeKeyUsage

Date Launches Clock App Enable/Disable

This is the On/Off switch for launching the Clock app on the device by tapping the date in the Notifications drop-down panel.

Parm Name: NotificationDate

Network 'Monitored' Message Enable/Disable

Controls whether the message "Network may be monitored..." is displayed on the device when the device user connects to certain types of networks. This message is generally associated with networks that implement a public key infrastructure and require a root certificate on the device before a client will be allowed to connect.

Security Warning: The "Network may be monitored..." message is a safeguard intended to warn device users of a potential security risk. Administrators should not suppress this message unless CA certificates have been properly vetted before installation on a device, and should ensure that no untrusted certificates can be subsequently installed while the message remains suppressed.

Note: On TC20/TC25 devices, available only when running Android 8.x Oreo and higher.

Parm Name: NetworkMonitorNotification

Multi-user Enable/Disable

This is the On/Off switch for Multi-user mode on the device, which can provide separate user accounts, data and apps or app restrictions on a shared device. Zebra devices support a maximum of 4 users.

This feature is supported only on SDM660-platform devices, which includes (but is not limited to):

• PS20
• TC52
• TC57
• TC72
• TC77

Note: Supported on SDM660-platform devices only. Zebra devices support a maximum of 4 users.

Parm Name: MultiUser

Set Current Locale

Permits the selection of the device's Locale. A locale is the combination of a language and a region in which that language is spoken. Languages are identified by two lower-case letters; regions are identified by two upper-case letters. The locale joins the two letter-pairs with an underscore ("_") character. For example, "en_US" is the locale specification for "English spoken in the United States," and "fr_CA" is the locale specification for "French spoken in Canada."

When changing the Locale, it also might be desirable to change the default input method to one that is suitable for entry of characters for the language associated with the selected Locale. Setting a particular input method as the default input method does not prevent the device user from manually selecting a different input method, it merely determines which input method will come up automatically each time that parm is invoked.

Parm value input rules:

• String containing two lower-case letters corresponding to the language
• Optionally may contain two upper-case letters designating a region code
• When a region code is used, letter pairs are joined by an underscore ("_") character. For example: en_US
• The minimum length is 2 characters; the maximum length is 5 characters

Parm Name: CurrentLocale

Battery Percentage Show/Hide

Controls whether the current battery-charge percentage is displayed. When shown, the percentage appears in the Android Status Bar at the top of the screen.

Parm Name: ShowBatteryPercentage

TalkBack Shortcut On/Off

Controls whether long-pressing the Volume Up/Down buttons toggles TalkBack, which speaks words displayed on the device screen to aid visually impaired users.

Parm Name: TalkBackShortcut

Split Screen Enable/Disable

This is the On/Off switch for Split Screen functionality on the device, which allows two apps (that support the feature) to be usable at the same time, each with its own section of the screen. When enabled, Split Screen mode is accessed on some devices by long-pressing the "Recent Apps" button. The StageNow client app does NOT support split-screen mode.

Parm Name: SplitScreenMode

Do Not Disturb Enable/Disable

Controls whether the device user is permitted to change the state (turn on/off) of "Do Not Disturb" (DND) mode on the device, which toggles app notification sounds and messages. When Enabled (option 1), the user can turn notifications on or off using the Notification pull-down or Android Settings panel. When Disabled, the user can view the DND state but cannot change it.

This parameter does NOT change the state (turn on/off) of DND mode, only the device user's ability to do so.

Note: This feature is supported only on SDM660-platform and later devices.

Parm Name: DND

Do Not Disturb Turn On/Off

This is the On/Off switch for "Do Not Disturb" (DND) mode on the device, which toggles app notification sounds, pop-ups and messages in the Notification/Status bar. When Turn On (option 1) is selected, all device notifications are muted.

This parameter does NOT prevent the device user from changing the state of DND mode using the Android Settings panel.

Parm Name: DoNotDisturb

Bluetooth Pairing Pop-up Enable/Disable

Controls whether to present the Bluetooth Pairing Pop-up during a pairing operation, useful mainly when the device user is responsible for pairing. If one or more applications are expected to control pairing operations, suppressing the Pairing Pop-up can reduce the potential for user interference with the pairing process.

Parm Name: BluetoothPairingPopupUsage

App Info Icon Enable/Disable

This is the On/Off switch for device response to a "long-press" of an app icon in the Recent Apps Header. When enabled, long-pressing an app icon allows the device user to access application information and to potentially perform undesireable actions, such as stopping the app.

Parm Name: AppInfoIconOnRecentAppHeader

Set a Custom Locale

Permits the selection of the device's Custom Locale. A locale is the combination of a language and a region in which that language is spoken. Languages are identified by two lower-case letters; regions are identified by two upper-case letters. The locale joins the two letter-pairs with an underscore ("_") character. For example, "en_US" is the locale specification for "English spoken in the United States," and "fr_CA" is the locale specification for "French spoken in Canada."

When changing the Locale, it also might be desirable to change the Default input method to one that is suitable for entry of characters associated with the language of the selected Locale. Setting a particular input method as the default input method does not prevent the device user from manually selecting a different input method, it merely determines which input method will come up automatically each time that parm is invoked.

Parm value input rules:

• String containing two lower-case letters corresponding to the language
• Optionally may contain two upper-case letters designating a region code
• When a region code is used, letter pairs are joined by an underscore ("_") character. For example: en_US
• The minimum length is 2 characters; the maximum length is 5 characters

Shown if: Current Locale value is "Custom" (99)

Parm Name: CustomLocale

Requires:

• MX: 5.1+

Set an Extended Locale

Permits the selection of the device's locale from the list of Extended Locales. A locale is the combination of a language and a region in which that language is spoken. Languages are identified by two lower-case letters; regions are identified by two upper-case letters. The locale joins the two letter-pairs with an underscore ("_") character. For example, "en_US" is the locale specification for "English spoken in the United States," and "fr_CA" is the locale specification for "French spoken in Canada."

When changing the Locale, it also might be desirable to change the default input method to one that is suitable for entry of characters for the language associated with the selected Locale. Setting a particular input method as the Default input method does not prevent the device user from manually selecting a different input method, it merely determines which input method will come up automatically each time that parm is invoked.

Parm value input rules:

• String containing two lower-case letters corresponding to the language
• Optionally may contain two upper-case letters designating a region code
• When a region code is used, letter pairs are joined by an underscore ("_") character. For example: en_US
• The minimum length is 2 characters; the maximum length is 5 characters

Shown if: Current Locale value is "Extended" (98)

Parm Name: ExtendedLocale

Set Default Input Method

Controls whether to change the default input method (i.e. a soft keyboard) when that change is requested programmatically or manually by the device user. Setting a particular input method as the default input method does not prevent the device user from manually selecting a different input method, it merely determines which input method will come up automatically each time that parm is invoked. When changing the Current Locale, it may desirable to also change the default input method to one that is suitable for entry of characters that are associated with the selected Locale.

Parm Name: InputMethodAction

Input Method Class Name

Used to enter the Android Class Name of a user-defined input method to be made the default input method.

Note: The specified Class Name is used in conjunction with the package name and must match the name of the class that implements an input method within an Android application that is already installed and that has the specified package name. If an attempt is made to enter a Class Name that does not match an installed input method, an error will be returned.

Parm value input rules:

• String with a minimum size of 1 character

Shown if: The "Input Method Action" is "Change Current Input Method" and the "Select a Default Input Method Option" is "User defined Input Method"

Parm Name: InputMethodClassName

Requires:

• MX: 4.3+
• Android API: 16+

Set Default Input Method

Allows the selection of the default input method (i.e. the soft keyboard). If the selected input method is not already enabled, this parameter will first enable it and then set it as the new default. The desired input method must have been previously installed and must be specified using its Android package name and class name.

Shown if: The "Input Method Action" is "Change Current Input Method"

Parm Name: InputMethodOption

Gear Icon Show/Hide

Controls whether the "Gear" icon is displayed in the Android Notifications panel. The Gear icon provides immediate access to Wi-Fi, Bluetooth, GPS and other commonly used System settings without having to go through the Settings panel. The Notifications panel is accessed from most applications by dragging downward from the Notification/Status bar at the top of the Android screen. Hiding the Gear icon can prevent a device user from accessing those Settings and changing device behavior.

Parm Name: NotificationSettings

Input Method Package Name

Used to enter the Android package name of a user-defined input method to be made the default input method (i.e. a soft keyboard).

Note- The specified package name must match the package name of an input method that is already installed. If an attempt is made to enter a package name that does not match an installed input method, an error will be returned in the Result XML document.

Parm value input rules:

• String containing the valid package name of an Android application that is currently installed and that implements a valid input method. Example: com.mycompany.myinputmethod
• String with a minimum size of 1 character

Shown if: The "Input Method Action" is "Change Current Input Method" and the "Select a Default Input Method Option" is "User defined Input Method"

Parm Name: InputMethodPackageName

Requires:

• MX: 4.3+
• Android API: 16+

Notification Pulldown Enable/Disable

Controls whether a device user will be allowed to "pull down" the Notifications/Status bar and access the Notifications panel. Depending on the Android version, the Notifications panel displays application alerts, text messages, widgets and other notifications, and provides access to device Settings. Preventing access to the Notification Pulldown can prevent a device user from accessing device Settings and other system objects that might allow a user to change system behavior or navigate away from the current application.

Parm Name: NotificationPullDown

Two-Finger Quick Settings Enable/Disable

Controls whether Quick Settings can be accessed using a two-finger downward swipe gesture on some versions of Android. Quick Settings icons provide immediate access to Wi-Fi, Bluetooth, GPS and other commonly used System settings without having to go through the Settings panel. Disabling Quick Settings access can prevent a device user from changing device behavior.

Note: This parameter is superseded by the "System Settings Access" parameter of Access Manager. If Reduced Access is enabled, later attempts enable Quick Settings result in failure.

Note: Superseded by the System Settings Access parameter of Access Manager. On TC20/TC25 devices, available only when running Android 8.x Oreo and higher.

Parm Name: QuickSettings

Navigation Bar Enable/Disable

This is the On/Off switch for the on-screen Navigation Bar, which contains the BACK, HOME and RECENT soft keys. Disabling the Navigation Bar can prevent the user from exiting the currently running app by means of those keys. This parameter applies only to the soft keys; it does not control capacitive or hardware keys, which can be disabled separately using the Keymapping Manager. Also see the Recent App Button Usage parameter elsewhere on this page.

IMPORTANT: On some devices running Android 13, enabling or disabling the Navigation Bar from within an app triggers a configuration change that might restart the app's main activity. To prevent this, add the attribute android:configChanges="screenSize|screenLayout" to the activity tag in the app's manifest file as in the highlighted section of the image below.

Note: On devices running Android 13, this parameter might cause unwanted behavior. See IMPORTANT note.

Parm Name: NavigationBarUsage

Recent App Button Enable/Disable

Controls access to the Android Recent Apps button, which displays a list of applications recently accessed on the device and from which the user can re-launch. Note: Disabling the recent apps button prevents the user from configuring the device for multi-window operation.

Parm Name: RecentAppButtonUsage

Magnification Gesture

Controls the "Magnification gesture" setting on the device, which is found in the Accessibility section of the Android Settings Panel. By turning this feature on (option 1), triple-tapping the screen magnifies the device display (except navigation bar and keyboard).

Parm Name: MagnificationGesture

Inter-app Sharing Enable/Disable

Used to select whether to enable inter-app sharing, which allows an app on the device to share data with other apps on the device.

Note: This feature requires OSX 13.1 (or later) on devices running Android 11 or 13.

Parm Name: InterAppSharing

Password Characters Show/Hide

Controls whether each password character is displayed briefly on the screen as it is entered; otherwise masked at all times. This parameter controls the "Security & Location" function of the Settings panel.

Parm Name: ShowPasswords

Virtual Keyboard Show/Hide

Controls whether to display the virtual keyboard on the device screen while a physical keyboard is active.

Parm Name: ShowVirtualKeyBoard

Home Screen Wallpaper

Used to select the wallpaper image to be displayed on the device Home screen. If selecting a custom image, enter the file name and on-device path of the image using the Custom Home Wallpaper parameter.

Parm Name: HomeScreenWallpaper

Custom Wallpaper

Used to enter the file name and path on the device of an image file (.jpg or .png, 126 MB max.) for display on the device Home screen.

Parm value input rules:

• String of at least one alphanumeric character
• Supports .jpg or .png file formats
• 126 MB maximum file size

Note: Supported only on devices running Android 10 or later. Android 11 requires MX 11.3 or later.

Shown if: Set Home Screen Wallpaper is "Custom"

Parm Name: CustomHomeWallpaper

Requires:

• MX: 10.5+

LKI Usage Enable/Disable

Controls whether the device user can enable/disable the Large Key Indicator (LKI) pop-up, which is used to show active modifier keys. LKI features are supported on MC93 devices only.

Note: Supported on MC93 devices only.

Parm Name: SetLKI

LKI Enable/Disable

This is the On/Off switch for the Large Key Indicator (LKI) pop-up, which is used to show active modifier keys. On most devices, the indicator is displayed in the Status Bar at the top of the screen. This parameter is accessible by the user only when SetLKI is set to "Turn On." LKI features are supported on MC93 devices only.

Note: Supported on MC93 devices only.

Parm Name: EnableLKI

Status Bar Enable/Disable

This is the On/Off switch for the Android Status bar on the device, which displays notifications, status icons and other information. When disabled (option 2), the bar and/or its contents are not visible on the device and cannot be accessed by any means.

Parm Name: StatusBarUsage

On-screen Power Button Enable/Disable

This is the On/Off switch for on-screen power button that appears when long-pressing the physical power button on the device.

This feature is supported only on SDM660-platform devices, which includes (but is not limited to):

• PS20
• TC52
• TC57
• TC72
• TC77

Note: Supported on SDM660-platform devices only.

Parm Name: OnScreenPowerButton

Assistant App

Used to select a digital assistant app as the default when an assistant app is used on the device.

Note: Supported only on devices running Android 10 or later. Android 11 requires MX 11.3 or later.

Parm Name: AssistApp

Custom Assistant App Package Name

Used to enter the Android package name of a user-defined digital assistant app as the default when an assistant app is used on the device. Package name must match that of an app already installed on the device.

Parm value input rules:

• String containing a valid package name of an app installed on the device

Example: com.google.android.apps.assistant

Note: Supported only on devices running Android 10 or later. Android 11 requires MX 11.3 or later.

Shown if: The Assistant App is "Custom"

Parm Name: CustomizeAssistApp

Requires:

• MX: 10.5+

Dark Theme On/Off

Used to select whether to use black backgrounds for the Android System UI and compliant apps.

Parm Name: DarkTheme

Battery Saver Usage Enable/Disable

Used to select whether the device user can control the state (on/off) of Battery Saver through Settings, Quick Settings and Notification panels.

Parm Name: BatterySaver

Quick Tile Editing Enable/Disable

Used to select whether the device user can change the display and layout of Quick Settings tiles on the device.

Parm Name: QuickTileEdit

Quick Tile Action

Used to select the action to show or hide Quick Settings tiles on the device.

Parm Name: QuickTileAction

Quick Tile Identifier

Used to select an individual Quick Settings tile to show or hide on the device.

Shown if: Quick Tile Action is "Show individual" or "Hide individual"

Parm Name: QuickTileIdentifier

Custom Quick Tile Name

Used to enter the name of the custom Quick Setting tile to show/hide on the device.

Parm value input rules:

• String containing a valid name of a custom Quick Tile on the device

Shown if: The Quick Tile Identifier is "Custom" and the Quick Tile Action is "Show individual" or "Hide individual"

Parm Name: QuickTileCustomIdentifier

Requires:

• MX: 10.5+

Proximity Sensor On/Off

Used to select whether the device can automatically control whether its display and touch panel are turned on/off based on device proximity to a human face.

Reboot recommended after using this parameter.

Note: Zebra recommends rebooting the device to ensure that changes to this parameter take effect.

Parm Name: ProximitySensor

Role Actions

Used to select an app to launch by default for the specified role. Works with the Package Name parameter.

Parm Name: RoleAction

Role Package Name

Used to enter the package name of the app to launch by default for a specified role. If no default app is selected, the device user is prompted to select an app to use each time the role arises with the option to set it as the default app (suppressing further prompts for that role).

Parm value input rules:

• String of at least one character containing a valid package name
• Leave blank to return device to the factory setting

Shown if: The Role Action is NOT "Do nothing"

Parm Name: PackageName

Requires:

• MX: 11.4+

Workflow Action

Used to control actions for managing Workflow(s), which automatically launch the app(s) designated for work activities. When more than one app is selected for a Workflow, the apps display simultaneously in split-screen mode and are subject to the behaviors described below.

Split-screen Behaviors:

• After being configured, Workflows are executed following each reboot of the device until removed; even after disabling Split Screen mode.
• If performing an Enterprise Reset on a device configured to execute and persist Split Screen mode, the apps still launch automatically on reboot, but run independently, not in Split Screen mode.
• Single-app Workflows launch the named app in full-screen mode; enabling split-screen mode is not required.
• Split-screen scenarios created manually by the device user execute with a screen ratio of 50:50 by default.
• The screen ratio can be changed manually on all split-screen scenarios by dragging the divider.
• Split-screen mode is exited on the device if:
  • Any Workflow app crashes.
  • A Workflow app is upgraded via adb.
• Workflows do not launch, might launch improperly or cause staging failure if:
  • The split-screen feature is disabled on the device.
  • One or more of the named apps are not present on target device(s).
  • One or more of the named apps does not support split-screen mode.
  • One or more of the named apps displayed a pop-up message when initially installed.
  • A Workflow is configured and deployed after split-screen is disabled on the target device(s).
• The StageNow client app does NOT support split-screen mode.

To Exit Split-screen:

• Drag divider toward the top-left or bottom-right of the screen
• Press HOME button and pull divider in any direction
• Press BACK button when first app is in focus
• Press BACK button when second app is in focus, then pull divider

Parm Name: Workflow

Workflow Package Name 1

Used to enter the package name of an Android app to launch as part of a Workflow. All Workflows require at least one app package name to be entered.

Parm value input rules:

• String of at least one character containing a valid package name of an Android app
  Example: com.myCompany.myWorkflowApp

Shown if: Workflow Action is "Add/Replace Workflow"

Parm Name: WorkflowPackageName1

Requires:

• MX: 11.9+
• Android API: 30+

Workflow Package Name 2

Used to enter the package name of a second (optional) Android app to launch as part of a Workflow.

Parm value input rules:

• String of at least one character containing a valid package name of an Android app
  Example: com.myCompany.myWorkflowApp

Shown if: Workflow Action is "Add/Replace Workflow"

Parm Name: WorkflowPackageName2

Requires:

• MX: 11.9+
• Android API: 30+

Workflow-app Allocation

Used to enter a percentage of the device screen (from 20-80) to be occupied by the app associated with Package Name 1 (required). The app associated with Package Name 2 (if specified) occupies the remaining percentage of the screen. If no value is entered, the screen is divided evenly for two-app Workflows (default value = 50).

Parm value input rules:

• Integer from 20–80

Shown if: Workflow Action is "Add/Replace Workflow"

Parm Name: WorkflowApp1Allocation

Requires:

• MX: 11.9+
• Android API: 30+

Immersive Mode Pop-up Show/Hide

Used to select whether to display a warning the first time an app attempts to enter Immersive Mode, which allows the app to fill the device screen and hides Status and Navigation bars.

Parm Name: ImmersiveModePopup

Examples

Configure Device Region and Keyboard

<wap-provisioningdoc>
  <characteristic type="UiMgr" version="4.3" >
    <parm name="CurrentLocale" value="en_GB"/>
    <parm name="InputMethodAction" value="1"/>
    <characteristic type="InputMethodDetails">
      <parm name="InputMethodOption" value="1"/>
    </characteristic>
  </characteristic>
</wap-provisioningdoc>

Set Enterprise Keyboard as the Default Input Method

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm name="InputMethodAction" value="1"/>
        <characteristic type="InputMethodDetails">
        <parm name="InputMethodOption" value="4"/>
        <parm name="InputMethodPackageName" value="com.symbol.mxmf.csp.enterprisekeyboard"/>
        <parm name="InputMethodClassName" value="com.android.inputmethod.latin.LatinIME"/>
        </characteristic>
    </characteristic>
</wap-provisioningdoc>

Queries

Queries are not supported on Zebra devices running Android 11 or later.

Get Current Locale

Input

 <wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm-query name="CurrentLocale"/>
    </characteristic>
</wap-provisioningdoc>

Output

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm name="CurrentLocale" value="en"/>
    </characteristic>
</wap-provisioningdoc>

Get Home Key Usage

Input

<wap-provisioningdoc>
<characteristic type="UiMgr" version="4.3" >
  <parm-query name="HomeKeyUsage"/>
</characteristic>

Output

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

Get Clipboard Usage

Input

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm-query name="ClipboardUsage"/>
    </characteristic>
</wap-provisioningdoc>

Output

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

Get AutoCorrect Usage

Input

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm-query name="AutoCorrectUsage"/>
    </characteristic>
</wap-provisioningdoc>

Output

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

Get Paring Popup

Input

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm-query name="BluetoothPairingPopupUsage"/>
    </characteristic>
</wap-provisioningdoc>

Output

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

Get Input Methods

Queries are not supported on Zebra devices running Android 11 or later.

Input

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <characteristic-query type="InputMethodDetails"/>
    </characteristic>
</wap-provisioningdoc>

Output Selected Input

 <wap-provisioningdoc>
    <characteristic type="UiMgr" version="4.3" >
        <parm name="InputMethodAction" value="1"/>
        <characteristic-query type="InputMethodDetails">
            <parm name="InputMethodOption" value="1"/>
        </characteristic>
    </characteristic>

Output Custom Input

<characteristic type="UiMgr" version="4.3" >
    <parm name="InputMethodAction" value="1"/>
    <characteristic type="InputMethodDetails">
        <parm name="InputMethodOption" value="4"/>
        <parm name="InputMethodPackageName" value="PackageName1"/>
        <parm name="InputMethodClassName" value="ClassName1"/>
    </characteristic>
</characteristic>

Get All Settings

Input

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

Output

<wap-provisioningdoc>
  <characteristic type="UiMgr" version="4.3" >
        <parm name="CurrentLocale" value="en"/>
        <parm name="HomeKeyUsage" value="1"/>
        <parm name="ClipboardUsage" value ="1"/>
        <parm name="AutoCorrectUsage" value ="1"/> 
        <parm name="InputMethodAction" value="1"/>
        <parm name="BluetoothPairingPopupUsage" value="1"/>
        <characteristic type="InputMethodDetails">
          <parm name="InputMethodOption" value="4"/>
          <parm name="InputMethodPackageName" value="PackageName1"/>
          <parm name="InputMethodClassName" value="ClassName1"/>
        </characteristic>
    </characteristic>
</wap-provisioningdoc>

Get Recent App Button status

Input

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="7.1" >
        <parm-query name="RecentAppButtonUsage" />
    </characteristic>
</wap-provisioningdoc>

Output (button enabled)

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="7.1" >
        <parm name="RecentAppButtonUsage" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Enable Navigation Bar

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="7.1" >
        <parm name="RecentAppButtonUsage" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Get Navigation Bar Status

Queries are not supported on Zebra devices running Android 11 or later.

Input

<wap-provisioningdoc>
    <characteristic type="UiMgr">
        <parm-query name="NavigationBarUsage"/>
    </characteristic>
</wap-provisioningdoc>

Output (Navigation Bar enabled)

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="7.1" >
        <parm name="RecentAppButtonUsage" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Disable Magnification Gesture

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="8.0" >
        <parm name="MagnificationGesture" value="2"/>
    </characteristic>
</wap-provisioningdoc>

Hide Virtual Keyboard

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="8.0" >
        <parm name="ShowVirtualKeyBoard" value="2"/>
    </characteristic>
</wap-provisioningdoc>

Enable SplitScreen Mode

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="8.1" >
        <parm name="SplitScreenMode" value="1"/>
    </characteristic>
</wap-provisioningdoc>

Disable SplitScreen Mode

<wap-provisioningdoc>
    <characteristic type="UiMgr" version="8.1" >
        <parm name="SplitScreenMode" value="2"/>
    </characteristic>
</wap-provisioningdoc>

Hide passwords

<wap-provisioningdoc>
    <characteristic version="9.1" type="UiMgr">
        <parm name="ShowPasswords" value="2" />
    </characteristic>
</wap-provisioningdoc>

Show passwords

<wap-provisioningdoc>
    <characteristic version="9.1" type="UiMgr">
        <parm name="ShowPasswords" value="1" />
    </characteristic>
</wap-provisioningdoc>