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.
Descontinuação de versões da Biblioteca Google Play Faturamento
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Conforme anunciado no Google I/O em 2019 e na postagem do blog
Conheça a versão 3 da Biblioteca Google Play Faturamento (link em inglês), todas as versões dessa biblioteca vão seguir um ciclo de descontinuação de dois anos.
Este tópico responde a perguntas comuns sobre a descontinuação de versões da Biblioteca Faturamento
e a migração para versões mais recentes.
Cronograma de suporte para diferentes versões
Versão (incluindo
versões secundárias)
|
A versão da data mais recente
pode ser usada para lançar novos apps
ou atualizações de apps
existentes |
O pedido de extensão pode ser
feito até a data
|
5 |
31 de agosto de 2024 |
1º de novembro de 2024 |
6 |
31 de agosto de 2025 |
1º de novembro de 2025 |
7 |
31 de agosto de 2026 |
1º de novembro de 2026 |
8 |
31 de agosto de 2027 |
1º de novembro de 2027 |
- Como posso descobrir qual APK ou Android App Bundle está acionando um aviso de uso descontinuado?
- Revise as dependências importadas do projeto, como as encontradas
no arquivo
build.gradle
. Para estar em conformidade, os apps
precisam importar uma versão compatível, conforme indicado na tabela. As
dependências de faturamento são encontradas apenas em APKs que exigem a permissão
com.android.vending.BILLING
.
- Um APK ou Android App Bundle que não mantenho mais está usando uma versão descontinuada da Biblioteca Play Faturamento. Preciso atualizá-lo?
- É altamente recomendável atualizar todos os APKs para a versão mais recente da
Biblioteca Play Faturamento. No entanto, se um APK não estiver mais sendo mantido, nenhuma
ação será necessária para o APK no momento. Essa descontinuação
de uso impede que novos apps e atualizações usem versões mais antigas da
Biblioteca Play Faturamento. Os apps existentes que usam uma versão descontinuada da
biblioteca vão continuar funcionando conforme o esperado. Confira se todos os
APKs que recebem suporte estão atualizados.
- Como corrigir o APK ou o Android App Bundle atualizado para a versão mais recente da Biblioteca Play Faturamento, mas ainda acionar o aviso de descontinuação?
- Confira se o
AndroidManifest.xml
contém uma entrada com o nome
com.google.android.play.billingclient.version
. Se a entrada
não estiver presente, confira as
configurações de mesclagem do manifesto
para ver se o atributo dele está sendo descartado durante a mesclagem.
- Como fazer upgrade de uma versão anterior da Biblioteca Play Faturamento?
Atualize a dependência na sua versão para usar uma versão compatível, conforme indicado
na tabela. Se quiser saber o que mudou entre as versões, leia as
notas da versão.
Além disso, temos um guia detalhado para migrar
para a PBL 8.
Onde encontro o formulário de extensão para continuar a distribuição do app a todos os usuários do Google Play até 1º de novembro?
Se o app ainda estiver usando uma versão desatualizada da Biblioteca Play Faturamento, você vai receber um aviso e uma mensagem na caixa de entrada do Play Console. O formulário de extensão está disponível na página de detalhes do aviso ou do problema na página Status da política no Play Console.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[null,null,["Última atualização 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."]]