Configure le test de sandbox Android

La mise en œuvre des achats en application nécessite une configuration appropriée dans le console Google Play. Ce guide vous guidera dans la configuration de la mise en œuvre de tests de sandbox pour votre application Android.

Utilisez la bonne version pour le travail

Avant de commencer, séparez ces trois types de versions Android :

• Version de débogage local/dev: Bon pour vérifier l'interface utilisateur et les intégrations natives sur votre appareil.
• Version de publication signée AAB téléchargée sur la console Play: Nécessaire pour les tests de facturation Google Play réalistes.
• Version de test de Play installé: La version que les testeurs installent à partir d'une piste interne ou fermée. Utilisez cette option pour les tests de qualité avant la vente.

Si vous n'installez que l'APK à partir de l'Android Studio ou adb, Google Play Billing peut ne pas se comporter de la même manière qu'en production. Pour la validation des abonnements et des achats en application, testez toujours avec une version installée à partir de Google Play.

Prérequis

• Un compte développeur Google Play Console. Si vous n'avez pas créé un compte encore, commencez par Console de jeu Play.
• Un enregistrement d'application créé dans la Console de jeu avec votre nom de package Android final
• Vos produits ou abonnements en application créés dans la Console de jeu
• Un compte Gmail de test que vous pouvez ajouter à la licence de test
• Une version signée prête à l'envoi

Avant de passer du temps sur la configuration des factures, créez l'application dans la Console de jeu et décidez si elle sera gratuit ou payantGoogle vous permet de déplacer une application payante vers gratuite ultérieurement, mais une fois qu'une application a été proposée en gratuité, elle ne peut pas être changée en payante.

Utilisez un Bundle d'application Android (.aab) pour les nouvelles applications de Google Play :

bunx cap sync android
cd android
./gradlew bundleRelease

Assurez-vous que votre signature de lancement Android est déjà configurée avant de lancer bundleRelease. Si votre clé de signature, votre configuration de signature ou vos mots de passe de lancement ne sont pas encore définis, créez le bundle signé à partir d'Android Studio avec Générez > Générer un bundle signé / APK, qui vous demande ces valeurs.

Procédure de mise en place

1. Ajouter un compte de test

   Dans le console Google Play, ouvrez Paramètres > Licence de test et ajoutez le compte Google principal utilisé sur votre appareil Android de test.

   Cela garantit que les achats affichent le flux de test de Google Play au lieu d'essayer un véritable paiement.

   

2. Choisissez un itinéraire de test

   Allez à Test et publication > Test et choisissez l'un de ces itinéraires :

   • Tests internesVoie la plus rapide pour les tests de QA et de fumée de facturation. Les nouvelles archives sont normalement disponibles en quelques minutes.
   • Tests fermésMieux adapté aux 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 mise en production, Play peut afficher un nom d'application temporaire et des informations de liste pour les testeurs internes pendant au maximum 48 heures.

   

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 devraient recevoir la build.

   Si vous travaillez vers l'accès à la production sur un compte personnel nouvellement créé, assurez-vous d'utiliser les tests fermés et gardez au moins 12 testeurs optés pour 14 jours consécutifs.

   

4. Télécharger une Release Build Signée

   Créer une nouvelle version dans le parcours de test sélectionné et télécharger votre version signée .aab.

   Les nouvelles applications Google Play doivent utiliser un Android App Bundle plutôt qu'un APK. Après téléchargement, enregistrez la version, corrigez tout bloqueur de politique ou de liste de magasin Play flags, puis publiez la version dans le parcours de test.

   

5. Rejoindre le Programme de Test

   Ouvrez l'URL d'opt-in de votre appareil de test et cliquez sur le “Devenir un testeur” bouton pour vous inscrire.

   Installez l'application à partir de la liste de magasin Play créée par ce flux d'opt-in, et non à partir d'un APK localement exporté.

   

6. Construire et Tester

   Lancez la build Play sur l'appareil de test et effectuez une commande d'achat. Vous devriez voir un message comme :

   “Cette commande est un test; vous ne serez pas facturé.”

   

Notes importantes

• Pour le test de facturation QA, désinstallez toute copie de l'application installée par sidéchargement avant d'installer la version de test de Play.
• Le test interne est excellent pour les tests rapides de fumée, mais le test fermé est la piste qui compte pour l'accès de production à nouveau compte personnel.
• Les comptes de test ne seront pas facturés pour les achats
• Les achats de test utilisent le même flux que les achats de production
• Vous pouvez tester toutes les fonctionnalités d'abonnement, y compris les essais et les offres d'introduction
• 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 : la boutique Play sur le dispositif, le flux d'opt-in du testeur et le test de licence

Dépannage

Produits ne s'affichent pas en mode test :

• Assurez-vous que votre application est téléchargée sur une piste de test
• Vérifiez que le compte de test est ajouté à la licence de test
• Vérifiez que les produits sont activés dans le console Google Play
• Confirmez que la build a été installée à partir de Google Play, et non sideloadée localement

« Erreur : article non disponible » :

• Attendez 2-3 heures après avoir créé des produits pour qu'ils deviennent disponibles
• Assurez-vous que le nom de package de votre application correspond à celui dans la console Play
• Vérifiez que vous êtes connecté avec un compte de test
• Confirmez que vous avez téléchargé la build de signature de libération qui pointe vers le même nom de package et le catalogue de produits

Achats de test s'affichent comme des frais réels :

• Vérifiez que le compte est ajouté à la licence de test
• Assurez-vous d'utiliser la build provenant de la piste de test
• Vérifiez que le bandeau de test s'affiche lors de l'achat

Ressources supplémentaires

• Effectuez des achats de test avec Google Play Billing
• Configurez un test ouvert, fermé ou interne
• Exigences de test pour les nouveaux comptes de développeurs personnels

Continuez de Configurez le test de l'arrière-plan Android

Si vous utilisez Configurez le test de l'arrière-plan Android planifier l'approbation et la distribution de l'application, connectez-la à En utilisant @capgo/native-purchases pour la capacité native dans En utilisant @capgo/native-purchases, @capgo/capacitor-examen-de-l'application-intérieure pour le détail d'implémentation dans @capgo/capacitor-examen-de-l'application-intérieure, En utilisant @capgo/capacitor-examen-de-l'application-intérieure pour la capacité native dans En utilisant @capgo/capacitor-examen-de-l'application-intérieure, @capgo/capacitor-marché-natif pour le détail d'implémentation dans @capgo/capacitor-marché-natif, et En utilisant @capgo/capacitor-marché-natif pour la capacité native dans En utilisant @capgo/capacitor-marché-natif.