Files

4.1 KiB
Raw Permalink Blame History

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