Android ビルド

Capgo の専用インフラを使用して、Android アプリをビルドし、Google Play Store に提出します。

学習内容

• Capgo Native Build を使用してアプリをアップロードする方法を学びます
• Capgo Native Build の認証情報を設定する方法を学びます。

前提条件

• 有効な Google Developer アカウントが必要です
• Android Studio がインストールされている必要があります
• アプリは Android Studio で正常にビルドできる必要があります

注意

チュートリアルでは以下のアプリを使用します: https://github.com/Cap-go/capgo-native-build-tutorial-app

推奨：自動オンボーディング

これらはすべて手作業で行う必要はありません。Capgo の onboarding が、Android の署名資格情報（keystore と Google Play サービスアカウント）を作成・設定します。これが推奨される手順です：

bunx @capgo/cli@latest build init --platform android

以下の手順は、自身で認証情報を設定したい方や、Capgo の内部動作を詳しく理解したい方向けのガイドです。

初回の手動ビルド

Capgo を使ってアプリのビルドを考え始める前に、まずセットアップを行い、手動で最初の Android ビルドを実行する必要があります。 手動ビルドを先に実行する利点はいくつかあります：

• 後々の Capgo ビルド用の資格情報を準備できます
• Play Store コンソールにレコードを作成できます

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 にアプリをビルドしたのが自分であることを示すためのものです。 生成するには、Android Studio の GUI を使います。 コマンドラインで行う方法もありますが、このチュートリアルでは扱いません。

1. 次をクリックします： Create new

2. Key Storeのパスを入力

   注意

   この 保存される - 後で使用します

3. Key Storeのパスワードを設定

   注意

   Key StoreとKey Aliasには同じパスワードを使うことをおすすめします。

   注意

   この 保存される - 後で使用します

4. フォームの残りの項目を入力してください

   1. Key Alias はそのまま (key0) にしてください
   2. 証明書の詳細を入力してください。ここではダミーデータを入力していますが、実際にはご自身の情報を入力してください。

   

5. 次をクリックします： OK

手動ビルドの仕上げ

1. Keystoreの詳細がすべて正しく入力されていることを確認し、次をクリックします。 Next

2. 次の release ビルドバリアントを選択し、次をクリックします。 Create

3. ビルドが成功すると、次の画面が表示されます。

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

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

Play Store Consoleでのアプリ作成

1. 以下に移動します： Google Play Console

2. 正しいデベロッパーアカウントを選択

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. 以下に移動します： Test and release -> Testing -> Internal testing

2. 次の Releases ボタンをクリックします

3. 次をクリックします： Create new release

4. 次をクリックします： Upload

5. AAB ファイルを選択

   注意

   必ず、Android Studioで手動ビルドしたAABファイルを選択してください。このファイルが Capgo ビルドで使用するkeystoreと同じでない場合、Capgo Native Build は失敗します。

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. 次の install ボタンをクリックします
   3. アプリを開き、正常にダウンロードされたことを確認します

   注意

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

Capgo Native Build の設定 (Android)

これで、Capgo Native Build のセットアップを開始できます。おめでとうございます 🎉!

要件	フラグ	説明	必須
Keystoreファイル	--keystore <path>	ファイルのパス .jks/.keystore APK/AABの署名に使用するファイル。	はい
Keystoreエイリアス	--keystore-alias <alias>	Keystore内のキーのエイリアス名。	はい
Keystoreのキーパスワード	--keystore-key-password <password>	キーのパスワード。キーとストアのパスワードが同じ場合、1つだけ指定できます。	以下の注記を確認してください
Keystoreのストアパスワード	--keystore-store-password <password>	keystoreのパスワード。キーとストアのパスワードが同じ場合、1つだけ指定できます。	以下の注記を確認してください
Google Playサービスアカウント	--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.

Keystore、keystoreパスワード、keystoreキーパスワード、keystoreエイリアス

に従った場合 手動ビルド手順に従っていれば、keystore はすでに生成されているはずです。 手順に従っていない場合は、keystore を生成するために手順に従ってください。

Google Playサービスアカウント

Google Play のサービスアカウント生成は手動かつ複雑なプロセスです。 しかし、アプリを Google Play にアップロードするには必須です。以下の点にご注意ください:

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

始めましょう。

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. Service Account ID は以下に設定することをお勧めします capgo-native-build-service-acc
   3. 説明は必須ではありませんが、以下を入力することをお勧めします Allows Capgo Native Build to build and submit the app to the Play Store

   

7. 新しく作成したサービスアカウントをクリックしてください リストに新しく作成したサービスアカウントが表示されているはずです。それをクリックします。

   注意

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

8. 次の Keys タブ

9. 次をクリックします： Add Key と Create new key

10. 次をクリックします： JSON と Create

    注意

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

    JSONファイルを安全な場所に保存してください。このファイルは 必ず 後で使用します。

11. JSONファイルをダウンロード JSONファイルは自動的にダウンロードされているはずです。以下をクリックすると close ウィンドウが閉じます。

サービスアカウントにPlay Store API へのアクセス権を付与

作成したばかりのサービスアカウントには、まだ Play Store の API へのアクセス権がありません。付与するには、Play Store Console に移動してください。

1. 以下に移動します： Google Play Console
2. 正しいデベロッパーアカウントを選択
3. 次をクリックします： Users and permissions
4. 次をクリックします： Invite new users
5. サービスアカウントのメールアドレスをコピー
6. 以下に移動します： Account permissions 必要最小限の権限を付与します：
   • では App permissions、アプリへのアクセス権限を付与します。
   • では Releases、有効にする 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)

すでに完了している場合 Keystore、keystoreパスワード、keystoreキーパスワード、keystoreエイリアス と Google Playサービスアカウント、CI/CDに必要なものはすべて揃っています。 このセクションでは、それらの値をGitHub Actionsのシークレットや環境変数として渡す方法のみを説明します。

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) リポジトリシークレットを作成

では 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 エイリアス Keystore、keystoreパスワード、keystoreキーパスワード、keystoreエイリアス
KEYSTORE_KEY_PASSWORD	Keystoreのキーパスワード
KEYSTORE_STORE_PASSWORD	Keystoreのストアパスワード
PLAY_CONFIG_JSON	内容: play_config_base64.txt

注意

キーとストアのパスワードが同じ場合、どちらか一方のみ指定できます KEYSTORE_KEY_PASSWORD または KEYSTORE_STORE_PASSWORD.

3) GitHub Actions workflow で環境変数を使う

.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

これでビルドプロセスが開始されます 🍾🥂

Playのリリースを審査に提出する

デフォルトでは、Android のリリースビルドは Google Play にアップロードされ、Play Console でリリースを完了するまで非アクティブのままにできます。CI リリースで Play リリースを自動的に提出する場合は、 --submit-to-store-review リリースビルドで渡します:

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%のユーザーにライブ配信される可能性があります。Pass --android-track internal (または alpha / beta）、または PLAY_STORE_TRACK をCIで設定し、完了したリリースを非本番トラックに保持します。使用: --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" entry はそのロケール向けのローカライズされた Play 変更履歴を書き込みます。Capgo は Play リリースを次のように送信します completed を上書きしない限り、 --android-release-statusPlay Console で「管理公開」が有効な場合、Google は承認後も手動公開を待ちます。

Android Buildsから続ける

使用している場合 Android ビルド CI/CD自動化を計画するには、次と連携してください Capgo での CI/CD 設定 Capgo CI/CDでのプロダクトワークフローについては、 Capgo Native Build Capgo Native Buildsでのプロダクトワークフローについては、 Capgo インテグレーション Capgo インテグレーションでのプロダクトワークフロー向けに、 CI/CD 連携 CI/CD Integrationの実装詳細については、 GitHub Actions 連携 GitHub Actions Integrationの実装詳細については。