Files
zhy200308 f895e45236 feat(ui): 交付第10个子页面【版本信息】UI重构与设计规范
- 页面交付清单 (已累计完成 10/11 个页面):
  1. 语言设置 (已完工)
  2. 版型切换 (已完工)
  3. 心率区间设置 (已完工)
  4. 自动连接配置 (已完工)
  5. 手环配置 (已完工)
  6. DFU固件升级 (已完工)
  7. 用户管理 (已完工)
  8. 设备数据库管理 (已完工)
  9. 数据上传 (已完工)
  10. 版本信息 (本次交付·已完工)
- 核心重构亮点:
  1. 采纳 Master-Detail Inset Station 经典双栏比例 (360px 1fr);
  2. 左侧 360px 布局应用徽标、版本号微底胶囊与 OTA 系统更新卡片及全宽下载按钮;
  3. 右侧 1fr 清晰组织【设备信息】与【构建信息】卡片矩阵,采用调和 Debug 玫瑰红标签;
  4. 集齐 6 件套交付物 (baseline_ui.html, image.png, DESIGN_SPEC.md, implementation_plan.md, CARD 任务卡, README 更新)。
2026-08-17 18:48:17 +08:00

1.8 KiB
Raw Permalink Blame History

版本信息 - 工程实施方案 (Implementation Plan)

1. 数据模型与接口规范 (Data Model & Schema)

export interface AppVersionInfo {
  appName: string;                  // 应用名称 (如 "EAP Manage Team")
  currentVersionName: string;       // 当前版本名 (如 "1.00.0000")
  currentVersionCode: number;       // 当前版本号 (如 1000000)
  hardwareId: string;               // 硬件 ID
  deviceModel: string;              // 设备型号 (如 "TB375FC")
  androidVersion: string;           // Android 系统版本 (如 "16 (API 36)")
  buildType: 'Debug' | 'Release';   // 构建类型
  upgradePackage?: {
    hasNewVersion: boolean;         // 是否有新版本
    latestVersionName: string;      // 最新版本 (如 "1.00.0001")
    packageSizeMb: number;          // 升级包大小
    downloadUrl: string;            // 下载地址
  };
}

2. 状态机与更新流 (State Machine & Upgrade Flow)

stateDiagram-v2
    [*] --> Idle: 载入当前系统版本
    Idle --> Checking: 点击检查更新 / 自动检测
    Checking --> Latest: 当前已是最新版本
    Checking --> UpdateAvailable: 检测到新版本 (1.00.0001)
    UpdateAvailable --> Downloading: 点击【下载更新】
    Downloading --> Installing: 下载完成验签通过
    Installing --> [*]: 重启应用并完成升级

3. 原生实施映射 (Native Implementation Mapping)

  • Android (Kotlin / Jetpack Compose):
    • 读取 BuildConfig.VERSION_NAME、BuildConfig.BUILD_TYPE 与 Build.MODEL、Build.VERSION.RELEASE;
    • 硬件 ID 获取基于 Settings.Secure.getString(contentResolver, Settings.Secure.ANDROID_ID);
    • 双栏使用 Row { Box(modifier = Modifier.width(360.dp)) { VersionHeroPanel() }; Box(modifier = Modifier.weight(1f)) { DetailsPanel() } }。