Ce document explique comment passer de la bibliothèque Google Play Billing 6 ou 7 à la bibliothèque PBL 8, et comment l'intégrer aux nouvelles fonctionnalités d'abonnement facultatives.
Pour obtenir la liste complète des modifications apportées à la version 8.0.0, consultez les notes de version.
Présentation
PBL 8 contient des améliorations apportées aux API existantes, ainsi que la suppression des API précédemment obsolètes. Cette version de la bibliothèque inclut également de nouvelles API pour les produits ponctuels.
Rétrocompatibilité pour la mise à niveau de la bibliothèque PBL
Pour migrer vers PBL 8, vous devez mettre à jour ou supprimer certaines de vos références d'API existantes de votre application, comme décrit dans les notes de version et plus loin dans ce guide de migration.
Passer de PBL 6 ou 7 à PBL 8
Pour passer de la version 6 ou 7 de PBL à la version 8, procédez comme suit :
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 = 8.0.0 implementation "com.android.billingclient:billing:$billingVersion" }
(Applicable uniquement pour la mise à niveau de PBL 6 vers PBL 8). Gérez les modifications d'API liées aux abonnements dans votre application.
Le tableau suivant liste les API liées aux abonnements qui sont supprimées dans PBL 8 et l'API de remplacement correspondante que vous devez utiliser dans votre application.
Suppression d'une API précédemment obsolète dans PBL 8 API de remplacement à utiliser setOldSkuPurchaseToken setOldPurchaseToken setReplaceProrationMode setSubscriptionReplacementMode setReplaceSkusProrationMode setSubscriptionReplacementMode Mettez à jour l'implémentation de la méthode
queryProductDetailsAsync
.La signature de la méthode
ProductDetailsResponseListener.onProductDetailsResponse
a changé, ce qui nécessite des modifications dans votre application pour l'implémentation dequeryProductDetailsAsync
. Pour en savoir plus, consultez la section Afficher les produits disponibles à l'achat.Gérer les API supprimées
Mettre à niveau à partir de
PBL 8 n'est plus compatible avec les API listées dans le tableau suivant. Si votre implémentation utilise l'une de ces API supprimées, consultez le tableau pour connaître les API de remplacement correspondantes.
Suppression d'une API précédemment obsolète dans PBL 8 API de remplacement à utiliser API queryPurchaseHistoryAsync Voir Interroger l'historique des achats querySkuDetailsAsync queryProductDetailsAsync enablePendingPurchases() (API sans paramètres) enablePendingPurchases(PendingPurchaseParams params)
Notez que la méthode obsolète enablePendingPurchases() est fonctionnellement équivalente àenablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build())
.queryPurchasesAsync(String skuType, PurchasesResponseListener listener) queryPurchasesAsync BillingClient.Builder.enableAlternativeBilling BillingClient.Builder.enableUserChoiceBilling AlternativeBillingListener UserChoiceBillingListener AlternativeChoiceDetails UserChoiceDetails Mettre à niveau à partir de
Le tableau suivant répertorie les API supprimées dans PBL 8 et les API de remplacement correspondantes que vous devez utiliser dans votre application.
Suppression d'une API précédemment obsolète dans PBL 8 API de remplacement à utiliser API queryPurchaseHistoryAsync Voir Interroger l'historique des achats querySkuDetailsAsync queryProductDetailsAsync enablePendingPurchases() (API sans paramètres) enablePendingPurchases(PendingPurchaseParams params)
Notez que la méthode obsolète enablePendingPurchases() est fonctionnellement équivalente àenablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build())
.queryPurchasesAsync(String skuType, PurchasesResponseListener listener) queryPurchasesAsync (Recommandé) Activez la reconnexion automatique du service.
La bibliothèque Play Billing peut tenter de rétablir automatiquement la connexion au service si un appel d'API est effectué alors que le service est déconnecté. Pour en savoir plus, consultez la section Activer la reconnexion automatique des services.
Modifications facultatives.
Acceptez les achats en attente pour les forfaits prépayés. Pour en savoir plus, consultez la section Gérer les abonnements et les transactions en attente.
Abonnements avec versement virtuel Pour en savoir plus, consultez la section Intégration des abonnements en plusieurs versements.