Reminder: By Aug 31, 2025, all new apps and updates to existing apps must use Billing Library version 7 or newer. If you need more time to update your app, you can request an extension until Nov 1, 2025. Learn about Play Billing Library version deprecation.
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Biblioteka płatności w Play zwraca odpowiedź BillingResult, aby umożliwić Ci
poznać wynik wywołanego działania. Więcej informacji znajdziesz w artykule Obsługa kodów odpowiedzi BillingResult. Zanim wdrożysz aplikację w środowisku produkcyjnym, możesz przetestować różne przepływy odpowiedzi za pomocą symulatora odpowiedzi.
Symulator odpowiedzi
Po zintegrowaniu aplikacji z Biblioteką płatności w Play może być trudno przetestować wszystkie przepływy BillingResponseCode, ponieważ nie masz zbyt dużego wpływu na komunikację między Sklepem Play a systemem backendowym.
Symulator odpowiedzi w aplikacji Play Billing Lab pozwala
skonfigurować odpowiedzi w postaci kodów błędów na potrzeby Biblioteki płatności w Play, aby przetestować różne złożone elementy
i scenariuszy błędów.
Włącz testowanie zastępowania płatności w Bibliotece płatności w Google Play
Aby umożliwić komunikację między symulatorem odpowiedzi a aplikacją, musisz włączyć testowanie zastąpienia płatności w Bibliotece płatności w Google Play z poziomu aplikacji. W tym celu dodaj do pliku AndroidManifest.xml aplikacji te tagi metadanych.
Przy wdrażaniu aplikacji w środowisku produkcyjnym wykonaj jedną z tych czynności:
użyj osobnego pliku AndroidManifest.xml, który nie zawiera tych atrybutów
tagów metadanych lub upewnij się, że zostały one usunięte z sekcji
AndroidManifest.xml.
Symulowanie błędów Biblioteki płatności w Play
Aby zasymulować błędy Biblioteki płatności w Play, najpierw skonfiguruj kody odpowiedzi
w aplikacji Play Billing Lab, a następnie przetestuj aplikację.
Konfigurowanie kodu odpowiedzi
W aplikacji Play Billing Lab zaloguj się na konto testowe dla swojej aplikacji.
W ten sposób wyświetlisz panel Play Billing Lab, w tym kartę Symulator odpowiedzi.
Rysunek 1. Karta symulatora odpowiedzi
Na karcie symulatora odpowiedzi kliknij Zarządzaj.
Wyświetla się ekran Symulator odpowiedzi.
Gdy pojawi się odpowiedni komunikat, zezwól na powiadomienia z Laboratorium płatności w Play, aby sprawdzić stan połączenia Twojej aplikacji.
Włącz przełącznik Symulowanie odpowiedzi Biblioteki Google Play, jeśli nie jest jeszcze włączony.
Rysunek 2. Przełącznik symulowania odpowiedzi Biblioteki płatności w Google Play.
Wybierz kod odpowiedzi odpowiednich interfejsów API Biblioteki płatności w Play
do testów.
Wybrane opcje zostaną automatycznie zapisane, a symulator odpowiedzi
jest gotowy do wysłania wybranych kodów odpowiedzi do Twojej aplikacji.
Testowanie obsługi błędów w aplikacji
Otwórz aplikację.
Jeśli zezwolisz na powiadomienia z Laboratorium płatności w Play, na pasku stanu urządzenia zobaczysz ikonę powiadomień z Laboratorium płatności w Play. Oznacza to, że udało się połączyć z symulatorem odpowiedzi.
Rysunek 3. Ikona laboratorium rozliczeń w Google Play informująca o udanym połączeniu.
Wywołaj metodę interfejsu API Biblioteki płatności w Google Play, którą chcesz przetestować. Przykład:
Jeśli chcesz przetestować launchBillingFlow, rozpocznij zakup w aplikacji
przepływu danych.
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-27 UTC.
[null,null,["Ostatnia aktualizacja: 2025-07-27 UTC."],[],[],null,["# Test BillingResult response codes\n\nThe Play Billing Library returns a [`BillingResult`](/reference/com/android/billingclient/api/BillingResult) response to let you\nknow the outcome of an action that was triggered. For more\ninformation, see [handling `BillingResult` response codes](/google/play/billing/errors). Before you\ndeploy your app to the production environment, you can test your app's various\nresponse flows by using the Response Simulator.\n\nResponse Simulator\n------------------\n\nWhen you integrate your app with the Play Billing Library, it can be difficult\nto test all of the [`BillingResponseCode`](/reference/com/android/billingclient/api/BillingClient.BillingResponseCode) flows, because you don't have much\ncontrol over the communication between the Play Store and Play's backend.\nThe Response Simulator feature in the [Play Billing Lab](https://play.google.com/store/apps/details?id=com.google.android.apps.play.billingtestcompanion) app lets you\nconfigure error code responses for the Play Billing Library to test various complex\nerror scenarios.\n\n### Enable billing overrides testing for the Play Billing Library\n\n| **Note:** Before testing, ensure that your app is using [Play Billing Library](/google/play/billing/integrate#dependency) version 7.1.1 or later.\n\nTo enable communication between the Response Simulator and your app,\nyou must enable billing overrides testing for the Play Billing Library\nfrom within your app. To do this, add the following metadata tags to your app's\n`AndroidManifest.xml` file. \n\n```scdoc\n\u003cmanifest ... \u003e\n \u003capplication ... \u003e\n ...\n \u003cmeta-data\n android:name=\"com.google.android.play.largest_release_audience.NONPRODUCTION\"\n android:value=\"\" /\u003e\n \u003cmeta-data\n android:name=\"com.google.android.play.billingclient.enableBillingOverridesTesting\"\n android:value=\"true\" /\u003e\n \u003c/application\u003e\n\u003c/manifest\u003e\n```\n| **Note:** Even though adding only the `enableBillingOverridesTesting` tag and setting it to `true` is sufficient to enable billing overrides testing for your app, it's recommended that you also add the `NONPRODUCTION` tag. The `NONPRODUCTION` tag prevents accidental deployment of your app to the production environment with billing overrides testing enabled.\n\nWhen you deploy your app to the production environment, you should either\nuse a separate `AndroidManifest.xml` file that doesn't include these\nmetadata tags or ensure that you've removed these tags from the\n`AndroidManifest.xml` file.\n\n### Simulate Play Billing Library errors\n\nTo simulate Play Billing Library errors, first, configure the response codes\nin the [Play Billing Lab](https://play.google.com/store/apps/details?id=com.google.android.apps.play.billingtestcompanion) app, and then test your app.\n\n#### Configure a response code\n\n1. In the Play Billing Lab app, sign in with a [license tester](/google/play/billing/test#license-testers) account for your app.\n This displays the Play Billing Lab **Dashboard** including\n the **Response Simulator** card.\n\n **Figure 1.** Response Simulator card.\n2. Click **Manage** on the Response Simulator card.\n This shows the **Response Simulator** screen.\n\n3. When prompted, allow notifications from Play Billing Lab to see the connection status of your app.\n\n4. Enable the **Simulate Play Billing Library responses** switch, if it isn't\n already enabled.\n\n **Figure 2.** Simulate Play Billing Library responses switch.\n5. Select a response code for the Play Billing Library APIs that you want\n to test.\n Your selections are automatically saved, and the Response Simulator\n is ready to send the selected response codes to your app.\n\n#### Test your app's error handling\n\n| **Note:** When testing using the Response Simulator, ensure that you first open Play Billing Lab, and then open your app. Opening your app before opening Play Billing Lab may result in issues connecting to the Response Simulator.\n\n1. Open your app.\n\n - If you have allowed notifications from Play Billing Lab, you will see the Play Billing Lab notification icon in your device's status bar which indicates a successful connection to the Response Simulator.\n\n **Figure 3.** Play Billing Lab icon indicating successful connection.\n2. Trigger the Play Billing Library API method you want to test. For example,\n if you want to test the `launchBillingFlow`, initiate an in-app purchase\n flow."]]
