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 或應用程式套件會觸發淘汰警告?
- 查看專案的匯入依附元件 (例如,在專案的
build.gradle
檔案中找到的依附元件)。為符合規範,應用程式必須匯入表格中列出的支援版本。請注意,只有需要 com.android.vending.BILLING
權限的 APK 才含有帳單依附元件。
- 我不再維護的 APK 或應用程式套件使用了已淘汰的 Play 帳款服務程式庫版本。我需要更新嗎?
- 強烈建議您將所有 APK 更新為最新版 Play 帳款服務程式庫。但如果是不再維護的 APK,目前無須採取任何行動。只有新的應用程式和更新功能會受到淘汰版本影響,無法使用舊版 Play 帳款服務程式庫,現有應用程式即便使用淘汰版程式庫,也可繼續正常運作。請確保仍在積極維護的所有 APK 皆已更新完成。
- APK 或應用程式套件如已更新為最新版 Play 帳款服務程式庫,但還是觸發淘汰警告,應如何修正?
- 請確認
AndroidManifest.xml
中具有一項名稱為 com.google.android.play.billingclient.version
的項目。如果找不到該項目,請檢查您的資訊清單合併設定,確認是否在合併資訊清單時,遺失了資訊清單屬性。 - 如何升級舊版 Play 帳款服務程式庫?
更新版本中的依附元件,使用表格中列出的支援版本。如要查看不同版本之間的異動,請參閲版本資訊。
此外,我們也提供遷移至 PBL 8 的深入指南。
如果我想在 11 月 1 日前繼續向所有 Google Play 使用者發行應用程式,可以在哪裡找到延期表單?
如果您的應用程式仍使用過時版本,系統會發出警告,並傳送通知訊息到 Play 管理中心收件匣。如要申請延期,請前往 Play 管理中心的「政策審查狀態」頁面,透過相關警告或問題的詳細資料頁面存取延期表單。
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。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."]]