From e7c1429889ea21129da9c73405e68adcc97e5a6a Mon Sep 17 00:00:00 2001 From: chenmoyuan1214 Date: Sat, 21 Nov 2026 20:18:28 +0800 Subject: [PATCH] =?UTF-8?q?feat(ci):=20=E6=96=B0=E5=A2=9E=20@build-release?= =?UTF-8?q?-bot=20build=20<=E7=89=88=E6=9C=AC=E5=8F=B7>?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 编译 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) --- .github/CI.md | 26 ++- .github/workflows/build-release.yml | 293 ++++++++++++++++++++++++++++ 2 files changed, 318 insertions(+), 1 deletion(-) create mode 100644 .github/workflows/build-release.yml diff --git a/.github/CI.md b/.github/CI.md index c714f9f..a4da922 100644 --- a/.github/CI.md +++ b/.github/CI.md @@ -6,9 +6,11 @@ | --- | --- | --- | | `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`,手动触发的发 `ip-prerelease`。 +预发布用**不同的 tag**,互不覆盖:夜间构建发 `nightly`,`@build-bot` 发 `ip-prerelease`; +`@build-release-bot` 发的是正式版本(tag 就是版本号,会更新 latest)。 ## 每夜构建 @@ -61,3 +63,25 @@ - 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,不需要额外安装。 diff --git a/.github/workflows/build-release.yml b/.github/workflows/build-release.yml new file mode 100644 index 0000000..43e4b72 --- /dev/null +++ b/.github/workflows/build-release.yml @@ -0,0 +1,293 @@ +name: build-release + +# 在 Issue / PR 里评论触发「编译 + 发布正式版本」: +# @build-release-bot build 1.1.3 +# +# 与 build-bot 的区别: +# build-bot 只编译,产物丢进 ip-prerelease(预发布,反复覆盖) +# build-release 编译三平台,发一个 tag = 版本号的正式 Release(会更新 latest) +# +# 不会改动仓库里的 version.json:它由 GC-SAVEDOG 签名,CI 里没有签名私钥, +# 重新 stamp 会产出一份客户端拒绝接受的清单。清单更新请走本地 ./build.sh stamp。 + +on: + issue_comment: + types: [created] + +concurrency: + group: release-manual + cancel-in-progress: false + +permissions: + contents: write + issues: write + pull-requests: write + +env: + TZ: Asia/Shanghai + DOTNET_VERSION: '8.0.x' + FLUTTER_VERSION: '3.24.5' + +jobs: + prepare: + if: | + contains(github.event.comment.body, '@build-release-bot') && + (github.event.comment.author_association == 'OWNER' || + github.event.comment.author_association == 'MEMBER' || + github.event.comment.author_association == 'COLLABORATOR') + runs-on: ubuntu-latest + outputs: + ok: ${{ steps.parse.outputs.ok }} + version: ${{ steps.parse.outputs.version }} + ref: ${{ steps.parse.outputs.ref }} + reason: ${{ steps.parse.outputs.reason }} + steps: + - uses: actions/checkout@v4 + with: + fetch-depth: 0 + + - id: parse + name: 解析版本号并预检 + env: + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + BODY: ${{ github.event.comment.body }} + run: | + set -e + # 只认 主.次.修订,其它写法直接忽略 + VER=$(printf '%s' "$BODY" \ + | grep -oiE '@build-release-bot[[:space:]]+build[[:space:]]+[0-9]+\.[0-9]+\.[0-9]+' \ + | head -1 \ + | awk '{print $NF}' || true) + + if [ -z "$VER" ]; then + echo "ok=false" >> "$GITHUB_OUTPUT" + echo "reason=没有匹配到合法版本号(格式:@build-release-bot build 1.2.3)" >> "$GITHUB_OUTPUT" + echo "未匹配到版本号,忽略" + exit 0 + fi + + echo "version=$VER" >> "$GITHUB_OUTPUT" + echo "ref=${{ github.event.repository.default_branch }}" >> "$GITHUB_OUTPUT" + echo "版本号=$VER" + + # tag 已存在就不能再发:重复 tag 会让客户端拿到两份不同内容 + if gh api "repos/${{ github.repository }}/git/ref/tags/${VER}" >/dev/null 2>&1; then + echo "ok=false" >> "$GITHUB_OUTPUT" + echo "reason=tag ${VER} 已存在,请换一个版本号" >> "$GITHUB_OUTPUT" + echo "tag ${VER} 已存在" + exit 0 + fi + + echo "ok=true" >> "$GITHUB_OUTPUT" + echo "reason=" >> "$GITHUB_OUTPUT" + + - name: 回复「开始编译并发布」 + if: steps.parse.outputs.ok == 'true' + env: + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + GH_REPO: ${{ github.repository }} + ISSUE: ${{ github.event.issue.number }} + VER: ${{ steps.parse.outputs.version }} + RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }} + run: | + set -e + cat > ack.md < SHA256SUMS.txt 2>/dev/null || sha256sum *.zip > SHA256SUMS.txt + cat SHA256SUMS.txt + + - name: 发布 Release + env: + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + GH_REPO: ${{ github.repository }} + VER: ${{ needs.prepare.outputs.version }} + REF: ${{ needs.prepare.outputs.ref }} + ACTOR: ${{ github.event.comment.user.login }} + ISSUE: ${{ github.event.issue.number }} + run: | + set -e + cat > notes.md < macOS 包为 ad-hoc 签名,首次打开需右键 →「打开」,或在「系统设置 → 隐私与安全性」里放行。 + EOF + + gh release create "$VER" out/* \ + --target "$REF" \ + --title "GC ${VER}" \ + --notes-file notes.md + + echo "https://github.com/${{ github.repository }}/releases/tag/$VER" >> "$GITHUB_STEP_SUMMARY" + + report: + needs: [prepare, build-mac, build-win, publish] + if: always() && needs.prepare.outputs.ok == 'true' + runs-on: ubuntu-latest + steps: + - name: 回帖结果 + env: + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + GH_REPO: ${{ github.repository }} + ISSUE: ${{ github.event.issue.number }} + VER: ${{ needs.prepare.outputs.version }} + MAC: ${{ needs.build-mac.result }} + WIN: ${{ needs.build-win.result }} + PUB: ${{ needs.publish.result }} + RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }} + run: | + set -e + REPO="${{ github.repository }}" + + line() { + case "$2" in + success) echo "- $1:✅ 成功" ;; + skipped) echo "- $1:⏭ 跳过" ;; + cancelled) echo "- $1:⛔ 已取消" ;; + *) echo "- $1:❌ 失败" ;; + esac + } + + if [ "$PUB" = "success" ]; then + HEADLINE="✅ **已发布 \`${VER}\`**" + elif [ "$MAC" = "success" ] || [ "$WIN" = "success" ]; then + HEADLINE="⚠️ **编译完成但未发布 \`${VER}\`**(需要两个平台都成功才会发 Release)" + else + HEADLINE="❌ **\`${VER}\` 编译失败**" + fi + + { + echo "$HEADLINE" + echo + line "macOS" "$MAC" + line "Windows" "$WIN" + line "发布" "$PUB" + echo + if [ "$PUB" = "success" ]; then + echo "- Release:https://github.com/${REPO}/releases/tag/${VER}" + else + echo "- 日志:${RUN_URL}" + fi + } > result.md + + gh issue comment "$ISSUE" --body-file result.md