このチュートリアルは GitHub のホスティングに焦点を当てていますが、少し手を加えれば他の CI/CD プラットフォームにも応用できます。
はじめに
まず Capacitor アプリを Capgo に追加しておいてください。このチュートリアルではアップロードフェーズのみを扱います。
コミット規約
まずはコミット規約に従ってください conventional commits` を導入すると、ツールがバージョン番号をどう上げるか理解できるようになります。覚えるのに5分です。

タグ用の GitHub actions
次に、ビルドとタグ作成を自動化するための最初の GitHub actionを作成する必要があります。
以下のパスにファイルを作成してください: .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
これにより、mainブランチの各コミットに対してタグがリリースされます。また、 alpha リリースが development、そして最後に各コミットのチェンジログが作成されます。 CHANGELOG.md.
このファイルがなくても大丈夫です。自動的に作成されます。
これを実現するには、まず以下のものを作成する必要があります: パーソナルアクセストークン を作成し、GitHub の secrets として PERSONAL_ACCESS_TOKEN.
これは、CIがchangelogのコミットやバージョンの更新を行うために必要です。
トークンを作成する際は、有効期限を never スコープを repo.
以下の version を package.json ファイルに設定してください。App Storeで最後にリリースされたバージョンを使用してください。
これは初回のみ必要です。以降はツールが自動的に更新します。
これで両方のファイルをコミットすれば、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 ステップで変更できます。
環境変数が必要な場合は、 MY_ENV_VAR を設定し、 secret の GitHub プロジェクト設定から、secret を経由して GitHub Action に設定してください。
Capgo の upload を機能させるには、Capgo 用の API キーを取得し、 GitHub リポジトリの secret に追加する必要があります。 として CAPGO_TOKEN.
これで両方のファイルを commit すれば、Capgo に最初のバージョンが表示されます!
commit を追加すると、production と development チャネル向けの新しい Capacitor build が生成されます。
Ionic の build ステップにテストを追加して、code が正しく動作することを確認してください。
Capgo dashboard に移動して、表示されたばかりの build を確認してください。これで CI/CD システムが整いました。
GitHub actions を使った開発・本番環境 build の管理へ進む
使用している場合 開発ビルドと本番ビルドを GitHub アクションで管理 チャンネルルーティングと段階的ロールアウトを計画するには、次と組み合わせてください: チャンネル Channelsの実装の詳細については、 チャンネル Channelsの実装の詳細については、 チャンネル Channelsの実装の詳細については、 ベータテストソリューション ベータテストソリューションのプロダクトワークフロー向け、および バージョンターゲティングソリューション バージョンターゲティングソリューションのプロダクトワークフロー向け。