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 Billing Library استجابة BillingResult لإعلامك
بنتيجة الإجراء الذي تم تشغيله. لمزيد من المعلومات،
معلومات، راجِع التعامل مع رموز الاستجابة BillingResult. قبل
نشر التطبيق في بيئة الإنتاج، يمكنك اختبار مختلف أقسام
وتدفقات الاستجابة باستخدام محاكي الاستجابة.
محاكي الاستجابة
عند دمج تطبيقك مع Play Billing Library، قد يكون من الصعب
لاختبار كل مسارات BillingResponseCode، لأنه لا يتوفر لديك الكثير
التحكم في الاتصال بين "متجر Play" وخلفية Play.
تتيح لك ميزة محاكي الاستجابات في تطبيق Play Billing Lab
يمكنك إعداد استجابات رموز الخطأ لـ Play Billing Library لاختبار العديد من التطبيقات المعقّدة.
سيناريوهات الأخطاء المختلفة.
تفعيل اختبار إلغاءات الفوترة في "مكتبة الفوترة في Play"
لتفعيل الاتصالات بين "محاكي الردود" وتطبيقك،
يجب تفعيل اختبار عمليات إلغاء الفوترة في "مكتبة الفوترة في Play"
من داخل تطبيقك. لإجراء ذلك، أضِف علامات البيانات الوصفية التالية إلىملف
AndroidManifest.xml الخاص بتطبيقك.
عند نشر تطبيقك في بيئة الإنتاج، عليك إما
استخدام ملف AndroidManifest.xml منفصل لا يتضمّن علامات البيانات الوصفية هذه
أو التأكّد من إزالة هذه العلامات منملف
AndroidManifest.xml.
محاكاة أخطاء "مكتبة الفوترة في Play"
لمحاكاة أخطاء Play Billing Library، عليك أولاً ضبط رموز الاستجابة.
في التطبيق Play Billing Lab ثم اختبِر تطبيقك.
إعداد رمز استجابة
في تطبيق Play Billing Lab، سجِّل الدخول باستخدام حساب مختبِر ترخيص لتطبيقك.
يعرِض هذا العمود لوحة البيانات في Play Billing Lab، بما في ذلك
بطاقة محاكي الاستجابة.
الشكل 1. بطاقة محاكاة الردود
انقر على إدارة في بطاقة "محاكي الاستجابة".
سيؤدي ذلك إلى عرض شاشة محاكي الردود.
اسمح بالإشعارات الواردة من "برنامج Play Billing Lab" للاطّلاع على حالة ربط تطبيقك عندما يُطلب منك ذلك.
تفعيل مفتاح التبديل محاكاة الردود في Play Billing Library إذا لم يكن مفعَّلاً
مُفعَّلة حاليًا.
الشكل 2. محاكاة مفتاح تبديل الردود في Play Billing Library
اختيار رمز الاستجابة المطلوب لواجهات برمجة تطبيقات Play Billing Library
للاختبار.
يتم حفظ اختياراتك تلقائيًا، ويكون "محاكي الردود"
جاهزًا لإرسال رموز الردود المحدّدة إلى تطبيقك.
اختبار طريقة معالجة الأخطاء في التطبيق
فتح التطبيق
في حال السماح بالإشعارات من برنامج "الفوترة في Play"، سيظهر لك رمز الإشعار المعني بهذه الميزة في شريط الحالة على جهازك، ما يشير إلى نجاح الاتصال بمحاكي الاستجابة.
الشكل 3. رمز "برنامج Play Billing Lab" يشير إلى نجاح عملية الربط
شغِّل طريقة واجهة برمجة التطبيقات Play Billing Library API التي تريد اختبارها. على سبيل المثال،
إذا كنت تريد اختبار launchBillingFlow، ابدأ عملية شراء
داخل التطبيق.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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."]]