Android ビルド

インストール

Build and submit Android apps to Google Play Store using Capgo’s dedicated infrastructure.

学ぶこと

Capgo Native Buildを使用してアプリをアップロードする方法を学びます。
Capgo Native Buildの設定方法を学びます。

前提条件

Google Developerアカウントが有効である必要があります。
Android Studioがインストールされている必要があります。
Android Studioでアプリを正常にビルドできる必要があります。

Capgoの自動設定では、Androidの署名資格情報（キーストア + Google Playサービスアカウント）を作成および設定してくれます。これが推奨の方法です。

bunx @capgo/cli@latest build init --platform android

Capgoの詳細設定を理解したい、または自分で資格情報を設定したい場合は、以下の手順を参照してください。

最初の手動ビルド

Capgoを使用したビルドを始める前に、まずCapgoを設定し、手動でAndroidのビルドを実行してください。手動ビルドのメリットは以下です:

資格情報を後でCapgoで使用する準備ができます
Play Store Consoleに記録を作成します。

Android Studioでアプリを手動で作成します。

Capgoでアプリをビルドする前に、Android Studioでアプリを手動で作成する必要があります。

Android Studioを開きます。

実行 bunx cap open android Android Studioプロジェクトを開きます。
クリック Build -> Generate Signed App Bundles / APKs
選択 Android App Bundle クリック Next

Keystoreの作成

現在、Keystoreファイルが欠けているようです。このファイルは、アプリを署名するために使用され、Googleにアプリを開発したのは自分であることを知らせるために使用されます。 Keystoreファイルを生成するには、Android StudioのGUIメソッドを使用します。コマンドラインで行う方法もありますが、このチュートリアルでは説明しません。

クリック Create new
Key Store pathを入力

これ 保存しておく必要があります - 後で使用します __CAPGO_KEEP_0__
Key Store パスワードを設定

Key Store と Key Alias のパスワードを同じにすることをお勧めします。

- 後で使用するため 残りのフォームを埋めてください Key Alias をそのままにしておいてください (key0)
__CAPGO_KEEP_0__
1. __CAPGO_KEEP_1__
2. 証明書の詳細を入力してください。私が偽の詳細を入力した場合、自分の詳細を入力してください。
クリックしてください OK

手動ビルドの完了

キーストアの詳細が正しく入力されていることを確認し、クリックしてください。 Next
ビルドバリアントを選択し、クリックしてください。 release Android Studioでリリースビルドバリアントを選択してください。 Create
手動ビルドの完了
1. このポップアップは、ビルドが成功したことを示しています。
2. ボタンをクリックすると locate ファイルエクスプローラーが開き、ビルドが表示されるはずです。
ファイルエクスプローラーでビルドが表示できることを確認してください。

アプリをPlay Store Consoleで作成する

Google Play Consoleに移動してください。正しい開発者アカウントを選択してください。
Google Play Consoleで正しい開発者アカウントを選択してください。
クリックしてください Create app
アプリ名と言語を選択
アプリのカテゴリと料金を選択
利用規約を承知

利用規約を読んでから承知してください
クリックしてください Create

内部テストグループの作成

アプリを作成したので、内部テストグループを作成できます。Play Store でアプリを全員に公開しないので、内部テストグループを作成する必要があります。

Go to internal testing クリック Test and release -> Testing -> Internal testing
クリックしてください Testers
クリックしてください Create email list
メールリストの名前を付けます
テスト者のメールアドレスを追加
押してください Enter とクリックしてください Save
クリックしてください Create group
新しいリストが選択されていることを確認して、クリックしてください Save

内部テストグループにアプリをアップロード

内部テストグループを作成したので、内部テストグループにアプリをアップロードできます

移動してください Test and release -> Testing -> Internal testing
クリックしてください Releases ボタン
クリックしてください Create new release
クリックしてください Upload
AABファイルを選択

AABファイルを手動でAndroid Studioでビルドしたものを選択してください。 Capgo ビルドで使用するキーストアと同じものでない場合、Capgo ネイティブビルドは失敗します。
AABファイルのアップロードを待ってください
クリックしてください Next
エラーを修正する

このエラーについては、個人的にはこの段階ではまだ理解できていない

電話番号の確認がまだされていないためです。確認してからこのチュートリアルを続けます。
クリックしてください Save and publish このアプリを内部テストグループに公開します
公開を確認する
アプリが公開されていることを確認する
一時的なアプリ名を取得する

内部テストグループへの招待を受け入れる

内部テストグループにアプリをアップロードした後、内部テストグループへの招待を受け入れることができます。

へ Test and release -> Testing -> Internal testing
へ Testers
へ Copy link
電話にリンクを送信し、ブラウザで開き、 Accept
招待が受け入れられていることを確認し、「Google Play Storeでダウンロード」をクリックしてください。
アプリをインストールしてください。
1. Android Studioを使用してアプリをインストールしたことがある場合は、「ボタン」をクリックしてください。 uninstall ボタン
2. ボタン install Google Play Consoleでアプリをインストールしてください。
3. Play Storeの内部テストからアプリが正常にダウンロードされたことを確認します。
アプリがPlay Storeに表示されない場合は、Play Storeで正しいアカウントが選択されていることを確認してください。

Capgo Androidネイティブビルドの設定

Capgo Androidネイティブビルドのセットアップを始める準備ができました。 축하합니다 🎉!

要件	フラグ	説明	必須
キーストアファイル	`--keystore <path>`	キーストアファイルのパス `.jks`/`.keystore` APK/AABの署名に使用されるファイル。	はい
キーストア内のキーのエイリアス	`--keystore-alias <alias>`	はい	キーのパスワード
下の注釈を参照してください	`--keystore-key-password <password>`	キーストアのパスワード	下の注釈を参照してください
Google Playサービスアカウント	`--keystore-store-password <password>`	Yes	Keystore alias
Alias name of the key inside the keystore.	`--play-config <path>`	Play Storeアップロード用のJSONサービスアカウントファイル。	はい

bunx @capgo/cli@latest build credentials save --platform android \
  --keystore ./path/to/keystore.jks \
  --keystore-alias "your-alias" \
  --keystore-key-password "key-password" \
  --keystore-store-password "store-password" \
  --play-config ./play-store-service-account.json

キーストア、キーストアパスワード、キーストアキーパスワード、キーストアエイリアス

手動ビルドの指示に従った場合または、キーストアをすでに生成しているはずです。キーストアを生成する手順に従っていない場合は、手順に従ってキーストアを生成してください。

Google Playサービスアカウント

Google Playサービスアカウントの生成は、手動で複雑なプロセスです。しかし、アプリをGoogle Playにアップロードするには必要です。次のことをお忘れなくてください:

あなたは 必要です 開発者アカウントののオーナーでなければなりません。そうでないと、サービスアカウントを設定できません。Google Cloudプロジェクトを作成する必要があります (Google Playアカウントとは別のもの)
では始めましょう。

ここに移動してください

__CAPGO_KEEP_0__ Google Cloud Console
プロジェクトセレクターをクリックしてください
既存のプロジェクトがあれば選択してください。なければ新しいプロジェクトを作成してください:

以下のスクリーンショットは例です。実際のプロジェクト名を使用してください。
1. クリックしてください New project
2. プロジェクト名を入力してクリックしてください Create
3. 正しいプロジェクトに移動していることを確認してください
検索バーにクリックして service accounts を検索して
にクリックして Create service account
サービスアカウントのフォームを入力して Done
1. サービスアカウントの名前を Capgo Native Build Service Account
2. サービスアカウントのIDを capgo-native-build-service-acc
3. 説明を入力する必要はありませんが、以下のように入力することをお勧めします Allows Capgo Native Build to build and submit the app to the Play Store
新しく作成したサービスアカウントにクリックしてくださいリストに新しく作成したサービスアカウントが表示されます。クリックしてください

このメールアドレスをコピーしておいて、後で必要になります。
Google Consoleの Keys タブ
キー Add Key Google Consoleでキーを追加して新しいキーを作成します Create new key
キー JSON キーと Create

クリックすると Create 新しいキーが作成され、JSONファイルがローカルマシンにダウンロードされます。
JSONファイルを安全な場所に保存する必要があります。それは 後で使用されます。 JSONファイルをダウンロードする JSONファイルは自動的にダウンロードされるはずです。ウィンドウを閉じるには
Google Consoleからキーをダウンロードする close Play Store __CAPGO_KEEP_0__にサービスアカウントへのアクセスを許可する

Granting Play Store API access to the service account

The newly created service account does not yet have access to the Play Store API. To grant it, head to the Play Store Console.

Go to Google Play Console
正しい開発者アカウントを選択
Click on Users and permissions
Click on Invite new users
サービスアカウントのメールアドレスをコピー
Go to Account permissions と
- In App permissions、
- In Releases、 Create, edit, and roll out releases.
- を有効にします。
- Play App Signingを使用している場合は、関連する署名許可を有効にします。 Admin 不明な場合は
Google Play Console から許可を付与する Invite user
招待を確認する
ユーザーが招待されたことを確認する

クレデンシャルを保存する

クレデンシャルを保存し、最初のビルドを実行する準備ができました。クレデンシャルを保存するには、以下のコマンドを使用してください:

bunx @capgo/cli@latest build credentials save --platform android \
  --keystore ./path/to/keystore.jks \
  --keystore-alias "your-alias" \
  --keystore-key-password "key-password" \
  --keystore-store-password "store-password" \
  --play-config ./play-store-service-account.json

CI/CD設定 (GitHub Actions)

あらかじめ Keystore, keystore password, keystore key password, keystore alias と Google Playサービスアカウントこのセクションでは、CI/CD用にすでに必要なものはすべて揃っています。このセクションでは、GitHub Actionsシークレットと環境変数として値を渡す方法について説明します。

1) 1行のbase64に変換する

# Android keystore (.jks or .keystore)
base64 -i ./path/to/keystore.jks | tr -d '\n' > keystore_base64.txt

# Google Play service account JSON
base64 -i ./play-store-service-account.json | tr -d '\n' > play_config_base64.txt

2) リポジトリシークレットを作成する

In GitHub > Repository > Settings > Secrets and variables > Actions, 付加:

シークレット名	値
`CAPGO_TOKEN`	あなたの Capgo API トークン
`APP_ID`	あなたの Capgo アプリID (例: `com.example.app`)
`ANDROID_KEYSTORE_FILE`	内容 `keystore_base64.txt`
`KEYSTORE_KEY_ALIAS`	キーストアのエイリアスキーストア、キーストアのパスワード、キーストアのキーパスワード、キーストアのエイリアス
`KEYSTORE_KEY_PASSWORD`	キーストアのキーパスワード
`KEYSTORE_STORE_PASSWORD`	Keystore store password
`PLAY_CONFIG_JSON`	Content of `play_config_base64.txt`

3) Use env vars in your GitHub Actions workflow

name: Android Cloud Build

on:
  workflow_dispatch:
  push:
    branches: [main]

jobs:
  android-build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
        with:
          bun-version: latest
      - name: Request Android build with Capgo
        run: bunx @capgo/cli@latest build request ${{ secrets.APP_ID }} --platform android
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          ANDROID_KEYSTORE_FILE: ${{ secrets.ANDROID_KEYSTORE_FILE }}
          KEYSTORE_KEY_ALIAS: ${{ secrets.KEYSTORE_KEY_ALIAS }}
          KEYSTORE_KEY_PASSWORD: ${{ secrets.KEYSTORE_KEY_PASSWORD }}
          KEYSTORE_STORE_PASSWORD: ${{ secrets.KEYSTORE_STORE_PASSWORD }}
          PLAY_CONFIG_JSON: ${{ secrets.PLAY_CONFIG_JSON }}

ビルドを実行する

おめでとうございます！最初のビルドを実行する準備ができました。

実行:

bunx @capgo/cli@latest build request com.example.app --platform android

そして、これがビルドプロセスを開始します。

プレイリリースをレビューに提出する

デフォルトでは、Android リリースビルドは Google Play にアップロードされ、プレイコンソールでリリースを完了するまで非アクティブになります。CI リリースがプレイリリースを自動的に提出するようにするには、 --submit-to-store-review リリースビルドとともに

npx @capgo/cli@latest build request com.example.app \
  --platform android \
  --build-mode release \
  --submit-to-store-review \
  --android-track production \
  --store-release-name "1.2.3" \
  --store-release-notes "General improvements" \
  --store-release-notes-locale "en-US=General improvements" \
  --store-release-notes-locale "nl-NL=Algemene verbeteringen" \
  --store-release-notes-locale "fr-FR=Ameliorations generales"

通常のアップロードパスと同じGoogle Playサービスアカウントの設定が必要です（CIまたはローカルに保存されたAndroidのクレデンシャルを使用します）PLAY_CONFIG_JSON CIまたはローカルに保存されたAndroidのクレデンシャルを使用します --store-release-name Google Play version_name. --store-release-notes Playのフォールバックチャンネルログです。各エントリは、__CAPGO_KEEP_0__がPlayのリリースを送信するローカライズされたPlayチャンネルログを書き出します。 --store-release-notes-locale "locale=notes" entry writes a localized Play changelog for that locale. Capgo sends the Play release as completed プレイコンソールでマネージドパブリッシュが有効になっている場合、Googleは承認後もあなたの手動で公開を待つことができます。 --android-release-statusAndroidビルドから続けて