KappS Base de conhecimento · Perguntas frequentes

Requisitos de versão da Biblioteca de Faturamento do Google Play

Perguntas frequentes Monetização e pagamentos

1. O Google segue um ciclo de descontinuação de dois anos na Play Billing Library: cada versão principal tem suporte por dois anos após o lançamento, e depois disso o Play Console deixa de aceitar novas compilações feitas com ela. A tabela publicada (https://developer.android.com/google/play/billing/deprecation-faq) traz: 5.x última data para novos apps e atualizações 2024-08-31 (prazo para pedido de extensão 2024-11-01), 6.x 2025-08-31 / 2025-11-01, 7.x 2026-08-31 / 2026-11-01, 8.x 2027-08-31 / 2027-11-01. Na prática: desde 31 de agosto de 2026, qualquer novo app ou atualização de app que use Play Billing deve ser compilado com a Billing Library 8.0.0 ou superior.

2. A redação exata importa. O FAQ de descontinuação da Google diz que esta descontinuação "impede apenas que novos apps e atualizações usem versões mais antigas da Play Billing Library. Apps existentes que usam uma versão descontinuada da biblioteca continuarão funcionando como esperado." É uma barreira de publicação, não um interruptor que mata em tempo de execução — uma build v7 já publicada continua processando compras. O que você perde é a capacidade de publicar qualquer coisa nova, incluindo um patch de segurança ou uma recompilação, então qualquer app que você pretenda continuar mantendo precisa ser migrado.

3. A extensão é uma solicitação, não um período de tolerância automático. Para a linha 7.x, o prazo para solicitar a extensão é 2026-11-01, e a solicitação precisa ser feita antes do prazo original. O Play Console sinaliza a elegibilidade por meio de um aviso na página do app e de uma mensagem na caixa de entrada da página Status de políticas quando um app está em uma versão descontinuada; o formulário de extensão fica na página de detalhes desse aviso ou problema (https://developer.android.com/google/play/billing/release-notes).

4. Armadilha de detecção: o Play Console lê a versão da sua biblioteca pela entrada com.google.android.play.billingclient.version que a biblioteca injeta no manifesto. A mesclagem de manifestos em projetos multimódulo pode descartá-la — se essa entrada faltar no manifesto mesclado final, o Play Console não consegue saber qual versão você enviou e o aviso pode nunca chegar até você. Verifique o manifesto mesclado em vez de confiar no silêncio.

5. O que quebra na v8 (cada item é um erro de compilação até ser substituído): querySkuDetailsAsync() -> queryProductDetailsAsync(QueryProductDetailsParams, ProductDetailsResponseListener); o enablePendingPurchases() sem argumentos -> enablePendingPurchases(PendingPurchasesParams); a sobrecarga queryPurchasesAsync(String skuType, PurchasesResponseListener) -> queryPurchasesAsync(QueryPurchasesParams, PurchasesResponseListener); queryPurchaseHistoryAsync() não tem substituto no lado do cliente, então o histórico de compras precisa ser rastreado no servidor; BillingClient.Builder.enableAlternativeBilling(), AlternativeBillingListener e AlternativeChoiceDetails -> enableUserChoiceBilling(UserChoiceBillingListener), UserChoiceBillingListener e UserChoiceDetails; e ProductDetailsResponseListener.onProductDetailsResponse() agora retorna um QueryProductDetailsResult que separa os produtos buscados dos não buscados com códigos de status por produto. A terminologia também mudou: o que a documentação chamava de "in-app items" agora são "one-time products", e na v8 eles suportam múltiplas opções de compra e ofertas como as assinaturas já faziam.

6. Checklist prático: fixe o patch mais recente da linha 8.x em vez da 8.0.0; teste novamente os fluxos de compra, restauração e compra pendente com licenciados de teste antes do lançamento; continue validando os tokens de compra no servidor; e trate isso como uma tarefa de manutenção anual, não pontual — a própria linha 8.x é descontinuada para novos uploads em 2027-08-31, com uma prorrogação de segurança até 2027-11-01. Programar cada migração com um trimestre de antecedência em relação ao prazo é a única forma de ela nunca bloquear um lançamento.