از نسخه 5 یا 6 به کتابخانه صورت‌حساب Google Play 7 مهاجرت کنید

این سند نحوه انتقال از کتابخانه صورت‌حساب Google Play 5 یا 6 به Google Play Billing Library 7 و نحوه ادغام با قابلیت‌های اشتراک اختیاری جدید را شرح می‌دهد.

برای لیست کامل تغییرات در نسخه 7.0.0، به یادداشت های انتشار مراجعه کنید.

نمای کلی

Google Play Billing Library 7 مدیریت پرداخت را برای ویژگی‌های اشتراک موجود بهبود می‌بخشد. این بهبودهای اختیاری، پشتیبانی از پرداخت با طرح های اقساطی و همچنین پشتیبانی از خریدهای معلق برای اشتراک های پیش پرداخت را اضافه می کند.

ارتقای کتابخانه صورت‌حساب Play سازگار با عقب

همه APIهای جدید Google Play Billing Library 7 اختیاری هستند و توسعه دهندگان برای به روز رسانی نیازی به اعمال هیچ تغییری در API ندارند.

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

از PBL 5 به PBL 7 ارتقا دهید

بخش های زیر نحوه ارتقاء از PBL 5 به PBL 7 را شرح می دهد.

کتابخانه صورت‌حساب Google Play را به‌روزرسانی کنید

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

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

در مرحله بعد، منابع API خود را همانطور که در بخش های زیر توضیح داده شده است، به روز کنید.

خریدهای اشتراک کاربر را تغییر دهید

Play Billing Library 5 و نسخه‌های قبلی از ProrationMode برای اعمال تغییرات در خریدهای اشتراک کاربر، مانند ارتقا یا کاهش، استفاده می‌کرد. این API حذف شده و با ReplacementMode جایگزین شده است.

کنترل تغییرات قیمت اشتراک

API launchPriceConfirmationFlow که قبلاً منسوخ شده بود حذف شده است. برای گزینه‌های جایگزین، راهنمای تغییرات قیمت را ببینید.

تغییرات API مربوط به اشتراک را مدیریت کنید

APIهای منسوخ شده قبلی setOldSkuPurchaseToken ، setReplaceProrationMode ، setReplaceSkusProrationMode حذف شده اند.

خطاهای Play Billing Library را مدیریت کنید

یک کد NETWORK_ERROR جدید نشان دهنده مشکلات در اتصال شبکه بین دستگاه کاربر و سیستم Google Play است.

کدهای SERVICE_TIMEOUT و SERVICE_UNAVAILABLE نیز به روز شدند.

برای اطلاعات بیشتر، به بررسی کدهای پاسخ BillingResult مراجعه کنید.

رسیدگی به معاملات معلق

کتابخانه صورت‌حساب Play دیگر شناسه سفارشی برای خریدهای معلق ایجاد نمی‌کند. برای این خریدها، شناسه سفارش پس از انتقال خرید به حالت PURCHASED تکمیل می شود. مطمئن شوید که ادغام شما تنها پس از تکمیل کامل تراکنش، انتظار شناسه سفارش را دارد. همچنان می توانید از رمز خرید برای سوابق خود استفاده کنید.

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

مدیریت APIهای جایگزین صورتحساب حذف شده

BillingClient.Builder.enableAlternativeBilling ، AlternativeBillingListener و AlternativeChoiceDetails حذف شد. توسعه‌دهندگان باید از BillingClient.Builder.enableUserChoiceBilling() با UserChoiceBillingListener و UserChoiceDetails در پاسخ به تماس شنونده استفاده کنند.

این به روز رسانی تغییر نام API های منسوخ شده بدون تغییر رفتار است.

تغییرات اختیاری

PBL 7 شامل دو API اختیاری جدید است.

از خریدهای معلق برای طرح های پیش پرداخت پشتیبانی کنید

راهنمای رسیدگی به اشتراک‌ها و معاملات معلق را ببینید.

اشتراک مجازی اقساط

راهنمای یکپارچه سازی اشتراک های اقساطی را ببینید.

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

بخش های زیر نحوه ارتقاء از PBL 6 به PBL 7 را شرح می دهد.

کتابخانه صورت‌حساب Google Play را به‌روزرسانی کنید

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

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

در مرحله بعد، منابع API خود را همانطور که در بخش های زیر توضیح داده شده است، به روز کنید.

تغییرات API مربوط به اشتراک را مدیریت کنید

APIهای منسوخ شده قبلی setOldSkuPurchaseToken ، setReplaceProrationMode ، setReplaceSkusProrationMode حذف شده اند.

مدیریت APIهای جایگزین صورتحساب حذف شده

BillingClient.Builder.enableAlternativeBilling ، AlternativeBillingListener و AlternativeChoiceDetails حذف شد. توسعه‌دهندگان باید از BillingClient.Builder.enableUserChoiceBilling() با UserChoiceBillingListener و UserChoiceDetails در پاسخ به تماس شنونده استفاده کنند.

تغییرات اختیاری

PBL 7 شامل دو API اختیاری جدید است.

از خریدهای معلق برای طرح های پیش پرداخت پشتیبانی کنید

راهنمای رسیدگی به اشتراک‌ها و معاملات معلق را ببینید.

اشتراک مجازی اقساط

برای اطلاعات در مورد نحوه ادغام این تغییرات در برنامه خود به راهنمای یکپارچه سازی اشتراک های اقساطی مراجعه کنید.