Aller au contenu

Configurer les tests en sandbox Android

GitHub

Le test des achats in-app nécessite une configuration adaptée dans la Google Play Console. Ce guide vous explique comment configurer des tests en sandbox pour votre app Android.

Avant de commencer, distinguez ces trois types de builds Android :

  • Build local de debug/dev: idéal pour vérifier l'UI et les intégrations natives sur votre appareil.
  • AAB de release signé envoyé sur la Play Console: requis pour des tests réalistes de la facturation Google Play.
  • Build de test installé via le Play Store: le build que vos testeurs installent depuis un canal interne ou fermé. Utilisez-le pour la QA des achats.

Si vous vous contentez de sideloader un APK depuis Android Studio ou adb, Google Play Billing peut ne pas se comporter comme en production. Pour la validation des abonnements et des achats in-app, testez toujours avec un build installé depuis Google Play.

  • Un compte développeur Google Play Console. Si vous n'en avez pas encore créé, commencez par l'inscription à la Play Console.
  • Une fiche d'application créée dans la Play Console avec votre nom de package Android définitif
  • Vos produits in-app ou abonnements créés dans la Play Console
  • Un compte Gmail de test que vous pouvez ajouter aux tests de licence
  • Un build de release signé prêt pour l'upload

Avant de passer du temps sur la configuration de la facturation, créez l'application dans la Play Console et décidez si elle sera gratuit ou payant. Google vous permet de passer une application payante en gratuite plus tard, mais une fois qu'une application a été proposée gratuitement, elle ne peut plus devenir payante.

Utilisez un Android App Bundle (.aab) pour les nouvelles apps du Play Store :

Fenêtre de terminal
bunx cap sync android
cd android
./gradlew bundleRelease

Assurez-vous que la signature de votre release Android est déjà configurée avant de lancer bundleRelease. Si votre keystore, votre config de signature ou vos mots de passe de release ne sont pas encore définis, créez le bundle signé depuis Android Studio avec Build > Générer un App Bundle / APK signé, ce qui vous demandera ces valeurs.

  1. Ajouter un compte de test

    Dans la Play Console, ouvrez Paramètres > Test de licence et ajoutez le compte Google principal utilisé sur votre appareil de test Android.

    Cela garantit que les achats affichent le flux sandbox de Play au lieu de tenter un débit réel.

    Ajouter un compte de test

  2. Choisissez une piste de test

    Accéder à Test et publication > Tests et choisissez l'une de ces pistes :

    • Tests internes: Le chemin le plus rapide pour vos tests de QA et de facturation. Les nouveaux bundles sont normalement disponibles en quelques minutes.
    • Tests fermés: Idéal pour des tests plus larges, et requis avant la production pour les comptes développeurs personnels créés après le 13 novembre 2023.

    Pour une première release, Play peut afficher un nom d'application et des informations de fiche temporaires auprès des testeurs internes pendant 48 heures maximum.

    Créer une piste de test

  3. Créer une liste de testeurs

    Après avoir ouvert votre piste, créez une liste de testeurs et ajoutez les comptes Google qui doivent recevoir le build.

    Si vous visez l’accès à la production sur un compte personnel nouvellement créé, assurez-vous d’utiliser test fermé et de conserver au moins 12 testeurs inscrits pendant 14 jours consécutifs.

    Créer une liste de testeurs

  4. Envoyer un build de release signé

    Créez une nouvelle release dans la piste de test sélectionnée et envoyez votre .aab.

    Les nouvelles applications Google Play doivent utiliser un Android App Bundle plutôt qu’un APK. Après l’envoi, enregistrez la release, corrigez tout blocage de politique ou de fiche store signalé par Play, puis publiez la release sur la piste de test.

    Envoyer le build de release

  5. Rejoindre le programme de test

    Ouvrez l’URL d’inscription depuis votre appareil de test et cliquez sur « Devenir testeur » pour vous inscrire.

    Installez l’application depuis la fiche Play Store créée par ce flux d’inscription, et non depuis un APK exporté localement.

    Rejoindre les tests

  6. Compiler et tester

    Lancez le build installé via Play sur l’appareil de test et tentez un achat. Vous devriez voir un message du type :

    « Il s’agit d’une commande de test ; vous ne serez pas facturé. »

    Achat de test

  • Pour le QA de la facturation, désinstallez toute copie sideloadée de l’application avant d’installer le build de test Play.
  • Les tests internes sont parfaits pour des smoke tests rapides, mais les tests fermés sont l'étape qui compte pour obtenir l'accès à la production avec un nouveau compte personnel.
  • Les comptes de test ne seront pas débités pour les achats
  • Les tests d'achats utilisent le même flux que les achats en production
  • Vous pouvez tester toutes les fonctionnalités d'abonnement, y compris les périodes d'essai et les offres introductives
  • Les abonnements de test ont des périodes de renouvellement accélérées pour un test plus rapide
  • Utilisez le même compte Google pour les trois endroits : le Play Store sur l'appareil, le parcours d'opt-in du testeur et License testing

Les produits ne s'affichent pas en mode test :

  • Assurez-vous que votre app est envoyée sur un canal de test
  • Vérifiez que le compte de test est ajouté au License testing
  • Vérifiez que les produits sont actifs dans la Google Play Console
  • Vérifiez que le build a été installé depuis Google Play, et non en sideload

Erreur « Article non disponible » :

  • Attendez 2 à 3 heures après la création des produits pour qu’ils deviennent disponibles
  • Vérifiez que le nom du package de votre app correspond à celui de Play Console
  • Vérifiez que vous êtes connecté avec un compte de test
  • Confirmez que vous avez envoyé le build de release signé qui pointe vers le même nom de package et le même catalogue de produits

Achats de test apparaissant comme des paiements réels :

  • Vérifiez que le compte est bien ajouté aux tests de licence
  • Assurez-vous d’utiliser le build de la piste de test
  • Vérifiez que la bannière de test s’affiche pendant l’achat

Continuer après « Configurer les tests en sandbox Android »

Section intitulée « Continuer après “Configurer les tests en sandbox Android” »

Si vous utilisez Configurer les tests en sandbox Android pour planifier la validation et la distribution sur le store, connectez-l’à Utiliser @capgo/native-purchases pour la capacité native dans Utiliser @capgo/native-purchases @capgo/capacitor-in-app-review pour le détail d'implémentation dans @capgo/capacitor-in-app-review, Utiliser @capgo/capacitor-in-app-review pour la capacité native dans Utiliser @capgo/capacitor-in-app-review, @capgo/capacitor-native-market pour le détail d'implémentation dans @capgo/capacitor-native-market, et Utiliser @capgo/capacitor-native-market pour la capacité native dans Utiliser @capgo/capacitor-native-market.