⚡ SDK 开发
手持机 Android SDK 集成指南
面向开发者的快速入门手册，包含环境搭建、依赖导入、扫描回调接口实现以及 Android 11+ 系统的权限适配方案。3 步完成集成，一行代码完成初始化。
Android 8.0+
兼容系统版本
3步
快速集成
条码·RFID·NFC
统一调用接口
OVERVIEW
统一硬件抽象层，一行代码完成初始化
摩数科技 Android SDK 提供条码扫描、RFID 读写、NFC 近场通信等核心功能的统一调用接口
AutoIDSdk.init(context) — 一行代码完成初始化，即可调用全部硬件能力。
STEP 01 · 环境
开发环境要求与仓库配置
确保你的开发环境满足以下条件
Arctic Fox+
Android Studio
JDK 11+
编译环境
SDK 26+
Android API Level
// build.gradle — 添加 Maven 仓库
repositories {
maven { url 'https://maven.autoid-tech.com/releases' }
}
repositories {
maven { url 'https://maven.autoid-tech.com/releases' }
}
STEP 02 · 集成
三步完成 SDK 接入
添加依赖 → 一行初始化 → 开始调用
1 添加 Gradle 依赖
implementation 'com.autoid:sdk:2.4.1'
2 初始化 SDK
AutoIDSdk.init(context) {
Log.d("AutoID", "SDK 初始化完成")
}
Log.d("AutoID", "SDK 初始化完成")
}
建议在 Application.onCreate() 中调用，确保全局可用。
3 调用硬件能力
初始化完成后，直接创建对应能力的实例：
val scanner = BarcodeScanner(context)
scanner.setOnScanListener { result ->
Log.d("SCAN", "扫描结果: ${result.data}")
}
scanner.startScan()
scanner.setOnScanListener { result ->
Log.d("SCAN", "扫描结果: ${result.data}")
}
scanner.startScan()
STEP 03 · 适配
Android 11+ 权限适配指南
Android 11 对后台位置权限做了更严格的限制
在 AndroidManifest.xml 中声明所需权限，并在运行时动态请求：
// Android 11+ 悬浮窗权限请求
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
if (!Settings.canDrawOverlays(this)) {
val intent = Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION)
startActivity(intent)
}
}
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
if (!Settings.canDrawOverlays(this)) {
val intent = Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION)
startActivity(intent)
}
}
SDK 在初始化时会自动检测缺失权限并给出日志提示，开发者只需按提示补充声明即可。
RECAP
← 返回技术支持列表 集成全流程回顾
从环境搭建到权限适配，三个关键阶段
环境
仓库 + 依赖
添加 Maven 仓库与 gradle 依赖
集成
初始化 + 调用
一行 init，即可调用全部硬件能力
适配
Android 11+ 权限
动态请求悬浮窗/后台位置权限