Tester les codes de réponse BillingResult

La bibliothèque Play Billing renvoie une réponse BillingResult pour vous indiquer le résultat d'une action déclenchée. Pour en savoir plus, consultez la section Gérer les codes de réponse BillingResult. Avant de commencer déployer votre application dans l'environnement de production, vous pouvez tester les différents flux de réponse à l'aide du simulateur de réponse.

Simulateur de réponse

Lorsque vous intégrez votre application à la bibliothèque Play Billing, il peut être difficile de tester tous les flux BillingResponseCode, car vous n'avez pas beaucoup de contrôle sur la communication entre le Play Store et le backend de Play. La fonctionnalité de simulateur de réponse de l'application Play Billing Lab vous permet de configurer les réponses aux codes d'erreur de la bibliothèque Play Billing afin de tester divers scénarios d'erreur complexes.

Activer les tests de forçage de la facturation pour la bibliothèque Play Billing

Remarque :Avant d'effectuer des tests, assurez-vous que votre application utilise Bibliothèque Play Billing version 7.1.0 ou ultérieure.

Pour activer la communication entre le simulateur de réponse et votre application, vous devez activer les tests de forçage de facturation pour la bibliothèque Play Billing depuis votre application. Pour ce faire, ajoutez les balises de métadonnées suivantes au fichier AndroidManifest.xml de votre application.

<manifest ... >
  <application ... >
    ...
     <meta-data
      android:name="com.google.android.play.largest_release_audience.NONPRODUCTION"
      android:value="" />
    <meta-data
      android:name="com.google.android.play.billingclient.enableBillingOverridesTesting"
      android:value="true" />
  </application>
</manifest>

Remarque : Même si l'ajout de la seule balise enableBillingOverridesTesting et de sa valeur true suffit à activer les tests de forçage de la facturation pour votre application, nous vous recommandons d'ajouter également la balise NONPRODUCTION. La balise NONPRODUCTION empêche le déploiement accidentel de votre application dans l'environnement de production lorsque les tests de forçage de la facturation sont activés.

Lorsque vous déployez votre application dans l'environnement de production, vous devez utiliser un fichier AndroidManifest.xml distinct qui n'inclut pas ces balises de métadonnées ou vous assurer d'avoir supprimé ces balises du fichier AndroidManifest.xml.

Simuler les erreurs de la bibliothèque Play Billing

Pour simuler des erreurs de la bibliothèque Play Billing, commencez par configurer les codes de réponse dans l'application Play Billing Lab, puis testez votre application.

Configurer un code de réponse

1. Dans l'application Play Billing Lab, connectez-vous à votre application avec un compte de testeur de licence. Le tableau de bord Play Billing Lab s'affiche, avec la fiche Simulateur de réponse.

   

   Figure 1 Carte du simulateur de réponse.

2. Cliquez sur Gérer dans la fiche du simulateur de réponse. L'écran du simulateur de réponse s'affiche.

3. Lorsque vous y êtes invité, autorisez les notifications de Play Billing Lab pour voir l'état de la connexion de votre application.

4. Si ce n'est pas le cas, activez l'option Simuler les réponses de la bibliothèque Play Billing. déjà activée.

   

   Figure 2. Bouton bascule "Simuler les réponses de la bibliothèque Play Billing".

5. Sélectionnez un code de réponse pour les API de la bibliothèque Play Billing que vous souhaitez tester. Vos sélections sont automatiquement enregistrées et le simulateur de réponse est prêt à envoyer les codes de réponse sélectionnés à votre application.

Tester la gestion des erreurs dans votre application

Remarque : Lorsque vous effectuez des tests à l'aide du simulateur de réponse, assurez-vous d'abord d'ouvrir Play Billing Lab, puis d'ouvrir votre application. Si vous ouvrez votre application avant d'ouvrir Play Billing Lab, vous risquez de rencontrer des problèmes de connexion au simulateur de réponse.

1. Ouvrez votre application.

   • Si vous avez autorisé les notifications de Play Billing Lab, l'icône de notification de Play Billing Lab s'affiche dans la barre d'état de votre appareil, ce qui indique que vous êtes bien connecté au simulateur de réponse.

   

   Figure 3 Icône Play Billing Lab indiquant que la connexion a réussi.

2. Déclenchez la méthode de l'API Play Billing Library que vous souhaitez tester. Par exemple, si vous souhaitez tester launchBillingFlow, lancez un parcours d'achat intégré.