跳过主要内容
CI/CD

Automatic build and release app with Github actions

使用Github创建您的CI/CD管道,免费部署IonicCapacitorJS应用程序每次推送到主分支。

文章来源

马丁·多纳迪乌

作者

瓦莱里亚

审阅者

乔丹

编辑

Automatic build and release app with Github actions

本教程专注于 GitHub 主机,但您可以轻松适应任何其他 CI/CD 平台。

前言

确保您已在 Capacitor 应用程序中添加您的应用程序,首先添加到 Capgo,本教程仅关注上传阶段。 如果您需要添加应用程序到 Capgo,您可以遵循本 教程

提交约定

首先,您需要遵循提交约定 上下文:Capgo Builder / 原生云构建产品页面。角色:短 UI 标签或导航项。消息键 `native_build_builder_credit_first` (原生构建构建者首先)。规范提交

 ` 这将有助于工具理解如何升级版本号,学习时间仅 5 分钟。

GitHub actions for tag

GitHub 动作(标签)

然后,您需要创建第一个 __CAPGO_KEEP_0__ 动作来自动构建和创建标签。 .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

这将为您的主分支中的每个提交发布一个标签。并为主分支中的每个提交添加一个更改日志条目。 CHANGELOG.md.

如果您没有这个文件,别担心,它将为您创建。

要使其工作,请创建一个 个人访问令牌 并将其添加到您的GitHub 秘密 作为 PERSONAL_ACCESS_TOKEN.

这有必要让CI提交更改日志。

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

最后一步,设置您的 package.json 文件中的版本号,与您的原生版本号保持同步,这将使下一步更容易。

这只需要在第一次使用时,之后工具将自动更新。

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

原生和Web平台都会在每次提交后将版本号更新。

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 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 步骤中进行更改。

要使此功能工作,您需要获取您的API密钥并将其添加到Capgo中, GitHub 的密钥 因为 CAPGO_TOKEN.

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

添加此提交将为生产渠道生成一个新的构建。

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

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

如果您希望让所有用户在可用时立即获得更新,请转到您的渠道并设置为 public.

您还可以通过遵循此教程添加您的 Ionic Capacitor JavaScript 应用的原生构建 👇

继续 Automatic build and release app with Github actions

如果您正在使用 Automatic build and release app with Github actions 来规划 CI/CD 自动化,连接它 Capgo CI/CD 为Capgo CI/CD Capgo 原生构建 为Capgo 原生构建 Capgo 集成 context:Capgo 集成 为__CAPGO_KEEP_0__ 集成 CI/CD 集成 GitHub Actions Integration for the implementation detail in GitHub Actions Integration.

Live updates for Capacitor apps

当一个 web 层 bug 活跃时,通过 Capgo 直接将修复推送给用户,而不是等待几天的 app store 审核时间。用户在后台接收更新,而原生变化仍然在正常的审查路径中。

来自 Martin 的专业支持

立即开始

最新博客

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