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 prendre en charge les paiements échelonnés ainsi que 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 la PBL 5 à la PBL 7
Les sections suivantes expliquent comment passer de la PBL 5 à la 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 votre documentation de référence de l'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, désormais 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 précédemment obsolètes ont été supprimées.
- Remplacez
setOldSkuPurchaseTokenparsetOldPurchaseToken. - Remplacez
setReplaceProrationModeparsetSubscriptionReplacementMode. - Remplacez
setReplaceSkusProrationModeparsetSubscriptionReplacementMode.
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 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
Suppression de BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener et AlternativeChoiceDetails. Utilisez plutôt 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
PBL 7 inclut deux nouvelles API facultatives.
Prendre en charge les achats en attente pour les forfaits prépayés
Consultez le guide Gérer les abonnements et les transactions en attente.
Abonnements avec versements virtuels
Consultez le guide Intégration des abonnements à paiement échelonné.
Passer de PBL 6 à PBL 7
Les sections suivantes expliquent comment passer de la PBL 6 à la 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 votre documentation de référence de l'API comme décrit dans les sections suivantes.
Gérer les modifications d'API liées aux abonnements
Les API setOldSkuPurchaseToken, setReplaceProrationMode et setReplaceSkusProrationMode précédemment obsolètes ont été supprimées.
- Remplacez
setOldSkuPurchaseTokenparsetOldPurchaseToken. - Remplacez
setReplaceProrationModeparsetSubscriptionReplacementMode. - Remplacez
setReplaceSkusProrationModeparsetSubscriptionReplacementMode.
Gérer les API de systèmes de facturation alternatifs supprimées
Suppression de BillingClient.Builder.enableAlternativeBilling, AlternativeBillingListener et AlternativeChoiceDetails. Utilisez plutôt BillingClient.Builder.enableUserChoiceBilling() avec UserChoiceBillingListener et UserChoiceDetails dans le rappel de l'écouteur.
Modifications facultatives
PBL 7 inclut deux nouvelles API facultatives.
Prendre en charge les achats en attente pour les forfaits prépayés
Consultez le guide Gérer les abonnements et les transactions en attente.
Abonnements avec versements virtuels
Consultez le guide Intégration des abonnements à paiement échelonné pour savoir comment intégrer ces modifications à votre application.