build: 支持在 Linux/macOS 上交叉编译 Windows 前端 #7

Merged
Morris merged 2 commits from feat/win-cross-compile into main 2026-11-18 18:09:51 +08:00
Owner

背景

此前打出来的 Windows 包里不含 GC-UI,启动后回退到内置 Avalonia 界面。原因不是打包脚本写错,而是 Flutter 官方不支持在非 Windows 主机上执行 flutter build windows——Windows 嵌入层依赖 MSVC 与 flutter_windows.dll。

做法

Flutter 的 Windows 外壳(windows/runner + cpp_client_wrapper)是纯 Win32 + 标准 C++,只通过 C ABI 调用 flutter_windows.dll,所以 mingw-w64 就能编译。整条链路上唯一必须执行的 Windows 二进制是 AOT 快照生成器 gen_snapshot.exe,交给 wine 运行即可。全流程不需要 Windows 机器,也不需要 MSVC。

文件 职责
buildsh/cross/toolchain-mingw.cmake CMake 交叉工具链,posix 线程模型,静态链接 libstdc++/libgcc
buildsh/cross/CMakeLists.txt 只编 C++ 外壳,绕开 tool_backend.bat 与 MSVC 专用参数
buildsh/cross/build-ui-win-cross.sh 拉引擎产物、给 gen_snapshot 装 wine 包装、生成 AOT 快照、组装
build_flutter_ui_cross / build.sh 非 Windows 主机走交叉编译分支

产物与官方 toolchain 完全一致:

GC-UI.exe  flutter_windows.dll  data/{icudtl.dat, app.so, flutter_assets/}

踩到的两个坑(已在脚本里处理)

  1. flutter_tools 会 exec 路径为 .../windows-x64-release/gen_snapshot(没有 .exe)的文件,所以在原 .exe 旁边放一个同名 shell 脚本转调 wine。
  2. Runner.rc 在 windres 下有两处不兼容:图标用反斜杠相对路径;VERSION_AS_STRING 依赖命令行 -D 传入转义字符串。脚本生成一份路径与宏都已规整的 rc 副本再编译。

顺带修复

lib/shell.dart 的 const Text 里引用了动态的 GcColors.accent,编译器直接报常量求值错误,导致前端根本编不过。去掉该处 const。

验证

在 Linux 上用 wine 跑新打出的包:Flutter 引擎正常初始化,Dart AOT 快照加载并执行到业务代码,GC.UI.Server 的 /api/health 返回 {"ok":true,"version":"1.0.7","platform":"win-x64"}。三平台构建全部通过,win-amd64 包由 97 MB 增至 110 MB(多出的即前端)。

依赖

sudo apt install mingw-w64 cmake ninja-build wine   # Linux
brew install mingw-w64 cmake ninja && brew install --cask wine-stable  # macOS

缺依赖时 build_flutter_ui_cross 只告警并继续,包内仍回退 Avalonia,不影响出包。

## 背景 此前打出来的 Windows 包里不含 `GC-UI`,启动后回退到内置 Avalonia 界面。原因不是打包脚本写错,而是 Flutter 官方不支持在非 Windows 主机上执行 `flutter build windows`——Windows 嵌入层依赖 MSVC 与 `flutter_windows.dll`。 ## 做法 Flutter 的 Windows 外壳(`windows/runner` + `cpp_client_wrapper`)是纯 Win32 + 标准 C++,只通过 C ABI 调用 `flutter_windows.dll`,所以 mingw-w64 就能编译。整条链路上唯一必须执行的 Windows 二进制是 AOT 快照生成器 `gen_snapshot.exe`,交给 wine 运行即可。**全流程不需要 Windows 机器,也不需要 MSVC**。 | 文件 | 职责 | |---|---| | `buildsh/cross/toolchain-mingw.cmake` | CMake 交叉工具链,posix 线程模型,静态链接 libstdc++/libgcc | | `buildsh/cross/CMakeLists.txt` | 只编 C++ 外壳,绕开 `tool_backend.bat` 与 MSVC 专用参数 | | `buildsh/cross/build-ui-win-cross.sh` | 拉引擎产物、给 `gen_snapshot` 装 wine 包装、生成 AOT 快照、组装 | | `build_flutter_ui_cross` / `build.sh` | 非 Windows 主机走交叉编译分支 | 产物与官方 toolchain 完全一致: ``` GC-UI.exe flutter_windows.dll data/{icudtl.dat, app.so, flutter_assets/} ``` ## 踩到的两个坑(已在脚本里处理) 1. `flutter_tools` 会 exec 路径为 `.../windows-x64-release/gen_snapshot`(**没有 `.exe`**)的文件,所以在原 `.exe` 旁边放一个同名 shell 脚本转调 wine。 2. `Runner.rc` 在 windres 下有两处不兼容:图标用反斜杠相对路径;`VERSION_AS_STRING` 依赖命令行 `-D` 传入转义字符串。脚本生成一份路径与宏都已规整的 rc 副本再编译。 ## 顺带修复 `lib/shell.dart` 的 `const Text` 里引用了动态的 `GcColors.accent`,编译器直接报常量求值错误,导致前端根本编不过。去掉该处 `const`。 ## 验证 在 Linux 上用 wine 跑新打出的包:Flutter 引擎正常初始化,Dart AOT 快照加载并执行到业务代码,`GC.UI.Server` 的 `/api/health` 返回 `{"ok":true,"version":"1.0.7","platform":"win-x64"}`。三平台构建全部通过,win-amd64 包由 97 MB 增至 110 MB(多出的即前端)。 ## 依赖 ```bash sudo apt install mingw-w64 cmake ninja-build wine # Linux brew install mingw-w64 cmake ninja && brew install --cask wine-stable # macOS ``` 缺依赖时 `build_flutter_ui_cross` 只告警并继续,包内仍回退 Avalonia,不影响出包。
Morris added 2 commits 2026-11-18 13:31:14 +08:00
feat(ui): 启动器接入 Flutter 前端 · 公司名统一 Morris · 模型版本 +1
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
cd44c7ecff
- GC-BOOT 新增 FlutterShell:随包带 GC.UI.Server 与 GC-UI 时,拉起「本地后端 + Flutter 窗口」,界面退出后一起收尾;缺任一产物则回退内置 Avalonia 界面
- 构建脚本新增 publish_backend(三平台发布 UI 后端)与 build_flutter_ui(宿主平台构建 Flutter 桌面产物)
- Windows 打包由「单文件 exe」改为整目录,包含启动器、GC-SAVEDOG、UI 后端与可选 Flutter 产物
- Flutter 工程:Windows BINARY_NAME 与 macOS PRODUCT_NAME 改为 GC-UI,窗口标题 Morris GC
- 公司信息:Windows CompanyName/LegalCopyright、macOS PRODUCT_COPYRIGHT 统一为 Morris
- 模型版本末位 +1:contour-map 1.1 / earth-geography 1.9 / earth-revolution 1.7 / earth-rotation 1.7 / scale-calculator 1.6,并重算清单哈希
build: 支持在 Linux/macOS 上交叉编译 Windows 前端
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
2c0c566c81
此前 Windows 包内不含 Flutter 界面,只能回退到内置 Avalonia 界面,
原因是 Flutter 官方不支持在非 Windows 主机上执行 flutter build windows。

实际上 Windows 嵌入层(windows/runner + cpp_client_wrapper)是纯 Win32
加标准 C++,只通过 C ABI 调用 flutter_windows.dll,因此用 mingw-w64 即可
编译。整条链路上唯一必须执行的 Windows 二进制是 AOT 快照生成器
gen_snapshot.exe,交给 wine 运行即可。全流程不需要 Windows 机器或 MSVC。

实现:
- buildsh/cross/toolchain-mingw.cmake  CMake 交叉工具链,posix 线程模型,
  静态链接 libstdc++/libgcc,产物只依赖系统 DLL 和 flutter_windows.dll
- buildsh/cross/CMakeLists.txt         只编 C++ 外壳,绕开 tool_backend.bat
  与 MSVC 专用编译参数
- buildsh/cross/build-ui-win-cross.sh  拉取引擎产物、为 gen_snapshot 装 wine
  包装、生成 AOT 快照、组装出与官方 toolchain 一致的目录结构
- build_flutter_ui_cross / build.sh    非 Windows 主机走交叉编译分支,
  x64 产物同时放进 win-amd64 与 win-arm64 两个包

顺带修掉 shell.dart 的常量求值错误:强调色改为跟随设置的动态 getter 后,
const Text 里引用 GcColors.accent 会让编译器报错。

已在 Linux 上用 wine 验证产物:Flutter 引擎正常初始化,Dart AOT 快照加载
并执行到业务代码,后端 /api/health 正常返回。
Morris added 1 commit 2026-11-18 13:54:17 +08:00
fix(update): 更新清单指向 xhmcl 仓库,下载地址与 tag 对齐
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
fdbf3160e8
VersionStamp 里硬编码的仓库地址还是 gitcode.com/Morris_1/GC,与启动器
AppSettings.UpdateRepository 的默认值(git.xhmcl.com/Morris/GC)不一致,
导致生成的 version.json 把客户端导到一个没有对应 Release 的仓库。

同时下载地址拼的是 /download/v{版本}/,而实际 tag 没有 v 前缀
(1.0.7、1.0.8),两者对不上会 404。

改为读同一仓库地址并去掉 v 前缀,同时把当前 1.0.8 的清单同步过来
(sha256 沿用本次构建产物,未重算)。
Morris merged commit 40e72957e3 into main 2026-11-18 18:09:51 +08:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Morris/GC#7