Android ビルド

Google Play Storeにアプリをアップロードして、Capgoの専用インフラを使用してアプリを公開します。

学ぶこと

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

前提条件

• 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. After the build succeeds, you should see the following screen

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

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

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

1. Playストアコンソールに移動してください 正しい開発者アカウントを選択してください

2. Playストアコンソールで正しい開発者アカウントを選択してください

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

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

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

6. 利用規約を承知

   注意

   利用規約を読んでから承知してください

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

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

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

注記

Play-distributedビルドの実行前の本番リリースの実際のリリースまでの最速の方法はまだ内部テストです。

開発者アカウントが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. 「Google Play Consoleの内部テスト」に移動 Testers

3. 「Google Play ConsoleのコピーURL」に移動 Copy link

4. Google Play Consoleの招待を受け入れる Accept

5. 招待が受け入れられたことを確認し、「Play Storeでダウンロード」をクリックしてください。

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

   1. Android Studioを使用してアプリをインストールしたことがある場合は、「 uninstall __CAPGO_KEEP_0__
   2. Google Play Consoleからアプリをアンインストールしてください。 install 「
   3. 」ボタンをクリックしてください。

   注意

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

Capgo Androidネイティブビルドの設定

Capgo Androidネイティブビルドのセットアップを開始する準備ができました。祝賀！

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

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

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

2. プロジェクトセレクターをクリックしてください

3. 既存のプロジェクトがあれば選択してください。なければ新しいプロジェクトを作成してください:

   注記

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

   1. クリックしてください New project
   2. プロジェクト名を入力して、[作成]ボタンをクリックしてください Create
   3. 正しいプロジェクトに移動していることを確認してください

4. 検索バーにクリックして service accounts を検索して

5. にクリックしてください Create service account

6. Service Accountのフォームを入力して Done

   1. Service Accountの名前を Capgo Native Build Service Account
   2. Service Account IDを capgo-native-build-service-acc
   3. Service Accountの説明を Allows Capgo Native Build to build and submit the app to the Play Store

   

7. 新しく作成したService Accountにクリックしてください リストに新しく作成したService Accountが表示されます。クリックしてください。

   注意

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

8. Google Consoleの Keys タブ

9. キーサブタブ Add Key Google Consoleの Create new key

10. Google Consoleの JSON キーと Create

    Caution

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

    JSONファイルを安全な場所に保存しておく必要があります。 それは 後で使用されます。

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

Granting Play Store API access to the service account

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. 正しい開発者アカウントを選択してください
3. Click on Users and permissions
4. Click on Invite new users
5. サービスアカウントのメールアドレスをコピーしてください
6. Go to Account permissions と
   • In App permissions, grant access to your app.
   • In Releases, enable Create, edit, and roll out releases.
   • If your workflow uses Play App Signing, enable the related signing permission.
   • If your workflow uses Play App Signing, Admin If you are unsure, use
7. Google Play Console 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) 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) リポジトリシークレットを作成する

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

or KEYSTORE_KEY_PASSWORD Capacitor KEYSTORE_STORE_PASSWORD.

3) Use env vars in your 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 }}

Capacitor live-update alternatives comparison page. Role: Long marketing or legal paragraph. Seen in: page alternatives.astro. Preserve Capgo product/brand and developer terms exactly. Message key `alternatives_cta_questions` (Alternatives CTA Questions). | Appflow comparison / migration marketing copy. Role: Long marketing or legal paragraph. Seen in: page ionic-appflow.astro. Preserve Capgo product/brand and developer terms exactly. Message key `appflow_cta_questions` (Appflow CTA Questions). | Capawesome comparison page. Role: Long marketing or legal paragraph. Seen in: page capwesome.astro. Preserve Capgo product/brand and developer terms exactly. Message key `capwesome_cta_questions` (Capwesome CTA Questions). | Consulting services page. Role: Section subtitle or tagline. Seen in: page consulting.astro. Preserve Capgo product/brand and developer terms exactly. Message key `consulting_faq_subtitle` (Consulting FAQ Subtitle). | Appflow comparison / migration marketing copy. Role: Short UI label or navigation item. Seen in: page ionic-appflow.astro, page ionic-enterprise-plugins.astro, page solutions/ionic-enterprise-plugins.astro. Message key `appflow_plugins_or` (Appflow Plugins Or). | 3) Actions workflowに環境変数を使用する方法です。 | Section titled “3) Actions workflowに環境変数を使用する方法です” | __CAPGO_KEEP_0__/workflows/android-build.yml | クリップボードにコピーする | Tip | 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%のユーザーに公開される可能性があります。Pass 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 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, CI/CD統合 実装詳細のCI/CD統合 GitHubアクション統合 実装詳細のGitHubアクション統合