Configurer les tests en sandbox Android
Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.
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.
Utilisez le bon build pour cette tâche
Section intitulée « Utilisez le bon build selon le besoin »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.
Prerequisites
Section intitulée « Prérequis »- 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 :
bunx cap sync androidcd android./gradlew bundleReleaseAssurez-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.
Processus de configuration
Section intitulée « Processus de configuration »-
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.

-
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 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.

-
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.

-
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.

-
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é. »

Notes importantes
Section intitulée « Notes importantes »- 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
Troubleshooting
Section intitulée « Dépannage »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
Ressources complémentaires
Section intitulée « Ressources complémentaires »- Tester les achats avec Google Play Billing
- Configurer un test ouvert, fermé ou interne
- Exigences de test pour les nouveaux comptes développeurs personnels
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.