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.
- Atualize
setOldSkuPurchaseToken
parasetOldPurchaseToken
. - Atualize
setReplaceProrationMode
parasetSubscriptionReplacementMode
. - Atualize
setReplaceSkusProrationMode
parasetSubscriptionReplacementMode
.
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.
- Atualize
setOldSkuPurchaseToken
parasetOldPurchaseToken
. - Atualize
setReplaceProrationMode
parasetSubscriptionReplacementMode
. - Atualize
setReplaceSkusProrationMode
parasetSubscriptionReplacementMode
.
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.