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 Billing Library نهائيًا
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
كما أعلنّا في مؤتمر Google I/O لعام 2019 وفي مشاركة المدونة التعرّف على الإصدار 3 من Play Billing Library، ستخضع جميع إصدارات Play Billing Library لدورة إيقاف نهائي مدتها عامان.
يتناول هذا الموضوع الأسئلة الشائعة حول إيقاف إصدارات "مكتبة الفوترة" نهائيًا ونقل البيانات إلى إصدارات أحدث.
المخطط الزمني للدعم للإصدارات المختلفة
| الإصدار (بما في ذلك الإصدارات الثانوية)
|
آخر تاريخ يمكن فيه استخدام الإصدار لإصدار تطبيقات جديدة أو تحديثات للتطبيقات الحالية |
يمكن تقديم طلب التمديد حتى تاريخ الاستحقاق.
|
| 5 |
31 أغسطس 2024 |
Nov-1-2024 |
| 6 |
31-أغسطس-2025 |
Nov-1-2025 |
| 7 |
31-أغسطس-2026 |
Nov-1-2026 |
| 8 |
Aug-31-2027 |
Nov-1-2027 |
- كيف يمكنني معرفة حِزمة APK أو حِزمة التطبيق التي تؤدي إلى ظهور تحذير بشأن الإيقاف النهائي؟
- راجِع التبعيات التي تم استيرادها إلى مشروعك (على سبيل المثال، تلك التي تم العثور عليها في ملف
build.gradle الخاص بمشروعك). ولكي تكون التطبيقات متوافقة،
يجب أن تستورد إصدارًا متوافقًا كما هو موضّح في الجدول. يُرجى العِلم أنّ العناصر التابعة لنظام الفوترة لا تظهر إلا في حِزم APK التي تتطلّب الإذن com.android.vending.BILLING.
- تستخدم حزمة APK أو حزمة تطبيق لم أعد أحتفظ بها إصدارًا متوقفًا نهائيًا من Play Billing Library. هل عليّ التحديث؟
- ننصحك بشدة بتحديث جميع حِزم APK إلى أحدث إصدار من
Play Billing Library. ومع ذلك، إذا لم يعُد يتم الحفاظ على ملف APK،
فليس عليك اتّخاذ أي إجراء بشأنه في الوقت الحالي. لا يؤدي إيقاف الإصدارات القديمة إلى منع التطبيقات الجديدة والتحديثات من استخدام إصدارات أقدم من
مكتبة الفوترة في Play. سيستمر عمل التطبيقات الحالية التي تستخدم إصدارًا متوقفًا نهائيًا من المكتبة على النحو المتوقّع. يُرجى التأكّد من تحديث جميع حِزم APK التي تتم صيانتها بانتظام.
- كيف يمكن حلّ مشكلة ظهور تحذير الإيقاف النهائي على الرغم من تحديث حِزمة APK أو حِزمة التطبيق إلى أحدث إصدار من Play Billing Library؟
- تأكَّد من أنّ
AndroidManifest.xml يتضمّن إدخالاً بالاسم
com.google.android.play.billingclient.version. إذا لم يكن الإدخال متوفّرًا، راجِع إعدادات دمج ملف البيان لمعرفة ما إذا كان يتم حذف سمة ملف البيان أثناء عملية الدمج.
- كيف يمكنني الترقية من إصدار سابق من "مكتبة الفوترة في Play"؟
عدِّل الاعتمادية في إصدارك لاستخدام إصدار متوافق كما هو موضّح في الجدول. للاطّلاع على التغييرات التي تم إجراؤها بين الإصدارات، يُرجى قراءة ملاحظات الإصدار.
بالإضافة إلى ذلك، يتوفّر لدينا دليل مفصّل لنقل البيانات
إلى الإصدار 8 من PBL.
أين يمكنني العثور على استمارة طلب التمديد لمواصلة توزيع التطبيق على جميع مستخدمي Google Play حتى 1 نوفمبر؟
إذا كان تطبيقك لا يزال يستخدم إصدارًا قديمًا من Play Billing Library، ستتلقّى تحذيرًا ورسالة في البريد الوارد على Play Console. تتوفّر استمارة طلب التمديد من خلال صفحة تفاصيل التحذير أو المشكلة، في صفحة حالة السياسة ضمن Play Console.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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."]]
