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

46 lines
1.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 版本信息 - 工程实施方案 (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() } }`。