Enterprise Keyboard Setup

Enterprise Keyboard 3.4

Overview

Enterprise Keyboard (EKB) setup varies by device but activation is always necessary to make it available to users. EKB also can be set as the default input method, if desired.

EKB can be activated and configured:

  • Manually at the device (covered here)
  • Remotely (covered elsewhere):
    • Zebra's StageNow device configuration tool and the UI Manager and Enterprise Keyboard Manager services (requires MX 6.3 or higher on the device)
    • Through a company's own enterprise mobility management (EMM) system (if compatible; see that system's info)

This guide covers:

For advanced settings, such as language selection and scan-tab configuration:

Install/Upgrade EKB

Some versions of EKB can be downloaded from the Zebra Support Portal and installed as a user app. Devices running Android 7.x Nougat (or higher) with older versions of EKB can be upgraded to the latest EKB version using the latest .apk file. Visit the Support Portal for specific EKB device and OS support information. Installation and upgrade instructions are below.

Before beginning any installation...

  1. See EKB download instructions and get the correct file(s) for the target device(s).
  2. Ensure that target device(s) are able to connect via USB to the host computer. Get USB drivers
  3. Note that Enterprise Keyboard requires activation following installation.

Upgrade/install using USB

  1. Connect the device via USB to the host computer that contains the downloaded Enterprisekeyboard.apk file.
  2. Copy the Enterprisekeyboard.apk file to the root directory of the device.
  3. Navigate to the file using a file manager app on the device.
  4. Tap the file to install it.
  5. See Verify Installation section below.

NOTE: After installation, Enterprise Keyboard requires activation.

Upgrade/install using adb

  1. Connect the device via USB to the host computer that contains the downloaded Enterprisekeyboard.x.x.x.x.apk file (where "x.x.x.x" = EKB version number).

  2. For devices with an older EKB already installed, run the following command:

    
adb install –r EnterpriseKeyboard_file_name.apk

    The "-r" option reinstalls an existing app and retains any existing user data.

  3. For devices with no prior version of EKB installed, run the following command:

    
adb install EnterpriseKeyboard_file_name.apk

  4. See Verify Installation section below.

NOTE: After installation, Enterprise Keyboard requires activation.

Also see

Uninstalling/Downgrading EKB

Notes:

  • If EKB was installed as a user app on a device with no prior version, removal is the same as for any standard Android app.
  • If EKB was installed as an upgrade on a device with EKB preinstalled, removal reverts to the preinstalled version.

Uninstall using adb

  1. Connect the host computer to the device that contains the Enterprise Keyboard to be uninstalled.

  2. From a terminal window, run the following command: 

    
adb uninstall com.symbol.mxmf.csp.enterprisekeyboard

  3. To verify uninstallation, use the Verify Installation instructions below to confirm that EKB was removed or downgraded to the preinstalled version.

Uninstall using the Settings panel

If downgrading to a preinstalled version:

  1. On the device that contains the Enterprise Keyboard to be uninstalled:
    Go to Settings -> Apps & Notification -> Enterprise Keyboard
  2. Tap "Disable" then "Disable App" then "OK" to confirm the downgrade.
    When uninstallation completes, the older EKB version number is displayed.
  3. Tap the "Enable" button to use the older EKB version.
  4. To use a different keyboard see the Manual Activation section.

If removing EKB installed as a user app:

  1. On the device that contains the Enterprise Keyboard to be uninstalled:
    Go to Settings -> Apps & Notification -> Enterprise Keyboard
  2. Tap the "Uninstall" button.
  3. When uninstallation completes, the standard Android keyboard becomes the default.
  4. To verify, open "Apps & Notification" in the Settings panel and confirm that "Enterprise Keyboard" is not listed.

NOTE: Settings panel labels such as "Apps & Notification" vary by Android version.

Verify Installation

Verify installation/upgrade success

  1. Go to Settings -> Apps & Notification -> Enterprise Keyboard
  2. Verify that the version corresponds with the version installed.

NOTE: After installation, Enterprise Keyboard requires activation.

EC30 Notes

  • On successful installation or upgrade on an EC30 device, EKB is shown in the Launcher app list.
  • To activate EKB on an EC30: Settings -> System -> Languages & input -> Virtual Keyboard -> Enterprise Keyboard.

Manual Activation

The section covers direct activation of Enterprise Keyboard on a single device. If using one of the remote methods referenced above to activate and configure multiple managed devices, please see the Automated Activation section later in this guide.

To quickly determine whether Enterprise Keyboard has been activated:

1. Bring up the Android keyboard and long-press the spacebar.

2. If "Enterprise Keyboard" appears in a screen like the one below, tap its radio button (arrow) to set it as the default input device:

If the Enterprise Keyboard does not appear, proceed to the steps below.

Activate Enterprise Keyboard

1. Open the Settings panel on the device:

2. Scroll to and tap the "Language and input" control:

3. Place a check next to "Enterprise Keyboard" to enable it on the device. Uncheck other input devices to disable them, if desired. * This step might not be necessary* if Enterprise Keyboard was included with the device by default (and not downloaded as a user app or OS patch).

NOTE: To activate EKB on the EC30 and certain other devices:
Go to Settings -> System -> Languages & input -> Virtual Keyboard -> Enterprise Keyboard

4. Tap "Default" to set the default input device:

5. Tap the Enterprise Keyboard radio button to set it as default input device: Note: This panel also can be invoked by long-pressing the spacebar whenever the Android or Zebra keyboard is visible.

6. Tap the HOME key to exit the Settings panel.

Enterprise Keyboard is now ready to use with default settings.

EC30 Note: To activate EKB on an EC30 device, go to:
Settings -> System -> Languages & input -> Virtual Keyboard -> Enterprise Keyboard.

Enterprise Keyboard Settings

Following installation, Enterprise Keyboard settings can be changed through the Android Settings panel.

Change EKB settings:

1. Open the Settings panel on the device:

2. Tap the "Language and input" control:

3. Tap the Enterprise Keyboard Settings button to change settings:

4. On the Enterprise Keyboard Preferences panel, tap the setting(s) that require change: See the Customize section for more information about Enterprise Keyboard settings.

Automated Activation

Enterprise Keyboard 1.1 (and higher) can be configured remotely on multiple managed devices using Zebra's StageNow tools and the UI Manager service or an organization's own MDM system.

Actions to be executed on the Android Settings panel:

  1. Open Language and input
  2. Add a check for "Enterprise Keyboard" to enable it on the device
  3. Select Enterprise Keyboard as the default input device
  4. Select a language (if other than the system default)

Set as Default Input Device

Whether using the UI Manager service through Zebra's StageNow or EMDK tools, or if deploying Enterprise Keyboard from a company's own MDM, it is necessary to specify Enterprise Keyboard's package and class names to select it as the default keyboard on the device.

The required package and class names are shown as the values below, wrapped by the coding necessary for using one of Zebra's tools: 

    
    <parm name="InputMethodPackageName" value="com.symbol.mxmf.csp.enterprisekeyboard"/>
    <parm name="InputMethodClassName" value="com.android.inputmethod.latin.LatinIME"/>

For additional information about usage and syntax, please refer to respective documentation.

Manual Deactivation

Enterprise Keyboard cannot be removed if it was included with the device operating system. However, it can be deactivated by reversing the activation process described in the Activation section. The steps below describe how to deactivate Enterprise Keyboard using the Android Settings panel.

Warning: This action renders Enterprise Keyboard inaccessible, including its scanning and other capabilities.

Deactivate Enterprise Keyboard on a device:

1. Open the Settings panel on the device:

2. Scroll to and tap the "Language and input" control:

NOTE: To deactivate EKB on the EC30 and certain other devices:
Go to Settings -> System -> Languages & input -> Virtual Keyboard -> Enterprise Keyboard

3. Remove the check next to "Enterprise Keyboard" to disable it on the device. If the Android keyboard is the only other input device, it automatically becomes the default input device and cannot be disabled.

Manual deactivation of Enterprise Keyboard is complete.

Automated Deactivation

Enterprise Keyboard 1.1 (and higher) can be deactivated on multiple managed devices using an organization's own MDM server in the same way as other Android apps. Alternatively, remote uninstallation can be accomplished through Zebra's EMDK or StageNow tools using the App Manager service.

Multi-user Mode

Enterprise Keyboard 2.0 (and higher) supports Primary and Secondary Users on devices built on Zebra's SDM660 platform (including ET51, ET56, L10, MC93, PS20, TC52, TC57, TC72 and TC77) running Android 8.x Oreo (and higher). Primary Users can make changes to EKB settings and create Secondary Users on the device. Secondary Users cannot change EKB settings or create additional users.

To create a Secondary User:
(Android 8.x Oreo and higher)

  1. Sign into a device as a Primary User.
  2. Open the Settings panel on the device.
  3. Tap Users & accounts -> Users -> Add user -> Add a new user.
  4. Follow prompts to complete the process.

EKB Settings are "greyed out" for Secondary Users. Click image to enlarge, ESC to exit.

To switch users

  1. Open the Settings panel on the device.
  2. Tap Users & accounts -> Users. A list of device User names appears.
  3. Tap on the desired User name to switch to that User.

Supported only on SDM660-platform devices running Android 8.x Oreo.