Androidビルド

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

学びます

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

前提条件

• 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がどのように動作するか完全に理解したい人向けです。

__CAPGO_KEEP_0__の最初の手動ビルド

Capgoを使用してアプリをビルドする前に、まずCapgoを設定し、手動でAndroidビルドを行う必要があります。 手動ビルドを行うことで得られるメリットは以下のとおりです:

• Capgoの後の設定用のクレデンシャルを用意する
• __CAPGO_KEEP_0__のためのPlay Store Consoleのレコードを作成する

__CAPGO_KEEP_0__の手動ビルド

Capgoを使用してアプリをビルドする前に、まずAndroid Studioを使用してアプリを手動でビルドする必要があります。

1. Android Studioを開く

   実行 bunx cap open android __CAPGO_KEEP_0__を実行してAndroid Studioプロジェクトを開きます。

2. __CAPGO_KEEP_1__をクリックして Build -> Generate Signed App Bundles / APKs

3. __CAPGO_KEEP_2__を選択して Android App Bundle __CAPGO_KEEP_3__をクリックして Next

キーストアの作成

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

1. __CAPGO_KEEP_1__をクリックして Create new

2. Key Store パスを入力してください

   注意

   この 保存しておいてください - 後で使用します

3. Key Store パスワードを設定

   注意

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

   注意

   この 保存する必要があります - 後で使用するため

4. フォームの残りの部分を入力してください

   1. キーアライアスをそのままにしておきます (key0)
   2. 証明書の詳細を入力してください。私が偽の詳細を入力したので、自分の詳細で入力してください。

   

5. Click on OK

手動ビルドの完了

1. __CAPGO_KEEP_0__の詳細を正しく入力し、クリックしてください。 Next

2. __CAPGO_KEEP_0__を選択し、クリックしてください。 release Android Studioでリリースビルドを選択 Create

3. Android Studioでビルドが成功した後

   1. __CAPGO_KEEP_0__をクリックしてください。これにより、ファイルエクスプローラーが開き、ビルドが表示されるはずです。
   2. __CAPGO_KEEP_0__を確認してください。ファイルエクスプローラーでビルドが表示できることを確認してください。 locate Android Studioでビルドが成功した後

4. このポップアップはビルドが成功したことを示しています。

Playストアコンソールでアプリを作成する

1. Go to Google Playコンソール

2. 正しい開発者アカウントを選択してください

3. Click on Create app

4. アプリ名と言語を選択してください

5. アプリのカテゴリとアプリが有料か無料かを選択してください

6. 利用規約を承知する

   注意

   利用規約を読んでから承知するようにしてください。

7. クリック Create

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

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

注意

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

開発者アカウントが2023年11月13日以降に作成された場合、内部テストはプロダクションへのアクセス用のクローズドテストの代わりではありません。少なくとも12人のオプティンインテスターが14日連続でクローズドテストに参加する必要があります。 Go to Click on

1. Google Play Console 内部テスト internal testing Click on Test and release -> Testing -> Internal testing

   

2. Click on Testers

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

4. メールリストに名前を付けます

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

6. Enterキーを押して Enter Google Play ConsoleでEnterキーを押して保存 Save

7. Google Play Consoleでグループを作成 Create group

8. Google Play Consoleで新しいリストが選択されていることを確認し、保存 Save

Google Play Consoleでグループを作成

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

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

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

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

4. Google Play Console アップロード Upload

5. AAB ファイルを選択

   注意

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

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

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

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

   個人的に、この段階ではこのエラーを見ることがあります

   

   これは、電話番号を検証していないためです。検証して続きます

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

10. 公開を確認する

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

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

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

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

1. 内部テストグループへの招待を受け入れる Test and release -> Testing -> Internal testing

2. __CAPGO_KEEP_0__をクリックしてください Testers

3. __CAPGO_KEEP_0__をクリックしてください Copy link

4. 電話にリンクを送信し、ブラウザで開き、__CAPGO_KEEP_0__をクリックしてください Accept

5. 招待を受け入れたことを確認し、「Play Storeでダウンロード」をクリックしてください

6. アプリをインストール

   1. アプリをAndroid Studioでインストールした場合は、__CAPGO_KEEP_0__をクリックしてください uninstall ボタン
   2. ボタンをクリック install ボタン
   3. アプリが正常にダウンロードされたことを確認する

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

   __CAPGO_KEEP_0__ Native Build (Android)の設定

「Capgo Native Build (Android)の設定」

Now, you are ready to start the setup of Capgo Native Build. ごほうびです！

必要な条件	フラグ	説明	必要
キーストアファイル	--keystore <path>	あなたのファイルへのパス .jks/.keystore APK/AABの署名に使用されるファイル。	はい
キーストアのエイリアス	--keystore-alias <alias>	キーストア内のキーのエイリアス名。	はい
__CAPGO_KEEP_0__の鍵パスワード	--keystore-key-password <password>	鍵/ストアのパスワードが一致する場合、1つだけ入力できます。	下の注釈を参照してください
__CAPGO_KEEP_0__のストアパスワード	--keystore-store-password <password>	鍵/ストアのパスワードが一致する場合、1つだけ入力できます。	下の注釈を参照してください
Google Playサービスアカウント	--play-config <path>	Playストアアップロード用の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

注意

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

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

あなたが手動でビルドの指示を実行した場合、すでにキーストアが生成されているはずです。 あなたが指示を実行していない場合は、キーストアを生成するために指示を実行してください。 Google Playサービスアカウント「Google Playサービスアカウント」というセクション

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

あなたが手動でビルドの指示を実行した場合、すでにキーストアが生成されているはずです。 あなたが指示を実行していない場合は、キーストアを生成するために指示を実行してください。

• Google Playサービスアカウントを生成することは、手動で複雑なプロセスです。 しかし、Google Playにアプリをアップロードするには必要です。 以下のことを覚えておいてください。 NEED Capgoの開発者アカウントのオーナーである必要があります。 サービスアカウントを設定することはできません。Google Cloud プロジェクトを作成する必要があります (Google Play アカウントとは別)。
• 始めましょう。

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

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

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

3. Let’s begin.

   注意

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

   1. クリックしてください 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. クリックしてください Keys タブ

9. __CAPGO_KEEP_0__をクリック Add Key そして Create new key

10. __CAPGO_KEEP_0__をクリック JSON そして Create

    注意

    __CAPGO_KEEP_0__をクリックすると、新しいキーが作成されJSONファイルがローカルマシンにダウンロードされます。 Create Google Console

    JSONファイルを安全な場所に保存する必要があります。後で使用されます。 __CAPGO_KEEP_0__ 自動的にダウンロードされるはずのJSONファイル

11. 閉じる close Google Consoleダウンロードキー

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

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. Google Play Console 正しい開発者アカウントを選択する
2. 正しい開発者アカウントを選択する
3. __CAPGO_KEEP_0__ Users and permissions
4. __CAPGO_KEEP_0__ Invite new users
5. サービスアカウントのメールアドレスをコピー
6. __CAPGO_KEEP_0__ Account permissions と、最低限必要なパーミッションを付与する:
   • __CAPGO_KEEP_1__ App permissions__CAPGO_KEEP_1__
   • __CAPGO_KEEP_2__ Releasesを有効化する Create, edit, and roll out releases.
   • Play App Signingを使用するワークフローがある場合、関連する署名許可を有効化してください。
   • 不明な場合は Admin セットアップのみに使用し、後で許可を削減する
7. をクリックしてください Invite user
8. 招待を確認する
9. Google Play Consoleでユーザーが招待されたことを確認する

__CAPGO_KEEP_0__

あなたは、資格情報を保存し、最初のビルドを実行する準備ができました。 資格情報を保存するには、以下のコマンドを使用できます:

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)資格情報ファイルをシングルラインベース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 シークレットはシングルラインの値でなければなりません。 tr -d '\n' Base64出力から改行を削除します。

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

リポジトリ内で 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	キーストア ストア パスワード
PLAY_CONFIG_JSON	コンテンツ play_config_base64.txt

注意

キーとストア パスワードが同じ場合は、どちらか一方を提供できます。 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:

Run:

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

これでビルドプロセスが始まります 🍾🥂

Android Buildsから続けて

あなたが使用している場合 Android Builds CI/CDの自動化を計画する場合、 Capgo CI/CD 製品ワークフローにCapgo CI/CDを接続する Capgo Native Builds 製品ワークフローにCapgo Native Buildsを接続する Capgo アサイスバート for the product workflow in Capgo Integrations, パティショナバームト パティショナバームトにアサイスバートにバームトを不なただです GitHub Actions Integration for the implementation detail in GitHub Actions Integration.