4.1 KiB
4.1 KiB
自动连接配置页面 — 原生落地图纸 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 涉及文件清单
- 布局文件 (Layout)
app/src/main/res/layout/activity_auto_connect_settings.xmlapp/src/main/res/layout/item_channel_reconnect.xml(通道列表单项布局)
- 逻辑类 (Activity & Adapter)
app/src/main/java/com/umilab/eapmanage/team/settings/AutoConnectSettingsActivity.javaapp/src/main/java/com/umilab/eapmanage/team/settings/adapter/ChannelSortAdapter.java
- 资源与样式 (Drawables & Colors)
app/src/main/res/drawable/bg_island_card.xmlapp/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 硬编码。