Android Sandbox Testing konfigurieren

Für das Testen von In-App-Käufen ist eine korrekte Konfiguration in der Google Play Console erforderlich. Dieser Guide zeigt dir, wie du das Sandbox-Testing für deine Android-App einrichtest.

Nutze den passenden Build

Bevor du startest, unterscheide zwischen diesen drei Android-Build-Typen:

• Lokaler Debug-/Dev-Build: Ideal, um UI und native Integrationen auf dem Gerät zu prüfen.
• Signiertes Release-AAB in die Play Console hochgeladen: Erforderlich für realistische Google Play Billing-Tests.
• Über Play installierter Test-Build: Der Build, den deine Tester aus einem internen oder geschlossenen Track installieren. Nutze ihn für die Purchase-QA.

Wenn du lediglich ein APK aus Android Studio sideloadest oder adb, verhält sich Google Play Billing möglicherweise nicht wie in der Produktion. Teste für die Validierung von Abonnements und In-App-Käufen immer mit einem Build, der über Google Play installiert wurde.

Voraussetzungen

• Ein Google Play Console Developer-Account. Falls du noch keinen hast, starte hier: Play-Console-Registrierung.
• Ein in der Play Console erstellter App-Eintrag mit deinem finalen Android Package-Namen
• Deine in der Play Console erstellten In-App-Produkte oder Abonnements
• Ein Test-Gmail-Konto, das du zu den Lizenztests hinzufügen kannst
• Ein signierter Release-Build bereit zum Upload

Bevor du Zeit in das Billing-Setup investierst, erstelle die App in der Play Console und entscheide, ob sie kostenlos oder paid. Google lets you move a paid app to free later, but once an app has been offered for free, it cannot be switched to paid.

Verwende ein Android App Bundle (.aab) für neue Play Store Apps:

bunx cap sync android
cd android
./gradlew bundleRelease

Stelle sicher, dass deine Android Release-Signierung bereits konfiguriert ist, bevor du bundleReleaseausführst. Falls dein Keystore, die Signing-Config oder die Release-Passwörter noch nicht gesetzt sind, erstelle das signierte Bundle in Android Studio über Build > Signed App Bundle / APK erstellen, wo du nach diesen Werten gefragt wirst.

Setup-Prozess

1. Testkonto hinzufügen

   Öffne in der Play Console Einstellungen > Lizenztest und füge das primäre Google-Konto hinzu, das auf deinem Android-Testgerät verwendet wird.

   So wird sichergestellt, dass Käufe den Play-Sandbox-Flow anzeigen, anstatt eine echte Zahlung zu versuchen.

   

2. Wähle einen Test-Track

   Gehe zu Testen und Veröffentlichen > Testen und wähle einen dieser Tracks aus:

   • Internes Testen: Schnellster Weg für QA und Billing-Smoke-Tests. Neue Bundles sind normalerweise innerhalb von Minuten verfügbar.
   • Geschlossener Test: Besser für breiteres Testen; erforderlich vor dem Production-Release für persönliche Developer-Accounts, die nach dem 13. November 2023 erstellt wurden.

   Bei einem ersten Release zeigt Play internen Testern möglicherweise bis zu 48 Stunden lang einen temporären App-Namen und Listungsinformationen an.

   

3. Testerliste erstellen

   Erstelle nach dem Öffnen deines Tracks eine Testerliste und füge die Google-Konten hinzu, die den Build erhalten sollen.

   Wenn du auf den Produktionszugriff für ein neues privates Konto hinarbeitest, stelle sicher, dass du geschlossenen Test hochladen und mindestens 12 Tester für 14 aufeinanderfolgende Tage angemeldet hältst.

   

4. Signed Release Build hochladen

   Erstelle ein neues Release im ausgewählten Testtrack und lade deinen signierten Build hoch. .aab.

   Neue Google Play Apps sollten ein Android App Bundle statt eines APKs verwenden. Speichere nach dem Upload das Release, behebe etwaige Richtlinien- oder Store-Listing-Fehler, die Google Play meldet, und veröffentliche das Release im Testtrack.

   

5. Am Testprogramm teilnehmen

   Öffne die Opt-in-URL auf deinem Testgerät und klicke auf den „Tester werden“- Button, um dich anzumelden.

   Installiere die App aus dem Play Store Eintrag, der durch den Opt-in-Flow erstellt wurde, nicht über eine lokal exportierte APK.

   

6. Build und Test

   Starte den über den Play Store installierten Build auf dem Testgerät und versuche einen Kauf. Du solltest eine Meldung wie diese sehen:

   „Dies ist eine Testbestellung; es werden keine Kosten berechnet.“

   

Wichtige Hinweise

• Für die Abrechnungs-QA deinstalliere alle sideloaded Kopien der App, bevor du den Play-Testing-Build installierst.
• Internes Testen ist super für schnelle Smoke Tests, aber Closed Testing ist der Track, der für den Produktionszugriff neuer persönlicher Accounts zählt.
• Test-Accounts werden bei Käufen nicht belastet
• Testkäufe laufen über denselben Flow wie Produktionskäufe
• Du kannst alle Abo-Features inklusive Testphasen und Einführungsangeboten testen
• Test-Abos haben verkürzte Erneuerungszeiträume für schnelleres Testen
• Nutze denselben Google-Account an allen drei Stellen: im Play Store auf dem Gerät, im Tester-Opt-in-Flow und bei License Testing

Fehlerbehebung

Produkte werden im Testmodus nicht angezeigt:

• Stelle sicher, dass deine App auf einem Test-Track hochgeladen wurde
• Prüfe, ob der Test-Account zu License Testing hinzugefügt wurde
• Prüfe, ob die Produkte in der Google Play Console aktiv sind
• Bestätigen Sie, dass der Build über Google Play installiert wurde und nicht per Sideloading

Fehler „Item not available“:

• Warten Sie 2–3 Stunden nach der Erstellung der Produkte, bis diese verfügbar sind
• Stelle sicher, dass der Paketname deiner App mit dem in der Play Console übereinstimmt
• Prüfen Sie, ob Sie mit einem Testkonto angemeldet sind
• Stellen Sie sicher, dass Sie den signierten Release-Build mit dem gleichen Package Name und Produktkatalog hochgeladen haben

Testkäufe werden als echte Abbuchungen angezeigt:

• Prüfen Sie, ob das Konto für das License Testing hinzugefügt wurde
• Stellen Sie sicher, dass Sie den Build aus dem Testing Track verwenden
• Prüfen Sie, ob der Test-Banner während des Kaufs erscheint

Weitere Ressourcen

• Testkäufe mit Google Play Billing testen
• Einen offenen, geschlossenen oder internen Test einrichten
• Testanforderungen für neue persönliche Entwicklerkonten

Weiterlesen: Android Sandbox Testing konfigurieren

Wenn du es nutzt Android Sandbox Testing konfigurieren um Store-Zulassung und Distribution zu planen, verknüpfen Sie es mit @capgo/native-purchases verwenden für die native Funktionalität bei der Nutzung von @capgo/native-purchases, @capgo/capacitor-in-app-review für die Implementierungsdetails in @capgo/capacitor-in-app-review, @capgo/capacitor-in-app-review nutzen für die native Funktion bei der Nutzung von @capgo/capacitor-in-app-review, @capgo/capacitor-native-market für das Implementierungsdetail in @capgo/capacitor-native-market, und @capgo/capacitor-native-market nutzen für die native Funktionalität bei der Nutzung von @capgo/capacitor-native-market.