Android ビルド

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

学びます

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

前提条件

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

注記

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

最初の手動ビルド

Capgo を使用する前に、アプリを設定し、手動で最初の Android ビルドを行う必要があります。

• You will prepare the credentials for the later Capgo build
• 後で __CAPGO_KEEP_0__ ビルドのために、クレデンシャルを用意することができます。

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 Android Studioで署名済みアプリバンドルを選択する Next

Android Studioで署名済みアプリバンドル/アプリパッケージを生成する

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

1. クリック Create new

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

   これ

   保存しておく必要があります - これは後で使用するため キーストアパスワードを設定

3. protectedTokens

   注意

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

   注意

   これ 保存しておく必要があります - これは後で使用されます

4. 残りのフォームを埋めてください

   1. Key Aliasをそのままにしておきましょう (key0)
   2. 証明書の詳細を埋めてください。私が偽の詳細を入力したので、自分の詳細で埋めてください。

   

5. クリックしてください OK

手動ビルドの完了

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

2. ビルド release ビルド バリアントを選択し、クリックしてください Create

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

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

4. Android Studioでファイルエクスプローラーでビルドが表示できることを確認してください。

セクション：Playストアコンソールでアプリを作成しています。

1. Google Playコンソール 正しい開発者アカウントを選択してください。

2. Google Playコンソールで正しい開発者アカウントを選択してください。

3. ファイルエクスプローラーが開き、ビルドが表示されるはずです。 Create app

4. アプリ名と言語を選択

5. アプリのカテゴリと料金を選択

6. 利用規約を承認

   利用規約を読んで承認する前に、注意してください。

   クリックして

7. Google Play Consoleで作成をクリック Create

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

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

注意

Play-distributedビルドの実際のリリース前に、内部テストがまだ最速の方法です。

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

1. Google Play Consoleの内部テスト internal testing 内部テストは、実際のリリース前にPlay-distributedビルドをスモークテストする最速の方法です。 Test and release -> Testing -> Internal testing

   

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

3. クリックしてください Create email list

4. メールリストの名前を設定

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

6. Enter を押してください Enter Google Play Console で Enter を押してください Save

7. Google Play Console で保存 Create group

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

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

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

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

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

3. button Create new release

4. Click on Upload

5. AABファイルを選択

   注意

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

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

7. Click on Next

8. エラーを修正

   個人的に、この段階ではこのエラーをみてみます。

   

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

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

10. 公開を確認

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

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

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

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

1. Go to 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. __CAPGO_KEEP_0__がインストールされている場合は、Android Studioを使用してアプリをインストールした場合に、__CAPGO_KEEP_0__ボタンをクリックしてください。 uninstall button
   2. __CAPGO_KEEP_0__ボタン install Google Play Consoleでアプリをインストール
   3. Play Storeの内部テストからアプリを正常にダウンロードした

   注意

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

Capgo Native Build (Android)の設定

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

要件	フラグ	説明	必要
キーストアファイル	--keystore <path>	APK/AABに署名するために使用されるファイルのパス .jks/.keystore APK/AABに署名するために使用されるファイル	はい
__CAPGO_KEEP_0__	--keystore-alias <alias>	__CAPGO_KEEP_0__	はい
__CAPGO_KEEP_0__	--keystore-key-password <password>	鍵ストア内のキー名	はい
__CAPGO_KEEP_0__	--keystore-store-password <password>	鍵ストアのパスワード	注釈を参照してください
Playストアアップロード用のサービスアカウント	--play-config <path>	JSONサービスアカウントファイル	はい

bunx @capgo/cli 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 Cloudプロジェクトを作成する必要があります (Google Playアカウントとは別のもの)。

始めましょう。

1. Google Cloud Consoleに へ行きましょう。

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

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

   注意

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

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

   注意

   __CAPGO_KEEP_0__をコピーしておいてください。これは後で必要になります。

8. Google Consoleで Keys タブ

9. キー Add Key Google Consoleで Create new key

10. Google Consoleでキーを追加して新しいキーを作成 JSON __CAPGO_KEEP_0__ Create

    注意

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

    JSONファイルを安全な場所に保存する必要があります。 それが 使用されます。

11. JSONファイルをダウンロードする JSONファイルは自動的にダウンロードされるはずです。ウィンドウを閉じるには close Google Consoleでキーをダウンロードする

Granting Play Store API access to the service account

Play Store API にアクセスできるサービス アカウントはまだ作成されていません。許可するには、Google Play Console にアクセスしてください。

1. Go to Google Play Console
2. 正しい開発者アカウントを選択する
3. Click on Users and permissions
4. Click on Invite new users
5. サービス アカウントのメール アドレスをコピーする
6. Go to Account permissions __CAPGO_KEEP_0__
   • アプリ App permissionsGoogle Play Console
   • アプリ ReleasesGoogle Play Console Create, edit, and roll out releases.
   • 有効
   • Play App Signingの場合、関連する署名権限を有効にします。 Admin 不明な場合は
7. Google Play Console Invite user
8. 招待を確認する
9. ユーザーが招待されたことを確認する

クレデンシャルを保存中

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

bunx @capgo/cli 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 secrets should be single-line values. tr -d '\n' __CAPGO_KEEP_0__ シークレットはシングルライン値でなければなりません。

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

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

シークレット名	値
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 ${{ 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は環境変数のみを通じてクレデンシャルを送信します。署名ファイルをコミットする必要も、ワークフロー アーティファクトとしてアップロードする必要もありません。

ビルドを実行する

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

実行:

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

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