Files
EAP_Interface_html/设置页面UI优化/自动连接配置/implementation_plan.md
T

78 lines
4.1 KiB
Markdown
Raw 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
- **模块**:系统设置 — 自动连接配置 (`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 硬编码。