Migrar das versões 5 ou 6 para a Biblioteca Google Play Faturamento 7

Este documento descreve como migrar da versão 5 ou 6 da Biblioteca Google Play Faturamento para a versão 7 e como fazer a integração com os novos recursos de assinatura opcionais.

Para conferir uma lista completa das mudanças na versão 7.0.0, consulte as notas da versão.

Informações gerais

A Biblioteca Google Play Faturamento 7 melhora o processamento de pagamentos para recursos de assinatura atuais. Essas melhorias opcionais adicionam suporte ao pagamento com planos de parcelamento, bem como suporte a compras pendentes de assinaturas pré-pagas.

Upgrade da Biblioteca Play Faturamento para ser compatível com versões anteriores

Todas as novas APIs da Biblioteca Google Play Faturamento 7 são opcionais, e os desenvolvedores não precisam implementar nenhuma mudança na API para atualizar.

Para migrar, é necessário atualizar as referências da API e remover algumas APIs do app, conforme descrito nas notas da versão e posteriormente neste guia de migração.

Fazer upgrade da Biblioteca Play Faturamento 5 para a Biblioteca Play Faturamento 7

As seções a seguir descrevem como fazer upgrade da Biblioteca Play Faturamento 5 para a Biblioteca 7.

Atualizar a Biblioteca Google Play Faturamento

Atualize a versão da dependência da Biblioteca Play Faturamento no arquivo build.gradle do seu app.

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

Em seguida, atualize as referências da API conforme descrito nas seções a seguir.

Mudar as compras de assinaturas de um usuário

A Biblioteca Play Faturamento 5 e versões anteriores usavam ProrationMode para aplicar mudanças às compras de assinaturas de um usuário, como upgrades ou downgrades. Essa API foi removida e substituída por ReplacementMode.

Processar mudanças no preço de assinaturas

A API launchPriceConfirmationFlow descontinuada foi removida. Para conferir alternativas, consulte o guia de mudanças de preço.

Processar mudanças na API relacionadas a assinaturas

As APIs descontinuadas setOldSkuPurchaseToken, setReplaceProrationMode e setReplaceSkusProrationMode foram removidas.

Processar erros da Biblioteca Play Faturamento

Um novo código NETWORK_ERROR indica problemas com a conexão de rede entre o dispositivo do usuário e o sistema do Google Play.

Os códigos SERVICE_TIMEOUT e SERVICE_UNAVAILABLE também foram atualizados.

Para mais informações, consulte Processar códigos de resposta de BillingResult.

Processar transações pendentes

A Biblioteca Play Faturamento não cria mais um código do pedido para compras pendentes. Para essas compras, o código do pedido é preenchido depois que a compra é movida para o estado PURCHASED. Confira se a integração espera um ID do pedido somente após a conclusão de uma transação. Ainda é possível usar o token de compra para seus registros.

Para saber mais sobre como processar compras pendentes, consulte o guia de integração da Biblioteca Play Faturamento e o guia de gerenciamento do ciclo de vida de compras.

Processar APIs de faturamento alternativo removidas

Remoção de BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener e AlternativeChoiceDetails. Os desenvolvedores precisam usar BillingClient.Builder.enableUserChoiceBilling() com UserChoiceBillingListener e UserChoiceDetails no callback do listener.

Esta atualização é uma renomeação das APIs descontinuadas sem mudanças de comportamento.

Alterações opcionais

A Biblioteca Play Faturamento 7 inclui duas novas APIs opcionais.

Suporte a compras pendentes para planos pré-pagos

Consulte o guia Processar assinaturas e transações pendentes.

Assinaturas de parcelas virtuais

Consulte o guia Integração de assinaturas de parcelas.

Fazer upgrade da Biblioteca Play Faturamento 6 para a Biblioteca Play Faturamento 7

As seções a seguir descrevem como fazer upgrade da Biblioteca Play Faturamento 6 para a Biblioteca Play Faturamento 7.

Atualizar a Biblioteca Google Play Faturamento

Atualize a versão da dependência da Biblioteca Play Faturamento no arquivo build.gradle do seu app.

dependencies {
    def billingVersion = 7.0.0

    implementation "com.android.billingclient:billing:$billingVersion"
}

Em seguida, atualize as referências da API conforme descrito nas seções a seguir.

Processar mudanças na API relacionadas a assinaturas

As APIs descontinuadas setOldSkuPurchaseToken, setReplaceProrationMode e setReplaceSkusProrationMode foram removidas.

Processar APIs de faturamento alternativo removidas

Remoção de BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener e AlternativeChoiceDetails. Os desenvolvedores precisam usar BillingClient.Builder.enableUserChoiceBilling() com UserChoiceBillingListener e UserChoiceDetails no callback do listener.

Alterações opcionais

A Biblioteca Play Faturamento 7 inclui duas novas APIs opcionais.

Suporte a compras pendentes para planos pré-pagos

Consulte o guia Processar assinaturas e transações pendentes.

Assinaturas de parcelas virtuais

Consulte o guia Integração de assinaturas em parcelas para saber como integrar essas mudanças ao seu app.