Android ビルド

Google Play StoreにアプリをアップロードするためのAndroidアプリをCapgoの専用インフラで作成して提出します。

学ぶこと

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

前提条件

• 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を入力

   注意

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

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. Android Studioのビルドが成功した後

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. 招待が受け入れられたことを確認し、「Google Play Storeでダウンロード」をクリックしてください。

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

   1. Android Studioを使用してアプリをインストールしたことがある場合は、「ボタン」をクリックしてください。 uninstall ボタン
   2. ボタン install Google Play Consoleでアプリをインストールしてください。
   3. Play Storeの内部テストからアプリが正常にダウンロードされたことを確認します。

   注意

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

Configuring Capgo Native Build (Android)

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

要件	フラグ	説明	必須
キーストアファイル	--keystore <path>	キーストアファイルのパス .jks/.keystore APK/AABの署名に使用されるファイル。	はい
キーストア内のキーのエイリアス	--keystore-alias <alias>	キーストア内のキーのエイリアス名	はい
キーのパスワードです。キー/ストアのパスワードが同じ場合は、1つだけ入力できます。	--keystore-key-password <password>	下の注釈を参照してください	キーストアのパスワードです。キー/ストアのパスワードが同じ場合は、1つだけ入力できます。
下の注釈を参照してください	--keystore-store-password <password>	Google Playサービスアカウント	__CAPGO_KEEP_0__
__CAPGO_KEEP_1__	--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). 必要ですアプリの開発者アカウントの
• context

owner

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. Google Consoleにキーを追加して新しいキーを作成 JSON と Create

    Caution

    Clicking on Create キーを作成すると、JSONファイルがローカルマシンにダウンロードされます。

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

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

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 と
   • In App permissions、
   • In Releases、 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 password, keystore key password, keystore alias と Google PlayサービスアカウントCI/CD用に必要なものはすべて揃っています。このセクションでは、GitHub Actionsシークレットと環境変数として値を渡す方法について説明します。

1) Credentialファイルを単一行の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

__CAPGO_KEEP_0__シークレットは、単一行の値でなければなりません。

GitHub secrets should be single-line values. tr -d '\n' and

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

In GitHub > Repository > Settings > Secrets and variables > Actions, 追加:

シークレット名	値
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	Keystore store password
PLAY_CONFIG_JSON	Content of play_config_base64.txt

Note

keyとstoreのパスワードが同じ場合は、keyのパスワードのみを入力してください。 KEYSTORE_KEY_PASSWORD or KEYSTORE_STORE_PASSWORD.

3) Use env vars in your GitHub Actions workflow

3) github Actionsワークフローで環境変数を使用する

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

ビルドを実行

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

実行:

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

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

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

デフォルトでは、Android リリース ビルドは Google Play にアップロードされ、プレイ コンソールでリリースを完了するまで非アクティブになります。CI リリースでプレイ リリースを自動的に提出する場合は、 --submit-to-store-review with a release build:

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.