اختبار رموز استجابة BillingResult

تعرض Play Billing Library الرد BillingResult من أجل السماح لك بذلك. معرفة نتيجة إجراء تم تشغيله. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة معالجة رموز الاستجابة BillingResult. قبل نشر تطبيقك في بيئة الإنتاج، يمكنك اختبار مختلف عمليات الاستجابة لتطبيقك باستخدام "محاكي الاستجابة".

أداة محاكاة الاستجابة

عند دمج تطبيقك مع Play Billing Library، قد يكون من الصعب لاختبار كل مسارات BillingResponseCode، لأنه لا يتوفر لديك الكثير التحكم في الاتصال بين "متجر Play" وخلفية Play. تتيح لك ميزة "محاكي الردود" في تطبيق Play Billing Lab ضبط الردود على رموز الخطأ في مكتبة Play Billing Library لاختبار سيناريوهات خطأ معقدة مختلفة.

تفعيل اختبار إلغاءات الفوترة في "مكتبة الفوترة في Play"

ملاحظة: قبل الاختبار، تأكَّد من أنّ تطبيقك يستخدم الإصدار 7.1.0 أو إصدارًا أحدث من مكتبة الفوترة في Play.

لتمكين التواصل بين محاكي الاستجابة وتطبيقك، يجب تفعيل اختبار إلغاءات الفوترة في Play Billing Library من داخل تطبيقك. لإجراء ذلك، أضِف علامات البيانات الوصفية التالية إلى علامة التبويب الخاصة بتطبيقك. ملف AndroidManifest.xml.

<manifest ... >
  <application ... >
    ...
     <meta-data
      android:name="com.google.android.play.largest_release_audience.NONPRODUCTION"
      android:value="" />
    <meta-data
      android:name="com.google.android.play.billingclient.enableBillingOverridesTesting"
      android:value="true" />
  </application>
</manifest>

ملاحظة: على الرغم من أن إضافة علامة enableBillingOverridesTesting فقط و يكفي ضبطها على true لتفعيل اختبار عمليات إلغاء الفوترة. لتطبيقك، ننصحك أيضًا بإضافة العلامة NONPRODUCTION. تمنع العلامة NONPRODUCTION النشر غير المقصود لتطبيقك في بيئة الإنتاج التي تم فيها تفعيل اختبار إلغاءات الفوترة.

عند نشر تطبيقك في بيئة الإنتاج، عليك تنفيذ أحد الإجراءَين التاليَين: استخدِم ملف AndroidManifest.xml منفصلاً لا يتضمّن هذه الملفات البيانات الوصفية أو التأكد من إزالة هذه العلامات من ملف AndroidManifest.xml.

محاكاة أخطاء Play Billing Library

لمحاكاة أخطاء مكتبة Play Billing Library، عليك أولاً ضبط رموز الاستجابة في تطبيق Play Billing Lab، ثم اختبار تطبيقك.

إعداد رمز استجابة

1. في تطبيق Play Billing Lab، سجِّل الدخول باستخدام حساب مختبِر ترخيص لتطبيقك. يعرِض هذا العمود لوحة البيانات في Play Billing Lab، بما في ذلك بطاقة محاكي الاستجابة.

   

   الشكل 1. بطاقة "محاكي الردود"

2. انقر على إدارة في بطاقة "محاكي الاستجابة". سيؤدي ذلك إلى عرض شاشة محاكي الردود.

3. اسمح بالإشعارات من الميزة الاختبارية "الفوترة في Play" عندما يُطلب منك ذلك للاطّلاع على حالة ربط تطبيقك.

4. فعِّل مفتاح التبديل محاكاة ردود Google Play Billing Library، إذا لم يكن مفعّلاً بالفعل.

   

   الشكل 2. محاكاة مفتاح تبديل الردود في Play Billing Library

5. اختَر رمز استجابة لواجهات برمجة تطبيقات Play Billing Library التي تريد اختبارها. يتم حفظ اختياراتك تلقائيًا، ويكون "محاكي الردود" جاهزًا لإرسال رموز الردود المحدّدة إلى تطبيقك.

اختبار معالجة الأخطاء في تطبيقك

ملاحظة: عند إجراء الاختبار باستخدام "محاكي الردود"، تأكَّد أولاً من فتح Play Billing Lab، ثم فتح تطبيقك. قد يؤدي فتح تطبيقك قبل فتح Play Billing Lab إلى حدوث مشاكل في الاتصال بـ "محاكي الردود".

1. فتح التطبيق

   • إذا سمحت بالإشعارات الواردة من "ميزة الفوترة التجريبية" في Play، سيظهر رمز إشعار "ميزة الفوترة التجريبية" في شريط حالة جهازك، ما يشير إلى نجاح الاتصال بـ "محاكي الردود".

   

   الشكل 3. رمز الميزة الاختبارية "الفوترة في Play" يشير إلى نجاح عملية الاتصال

2. شغِّل طريقة واجهة برمجة التطبيقات Play Billing Library API التي تريد اختبارها. على سبيل المثال، إذا كنت تريد اختبار launchBillingFlow، ابدأ عملية شراء داخل التطبيق .