# 自动连接配置页面 — 原生落地图纸 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 硬编码。