アンドロイドビルド

Capgoの専用インフラでGoogle Play StoreにAndroidアプリをビルドして提出します。

学ぶこと

• Capgo Native ビルドを使用してアプリをアップロードする方法を学びます
• Capgo Native ビルドのクレデンシャルを設定する方法を学びます

前提条件

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

注記

このチュートリアルでは、以下のアプリを使用します: https://github.com/Cap-go/capgo-native-build-tutorial-app

推奨: 自動化のオンボーディング

手動でこれらの作業を行う必要はありません。Capgoのオンボーディングは、Androidの署名資格情報（キーストア + Google Playサービスアカウント）を作成および構成します。これは推奨されるパスです。

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

この下の手動ウォークスルーは、自分で資格情報を設定したい人や、Capgoの内部動作を完全に理解したい人向けです。

最初の手動ビルド

Capgoを使用してアプリをビルドする前に、まずアプリを手動でセットアップし、最初のAndroidビルドを行う必要があります。 手動ビルドを行うことで、次の利点があります。

• 後でCapgoでビルドするために資格情報を準備する
• Play Store Consoleに記録を作成する

Android Studioを使用してアプリを手動でビルドする

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

1. Android Studioを開く

   実行 bunx cap open android Android Studioのプロジェクトを開く

2. クリック Build -> Generate Signed App Bundles / APKs

3. 選択 Android App Bundle クリック Next

キーストアを作成する

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

1. クリック Create new

2. キーストアのパスを入力

   この

   保存しておいてください - 以降に使用します キーストアのパスワードを設定

3. Android Studio でキーストアのパスワードを設定

   Note

   I recommend using the same password for the Key Store and the Key Alias.

   Caution

   This IS TO BE SAVED - it will be used later

4. Fill the rest of the form

   1. Keep the Key Alias as is (key0)
   2. Fill the certificate details. I have filled it with fake details, but you should fill it with your own details.

   

5. Click on OK

手動ビルドの完了

1. キーストアの詳細がすべて正しく入力されていることを確認し、クリック Next

2. ビルド release リリースビルドを選択し、クリック Create

3. ビルドが成功すると、以下の画面が表示される

   1. ビルドが成功したことを示すポップアップ
   2. Click on the locate button - にはファイルエクスプローラーが開き、ビルドが表示されるはずです。

4. Make sure you can see the build in the file explorer

Creating the app on the Play Store Console

1. Go to Google Play Console

2. Select the correct developer account

3. Click on Create app

4. __CAPGO_KEEP_0__を選択し、言語を選択してください

5. __CAPGO_KEEP_0__のカテゴリを選択し、有料か無料かを選択してください

6. 利用規約と条件を承知する

   注意

   利用規約と条件を読んで承知することの重要性を理解してください。

7. __CAPGO_KEEP_0__ Create

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

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

注意

内部テストは、実際のリリース前にPlayで配布するビルドをスモークテストする最速の方法です。

開発者アカウントが2023年11月13日以降に作成された個人アカウントの場合、内部テストは 閉鎖テストの要件を置き換えません。生産アクセスには、少なくとも12人のオプティンインテスターが14日連続で閉鎖テストに参加する必要があります。 Google Play Consoleに移動

1. 「内部テスト」にクリック internal testing Google Play Consoleの内部テストに移動 Test and release -> Testing -> Internal testing

   

2. protectedTokens Testers

3. Click on Create email list

4. メールリストの名前

5. テスターのメールアドレスを追加

6. Enter を押して Enter と Save

7. Click on Create group

8. 新しいリストが選択されていることを確認し、 Save

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

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

1. をクリック Test and release -> Testing -> Internal testing

2. ボタン Releases Google Play Consoleのリリース

3. Google Play Consoleの新しいリリースを作成 Create new release

4. クリックしてください Upload

5. AABファイルを選択してください

   注意

   CapgoでAndroid Studioで手動でビルドしたAABファイルを選択してください。Capgoネイティブビルドが失敗するのは、Capgoで使用したキーストアと同じキーストアを使用していない場合です。

6. AABファイルのアップロードを待ってください

7. クリックしてください Next

8. エラーを修正してください

   個人的には、この段階でエラーが見えます

   

   これは、電話番号を検証していないためです。電話番号を検証し、チュートリアルを続行します。

9. クリックしてください Save and publish このアプリを内部テストグループに公開します。

10. 公開を確認

11. アプリが公開されていることを確認してください

12. 一時的なアプリ名を取得

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

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

1. Go to Test and release -> Testing -> Internal testing

2. Click on Testers

3. Click on Copy link

4. 電話にリンクを送信し、ブラウザで開き、 Accept

5. 招待が受け入れられたことを確認し、「Play Storeでダウンロードする」にクリック

6. Install the app

   1. If you had installed the app before using Android Studio, click on the uninstall button
   2. Click on the install button
   3. Open the app and confirm it has downloaded successfully

   Caution

   Play Storeにアプリが表示されない場合は、Play Storeで正しいアカウントが選択されていることを確認してください。

Capgo Native Build (Android)の設定

Capgo Native Buildのセットアップを開始する準備が整いました。おめでとうございます！

必要条件	フラグ	説明	必須
署名用のAPK/AABファイル	--keystore <path>	署名用のAPK/AABファイルのパス .jks/.keystore ファイル名	ファイルあり
__CAPGO_KEEP_0__	--keystore-alias <alias>	__CAPGO_KEEP_1__	__CAPGO_KEEP_2__
__CAPGO_KEEP_3__	--keystore-key-password <password>	__CAPGO_KEEP_4__	__CAPGO_KEEP_5__
__CAPGO_KEEP_6__	--keystore-store-password <password>	__CAPGO_KEEP_7__	__CAPGO_KEEP_8__
__CAPGO_KEEP_9__	--play-config <path>	__CAPGO_KEEP_10__	__CAPGO_KEEP_11__

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

注意

キーとストアのパスワードが同じ場合は、1つだけを提供してください。 --keystore-key-password または --keystore-store-password.

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

手順に従った場合に限り、キーストアがすでに生成されているはずです。 手順に従っていない場合は、キーストアを生成するために手順に従ってください。 Google Play サービス アカウントGoogle Play サービス アカウント

Google Play サービス アカウント

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

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

Google Cloud Consoleに移動してください。

1. プロジェクトセレクターをクリックしてください。 __CAPGO_KEEP_0__

2. __CAPGO_KEEP_1__

3. 既にプロジェクトが存在する場合はそれを選択してください。そうでない場合は新しいプロジェクトを作成してください。

   注意

   以下のスクリーンショットは例です。実際のプロジェクト名を使用してください。

   1. Google Consoleで New project
   2. プロジェクト名を入力し、 Create
   3. 正しいプロジェクトが選択されていることを確認してください。

4. 検索バーにクリックしてください。 service accounts をクリックしてください

5. をクリックしてください Create service account

6. サービスアカウントのフォームを入力し、をクリックしてください 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

   

7. 新しく作成したサービスアカウントをクリック リストに新しく作成したサービスアカウントが表示されます。をクリックしてください

   注意

   このメールアドレスをコピーしておいてください、後で必要になります。

8. Click on the Keys タブ

9. キー Add Key タブ Create new key

10. Google Consoleの JSON キー Create

    注意

    クリックすると Create __CAPGO_KEEP_0__を作成し、JSONファイルをローカルマシンにダウンロードします。

    __CAPGO_KEEP_0__を安全な場所に保存する必要があります。後で使用するためです。 WILL __CAPGO_KEEP_0__は後で使用するためです。

11. JSONファイルをダウンロード JSONファイルは自動的にダウンロードされるはずです。ここをクリックしてウィンドウを閉じることができます。 close Google Consoleダウンロードキー

「Play Store APIにサービスアカウントへのアクセスを許可する」のセクション

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

1. Go to Google Play Console
2. Select the correct developer account
3. Click on Users and permissions
4. Click on Invite new users
5. Copy the email address of the service account
6. Go to Account permissions and grant the minimum required permissions:
   • アプリにアクセス権を付与します。 App permissions__CAPGO_KEEP_0__
   • アプリにアクセス権を付与します。 Releases__CAPGO_KEEP_1__ Create, edit, and roll out releases.
   • Play App Signingを使用するワークフローがある場合、関連する署名許可を有効にします。
   • __CAPGO_KEEP_2__ Admin 不明な場合は、セットアップのみに制限し、後で許可を削減することをお勧めします。
7. Google Play Consoleで許可を付与します。 Invite user
8. Google Play Consoleでユーザーを招待します。
9. ユーザーが招待されたことを確認する

クレデンシャルを保存

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

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)

すでに完了している場合 キーストア、キーストアパスワード、キーストアキー パスワード、キーストアエイリアス と Google Play サービス アカウント、CI/CD用に必要なものはすでに揃っています。このセクションでは、GitHub Actionsシークレットと環境変数として値を渡す方法について説明します。

1) 1行ベース64に変換する

# 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

ヒント

GitHub シークレットは1行の値でなければなりません。 tr -d '\n' ベース64出力から改行を削除します。

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

In: GitHub > Repository > Settings > Secrets and variables > Actions, add:

Secret name:	Value:
CAPGO_TOKEN	Your Capgo API token:
APP_ID	Your Capgo app ID (example: ): com.example.app)
ANDROID_KEYSTORE_FILE	Content of: keystore_base64.txt
KEYSTORE_KEY_ALIAS	Keystore alias from: Keystore, keystore password, keystore key password, keystore alias:
KEYSTORE_KEY_PASSWORD	Keystore key password:
KEYSTORE_STORE_PASSWORD	Keystore store password:
PLAY_CONFIG_JSON	Content of: play_config_base64.txt

注意

キーとストアのパスワードが同じ場合は、1つだけ提供できます。 KEYSTORE_KEY_PASSWORD または KEYSTORE_STORE_PASSWORD.

3) GitHub Actions ワークフローで環境変数を使用する

github/workflows/android-build.yml

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 }}

ヒント

この設定では、CIは環境変数のみを使用してクレデンシャルを送信します。署名ファイルをコミットする必要もありません。また、ワークフロー アーティファクトとしてアップロードする必要もありません。

ビルドを実行

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

Run:

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

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

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

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

npx @capgo/cli@latest build request com.example.app \
  --platform android \
  --build-mode release \
  --submit-to-store-review \
  --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サービスアカウントの設定は、通常のアップロードパスと同じ必要です (PLAY_CONFIG_JSON CIまたはローカルに保存されたAndroidのクレデンシャルを使用します。 --store-release-name Google Playのリリース名として使用されます。 --store-release-notes Playのフォールバック変更履歴であり、各 --store-release-notes-locale "locale=notes" エントリはローカライズされたPlayの変更履歴をそのロケールに書き出します。 Capgo はPlayのリリースを送信します。 completed承認後、Googleはまだ手動で公開を待つことができます。Managed PublishingがPlay Consoleで有効になっている場合。

Android Buildsから続ける

Android Builds CI/CDの自動化を計画する場合、Android Buildsを使用している場合、__CAPGO_KEEP_0__ CI/CDと接続します。 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.