Files
Morris e7c1429889 feat(ci): 新增 @build-release-bot build <版本号>
编译 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)
2026-11-21 20:18:28 +08:00

88 lines
4.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 在新建 / 推新提交 / 重新打开时运行,检查四项:
1. **能否编译**:`dotnet build GC.sln -c Release`
2. **代码检查**:`flutter analyze`(在 `GC-UI/frontend`)
3. **是否冲突**:读 GitHub 的 `mergeable` 字段(异步计算,会重试几次)
4. **是否落后**:`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,不需要额外安装。