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