يوضّح هذا المستند كيفية نقل البيانات من الإصدار 5 أو 6 من Google Play Billing Library إلى الإصدار 7، وكيفية الدمج مع إمكانات الاشتراك الجديدة الاختيارية.
للاطّلاع على القائمة الكاملة بالتغييرات في الإصدار 7.0.0، يُرجى الرجوع إلى ملاحظات الإصدار.
نظرة عامة
يُحسِّن الإصدار 7 من Google Play Billing Library طريقة معالجة الدفعات مقابل ميزات الاشتراك الحالية. تضيف هذه التحسينات الاختيارية إمكانية الدفع باستخدام خطط التقسيط، بالإضافة إلى إمكانية إجراء عمليات شراء معلّقة للاشتراكات المدفوعة مسبقًا.
ترقية Play Billing Library المتوافقة مع الإصدارات القديمة
جميع واجهات برمجة التطبيقات الجديدة في الإصدار 7 من Google Play Billing Library اختيارية، ولا يحتاج المطوّرون إلى تنفيذ أي تغييرات على واجهات برمجة التطبيقات لإجراء التحديث.
لنقل البيانات، عليك تعديل مراجع واجهة برمجة التطبيقات وإزالة بعض واجهات برمجة التطبيقات من تطبيقك كما هو موضّح في ملاحظات الإصدار وفي دليل نقل البيانات هذا.
الترقية من 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 Billing Library ودليل إدارة مراحل نشاط عمليات الشراء.
التعامل مع واجهات برمجة التطبيقات لنظام الفوترة البديل التي تمت إزالتها
تمت إزالة BillingClient.Builder.enableAlternativeBilling وAlternativeBillingListener وAlternativeChoiceDetails.
على المطوّرين استخدام BillingClient.Builder.enableUserChoiceBilling() مع UserChoiceBillingListener وUserChoiceDetails في معاودة الاتصال الخاصة بمتتبّع الحدث بدلاً من ذلك.
هذا التعديل هو إعادة تسمية لواجهات برمجة التطبيقات المتوقفة نهائيًا بدون أي تغييرات في السلوك.
التغييرات الاختيارية
يتضمّن الإصدار 7 من PBL واجهتَي برمجة تطبيقات اختياريتَين جديدتَين.
إتاحة عمليات الشراء المعلقة في خطط الدفع المُسبق
راجِع دليل التعامل مع الاشتراكات والمعاملات المعلّقة.
الاشتراكات في خدمة "الأقساط الافتراضية"
راجِع دليل دمج الاشتراكات بالتقسيط.
الترقية من الإصدار 6 من "برنامج بناء القدرات" إلى الإصدار 7
توضّح الأقسام التالية كيفية الترقية من الإصدار 6 إلى الإصدار 7 من "برنامج الشركاء من ناشري Google".
تحديث 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 في معاودة الاتصال الخاصة بمتتبّع الحدث بدلاً من ذلك.
التغييرات الاختيارية
يتضمّن الإصدار 7 من PBL واجهتَي برمجة تطبيقات اختياريتَين جديدتَين.
إتاحة عمليات الشراء المعلقة في خطط الدفع المُسبق
راجِع دليل التعامل مع الاشتراكات والمعاملات المعلّقة.
الاشتراكات في خدمة "الأقساط الافتراضية"
راجِع دليل دمج الاشتراكات بالتقسيط للحصول على معلومات حول كيفية دمج هذه التغييرات في تطبيقك.