首次提交,未改动文件

This commit is contained in:
zhy200308
2026-08-17 13:40:53 +08:00
commit cc6b6c54aa
37 changed files with 1559 additions and 0 deletions
@@ -0,0 +1,81 @@
---
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 排版!
>
> **工作台路径**:`.agents/UITask/系统设置界面-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 收口。
- [ ] 未丢失 `actual_ui.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/` 当前为空目录,是否有其他并行模块也计划使用,需协调避免策略冲突。