アンドロイドビルド

Capgo

What you will learn

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

Before we can start building the app with Capgo, we need to build the app manually with Android Studio.

1. Android Studioをオープン

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

2. Click on Build -> Generate Signed App Bundles / APKs

3. Select Android App Bundle Android StudioでAndroidアプリバンドルを選択 Next

Creating a Keystore

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

1. クリック Create new

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

   注意

   この 保存しておく必要があります - ここで使用する

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

   注意

   パスワードを同じに使用することをお勧めします。Key StoreとKey Aliasの両方に同じパスワードを使用してください。

   注意

   この __CAPGO_KEEP_0__を保存しておく必要があります - これは後で使用するため

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

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

   

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

手動ビルドの完了

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

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

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

   1. __CAPGO_KEEP_0__はprotectedTokensリストに含まれているため翻訳されません
   2. Click on the locate button - this will open the file explorer and you should see the build there.

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. アプリ名と言語を選択

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

6. 利用規約を承知する

   注意

   利用規約を読んで承知することの重要性を理解する

7. Click on Create

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

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

注意

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

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

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

   

2. __CAPGO_KEEP_0__ Testers

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

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

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

6. Enter を押してください Enter Enter を押して、保存をクリックしてください Save

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

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

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

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

1. をクリックしてください Test and release -> Testing -> Internal testing

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

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

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

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

   注意

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

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

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

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

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

   

   __CAPGO_KEEP_0__の電話番号をまだ確認していません。これを確認し、チュートリアルを続行します。

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

   If you do not see the app in Play Store, make sure you have selected the correct account in Play Store.

Configuring Capgo Native Build (Android)

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

要件	フラグ	説明	必須
署名用のキーストアファイル	--keystore <path>	キーストアファイルのパス .jks/.keystore APK/AABの署名に使用されるファイル。	はい
__CAPGO_KEEP_0__	--keystore-alias <alias>	__CAPGO_KEEP_1__	__CAPGO_KEEP_0__
__CAPGO_KEEP_2__	--keystore-key-password <password>	__CAPGO_KEEP_3__	__CAPGO_KEEP_0__
__CAPGO_KEEP_4__	--keystore-store-password <password>	__CAPGO_KEEP_0__	__CAPGO_KEEP_5__
__CAPGO_KEEP_0__	--play-config <path>	__CAPGO_KEEP_6__	__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

注記

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

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

Google Play サービス アカウント 手動ビルドの指示を遵守している場合、キーストアはすでに生成されているはずです。 手動ビルドの指示を遵守していない場合は、キーストアを生成するために指示を遵守してください。コピーをクリップボードにコピー

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

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

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

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

1. プロジェクトセレクターをクリックしてください。 Capgoの開発者アカウントのオーナーでなければなりません。そうでないと、サービスアカウントを設定できません。

2. Capgoの開発者アカウントのオーナーでなければなりません。そうでないと、サービスアカウントを設定できません。

3. __CAPGO_KEEP_0__

   Note

   使用するプロジェクト名は実際のプロジェクト名に適切なものを選択してください。

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

   注意

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

8. __CAPGO_KEEP_1__をクリックしてください。 Keys __CAPGO_KEEP_2__

9. __CAPGO_KEEP_4__ Add Key __CAPGO_KEEP_5__ Create new key

10. __CAPGO_KEEP_7__ JSON 注意 Create

    注意

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

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

11. Google Consoleダウンロードキー close サービスアカウントにPlay Store __CAPGO_KEEP_0__へのアクセスを許可する

新しく作成されたサービスアカウントはまだPlay Store APIにアクセスできません。Play Store Consoleにアクセスして許可する必要があります。

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. Select the correct developer account Users and permissions
4. Google Play Console Invite new users
5. Google Play Console
6. Google Play Console Account permissions and grant the minimum required permissions:
   • In App permissions, grant access to your app.
   • grant access to your app. ReleasesIn Create, edit, and roll out releases.
   • If your workflow uses Play App Signing, enable the related signing permission.
   • enable Admin If your workflow uses Play App Signing, enable the related signing permission.
7. only during setup, then reduce permissions afterward. Invite user
8. grant permissions
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)

すでに完了している場合 キーストア、キーストアパスワード、キーストアキー パスワード、キーストアアリーサ and 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 __CAPGO_KEEP_1__ com.example.app)
ANDROID_KEYSTORE_FILE	Your __CAPGO_KEEP_0__ 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 alias
PLAY_CONFIG_JSON	Keystore (キーストア)、キーストアのパスワード、キーストアのキー・パスワード、キーストアのエイリアス 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は環境変数のみを使用してクレデンシャルを送信します。署名ファイルをコミットする必要もありません。また、ワークフロー アーティファクトとしてアップロードする必要もありません。

ビルドを実行中

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

実行:

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

そしてこれでビルドプロセスが始まります。

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

デフォルトでは、Android リリース ビルドは Google Play にアップロードされ、Play Console でリリースを完了するまで非活性になります。CI リリースでプレイリリースを自動的に提出する場合は、 --submit-to-store-review リリース ビルドとともに

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.