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
.
- Remplacez
setOldSkuPurchaseToken
parsetOldPurchaseToken
. - Remplacez
setReplaceProrationMode
parsetSubscriptionReplacementMode
. - Remplacez
setReplaceSkusProrationMode
parsetSubscriptionReplacementMode
.
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
.
- Remplacez
setOldSkuPurchaseToken
parsetOldPurchaseToken
. - Remplacez
setReplaceProrationMode
parsetSubscriptionReplacementMode
. - Remplacez
setReplaceSkusProrationMode
parsetSubscriptionReplacementMode
.
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.