此前 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 编)
6.6 KiB
GC-UI 持续集成
夜间 alpha 构建的工作流在 .gitea/workflows/gc-ui-alpha.yml。
本仓库是自建 Gitea(不是 GitHub),所以目录是 .gitea/workflows/,语法与 GitHub Actions 基本一致,
差异集中在 runner 标签 和 API 前缀 两处。
它做什么
| 任务 | 运行环境 | 产出 |
|---|---|---|
prepare |
ubuntu-latest |
算版本号,建一个 草稿 + prerelease 的 Release |
windows |
windows-latest |
gc-ui-alpha-windows-x64.zip(Flutter release 目录) |
macos |
macos-latest |
gc-ui-alpha-macos-<arch>.zip(gc_ui.app,用 ditto 打包保真) |
publish |
ubuntu-latest |
两个平台都成功后才把草稿翻成可见,并断言 latest 没被占用 |
-
定时:每天 21:00(Asia/Shanghai),cron 写作
TZ=Asia/Shanghai 0 21 * * *。 Gitea 1.23 起 Actions 的 cron 默认按 UTC 解释,所以这里显式带时区前缀; 若你的实例不认TZ=,改成等效的 UTC 写法0 13 * * *。 -
alpha 不占用 latest:Gitea 的
/releases/latest只返回「最近一个既非草稿、也非 prerelease」 的发布,所以prerelease: true的夜间版本永远不会成为 latest。publish任务最后会再查一次/releases/latest,一旦指向本次 tag 就 fail。 -
手动触发:Actions 页面 Run workflow;或
curl -X POST -u "USER:TOKEN" \ "https://git.xhmcl.com/api/v1/repos/Morris/GC/actions/workflows/gc-ui-alpha.yml/dispatches" \ -H 'Content-Type: application/json' -d '{"ref":"gc-ui","inputs":{"note":"手动验证"}}'
前置条件(缺一不可)
1. 必须有 act_runner,并且带这三个标签
# 在准备当构建机的机器上(Windows / macOS 各一台,或一台 Linux 只跑 prepare/publish)
docker run -d --name gitea-runner \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /path/to/runner-data:/data \
-e GITEA_INSTANCE_URL=https://git.xhmcl.com \
-e GITEA_RUNNER_REGISTRATION_TOKEN=<在 站点管理 → Actions → Runners 里拿> \
-e GITEA_RUNNER_LABELS=ubuntu-latest:docker://gitea/runner-images:ubuntu-latest,windows-latest:docker://<你的 windows 镜像>,macos-latest:docker://<你的 macos 镜像> \
gitea/act_runner:latest
关键点:runs-on 的值必须和 runner 上注册的 label 完全一致,否则任务永远排队。
Windows / macOS 的构建不能跑在 Linux docker 容器里(一个要 MSVC,一个要 Xcode),
所以那两个 label 需要指向真实的 Windows / macOS 机器(自托管 runner)。
2. Flutter SDK
工作流里有一条「准备 Flutter SDK」:机器上已有 flutter 就直接用;没有就按
FLUTTER_VERSION(默认 3.24.5,需 >= 3.5.4 以匹配 pubspec.yaml 的 sdk: ^3.5.4)从
storage.googleapis.com 下载官方 SDK 并写进 PATH。所以机器只要能上外网就够,不必预装。
网络受限时请预装 Flutter 并确保 flutter 在 PATH 里。
Windows 还需要 VS Build Tools 的「使用 C++ 的桌面开发」工作负载;macOS 需要 Xcode。
3. Token
优先用仓库 Secrets 里的 RELEASE_TOKEN(Gitea 设置 → Actions → Secrets,需 repo 权限的个人访问令牌);
没配就退回 Gitea 自动注入的 github.token。若自动 token 没有 release 权限,
创建 Release 那步会报 401/403 —— 这时配一个 RELEASE_TOKEN 即可,不用改工作流文件。
本地构建(不经 CI)
# 按构建主机自动选目标,每条产物都带 Flutter 前端:
# macOS 主机 → mac-arm64(原生)+ win-amd64 / win-arm64(mingw 交叉)
# Linux 主机 → linux-amd64(原生)+ win-amd64 / win-arm64(mingw 交叉)
# Windows 主机 → win-amd64 / win-arm64(原生)
./build.sh build
# 前端是必需项:flutter 缺失或编译失败会直接中断,
# 确需降级成只有 Avalonia 回退界面的包时才用:
./build.sh build --allow-no-ui
# 只编 macOS 前端
./GC-UI/build-ui.sh macos
# Windows 主机原生构建
GC-UI\build-ui.cmd
Linux 前端(原生)
Flutter 的 Linux 桌面端只能在 Linux 上编,需要 GTK3 开发库与 C++ 工具链:
sudo apt install clang cmake ninja-build pkg-config libgtk-3-dev libstdc++-14-dev
libstdc++-14-dev 容易漏:clang 18 会去 /usr/lib/gcc/x86_64-linux-gnu/14/ 找
-lstdc++,系统只装了 gcc-13 的开发包时链接会失败,报 cannot find -lstdc++。
产物布局:GC-UI + lib/libflutter_linux_gtk.so + data/,与官方 flutter build linux 的 bundle 一致,直接铺进 dist/linux-amd64/。
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 跑即可。
# 依赖
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。