编译 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)
88 lines
4.4 KiB
Markdown
88 lines
4.4 KiB
Markdown
# 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,不需要额外安装。
|