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 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 de payer par versements et de gérer 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. 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 la bibliothèque Play Billing 5 à la bibliothèque Play Billing 7

Les sections suivantes décrivent comment passer de la bibliothèque Play Billing 5 à la bibliothèque Play Billing 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

Dans la bibliothèque Play Billing 5 et les versions antérieures, ProrationMode permettait d'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 d'API liées aux abonnements

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

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 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 labibliothè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

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 consiste à renommer les API obsolètes sans modifier leur comportement.

Modifications facultatives

La bibliothèque Play Billing 7 inclut deux nouvelles API facultatives.

Gérer les achats en attente pour les forfaits prépayés

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

Abonnements à versements virtuels

Consultez le guide d'intégration des abonnements à versements.

Passer de la bibliothèque Play Billing 6 à la bibliothèque Play Billing 7

Les sections suivantes décrivent comment passer de la bibliothèque Play Billing 6 à la bibliothèque Play Billing 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 d'API liées aux abonnements

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

Gérer les API de systèmes de facturation alternatifs 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

La bibliothèque Play Billing 7 inclut deux nouvelles API facultatives.

Gérer les achats en attente pour les forfaits prépayés

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

Abonnements à versements virtuels

Pour savoir comment intégrer ces modifications à votre application, consultez le guide d'intégration des abonnements à versements pour obtenir des informations.