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

Ce document explique comment passer de la bibliothèque Google Play Billing 5 ou 6 à la bibliothèque Google Play Billing 7, et comment l'intégrer aux 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 de payer avec des forfaits en plusieurs versements et d'accepter les 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 d'implémenter de modifications d'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 expliquent 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 vos références d'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 apportées à l'API liées aux abonnements

Les API setOldSkuPurchaseToken, setReplaceProrationMode et setReplaceSkusProrationMode, qui étaient auparavant obsolètes, ont été supprimées.

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 la section 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 enregistrements.

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 systèmes de facturation alternatifs supprimées

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

Cette mise à jour consiste à renommer les API obsolètes sans modifier leur comportement.

Modifications facultatives

PBL 7 inclut deux nouvelles API facultatives.

Prise en charge des achats en attente pour les forfaits prépayés

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

Abonnements avec versement virtuel

Consultez le guide Intégration des abonnements en plusieurs versements.

Passer de PBL 6 à PBL 7

Les sections suivantes expliquent 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 vos références d'API comme décrit dans les sections suivantes.

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

Les API setOldSkuPurchaseToken, setReplaceProrationMode et setReplaceSkusProrationMode, qui étaient auparavant obsolètes, ont été supprimées.

Gérer les API de systèmes de facturation alternatifs supprimées

BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener et AlternativeChoiceDetails ont été supprimés. Les développeurs doivent utiliser BillingClient.Builder.enableUserChoiceBilling() avec UserChoiceBillingListener et UserChoiceDetails dans le rappel de l'écouteur à la place.

Modifications facultatives

PBL 7 inclut deux nouvelles API facultatives.

Prise en charge des achats en attente pour les forfaits prépayés

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

Abonnements avec versement virtuel

Consultez le guide Intégration des abonnements en plusieurs versements pour savoir comment intégrer ces modifications dans votre application.