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.
Phiên bản Thư viện Google Play Billing không còn được dùng nữa
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Như đã thông báo tại Google I/O năm 2019 và bài đăng trên blog Làm quen với Thư viện Google Play Billing phiên bản 3, tất cả các phiên bản của Thư viện Play Billing sẽ tuân theo chu kỳ ngừng sử dụng sau hai năm.
Chủ đề này giải đáp các câu hỏi thường gặp liên quan đến việc ngừng sử dụng phiên bản Thư viện Billing và chuyển sang các phiên bản mới hơn.
Lịch trình hỗ trợ cho các phiên bản
| Phiên bản (bao gồm các phiên bản nhỏ)
|
Ngày cuối phiên bản này có thể được dùng để phát hành ứng dụng mới hoặc bản cập nhật cho các ứng dụng hiện có |
Bạn có thể yêu cầu gia hạn đến ngày hiện tại
|
| 5 |
31/8/2024 |
1/11/2024 |
| 6 |
31/8/2025 |
1/11/2025 |
| 7 |
31/8/2026 |
1/11/2026 |
| 8 |
31/8/2027 |
1/11/2027 |
- Làm cách nào để biết tệp APK hoặc Gói ứng dụng nào đang kích hoạt cảnh báo về việc ngừng sử dụng?
- Hãy xem lại các phần phụ thuộc đã nhập trong dự án của bạn (ví dụ: những phần phụ thuộc trong tệp
build.gradle của dự án). Để tuân thủ chính sách, các ứng dụng phải nhập một phiên bản được hỗ trợ như trong bảng. Lưu ý là các phần phụ thuộc Billing sẽ chỉ có trong các tệp APK yêu cầu quyền com.android.vending.BILLING.
- Một tệp APK hoặc Gói ứng dụng tôi không còn duy trì đang sử dụng một phiên bản Thư viện Play Billing không được dùng nữa. Tôi có cần phải cập nhật không?
- Bạn nên cập nhật tất cả tệp APK lên phiên bản mới nhất của Thư viện Play Billing. Tuy nhiên, nếu tệp APK không còn được duy trì thì bạn không cần phải làm gì thêm đối với tệp APK đó tại thời điểm này. Việc ngừng sử dụng này chỉ ngăn các bản cập nhật và ứng dụng mới dùng phiên bản cũ của Thư viện Play Billing. Các ứng dụng hiện đang sử dụng phiên bản thư viện không được dùng nữa sẽ tiếp tục hoạt động như dự kiến. Hãy đảm bảo rằng bạn đã cập nhật tất cả tệp APK đang được sử dụng.
- Làm thế nào để khắc phục vấn đề tệp APK hoặc Gói ứng dụng đã được cập nhật lên Thư viện Play Billing mới nhất nhưng vẫn kích hoạt cảnh báo về việc ngừng sử dụng?
- Hãy đảm bảo rằng
AndroidManifest.xml chứa mục có tên com.google.android.play.billingclient.version. Nếu bạn không thấy mục này, hãy kiểm tra chế độ cài đặt hợp nhất tệp kê khai để xem thuộc tính tệp kê khai có bị bỏ đi (drop) trong quá trình hợp nhất tệp kê khai hay không.
- Làm thế nào để nâng cấp từ phiên bản cũ của Thư viện Play Billing?
Cập nhật phần phụ thuộc trong bản phát hành để sử dụng một phiên bản được hỗ trợ như trong bảng. Để xem những thay đổi giữa các bản phát hành, vui lòng đọc bài viết về ghi chú phát hành.
Ngoài ra, chúng tôi có hướng dẫn chi tiết về cách di chuyển sang PBL 8.
Tôi có thể tìm biểu mẫu gia hạn ở đâu để có thể tiếp tục phân phối ứng dụng cho tất cả người dùng Google Play đến ngày 1 tháng 11?
Nếu ứng dụng của bạn vẫn đang dùng một phiên bản Thư viện Play Billing đã lỗi thời, bạn sẽ nhận được cảnh báo và tin nhắn trong hộp thư đến trên Play Console. Biểu mẫu yêu cầu gia hạn được cung cấp trên trang thông tin chi tiết về cảnh báo hoặc vấn đề đó tại trang Trạng thái tuân thủ chính sách trong Play Console.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-27 UTC."],[],[],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."]]
