Files
GC/.github/CI.md
T
Morris 936ef8333e fix: macOS 构建去掉 --no-codesign;build-bot 失败也回帖结果
- flutter build macos 不支持 --no-codesign(那是 iOS 的选项),
  传了会直接报 'Could not find an option named no-codesign' 导致编译失败。
  macOS 模板本身用 ad-hoc 签名,CI 无证书也能构建。
- 删除 workflow 里的 GC_NO_CODESIGN 环境变量
- build-bot 新增独立 report job(always):
  编译/发布任何一步失败都会回帖,列出各平台结果与日志链接,
  不再因为 publish 被跳过而静默
2026-11-21 19:47:57 +08:00

64 lines
3.3 KiB
Markdown
Raw 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`** 预发布 |
| `pr-review.yml` | 向 main 提 PR(新建 / 有新提交 / 重新打开) | 检查能否编译、是否有错、是否冲突、是否落后 main |
两个预发布用**不同的 tag**,互不覆盖:夜间构建发 `nightly`,手动触发的发 `ip-prerelease`。
## 每夜构建
时区用 `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 签名**(无开发者证书)。下载后首次打开需右键 →「打开」,
或在「系统设置 → 隐私与安全性」里放行。