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

Ce document explique comment migrer de la bibliothèque Google Play Billing 5 ou 6 vers la bibliothèque Google Play Billing 7 et comment intégrer les nouvelles fonctionnalités d'abonnement facultatives.

Pour obtenir la liste complète des modifications apportées à la version 7.0.0, consultez les notes de version.

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 permettent d'effectuer des paiements à l'aide de plans de versement, ainsi que 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, et les développeurs n'ont pas besoin de modifier l'API pour effectuer la mise à jour.

Pour effectuer la migration, vous devez mettre à jour les références d'API et supprimer certaines API de votre application, comme décrit dans les notes de version et plus loin dans ce 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

Mettez à 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 les références de votre API comme décrit dans les sections suivantes.

Modifier les achats d'abonnements d'un utilisateur

La bibliothèque Play Billing 5 et les versions antérieures utilisaient ProrationMode pour appliquer les modifications apportées aux achats d'abonnements d'un utilisateur, telles que le passage à un forfait supérieur ou inférieur. 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

Suppression des API précédemment abandonnées setOldSkuPurchaseToken, setReplaceProrationMode et setReplaceSkusProrationMode.

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

Un nouveau code NETWORK_ERROR indique les 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 que l'achat passe à l'état PURCHASED. Assurez-vous que votre intégration n'attend un ID de commande qu'une fois la transaction 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 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 a renommé les API obsolètes sans changement de comportement.

Modifications facultatives

PBL 7 inclut 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 à versements é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

Mettez à 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 les références de votre API comme décrit dans les sections suivantes.

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

Suppression des API précédemment abandonnées setOldSkuPurchaseToken, 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 inclut 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 à versement pour découvrir comment intégrer ces modifications à votre application.