feat(ui): 重做启动器界面并修复 DPI 发糊 #17

Merged
xhgit merged 1 commits from feat/ui-crisp-dpi into main 2026-11-18 22:18:02 +08:00
Owner

背景

启动器界面「太糊」。查下来不是配色问题:Release 1.0.11 里的 GC-UI.exe 完全没有嵌入清单(二进制里搜不到 dpiAwareness / supportedOS),Windows 把它当 DPI 不感知程序,在 125% / 150% 缩放的屏幕上把整块窗口当位图拉伸,所以是真的糊。原因是 windows/runner/CMakeLists.txt 把 runner.exe.manifest 当源文件交给 VS 生成器自动嵌入,而 mingw 交叉编译只用 windres 编 Runner.rc,没有这一步。

改动

DPI(根治发糊)

  • buildsh/cross/CMakeLists.txt:往 Runner.cross.rc 追加 1 24 "<abs>/runner.exe.manifest",windres 也会嵌清单
  • windows/runner/main.cpp:建窗前自行声明 Per-Monitor V2(三级回退到 shcore / SetProcessDPIAware),不依赖清单
  • windows/runner/win32_window.cpp:初始窗口按显示器工作区 92% 上限收缩,避免 DPI 感知后 1280×720 在 150% 屏上变成 1920×1080 顶出屏幕

界面重做

  • theme.dart:设计系统(间距/圆角/字号令牌、中性石墨底 + 高对比正文、按钮/输入/滑块/分段控件样式、桌面滚动行为),字体显式走 Segoe UI + Microsoft YaHei UI(macOS 苹方),行高钉死,正文最小 12px
  • shell.dart:侧栏 + 底部更新条重排
  • pages.dart:首页横幅/卡片网格自适应、下载页源列表与任务、设置页宽屏两栏、关于页双栏
  • 顺手修:下拉框/输入框字体丢失中文回退、封面遮罩把占位字母盖掉、任务状态 Downloading 未翻译、封面按整窗宽解码

截图与回归

  • tool/render_shots_test.dart:不依赖后端、注入 CJK 与 MaterialIcons 字体、toImage 挪进 runAsync(原来每个用例卡满 10 分钟超时)、补 1024×680 小窗溢出回归
  • 文档:GC-UI/README.md(测试 / DPI 说明)、GC-UI/CI.md(交叉编译必须自己嵌 DPI 清单)

验证

  • flutter analyze → No issues found
  • flutter test → 10 个截图用例 + 8 个单元/主题用例全部通过(含小窗回归)
  • flutter build bundle → 编译通过
  • 截图见 GC-UI/frontend/test/shots/(gitignore):home / download / settings / about / shell / 小窗 / 浅色

注意

仓库里没有 .signing/gc-signing.pem(gitignore),本次未重新签名 version.json;正式发版前请用私钥签一次,否则客户端会拒绝该清单的更新。

## 背景 启动器界面「太糊」。查下来不是配色问题:Release 1.0.11 里的 `GC-UI.exe` **完全没有嵌入清单**(二进制里搜不到 `dpiAwareness` / `supportedOS`),Windows 把它当 DPI 不感知程序,在 125% / 150% 缩放的屏幕上把整块窗口当位图拉伸,所以是真的糊。原因是 `windows/runner/CMakeLists.txt` 把 `runner.exe.manifest` 当源文件交给 VS 生成器自动嵌入,而 mingw 交叉编译只用 windres 编 `Runner.rc`,没有这一步。 ## 改动 **DPI(根治发糊)** - `buildsh/cross/CMakeLists.txt`:往 `Runner.cross.rc` 追加 `1 24 "<abs>/runner.exe.manifest"`,windres 也会嵌清单 - `windows/runner/main.cpp`:建窗前自行声明 Per-Monitor V2(三级回退到 shcore / SetProcessDPIAware),不依赖清单 - `windows/runner/win32_window.cpp`:初始窗口按显示器工作区 92% 上限收缩,避免 DPI 感知后 1280×720 在 150% 屏上变成 1920×1080 顶出屏幕 **界面重做** - `theme.dart`:设计系统(间距/圆角/字号令牌、中性石墨底 + 高对比正文、按钮/输入/滑块/分段控件样式、桌面滚动行为),字体显式走 `Segoe UI + Microsoft YaHei UI`(macOS 苹方),行高钉死,正文最小 12px - `shell.dart`:侧栏 + 底部更新条重排 - `pages.dart`:首页横幅/卡片网格自适应、下载页源列表与任务、设置页宽屏两栏、关于页双栏 - 顺手修:下拉框/输入框字体丢失中文回退、封面遮罩把占位字母盖掉、任务状态 `Downloading` 未翻译、封面按整窗宽解码 **截图与回归** - `tool/render_shots_test.dart`:不依赖后端、注入 CJK 与 MaterialIcons 字体、`toImage` 挪进 `runAsync`(原来每个用例卡满 10 分钟超时)、补 1024×680 小窗溢出回归 - 文档:`GC-UI/README.md`(测试 / DPI 说明)、`GC-UI/CI.md`(交叉编译必须自己嵌 DPI 清单) ## 验证 - `flutter analyze` → No issues found - `flutter test` → 10 个截图用例 + 8 个单元/主题用例全部通过(含小窗回归) - `flutter build bundle` → 编译通过 - 截图见 `GC-UI/frontend/test/shots/`(gitignore):home / download / settings / about / shell / 小窗 / 浅色 ## 注意 仓库里没有 `.signing/gc-signing.pem`(gitignore),本次未重新签名 `version.json`;正式发版前请用私钥签一次,否则客户端会拒绝该清单的更新。
xhgit added 1 commit 2026-11-18 22:16:20 +08:00
feat(ui): 重做启动器界面并修复 DPI 发糊
PR 审核 / 后端编译 (pull_request) Canceled after 0s
PR 审核 / 后端自检 (pull_request) Canceled after 0s
PR 审核 / 前端检查(Flutter) (pull_request) Canceled after 0s
PR 审核 / 安全扫描 (pull_request) Canceled after 0s
PR 审核 / 审核汇总 (pull_request) Canceled after 0s
e67cc63998
- 交叉编译补嵌 runner.exe.manifest:GNUn res 不再丢掉 DPI 声明,缩放屏不再位图拉伸
- main.cpp 建窗前自行声明 Per-Monitor V2 DPI 感知(三级回退)
- win32_window 初始窗口按显示器工作区上限收缩,避免 150% 缩放后超出屏幕
- 重做主题:中性石墨底 + 高对比正文、统一字号/间距/圆角令牌、Segoe UI + 雅黑字体栈
- 首页/下载/设置/关于四页重排,宽屏自适应、小窗不溢出
- 修复下拉框字体丢失、封面遮罩盖住占位、任务状态未翻译等问题
- 截图脚本:注入 CJK/图标字体、runAsync 取像素、补小窗回归用例
xhgit merged commit a1a14f106b into main 2026-11-18 22:18:02 +08:00
xhgit deleted branch feat/ui-crisp-dpi 2026-11-18 22:18:02 +08:00
Owner

牛逼牛逼

牛逼牛逼
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Morris/GC#17