使用 Github actions 自动构建并发布应用

本教程重点介绍 GitHub 的托管，但稍作调整即可适配任何其他 CI/CD 平台。

前言

请确保已先将您的 Capacitor 应用添加到 Capgo，本教程仅侧重于 upload 阶段。如果您需要将应用添加到 Capgo，可以参考此指南教程

Commit 规范

首先，你需要开始遵循 commit 规范约定式提交 (conventional commits)` 这将帮助工具链理解如何升级版本号，学会它只需 5 分钟。

约定式提交 (Conventional commits)

用于 tag 的 GitHub actions

然后，你需要创建第一个 GitHub action，用来自动 build 并创建 tag。

在此路径下创建文件： .github/workflows/bump_version.yml

内容如下：

name: Bump version

on:
  push:
    branches:
      - main

jobs:
  bump-version:
    if: "!startsWith(github.event.head_commit.message, 'chore(release):')"
    runs-on: ubuntu-latest
    name: "Bump version and create changelog with standard version"
    steps:
      - name: Check out
        uses: actions/checkout@v6
        with:
          fetch-depth: 0
          filter: blob:none
          token: '${{ secrets.PERSONAL_ACCESS_TOKEN }}'
      - name: Git config
        run: |
          git config --local user.name "github-actions[bot]"
          git config --local user.email "github-actions[bot]@users.noreply.github.com"
      - name: Create bump and changelog
        run: npx capacitor-standard-version
      - name: Push to origin
        run: |
          CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
          remote_repo="https://${GITHUB_ACTOR}:${{ secrets.PERSONAL_ACCESS_TOKEN }}@github.com/${GITHUB_REPOSITORY}.git"
          git pull $remote_repo $CURRENT_BRANCH
          git push $remote_repo HEAD:$CURRENT_BRANCH --follow-tags --tags

这将为 main 分支的每次 commit 发布一个 tag，并在其中为 main 分支的每次 commit 添加 changelog 条目： CHANGELOG.md.

如果你没有这个文件，别担心，它会自动为你创建。

要实现此功能，请创建一个个人访问令牌 (Personal Access Token) 并将其添加到您的 GitHub 中 secrets 命名为 PERSONAL_ACCESS_TOKEN.

这是为了让 CI 能够提交 changelog。

创建令牌时，请将有效期设置为 never 并将权限范围 (scope) 设置为 repo.

最后，在您的 package.json 文件中设置版本号，使其与您的 Native 版本号保持一致，以便简化后续步骤。

这仅在第一次时需要，之后工具会自动保持更新。

现在你可以提交这两个文件，并在 GitHub 中看到你的第一个 tag 了！

每次 commit 后，原生和 Web 平台的版本号都会递增。

GitHub 的构建 action

在此路径下创建文件： .github/workflows/build.yml

内容如下：

name: Build source code and send to Capgo

on:
  push:
    tags:
      - '*'
      
jobs:
  deploy:
    runs-on: ubuntu-latest
    name: "Build code and release"
    steps:
      - name: Check out
        uses: actions/checkout@v6
      - name: Install dependencies
        id: install_code
        run: npm i
      - name: Build
        id: build_code
        run: npm run build
        env: # Remove both lines  if you don't need it
          FIREBASE_CONFIG: ${{ secrets.FIREBASE_CONFIG }} # Example of env var coming from a secret
      - name: Create Release
        id: create_release
        run: npx @capgo/cli@latest bundle upload -a ${{ secrets.CAPGO_TOKEN }} -c production

这会在发送到 Capgo 之前，先安装并构建你的依赖。

如果你的构建命令不同，可以在 build_code 步骤中修改。

要让其生效，你需要获取用于 Capgo 的 API key，并将其添加到你的 GitHub 仓库的 secret 中，命名为 CAPGO_TOKEN.

现在你可以提交这两个文件，并在 GitHub 中看到你的第一个 tag 了！

添加该 commit 后，会为 production channel 生成新的 build。

你应该在 build 步骤中添加测试，以确保你的 code 运行正常。

前往你的 Capgo dashboard 查看刚刚生成的 build，你现在已经拥有了自己的 CI/CD 系统。

如果你希望所有用户在有更新时都能收到，请前往你的 channel 并将其设置为 public.

你还可以按照本教程，为你的 Ionic Capacitor JavaScript 应用添加 Native Build 👇

继续学习：使用 Github actions 实现应用的自动化 build 与 release

如果你正在使用 使用 Github actions 自动构建并发布应用 规划 CI/CD 自动化，并将其与 Capgo CI/CD 用于 Capgo CI/CD 中的产品工作流， Capgo Native Build 用于 Capgo Native Builds 中的产品工作流， Capgo 集成用于 Capgo 集成中的产品工作流， CI/CD 集成了解 CI/CD 集成的实现细节，以及 GitHub Actions 集成有关 GitHub Actions 集成的实现细节。