Download - SAP Fiori Mobile (v2.1.x) - Cognex

t it le:SAPFioriMobile(v2.1.x);ver:2.6.x 1/47

SAPFioriMobile(v2.1.x)

Introduct ion

Whatarehybridmobileapps?

Hybridmobileappsarewebapplicationswrappeduptheirownbrowserwhichcanrunonanyofthemobileplatforms(Android,iOS,Windowsetc.).Thebigadvantageofahybridappisthatithasasinglecodebase,whereasanativeappmustbere-writtenforeachplatform.

ApacheCordovaisanopen-sourceframeworkfordevelopinghybridapps.Tousenativefeatures(beyondthosealreadyavailableviahmtl5,)appscanmakeuseofplugins.Thesepluginshandletheplatform-specificcodeandareavailableforsingleormultipleplatforms.PluginsareavailabletoaccesstheGPS,accelerometerorcamera,forexample.

SAPhavewrittentheirownplugins,brandedasKapsel,tohandlethingslikelogonandofflineOData.Thesebringanenterpriseflavourtohybridapps.

WhatisFioriMobile?

UntilrecentlySAP’srecommendedapproachwastousetheHybridApplicationToolkit(orHAT)inordertobuildhybridapps.Theappbuildtookplaceonthedeveloper’sPCorMac.TheHATgainedareputationforbeingtrickytosetupandthathinderedtheuseofhybridappswithintheSAPecosystem.

FioriMobilehasat it scoreacloud-buildservice,sothereisnoneedtoinstalltheHAT.WecantriggerthebuildfromWebIDE.Wespecifythe(alreadydeployed)Fioriapp(s)thatwewanttopackageandafterafewminuteswecandownloadthe.apk(forAndroid)and.ipa(foriOS)filesreadytobeinstalledonmobiledevices.

Doesit work?

Thecloudbuildserviceworkswell.Ittypicallybuildforbothplatformsinabout8minuteswithoutissueas.Therehaveonlybeenacoupleofoccasionswhenbuildsfailedduetotechnicalproblems.

Therearesomefacetstothetechnologywhichdon’tfeelmatureyet.OneareaistheofflineODatafeatures.WhenusingFioriMobilethingsworkdifferentlytothemoreconventionalhybridandnativeapps.Oneexamplewouldbethedestinations,becauseFioriMobileappsuseagenerateddestinationwhichreferencetheSAPCloudPlatform(CP)portalservice.

https://cordova.apache.org/

https://help.sap.com/saphelp_smp303sdk/helpdata/en/7c/05514870061014ae31b35a27134786/frameset.htm


MypointisnotthatofflineODataseemsimmature,ratherthattheofflinefeaturescanbetrickywhenusedwithFioriMobileapps.WearestillreceivingassistancefromSAPtogettheofflinefeaturesofourappoptimised.Thisisashame,becauseshareddataandthehandlingofdeltarequests,forexample,aretwofeatureswhichjustifythe‘middleware’approachtoofflinethatSAPhavetaken.

Authenticationhasalsobeenachallenge.OnapreviousprojectIusedtheFioriClientinconjunctionwithSAPCloudIdentity(nowofficiallySAPCloudPlatformIdentityAuthentication).TheFioriClientstoredtheusernameandpasswordonthedevicesothattheuserdidn’tneedtoenterthemeverytimetheirsessiontimedout.Wehaven’tachievedthatyetwithourFioriMobileapp.

Account andServices

IfyouhaveproductionaccountbrowseonHCPCockpitandlogin.Ifyouusetrialaccountloginhere

AswesaidbeforethereistwowaystobuildSAPFiorimobileapplication:

1. UsingFioriMobileService.NotethatthisservicehavebeendiscontinuedfromMarch31,2018.StrategicfeaturesavailableinthemobileserviceforSAPFiorihavebeenincorporatedintoSAPCloudPlatformmobileservicefordevelopmentandoperations.Howeveryoucanusethisserviceifyouhaveoldaccountthatalreadyhasenabledthatservice.Usingthisservicerequiretwootherservicestobeenabled:PortalServiceandSAPWebIDEFull-StackService.

https://help.sap.com/viewer/e2ed9b4f3edb4391a7a89b1af84d9606/3.0.15/en-US/ec9fb688ebe64f1bb2f6932d88f81876.html

https://cloudplatform.sap.com/capabilities/security/cloud-identity.html

https://account.hana.ondemand.com/cockpit

https://account.hanatrial.ondemand.com/cockpit




2. UsingHAT (HybridApplicationToolkit)extensioninSAPWebIDEFull-StackService.UsingthisextensionrequireMobileServicestobeenabled.

CreateFioriLaunchpad

IfweuseSAPForiMobileServicetobuildmobileapplicationfirstweneedtocreateandpublishsitewhereapplicationwillbedeployed.OtherwiseifweuseHATskipthisstepandcontinuewithCreateFioriProject

GotoPortalServiceandcreatenewSiteDirectory

Apopupwillbedisplayed.EnteryourSiteName,chooseSAPFioriLaunchpadasTemplateSourceandclickCreate

https://cmbdn.cognex.com/v2.1.x/knowledge/sap-fiori-mobile/create-fiori-project


FollowingthisyouwillberedirectedtoSAPFioriConfigurationCockpit.ClosethetabandgobacktoAdminSpaceforPortalService.

NowweneedtoPublishthisSiteandSetasdefault.



CreateFioriProject

OncewecreateandpublishcmbSDKTestSitewecancreateourFioriproject(ifweuseFioriMobileServicetobuildmobileapplication,otherwiseifweuseHATwedon'tneedtopublishsiteonLaunchpadandcreatingFioriprojectwillbeourfirststep).

GotoServicestabagain,openSAPWebIDEFull-Stackservice,andclickonGotoService


Anewtabwillbeopened.FromherewewillstarttocreateourFioriproject.

ClickonNewProjectfromTemplate


ChooseSAPUI5ApplicationfromTemplateSelection

SetyourProjectNameandNamespace


ChoosetheViewTypeandsettheViewName.InoursamplewewilluseXMLView.ClickFinishandyourFioriprojectiscreated.

HowtousecmbSDKcordovaplugin

IntheSAPWebIDEWorkspacewecanseeallfilesthatourFioriprojectinludes.


OpenComponent.jsfile .

Component.jsisthefirstpointofourapplication,wecansaythatitservesasindexwhichencapsulatesallourapplicationsdetails,i.e .viewnames,routingdetails,mainview,applicationstype(FullScreenorSplitApp),applicationserviceconfigurationetc..

Hereininit functionwewillconfigureourplugin.Setpropertiesthatweneed,setcallbackfunctions,callsomemethods,etc..

sap.ui.define([ "sap/ui/core/UIComponent", "sap/ui/Device",


"MyFirstFioriApp/MyFirstFioriApp/model/models"],function(UIComponent,Device,models){ "usestrict";

varoEventBus=sap.ui.getCore().getEventBus(); varscannerIsInitialized=false;

returnUIComponent.extend("MyFirstFioriApp.MyFirstFioriApp.Component",{

metadata:{ manifest:"json" },

/** *ThecomponentisinitializedbyUI5automaticallyduringthestartupoftheappandcallstheinitmethodonce. *@public *@override */ init:function(){ //callthebasecomponent'sinitfunction UIComponent.prototype.init.apply(this,arguments);

//enablerouting this.getRouter().initialize();

//setthedevicemodel this.setModel(models.createDeviceModel(),"device");

if(!scannerIsInitialized){

scannerIsInitialized=true; window.readerConnected=0; window.scannerActive=false;

cmbScanner.addOnResume(function(result){ cmbScanner.setAvailabilityCallback((readerAvailability)=>{ if(readerAvailability===cmbScanner.CONSTANTS.AVAILABILITY_AVAILABLE){ oEventBus.publish("ScanView","SetConnectionStatus",{ statusText:"AVAILABLE" }); cmbScanner.connect((result)=>{}); }else{ oEventBus.publish("ScanView","SetConnectionStatus",{ statusText:"NOTAVAILABLE" }); } }); if(Device.os.android){ cmbScanner.connect((result)=>{}); } });

cmbScanner.addOnPause(function(result){ if(Device.os.android){ cmbScanner.disconnect(); } cmbScanner.setAvailabilityCallback();


});

cmbScanner.setPreviewContainerPositionAndSize(0,0,100,50);

cmbScanner.setConnectionStateDidChangeOfReaderCallback((connectionState)=>{ if(connectionState===cmbScanner.CONSTANTS.CONNECTION_STATE_CONNECTED){ oEventBus.publish("ScanView","SetConnectionStatus",{ statusText:"CONNECTED" }); if(window.readerConnected!=connectionState){ cmbScanner.setSymbologyEnabled("SYMBOL.DATAMATRIX",true); cmbScanner.setSymbologyEnabled("SYMBOL.C128",true); cmbScanner.sendCommand("SETTRIGGER.TYPE2"); } }elseif(connectionState==cmbScanner.CONSTANTS.CONNECTION_STATE_DISCONNECTED){ oEventBus.publish("ScanView","SetConnectionStatus",{ statusText:"DISCONNECTED" }); }elseif(connectionState==cmbScanner.CONSTANTS.CONNECTION_STATE_CONNECTING){ oEventBus.publish("ScanView","SetConnectionStatus",{ statusText:"CONNECTING" }); }elseif(connectionState==cmbScanner.CONSTANTS.CONNECTION_STATE_DISCONNECTING){ oEventBus.publish("ScanView","SetConnectionStatus",{ statusText:"DISCONNECTING" }); } window.readerConnected=connectionState; });

cmbScanner.setAvailabilityCallback((readerAvailability)=>{ if(readerAvailability===cmbScanner.CONSTANTS.AVAILABILITY_AVAILABLE){ oEventBus.publish("ScanView","SetConnectionStatus",{ statusText:"AVAILABLE" }); cmbScanner.connect((result)=>{}); }else{ oEventBus.publish("ScanView","SetConnectionStatus",{ statusText:"NOTAVAILABLE" }); } });

cmbScanner.setActiveStartScanningCallback((result)=>{ if(result===true) window.scannerActive=true;


else window.scannerActive=false; });

cmbScanner.setPreviewOptions(cmbScanner.CONSTANTS.PREVIEW_OPTIONS.DEFAULTS|cmbScanner.CONSTANTS.PREVIEW_OPTIONS.HARDWARE_TRIGGER);

cmbScanner.setCameraMode(cmbScanner.CONSTANTS.CAMERA_MODES.NO_AIMER);

varsdkKEY=""; if(Device.os.android) sdkKEY=this.getModel("i18n").getProperty("MX_MOBILE_LICENSE_ANDROID"); else sdkKEY=this.getModel("i18n").getProperty("MX_MOBILE_LICENSE_iOS");

cmbScanner.registerSDK(sdkKEY);

cmbScanner.loadScanner(0,(result)=>{ cmbScanner.connect((result)=>{}); });

oEventBus.subscribe("Component","LoadScanner",this.loadScanner,this); } }, loadScanner:function(sChanel,sEvent,oData){ cmbScanner.disconnect((result)=>{ cmbScanner.loadScanner(oData.selectedDevice,(result)=>{ cmbScanner.connect((result)=>{}); }); }); }, onExit:function(){ oEventBus.unsubscribe("Component","LoadScanner",this.loadScanner,this); cmbScanner.disconnect(); cmbScanner.setAvailabilityCallback(); } });});

cmbScannerisanobjectthatrepresentsourplugin.WiththisobjectwecanaccessallAPImethodsandConstantsfromourplugin.

scannerIsInit ialized-variabletomakesurethatwesetsomefunctionsforinitializationonlyonetimewindow.readerConnected-globalvariablethatischangedeverytimewhenthereaderconnectionstateischangedwindow.scannerAct ive-globalvariablethatshowsusifscanningisactiveornotcmbScanner.addOnPause-inthismethodwedisconnectionfromreaderdeviceonAndroid(oniOSthisishandledautomatically),andstoplisteningtoavailabilitychangingcmbScanner.addOnResume-inthismethodwetrytoconnectwithreaderdeviceagainandsetcallbackforavailabilitychanging

https://cmbdn.cognex.com/v2.1.x/knowledge/cordova-plugin-for-cmbsdk/api-methods


cmbScanner.setPreviewContainerPosit ionAndSize-tosetthesizeandpositionofthepreviewcontainer.Learnmorehere.cmbScanner.setConnect ionStateDidChangeOfReaderCallback-allconnect /disconnect eventsshouldbehandledwithinthecallbackfunctionsetwiththisAPImethod.IfconnectionstateisconnectedwesetsomereaderdevicesettingswithAPImethodsordirectlywithsendCommand()method.Hereinthisexampleweenablesymbologiesandsettriggertype.AlsohereweshouldLicensingtheSDK.WewillspeakaboutthislaterinthissectioncmbScanner.setAvailabilit yCallback-tomonitorforavailabilityoftheMXdevice.IfMXdeviceisavailablewetrytoconnect.Learnmorehere.cmbScanner.setAct iveStartScanningCallback-tomonitorthestateofthescanner.Learnmorehere.cmbScanner.loadScanner-togetascannerupandrunning.Learnmorehere.

Hereweareonlyconfiguringreaderdevice,handlingconnections,availability,etc..Wewilldoscanningandgettingresultsinotherviews.IfwewanttonotifyusersabouteveryconnectionstatechangedorotherinfoaboutreaderdevicewewillbeusingEventBussapobject.Withthisobjectwecanpublishfunctionandcallthemfromanyviewintheapplication.InthisexampleonconnectionstatechangedwithEventBuswearecallingSetConnect ionStatusfunctionthatisimplementedinviewwherescanningisperformedandsetlabeltexttoshowusercurrentconnectionstate.

NowopenScanView.view.xmlandaddthiscode:

<mvc:ViewcontrollerName="MyFirstFioriApp.MyFirstFioriApp.controller.ScanView"xmlns:mvc="sap.ui.core.mvc"displayBlock="true"xmlns="sap.m" xmlns:core="sap.ui.core"> <Shellid="shell"> <Appid="app"> <pages> <Pageid="page"title="{i18n>title}"> <subHeader> <Toolbarid="__toolbar2"width="100%"> <content> <FlexBoxid="__box0"width="100%"alignContent="Center"alignItems="Start"direction="Column"fitContainer="true"justifyContent="Center"> <items> <Selectid="selectActiveDevice"items="{/Devices}"textAlign="Center"selectedKey="0"change="activeDeviceChanged"> <core:Itemtext="{text}"key="{key}"/> </Select> </items> </FlexBox> <Labelid="lblStatus"text="DISCONNECTED"width="100%"textAlign="End"design="Bold"/> </content> </Toolbar> </subHeader> <content> <FlexBoxid="flexBoxContainer"width="100%"alignContent="Start"alignItems="Start"direction="Column"fitContainer="true"/> </content>

https://cmbdn.cognex.com/v2.1.x/knowledge/cordova-plugin-for-cmbsdk/api-methods/setpreviewcontainerpositionandsize

https://cmbdn.cognex.com/v2.1.x/knowledge/cordova-plugin-for-cmbsdk/api-methods

https://cmbdn.cognex.com/v2.1.x/knowledge/cordova-plugin-for-cmbsdk/api-methods/sendcommand

https://cmbdn.cognex.com/v2.1.x/knowledge/cordova-plugin-for-cmbsdk/api-methods/setavailabilitycallback

https://cmbdn.cognex.com/v2.1.x/knowledge/cordova-plugin-for-cmbsdk/api-methods/setactivestartscanningcallback

https://cmbdn.cognex.com/v2.1.x/knowledge/cordova-plugin-for-cmbsdk/api-methods/loadscanner

https://sapui5.hana.ondemand.com/#/api/sap.ui.core.EventBus/overview


<footer> <Toolbarid="__toolbar1"width="100%"> <content> <Buttonid="btnScan"press="btnScanPress"text="Scan"width="100%"/> </content> </Toolbar> </footer> </Page> </pages> </App> </Shell></mvc:View>

YoucandesignviewwithCodeEditororwithLayoutEditor.

AfterthatopenScanView.cont roller.jsandaddthiscode

sap.ui.define([ "sap/ui/core/mvc/Controller"],function(Controller){ "usestrict"; varoEventBus=sap.ui.getCore().getEventBus(); varoModel=newsap.ui.model.json.JSONModel(); oModel.setData({ Devices:[{


key:"0", text:"MXDevice" },{ key:"1", text:"MobileCamera" }] });

returnController.extend("MyFirstFioriApp.MyFirstFioriApp.controller.ScanView",{ onInit:function(){ this.getView().setModel(oModel); }, onAfterRendering:function(){ window.scannerActive=false; switch(window.readerConnected){ casecmbScanner.CONSTANTS.CONNECTION_STATE_CONNECTED: this.getView().byId("lblStatus").setText("CONNECTED"); break; casecmbScanner.CONSTANTS.CONNECTION_STATE_DISCONNECTED: this.getView().byId("lblStatus").setText("DISCONNECTED"); break; casecmbScanner.CONSTANTS.CONNECTION_STATE_CONNECTING: this.getView().byId("lblStatus").setText("CONNECTING"); break; casecmbScanner.CONSTANTS.CONNECTION_STATE_DISCONNECTING: this.getView().byId("lblStatus").setText("DISCONNECTING"); break default: this.getView().byId("lblStatus").setText("UNKNOWN"); break; } oEventBus.subscribe("ScanView","SetConnectionStatus",this.setConnectionStatus,this); cmbScanner.setResultCallback((result)=>{ if(result&&result.readResults&&result.readResults.length>0){

result.readResults.forEach((item,index)=>{

if(item.goodRead==true){ //Performsomeactiononbarcoderead //example:varverticalLayoutContainer=newsap.ui.layout.VerticalLayout(null,{ width:"100%" }).addStyleClass("sapUiSmallMarginTop"); verticalLayoutContainer.addContent(newsap.m.Label({ text:item.symbologyString+":", textAlign:"Begin", design:"Bold" }).addStyleClass("sapUiSmallMarginBegin")); verticalLayoutContainer.addContent(newsap.m.Text({ text:item.readString, textAlign:"Begin" }).addStyleClass("sapUiSmallMarginBegin")); this.getView().byId("flexBoxContainer").addItem(verticalLayoutContainer);

}else{


//Performsomeactionwhennobarcodeisreadorjustleaveitempty}});} }); }, btnScanPress:function(){ if(window.readerConnected===cmbScanner.CONSTANTS.CONNECTION_STATE_CONNECTED){ if(window.scannerActive===true){ cmbScanner.stopScanning(); }else{ cmbScanner.startScanning(); } } }, setConnectionStatus:function(sChanel,sEvent,oData){ this.getView().byId("lblStatus").setText(oData.statusText); }, activeDeviceChanged:function(){

cmbScanner.disconnect((result)=>{ oEventBus.publish("Component","LoadScanner",{ selectedDevice:parseInt(this.getView().byId("selectActiveDevice").getSelectedKey()) }); }); }, onExit:function(){ oEventBus.unsubscribe("ScanView","SetConnectionStatus",this.setConnectionStatus,this); if(window.readerConnected===cmbScanner.CONSTANTS.CONNECTION_STATE_CONNECTED){ if(window.scannerActive===true){ cmbScanner.stopScanning(); } } cmbScanner.setResultCallback((result)=>{ returnfalse; }); } });});

InthisviewwehaveaScanbuttontostartScanning()/stopScanning()andcmbScanner.setResultCallbacktohandlesuccessfulscanresults.

BuildFioriMobileApplicat ion

InthissectionwewillexplainhowtobuildFioriMobileApplication(generate.ipaand.apk

https://cmbdn.cognex.com/v2.1.x/knowledge/cordova-plugin-for-cmbsdk/api-methods/startscanning-stopscanning

https://cmbdn.cognex.com/v2.1.x/knowledge/cordova-plugin-for-cmbsdk/api-methods/setresultcallback


files).

1.UsingHAT (HybridApplicationToolkit)

FirstweneedtoenableHAT extensioninSAPWebIDEWorkspase.OpenTools->Preferences:

NavigatetoExtensionssectionandsearchforHATextension:

BydefaultHATextensionisdisabled.EnableHATextensionandclickSave.AfterenablingwewillneedtorefreshSAPWebIDE.


AfterenablingHATgoagaininTools->Preferences.IfyouhavebothFioriMobileandMobileServicesenabledyouwillhaveoptionstoselectonethatwillbeusedasCloudBuildService.PleasechooseMobileServicesandclickSave:


Ifyoudon'tseetheseradiobuttonsyoudon'tneedtodoanything.MobileServicewillbeenabledbydefault.NowrightclickonprojectrootandyouwillseeMobilesection.ClickEnableasHybridMobileProject


Youcanseethatsomenewfilesareaddedinourprojectthatallowustobuildthisprojectasmobileapplication.Beforebuildweneedtoaddourcmbsdk-cordovaplugin.ClickonSelectCordovaPlugins,findcmbsdk-cordovapluginfrompublicpluginsandaddinthisproject.Don'tforgettoclickSavewhenyouaddplugin.



Wearereadytobuildourmobileapplicationandgenerate.ipaand.apkfiles.ClickonBuildPackagedAppfromMobilemenu.

Setyourapplicationdetails


ChooseplatformorbothiOSandAndroidplatforms,selectsigningprofiles(orcreateoneifyoudon'thave)andsetsomecommonoptions


Startbuildingprocess


Whenbuildingprocessisfinishedpopupfromwhereyoucandownload.ipaand.apkfileswillbeshown


2.UsingFioriMobileService

BeforewestarttobuildourFioriMobileApplicationwithFioriMobileServiceweneedtodeployourprojectonSAPHANACloudPlatform.

RightclickonprojectfolderthenselectDeployandchooseDeploytoSAPCloudPlatform

https://cloudplatform.sap.com/index.html


SetapplicationdetailsandclickDeploy


Afterasuccessfuldeploy,thenextstepistoRegistertoSAPFiorilaunchpadthatwe'vecreatedintheprevioussection.

Chooseaccountandsetapplicationname


SetType(Staticbydefault),setTitle,andSubtitle

ChooseSitethatwecreatebefore,catalog,andgroup(samplecatalogandgroupiscreatedbydefault)


ClickfinishonConfirmationtabandifeverythingisfinethepopupbelowwillbeshown.ClickOKtoclosethispopup.WiththesestepswedeployourprojectonHCPandnowwecancontinuetobuildourFioriMobileApplication

GotoServicestabagain,openFioriMobileservice,andclickonGotoAdminConsole


OpenManagePluginssectionanduploadcmbsdk-cordovapluginascustomplugin.Youcandownloadlatestpluginonthislink.

https://cmbdn.cognex.com/files/download_latest/cmbSDK_Cordova


Nextmanageyoursingingprofiles.OpenManageSigningProfilessectionandcreatenewonesifyoudon'thavealready


NowopenManageAppssectionandcreateNewApplication

Selectfirstoption


SelectyourFioriCloudEditionasFioriServer


Selectapplicationthatwecreatedbefore(withdoubleclickordrag&drop)


Setyouapplicationnameandsigningprofiles.Atthebottomofpageyouhavequestion"Areyoureadytobuildtheapplication?".Select"No,Iwouldliketocustomizemyapplication".


Windowwherewecancontinuewithappcustomizationwillbeopened.Fromherewewilladdpluginthatweuploadedbeforeanddisablepasscodescreen.Youcansetsomeothersparametersperyourneeds.Alsoimportantthinghereistosaveeverychangethatwillbemade.




Wearereadytobuildourmobileapplicationandgenerate.ipaand.apkfiles.NavigatetoPlatformsandclickBuildAllbuttonifyouwanttobuildbothiOSandAndroidplatformtogether,oryoucanbuildonebyonefromActionsgridcolumn.


Buildpopupwillbeshown.ClickBuildbuttonandwaitwhilebuildingprocessfinish.


Whenbuildingprocessisfinishedyoucandownloadbinary(.ipaor.apk)fileandinstallapplicationonyourmobiledevice


LicensingtheSDK

IfyouplantousethecmbSDKtodomobilescanningwithasmartphoneoratablet(withouttheMXmobileterminal),theSDKrequirestheinstallationofalicensekey.Withoutalicensekey,theSDKwillstilloperate,althoughscannedresultswillbeblurred(theSDKwillrandomlyreplacecharactersinthescanresultwithanasteriskcharacter).

ContactyourCognexSalesRepresentativeforinformationonhowtoobtainalicensekeyincludingtriallicenseswhichcanbeusedfor30daystoevaluatetheSDK.

Afterobtainingyourlicensekeyopeni18n.propertiesfile inyourprojectonSAPWEBIDEservice,andsetyourobtainedkeys.


ThengobacktotheComponent.jsfile andcheckthiscode:

...

varsdkKEY="";if(Device.os.android)sdkKEY=this.getModel("i18n").getProperty("MX_MOBILE_LICENSE_ANDROID");elsesdkKEY=this.getModel("i18n").getProperty("MX_MOBILE_LICENSE_iOS");

cmbScanner.registerSDK(sdkKEY);

...

Youcanseethatyoureadthiskeyfromi18n.propertiesandcallcmbScanner.registerSDKmethodtoregisterSDKwithyourlicensekey.