Files
EAP_Interface_html/系统设置界面-20260816/CARD-20260816-UITask-系统设置界面.md
2026-08-17 14:51:41 +08:00

6.7 KiB
Raw Permalink Blame History

title, status, created, level
title status created level
APP界面优化 - 系统设置类页面(语言设置 / 选择版型 / 版本信息 / Logo 授权管理 / 数据上传) TODO 2026-08-16 1

任务目标

对系统设置类 5 张页面执行纯美化重构(不改信息架构、不改交互范式、不丢任何字段), 核心解决平板宽屏下"内容顶左上角、右侧大片留白"的排版失衡问题,统一为 840dp 居中内容容器; 同时修复数据上传页三个输入框的物理重叠错位、选择版型页选中态描边逻辑颠倒等具体 Bug。

开发依据(4 件套约束)

🚨 绝对约束:请 @coder 在修改代码前,必须必须必须先阅读以下工作台目录的全部 3 份基准物料, 并同步阅读全局公约 ../BEAUTIFY_BASELINE_20260816.md 与 Token 宪法 ../UI_DEV_GUIDE.md。严禁自行发挥 UI 排版!

工作台路径:仓库根目录下的 系统设置界面-20260816/(即本卡片所在目录)

  1. baseline_ui.html:[必读] 终极 HTML 排版基准源代码,5 个 <section> 对应 5 屏,顶部 :root 为全量 Token 声明。
  2. DESIGN_SPEC.md:[必读] 视觉边界手册 —— 840dp 栅格规范、五屏逐项差异点、状态机、截断规则、最小点击区域、与公约的差异声明。
  3. implementation_plan.md:[必读] CSS→Android Token 映射字典 + 已实际检索确认的落地文件清单 + 风险/待确认项。

原始截图(未复制,相对路径引用,@coder 核对信息槽位用):

  • ../ui_baseline/EAPManageUI/Screenshot_20260812_143341.png(语言设置)
  • ../ui_baseline/EAPManageUI/Screenshot_20260812_143347.png(选择版型)
  • ../ui_baseline/EAPManageUI/Screenshot_20260812_143456.png(版本信息)
  • ../ui_baseline/EAPManageUI/Screenshot_20260812_143502.png(Logo 授权管理)
  • ../ui_baseline/EAPManageUI/Screenshot_20260812_143450.png(数据上传)

涉及文件(详细改动点见 implementation_plan.md §2,此处仅列清单)

Layout

  • app/src/main/res/layout/activity_language_settings.xml
  • app/src/main/res/layout/activity_edition_selection.xml
  • app/src/main/res/layout/activity_version_info.xml
  • app/src/main/res/layout/activity_logo_management.xml
  • app/src/main/res/layout/activity_data_upload.xml

Java / Activity / ViewModel

  • app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/language/LanguageSettingsActivity.java
  • app/src/main/java/com/umilab/eapmanage/team/edition/EditionSelectionActivity.java
  • app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/version/VersionInfoActivity.java
  • app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/version/VersionInfoViewModel.java
  • app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/logo/LogoManagementActivity.java
  • app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/logo/LogoManagementViewModel.java
  • app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/upload/DataUploadActivity.java

资源(新增 Token / 样式 / drawable)

  • app/src/main/res/values/dimens.xml(新增 content_max_width、settings_form_label_width、settings_row_height)
  • app/src/main/res/values/colors.xml(核对 color_secondary_container 取值)
  • app/src/main/res/values/themes.xml(新增 Widget.EAPManage.Button.Segmented,补充 Toolbar titleTextAppearance)
  • 新增 app/src/main/res/drawable/selector_language_row_bg.xml
  • 新增 app/src/main/res/drawable/shape_badge_error.xml、shape_badge_success.xml

执行步骤清单

  1. 840dp 居中容器:按 DESIGN_SPEC.md §1 落地统一栅格规范,5 屏全部收敛;语言设置页保持"外层通栏可点、内层视觉居中"的双层结构(implementation_plan.md §3.2)。
  2. 修复数据上传页三输入框重叠错位:ConstraintLayout 改写为竖向 LinearLayout + 四行横向两列结构(implementation_plan.md §2.5),标签列固定 140dp。
  3. 修复选择版型页选中态描边颠倒:两张卡的 strokeColor/strokeWidth/圆点 tint 随选中状态动态联动,不再与卡片身份绑死(implementation_plan.md §3.3)。
  4. 语言设置:行高 56dp、选中态背景反馈、分割线缩进对齐。
  5. 版本信息:三卡标签列统一 140dp 对齐成列;"Debug" 由纯红字降级为徽章;下载更新按钮改为独立动作行。
  6. Logo 授权管理:分段控件按公约 §5.6 收口;预览条底色改为 surface+描边;计数器归位到输入框正下方。
  7. 黑色胶囊开关替换:数据上传页 SwitchCompat → MaterialSwitch。
  8. 全部页面 AppBar 标题字号/返回箭头间距按公约 §3 统一。
  9. 自查 DESIGN_SPEC.md §6 清单逐条过一遍再提交。

验收标准

  • 平板横屏下 5 屏内容均为 840dp 居中显示,无"顶左上角+右侧大片留白"现象。
  • 数据上传页三个输入框标签与框对齐、互不重叠压盖。
  • 选择版型页:选中卡 = primary 描边 + primary-container 底,未选中卡为中性描边,两卡逻辑一致(不再一蓝一绿颠倒)。
  • 语言设置页:行高 56dp,选中行有背景反馈,分割线不再通栏到边。
  • 版本信息页:三张卡标签值对齐成列,Debug 变为浅红底徽章而非纯红字,下载更新按钮有分割线锚定。
  • Logo 授权管理页:分段控件、预览条、计数器均按 DESIGN_SPEC.md §3.4 收口。
  • 未丢失上述 5 张原机截屏(../ui_baseline/EAPManageUI/Screenshot_*.png,逐页对照本卡片"原始截图"小节)中的任何一个信息字段或功能入口。
  • 无散落十六进制颜色/尺寸,全部引用 @color/、@dimen/、?attr/ Token(对照 UI_DEV_GUIDE.md §5 清单自查)。

附:待 @coder 二次确认的风险项(详见 implementation_plan.md §4,此处摘要)

  1. 公约字号阶梯(15sp/13sp)与仓库现有 dimens.xml(14sp/11sp)不完全对齐,建议先与其他并行 UI 子任务对齐字号基准表。
  2. radius_lg(12dp)与 corner_radius_lg(20dp)命名相近但数值不同,落地时需明确版型卡用前者。
  3. color_secondary_container 实际取值是否已是浅绿,需核实。
  4. 项目中是否已有 MaxWidthXxxLayout 类自定义容器可复用(用于承载 840dp 居中逻辑)。
  5. MaterialCardView.strokeColor 是否支持 ColorStateList(取决于 Material Components 版本),若不支持则版型卡选中态必须走代码动态设置而非 XML selector。
  6. values-w600dp/、layout-w600dp/ 当前为空目录,是否有其他并行模块也计划使用,需协调避免策略冲突。