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 更新)。
This commit is contained in:
zhy200308
2026-08-17 18:48:17 +08:00
parent ed877e14ef
commit f895e45236
17 changed files with 1098 additions and 1 deletions
@@ -0,0 +1,45 @@
# 版本信息 - 工程实施方案 (Implementation Plan)
## 1. 数据模型与接口规范 (Data Model & Schema)
```typescript
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)
```mermaid
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() } }`。