diff --git a/.preview/version_info/option_1_master_detail_split.html b/.preview/version_info/option_1_master_detail_split.html new file mode 100644 index 0000000..8034e34 --- /dev/null +++ b/.preview/version_info/option_1_master_detail_split.html @@ -0,0 +1,262 @@ + + + + + +方案 1:Master-Detail Inset Station 经典双栏 (360px 1fr·推荐·家族风) + + + +
+
+
+ +

版本信息

+
+ +
+ +
+ +
+
+
+
+ +
+
EAP Manage Team
+
版本号 1.00.0000
+
+ + +
+
+ 系统更新 + OTA 就绪 +
+
+ 有新版本可用: + 1.00.0001 +
+
+
+ + +
+ +
+
+ + +
+ +
+
+ 📱 设备信息 +
+
+
+ 硬件 ID + 15EA5B1C22D14D97 +
+
+ 设备型号 + TB375FC +
+
+ Android 版本 + 16 (API 36) +
+
+
+ + +
+
+ 🛠️ 构建信息 +
+
+
+ 构建类型 + Debug +
+
+ 编译环境 + UmiLab CI/CD Pipeline +
+
+
+ + +
+
+
+ + + + diff --git a/.preview/version_info/option_2_fluid_bento_station.html b/.preview/version_info/option_2_fluid_bento_station.html new file mode 100644 index 0000000..b53c12c --- /dev/null +++ b/.preview/version_info/option_2_fluid_bento_station.html @@ -0,0 +1,93 @@ + + + + + +方案 2:Fluid Bento Station 居中磁贴工控卡片流 + + + +
+
+
+ +

版本信息

+
+ +
+ +
+
+
+ +
+

EAP Manage Team

+ 版本号 1.00.0000 +
+ +
+

设备信息

+
硬件 ID:15EA5B1C22D14D97
+
设备型号:TB375FC
+
Android 版本:16 (API 36)
+
+ +
+

构建信息

+
构建类型:Debug
+
+ +
+
+
系统更新
+
有新版本可用: 1.00.0001
+
+ +
+
+
+ + diff --git a/.preview/version_info/option_3_cyber_telemetry_dock.html b/.preview/version_info/option_3_cyber_telemetry_dock.html new file mode 100644 index 0000000..6eefc7e --- /dev/null +++ b/.preview/version_info/option_3_cyber_telemetry_dock.html @@ -0,0 +1,84 @@ + + + + + +方案 3:Cyber Precision 暗晶终端 HUD + + + +
+
+
+ +

版本信息

+
+ +
+ +
+
+
+
+ +
+ EAP Manage Team + v1.00.0000 +
+ +
+ +
+

设备与底层信息

+
硬件 ID:15EA5B1C22D14D97
+
设备型号:TB375FC
+
Android:16 (API 36)
+
构建类型:Debug
+
+
+
+ + diff --git a/.preview/version_info/option_4_nordic_slate_sheet.html b/.preview/version_info/option_4_nordic_slate_sheet.html new file mode 100644 index 0000000..8e9cf0b --- /dev/null +++ b/.preview/version_info/option_4_nordic_slate_sheet.html @@ -0,0 +1,84 @@ + + + + + +方案 4:Nordic Slate 极净工业卡片 + + + +
+
+
+ +

版本信息

+
+ +
+ +
+
+
+ +
+
+

EAP Manage Team

+ 版本号 1.00.0000 +
+
+ +
硬件 ID15EA5B1C22D14D97
+
设备型号TB375FC
+
Android 版本16 (API 36)
+
构建类型Debug
+
+
+ 系统更新 +
有新版本可用: 1.00.0001
+
+ +
+
+
+ + diff --git a/.preview/version_info/option_5_unified_card_stream.html b/.preview/version_info/option_5_unified_card_stream.html new file mode 100644 index 0000000..1e180d9 --- /dev/null +++ b/.preview/version_info/option_5_unified_card_stream.html @@ -0,0 +1,89 @@ + + + + + +方案 5:Unified Card Stream 垂直卡片流 + + + +
+
+
+ +

版本信息

+
+ +
+ +
+
+
+
+ +
+
+ EAP Manage Team +
版本号 1.00.0000
+
+
+ +
+ +
+

设备信息

+
硬件 ID:15EA5B1C22D14D97
+
设备型号:TB375FC
+
Android 版本:16 (API 36)
+
+ +
+

构建信息

+
构建类型:Debug
+
+
+
+ + diff --git a/.preview/version_info/preview_bakeoff.html b/.preview/version_info/preview_bakeoff.html new file mode 100644 index 0000000..a2617c7 --- /dev/null +++ b/.preview/version_info/preview_bakeoff.html @@ -0,0 +1,102 @@ + + + + + +版本信息 - 5套重构方案决策中心 + + + +
+
+ 📱 版本信息 5套候选方案决策中心 + v1.00.0000 · Android 16 +
+
+ + + + + +
+
+ +
+ +
+ + + + diff --git a/.preview/version_info/shot_opt1.png b/.preview/version_info/shot_opt1.png new file mode 100644 index 0000000..4db299c Binary files /dev/null and b/.preview/version_info/shot_opt1.png differ diff --git a/.preview/version_info/shot_opt2.png b/.preview/version_info/shot_opt2.png new file mode 100644 index 0000000..3809e7d Binary files /dev/null and b/.preview/version_info/shot_opt2.png differ diff --git a/.preview/version_info/shot_opt3.png b/.preview/version_info/shot_opt3.png new file mode 100644 index 0000000..b68c81a Binary files /dev/null and b/.preview/version_info/shot_opt3.png differ diff --git a/.preview/version_info/shot_opt4.png b/.preview/version_info/shot_opt4.png new file mode 100644 index 0000000..6b413ee Binary files /dev/null and b/.preview/version_info/shot_opt4.png differ diff --git a/.preview/version_info/shot_opt5.png b/.preview/version_info/shot_opt5.png new file mode 100644 index 0000000..a16da95 Binary files /dev/null and b/.preview/version_info/shot_opt5.png differ diff --git a/README.md b/README.md index 169f2bf..970c38b 100644 --- a/README.md +++ b/README.md @@ -37,7 +37,7 @@ | 7 | `用户管理/` | `Screenshot_20260812_143424.png` | ✅ | **已完工**(6 件齐) | | 8 | `设备数据库管理/` | `Screenshot_20260812_143432.png` | ✅ | **已完工**(6 件齐) | | 9 | `数据上传/` | `Screenshot_20260812_143450.png` | ✅ | **已完工**(6 件齐) | -| 10 | `版本信息/` | `Screenshot_20260812_143456.png` | ❌ | 待办 · 有旧基准¹ | +| 10 | `版本信息/` | `Screenshot_20260812_143456.png` | ✅ | **已完工**(6 件齐) | | 11 | `Logo授权管理/` | `Screenshot_20260812_143502.png` | ❌ | 待办 · 有旧基准¹ | > ¹ **旧基准复用**:这 3 页(外加已完工的语言设置、版型切换)曾在 `系统设置界面-20260816/` 产出过 `baseline_ui.html` / `DESIGN_SPEC.md` / `implementation_plan.md`。接手时**必须先读旧物料再动手**,不要从零重写,避免与已交付的 Token 基准打架。 diff --git a/设置页面UI优化/版本信息/CARD-20260817-UITask-版本信息.md b/设置页面UI优化/版本信息/CARD-20260817-UITask-版本信息.md new file mode 100644 index 0000000..ea3fced --- /dev/null +++ b/设置页面UI优化/版本信息/CARD-20260817-UITask-版本信息.md @@ -0,0 +1,29 @@ +# JIRA 任务卡:CARD-20260817-UITask-版本信息 + +- **任务 ID**: `CARD-20260817-UITask-版本信息` +- **模块名称**: 设置 / 版本信息 +- **设计风格**: 方案 1 · Master-Detail Inset Station 经典双栏 (360px 1fr) +- **状态**: `READY_FOR_RELEASE` +- **创建时间**: 2026-08-17 + +--- + +## 1. 业务目标与需求 + +1. **统一色彩规范**:严格对齐项目主色调 `#2563EB`(Royal Blue)体系,版本号胶囊采用浅蓝微底与科技蓝边框。 +2. **黄金栅格比例**:采用 `360px : 1fr` 经典双栏比例,左侧为应用标头与 OTA 升级控制中心,右侧为设备与底层系统参数矩阵。 +3. **视觉层次优化**: + - 顶部应用徽标重塑为高质感圆角几何渐变底座; + - 构建类型 `Debug` 采用调和温和玫瑰红胶囊标签,避免刺眼红色; + - 底部贯穿式全宽【下载更新】按钮集成高质感发光阴影; +4. **版权信息呈现**:右侧底部优雅居中展示 `© 2026 UmiLab. All rights reserved.`。 + +--- + +## 2. 验收清单 (Acceptance Criteria) + +- [x] AppBar 标题为 `← 版本信息`,带标准返回与更多功能操作。 +- [x] 左侧 360px 包含应用 Logo、EAP Manage Team、版本号 1.00.0000 胶囊、系统更新卡片与贯穿式【下载更新】按钮。 +- [x] 右侧 1fr 包含【设备信息】(硬件 ID、设备型号、Android 版本)与【构建信息】(构建类型 Debug、编译环境)。 +- [x] 底部居中包含官方版权声明。 +- [x] 无头渲染输出 1200x800 高清效果图 `image.png`。 diff --git a/设置页面UI优化/版本信息/DESIGN_SPEC.md b/设置页面UI优化/版本信息/DESIGN_SPEC.md new file mode 100644 index 0000000..6d40c12 --- /dev/null +++ b/设置页面UI优化/版本信息/DESIGN_SPEC.md @@ -0,0 +1,47 @@ +# 版本信息 - 工业级 UI 重构设计规范 (Design Spec) + +## 1. 架构与定位 (Architecture & Positioning) + +本模块展示当前应用程序版本、OTA 固件升级包就绪状态、底层硬件 ID、设备硬件型号、Android 系统 API 级别以及编译构建类型(Debug / Release),同时承载版本一键升级下载与版权声明信息。 + +--- + +## 2. 设计规范与色彩系统 (Design Tokens & Color Palette) + +严格对齐项目主色调 `#2563EB` 与调和语义色规范: + +| Token 变量名 | 色值 / 规范 | 应用场景 | +| :--- | :--- | :--- | +| `--color-primary` | `#2563EB` (Royal Blue) | 主品牌色、版本号高亮、升级主按钮 | +| `--color-primary-dark` | `#1D4ED8` | 主按钮悬停与渐变深色端 | +| `--color-primary-light` | `#EFF6FF` | 版本号胶囊浅底、OTA 更新卡片浅底 | +| `--color-primary-border` | `#DBEAFE` | 版本号胶囊边框、更新卡片边框 | +| `--color-primary-gradient` | `linear-gradient(135deg, #2563EB 0%, #1D4ED8 100%)` | 下载更新贯穿式按钮渐变背景 | +| `--color-danger` | `#E11D48` (Rose) | Debug 构建类型警告色 | +| `--color-danger-bg` | `#FFF1F2` | Debug 标签浅底 | +| `--color-danger-border` | `#FFE4E6` | Debug 标签浅边框 | + +--- + +## 3. 布局与比例规范 (Layout & Ratio) + +采用与系统设置全局家族化对齐的 **360px : 1fr** 经典双栏比例: +- **左侧 360px 应用标头与 OTA 升级控制中心**: + - 应用 Logo 徽标与 `EAP Manage Team` 名称; + - `版本号 1.00.0000` 调和科技蓝微底胶囊; + - `系统更新` OTA 卡片(提示 `有新版本可用: 1.00.0001`); + - 底部贯穿式全宽 `下载更新 (1.00.0001)` 渐变主按钮。 +- **右侧 1fr 设备与底层参数矩阵**: + - `📱 设备信息` 卡片:硬件 ID、设备型号 (`TB375FC`)、Android 版本 (`16 (API 36)`); + - `🛠️ 构建信息` 卡片:构建类型 (`Debug` 调和红胶囊)、编译环境; + - 底部居中版权信息 `© 2026 UmiLab. All rights reserved.`。 + +--- + +## 4. 交付文件清单 (Deliverables) + +1. `baseline_ui.html`:生产级无头渲染 HTML 源代码。 +2. `image.png`:1200x800 高清定稿预览效果截图。 +3. `DESIGN_SPEC.md`:本设计规范。 +4. `implementation_plan.md`:原生与前端工程实施方案。 +5. `CARD-20260817-UITask-版本信息.md`:JIRA 重构研发任务卡。 diff --git a/设置页面UI优化/版本信息/baseline_ui.html b/设置页面UI优化/版本信息/baseline_ui.html new file mode 100644 index 0000000..533d29e --- /dev/null +++ b/设置页面UI优化/版本信息/baseline_ui.html @@ -0,0 +1,262 @@ + + + + + +版本信息 - Master-Detail Inset Station (360px 1fr) + + + +
+
+
+ +

版本信息

+
+ +
+ +
+ +
+
+
+
+ +
+
EAP Manage Team
+
版本号 1.00.0000
+
+ + +
+
+ 系统更新 + OTA 就绪 +
+
+ 有新版本可用: + 1.00.0001 +
+
+
+ + +
+ +
+
+ + +
+ +
+
+ 📱 设备信息 +
+
+
+ 硬件 ID + 15EA5B1C22D14D97 +
+
+ 设备型号 + TB375FC +
+
+ Android 版本 + 16 (API 36) +
+
+
+ + +
+
+ 🛠️ 构建信息 +
+
+
+ 构建类型 + Debug +
+
+ 编译环境 + UmiLab CI/CD Pipeline +
+
+
+ + +
+
+
+ + + + diff --git a/设置页面UI优化/版本信息/image.png b/设置页面UI优化/版本信息/image.png new file mode 100644 index 0000000..4db299c Binary files /dev/null and b/设置页面UI优化/版本信息/image.png differ diff --git a/设置页面UI优化/版本信息/implementation_plan.md b/设置页面UI优化/版本信息/implementation_plan.md new file mode 100644 index 0000000..1ba0cb4 --- /dev/null +++ b/设置页面UI优化/版本信息/implementation_plan.md @@ -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() } }`。