开发指南与基础

本页介绍在 Urovo 设备上开发时通用的环境、权限、调试与实践建议。各硬件能力（打印、扫码、RFID 等）的接口细节，请参阅对应产品文档。

开发环境

建议使用以下环境，以减少兼容性问题：

项目	建议
IDE	Android Studio 最新稳定版
JDK	与 Android Gradle Plugin 要求一致（常见为 JDK 17）
构建工具	使用工程锁定的 Android Gradle Plugin 与 Gradle 版本
真机	使用目标机型验证；模拟器通常无法覆盖打印机、扫头、RFID 等硬件能力

在切换 SDK 大版本时，同时核对：

minSdk / targetSdk 是否满足文档要求
是否需要额外系统权限或签名能力
Demo 能否在同一台设备上正常运行

权限与系统配置

不同 SDK 依赖不同权限。接入前请按产品文档逐项核对，常见类别包括：

蓝牙：外接打印机、Sled RFID 等场景通常需要蓝牙与位置相关权限（视系统版本而定）
存储：固件升级、日志导出、字体或资源加载可能需要存储或媒体权限
网络：部分升级、远程配置或日志上报能力需要网络权限
系统级能力：部分设备 API 需要系统签名或厂商权限，普通三方应用无法直接调用

实践建议：

在 AndroidManifest.xml 中声明文档要求的权限。
对运行时权限，在调用相关 API 之前完成申请与结果处理。
权限被拒绝时给出明确提示，并避免继续调用依赖该权限的接口。

日志与调试

联调时优先保留可复现信息：

打开 SDK 日志（若产品提供开关），保留时间戳、错误码与关键状态。
使用 adb logcat 过滤应用包名与 SDK 相关 TAG。
记录环境信息：机型、系统版本、SDK 版本、复现步骤。
先跑官方 Demo：若 Demo 正常而业务工程异常，优先对比初始化顺序、权限与依赖版本。

调试连接：

USB 调试：确认已授权该电脑的调试请求
无线调试：确认设备与电脑在同一网络，且端口可达

错误处理

调用 SDK 时，按文档处理返回值与回调：

区分可重试错误（短暂断连、忙状态）与配置错误（权限不足、参数非法、机型不支持）
向用户展示可读提示，同时把原始错误码写入日志
不要忽略初始化失败；初始化失败时不要继续调用业务接口

版本与兼容

发版前确认：

检查项	说明
SDK 版本	与文档、Demo 使用同一正式版本
固件 / 服务版本	打印、扫码、RFID 等能力可能依赖设备侧服务或固件
混淆规则	Release 构建按文档保留必要类与接口
回归路径	至少覆盖初始化、主流程成功与一种失败场景

常见问题排查

按以下顺序排查，通常能更快定位问题：

Demo 在同一设备上是否可用？
SDK 版本、设备型号、系统版本是否在支持列表内？
权限是否已授予？初始化是否成功？
日志中的错误码是否能在产品 FAQ 中找到对应说明？
是否存在多个 SDK / 重复依赖导致类冲突？

仍无法解决时，向技术支持反馈时请附上：机型、系统版本、SDK 版本、复现步骤与关键日志。

后续步骤

选择与你的业务对应的专题继续阅读：