Android サンドボックステストの設定

インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。

アプリ内課金のテストには、Google Play Consoleでの適切な設定が必要です。このガイドでは、Androidアプリのサンドボックステストの設定手順を解説します。

用途に合ったビルドを選ぶ

開始する前に、以下の3種類のAndroidビルドを区別してください：

ローカルのデバッグ/開発用ビルド: デバイス上でのUIやネイティブ連携の確認に適しています。
Play Consoleにアップロード済みの署名済みリリースAAB: Google Play Billingのリアルなテストを行うために必要です。
Playストアからインストールしたテスト用ビルド: テスターが内部テストまたはクローズドテストからインストールするビルドです。購入機能のQAにはこれを使用してください。

Android StudioからAPKをサイドロードしただけの場合、 adbGoogle Play Billingが本番環境と同じ挙動をしない可能性があります。サブスクリプションやアプリ内課金の検証には、必ずGoogle Playからインストールしたビルドでテストしてください。

前提条件

Google Play Console のデベロッパーアカウント。まだ作成していない場合は、こちらから開始してください： Play Console サインアップ.
Play Console に作成済みの、最終的な Android パッケージ名を持つアプリレコード
Play Console で作成済みのアプリ内課金アイテムまたはサブスクリプション
ライセンステストに追加可能なテスト用 Gmail アカウント
アップロード準備が完了している、署名済みのリリースビルド

課金設定を進める前に、Play Console でアプリを作成し、以下を決定してください：無料または有料有料アプリを後から無料に変更することは可能ですが、一度無料として提供を開始したアプリを、再度有料に切り替えることはできません。

Android App Bundle (".aab) 新しい Play Store アプリの場合:

bunx cap sync android
cd android
./gradlew bundleRelease

コマンドを実行する前に、Android のリリース署名が設定済みであることを確認してください。 bundleReleasekeystore、署名設定、またはリリースパスワードがまだ設定されていない場合は、Android Studio で以下の手順から署名済み bundle を作成してください。 Build > Generate Signed App Bundle / APKを選択すると、これらの値の入力が求められます。

セットアップ手順

テストアカウントの追加

Play Consoleで、次を開きます： 設定 > ライセンステスト Androidテストデバイスで使用しているメインのGoogleアカウントを追加します。

これにより、購入時は実際の課金を試みる代わりに、Playのサンドボックスフローが表示されます。
テストトラックを選択

以下に移動します： テストとリリース > テスト 以下のいずれかのトラックを選択してください：
- 内部テスト: QAと課金のスモークテストに最適な最短ルートです。新しいbundleは通常数分以内に利用可能になります。
- クローズドテスト: より広範なテストに適しており、2023年11月13日以降に作成された個人開発者アカウントでは本番公開前に必須です。
初回リリース時、Playは内部テスターに最大48時間、一時的なアプリ名やストア掲載情報を表示することがあります。
テスターリストの作成

トラックを開いた後、テスターリストを作成し、ビルドを受け取るGoogleアカウントを追加してください。

新規作成した個人アカウントで本番環境へのアクセスを目指している場合は、必ず クローズドテスト を利用し、少なくとも12人のテスターが14日間連続で参加している状態を維持してください。
署名済みリリースビルドのアップロード

選択したテストトラックで新しいリリースを作成し、署名済みのビルドを .aab.

新しいGoogle Playアプリでは、APKではなくAndroid App Bundleを使用する必要があります。アップロード後、リリースを保存し、Play Consoleが指摘するポリシー違反やストア掲載情報の問題を修正してから、テストトラックにリリースを公開してください。
テストプログラムに参加

テスト端末でオプトインURLを開き、 「テスターになる」 ボタンをクリックして登録してください。

アプリはローカルからエクスポートしたAPKではなく、そのフローで作成されたPlay Storeのリスティングからインストールしてください。
ビルドとテスト

テスト端末でPlay Storeからインストールしたビルドを起動し、購入を試行します。次のようなメッセージが表示されるはずです：

「これはテスト注文です。料金は請求されません。」

重要な注意事項

課金のQAを行う際は、Playのテスト用ビルドをインストールする前に、サイドロードしたアプリをアンインストールしておいてください。
内部テストは迅速なスモークテストには最適ですが、個人アカウントでの新規本番環境へのアクセスにはクローズドテストが不可欠です。
テストアカウントでは購入時に課金されません
テスト購入は本番環境と同じフローで行われます
トライアルや初回特典を含むすべてのサブスクリプション機能をテストできます
テスト用サブスクリプションは、テストを迅速化するために更新サイクルが短縮されています
デバイスのPlay Store、テスターのオプトイン、ライセンステストの3箇所すべてで同じGoogleアカウントを使用してください

トラブルシューティング

テストモードで製品が表示されない場合：

アプリがテストトラックにアップロードされているか確認してください
テストアカウントがライセンステストに追加されているか確認してください
Google Play Consoleで製品が有効になっているか確認してください
ビルドがローカルでサイドロードされたものではなく、Google Playからインストールされたことを確認してください

「Item not available」エラー:

商品作成後、利用可能になるまで2〜3時間待機してください
アプリのパッケージ名がPlay Consoleのものと一致することを確認してください
テストアカウントでサインインしていることを確認してください
同じパッケージ名と商品カタログを指す署名済みリリースビルドをアップロードしたことを確認してください

テスト購入が実際の課金として表示される場合:

アカウントがライセンステストに追加されているか再確認してください
テストトラックのビルドを使用していることを確認してください
購入時にテスト用のバナーが表示されることを確認してください

Android Sandbox Testingの設定から次へ

使用している場合 Android サンドボックステストの設定 ストアの承認と配信を計画するには、これを次と連携させてください： @capgo/native-purchases を使用する @capgo/native-purchasesの使用におけるネイティブ機能について @capgo/capacitor-in-app-review @capgo/capacitor-in-app-review での実装の詳細については、 @capgo/capacitor-in-app-review の使い方「@capgo/capacitor-in-app-review の使い方」のネイティブ機能については、 @capgo/capacitor-native-market @capgo/capacitor-native-market の実装の詳細については、 @capgo/capacitor-native-market の使用「@capgo/capacitor-native-market. の使用」のネイティブ機能については