Android ビルド

Build and submit Android apps to Google Play Store using Capgo’s dedicated infrastructure.

学習すること

• 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

The manual walkthrough below is only for those who prefer to set up credentials themselves, or want to understand exactly what Capgo does under the hood.

手動のウォークスルーは、自分で資格情報を設定したい人や、__CAPGO_KEEP_0__の内部動作を理解したい人向けです。

Before we can start thinking about building the app with Capgo, we should first set it up, and do a first Android build by hand. There are some advantages to doing a manual build first:

• Capgoでアプリをビルドする前に、まずセットアップし、手動で最初のAndroidビルドを行う必要があります。 手動ビルドを行うことで、次の利点があります:
• 後で__CAPGO_KEEP_0__でビルドする際の資格情報を準備することになります。

Android Studioでアプリを手動で作成する

CapgoでアプリをCapgoで作成する前に、アプリをAndroid Studioで手動で作成する必要があります。

1. Android Studioを開く

   実行 bunx cap open android Android Studio のプロジェクトを開きます。

2. クリックして Build -> Generate Signed App Bundles / APKs

3. Select Android App Bundle クリック Next

選択する

現在、Keystoreファイルが欠けているようです。このファイルは、アプリを署名するために使用され、Googleにアプリを開発したのは自分であることを知らせるのに役立ちます。 Keystoreファイルを生成するには、Android Studioが提供するGUIメソッドを使用します。 コマンドラインで行う方法もあるのですが、このチュートリアルではカバーしません。

1. クリックして Create new

2. Key Store pathを入力

   注意

   This - これは後で使用されるため Key Storeパスワードを設定

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

   注意

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

   注意

   これ 保存しておいてください - これは後で使用されます

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

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

   

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

手動ビルドの完了

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

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

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

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

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

Play Store Consoleでアプリを作成しています。

1. Go to 正しい開発者アカウントを選択してください。

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

3. ボタンをクリックしてください。 Create app

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

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

6. 利用規約を承知する

   注意

   利用規約を読んで承知すること

7. クリック Create

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

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

注記

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

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

1. 移動 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. Go to Test and release -> Testing -> Internal testing

2. クリックしてください Releases button

3. クリックして Create new release

4. クリック Upload

5. AABファイルを選択

   注意

   Google Play Consoleで手動でAndroid Studioでビルドした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. Google Play Consoleでアプリをインストール install ボタン
   3. Play Storeの内部テストからアプリが正常にダウンロードされた

   注意

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

Capgo Native Build (Android)の設定

Capgo Native Buildのセットアップを開始する準備ができました。よくできました！ 🎉

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

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 or --keystore-store-password.

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

手順に従った場合、キーストアはすでに生成されているはずです。 手順に従っていない場合は、手順に従ってください。 手順に従った場合、キーストアはすでに生成されているはずです。 手順に従っていない場合は、手順に従ってください。手順に従った場合、キーストアはすでに生成されているはずです。 手順に従っていない場合は、手順に従ってください。

Google Playサービスアカウント

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

• あなた NEED 必要 サービスアカウントの所有者である必要があります。
• そうでないと、サービスアカウントを設定できません。

Google Cloudプロジェクトを作成する必要があります (Google Playアカウントとは別)。

1. 始めましょう。 Google Cloudコンソールに移動してください。

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. Capgoマーケティングサイトのページエージェント/[slug].astroで見られるUIラベルです。メッセージキー`agents_page_copy_label` (Agents Page Copy Label)。 Keys tab

9. Google Consoleの Add Key and Create new key

10. Google Consoleの JSON and Create

    注意

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

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

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

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

新しく作成されたサービスアカウントはまだPlayストアにアクセスできません。API。アクセス権を付与するには、Playストアコンソールに移動してください。

1. Go to Google Play Console
2. 正しい開発者アカウントを選択
3. クリックしてください Users and permissions
4. クリックしてください Invite new users
5. サービスアカウントのメールアドレスをコピー
6. Go to Account permissions および、最低必要な権限を付与します:
   • In App permissionsアプリにアクセスを許可する。
   • In Releases, enable Create, edit, and roll out releases.
   • ワークフローがPlay App Signingを使用している場合、関連する署名許可を有効にします。
   • もし不明な点があれば、 Admin セットアップ時のみ、後で権限を削減します。
7. クリックして 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）

「CI/CD設定 (__CAPGO_KEEP_0__ Actions)」のセクション 既に完了している場合 と 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) リポジトリシークレットを作成する

では 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	キーストアのストア パスワード
PLAY_CONFIG_JSON	コンテンツの 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

ビルドプロセスを開始します 🍾🥂

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

セクション: プレイ リリースを提出する --submit-to-store-review デフォルトでは、Android リリース ビルドは Google Play にアップロードされ、Play Console でリリースを完了するまで非アクティブになります。CI リリースでプレイ リリースを自動的に提出するには、以下のオプションを使用してください:

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 標準では 本番 トラッキングする release_status: completed トラッキングしない場合、100%のユーザーに公開される可能性があります。パス --android-track internal (または alpha / betaCIで設定する PLAY_STORE_TRACK 完了したリリースを非本番トラッキングに保持する --android-release-status / PLAY_STORE_RELEASE_STATUS — または completed.

Google Playサービスアカウントの設定は、通常のアップロードパスと同じ必要です (PLAY_CONFIG_JSON CIまたはローカルに保存されたAndroidのクレデンシャルが使用されます。 --store-release-name Google Play version_name. --store-release-notes Playのフォールバックチャンネルログです。各 --store-release-notes-locale "locale=notes" エントリは、ローカライズされたPlayチャンネルログをそのロケールで書きます。CapgoはPlayリリースを送信します completed 、Managed PublishingがPlayコンソールで有効になっている場合、Googleは承認後、手動で公開を待つことができます。 --android-release-statusAndroidビルドから続けてください

セクションのタイトル「Androidビルドから続けてください」

CIまたはローカルに保存されたAndroidのクレデンシャルが使用されます。 Androidビルド CI/CDの自動化を計画する場合、Androidビルドを接続します Capgo CI/CD Capgo製品ワークフロー向け Capgoネイティブビルド Capgo製品ワークフロー向け Capgo統合 Capgo製品ワークフロー向け CI/CD統合 __CAPGO_KEEP_0__アクション統合 GitHubアクション統合 GitHubから始めましょう