build: 支持在 Linux/macOS 上交叉编译 Windows 前端
此前 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 正常返回。
This commit is contained in:
1 parent
cd44c7ecff
commit
2c0c566c81
7 files changed
+456
-16
No files matched your search
+48
-2
@@ -64,9 +64,55 @@ Windows 还需要 **VS Build Tools 的「使用 C++ 的桌面开发」工作负
|
||||
## 本地构建(不经 CI)
|
||||
|
||||
```bash
|
||||
# macOS
|
||||
# Linux / macOS:三平台一次出齐。Windows 前端用 mingw-w64 + wine 交叉编译,
|
||||
# 不需要 Windows 机器。
|
||||
./build.sh build
|
||||
|
||||
# 只编 macOS 前端
|
||||
./GC-UI/build-ui.sh macos
|
||||
|
||||
# Windows
|
||||
# Windows 主机原生构建
|
||||
GC-UI\build-ui.cmd
|
||||
```
|
||||
|
||||
### Windows 前端交叉编译
|
||||
|
||||
Flutter 官方不支持在非 Windows 主机上 `flutter build windows`,但 Windows 嵌入层
|
||||
(`windows/runner/*.cpp` + `cpp_client_wrapper`)是纯 Win32 + 标准 C++,只通过 C ABI
|
||||
调用 `flutter_windows.dll`,所以 mingw-w64 就能编译。整条链路上唯一必须执行的
|
||||
Windows 二进制是 AOT 快照生成器 `gen_snapshot.exe`,交给 wine 跑即可。
|
||||
|
||||
```bash
|
||||
# 依赖
|
||||
sudo apt install mingw-w64 cmake ninja-build wine # Linux
|
||||
brew install mingw-w64 cmake ninja # macOS
|
||||
brew install --cask wine-stable # macOS 的 wine
|
||||
|
||||
# 单独构建(默认输出到 GC-UI/frontend/build/windows/x64/runner/Release)
|
||||
./buildsh/cross/build-ui-win-cross.sh [输出目录]
|
||||
```
|
||||
|
||||
产物与官方 toolchain 完全一致,可直接拷到 Windows 运行:
|
||||
|
||||
```
|
||||
GC-UI.exe flutter_windows.dll data/{icudtl.dat, app.so, flutter_assets/}
|
||||
```
|
||||
|
||||
实现分三层:
|
||||
|
||||
| 文件 | 职责 |
|
||||
|---|---|
|
||||
| `buildsh/cross/toolchain-mingw.cmake` | CMake 交叉工具链(posix 线程模型,静态链接 libstdc++,产物只依赖系统 DLL) |
|
||||
| `buildsh/cross/CMakeLists.txt` | 只编 C++ 外壳;绕开 `tool_backend.bat` 与 MSVC 专用参数 |
|
||||
| `buildsh/cross/build-ui-win-cross.sh` | 拉引擎产物、装 `gen_snapshot` 的 wine 包装、生成 AOT 快照、组装 |
|
||||
|
||||
两个容易踩的坑,脚本里已处理:
|
||||
|
||||
- `flutter_tools` 会 exec 路径为 `.../windows-x64-release/gen_snapshot`(**没有 `.exe`**)
|
||||
的文件,所以脚本在原 `.exe` 旁边放一个同名 shell 脚本转调 wine。
|
||||
- `Runner.rc` 在 windres 下有两处不兼容:图标用反斜杠相对路径、`VERSION_AS_STRING`
|
||||
依赖命令行传 `-D` 的转义字符串。脚本生成一份路径与宏都已规整的 rc 副本再编译。
|
||||
|
||||
`.gitea/workflows` 里的 `windows` 任务仍然跑在 `windows-latest` 上;若手头只有 macOS/Linux
|
||||
构建机,可以把该任务的 `runs-on` 换成对应标签,直接复用这套交叉编译脚本,
|
||||
不再需要 VS Build Tools。
|
||||
@@ -140,7 +140,7 @@ class _Sidebar extends StatelessWidget {
|
||||
borderRadius: BorderRadius.circular(8),
|
||||
),
|
||||
alignment: Alignment.center,
|
||||
child: const Text(
|
||||
child: Text(
|
||||
'◎',
|
||||
style: TextStyle(fontSize: 14, color: GcColors.accent),
|
||||
),
|
||||
|
||||
Reference in new issue
Block a user