Gérer les erreurs dans le SDK Android

Chaque erreur renvoyée par le SDK est de type AdaptyError.

Activez les journaux détaillés avant de déboguer. La plupart des AdaptyError encapsulent une erreur sous-jacente de Play Billing, du réseau ou du backend. Avec les journaux détaillés activés (Adapty.logLevel = AdaptyLogLevel.VERBOSE — voir Journalisation), cette erreur encapsulée s’affiche dans la console, ce qui indique généralement la cause réelle.

Si ces solutions ne résolvent pas votre problème, consultez Autres problèmes pour connaître les étapes à suivre avant de contacter le support afin de nous permettre de vous aider plus efficacement.

Erreur	Solution
UNKNOWN	Cette erreur indique qu’une erreur inconnue ou inattendue s’est produite.
ITEM_UNAVAILABLE	Cette erreur survient principalement en phase de test. Elle peut signifier que les produits sont absents de la production ou que l’utilisateur n’appartient pas au groupe Testeurs dans Google Play.
ADAPTY_NOT_INITIALIZED	Le SDK Adapty n’est pas activé. Ce cas se présente le plus souvent quand un écran de démarrage ou un hook d’interface précoce appelle des méthodes Adapty avant que `Adapty.activate` ait terminé. Le symptôme est intermittent et peut ne pas se reproduire sur un émulateur, car le timing diffère d’un appareil réel. Attendez que `Adapty.activate` soit terminé avant de planifier tout autre appel SDK. Consultez l’ordre des appels dans le SDK Android pour la séquence complète. Vous devez également configurer le SDK Adapty correctement à l’aide de la méthode `Adapty.activate`.
PROFILE_WAS_CHANGED	Le profil utilisateur a été modifié pendant l’opération. Cela se produit lorsqu’une méthode est appelée alors qu’`Adapty.identify` est encore en cours — l’appel en vol atterrit sur un profil sur le point d’être remplacé, et le SDK le rejette. Attendez qu’`Adapty.identify` soit terminé avant de planifier d’autres appels SDK. Consultez l’ordre des appels dans le SDK Android.
PRODUCT_NOT_FOUND	Cette erreur indique que le produit demandé à l’achat n’est pas disponible dans le store.
INVALID_JSON	Le JSON du paywall de secours local n’est pas valide. Corrigez votre paywall anglais par défaut, puis remplacez les paywalls locaux invalides. Consultez la rubrique Personnaliser le paywall avec Remote Config pour savoir comment corriger un paywall, et Définir les paywalls de secours locaux pour savoir comment remplacer les paywalls locaux.
CURRENT_SUBSCRIPTION_TO_UPDATE _NOT_FOUND_IN_HISTORY	L’abonnement d’origine à remplacer est introuvable dans les abonnements actifs.
BILLING_SERVICE_TIMEOUT	Cette erreur indique que la requête a atteint le délai d’attente maximal avant que Google Play puisse répondre. Cela peut être dû, par exemple, à un retard dans l’exécution de l’action demandée par l’appel à la Play Billing Library.
FEATURE_NOT_SUPPORTED	La fonctionnalité demandée n’est pas prise en charge par le Play Store sur l’appareil actuel.
BILLING_SERVICE_DISCONNECTED	Cette erreur indique que la connexion de l’application cliente au service Google Play Store via le `BillingClient` a été interrompue.
BILLING_SERVICE_UNAVAILABLE	Cette erreur indique que le service Google Play Billing est actuellement indisponible. Dans la plupart des cas, cela signifie qu’il y a un problème de connexion réseau entre l’appareil client et les services Google Play Billing.
BILLING_UNAVAILABLE	Cette erreur indique qu’un problème de facturation s’est produit pendant le processus d’achat. Causes possibles : 1. L’application Play Store sur l’appareil de l’utilisateur est absente ou obsolète. 2. L’utilisateur se trouve dans un pays non pris en charge. 3. L’utilisateur fait partie d’un compte entreprise dont l’administrateur a désactivé les achats. 4. Google Play n’a pas pu débiter le moyen de paiement de l’utilisateur (par exemple, une carte de crédit expirée). 5. L’utilisateur n’est pas connecté à l’application Play Store.
DEVELOPER_ERROR	Cette erreur indique que vous utilisez une API de manière incorrecte.
BILLING_ERROR	Cette erreur indique un problème interne à Google Play lui-même.
ITEM_ALREADY_OWNED	Le produit a déjà été acheté.
ITEM_NOT_OWNED	Cette erreur indique que l’action demandée sur l’article a échoué car l’utilisateur n’en est pas propriétaire.
BILLING_NETWORK_ERROR	Cette erreur indique qu’un problème de connexion réseau s’est produit entre l’appareil et les systèmes Play.
NO_PRODUCT_IDS_FOUND	Cette erreur indique qu’aucun des produits du paywall n’est disponible dans le store. Si vous rencontrez cette erreur, suivez les étapes ci-dessous pour la résoudre : Vérifiez que tous les produits ont bien été ajoutés à l’Adapty Dashboard. Assurez-vous que le Package name de votre application correspond à celui indiqué dans la Google Play Console. Vérifiez que les identifiants de produits des stores correspondent à ceux que vous avez ajoutés au Dashboard. Notez que les identifiants ne doivent pas contenir le Bundle ID, sauf s’il est déjà inclus dans le store. Confirmez que le statut payant de l’application est Active dans vos paramètres fiscaux Google. Assurez-vous que vos informations fiscales sont à jour et que vos certificats sont valides. Vérifiez qu’un compte bancaire est associé à l’application afin qu’elle puisse être éligible à la monétisation. Vérifiez si les produits sont disponibles dans votre région. Assurez-vous que votre application figure dans l’un des canaux de test. Le canal Internal testing est l’option la plus simple, car il ne nécessite pas de validation et garde l’application invisible pour les clients.
NO_PURCHASES_TO_RESTORE	Cette erreur indique que Google Play n’a trouvé aucun achat à restaurer.
AUTHENTICATION_ERROR	Vous devez configurer le SDK Adapty correctement à l’aide de la méthode `Adapty.activate`.
BAD_REQUEST	Requête incorrecte. Assurez-vous d’avoir effectué toutes les étapes nécessaires à l’intégration avec Google Play.
SERVER_ERROR	Erreur serveur.
REQUEST_FAILED	Cette erreur indique un problème réseau qui ne peut pas être défini précisément.
DECODING_FAILED	Nous n’avons pas pu décoder la réponse. Vérifiez votre code et assurez-vous que les paramètres que vous envoyez sont valides. Par exemple, cette erreur peut indiquer que vous utilisez une clé API invalide.
ANALYTICS_DISABLED	Nous ne pouvons pas traiter les événements d’analyse, car vous avez désactivé cette option.
WRONG_PARAMETER	Cette erreur indique que certains de vos paramètres sont incorrects : vide alors qu’il ne peut pas l’être, mauvais type, etc.

Autres problèmes

Si vous n’avez pas encore trouvé de solution, voici les prochaines étapes possibles :

Mettre à jour le SDK vers la dernière version : nous recommandons toujours de passer à la dernière version du SDK, car elle est plus stable et inclut des correctifs pour les problèmes connus.
Contacter l’équipe support ou obtenir de l’aide auprès d’autres développeurs dans le forum d’assistance.
Contacter l’équipe support via support@adapty.io ou via le chat : si vous n’êtes pas prêt à mettre à jour le SDK ou si cela n’a pas résolu le problème, contactez notre équipe support. Notez que votre problème sera résolu plus rapidement si vous activez la journalisation verbeuse et partagez les logs avec l’équipe. Vous pouvez également joindre des extraits de code pertinents.