消费页读卡器状态与用户行为提示变更记录

日期:2026-08-29
目标项目:/Users/liang/AndroidStudioProjects/ZhctTrayBindingMachine

变更目标

消费页将读卡器连接状态与用户卡片操作提示拆分为两行。连接状态始终可见,并按“正常过渡黄色、已连接绿色、明确异常红色”展示;用户行为提示只在卡片结算阶段出现。

修改文件

文件修改内容
activity_consumption.xml连接状态行取消 GONE,新增默认隐藏的用户行为提示行
strings.xml新增六种卡片操作提示
dimens.xml新增提示行顶部间距资源
ConsumptionActivity.java实现三色连接状态和统一页面状态驱动的行为提示

连接状态规则

阶段颜色文案行为
初始化、申请 USB 权限、正在连接黄色始终显示当前过渡状态
已连接并寻卡绿色显示“读卡器已连接,正在寻卡…”
未找到、权限拒绝、断开、异常红色保留现有具体错误文案

三种颜色均复用现有资源,没有新增硬编码颜色。

用户行为提示规则

页面状态提示
餐盘、订单阶段隐藏
等待放卡请放置卡片
卡区需清空请拿走卡片
正在读卡或扣款请勿移动卡片
读取/结算完成读卡成功,请拿走卡片
交易失败读卡失败,请拿走卡片
结果不确定读卡结果待确认,请勿重复放卡

每次渲染先隐藏上一阶段内容,防止非卡片页面残留旧提示。

验证结果

环境说明

旧版 Gradle/AGP 验证临时使用本机 JDK 8;没有修改项目 JDK 配置或脚本权限。

Git 边界

未执行暂存、提交、推送、建分支、切换分支或其他 Git 写操作。