Gitlabを使用した自動ビルドとリリース

このチュートリアルはGitLab CIに焦点を当てていますが、CI/CDプラットフォームのいくつかを適応させることで他のCI/CDプラットフォームでも使用できます。

序文

Capgoにアプリを追加することを確認してください。このチュートリアルはアップロードフェーズに焦点を当てています。

コミット規約

まずコミット規約に従う必要があります。標準的なコミット` __CAPGO_KEEP_0__ を使用すると、ツールがバージョン番号のアップグレードを理解するのに役立ちます。5分で学べます。

Conventional Commits

GitLab CI for tag

次に、自動的にビルドとタグを作成するための最初の GitLab を作成する必要があります。

このパスにファイルを作成してください: .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 エントリを追加します。 CHANGELOG.md.

このファイルが必要ありません。自動的に作成されます。

この設定を実行するには、 PERSONAL ACCESS TOKEN GitLab CI/CD 変数に追加してください: PERSONAL_ACCESS_TOKEN.

CI が changelog をコミットできるようにする必要があります。

トークンを作成するときは、有効期限を never とスコープを repo.

最後に、ツールが保存されているバージョンの場所を理解するために、ファイル .cz.toml をリポジトリのルートに作成する必要があります。

に追加してください。

[tool.commitizen]
name = "cz_conventional_commits"
tag_format = "$major.$minor.$patch$prerelease"
version = "0.11.5"
version_files = [
    "package.json:version",
    ".cz.toml"
]

このファイルのバージョンを、 package.json ファイルのバージョンと同じに設定してください。

これは最初の時のみ必要です。その後、ツールは自動的に更新します。

GitHubのタグが表示されます。

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

This will install and build your dependency before sending it to Capgo.

buildコマンドが異なる場合は、ステップで変更できます。 build_code この機能を使用するには、__CAPGO_KEEP_1__の__CAPGO_KEEP_0__キーを取得し、__CAPGO_KEEP_0__リポジトリのシークレットに追加する必要があります。

To make this work, you need to get your API key for Capgo, add it in the secret of your GitHub repository __CAPGO_KEEP_0__のテストをビルドステップに追加して、__CAPGO_KEEP_0__が正常に動作していることを確認する必要があります。 CAPGO_TOKEN.

GitHubダッシュボードにアクセスし、最近追加されたビルドを確認し、CI/CDシステムを構築したことを確認します。

すべてのユーザーが利用可能な更新を取得したい場合は、チャンネルに自動更新を設定してください。

codeの自動ビルドとリリースをGitLabで継続してください。

Capgoの__CAPGO_KEEP_1__キーを取得し、Capgoリポジトリのシークレットに追加する必要があります。

__CAPGO_KEEP_0__のテストをビルドステップに追加して、__CAPGO_KEEP_0__が正常に動作していることを確認する必要があります。 public.

__CAPGO_KEEP_0__ダッシュボードにアクセスし、最近追加されたビルドを確認し、CI/CDシステムを構築したことを確認します。

あなたが使用している場合 Gitlabと自動的にビルドおよびリリース CI/CDの自動化を計画する場合、Cloudflareと接続 Capgo CI/CD Capgo CI/CDの製品ワークフロー Capgo Native Builds Capgo Native Buildsの製品ワークフロー Capgo Integrations Capgo Integrationsの製品ワークフロー CI/CDの実装詳細 CI/CDの統合 GitHub Actions Integration GitHub の実装詳細のアクション統合の詳細についてはこちらを参照してください。