メインコンテンツにジャンプ
Capgoロゴ
CI/CD

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

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

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

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

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

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

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

前提条件

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

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

Capgo Build for CI/CD by Capgo

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

  • __CAPGO_KEEP_0__ Buildはパイプラインと連携します。: Capgo BuildをGitHub Actions、GitLab CI、Jenkins、またはローカルスクリプトからトリガーして、ウェブビルド後に実行します。 npx cap sync.
  • : CIシークレットから署名します。: Androidのキーストア、キーアリセイ、パスワード、Play ConsoleサービスアカウントJSONをCIシークレットに保持します。
  • : __CAPGO_KEEP_0__ BuildはAndroidビルド環境を維持しているので、__CAPGO_KEEP_1__イメージ、Gradleキャッシュの問題、またはFastlaneのレーンの管理は必要ありません。: Capgo Buildから署名されたアーティファクトをダウンロードしてQAに使用、またはCapgo SDKを通じてリリースビルドを提出します。
  • __CAPGO_KEEP_0__ Build for CI/CD by __CAPGO_KEEP_1__: Download signed artifacts for QA or submit release builds through the Capgo CLI.

料金

  • Capgo プランは 1 か月あたり 12 ドルから始まります
  • __CAPGO_KEEP_0__ では、1 か月あたり約 15 回のネイティブ ビルドと OTA 更新が含まれます
  • __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 サービス アカウントを設定する
  3. Fastlane を設定する
  4. GitHub シークレットを構成する
  5. GitHub アクション ワークフローを作成する

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

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

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 を設定してください

__CAPGO_KEEP_0__

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

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

  1. 以下のサイトにアクセスしてください Google Cloud コンソール
  2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択する
  3. プロジェクト ID をメモしてください

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

  1. Google Cloud コンソールにアクセスし、 APIs & Services → ライブラリ
  2. 「Google Play Android Developer API」と検索する
  3. 検索結果から「Google Play Android Developer __CAPGO_KEEP_0__」をクリックする 有効化

ステップ 2.3: サービス アカウントの作成

  1. Go to IAM & Admin → サービス アカウント
  2. Click サービス アカウントの作成
  3. 詳細を入力してください:
    • 名前: github-actions-uploader
    • 説明:「GitHub のビルドアップロードアクション用サービス アカウント」
  4. Click 作成して続行
  5. 今回は役割の割り当てをスキップします (クリック 続行, その後 完了)

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

  1. 新しく作成したサービス アカウントにクリック
  2. ここに キーセクション タブ
  3. クリック キーを追加 → 新しいキーを作成
  4. 選択 JSON形式 JSON形式でファイルをダウンロードするので、安全に保存しておいてください
  5. ダウンロードしたJSONファイルは後で必要になるため、安全に保存しておいてください Step 2.5: Google Play Consoleでアクセス権を付与する
  6. Google Play Consoleに移動 Google Play Consoleに移動Google Play Consoleに移動してください

Google Play Consoleに移動してください

  1. Step 2.5: Google Play Consoleでアクセス権を付与する Google Play Consoleに移動してください
  2. Google Play Consoleに移動してください セットアップ → API アクセス
  3. 以下 サービス アカウント, クリック アクセスを許可 サービス アカウントのために
  4. アプリケーション アプリケーション アカウント
  5. アカウント アカウントのパーミッション 許可を付与するタブ:
    • アプリの情報を表示し、バulk レポートをダウンロード (読み取り専用)
    • ドラフト アプリを作成、編集、削除
    • テスト トラックにアプリをリリース
    • プロダクション、除外、他トラックにアプリをリリース
  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をセットアップ

Create a 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

CapgoでキーストアとサービスアカウントJSONを取得したので、安全にGitHubに保存する必要があります。

Step 4.1: GitHubシークレットにアクセス

Step 4.1: Access GitHub Secrets

  1. Go to your repository on GitHub
  2. Actions Click → Settings → Secrets and variables
  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. Base64に変換されたキーストアを入力してください:

macOS/Linuxの場合:

base64 my-release-key.keystore | pbcopy

Windows (PowerShell)の場合:

[Convert]::ToBase64String([IO.File]::ReadAllBytes("my-release-key.keystore")) | Set-Clipboard
  1. キー名を入力してください ANDROID_KEYSTORE_FILE キー名を入力してください

__CAPGO_KEEP_0__

__CAPGO_KEEP_1__ my-key-alias)

__CAPGO_KEEP_2__

__CAPGO_KEEP_3__

__CAPGO_KEEP_4__

__CAPGO_KEEP_5__

__CAPGO_KEEP_6__

アプリのパッケージ名 (例、 com.example.app)

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

Step 4.3: すべてのシークレットを検証する

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
  • オープンソースプロジェクトは無料

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

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

ライブ更新とデプロイ

Resources

Capacitor アプリのリアルタイム更新

Capgo アプリの場合、ウェブ層のバグが生じた場合、修正を Capgo を通じて配信し、アプリストアの承認待ちの日数を待たずに修正を配信することができます。ユーザーはバックグラウンドで更新を受け取り、ネイティブの変更は通常のレビュー経路を通じて残ります。

今すぐ始めましょう

ブログの最新記事

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

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

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

5つのOTAアップデートのミスを避ける方法
開発、セキュリティ、更新
2025年4月13日

5つのOTAアップデートのミスを避ける方法

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

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

ブログからすべてを参照