=============================
UnitechSDK for Android Apps
        READ ME
============================= 

UnitechSDK for Android Apps is an Java-based SDK for developing Android applications that interacts with Unitech-specific features on Unitech Android-based mobile devices. 

@License Agreement:
Please read the "LICENSE" file ("The License Agreement") carefully before using the UnitechSDK. 
The UnitechSDK software license shall be granted to you when you have fully accepted all clauses, terms, conditions and obligations in The License Agreement.
Failure to accept The License Agreement, please stop using the UnitechSDK software and delete all copies of the software from your all your computer devices.

@Non-MainThread Usage:
To start using the SDK, please start a project in your Android Studio, import the UnitechSDK JAR library into your project, and then reference the API functions exposed by the library.
The code that calls the SDK functions must not be resident on the main thread in your Android app. 
Please refer to the UnitechSDKTester sample app source code for an example how to implement your app with SDK function calls outside of the Main thread.

@Dependency Apps:
Before developing or deploying your apps onto the supported device models, please make sure that the dependency apps with the minimum version required are installed. 
This SDK requires correct versions of AppCtrlService and DMService to function correctly. (Please refer to below discussions to see the minimum versions required).
Please implement a prerequisite checking mechanism in your own app that will check for and install the dependency apps if the target device does not have the correct apps/versions installed.

@Javadoc
API documentation is provided as javadoc. 
The UnitechSDKTester application also comes with its source code project, allowing you to study how apps can reference the API functions from the JAR library.


----------------------------------------
UnitechSDK for Android Apps V1.1.19 
          Requirements
----------------------------------------
This version of the UnitechSDK supports the following device models:
- PA760 Android 9	(MinimumOS:	MR6)
- PA760 Android 10	(MinimumOS: MR1)
- EA630 Android 9	(MinimumOS: V.173)
- EA630 Android 10	(MinimumOS: V.092)
- WD200 Android 10	(MinimumOS: V.CR3)
- HT730 Android 10  (MinimumOS: V1.0.13)

Before developing and deploying your apps onto the devices, these dependency apps are required to be installed.
The minimum version required for each dependecy apps are listed below:
- AppCtrlService V1.0.7 or later
- DMService V1.1.18 or later

(Note: You can find the APK files of the dependency apps under the "dependecy" directory)

----------------------------------------
Directory Structure
----------------------------------------
This SDK Package contains the following directory structure
+--UnitechSDK_V1.1.19									[The UnitechSDK]
|  |
|  +--dependencies										[Dependency APKs for supported models]
|  |  |
|  |  +--AppCtrlService_1.0.7_SystemUID_EA630.apk		[AppCtrlService APK required for EA630A9 & EA630A10]
|  |  |
|  |  +--AppCtrlService_1.0.7_SystemUID_PA760.apk		[AppCtrlService APK required for PA760A9 & PA760A10]
|  |  |
|  |  +--AppCtrlService_1.0.7_SystemUID_WD200.apk		[AppCtrlService APK required for WD200A10]
|  |  |
|  |  +--AppCtrlService_1.0.7_SystemUID_HT730.apk		[AppCtrlService APK required for HT730A10]
|  |  |
|  |  +--DMService_1.1.18_EA630.apk						[DMService APK required for EA630A9 & EA630A10]
|  |  |
|  |  +--DMService_1.1.18_PA760.apk						[DMService APK required for PA760A9 & PA760A10]
|  |  |
|  |  +--DMService_1.1.18_WD200.apk						[DMService APK required for WD200A10]
|  |  |
|  |  +--DMService_1.1.18_HT730.apk						[DMService APK required for HT730A10]
|  |  
|  +--javadoc											[javadoc for the UnitechSDK]
|  |  
|  +--UnitechSDK_1.1.19.jar								[The UnitechSDK JAR library file]
|  |  
+--UnitechSDKTester_V1.1.17								[The SDK Tester app with source code]
|  |  
|  +--UnitechSDK_Tester_SourceCode_v1.1.17.zip			[Tester App Source Code]
|  |  
|  +--UnitechSDK_Tester_v1.1.17.apk						[Tester App Binary APK file]


----------------------------------------
Known Issues
----------------------------------------
#UNITECHSDK-32: [UnitechSDK][1.1.19] Enter empty value as parameter causes unexpected behaviors
Affected functions:
- AppManagementCtrl > DeactivateApp
- AppManagementCtrl > RunSysCmd 
- AppManagementCtrl > ClearDefaultApps_with_PackageNameArray
- DebuggingCtrl > saveLogcatFile
- StageGoCtrl > setReportMaxNum
- StageGoCtrl > enabledBootupScript
- RFID2KeyCtrl > setMode
- USUCtrl > SetScannerSymbologyConfiguration


----------------------------------------
Disclaimer
----------------------------------------
UnitechSDK is Copyright 2020-2021 by Unitech Electronics Co. Ltd.
All Rights Reserved.

Please read the LICENSE file and accept the license agreement before use.