6.7 KiB
6.7 KiB
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/(即本卡片所在目录)
baseline_ui.html:[必读] 终极 HTML 排版基准源代码,5 个<section>对应 5 屏,顶部:root为全量 Token 声明。DESIGN_SPEC.md:[必读] 视觉边界手册 —— 840dp 栅格规范、五屏逐项差异点、状态机、截断规则、最小点击区域、与公约的差异声明。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.xmlapp/src/main/res/layout/activity_edition_selection.xmlapp/src/main/res/layout/activity_version_info.xmlapp/src/main/res/layout/activity_logo_management.xmlapp/src/main/res/layout/activity_data_upload.xml
Java / Activity / ViewModel
app/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/language/LanguageSettingsActivity.javaapp/src/main/java/com/umilab/eapmanage/team/edition/EditionSelectionActivity.javaapp/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/version/VersionInfoActivity.javaapp/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/version/VersionInfoViewModel.javaapp/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/logo/LogoManagementActivity.javaapp/src/main/java/com/umilab/eapmanage/team/ui/settings/subsettings/logo/LogoManagementViewModel.javaapp/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,补充 ToolbartitleTextAppearance)- 新增
app/src/main/res/drawable/selector_language_row_bg.xml - 新增
app/src/main/res/drawable/shape_badge_error.xml、shape_badge_success.xml
执行步骤清单
- 840dp 居中容器:按
DESIGN_SPEC.md§1 落地统一栅格规范,5 屏全部收敛;语言设置页保持"外层通栏可点、内层视觉居中"的双层结构(implementation_plan.md§3.2)。 - 修复数据上传页三输入框重叠错位:
ConstraintLayout改写为竖向LinearLayout+ 四行横向两列结构(implementation_plan.md§2.5),标签列固定 140dp。 - 修复选择版型页选中态描边颠倒:两张卡的
strokeColor/strokeWidth/圆点 tint 随选中状态动态联动,不再与卡片身份绑死(implementation_plan.md§3.3)。 - 语言设置:行高 56dp、选中态背景反馈、分割线缩进对齐。
- 版本信息:三卡标签列统一 140dp 对齐成列;"Debug" 由纯红字降级为徽章;下载更新按钮改为独立动作行。
- Logo 授权管理:分段控件按公约 §5.6 收口;预览条底色改为 surface+描边;计数器归位到输入框正下方。
- 黑色胶囊开关替换:数据上传页
SwitchCompat→MaterialSwitch。 - 全部页面 AppBar 标题字号/返回箭头间距按公约 §3 统一。
- 自查
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,此处摘要)
- 公约字号阶梯(15sp/13sp)与仓库现有
dimens.xml(14sp/11sp)不完全对齐,建议先与其他并行 UI 子任务对齐字号基准表。 radius_lg(12dp)与corner_radius_lg(20dp)命名相近但数值不同,落地时需明确版型卡用前者。color_secondary_container实际取值是否已是浅绿,需核实。- 项目中是否已有
MaxWidthXxxLayout类自定义容器可复用(用于承载 840dp 居中逻辑)。 MaterialCardView.strokeColor是否支持 ColorStateList(取决于 Material Components 版本),若不支持则版型卡选中态必须走代码动态设置而非 XML selector。values-w600dp/、layout-w600dp/当前为空目录,是否有其他并行模块也计划使用,需协调避免策略冲突。