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 结算库版本废弃
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
正如 2019 年 Google I/O 大会和 Google Play 结算库版本 3 博文所宣布的,所有版本的 Play 结算库都将遵循两年的废弃周期。
本主题回答了关于结算库版本废弃和迁移到更高版本的常见问题。
不同版本的支持时间表
版本(包括次要版本)
|
最后日期版本
可用于发布新应用或
现有应用的更新 |
延期申请最晚可在以下日期提出
|
5 |
2024 年 8 月 31 日 |
2024 年 11 月 1 日 |
6 |
2025 年 8 月 31 日 |
2025 年 11 月 1 日 |
7 |
2026 年 8 月 31 日 |
2026 年 11 月 1 日 |
8 |
2027 年 8 月 31 日 |
2027 年 11 月 1 日 |
- 如何知道哪个 APK 或 app bundle 触发了废弃警告?
- 查看您项目中已导入的依赖项(例如,在项目的
build.gradle
文件中找到的依赖项)。为了符合要求,应用必须导入表中所示的受支持版本。请注意,您只会在需要 com.android.vending.BILLING
权限的 APK 中找到结算依赖项。
- 我不再维护的 APK 或 App Bundle 使用了已弃用的 Play 结算库版本。我需要更新吗?
- 我们强烈建议将所有 APK 的 Play 结算库更新到最新版本。不过,对于不再维护的 APK,您目前无需对其采取任何行动。此弃用机制仅会阻止新应用和应用更新使用旧版 Play 结算库。使用已弃用的结算库版本的现有应用将继续发挥预期功用。请务必更新所有在维护中的 APK。
- 如何解决 APK 或 app bundle 在更新至最新 Play 结算库后仍然会触发废弃警告的问题?
- 请确保您的
AndroidManifest.xml
包含名为 com.google.android.play.billingclient.version
的条目。如果该条目不存在,请检查您的清单合并设置,确认清单属性是否在清单合并期间被丢弃。
- 如何从较早版本的 Play 结算库进行升级?
将您版本中的依赖项更新为使用表中指示的支持版本。如需了解各版本之间有哪些变化,请参阅版本说明。
此外,我们还提供了关于如何迁移到 PBL 8 的深度指南。
如果我想在 11 月 1 日之前继续向所有 Google Play 用户分发应用,在哪里可以找到延期表单?
如果您的应用仍在使用已过时的 Play 结算库版本,您将在 Play 管理中心内收到警告和收件箱消息。可通过相应警告或问题的详情页面(位于 Play 管理中心的政策状态页面)找到延期表单。
本页面上的内容和代码示例受内容许可部分所述许可的限制。Java 和 OpenJDK 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-27。
[null,null,["最后更新时间 (UTC):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."]]