2026-08-26 一卡通代码包迁移

变更结论

已将 OnecardDemo 的 customer、reader、server、log 四个包迁移到 ZhctTrayBindingMachine 的 com.zhct.traybinding.onecard 命名空间，并完成包声明、包间导入和 Demo 全局常量依赖处理。目标项目 Java 编译通过。

项目文件变更

• 新增 com.zhct.traybinding.onecard.customer：9 个 Java 文件，包含人员解析、分段同步、SQLite 人员仓库和同步日志适配。
• 新增 com.zhct.traybinding.onecard.reader：20 个 Java 文件，包含 USB HID 传输、新开普协议、寻卡、读卡、本地消费、错误模型和 F700 USB 控制器恢复逻辑。
• 新增 com.zhct.traybinding.onecard.server：11 个 Java 文件，包含 WebService 客户端、SOAP 请求与响应、消费记录上传模型、人员格式化和服务器稳定性测试。
• 新增 com.zhct.traybinding.onecard.log：2 个 Java 文件，包含毫秒级本地文件日志、日志轮转、保留期清理、读取和会话标识。
• 所有 com.cpt.onecarddemo.* 包声明及导入已替换为 com.zhct.traybinding.onecard.*。
• CustomerSyncService 不再依赖 Demo 根目录的 Constants，改为包内公开常量 DEFAULT_BATCH_SIZE = 1000，避免把 Demo 的服务器地址和其他业务配置带入目标项目。

兼容性说明

• 目标项目现有 INTERNET 权限和明文网络安全配置可支持当前 WebService 客户端。
• 读卡器代码使用 Android USB Host API；本次只迁移代码包，未修改目标项目已有页面、Manifest 和 USB 权限申请流程。
• F700 USB 控制器恢复代码依赖设备 root 环境、固定 USB 拓扑和 xhci-hcd.1.auto，仅适用于原已验证硬件环境；在其他设备上属于待硬件验证能力。
• ReaderLog.initialize(Context) 仍需由使用方在开始读卡或同步前调用，否则日志接口保持安全空操作。

验证结论

• 文件数量：共 42 个 Java 文件，其中 customer 9 个、reader 20 个、server 11 个、log 2 个。
• 旧包名扫描：目标目录不存在 com.cpt.onecarddemo 残留引用。
• 构建栈：Gradle 5.1.1、Android Gradle Plugin 3.4.1，需要 JDK 8。
• 编译命令：JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash gradlew --no-daemon :app:compileDebugJavaWithJavac。
• 编译结果：BUILD SUCCESSFUL in 21s，42 个任务中 10 个执行、32 个为最新状态。
• 编译只出现目标项目原有的过时 API、未检查操作及旧工具链版本警告，没有新增导包或类型错误。

范围说明

• 本次没有把 OnecardDemo 的 Activity、布局、USB 广播接收器和 USB 权限申请页面逻辑迁入目标项目。
• 本次没有修改 ZhctTrayBindingMachine 已有页面、资源、Manifest 或业务网络逻辑。
• 未执行 Git 暂存、提交、推送、分支切换或其他 Git 写操作。