82 lines
6.7 KiB
Markdown
82 lines
6.7 KiB
Markdown
---
|
||
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/` 当前为空目录,是否有其他并行模块也计划使用,需协调避免策略冲突。
|