EMDK for Android v6.3 Release Notes

Important News

  • EMDK for Android support for all Jelly Bean (Android 4.1.2) and TC70 KitKat (Android 4.4.2) BSP version 112414 devices has been terminated - Starting from EMDK for Android v6.0, KitKat and higher OS versions (except TC70 KitKat BSP version 112414) are supported. EMDK for Android v5.0 will continue to support Jelly Bean and TC70 KitKat BSP version 112414 devices.

  • EMDK for Android support for Payment APIs is terminated - This version does not support Payment APIs. EMDK for Android v5.0 is the only version that supports Payment APIs.

  • EMDK OS update support for installation on Lollipop (Android 5.1.1) devices will be dropped -  The EMDK OS update which will be distributed with future EMDK installations will not support installation on Lollipop devices. EMDK for Android v6.3 will be the final version supporting installation on Lollipop (Android 5.1.1) devices. All future versions will support installation only on KitKat (Android 4.4.2) devices.

  • Support for ProfileConfig class has been deprecated - The ProfileConfig class which can be used to access the profile data has been deprecated. It is recommended to use the name-value pair function of Profile Manager feature. The Profile XML can also be directly modified. Refer to the Clock Sample for information on modifying Profile XML data.

  • Support for ContinuousRead class is deprecated - The ContinuousRead class which can be used to enable the continuous scanning has been deprecated. It is recommended to use the aimType, sameSymbolTimeout, differentSymbolTimeout of camera, imager and laser specific reader parameters.

  • Support for picklist field is deprecated - The picklist field used for enabling the picklist mode has been deprecated and it is replaced by the field picklistEx.

  • Online Help: The EMDK for Android Help documentation is now available only online. The EMDK installation will no longer install the documentation on the development computer.

  • Online Samples: The EMDK Samples are now available only online. The EMDK installation will no longer install the samples on the development computer. The online samples can be downloaded and used on the development computer.

Introduction

The EMDK for Android provides developers with a comprehensive set of tools to easily create powerful line of business applications for enterprise mobility devices and is designed for use with Google Android Studio. The EMDK for Android includes enterprise mobility 'Android' class libraries such as Barcode, sample applications with source code, as well as all of the associated documentation to help your applications take full advantage of what our devices have to offer. It also includes an exclusive Profile Manager Technology within the Android Studio IDE, providing a GUI based development tool. This allows you to write fewer lines of code resulting in reduced development time, effort and errors.

Description

  1. This version does not support Payment APIs. EMDK for Android v5.0 is the only version that supports Payment APIs.
  2. Added support for MX v6.2 in Profile Manager:
    •  Touch Manager
      1. Device Type - Select the Device Type to configure touch sensitivity.
      2. Protector - Enable or disable the screen protector on the supported devices.
    • Cellular Manager
      1. SimSocketSelect - Select the SIM card to connect to the network.
      2. SimSocketUsage - Allow or disallow the SIM card selection for network connection.
      3. KeyMapping Manager - Added key mapping support for NAV PAD Button.
  3. Barcode Manager APIs with the following features:
    • Added support for new pluggable scanner RS5000 to be used with WT6000 device. The following enhanced feature available in this release is for beta use only. It must not be used in production environment. A future version of EMDK will formally support this feature.
      1. Added "PLUGGABLE_IMAGER_RS5000" under BarcodeManager.DeviceIdentifier for selecting this scanner.
    • Added new reader parameters in each ImagerSpecific, CameraSpecific and LaserSpecific classes under ScannerConfig.ReaderParams.ReaderSpecific:
      1. aimTimer - Sets the duration for timed aim types such as timed hold and timed release.
      2. sameSymbolTimeout - This setting is used to prevent the scanner driver from decoding the same symbol within this time interval during continuous scan.
      3. differentSymbolTimeout - This setting is used to prevent the scanner from decoding another symbol within this time interval during continuous scan.
      4. picklistEx - Allows the imager or camera to decode only the barcode that is directly under the cross-hair (+)/ center of the reticle part of the pattern. This replaces the Picklist field under the imager specific class . This feature also allows selecting the hardware or software picklist.
      5. aimType - Allows selecting the aim type such as continuous, press & release, timed hold and timed release.
    • The ContinuousRead class which can be used to enable the continuous scanning has been deprecated. It is recommended to use the aimType, sameSymbolTimeout, differentSymbolTimeout of camera, imager and laser specific reader parameters.
  4. Enhanced Profile Manager for the following features:
    • DataCapture feature:
      1. Support for selecting RS5000 as the scanning device. This enhanced feature available in this release is for beta use only. It must not be used in production environment. A future version of EMDK will formally support this feature.
      2. Support for the new "Data Capture Plus (DCP)" feature. This feature Data Capture Plus (formerly known as the "Data Capture Panel") enables areas of the device screen to be designated as scan triggers. By tapping on a designated screen area, DataWedge will respond as it would to a scanner button-press or other hardware trigger.
      3. Support for the new "Keep enabled on suspend" feature. Enabling this feature will keep the Bluetooth scanner enabled when the device is in suspend mode. Pressing the Bluetooth scan trigger will wake up the device for scanning.
    • Added new parameter “Receiver foreground flag” in Intent Output for delivering the captured data via Broadcast Intent to broadcast recipient permission to run at the foreground priority with a shorter timeout interval.
    • Added the following new parameters in Keystroke Output feature:
      1. Multi byte character delay -  Sets an inter character delay in milliseconds for multi byte characters. This setting was required to be set in-order to overcome data dispatching errors when dispatching multi byte characters to browser.
      2. Key event delay - Sets a delay in milliseconds for dispatching control characters as keystrokes correctly to the foreground application.
  5. Enhanced Serial Comm APIs with the following features:
    • Added getConfig() and setConfig() for accessing the current configuration settings such as baudRate, parity, dataBit and stopBit.
    • Added getSignalState() to query the signal status such as DTR, DCD, DSR, RI, RTS and CTS.
    • Added new method setSignalState() to set the signal status such as RTS and DTR.
    • Added getPortInfo() to query the port name.
  6.  

Device Compatibility

This software release has been approved for use with the following devices.

Device

Android KitKat

Android Lollipop

Android Marshmallow

ET5X

 

*

 

MC18

*

 

 

MC40

*

 

 

MC67

*

 

 

MC92

*

 

 

TC51

 

 

*

TC55

*

 

 

TC56

 

 

*

TC70

*

*

 

TC75

*

*

 

TC75x

 

 

*

TC8000

*

*

 

WT6000

 

*

 

Installation Requirements

The following software must be installed prior to using the EMDK for Android.

  • Microsoft® Windows 7 (32-bit and 64-bit)  or Microsoft® Windows 8 (32-bit and 64-bit) or Microsoft® Windows 8.1 (32-bit and 64-bit)

  • Java Development Kit (JDK) v7u45 or higher

  • Android Studio v2.x or higher.

Notes:

  1. The appropriate Android SDK Platform package must be installed on the development machine in order to target the right EMDK APIs SDK add-on. For example, Android 6.0 (API 23) must be installed for targeting EMDK APIs (API 23) as Compile SDK Version in Android Studio.

  2. For building EMDK samples, the Android SDK Build-tools rev.23.0.x or higher must be installed.

  3. All the Android Studio sessions must be closed if already running.

Device Updates

Before using the EMDK for Android features on your Zebra Android device, you must update it with the EMDK device runtime using EMDK OS update.

Please note that upon installing the EMDK OS update, the following components on the device (if the version is lower) will be updated to the below versions.

Component

Version

(Android Lollipop and KitKat)

EMDK API

6.3.23.623

DataWedge

6.2.23

MX MF

6.2.0.13

Note: The EMDK OS update distributed with the EMDK installation does not support installation on TC8000 KitKat devices and Marshmallow devices such as TC51.

 

Usage Notes

None.

 

Known Issues

None.

Part Number and Release Date

EMDK-A-0603037

February 07, 2017

© 2014-2017 Zebra Technologies Corp. All rights reserved.