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.
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
ספריית החיובים ב-Play מחזירה את התשובה BillingResult כדי לאפשר לך
לדעת מה התוצאה של פעולה שהופעלה. לקבלת מידע נוסף
למידע נוסף, ראו טיפול בקודי תגובה של BillingResult. לפני שמתחילים
לפרוס את האפליקציה שלכם בסביבת הייצור, תוכלו לבדוק את
זורמים באמצעות סימולטור התגובה.
סימולטור תגובות
כשמשלבים את האפליקציה עם ספריית החיובים ב-Play, יכול להיות קשה
לבדוק את כל התהליכים של BillingResponseCode, כי אין לכם
שליטה בתקשורת בין חנות Play לקצה העורפי של Play.
התכונה Response Simulator באפליקציה Play Billing Lab מאפשרת להגדיר תגובות לקודי שגיאה בספריית החיוב ב-Play כדי לבדוק תרחישי שגיאה מורכבים שונים.
הפעלת החיוב מבטלת את הבדיקה של ספריית החיוב ב-Play
כדי לאפשר תקשורת בין סימולטור התשובות לבין האפליקציה, צריך להפעיל את בדיקת החיובים המנוגדים לספריית החיובים ב-Play מתוך האפליקציה. לשם כך, מוסיפים את תגי המטא-נתונים הבאים לקובץ AndroidManifest.xml של האפליקציה.
כשפורסים את האפליקציה בסביבת הייצור, צריך להשתמש בקובץ AndroidManifest.xml נפרד שלא כולל את תגי המטא-נתונים האלה, או לוודא שהסרתם את התגים האלה מקובץ AndroidManifest.xml.
סימולציה של שגיאות בספריית החיוב ב-Play
כדי לדמות שגיאות בספריית החיובים ב-Play, קודם צריך להגדיר את קודי התגובה
באפליקציה Play Billing Lab, ולאחר מכן לבדוק את האפליקציה.
הגדרת קוד תגובה
באפליקציית Play Billing Lab, נכנסים באמצעות חשבון בודק רישיונות של האפליקציה. תוצג לוח הבקרה של Play Billing Lab, כולל הכרטיס סימולטור התשובות.
איור 1. כרטיס של סימולטור התגובות.
לוחצים על ניהול בכרטיס של סימולטור התשובות.
הלחיצה תפתח את המסך של סימולטור התגובות.
כשמוצגת בקשה, מאשרים לקבל התראות מ-Play Billing Lab כדי לראות את סטטוס החיבור של האפליקציה.
מפעילים את המתג Simulate Billing Library (Simulate Billing Library) אם הוא לא מופעל
כבר מופעל.
איור 2. סימולציה של מעבר בין התשובות של ספריית החיוב ב-Play.
בוחרים את קוד התגובה של ממשקי ה-API של Play Billing Library שרוצים לבדוק.
הבחירות שלכם נשמרות באופן אוטומטי וסימולטור התגובות
מוכן לשלוח את קודי התגובה שנבחרו לאפליקציה שלך.
בדיקת הטיפול בשגיאות באפליקציה
פותחים את האפליקציה.
אם אישרתם קבלת התראות מ-Play Billing Lab, סמל ההתראות של 'מעבדת החיוב ב-Play' יופיע בשורת הסטטוס של המכשיר כדי לציין חיבור מוצלח לסימולטור התגובות.
איור 3. סמל של תכונת ה-Labs לחיוב ב-Play שמציין חיבור מוצלח.
מפעילים את ה-method של ספריית החיוב של Play שרוצים לבדוק. לדוגמה, אם רוצים לבדוק את launchBillingFlow, מפעילים תהליך רכישה מתוך האפליקציה.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[null,null,["עדכון אחרון: 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."]]
