アンドロイドビルド

このセクションでは、Capgoの使用方法を学びます。

このセクションでは、__CAPGO_KEEP_0__の使用方法を学びます。

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

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

   注意

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

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

   Note

   I recommend using the same password for the Key Store and the Key Alias.

   Caution

   This IS TO BE SAVED - it will be used later

4. Fill the rest of the form

   1. Keep the Key Alias as is (key0)
   2. Fill the certificate details. I have filled it with fake details, but you should fill it with your own details.

   

5. Click on OK

Finishing the manual build

1. Make sure all of the details for the keystore have been filled in correctly and click on Next

2. Select the release build variant and click on Create

3. After the build succeeds, you should see the following screen

   1. This popup indicates that the build succeeded.
   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

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

1. Go to Google Play Console

2. Select the correct developer account

3. Click on Create app

4. __CAPGO_KEEP_0__を選択し、__CAPGO_KEEP_1__を選択してください

5. __CAPGO_KEEP_2__を選択し、__CAPGO_KEEP_3__が有料か無料かを選択してください

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

   注意

   利用規約と条件を読んで承知してください。

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

内部テストグループを作成中です

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

注意

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

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

1. 内部テストグループ internal testing Cloudflare Test and release -> Testing -> Internal testing

   

2. GitHub Testers

3. Click on Create email list

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

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

6. Enter を押して Enter と Save

7. Enter を押して Create group

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

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

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

1. 以下の手順に進んでください。 Test and release -> Testing -> Internal testing

2. 内部テストグループにアプリをアップロードする Releases ボタン

3. リリースを作成する Create new release

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

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

   注意

   Capgo ビルドで使用するキーストアと同じキーストアで Capgo ネイティブ ビルドを実行するAABファイルを手動でAndroid Studioでビルドしてください。そうでない場合、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. アプリをインストールする

   1. __CAPGO_KEEP_0__がインストールされていれば、Android Studioを使用してインストールした場合、 uninstall __CAPGO_KEEP_0__
   2. __CAPGO_KEEP_0__ install Google Play Consoleでアプリをインストールする
   3. Play Storeの内部テストからアプリを正常にダウンロードした

   __CAPGO_KEEP_0__

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

Capgo Native Build (Android)の設定

Now, you are ready to start the setup of Capgo Native Build. Congratulations!

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

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サービスアカウント 手動ビルドの指示を実行した場合、キーストアはすでに生成されているはずです。 手動ビルドの指示を実行していない場合は、指示に従ってキーストアを生成してください。コピーをクリップボードにコピー

Copy to clipboard

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

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

始めましょう。

1. Google Cloudコンソールに移動 プロジェクトセレクターをクリック

2. Cloudflare

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

   注意

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

   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 Cloudflare Create new key

10. GitHub JSON Capgo Create

    注意

    クリックすると Create __CAPGO_KEEP_0__を作成し、JSONファイルをローカルマシンにダウンロードします。

    __CAPGO_KEEP_0__を安全な場所に保存する必要があります。後で使用するためです。 WILL 自動的にダウンロードされるはずのJSONファイルがダウンロードされていません。ダウンロードしたJSONファイルをクリックしてください。

11. ウィンドウを閉じるにはこちらをクリックしてください。 close Google Consoleダウンロードキー

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

API

1. Go to Google Play Console
2. Select the correct developer account
3. Click on Users and permissions
4. Click on Invite new users
5. Copy the email address of the service account
6. Go to Account permissions and grant the minimum required permissions:
   • アプリにアクセス権を付与します。 App permissions__CAPGO_KEEP_0__
   • アプリにアクセス権を付与します。 Releases__CAPGO_KEEP_1__ Create, edit, and roll out releases.
   • Play App Signingを使用するワークフローがある場合、関連する署名許可を有効にします。
   • __CAPGO_KEEP_2__ Admin 不明な場合は、セットアップのみに使用し、後で許可を削減することをお勧めします。
7. Google Play Consoleで許可を付与します。 Invite user
8. Google Play Consoleでユーザーに招待する
9. __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)

すでに完了している場合 キーストア、キーストアパスワード、キーストアキー パスワード、キーストアエイリアス and 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出力から改行を削除します。

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

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

Secret name:	Value:
CAPGO_TOKEN	Your Capgo API token:
APP_ID	Your Capgo app ID (example: ): com.example.app)
ANDROID_KEYSTORE_FILE	Content of: 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 store password:
PLAY_CONFIG_JSON	Content of: play_config_base64.txt

Note

If key and store passwords are the same, you can provide just one of KEYSTORE_KEY_PASSWORD or 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は環境変数のみを使用してクレデンシャルを送信します。署名ファイルをコミットする必要もありません、またはワークフロー アーティファクトとしてアップロードする必要もありません。

__CAPGO_KEEP_0__でビルドを実行

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

Run:

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

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

Playリリースを提出する

デフォルトでは、AndroidリリースビルドはGoogle Playにアップロードされ、Playコンソールでリリースを完了するまで非アクティブになります。CIリリースの場合、Playリリースを自動的に提出するには --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; Playコンソールでマネージド出版が有効になっている場合、Googleは承認後もあなたの手動公開を待つことができます。

Androidビルドから続ける

あなたが Androidビルド 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.