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

82 lines
6.7 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.
---
title: "APP界面优化 - 系统设置类页面(语言设置 / 选择版型 / 版本信息 / Logo 授权管理 / 数据上传)"
status: "TODO"
created: "2026-08-16"
level: 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/` 当前为空目录,是否有其他并行模块也计划使用,需协调避免策略冲突。