Skip to main content
Capgoのロゴ
CI/CD

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

5分でAndroid Capacitor アプリのCI/CDパイプラインをfastlaneとGitHub Actionsで設定する方法

マーティン・ドナディュー

マーティン・ドナディュー

コンテンツマーケター
自動Capacitor Android ビルドとGitHub アクション

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

今後は__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 CI/CD用ビルドに Capgo を使用してください。

Fastlane、Gradleランナー、キーストア、アップロードスクリプトのメンテナンスをスキップしてください。 Capgo ビルド 既存のCI/CDパイプラインから署名済みネイティブAndroidビルドを実行します。

  • パイプラインと連携: Capgo ビルドを GitHub アクション、GitLab CI、Jenkins、またはローカルスクリプトから Capgo の後、Webビルドの後にトリガーしてください。 npx cap sync.
  • CIシークレットから署名: Androidのキーストア、キー・アリセイア、パスワード、PlayコンソールサービスアカウントのJSONをCIシークレットに保持してください。
  • ネイティブランナーのメンテナンスなし: Capgo ビルドはAndroidビルド環境を管理しているので、SDK イメージ、Gradleキャッシュの問題、またはFastlaneのレーンの管理をしなくて済みます。
  • アーティファクトと提出: QA用に署名済みアーティファクトをダウンロードしたり、Capgo CLI を介してリリースビルドを提出してください。

料金

  • Capgo プランは 1 か月あたり 12 ドルから始まります
  • __CAPGO_KEEP_0__ プランには、1 か月あたり約 15 回のネイティブ ビルドが含まれます
  • __CAPGO_KEEP_0__ プランの追加ビルド分数は、分単位でクレジットを通じて請求されます

Capgo ビルドを CI/CD にセットアップする

手動セットアップガイド

ここが始まります:

GitHub アクションの料金

GitHub アクションの料金

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

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

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

手動セットアップ手順

  1. Androidキーストアを作成する
  2. Google Play Serviceアカウントをセットアップする
  3. Fastlaneをセットアップする
  4. GitHubシークレットを構成する
  5. GitHubアクションワークフローを作成する

1. Androidキーストアを作成する

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

keytoolでキーストアを生成する

ターミナルで次のコマンドを実行してください:

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

次の質問に答えていただく必要があります:

  • Keystore password__CAPGO_KEEP_0__ KEYSTORE_STORE_PASSWORD)
  • Key password__CAPGO_KEEP_0__ KEYSTORE_KEY_PASSWORD)
  • Your name, organization, etc.__CAPGO_KEEP_0__

Important Notes

  • __CAPGO_KEEP_0__:

    • Keystore file location (e.g., my-release-key.keystore)
    • Key alias (e.g., my-key-alias__CAPGO_KEEP_0__ KEYSTORE_KEY_ALIAS
    • Keystore password - __CAPGO_KEEP_0__ KEYSTORE_STORE_PASSWORD
    • パスワード - これが必要なので KEYSTORE_KEY_PASSWORD

  • キーストアファイルをバックアップしてください: アプリを公開した場合に失うと、アプリを更新できなくなります

  • 秘密にしましょう: これをgitにコミットしてはいけません

  • 安全な場所に複数のバックアップをしましょう代替: 既存のキーストアを使用する

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

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

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

Alternative: Use Existing Keystore

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

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

  1. Google Cloud Consoleに移動する 新しいプロジェクトを作成するか、既存のプロジェクトを選択する
  2. プロジェクト ID をメモする
  3. ステップ 2.2: Google Play Developer __CAPGO_KEEP_0__ を有効にする

Step 2.2: Enable Google Play Developer API

  1. APIs & Services ライブラリ → 「Google Play Android Developer __CAPGO_KEEP_0__」を検索する
  2. 検索結果から「Google Play Android Developer API」をクリックする
  3. Step 2.3: Create Service Account 有効化

Step 2.3: Service Account の作成

  1. Go to IAM & Admin → Service Accounts
  2. Click Service Account の作成
  3. Enter details:
    • Name: github-actions-uploader
    • 説明: “GitHub のアクションでビルドをアップロードするためのサービス アカウント”
  4. Click Create and Continue
  5. Skip ロール割り当ては今回はスキップ (クリック 続行、次に 完了)

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

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

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

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

ステップ 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 シークレット設定のベース64 変換ステップで変換します。

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

  1. Go to your repository on GitHub
  2. シークレットと変数 アクション → 4. __CAPGO_KEEP_0__シークレットを設定する → ステップ 4.1: __CAPGO_KEEP_0__シークレットにアクセスする
  3. クリック 新しいリポジトリのシークレット

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

これらのシークレットを一つずつ追加してください。

__CAPGO_KEEP_0__

  1. __CAPGO_KEEP_1__のサービス アカウント JSON ファイルをダウンロードしたステップ 2.4
  2. __CAPGO_KEEP_2__に変換する

macOS/Linux:

base64 service_account_key.json | pbcopy

Windows (PowerShell):

[Convert]::ToBase64String([IO.File]::ReadAllBytes("service_account_key.json")) | Set-Clipboard
  1. __CAPGO_KEEP_3__と名付けられた新しいシークレットを作成し PLAY_CONFIG_JSON __CAPGO_KEEP_4__をペーストする

__CAPGO_KEEP_5__

  1. __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
  1. __CAPGO_KEEP_1__という新しいシークレットを作成し、Base64の文字列をペーストしてください。 ANDROID_KEYSTORE_FILE KEYSTORE_KEY_ALIAS

キーストアのキー・アライアスを作成するシークレットを作成します。例えば、

KEYSTORE_KEY_PASSWORD my-key-alias)

キーストアのキー・パスワードを作成するシークレットを作成します。

KEYSTORE_STORE_PASSWORD

キーストアのストア・パスワードを作成するシークレットを作成します。

DEVELOPER_PACKAGE_NAME

__CAPGO_KEEP_2__

アプリのパッケージ名 (例えば、 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 ワークフローを作成する

作成 .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

機能のしくみ

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

ビルド時間とコスト

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

CI/CD設定ガイド

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

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

Resources

Capacitor ActionsとFastlaneを組み合わせて、自動Capacitor AndroidビルドからGitHubアクションで進めます。

自動__CAPGO_KEEP_0__ Androidビルドと__CAPGO_KEEP_1__アクションを使用している場合 Automatic Capacitor Android build with GitHub actions __CAPGO_KEEP_0__ Capgo CI/CD 製品ワークフローにおけるCapgo CI/CDの Capgoネイティブビルド 製品ワークフローにおけるCapgoネイティブビルドの Capgo統合 製品ワークフローにおけるCapgo統合の CI/CD統合 CI/CD統合の実装詳細については GitHubアクション統合 CI/CD統合の実装詳細についてはGitHubアクション統合の

Capacitorアプリのライブアップデート

ウェブ層のバグがライブの場合、Capgoを通して修正を配信するのではなく、数日間待ってアプリストアの承認を待つのではなく、ユーザーはバックグラウンドでアップデートを受け取り、ネイティブの変更は通常のレビュー経路で進めます。

今すぐ始めましょう

ブログの最新記事

Capgoは、プロフェッショナルなモバイルアプリを作成するために必要な最良の洞察を提供します。

Capacitorアプリで2方向のコミュニケーション
開発 モバイル +1
2025年4月26日

Capacitor アプリの2方向コミュニケーション

OTA更新の5つの一般的なミスを避ける
開発 セキュリティ +1
2025年4月13日

モバイルアプリのライブ更新の5つの一般的なミスを避ける

モバイルアプリのライブ更新のセキュリティベストプラクティス
開発 モバイル +1
2025年1月14日

モバイルアプリのライブアップデートのための5つのセキュリティベストプラクティス

ブログからすべてを参照