انتقال دادن به «کتابخانه خدمات صورت‌حساب Google Play» نسخه ۸ از نسخه‌های ۶ یا ۷

این سند نحوه انتقال از «کتابخانه خدمات صورت‌حساب Google Play» ‏ (PBL) نسخه ۶ یا ۷ به PBL نسخه ۸ و نحوه ادغام با قابلیت‌های اختیاری جدید اشتراک را شرح می‌دهد.

برای مشاهده فهرست کامل تغییرات در نسخه ۸.۰.۰، به یادداشت‌های انتشار مراجعه کنید.

نمای کلی

‫PBL 8 شامل بهبودهایی در میاناهای برنامه‌سازی کاربردی موجود و همچنین حذف میاناهای برنامه‌سازی کاربردی منسوخ‌شده قبلی است. این نسخه از کتابخانه همچنین شامل میاناهای برنامه‌سازی کاربردی جدیدی برای محصولات یک‌باره است.

سازگاری با نسخه قدیمی برای ارتقای PBL

برای انتقال به PBL 8، باید برخی‌از مراجع میانای برنامه‌سازی کاربردی موجود را از برنامه‌تان به‌روزرسانی یا حذف کنید، همان‌طور که در یادداشت‌های انتشار و بعداً در این راهنمای انتقال توضیح داده شده است.

ارتقا دادن از PBL 6 یا 7 به PBL 8

برای ارتقا دادن از «کتابخانه خدمات صورت‌حساب Play» نسخه ۶ یا ۷ به «کتابخانه خدمات صورت‌حساب Play» نسخه ۸، مراحل زیر را انجام دهید:

  1. نسخه وابستگی «کتابخانه خدمات صورت‌حساب Play» را در فایل build.gradle برنامه‌تان به‌روز کنید.

    dependencies {
   def billingVersion = 8.0.0
   implementation "com.android.billingclient:billing:$billingVersion"
}

  2. (فقط برای ارتقا از PBL 6 به PBL 8 قابل‌اجرا است). تغییرات API مربوط به اشتراک را در برنامه‌تان مدیریت کنید.

    جدول زیر میاناهای برنامه‌سازی کاربردی مربوط به اشتراک را که در PBL 8 برداشته شده‌اند و میانای برنامه‌سازی کاربردی جایگزین مربوطه را که باید در برنامه‌تان استفاده کنید فهرست می‌کند.

    ‫API منسوخ‌شده قبلی در PBL 8 برداشته شد میانای برنامه‌سازی کاربردی جایگزین برای استفاده
    setOldSkuPurchaseToken setOldPurchaseToken
    setReplaceProrationMode setSubscriptionReplacementMode
    setReplaceSkusProrationMode setSubscriptionReplacementMode

  3. پیاده‌سازی روش queryProductDetailsAsync را به‌روز کنید.

    تغییری در امضای روش ProductDetailsResponseListener.onProductDetailsResponse ایجاد شده است که مستلزم تغییراتی در برنامه‌تان برای پیاده‌سازی queryProductDetailsAsync است. برای اطلاعات بیشتر، به نمایش محصولات موجود برای خرید مراجعه کنید.

  4. میاناهای برنامه‌سازی کاربردی برداشته‌شده را مدیریت کنید.

    ارتقا دادن از

    PBL 8 دیگر از میاناهای برنامه‌سازی کاربردی فهرست‌شده در جدول زیر پشتیبانی نمی‌کند. اگر پیاده‌سازی شما از هرکدام از این میاناهای برنامه‌سازی کاربردی حذف‌شده استفاده می‌کند، برای میاناهای برنامه‌سازی کاربردی جایگزین مربوطه به جدول مراجعه کنید.

    ‫API منسوخ‌شده قبلی در PBL 8 برداشته شد میانای برنامه‌سازی کاربردی جایگزین برای استفاده
    میاناهای برنامه‌سازی کاربردی queryPurchaseHistoryAsync Query Purchase History را ببینید
    querySkuDetailsAsync queryProductDetailsAsync
    ()enablePendingPurchases (میانای برنامه‌سازی کاربردی بدون پارامتر) enablePendingPurchases(PendingPurchaseParams params)
    توجه داشته باشید که enablePendingPurchases() منسوخ‌شده ازنظر عملکردی معادل enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()) است.
    queryPurchasesAsync(String skuType, PurchasesResponseListener listener) queryPurchasesAsync
    BillingClient.Builder.enableAlternativeBilling BillingClient.Builder.enableUserChoiceBilling
    AlternativeBillingListener UserChoiceBillingListener
    AlternativeChoiceDetails UserChoiceDetails

    ارتقا دادن از

    جدول زیر میاناهای برنامه‌سازی کاربردی را که در PBL 8 برداشته شده‌اند و میاناهای برنامه‌سازی کاربردی جایگزین مربوطه را که باید در برنامه‌تان استفاده کنید فهرست می‌کند.

    ‫API منسوخ‌شده قبلی در PBL 8 برداشته شد میانای برنامه‌سازی کاربردی جایگزین برای استفاده
    میاناهای برنامه‌سازی کاربردی queryPurchaseHistoryAsync Query Purchase History را ببینید
    querySkuDetailsAsync queryProductDetailsAsync
    ()enablePendingPurchases (میانای برنامه‌سازی کاربردی بدون پارامتر) enablePendingPurchases(PendingPurchaseParams params)
    توجه داشته باشید که enablePendingPurchases() منسوخ‌شده ازنظر عملکردی معادل enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()) است.
    queryPurchasesAsync(String skuType, PurchasesResponseListener listener) queryPurchasesAsync

  5. (توصیه‌شده) اتصال مجدد خودکار سرویس را فعال کنید.

    اگر درحین قطع بودن سرویس، فراخوانی میانای برنامه‌سازی کاربردی انجام شود، «کتابخانه صورت‌حساب Play» می‌تواند برای برقراری مجدد اتصال سرویس به‌طور خودکار تلاش کند. برای اطلاعات بیشتر، فعال کردن اتصال مجدد خودکار سرویس را ببینید.

  6. تغییرات اختیاری.