Android Builds

Google Play Store への Android アプリのビルドと提出を Capgo の専用インフラで行います。

学びます

• 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でアプリを手動でビルドします

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. キーストアのパスを入力

   注意

   これ __CAPGO_KEEP_0__ - __CAPGO_KEEP_0__

3. Key Store パスワードを設定してください

   注意

   Key StoreとKey Aliasのパスワードを同じにすると便利です。

   注意

   これは保存する必要があります - __CAPGO_KEEP_0__ 残りのフォームを埋めてください

4. protectedTokens

   1. キー名をそのままにしておく (key0)
   2. __CAPGO_KEEP_0__の証明書の詳細を入力してください。私が入力したのは偽の情報ですが、自分の情報で入力してください。

   

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

手動ビルドの完了

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

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

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

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

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

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

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

2. Select the correct developer account

3. Click on Create app

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

5. アプリのカテゴリとアプリが有料か無料かを選択

6. 利用規約を承知してください

   注意

   利用規約を読んで承知することを確認してください

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

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

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

注意

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

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

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

   

2. Click on Testers

3. Click on Create email list

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

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

6. Press Enter とクリック Save

7. クリック Create group

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

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

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

1. 内部テスト グループにアプリをアップロードするには、 Test and release -> Testing -> Internal testing

2. クリック Releases 保存

3. Click on Create new release

4. Click on Upload

5. AAB ファイルを選択

   Caution

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

6. AAB ファイルのアップロードを待ちます

7. Click on Next

8. エラーを修正

   個人的には、この段階ではこのエラーを確認している

   

   電話番号を確認していないため、このように表示されます。確認し、チュートリアルを続行します。

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

10. 公開を確認

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

12. __CAPGO_KEEP_0__の仮想アプリ名を取得

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

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

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

2. Click on Testers

3. Click on 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 Native Build (Android)の設定

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

要件	フラグ	説明	必須
キーストアファイル	--keystore <path>	__CAPGO_KEEP_0__ .jks/.keystore APK/AABの署名に使用するファイルのパスです。	Yes
キーストアのエイリアス	--keystore-alias <alias>	キーストア内に格納されているキーのエイリアス名です。	Yes
キーのパスワード	--keystore-key-password <password>	キーのパスワードです。キーとストアのパスワードが一致している場合、1つだけ入力できます。	下の注釈を参照してください
キーストアのストアパスワード	--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

注記

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

キーストア、キーストア パスワード、キーストア キー パスワード、キーストア アリάς

Capgo の指示に従った場合 手動ビルドの指示__CAPGO_KEEP_0__ __CAPGO_KEEP_0__ Cloudflareのサービスアカウント

Google Playサービスアカウント

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

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

Let's begin.

1. Go to Google Cloud Console

2. Click on the project selector

3. 既存のプロジェクトがあればそれを選択し、なければ新しいプロジェクトを作成してください。

   Note

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

   1. Click on New project
   2. プロジェクト名を入力し、Create ボタンをクリックしてください。 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. Click on the newly created service account __CAPGO_KEEP_0__ You should now see the newly created service account in the list. Click on it.

   Note

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

8. __CAPGO_KEEP_1__ Keys タブ

9. __CAPGO_KEEP_2__ Add Key と Create new key

10. __CAPGO_KEEP_3__ JSON かつ Create

    注意

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

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

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

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

サービス アカウントが新しく作成されたが、まだ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 そして、必要な最小限の権限を付与する:
   • Google Play Consoleで App permissions, ご利用のアプリにアクセス許可を付与する
   • Google Play Consoleで Releases, 有効にする Create, edit, and roll out releases.
   • Playアプリ署名を使用するワークフローがある場合、関連する署名権限を有効にする
   • 不明な点がある場合は、 Admin セットアップのみに使用し、権限を後で削減する
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)

既に完了している場合 キーストア、キーストアパスワード、キーストアキー パスワード、キーストアエイリアス と Google Playサービスアカウント, you already have everything needed for CI/CD. This section only covers how to pass those values as GitHub Actions secrets and environment variables.

このセクションでは、__CAPGO_KEEP_0__ Actionsシークレットと環境変数として値を渡す方法について説明します。

# 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出力から改行を削除します。

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	__CAPGO_KEEP_0__
KEYSTORE_STORE_PASSWORD	__CAPGO_KEEP_0__
PLAY_CONFIG_JSON	__CAPGO_KEEP_0__の内容 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 }}

Tip

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

ビルドを実行

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

Run:

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

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

Android ビルドから続けて

あなたがAndroidビルドを使用している場合 Android ビルド __CAPGO_KEEP_0__ CI/CD と接続する Capgo CI/CD Capgo CI/CD Capgo ネイティブ ビルド Capgo ネイティブ ビルド Capgo インテグレーション Capgo インテグレーション CI/CD インテグレーション CI/CD インテグレーションの実装詳細 GitHub アクション インテグレーション GitHub アクション インテグレーションの実装詳細