feat(ui): 完成【版型切换】与【心率区间设置】页面 UI 重构及标准物料交付

This commit is contained in:
zhy200308
2026-08-17 15:43:15 +08:00
parent 0c7e12f89a
commit fa304292b4
40 changed files with 10137 additions and 0 deletions
@@ -0,0 +1,81 @@
# 选择版型页面 — 原生落地图纸 implementation_plan
- **模块**:系统设置 — 版型切换 (`EditionSelectionActivity`)
- **依据**:同目录 `baseline_ui.html` + `DESIGN_SPEC.md`
- **原始出厂截图**:`./Screenshot_20260812_143347.png`
- **执行角色**:`@coder` (Android 工程师)
---
## 1. CSS → Android Token 映射字典
### 1.1 颜色语义映射
| HTML CSS 变量 | 取值 | Android 语义 Token / 资源 ID | 状态 / 说明 |
| :--- | :--- | :--- | :--- |
| `--color-primary` | `#3949AB` | `?attr/colorPrimary` (`@color/color_primary`) | ✅ 已存在,选中卡片描边与指示器 |
| `--color-on-primary` | `#FFFFFF` | `?attr/colorOnPrimary` | ✅ 已存在 |
| `--color-primary-container` | `#EEF2FF` | `?attr/colorPrimaryContainer` (`@color/color_primary_container`) | ✅ 已存在,选中卡片底色 |
| `--color-on-primary-container` | `#1A237E` | `?attr/colorOnPrimaryContainer` | ✅ 已存在,选中卡片标题色 |
| `--color-secondary` | `#00897B` | `?attr/colorSecondary` (`@color/color_secondary`) | ✅ 已存在,确认按钮文字 |
| `--color-secondary-container` | `#E0F2F1` | `?attr/colorSecondaryContainer` (`@color/color_secondary_container`) | ✅ 已存在,确认按钮浅绿底色 |
| `--color-surface` | `#FFFFFF` | `?attr/colorSurface` (`@color/color_surface`) | ✅ 已存在,卡片背景色 |
| `--color-surface-variant` | `#F8FAFC` | `?attr/colorSurfaceVariant` | ✅ 已存在,侧边栏底色 |
| `--color-background` | `#F1F5F9` | `?attr/colorBackground` (`@color/color_background`) | ✅ 已存在,页面底色 |
| `--text-primary` | `#0F172A` | `@color/text_primary` | ✅ 已存在,主标题与主要文字 |
| `--text-secondary` | `#64748B` | `@color/text_secondary` | ✅ 已存在,说明副文本 |
| `--divider` | `#E2E8F0` | `@color/divider` | ✅ 已存在,分割线与浅描边 |
| `--outline` | `#CBD5E1` | `@color/outline` | ✅ 已存在,单选外圈 |
### 1.2 尺寸与间距 Token 映射
| HTML CSS 变量 | 取值 | Android 推荐 Token | 规范落地建议 |
| :--- | :--- | :--- | :--- |
| `--content-max-width` | 940px | `@dimen/content_max_width_split` (940dp) | 宽屏双栏内容容器最大宽度 |
| `--sidebar-width` | 320px | `@dimen/settings_sidebar_width_wide` (320dp) | 左侧状态概览面板固定宽度 |
| `--appbar-height` | 60px | `@dimen/appbar_height` (60dp 或复用 56dp) | Toolbar 高度 |
| `--corner-md` | 12px | `@dimen/corner_radius_md` (12dp) | 按钮与内部小组件圆角 |
| `--corner-lg` | 16px | `@dimen/corner_radius_lg` (16dp) | 版型卡片与侧边面板圆角 |
| `--spacing-md` | 16px | `@dimen/spacing_md` (16dp) | 卡片间距 |
| `--spacing-lg` | 24px | `@dimen/spacing_xl` (24dp) | 双栏间距与安全边距 |
---
## 2. Android 落地代码清单与改动指南
### 2.1 涉及文件
1. **布局文件 (Layout)**
- `app/src/main/res/layout/activity_edition_selection.xml`
2. **逻辑类 (Activity)**
- `app/src/main/java/com/umilab/eapmanage/team/edition/EditionSelectionActivity.java`
3. **新增资源 (Drawable)**
- `app/src/main/res/drawable/selector_edition_card_bg.xml` (卡片背景与描边选择器)
- `app/src/main/res/drawable/ic_edition_histogram.xml` (原版红框柱状图矢量图标)
---
### 2.2 具体实施步骤
#### 步骤 1:重构 `activity_edition_selection.xml`
- 将原有的单列居中布局重构为 **AppBar + 居中 940dp 水平双栏容器 (`LinearLayout horizontal`)**。
- 左侧 `summary-sidebar`:放置原版红框柱状图图标、大标题“选择版型”、说明、及 `tv_current_selected_edition` 状态卡片。
- 右侧 `main-selection`:放置两张 `MaterialCardView`(专业版与自定义功能版)以及底部 `btn_confirm` 确认按钮。
#### 步骤 2:修复卡片描边与选中状态
- 移除原代码中与卡片身份死绑的硬编码边框颜色(彻底去除专业版硬编码蓝框、自定义版硬编码绿框)。
- 卡片采用 `MaterialCardView` 统一绑定 `selector_edition_card_bg.xml` 或在 Activity 中动态设置 `strokeColor`/`cardBackgroundColor`:
- 选中态:`strokeColor = ?attr/colorPrimary` (1.5dp), `cardBackgroundColor = ?attr/colorPrimaryContainer`
- 未选中态:`strokeColor = ?attr/colorOutlineVariant` (1dp), `cardBackgroundColor = ?attr/colorSurface`
#### 步骤 3:`EditionSelectionActivity.java` 交互与联动
- 点击卡片时,更新选中状态并刷新左侧 `tv_current_selected_edition` 文本。
- 点击底部 `btn_confirm` 执行版型生效逻辑。
---
## 3. 验收核验标准
- [ ] 平板横屏下展示为居中双栏控制台布局,视觉平衡饱满。
- [ ] 彻底修复原图中一蓝一绿的描边逻辑错误(选中为 Primary 蓝描边+浅蓝底,未选中为中性浅描边)。
- [ ] 原版红框柱状图图标、文案“选择版型”、“请选择适合您使用场景的版型,后续可在设置中更改”、“专业版”、“自定义功能版”、“确定”全量保留无遗漏。
- [ ] 所有颜色与尺寸严格使用 Android 语义 Token。