# 版本信息 - 工程实施方案 (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() } }`。