يوضّح هذا المستند كيفية نقل البيانات من الإصدار 5 أو 6 من Google Play Billing Library إلى Google Play Billing Library 7 وكيف يمكن دمج الإصدار الاختياري الجديد إمكانات الاشتراك
للحصول على قائمة كاملة بالتغييرات في الإصدار 7.0.0، يمكنك الرجوع إلى الإصدار الملاحظات.
نظرة عامة
تحسين طريقة معالجة الدفعات في الإصدار 7 من Google Play Billing Library ميزات الاشتراك الحالية. هذه التحسينات الاختيارية يمكنك إضافة ميزة الدفع باستخدام خطط تقسيط دعم عمليات الشراء المُعلّقة لاشتراكات الدفع المُسبَق.
ترقية متوافقة مع الإصدارات القديمة من Play Billing Library
جميع واجهات برمجة التطبيقات Google Play Billing Library 7 الجديدة اختيارية، ولا يحتاج المطورون إلى تنفيذ أي تغييرات في واجهة برمجة التطبيقات لإجراء التحديث.
لنقل البيانات، عليك تعديل مراجع واجهة برمجة التطبيقات وإزالتها. بعض واجهات برمجة التطبيقات من تطبيقك كما هو موضَّح في ملاحظات الإصدار ولاحقًا في هذا القسم دليل الترحيل.
الترقية من PBL 5 إلى PBL 7
توضح الأقسام التالية كيفية الترقية من PBL 5 إلى PBL 7.
تعديل Google Play Billing Library
تحديث إصدار الاعتمادية على Play Billing Library في
ملف build.gradle لتطبيقك.
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
بعد ذلك، عدِّل مراجع واجهة برمجة التطبيقات كما هو موضّح في الأقسام التالية.
تغيير عمليات شراء اشتراكات المستخدم
الإصدار 5 من Play Billing Library والإصدارات الأقدم ProrationMode
لتطبيق تغييرات على عمليات شراء اشتراكات المستخدم، مثل الترقيات
أو الرجوع إلى إصدار سابق. تمّت إزالة واجهة برمجة التطبيقات هذه واستبدالها
ReplacementMode
التعامل مع التغييرات في أسعار الاشتراكات
وتمت إزالة واجهة برمجة تطبيقات launchPriceConfirmationFlow التي سبق أن تم إيقافها نهائيًا.
للحصول على خيارات بديلة، يمكنك الاطّلاع على تغييرات الأسعار.
الدليل.
التعامل مع التغييرات في واجهة برمجة التطبيقات المتعلقة بالاشتراكات
واجهات برمجة التطبيقات setOldSkuPurchaseToken التي تم إيقافها نهائيًا سابقًا
تمت إزالة setReplaceProrationMode وsetReplaceSkusProrationMode.
- عدِّل
setOldSkuPurchaseTokenإلىsetOldPurchaseToken. - تحديث
setReplaceProrationModeإلىsetSubscriptionReplacementMode - تحديث
setReplaceSkusProrationModeإلىsetSubscriptionReplacementMode
التعامل مع أخطاء Play Billing Library
رمز NETWORK_ERROR جديد يشير إلى مشاكل في الاتصال بالشبكة
بين جهاز المستخدم ونظام Google Play.
تم أيضًا تعديل الرمزين SERVICE_TIMEOUT وSERVICE_UNAVAILABLE.
لمزيد من المعلومات، يُرجى مراجعة التعامل مع رموز الاستجابة لـ BillingResult.
التعامل مع المعاملات غير المكتملة
لم تعُد "مكتبة الفوترة في Play" تنشئ مُعرّف طلب لعمليات الشراء المعلَّقة.
بالنسبة إلى عمليات الشراء هذه، تتمّ تعبئة مُعرّف الطلب بعد نقل عملية الشراء.
إلى الحالة PURCHASED. التأكد من أن عملية الدمج تتوقع
مُعرّف الطلب فقط بعد اكتمال المعاملة بالكامل. لا يزال بإمكانك استخدام
رمز الشراء لسجلاتك.
لمزيد من المعلومات حول التعامل مع عمليات الشراء المُعلّقة، يُرجى الاطّلاع على دليل دمج "مكتبة الفوترة في Play" دليل إدارة مراحل نشاط الشراء
معالجة واجهات برمجة التطبيقات لنظام الفوترة البديل التي تمت إزالتها
تمت إزالة BillingClient.Builder.enableAlternativeBilling،
AlternativeBillingListener,
وAlternativeChoiceDetails.
على المطوّرين استخدام BillingClient.Builder.enableUserChoiceBilling() مع UserChoiceBillingListener.
وUserChoiceDetails
في معاودة اتصال المستمع بدلاً من ذلك.
يهدف هذا التحديث إلى إعادة تسمية واجهات برمجة التطبيقات المتوقّفة نهائيًا بدون أي تغييرات في السلوك.
التغييرات الاختيارية
يشتمل الإصدار PBL 7 على واجهتَي برمجة تطبيقات اختياريتَين جديدتَين.
دعم عمليات الشراء المعلّقة في خطط الدفع المُسبق
يمكنك الاطّلاع على دليل التعامل مع الاشتراكات والمعاملات المعلّقة.
اشتراكات الأقساط الافتراضية
يمكنك الاطّلاع على دليل دمج اشتراكات الأقساط.
الترقية من PBL 6 إلى PBL 7
توضح الأقسام التالية كيفية الترقية من PBL 6 إلى PBL 7.
تعديل Google Play Billing Library
تحديث إصدار الاعتمادية على Play Billing Library في
ملف build.gradle لتطبيقك.
dependencies {
def billingVersion = 7.0.0
implementation "com.android.billingclient:billing:$billingVersion"
}
بعد ذلك، عدِّل مراجع واجهة برمجة التطبيقات كما هو موضّح في الأقسام التالية.
التعامل مع التغييرات في واجهة برمجة التطبيقات المتعلقة بالاشتراكات
واجهات برمجة التطبيقات setOldSkuPurchaseToken التي تم إيقافها نهائيًا سابقًا
تمت إزالة setReplaceProrationMode وsetReplaceSkusProrationMode.
- عدِّل
setOldSkuPurchaseTokenإلىsetOldPurchaseToken. - تحديث
setReplaceProrationModeإلىsetSubscriptionReplacementMode - تحديث
setReplaceSkusProrationModeإلىsetSubscriptionReplacementMode
معالجة واجهات برمجة التطبيقات لنظام الفوترة البديل التي تمت إزالتها
تمت إزالة BillingClient.Builder.enableAlternativeBilling،
AlternativeBillingListener
وAlternativeChoiceDetails.
على المطوّرين استخدام BillingClient.Builder.enableUserChoiceBilling() مع UserChoiceBillingListener.
وUserChoiceDetails
في معاودة اتصال المستمع بدلاً من ذلك.
التغييرات الاختيارية
يشتمل الإصدار PBL 7 على واجهتَي برمجة تطبيقات اختياريتَين جديدتَين.
دعم عمليات الشراء المعلّقة في خطط الدفع المُسبق
يمكنك الاطّلاع على دليل التعامل مع الاشتراكات والمعاملات المعلّقة.
اشتراكات الأقساط الافتراضية
يمكنك مراجعة دليل دمج اشتراكات الأقساط من أجل معلومات حول كيفية دمج هذه التغييرات في تطبيقك.