标题栏设备编号显示配置:方案、实施与验证汇总

日期:2026-07-15

需求与结论

标题栏设备编号已改为由设置页本地开关控制。默认开启;关闭只影响 UI,不影响业务链路。

实施方案

项目实现
配置键SETTING_TITLE_TERMINAL_NUMBER_VISIBLE
存储MmkvUtils
默认值true
控制入口设置页“标题栏显示设备编号”开关
即时性回调写入 MMKV 后立即刷新标题栏
跨页面BaseActivity 的既有 onStart 刷新时读取最新配置

展示规则

  1. 关闭:隐藏。
  2. 开启但编号为空:隐藏。
  3. 开启且编号存在:显示“设备编号:{编号}”。

已修改内容

配对、心跳、上传、版本检查、MQTT 和日志标签不受影响。

实施计划与设计依据

本汇总文档是本次设计与实施计划的唯一归档,保存在提示词工程目录,不在 Android 源码项目中新增文档目录。除物理设备上的交互检查外,其余实施步骤均已完成。

验证证据

JAVA_HOME="/Users/liang/Library/Java/JavaVirtualMachines/corretto-1.8.0_482/Contents/Home" ./gradlew :app:assembleDebug --console=plain

BUILD SUCCESSFUL in 26s。既有 SDK schema/弃用警告未造成编译失败。

真机验收清单

  1. 确认默认打开且显示编号。
  2. 关闭后当前设置页立即隐藏。
  3. 跨页面保持隐藏。
  4. 重新打开后立即恢复。
  5. 清除配对后保持隐藏。