نقل البيانات إلى الإصدار 7 من Google Play Billing Library من الإصدار 5 أو 6

يوضّح هذا المستند كيفية نقل البيانات من الإصدار 5 أو 6 من Google Play Billing Library إلى الإصدار 7 من Google Play Billing Library، وكيفية التكامل مع ميزات الاشتراك الاختيارية الجديدة.

للاطّلاع على قائمة كاملة بالتغييرات في الإصدار 7.0.0، يُرجى الرجوع إلى ملاحظات الإصدار.

نظرة عامة

يُحسِّن الإصدار 7 من Google Play Billing Library معالجة الدفعات لميزات الاشتراك الحالية. تتيح هذه التحسينات الاختيارية الدفع باستخدام خطط التقسيط، بالإضافة إلى عمليات الشراء المُعلّقة لاشتراكات الدفع المُسبق.

ترقية Play Billing Library المتوافقة مع الأنظمة القديمة

جميع واجهات برمجة التطبيقات الجديدة في الإصدار 7 من Google Play Billing Library اختيارية، ولا يحتاج المطوّرون إلى إجراء أي تغييرات على واجهات برمجة التطبيقات لإجراء التحديث.

لنقل البيانات، عليك تعديل مراجع واجهة برمجة التطبيقات وإزالة بعض واجهات برمجة التطبيقات من تطبيقك كما هو موضّح في ملاحظات الإصدار وفي وقت لاحق في دليل نقل البيانات هذا.

الترقية من PBL 5 إلى PBL 7

توضّح الأقسام التالية كيفية الترقية من الإصدار 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.

التعامل مع أخطاء Play Billing Library

يشير رمز NETWORK_ERROR الجديد إلى وجود مشاكل في الاتصال بالشبكة بين جهاز المستخدم ونظام Google Play.

تم أيضًا تعديل رمزَي SERVICE_TIMEOUT وSERVICE_UNAVAILABLE.

لمزيد من المعلومات، يُرجى الاطّلاع على التعامل مع رموز استجابة BillingResult.

التعامل مع المعاملات في انتظار المعالجة

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

لمزيد من المعلومات حول التعامل مع عمليات الشراء المُعلّقة، يُرجى الاطّلاع على دليل الدمج في Play Billing Library ودليل إدارة دورة حياة عمليات الشراء.

التعامل مع واجهات برمجة التطبيقات لنظام الفوترة البديل التي تمت إزالتها

تمت إزالة BillingClient.Builder.enableAlternativeBilling وAlternativeBillingListener وAlternativeChoiceDetails. استخدِم BillingClient.Builder.enableUserChoiceBilling() مع UserChoiceBillingListener وUserChoiceDetails في دالة الاستدعاء الخاصة بالمستمع بدلاً من ذلك.

يتمثّل هذا التعديل في إعادة تسمية واجهات برمجة التطبيقات المتوقّفة نهائيًا بدون إجراء أي تغييرات على السلوك.

التغييرات الاختيارية

تتضمّن الإصدار 7 من PBL واجهتَي برمجة تطبيقات اختياريتَين جديدتَين.

إتاحة عمليات الشراء المُعلّقة لخطط الدفع المُسبَق

يُرجى الاطّلاع على دليل التعامل مع الاشتراكات والمعاملات في انتظار المعالجة.

اشتراكات الأقساط الافتراضية

يُرجى الاطّلاع على دليل دمج الاشتراكات بالتقسيط.

الترقية من 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.

التعامل مع واجهات برمجة التطبيقات لنظام الفوترة البديل التي تمت إزالتها

تمت إزالة BillingClient.Builder.enableAlternativeBilling وAlternativeBillingListener وAlternativeChoiceDetails. استخدِم BillingClient.Builder.enableUserChoiceBilling() مع UserChoiceBillingListener وUserChoiceDetails في دالة الاستدعاء الخاصة بالمستمع بدلاً من ذلك.

التغييرات الاختيارية

تتضمّن الإصدار 7 من PBL واجهتَي برمجة تطبيقات اختياريتَين جديدتَين.

إتاحة عمليات الشراء المُعلّقة لخطط الدفع المُسبَق

يُرجى الاطّلاع على دليل التعامل مع الاشتراكات والمعاملات في انتظار المعالجة.

اشتراكات الأقساط الافتراضية

يُرجى الاطّلاع على دليل دمج الاشتراكات بالتقسيط للحصول على معلومات حول كيفية دمج هذه التغييرات في تطبيقك.