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

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

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

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

前提条件

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

GitHub のアカウントに管理者権限
Google Play Store への既存のアプリの公開と適切な署名
Android の署名キーとキーストアファイル
Google Cloud Console 项目で Play Store API が有効
適切な権限を持つサービスアカウント
GitHub Actions ワークフローの理解
Fastlane の構成の知識
パイプラインの維持とデバッグに必要な時間

Capgo Build for CI/CD by Capgo

Fastlane、Gradle ランナー、キーストア、アップロードスクリプトのメンテナンスをスキップ Capgo ビルド既存のCI/CDPipelineからAndroidネイティブビルドを実行します。

パイプラインと一緒に機能します: Capgo ビルドをGitHub Actions、GitLab CI、Jenkins、またはローカルスクリプトからGitHub の後、ウェブビルドの後にトリガーします。 npx cap sync.
CIシークレットから署名: Androidキーストア、キーアライアス、パスワード、Play ConsoleサービスアカウントJSONをCIシークレットに保持します。
ネイティブランナーのメンテナンスなし: Capgo ビルドはAndroidビルド環境を管理しているので、SDK イメージ、Gradleキャッシュの問題、またはFastlaneレーンの管理は必要ありません。
アーティファクトと提出: QAのために署名されたアーティファクトをダウンロードするか、Capgo CLI からリリースビルドを提出します。

価格

: Capgo プランは$12/月から始まります
月に約15のネイティブビルドを含むOTA更新
クレジットを通じて1分あたり追加のビルド時間が請求されます

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

マニュアルセットアップガイド

ここで行う必要があります:

GitHub アクションの価格

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

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

プライベートプロジェクトの場合、1 分あたり約 $0.008 のコストが発生します。通常、ビルド時間は 3-5 分です。

マニュアルセットアップステップ

Android キーストアを作成
Google Play サービスアカウントを設定
Fastlane を設定
GitHub のシークレットを構成
GitHub のアクションワークフローを作成

1. Android キーストアを作成

Android アプリを署名して公開するには、キーストアファイルを作成する必要があります。これは、一時的な設定です。

keytool でキーストアを生成

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

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

次の質問に答えてください

キーストアパスワード: 強力なパスワードを選択してください (必要なので) KEYSTORE_STORE_PASSWORD)
パスワード: 強力なパスワードを選択してください (これが必要になります KEYSTORE_KEY_PASSWORD)
名前、組織など: ご自身の詳細を入力してください

重要な注意事項

これらの値を安全に保存してください:
- キーストアファイルの保存場所 (例えば my-release-key.keystore)
- キーアリセイ (例えば my-key-alias) - これが必要になります KEYSTORE_KEY_ALIAS
- キーストアパスワード - これが必要になります KEYSTORE_STORE_PASSWORD
- パスワード - これが必要になります KEYSTORE_KEY_PASSWORD
キーストアファイルをバックアップしてください: アプリを公開した場合、更新できません
機密に保管してください: Git にキーストアーファイルをコミットしないでください
安全な場所に保管してください: 安全な場所に複数のバックアップを作成してください

既存のキーストアを使用する

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

ローカルマシンでアプリを最初にビルドした場所
Play Console → 設定 → アプリ署名 (Google Play App Signing を使用している場合)

2. Google Play Service Account の設定

To allow GitHub Actions to upload builds to Google Play, you need a service account.

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

Go to Google Cloud Console
新しいプロジェクトを作成または既存のプロジェクトを選択
プロジェクトIDを記録

Step 2.2: Enable Google Play Developer API

Google Cloud Consoleに移動し APIs & Services → Library
Search for “Google Play Android Developer API”
有効 Step 2.3: Service Accountを作成

__CAPGO_KEEP_0__

Go to IAM & 管理 → サービスアカウント
Click サービスアカウントの作成
詳細を入力してください:
- 名前: github-actions-uploader
- 説明:「GitHub アクション用のビルドアップロード用サービスアカウント」
Click 作成と続行
今後ロールの割り当てをスキップ (クリック続行、次のステップ完了)

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

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

ステップ 2.5: Play Console でのアクセス許可

Go to Google Play Console
Go to セットアップ → API アクセス許可
下に サービスアカウント, クリック アクセス許可を付与 サービスアカウントのために
アプリケーション許可 タブにアプリケーションを追加 アカウント許可
タブで、次の許可を付与 アプリケーション情報の表示とbulkレポートのダウンロード (読み取り専用) __CAPGO_KEEP_0__
- __CAPGO_KEEP_1__
- __CAPGO_KEEP_0__
- draftアプリを作成、編集、削除
- テストトラックにアプリをリリース
プロダクション、除外、他トラックにアプリをリリース クリック
ユーザーを招待 クリック

JSONキーを検証するステップ 2.6

ダウンロードした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": "..."
}

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

3. Fastlaneを設定する

アプリを作成 fastlane プロジェクトのルートディレクトリにフォルダを作成し、以下の内容を追加してください。 Fastfile 4. __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. Configure GitHub Secrets

ステップ 4.1: GitHub のシークレットにアクセスしてください。

Step 4.1: Access GitHub Secrets

Go to your repository on GitHub
シークレットと変数 アクション → 新しいリポジトリシークレットを作成してください。 → __CAPGO_KEEP_0__
__CAPGO_KEEP_0__ __CAPGO_KEEP_0__

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

それぞれのシークレットを 1 つずつ追加する:

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__
__CAPGO_KEEP_0__ を base64 に変換する:

macOS/Linux の場合:

base64 service_account_key.json | pbcopy

Windows (PowerShell) の場合:

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

__CAPGO_KEEP_0__ という名前の新しいシークレットを作成し、base64 の文字列をペーストする: PLAY_CONFIG_JSON __CAPGO_KEEP_0__

__CAPGO_KEEP_0__ を base64 に変換する:

macOS/Linux の場合:

Windows (PowerShell) の場合:

base64 my-release-key.keystore | pbcopy

Windows (PowerShell) で

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

__CAPGO_KEEP_0__ を作成し、 ANDROID_KEYSTORE_FILE base64 の文字列をペーストしてください

KEYSTORE_KEY_ALIAS

__CAPGO_KEEP_0__ を作成し、 my-key-alias)

KEYSTORE_KEY_PASSWORD

__CAPGO_KEEP_0__ を作成し、

KEYSTORE_STORE_PASSWORD

__CAPGO_KEEP_0__ を作成し、

DEVELOPER_PACKAGE_NAME

__CAPGO_KEEP_0__ を作成し、 com.example.app)

アプリのパッケージ名 (例えば、 android/app/build.gradle 下記の6つのシークレットを設定してください: applicationId

ステップ 4.3: 全てのシークレットを確認する

✅ PLAY_CONFIG_JSON

✅ ANDROID_KEYSTORE_FILE
✅ KEYSTORE_KEY_ALIAS
✅ KEYSTORE_KEY_PASSWORD
✅ KEYSTORE_STORE_PASSWORD
✅ DEVELOPER_PACKAGE_NAME
5. __CAPGO_KEEP_0__ Actionsワークフローを作成する

5. Create GitHub Actions Workflow

Capgoのしくみ .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

How It Works

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

ビルド時間とコスト

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

CI/CD セットアップガイド

自動Capacitor iOS ビルドとGitHub Actions - iOS CI/CD セットアップを完了する
自動ビルドとリリースとGitHub Actions - フルCI/CDパイプラインチュートリアル
開発と本番環境のビルドの管理とGitHub Actions - 環境管理

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

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

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

Capgoライブアップデートドキュメント - アプリにOTAアップデートを追加
CI/CD統合 with Capgo - パイプラインにリアルタイム更新を統合する

リソース

Capacitor アクションと自動 GitHub Android ビルドから続ける

__CAPGO_KEEP_0__ を使用している場合 自動 Capacitor Android ビルドと GitHub アクション CI/CD自動化の計画に使用し、__CAPGO_KEEP_0__ CI/CD CI/CDの製品ワークフローにCapgo CI/CD CI/CDの製品ワークフローにCapgo CI/CDの製品ワークフローにCapgoネイティブビルド Capgo Native Buildsの製品ワークフローについて Capgo インテグレーション Capgo インテグレーションの製品ワークフローについて CI/CD インテグレーション CI/CD インテグレーションの実装詳細について、そして GitHub アクションズインテグレーションの実装詳細について GitHub アクションズインテグレーション

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

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

前提条件

Capgo Build for CI/CD by Capgo

価格

マニュアルセットアップガイド

GitHub アクションの価格

マニュアルセットアップステップ

1. Android キーストアを作成

keytool でキーストアを生成

重要な注意事項

既存のキーストアを使用する

2. Google Play Service Account の設定

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

Step 2.2: Enable Google Play Developer API

__CAPGO_KEEP_0__

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

ステップ 2.5: Play Console でのアクセス許可

JSONキーを検証するステップ 2.6

3. Fastlaneを設定する

4. Configure GitHub Secrets

Step 4.1: Access GitHub Secrets

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

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__ を base64 に変換する:

KEYSTORE_KEY_ALIAS

KEYSTORE_KEY_PASSWORD

KEYSTORE_STORE_PASSWORD

DEVELOPER_PACKAGE_NAME

ステップ 4.3: 全てのシークレットを確認する

5. Create GitHub Actions Workflow

How It Works

ビルド時間とコスト

関連記事

CI/CD セットアップ ガイド

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

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

リソース

Capacitor アクションと自動 GitHub Android ビルドから続ける

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

CI/CD セットアップガイド