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

Este documento descreve como migrar da Biblioteca Google Play Faturamento 5 ou 6. à Biblioteca Google Play Faturamento 7 e como fazer a integração com a nova recursos de assinatura.

Para obter uma lista completa das mudanças na versão 7.0.0, consulte a documentação .

Visão geral

A Biblioteca Google Play Faturamento 7 melhora o processamento de pagamentos para: recursos de assinatura existentes. Essas melhorias opcionais adicionar suporte para 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. os desenvolvedores não precisam implementar nenhuma mudança de API para fazer a atualização.

Para migrar, você precisa atualizar as referências da API e remover determinadas APIs do seu aplicativo, 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 de dependência da Biblioteca Play Faturamento em o arquivo build.gradle do seu app.

dependencies {
    def billingVersion = 7.0.0

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

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

Mudar as compras de assinaturas de um usuário

Biblioteca Play Faturamento 5 e versões anteriores usadas ProrationMode para aplicar mudanças às compras de assinatura 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 de API relacionadas a assinaturas

As APIs descontinuadas setOldSkuPurchaseToken, setReplaceProrationMode e setReplaceSkusProrationMode foram removidos.

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 ao estado PURCHASED. Verifique se a integração espera um código do pedido somente após a conclusão da transação. Você ainda pode usar o token de compra para seus registros.

Para mais informações sobre como lidar com compras pendentes, consulte a O guia de integração da Biblioteca Play Faturamento e os guia de gerenciamento do ciclo de vida de compras.

Processar APIs de faturamento alternativo removidas

BillingClient.Builder.enableAlternativeBilling removido, AlternativeBillingListener, e AlternativeChoiceDetails. Os desenvolvedores precisam usar BillingClient.Builder.enableUserChoiceBilling() com UserChoiceBillingListener. e UserChoiceDetails no retorno de chamada do listener.

Essa 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 de planos pré-pagos

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

Assinaturas virtuais em parcelas

Consulte o guia Integração de assinaturas em 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 7.

Atualizar a Biblioteca Google Play Faturamento

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

dependencies {
    def billingVersion = 7.0.0

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

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

Processar mudanças de API relacionadas a assinaturas

As APIs descontinuadas setOldSkuPurchaseToken, setReplaceProrationMode e setReplaceSkusProrationMode foram removidos.

Processar APIs de faturamento alternativo removidas

BillingClient.Builder.enableAlternativeBilling removido, AlternativeBillingListener e AlternativeChoiceDetails. Os desenvolvedores precisam usar BillingClient.Builder.enableUserChoiceBilling() com UserChoiceBillingListener. e UserChoiceDetails no retorno de chamada do listener.

Alterações opcionais

A Biblioteca Play Faturamento 7 inclui duas novas APIs opcionais.

Suporte a compras pendentes de planos pré-pagos

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

Assinaturas virtuais em parcelas

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