Migrer vers la bibliothèque Google Play Billing 7 à partir des versions 5 ou 6

Ce document explique comment effectuer une migration depuis la bibliothèque Google Play Billing 5 ou 6 à la bibliothèque Google Play Billing 7 et comment intégrer le nouveau de Google Cloud.

Pour obtenir la liste complète des modifications apportées à la version 7.0.0, reportez-vous à la version commentaires.

Présentation

La Bibliothèque Google Play Billing 7 améliore la gestion des paiements pour les fonctionnalités d'abonnement existantes. Ces améliorations facultatives ajouter la prise en charge du paiement avec des plans de versement ainsi que la prise en charge des achats en attente pour les abonnements prépayés.

Mise à niveau de la bibliothèque Play Billing rétrocompatible

Toutes les nouvelles API de la bibliothèque Google Play Billing 7 sont facultatives. les développeurs n'ont pas besoin de modifier l'API pour effectuer la mise à jour.

Pour procéder à la migration, vous devez mettre à jour les références des API et supprimer certaines API de votre application, comme décrit dans les notes de version et plus loin dans ce document guide de migration.

Passer de PBL 5 à PBL 7

Les sections suivantes décrivent comment passer de PBL 5 à PBL 7.

Mettre à jour la Bibliothèque Google Play Billing

Mettre à jour la version de la dépendance de la bibliothèque Play Billing dans le fichier build.gradle de votre application.

dependencies {
    def billingVersion = 7.0.0

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

Ensuite, mettez à jour vos références d'API comme décrit dans les sections suivantes.

Modifier les achats d'abonnements d'un utilisateur

Bibliothèque Play Billing 5 et versions antérieures utilisées ProrationMode pour appliquer des modifications aux achats d'abonnements d'un utilisateur, telles que les mises à niveau ou à des rétrogradations. Cette API a été supprimée et remplacée par ReplacementMode

Gérer les changements de prix des abonnements

L'API launchPriceConfirmationFlow, qui était obsolète, a été supprimée. Pour découvrir d'autres options, consultez le Guide des changements de prix.

Gérer les modifications de l'API liées aux abonnements

Les API setOldSkuPurchaseToken, qui étaient obsolètes, Suppression de setReplaceProrationMode et setReplaceSkusProrationMode.

Gérer les erreurs de la bibliothèque Play Billing

Un nouveau code NETWORK_ERROR indique des problèmes de connexion réseau entre l'appareil de l'utilisateur et le système Google Play.

Les codes SERVICE_TIMEOUT et SERVICE_UNAVAILABLE ont également été mis à jour.

Pour en savoir plus, consultez Gérer les codes de réponse BillingResult

Gérer les transactions en attente

La bibliothèque Play Billing ne crée plus d'ID de commande pour les achats en attente. Pour ces achats, l'ID de commande est renseigné une fois l'achat transféré. à l'état PURCHASED. Assurez-vous que votre intégration attend un ID de commande qu'une fois la transaction entièrement terminée. Vous pouvez toujours utiliser le jeton d'achat pour vos archives.

Pour en savoir plus sur la gestion des achats en attente, consultez les le guide d'intégration de la bibliothèque Play Billing et le guide de gestion du cycle de vie des achats.

Gérer les API de facturation alternative supprimées

Suppression de BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener, et AlternativeChoiceDetails. Les développeurs doivent utiliser BillingClient.Builder.enableUserChoiceBilling() avec UserChoiceBillingListener et UserChoiceDetails dans le rappel de l'écouteur.

Cette mise à jour renomme les API obsolètes sans aucun changement de comportement.

Modifications facultatives

PBL 7 comprend deux nouvelles API facultatives.

Prise en charge des achats de forfaits prépayés en attente

Consultez le guide Gérer les abonnements et les transactions en attente.

Abonnements à versements virtuels

Consultez le guide d'intégration des abonnements échelonnés.

Passer de PBL 6 à PBL 7

Les sections suivantes décrivent comment passer de PBL 6 à PBL 7.

Mettre à jour la Bibliothèque Google Play Billing

Mettre à jour la version de la dépendance de la bibliothèque Play Billing dans le fichier build.gradle de votre application.

dependencies {
    def billingVersion = 7.0.0

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

Ensuite, mettez à jour vos références d'API comme décrit dans les sections suivantes.

Gérer les modifications de l'API liées aux abonnements

Les API setOldSkuPurchaseToken, qui étaient obsolètes, Suppression de setReplaceProrationMode et setReplaceSkusProrationMode.

Gérer les API de facturation alternative supprimées

Suppression de BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener et AlternativeChoiceDetails. Les développeurs doivent utiliser BillingClient.Builder.enableUserChoiceBilling() avec UserChoiceBillingListener et UserChoiceDetails dans le rappel de l'écouteur.

Modifications facultatives

PBL 7 comprend deux nouvelles API facultatives.

Prise en charge des achats de forfaits prépayés en attente

Consultez le guide Gérer les abonnements et les transactions en attente.

Abonnements à versements virtuels

Consultez le guide d'intégration des abonnements échelonnés pour connaître des informations sur la façon d'intégrer ces changements dans votre application.