feat(ui): 统一AppBar规范与双栏动态页边距,交付自动连接配置全量物料

This commit is contained in:
zhy200308
2026-08-17 16:32:14 +08:00
parent fa304292b4
commit c50d6f00f5
29 changed files with 4250 additions and 176 deletions
@@ -0,0 +1,77 @@
# 自动连接配置页面 — 原生落地图纸 implementation_plan
- **模块**:系统设置 — 自动连接配置 (`AutoConnectSettingsActivity`)
- **依据**:同目录 `baseline_ui.html` + `DESIGN_SPEC.md`
- **原始出厂截图**:`./Screenshot_20260812_143357.png`
- **定妆效果图**:`./image.png`
- **执行角色**:`@coder` (Android 工程师)
---
## 1. CSS → Android Token 映射字典
> ⚠️ **Token 状态声明**:因仓库暂未包含 `UI_DEV_GUIDE.md` 宪法文件,以下 Token 映射依据 Google Material Design 3 标准语义 Token 编写,标记为 `[标准推荐/待校准]`,严禁硬编码色值与尺寸。
### 1.1 颜色语义映射
| HTML CSS 变量 | 取值 | Android 语义 Token / 资源 ID | 状态 / 说明 |
| :--- | :--- | :--- | :--- |
| `--color-primary` | `#2563EB` | `?attr/colorPrimary` | ✅ 主题主色 (Switch 激活态、通道微胶囊) |
| `--color-primary-light` | `#EFF6FF` | `@color/primary_container_light` (`#EFF6FF`) | ✅ 状态胶囊浅底色 |
| `--color-surface` | `#FFFFFF` | `?attr/colorSurface` | ✅ 卡片背景色 |
| `--color-surface-variant` | `#F8FAFC` | `?attr/colorSurfaceVariant` | ✅ 页面内容区底色与列表项背景 |
| `--color-background` | `#EEF2F6` | `?attr/colorBackground` | ✅ 页面最外层底色 |
| `--text-main` | `#0F172A` | `?attr/colorOnSurface` | ✅ 主标题文本色 |
| `--text-sub` | `#64748B` | `?attr/colorOnSurfaceVariant` | ✅ 辅助说明文本色 |
| `--divider` | `#E2E8F0` | `?attr/colorOutlineVariant` | ✅ 分割线与卡片边框 |
### 1.2 尺寸与圆角映射
| CSS 变量 / 属性 | 取值 | Android 资源 ID | 说明 |
| :--- | :--- | :--- | :--- |
| `--content-max-width` | `1120px` | `@dimen/content_max_width_auto_connect` (1120dp) | 宽屏居中最大宽度 |
| `--corner-card` | `18px` | `@dimen/corner_radius_lg` (18dp) | 岛屿与 Bento 卡片圆角 |
| `--corner-item` | `12px` | `@dimen/corner_radius_md` (12dp) | 列表行与子规则卡片圆角 |
| `--appbar-height` | `60px` | `?attr/actionBarSize` (60dp) | 顶部栏高度 |
---
## 2. Android 落地代码清单与改动指南
### 2.1 涉及文件清单
1. **布局文件 (Layout)**
- `app/src/main/res/layout/activity_auto_connect_settings.xml`
- `app/src/main/res/layout/item_channel_reconnect.xml` (通道列表单项布局)
2. **逻辑类 (Activity & Adapter)**
- `app/src/main/java/com/umilab/eapmanage/team/settings/AutoConnectSettingsActivity.java`
- `app/src/main/java/com/umilab/eapmanage/team/settings/adapter/ChannelSortAdapter.java`
3. **资源与样式 (Drawables & Colors)**
- `app/src/main/res/drawable/bg_island_card.xml`
- `app/src/main/res/drawable/bg_channel_item.xml`
---
### 2.2 具体实施步骤
#### 步骤 1:重构 `activity_auto_connect_settings.xml`
- 顶部放置标准 `Toolbar`(60dp 高);
- 核心内容区使用横向双栏:
- 左侧 `MaterialCardView`(固定 420dp):放置顶部总控开关与 `RecyclerView`(9 通道列表);
- 右侧 `LinearLayout`(权重 1fr):垂直排布两张 `MaterialCardView`(上方:型号过滤规则纵向卡片组;下方:系统连接策略 2x2 四宫格网格)。
#### 步骤 2:通道列表与拖拽重排 (`RecyclerView` + `ItemTouchHelper`)
- 使用 `ItemTouchHelper` 绑定左侧通道列表,用户长按或拖拽右侧 `≡` 即可实现通道顺序自由交换与持久化。
#### 步骤 3:`AutoConnectSettingsActivity.java` 逻辑与文案绑定
- 严格绑定各 Switch 的 SharedPreferences 存取;
- 策略第 4 项绑定键值与文案:`离线超过30秒停止写入设备`。
---
## 3. 验收核验标准
- [ ] 平板横屏下呈现为 1120dp 居中双栏架构(左侧 420dp 通道岛屿 + 右侧 Bento 规则策略双层矩阵)。
- [ ] 通道列表第一项顶部具备完整内边距,上边框在任何状态下绝不被裁切。
- [ ] 型号过滤规则采用上下纵向摆放,输入框通栏舒展。
- [ ] 系统连接策略第 4 项文案准确显示为“离线超过30秒停止写入设备”。
- [ ] 所有颜色与尺寸严格使用语义 Token,无 XML 硬编码。