编译 macOS + Windows(amd64/arm64),发布 tag = 版本号的正式 Release(非预发布)。 - prepare 解析版本号(必须 主.次.修订),tag 已存在则拒绝并回帖说明 - 两个平台都成功才发 Release,附 SHA256SUMS.txt - 独立的 report job:任何一步失败都会回帖,列出各平台与发布状态 - 不动 version.json(需 SAVEDOG 签名,CI 无私钥),文档里注明走本地 ./build.sh stamp - mac job 增加环境自检(sw_vers / xcodebuild -version / flutter --version)
4.4 KiB
GitHub Actions 说明
三个工作流,都在 .github/workflows/ 下。自建 Gitea 里对应的老流水线在 .gitea/workflows/,两边互不影响。
| 工作流 | 触发 | 做什么 |
|---|---|---|
nightly-prerelease.yml |
每天 21:00(Asia/Shanghai),或手动 | 编译 macOS + Windows(amd64/arm64),发布 nightly 预发布 |
build-bot.yml |
Issue / PR 评论里 @build-bot build <目标> |
只编译指定平台,发布 ip-prerelease 预发布 |
build-release.yml |
Issue / PR 评论里 @build-release-bot build <版本号> |
编译三平台,发布 tag = 版本号 的正式 Release |
pr-review.yml |
向 main 提 PR(新建 / 有新提交 / 重新打开) | 检查能否编译、是否有错、是否冲突、是否落后 main |
预发布用不同的 tag,互不覆盖:夜间构建发 nightly,@build-bot 发 ip-prerelease;
@build-release-bot 发的是正式版本(tag 就是版本号,会更新 latest)。
每夜构建
时区用 TZ=Asia/Shanghai,cron 写成 0 13 * * *(= 21:00 UTC+8)。
产物是 GCL-<版本>-<平台>.zip,由 build.sh / build.ps1 生成在 dist/<平台>/。
nightly 这个 tag 每次滚动重建(先删 release 和 tag,再按当前提交创建),
所以它的下载链接是稳定的。因为 tag 不是版本号,客户端的上传/更新逻辑会跳过它
——夜间版本永远不会被当成「有新版可用」推给用户,符合预期。
build-bot 用法
在 Issue 或 PR 里评论:
@build-bot build mac # 只编 macOS
@build-bot build win-amd # 只编 Windows amd64
@build-bot build win-arm # 只编 Windows arm64
@build-bot build all # 三个平台全编
规则:
- 只有
OWNER/MEMBER/COLLABORATOR的评论才会触发,其他人评论会被忽略。 - PR 上的评论编的是 该 PR 的 head 提交;Issue 上评论编的是 main 最新提交。
- 产物用
gh release upload --clobber合并进ip-prerelease,不会删掉别的平台资产。 - 编完会在评论里回帖:成功给出 release 链接,失败给出日志链接。
- 同一时刻只跑一个 build-bot(同一 concurrency 组),避免并发改同一个 release;
nightly用的是另一个组,两者互不干扰(tag 本来就不同)。
PR 自动审查
对 main 的 PR 在新建 / 推新提交 / 重新打开时运行,检查四项:
- 能否编译:
dotnet build GC.sln -c Release - 代码检查:
flutter analyze(在GC-UI/frontend) - 是否冲突:读 GitHub 的
mergeable字段(异步计算,会重试几次) - 是否落后:
git rev-list --count HEAD..origin/main
结论写进一条带 <!-- gc-pr-review --> 标记的评论,重复运行只更新这一条,不会刷屏。
日志尾部(dotnet / flutter 各 40 行)折叠在评论的 <details> 里。
说明:这里只做「能编译 + 能通过静态分析」,不跑
flutter build macos(Ubuntu runner 没有 Xcode)。真正的三平台编译由nightly-prerelease和build-bot覆盖。
需要的仓库设置
Settings → Actions → General → Workflow permissions给 Read and write, 否则gh release/ 评论接口会 403(工作流里已声明permissions:,但组织策略可能覆盖)。- Secrets 不需要额外配置,统一用内置的
GITHUB_TOKEN。 - macOS 产物是 ad-hoc 签名(无开发者证书)。下载后首次打开需右键 →「打开」, 或在「系统设置 → 隐私与安全性」里放行。
build-release 用法
在 Issue 或 PR 里评论:
@build-release-bot build 1.1.3
规则:
- 版本号必须是
主.次.修订(如1.1.3),其它写法会被忽略 - tag 已存在时不会触发,会回帖说明「请换一个版本号」——同一个 tag 发两次会让客户端拿到两份不同内容
- 只有
OWNER/MEMBER/COLLABORATOR能触发 - 编 macOS + Windows(amd64/arm64),两个平台都成功才发 Release,否则只回帖失败原因
- Release 附带
SHA256SUMS.txt - 不会改动仓库里的
version.json:它由 GC-SAVEDOG 签名,CI 没有签名私钥。清单更新请在本地跑./build.sh stamp
macOS runner
统一用 macos-latest。macos-14 在本账号会被判为 macos-14-arm64-us-default 不受支持,
job 在启动前就变成 cancelled。runner 自带多个版本的 Xcode 和 CocoaPods,不需要额外安装。