此前 build.sh 在非 Windows 宿主上把前端当「可选项」:flutter 缺失只告警、 交叉编译失败只告警、macOS 前端在 Linux 上直接跳过。结果是包照出,用户拿到 的是 Avalonia 回退界面,而构建日志里一行红字很容易被忽略。 改为默认必需: - build_flutter_ui / build_flutter_ui_cross 缺 flutter 或编译失败一律返回非 0, build.sh 立即中断并给出原因(交叉编译失败时带日志尾巴) - 确实要出降级包时显式声明 ./build.sh build --allow-no-ui 目标平台按构建主机决定,每条产物都带 Flutter: macOS 主机 → mac-arm64(Xcode 原生)+ win-amd64/win-arm64(mingw 交叉) Linux 主机 → linux-amd64(原生)+ win-amd64/win-arm64(mingw 交叉) Windows 主机 → win-amd64/win-arm64(原生) Linux 目标此前根本不存在,这次一并补上: - GC-UI/frontend/linux/ 由 flutter create 生成,BINARY_NAME=GC-UI、 APPLICATION_ID=com.xhmcl.GC、窗口标题 "Morris GC" - build_flutter_ui 增加 linux 分支,bundle(GC-UI + lib/ + data/)铺进 dist/linux-amd64/,pack_launcher 增加 Linux 整目录打包 - linux/CMakeLists.txt 强制 CMAKE_INSTALL_PREFIX 指向 build/.../bundle: 某些环境下它会被初始化成 /usr/local,导致 flutter 报「构建成功」但 bundle 是空的、产物装进了系统目录(本机实测踩到) 顺带修正两处: - 生成 settings.json 的默认 updateRepository 还是 gitcode 地址,与只保留 xhmcl 源的现状不符 - 进度条权重改为按实际目标动态计算,新平台不会再把总进度算过 100% 验证(Linux 主机,flutter 3.24.5): - ./build.sh build 出 win-amd64 109 MB、win-arm64 105 MB、linux-amd64 65 MB, 三份均含 Flutter 前端,清单签名 Verified - Linux 包在 Xvfb + llvmpipe 下实跑:后端 /api/health 返回 ok,GC-UI 窗口 正常渲染出模型库首页 - macOS 目标在 Linux 上不再产出 Avalonia 空壳包(要它得回 macOS 编)
此前 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 正常返回。
- 说明 .gitea/workflows 与 GitHub 目录的差异、TZ= 时区前缀、prerelease 不占用 latest 的原理 - 记录 act_runner 必须注册 ubuntu-latest / windows-latest / macos-latest 三个标签, 以及 Windows 需 MSVC、macOS 需 Xcode