跳过主要内容
自动化

使用GitHub管理开发和生产构建

使用Capgo将您的开发版发布到特定频道,允许您的团队尝试您的CapacitorIonic应用程序,而无需等待苹果和谷歌的审查

文章来源

马丁·多纳迪

作者

瓦莱里亚

审稿人

乔丹

编辑

使用 GitHub 在 GitHub Actions 中管理开发和生产构建

本教程重点介绍 GitHub 的托管,但您可以通过稍微调整一下适用于任何其他 CI/CD 平台

序言

确保您已在 Capacitor 中添加应用程序,然后在 Capgo 中添加应用程序,这个教程只关注上传阶段

提交约定

首先,您需要遵循提交约定 规范提交 ` 这将有助于工具了解如何升级版本号,学习它只需 5 分钟

规范提交

GitHub 动作标签

然后你需要创建第一个GitHub动作来自动构建并创建标签。

在这个路径创建一个文件: .github/workflows/bump_version.yml

内容如下:

name: Bump version

on:
  push:
    branches:
      - main
      - development

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
        if: github.ref == 'refs/heads/main'
        run: npx capacitor-standard-version
      - name: Create bump and changelog
        if: github.ref != 'refs/heads/main'
        run: npx capacitor-standard-version --prerelease alpha
      - 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

这将为每个主分支的提交发布一个标签。并且一个 alpha 发布 development,最后一个每个提交的 CHANGELOG.md.

的更改日志条目。

不用担心如果你没有这个文件,它会自动创建。 为了使其工作,你需要创建一个 并将其添加到您的GitHub secrets as PERSONAL_ACCESS_TOKEN.

这是必要的,以便CI提交changelog和版本号。

当您创建令牌时,请选择过期时间为 never 并将范围设置为 repo.

设置 version 在您的 package.json 文件中使用最后一个在商店发布的版本。

这只需要第一次,然后工具会自动更新。

您现在可以提交这两个文件并看到您的第一个标签出现在GitHub!

capacitor-standard-version 是负责魔法的包, 默认情况下,他也会更新您的Android和IOS版本号

GitHub 构建动作

创建一个文件到这个路径: .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 build
        env:
          MY_ENV_VAR: ${{ secrets.MY_ENV_VAR }}
      - name: Create Release Alpha
        if: "contains(github.ref, '-alpha.')"
        id: create_release_prepro
        run: npx @capgo/cli@latest bundle upload -a ${{ secrets.CAPGO_TOKEN }} -c development
      - name: Create Release Production
        if: "!contains(github.ref, '-alpha.')"
        id: create_release_prod
        run: npx @capgo/cli@latest bundle upload -a ${{ secrets.CAPGO_TOKEN }} -c production

这将安装并构建您的依赖项,然后将其发送到 Capgo。

如果您的构建命令不同,则可以在步骤中进行更改。 build_code step.

如果您需要一个环境变量,请使用 MY_ENV_VAR 并设置 secret in your GitHub project setting, then secret then GitHub Action.

为了让Capgo上传工作,您需要获取您的API密钥,用于Capgo,并将其添加到 添加此提交将生成一个新的 GitHub 构建,用于生产和开发频道。 as CAPGO_TOKEN.

添加此提交将生成一个新的 Capgo 构建,用于生产和开发频道。

添加此提交将生成一个新的 Capacitor 构建,用于生产和开发频道。

您应该在Ionic构建步骤中添加您的测试,以确保您的code正在工作。

前往您的Capgo控制台,检查刚刚出现的构建,您现在已经拥有了CI/CD系统。

继续从使用GitHub Actions管理开发和生产构建

如果您正在使用 使用GitHub Actions管理开发和生产构建 规划通道路由和阶段性发布,连接它与 通道 查看通道的实现细节 通道 查看通道的实现细节 通道 查看通道的实现细节 Beta 测试解决方案 为 Beta 测试解决方案中的产品工作流程, 和 版本目标解决方案 为版本目标解决方案中的产品工作流程.

Capacitor 应用程序的即时更新

当 web 层 bug 活跃时,通过 Capgo 发送修复,而不是等待几天的 app 商店审批。用户在后台接收更新,而原生更改仍在正常审批路径中。

来自马丁的人性化支持

立即开始

最新博客文章

Capgo 给您创建真正专业的移动应用所需的最佳见解。