Upcoming Dev EventsDevTalks Schedule: https://partnerportal.zebra.com/PartnerPortal/resources/events/DevTalk.aspx

Next Session – March 17, 2021What's New with Mobility DNAMobility DNA gives Zebra mobile computers their distinct enterprise capabilities. In this session, Darryn Campbell will take you on a whirlwind tour of some of the latest features added to Mobility DNA to make a user's life easier—from simpler update distribution to new APIs—and review the latest features of MX and DataWedge, plus more.Date and Time:March 17, 202110 a.m. CT

November 2021 - Zebra DevCon (Developer Conference)Live event (location to be confirmed)

Testing Exported XML before EMM Deployment via OEMConfigIan HattonPreSales ConsultantZebra EMEA

Agenda

• OEMConfig Overview

• EMM XML Deployment demo using OEMConfig

• Rapid testing of exported XML

• XML Configuration Samples

ZEBRA TECHNOLOGIES

OEMConfig

• New Interface to Zebra’s proprietary API’s aka Mobility Extensions (Mx)

• Removes the need for EMM’s to develop custom code to interface with OEM API’s

• Uses Google standard launched in 2018

• Zebra OEMConfig App published on Play : https://play.google.com/store/apps/details?id=com.zebra.oemconfig.common

• This app currently requires use with an EMM client which supports OEMConfig

• Requires GMS features to be enabled (not compatible with GMS Restricted Mode)

ZEBRA TECHNOLOGIES

OEMConfig

•

ZEBRA TECHNOLOGIES

XML Deployment via OEMConfigOverview

• Exported XML can be deployed using any EMM supporting OEMConfig via the Device Administrator / Submit XML option

• Screenshot shows this option accessed via Wizy EMM

• Paste the required XML into the field available in the Submit XML section

• Make sure that the SubmitXMLoption is enabled in the Action field

ZEBRA TECHNOLOGIES

Testing Exported XML before EMM Deployment via OEMConfigOverview

• StageNow can export raw XML for most profiles using the Export for MDM option after pressing the 3 vertical dot icon next to the required profile :

ZEBRA TECHNOLOGIES

Testing Exported XML before EMM Deployment via OEMConfigOverview

• Test initially with a simple XML profile e.g. enable bluetooth• <wap-provisioningdoc>• <!--BTON-->• <characteristic version="4.3" type="WirelessMgr">• <parm name="Bluetooth" value="1" />• <parm name="BluetoothState" value="1" />• </characteristic>• </wap-provisioningdoc>

• Comments can be embedded in XML

• XML version header tag is not required (<?xml version="1.0" encoding="utf-8"?>)

• Wap-provisioning open/close tags are also optional

ZEBRA TECHNOLOGIES

Wizy OEMConfig XML Deployment Demo

• Wizy (https://wizyemm.com/) is an EMM which uses Google Management API’s

• Free version available for up to 2 devices with minimal feature set

• Very competitive pricing for basic functionality (excluding Remote Control ) : 2 USD per device per month list

• Full Remote Control supported on Zebra devices via a plugin

• Also supports Zebra FOTA deployment of OS images + LifeGuardpatches

ZEBRA TECHNOLOGIES

Testing Exported XML before EMM Deployment via OEMConfigSnexport_tester Utility

• Unofficial/unsupported utility to simplify testing of exported XML is available here: https://developer.zebra.com/blog/testing-xml-exported-stagenow-emm-deployment

• Uses ADB to push XML file to /sdcard/myxml.xml and then a single StageNow barcode to process it via the Batch CSP

• XML can be edited and redeployed easily – modified XML can then be saved when working correctly

ZEBRA TECHNOLOGIES

Testing Exported XML before EMM Deployment via OEMConfigUsage

• Press Select to chose XML file to load• XML will be displayed in edit panel• Press Syntax check to load the current

XML into Chrome in order to make a basic syntax check

• Press Push to send the currently displayed XML to the connected device via ADB (SN barcode on mid right side can be used to enable ADB )

• Press Start SN to start the StageNowclient on the test device

• Scan the SN barcode on lower right side to process the deployed XML

ZEBRA TECHNOLOGIES

Testing Exported XML before EMM Deployment via OEMConfigUsing a standard editor

• Editor such as Notepad++ can also be used and includes colour coding for XML syntax

• Copy XML to device via SendTo menu using _copy_to_myxml.bat

• XML pushed via ADB to device as /sdcard/myxml.xml

• Myxml.xml is processed via Mx Batch CSP which is invoked via the StageNowmyxml_sdcard.pdf barcode

ZEBRA TECHNOLOGIES

Testing Exported XML before EMM Deployment via OEMConfigXML Configuration Samples

ZEBRA TECHNOLOGIES

Testing Exported XML before EMM Deployment via OEMConfigXML Samples – Install Zebra Licence

• Zebra software licences can be installed via LicenceMgr

• Licence will be reinstalled automatically if device is cleanbooted and re-enrolled

• Requires IP path to cloud server in order to acquire licence

ZEBRA TECHNOLOGIES

Testing Exported XML before EMM Deployment via OEMConfigXML Samples – Install Open Keyboard

• Customers may prefer not to use Gboarddue to data security concerns (https://developer.zebra.com/blog/using-openboard-keyboard-replacement-google-gboard )

• OpenBoard is an open source alternative which can be installed to replace Gboard

• XML profile will make OpenBoard the default input method and also disable Gboard

•

ZEBRA TECHNOLOGIES

Testing Exported XML before EMM Deployment via OEMConfigXML Samples – using AccessMgr to grant ‘display over other apps’ permission

• Some apps require the ‘display over other apps’ permission which normally is granted by the user

• AccessMgr can be used to pre-grant this permission on a per-application basis

• Requires the app package name and the app certificate in Base64 format

• Zebra sigtools utility can be used to extract the required certificate

ZEBRA TECHNOLOGIES

Testing Exported XML before EMM Deployment via OEMConfigXML Samples – using AccessMgr to grant ‘display over other apps’ permission

• Steps :

• 1. Use aapt.exe to obtain package name (apkinfo.bat)

• 2. Use sigtools to extract APK signature to separate file (getsig.bat)

• 3. Copy and paste certificate into the Accessmgr XML

• 4. Deploy and test

ZEBRA TECHNOLOGIES

Testing Exported XML before EMM Deployment via OEMConfigXML Samples – Enable Restricted Settings

• This XML will remove the settings icons normally shown in the notification pulldown

• Leaves only the backlight slider available plus WAN network name

• Will also restrict Settings to Display,Sound and About

ZEBRA TECHNOLOGIES

Testing Exported XML before EMM Deployment via OEMConfigXML Samples – Enable Application Whitelist

• AccessMgr supports creation of a whitelist of allowed applications

• Any (non-system) applications not on the whitelist will be hidden if already installed or blocked for installation

• Provides a simple way to restrict device to run only approved apps

• App package names should be specified in XML separated by a comma:

• <parm name="AddPackageNames" value="tunein.player,com.adobe.reader" />

ZEBRA TECHNOLOGIES

Testing Exported XML before EMM Deployment via OEMConfigXML Samples – Disable Zebra Analytics

• In cases where a customer requires ZDS Analytics to be disabled, this can be easily configured using this XML

• Can be verified by running Zebra Data Service app and checking Device Data switch is off

ZEBRA TECHNOLOGIES

Testing Exported XML before EMM Deployment via OEMConfigXML Samples – Control RxLogger

• XML can be used to remotely enable/disable/export RxLogs using the intents detailed here: https://techdocs.zebra.com/rxlogger/6-0/guide/apis/

• Allows the EMM to selectively enable logging on a single or small group of devices for debug purposes

ZEBRA TECHNOLOGIES

Testing Exported XML before EMM Deployment via OEMConfigXML Samples –RxLogger Upload

• Some EMM’s do not support file upload from device to server which means that an exported RxLog cannot be retrieved automatically

• FileMgr supports upload from MX 10.1 onwards

• This XML performs the following steps:• Exports the RxLog using the intent API

• Pauses for 5 seconds in order to allow the export to complete

• configures FileMgr to upload the latest exported log file from /sdcard/RxLogger using FTP

• File will be automatically deleted from device after upload

ZEBRA TECHNOLOGIES

Testing Exported XML before EMM Deployment via OEMConfigXML Samples – LifeGuard install

• LifeGuard patches can be downloaded and installed via XML

• Provides a consistent way to do this across all EMM’s supporting OEMConfig

• XML checks battery level is >30% before downloading file which avoids an error occurring after download

• Requires the patch file to be posted on a network accessible link using HTTP/HTTPS or FTP/FTPS

• Could also be used for a full OS image provided a good/fast network connection is available

ZEBRA TECHNOLOGIES

Download Links

• Download link for utils and sample XML profiles:

• http://zebra.airsetup.com/2021/devtalks/xml_devtalk_utils_v1.zip

ZEBRA TECHNOLOGIES

Questions?

ZEBRA TECHNOLOGIES

Questions??http://developer.zebra.com

Zebra Developer Community – LinkedIn Group

@ZebraDevs

<<Your Title and Info here >>