Reminder: By Aug 31, 2025, all new apps and updates to existing apps must use Billing Library version 7 or newer. If you need more time to update your app, you can request an extension until Nov 1, 2025. Learn about
Play Billing Library version deprecation.
منسوخ شدن نسخه کتابخانه صورتحساب Google Play، منسوخ شدن نسخه کتابخانه صورتحساب Google Play
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
همانطور که در Google I/O در سال 2019 و پست وبلاگ Meet Google Play Billing Library نسخه 3 اعلام شد، همه نسخه‌های کتابخانه صورتحساب Play از یک چرخه منسوخ شدن دو ساله پیروی می‌کنند.
این مبحث به سؤالات رایج در مورد منسوخ شدن نسخه کتابخانه صورتحساب و انتقال به نسخه‌های جدیدتر پاسخ می‌دهد.
پشتیبانی از جدول زمانی برای نسخه های مختلف
| نسخه (از جمله نسخه های کوچک) | نسخه آخرین تاریخ را می توان برای انتشار برنامه های جدید یا به روز رسانی برنامه های موجود استفاده کرد | درخواست تمدید را می توان به روز کرد |
|---|
| 5 | اوت-31-2024 | نوامبر 1-2024 |
| 6 | اوت-31-2025 | نوامبر 1-2025 |
| 7 | اوت-31-2026 | نوامبر 1-2026 |
| 8 | اوت-31-2027 | نوامبر 1-2027 |
- چگونه می‌توانم بفهمم کدام APK یا App Bundle اخطار منسوخ شدن را راه‌اندازی می‌کند؟
- وابستگی های وارد شده پروژه خود را مرور کنید (به عنوان مثال، آنهایی که در فایل
build.gradle پروژه شما یافت می شوند). برای سازگاری، برنامه ها باید نسخه پشتیبانی شده را همانطور که در جدول نشان داده شده است وارد کنند. توجه داشته باشید که وابستگی‌های صورتحساب فقط در فایل‌های APK که به مجوز com.android.vending.BILLING نیاز دارند، یافت می‌شوند. - APK یا App Bundle که من دیگر آن را نگهداری نمی‌کنم از نسخه قدیمی کتابخانه صورتحساب Play استفاده می‌کند. آیا نیاز به آپدیت دارم؟
- اکیداً توصیه می‌کنیم همه فایل‌های APK را به آخرین نسخه کتابخانه صورتحساب Play به‌روزرسانی کنید. با این حال، اگر یک APK دیگر نگهداری نشود، در حال حاضر هیچ اقدامی برای APK لازم نیست. این منسوخ شدن فقط برنامه‌ها و به‌روزرسانی‌های جدید را از استفاده از نسخه‌های قدیمی‌تر کتابخانه صورتحساب Play جلوگیری می‌کند. برنامه‌های موجود که از نسخه قدیمی کتابخانه استفاده می‌کنند، همانطور که انتظار می‌رفت به کار خود ادامه می‌دهند. لطفاً مطمئن شوید که همه APKهایی که به طور فعال نگهداری می شوند به روز می شوند.
- چگونه می‌توان APK یا App Bundle را که به آخرین کتابخانه صورتحساب Play به‌روزرسانی شده است، اما همچنان هشدار انحلال را راه‌اندازی می‌کند، برطرف کنیم؟
- مطمئن شوید که
AndroidManifest.xml شما دارای ورودی با نام com.google.android.play.billingclient.version باشد. اگر ورودی وجود ندارد، تنظیمات ادغام مانیفست خود را بررسی کنید تا ببینید آیا ویژگی مانیفست در طول ادغام مانیفست حذف می‌شود یا خیر. - چگونه می توانم از نسخه قبلی کتابخانه صورتحساب Play ارتقا دهم؟
برای استفاده از نسخه پشتیبانی شده همانطور که در جدول نشان داده شده است، وابستگی را در نسخه خود به روز کنید. برای مشاهده تغییرات بین نسخه‌ها، یادداشت‌های انتشار را بخوانید.
علاوه بر این، ما یک راهنمای عمیق برای مهاجرت به PBL 8 داریم.
کجا می توانم فرم برنامه افزودنی را برای ادامه توزیع بین همه کاربران Google Play تا 1 نوامبر پیدا کنم؟
اگر برنامه شما همچنان از نسخه قدیمی کتابخانه صورتحساب Play استفاده می‌کند، یک هشدار و یک پیام صندوق ورودی در کنسول Play دریافت خواهید کرد. فرم برنامه افزودنی از طریق صفحه جزئیات هشدار یا مشکل در صفحه وضعیت خط‌مشی در Play Console در دسترس است.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین به‌روزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Google Play Billing Library version deprecation\n\nAs announced at Google I/O in 2019 and the\n[Meet Google Play Billing Library Version 3](https://android-developers.googleblog.com/2020/06/meet-google-play-billing-library.html \"Play Billing Library Version 3 Blog\") blog post, all versions of Play\nBilling Library will follow a two year deprecation cycle.\n\nThis topic answers common questions regarding Billing Library version\ndeprecation and migrating to newer versions.\n\nSupport timeline For different versions\n---------------------------------------\n\n| Version (including minor versions) | Last date version can be used to release new apps or updates to existing apps | Extension request can be made up to date |\n|------------------------------------|-------------------------------------------------------------------------------|------------------------------------------|\n| 5 | Aug-31-2024 | Nov-1-2024 |\n| 6 | Aug-31-2025 | Nov-1-2025 |\n| 7 | Aug-31-2026 | Nov-1-2026 |\n| 8 | Aug-31-2027 | Nov-1-2027 |\n\n**How can I find which APK or App Bundle is triggering a deprecation warning?**\n: Review your project's imported dependencies (for example, those found\n in your project's `build.gradle` file). To be compliant, apps\n must import a supported version as indicated in the table. Note that\n Billing dependencies would be found only in APKs that require the\n `com.android.vending.BILLING` permission.\n\n**An APK or App Bundle that I no longer maintain is using a deprecated version of the Play Billing Library. Do I need to update?**\n: We strongly recommend updating all APKs to the latest version of the\n Play Billing Library. However, if an APK is no longer maintained, then\n no action is required for the APK at this time. This deprecation\n prevents only new apps and updates from using older versions of the\n Play Billing Library. Existing apps that use a deprecated version of\n the library will continue to function as expected. Please ensure that all\n actively maintained APKs are updated.\n\n**How to fix APK or App Bundle updated to latest Play Billing Library but still triggering deprecation warning?**\n: Make sure your `AndroidManifest.xml` contains an entry with name\n `com.google.android.play.billingclient.version`. If the entry\n isn't present, check your\n [manifest merge settings](/studio/build/manage-manifests#merge-manifests)\n to see if the manifest attribute is being dropped during manifest merging.\n\n**How can I upgrade from an earlier version of Play Billing Library?**\n\n: Update the dependency in your release to use a supported version as indicated\n in the table. To see what changed between releases, read the\n [release notes](/google/play/billing/release-notes).\n\n In addition, we have an in-depth guide for migrating\n [to PBL 8](/google/play/billing/migrate-gpblv8).\n\n**Where can I find the extension form to continue distributing to all Google\nPlay users until 1 November?**\n\nIf your app is still using an out of date Play Billing Library version, you'll\nreceive a warning and an inbox message in Play Console. The extension form is\navailable through the details page of the warning or issue on the\n[Policy status](https://play.google.com/console/developers/app/policy-center \"Policy Center\") page in Play Console."]]
