自動Capacitor Android ビルドにGitHubアクションを使用

CapacitorアプリのCI/CD設定は複雑で時間がかかることがあります。ここでは、必要なことを知っておくことがおすすめです。

新しいビルドの推奨: Capgo ビルドを使用

__CAPGO_KEEP_0__ ビルドを使用することをおすすめします。 Capgo ビルドとCapgo CLI ネイティブ Capacitor ビルド用。 このFastlaneガイドは、既存のGitHubアクションパイプラインを維持するチーム向けに残されていますが、新しいAndroidビルドにはCapgo CLIを使用してください。そうすることで、Fastlane、Gradleランナーの、キーストア、そしてアップロードスクリプトを自分で維持する必要がなくなります。

前提条件

開始する前に、次の設定が必要です。

GitHubアカウントに管理者権限
Google Play Storeに適切に署名されたアプリがすでに公開されている
Android署名キーとキーストアファイル
Play Store APIが有効になっているGoogle Cloud Consoleプロジェクト
適切な権限を持つサービスアカウント
GitHubアクションワークフローの理解
Fastlaneの設定に関する知識
パイプラインの維持とデバッグに必要な時間

Capgo Build for CI/CD by Capgo

Fastlane, Gradle ランナー、キーストア、そしてアップロードスクリプトのメンテナンスをスキップします。 Capgo Build __CAPGO_KEEP_0__ Buildは、既存のCI/CD Pipelinesから署名されたネイティブAndroidビルドを実行します。

__CAPGO_KEEP_0__ Buildは、パイプラインと一緒に機能します。: Capgo BuildをGitHub Actions、GitLab CI、Jenkins、またはローカルスクリプトからトリガーします。Webビルド後に npx cap sync.
: CIシークレットから署名します。: Androidのキーストア、キーアリセイ、パスワード、プレイコンソールサービスアカウントJSONをCIシークレットに保持します。
: __CAPGO_KEEP_0__ Buildは、Androidビルド環境を管理しているので、__CAPGO_KEEP_1__ イメージ、Gradleキャッシュ問題、またはFastlaneレーンの管理をしなくてもよい。: Capgo Buildは、署名されたアーティファクトをQAでダウンロードしたり、Capgo SDK からリリースビルドを送信したりできます。
__CAPGO_KEEP_0__ Build: Download signed artifacts for QA or submit release builds through the Capgo CLI.

料金

Capgo プランは月額 12 ドルから始まります
OTA の更新と約 15 回のネイティブビルドを含みます
クレジットを通じて 1 分あたり追加のビルド分数を請求します

Capgo ビルドを CI/CD で設定する

手動設定ガイド

ここで何が必要かを説明します

GitHub アクションの料金

GitHub アクションは、リポジトリの種類に基づいて無料分数を提供します

パブリックリポジトリ: 1 か月あたり 2,000 分
プライベートリポジトリ: 1 か月あたり 2,000 分 (Linux ランナー)

個人的プロジェクトの場合、コストは約$0.008/分です。通常のビルドには3-5分かかります。

手動セットアップ手順

Android Keystoreを作成する
Google Play Service Accountをセットアップする
Fastlaneをセットアップする
Configure GitHub secrets
Create GitHub Actions workflow

1. Android Keystoreを作成する

Androidアプリを署名して公開する前に、キーストアファイルを作成する必要があります。これは1回限りのセットアップです。

keytoolを使用してキーストアを作成する

ターミナルでこのコマンドを実行する

keytool -genkey -v -keystore my-release-key.keystore -alias my-key-alias -keyalg RSA -keysize 2048 -validity 10000

次の質問に答えます:

__CAPGO_KEEP_0__のパスワード__CAPGO_KEEP_1__を選択してください (これは後で必要になります。 KEYSTORE_STORE_PASSWORD)
__CAPGO_KEEP_0__のパスワード__CAPGO_KEEP_1__を選択してください (これは後で必要になります。 KEYSTORE_KEY_PASSWORD)
名前、組織など__CAPGO_KEEP_1__を入力してください

注意事項

これらの値を安全に保存してください:
- __CAPGO_KEEP_2__のファイルの保存場所 (例えば、 my-release-key.keystore)
- __CAPGO_KEEP_3__ (例えば、 my-key-alias） - これは後で必要になります。 KEYSTORE_KEY_ALIAS
- __CAPGO_KEEP_0__のパスワード - これは後で必要になります。 KEYSTORE_STORE_PASSWORD
- パスワード - これが必要なので KEYSTORE_KEY_PASSWORD
キーストアファイルをバックアップしてください: アプリを公開した場合に失うと、アプリを更新できなくなります
秘密にしましょう: これをgitにコミットしてはいけません
安全な場所に複数のバックアップをしましょう代替: 既存のキーストアを使用する

アプリをすでに公開している場合、最初に使用したキーストアを使用する必要があります。場所を探すことができます:

最初にアプリをビルドしたローカルマシン

Play Console → 設定 → アプリ署名 (Google Play App Signingを使用している場合)
2. Google Play Service Accountを設定する

2. Google Play Service Accountを設定する

Google Playにアップロードするために、GitHub Actionsを使用するには、サービスアカウントが必要です。

ステップ 2.1: Google Cloud プロジェクトを作成する

Go to Google Cloud Console
新しいプロジェクトを作成するか、既存のプロジェクトを選択する
プロジェクト ID をメモする

ステップ 2.2: Google Play Developer API を有効にする

Google Cloud Consoleに移動し、 APIs & Services → ライブラリ
「Google Play Android Developer API」を検索する
クリック 有効化

Step 2.3: Service アカウントの作成

Go to IAM & Admin → Service アカウント
Click Service アカウントの作成
Enter details:
- Name: github-actions-uploader
- 説明: “GitHub のビルドアップロード用サービスアカウント”
Click 作成と続行
現在のロール割り当てをスキップ (クリック続行, その後完了)

ステップ 2.4: サービスアカウントキーを作成する

新しく作成したサービスアカウントにクリック
ここに キーセクション タブ
クリック キーを追加 → 新しいキーを作成
選択してください JSON形式 フォーマット
クリック作成
JSONファイルがダウンロードされます - このファイルを安全に保存してください後で必要になります

ステップ 2.5: Play Console でアクセス権を付与する

Google Play Console に移動 Google Play Console に移動
Step 2.5: Play Console でアクセス権を付与する セットアップ → API にアクセス
下 サービスアカウント、クリック アクセスを許可 サービスアカウントのために
アクセス許可の アプリの許可 タブにアプリを追加
アクセス許可の アカウントの許可 タブ、許可を付与する:
- アプリの情報を表示し、大量のレポートをダウンロード (読み取り専用)
- ダークアプリを作成、編集、削除
- テストトラックにアプリをリリース
- プロダクション、除外、他トラックにアプリをリリース
クリック ユーザーを招待
クリック 招待を送信

ステップ 2.6: JSON キーを検証

ダウンロードした JSON ファイルは次のようになります:

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "...",
  "private_key": "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n",
  "client_email": "github-actions-uploader@your-project-id.iam.gserviceaccount.com",
  "client_id": "...",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://oauth2.googleapis.com/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "..."
}

GitHub シークレット設定ステップで、この値を base64 に変換します。

3. Fastlaneをセットアップする

プロジェクトのルートディレクトリにフォルダを作成し、以下の内容を追加する fastlane 4. __CAPGO_KEEP_0__シークレットを設定する Fastfile キーストアとサービスアカウントのJSONファイルを取得したので、__CAPGO_KEEP_0__で安全に保存する必要があります。

default_platform(:android)

KEYSTORE_KEY_ALIAS = ENV["KEYSTORE_KEY_ALIAS"]
KEYSTORE_KEY_PASSWORD = ENV["KEYSTORE_KEY_PASSWORD"]
KEYSTORE_STORE_PASSWORD = ENV["KEYSTORE_STORE_PASSWORD"]

platform :android do
    desc "Deploy a beta version to the Google Play"
    private_lane :verify_changelog_exists do |version_code: |
      changelog_path = "android/metadata/en-US/changelogs/#{version_code}.txt"
      UI.user_error!("Missing changelog file at #{changelog_path}") unless File.exist?(changelog_path)
      UI.message("Changelog exists for version code #{version_code}")
    end

    private_lane :verify_upload_to_staging do |version_name: |
      UI.message "Skipping staging verification step"
    end
    
    lane :beta do
        keystore_path = "#{Dir.tmpdir}/build_keystore.keystore"
        File.write(keystore_path, Base64.decode64(ENV['ANDROID_KEYSTORE_FILE']))
        json_key_data = Base64.decode64(ENV['PLAY_CONFIG_JSON'])
        
        # Get previous build number and increment
        previous_build_number = google_play_track_version_codes(
            package_name: ENV['DEVELOPER_PACKAGE_NAME'],
            track: "internal",
            json_key_data: json_key_data,
        )[0]
        current_build_number = previous_build_number + 1
        sh("export NEW_BUILD_NUMBER=#{current_build_number}")
        
        # Build the app
        gradle(
          task: "clean bundleRelease",
          project_dir: 'android/',
          print_command: false,
          properties: {
            "android.injected.signing.store.file" => "#{keystore_path}",
            "android.injected.signing.store.password" => "#{KEYSTORE_STORE_PASSWORD}",
            "android.injected.signing.key.alias" => "#{KEYSTORE_KEY_ALIAS}",
            "android.injected.signing.key.password" => "#{KEYSTORE_KEY_PASSWORD}",
            'versionCode' => current_build_number
          })
        
        # Upload to Play Store
        upload_to_play_store(
            package_name: ENV['DEVELOPER_PACKAGE_NAME'],
            json_key_data: json_key_data,
            track: 'internal',
            release_status: 'completed',
            skip_upload_metadata: true,
            skip_upload_changelogs: true,
            skip_upload_images: true,
            skip_upload_screenshots: true,
        )
    end
end

ステップ 4.1: GitHubシークレットにアクセスする

GitHubにアクセスする

GitHub

Go to your repository on GitHub
シークレットと変数 アクション → Cloudflare → Capacitorは日本語で翻訳されませんでした。
クリック 新しいリポジトリのシークレット

ステップ 4.2: 必要なシークレットを追加する

それぞれのシークレットを 1 つずつ追加してください。

PLAY_CONFIG_JSON

ステップ 2.4 でダウンロードしたサービスアカウントの JSON ファイルを取得してください。
base64 に変換してください。

macOS/Linux の場合:

base64 service_account_key.json | pbcopy

Windows (PowerShell) の場合:

[Convert]::ToBase64String([IO.File]::ReadAllBytes("service_account_key.json")) | Set-Clipboard

新しいシークレットを作成してください。 PLAY_CONFIG_JSON 名を付けます。

base64 の文字列をペーストしてください。

__CAPGO_KEEP_0__をBase64に変換します:

macOS/Linuxの場合:

base64 my-release-key.keystore | pbcopy

Windows (PowerShell)の場合:

[Convert]::ToBase64String([IO.File]::ReadAllBytes("my-release-key.keystore")) | Set-Clipboard

新しいシークレットを作成してください ANDROID_KEYSTORE_FILE とBase64の文字列をペーストしてください

KEYSTORE_KEY_ALIAS

新しいシークレットを作成してください。キー・アライアスは、キーストアを生成したときに使用したものと同じで、例えば my-key-alias)

KEYSTORE_KEY_PASSWORD

キーストアを生成したときに設定したキー・パスワードのシークレットを作成してください

KEYSTORE_STORE_PASSWORD

キーストアを生成したときに設定したストア・パスワードのシークレットを作成してください

DEVELOPER_PACKAGE_NAME

アプリのパッケージ名で新しいシークレットを作成してください (例、 com.example.app)

パッケージ名は android/app/build.gradle の下で applicationId

Step 4.3: Verify All Secrets

6 つのシークレットが正しく設定されていることを確認してください:

✅ PLAY_CONFIG_JSON
✅ ANDROID_KEYSTORE_FILE
✅ KEYSTORE_KEY_ALIAS
✅ KEYSTORE_KEY_PASSWORD
✅ KEYSTORE_STORE_PASSWORD
✅ DEVELOPER_PACKAGE_NAME

5. GitHub Actions ワークフローを作成してください

__CAPGO_KEEP_0__ .github/workflows/build-upload-android.yml:

name: Build and Deploy Android App

on:
  push:
    tags:
      - '*'

jobs:
  build_android:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      
      - name: Setup Node.js
        uses: actions/setup-node@v6
        with:
          node-version: 24
          cache: npm
          
      - name: Install dependencies
        run: npm ci
        
      - name: Cache Gradle
        uses: actions/cache@v5
        with:
          path: |
            ~/.gradle/caches
            ~/.gradle/wrapper
          key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
          restore-keys: |
            ${{ runner.os }}-gradle-
            
      - name: Build app
        run: npm run build
        
      - name: Sync Capacitor
        run: npx cap sync
        
      - name: Setup Java
        uses: actions/setup-node@v5
        with:
            distribution: 'zulu'
            java-version: '17'
            
      - name: Setup Ruby
        uses: ruby/setup-ruby@v1
        with:
          ruby-version: '3.0'
          bundler-cache: true
          
      - name: Run Fastlane
        uses: maierj/fastlane-action@v3.1.0
        env:
          PLAY_CONFIG_JSON: ${{ secrets.PLAY_CONFIG_JSON }}
          ANDROID_KEYSTORE_FILE: ${{ secrets.ANDROID_KEYSTORE_FILE }}
          DEVELOPER_PACKAGE_NAME: ${{ secrets.DEVELOPER_PACKAGE_NAME }}
          KEYSTORE_KEY_ALIAS: ${{ secrets.KEYSTORE_KEY_ALIAS }}
          KEYSTORE_KEY_PASSWORD: ${{ secrets.KEYSTORE_KEY_PASSWORD }}
          KEYSTORE_STORE_PASSWORD: ${{ secrets.KEYSTORE_STORE_PASSWORD }}
        with:
          lane: android beta
          
      - name: Upload artifact
        uses: actions/upload-artifact@v2
        with:
          name: android-release
          path: ./android/app/build/outputs/bundle/release/app-release.aab
          retention-days: 10

作成方法

Gitタグを作成してワークフローをトリガーする
GitHub Actionsはアプリをビルドします
FastlaneはGoogle Playのベータチャンネルにアップロードします
アプリは自動的に更新されます

ビルド時間とコスト

ビルド時間: 3-5分
プライベートリポジトリのビルドコスト: 約$0.04
オープンソースプロジェクトは無料

CI/CD設定ガイド

自動 Capacitor iOS ビルドと GitHub アクション - iOS CI/CD セットアップの完了
自動ビルドとリリースと GitHub アクション - CI/CD パイプラインの完全なチュートリアル
GitHub アクションで開発と本番ビルドを管理 - 環境管理

代替CI/CDプラットフォーム

GitLab CIでビルド - Android用のGitLab代替
CodeMagicでビルド - CodeMagicのセットアップガイド

ライブアップデートとデプロイ

Capgo Live Updates Documentation - アプリにOTA更新を追加する
CI/CD統合 with Capgo - パイプラインにライブ更新を統合する

リソース

Capacitor ActionsとGitHubを使用して、自動Capacitor Androidビルドから続けてください。

自動__CAPGO_KEEP_0__ Androidビルドと__CAPGO_KEEP_1__アクションを使用している場合 Automatic Capacitor Android build with GitHub actions __CAPGO_KEEP_0__ CI/CD Capgo CI/CD 製品ワークフローにおけるCapgo CI/CDのために Capgo ネイティブビルド製品ワークフローにおけるCapgo ネイティブビルドのために Capgo インテグレーション製品ワークフローにおけるCapgo インテグレーションのために CI/CD インテグレーション CI/CD インテグレーションの実装詳細については GitHub アクションズインテグレーション for the implementation detail in GitHub Actions Integration.

Capacitorの自動GitHubアクションでAndroidビルド