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でアプリを正常にビルドできる必要があります。

注記

チュートリアルで使用するアプリはこちらです: 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

Keystoreの作成

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

1. クリック Create new

2. Key Store pathを入力

   注意

   これは、後で使用するため保存する必要があります。 これは、後で使用するため保存する必要があります。 IS TO BE SAVED

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

   注意

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

   これは保存しておく必要があります

   - 後で使用するため 残りのフォームを埋めてください Key Aliasをそのままにしておく (key0)

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

   1. これは保存しておく必要があります - 後で使用するため
   2. 証明書の詳細を入力してください。私が偽の詳細を入力した場合、実際の詳細を入力してください。

   

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

手動ビルドの完了

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

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

3. 手動ビルドの完了セクション

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

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

セクション「Play Store Consoleでアプリを作成する」

1. 正しい開発者アカウントを選択してください Google Play Consoleで正しい開発者アカウントを選択してください

2. Creating the app on the Play Store Console

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

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

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

6. 利用規約を承知

   注意

   利用規約を読んでおくことをお勧めします。

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

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

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

注記

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

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

1. Go to internal testing クリック Test and release -> Testing -> Internal testing

   

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

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

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

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

6. 押してください Enter とクリックしてください Save

7. クリックしてください Create group

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

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

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

1. 移動してください Test and release -> Testing -> Internal testing

2. クリックしてください Releases ボタン

3. クリックしてください Create new release

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

5. AABファイルを選択

   注意

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

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

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

8. エラーを修正する

   このステージでは個人的にこのエラーを認識しています

   

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

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

10. 公開を確認する

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

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

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

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

1. 移動先 Test and release -> Testing -> Internal testing

2. クリック Testers

3. クリック Copy link

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

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

6. アプリをインストールしてください。

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

注記

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

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

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

Google Playサービスアカウント

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

• あなた context HTML text fragment from a longer Capgo UI string (parent key `you_definition`). Page/area: Capgo marketing website. Role: Long marketing or legal paragraph. Seen in: page disclaimer.astro, page return.astro. Message key `you_definition` (You Definition). 必要アプリケーション
• 開発者アカウント

の

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

   注意

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

8. Google Consoleの Keys タブ

9. キーサブタブ Add Key Google Consoleの Create new key

10. と JSON と Create

    Caution

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

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

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

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.

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 と
   • In App permissions, grant access to your app.
   • In Releases, enable Create, edit, and roll out releases.
   • If your workflow uses Play App Signing, enable the related signing permission.
   • If you are unsure, use Admin only during setup, then reduce permissions afterward.
7. Click on Invite user
8. 招待を確認する
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)

あらかじめ完了している場合 Keystore、keystoreパスワード、keystoreキー パスワード、keystoreエイリアス と 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

ヒント

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

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

ビルドを実行する

おめでとうございます！初めてのビルドを実行できるようになりました。

実行:

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

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

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

デフォルトでは、Android リリース ビルドは Google Play にアップロードされ、Play Console でリリースを完了するまで非アクティブになります。CI リリースで Play リリースを自動的に提出する場合は、 --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"

注意

Androidでは、 --submit-to-store-review デフォルトは production トラッキング release_status: completed トラッキングを設定しない場合、 --android-track internal 100%のユーザーに公開される可能性があります。パス alpha / beta(または PLAY_STORE_TRACK CIで設定する場合、 --android-release-status / PLAY_STORE_RELEASE_STATUS Androidで異なるステータスが必要な場合 completed.

通常のアップロードパスと同じGoogle Playサービスアカウントの設定が必要です (PLAY_CONFIG_JSON CIまたはローカルに保存されたAndroidのクレデンシャルが使用されている場合) --store-release-name Google Playで使用される version_name. --store-release-notes Google Playのデフォルトの変更履歴であり、各 --store-release-notes-locale "locale=notes" entry writes a localized Play changelog for that locale. Capgo sends the Play release as completed __CAPGO_KEEP_0__はPlayのリリースを送信します --android-release-statusデフォルトでは、

マネージドパブリッシングがPlayコンソールで有効になっている場合、Googleは承認後、手動で公開を待つことができます。

「Androidビルドから続けて」 Androidビルドを使用している場合 CI/CD自動化の計画を行うには、接続する Capgo CI/CD 製品ワークフローにおけるCapgo CI/CDの Capgoネイティブビルド 製品ワークフローにおけるCapgoネイティブビルドの Capgo統合 for the product workflow in Capgo Integrations, 製品ワークフローにおける__CAPGO_KEEP_0__統合の CI/CD統合 GitHub Actions Integration for the implementation detail in GitHub Actions Integration.