Configurez les tests de sandbox Android

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

Utilisez la bonne version pour le travail

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

• Build de débogage local/dev : : Bon pour vérifier l'interface utilisateur et les intégrations natives sur votre appareil.Avant de commencer, séparez ces trois types de build Android : Local debug/dev build : Bon pour vérifier l'interface utilisateur et les intégrations natives sur votre appareil.
• Signature de version de mise en ligne AAB téléchargée sur le console de Play: Nécessaire pour des tests de facturation de Google Play réaliste.
• Test de build installé sur Play: Le build que vos testeurs installent à partir d'une piste interne ou fermée. Utilisez cela pour la validation des achats.

Si vous n'installez qu'un APK à partir d'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 un build installé à partir de Google Play.

Prérequis

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

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

Utilisez un Android App Bundle (.aab) pour les nouvelles applications de magasin Play :

bunx cap sync android
cd android
./gradlew bundleRelease

Assurez-vous que votre signature de sortie Android est déjà configurée avant de l'exécuter bundleRelease. Si votre clé de stockage, votre configuration de signature ou vos mots de passe de mise en ligne ne sont pas encore définis, créez le bundle signé à partir d'Android Studio avec Générez > Créez un bundle signé d'application / APK, which prompts you for those values.

Procédure de mise en place

1. Ajouter un compte de test

   Dans le console 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 sandbox Play au lieu d'essayer une charge réelle.

   

2. Choisissez un itinéraire de test

   Allez à Test et publication > Test et choisissez l'un de ces parcours :

   • Test interne: Chemin le plus rapide pour les tests de QA et de fumée de facturation. Les nouvelles archives sont normalement disponibles en quelques minutes.
   • Test fermé: Plus adapté 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 mise en production, Play peut afficher un nom d'application temporaire et des informations de liste pour les testeurs internes pendant jusqu'à 48 heures.

   

3. Créer une liste de testeurs

   Après avoir ouvert votre parcours, 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 tests fermés et garder au moins 12 testeurs optés pour 14 jours consécutifs.

   

4. Télécharger une version de build signée

   Créer une nouvelle version dans le chemin 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 chemin de test.

   

5. Rejoignez le Programme de Test

   Ouvrez l'URL d'opt-in à partir de votre appareil de test et cliquez sur le “Devenez 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 exporté localement.

   

6. Construire et tester

   Lancez la mise en production de l'application Play sur le dispositif de test et effectuez une commande. Vous devriez voir un message comme :

   “Ceci est une commande de test ; vous ne serez pas facturé.”

   

Notes importantes

• Pour la vérification des factures, supprimez toute copie de l'application installée par sidéchargement avant d'installer la mise en production de test de l'application Play.
• Les tests internes sont excellents pour les tests rapides de fumée, mais la vérification fermée est la piste qui compte pour l'accès à la production avec un compte personnel.
• Les comptes de test ne seront pas facturés pour les commandes
• Les commandes de test utilisent le même flux que les commandes 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 accéléré les périodes de renouvellement pour un test plus rapide
• Utilisez le même compte Google pour les trois endroits : la boutique Play sur le dispositif, le flux d'adhésion du testeur et les tests de licence

Dépannage

Les produits ne s'affichent pas en mode test :

• Vérifiez que votre application est téléchargée sur une piste de test
• Vérifiez que le compte de test est ajouté aux tests de licence
• Vérifiez que les produits sont actifs dans le console Google Play
• Confirmez que l'installation a été effectuée à partir de Google Play et non localement par sideload

Erreur « article non disponible » :

• Attendez 2-3 heures après avoir créé des produits pour qu'ils deviennent disponibles
• Vérifiez 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 version de build signée qui pointe vers le même nom de package et le catalogue de produits

Testes des achats qui apparaissent 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 apparait lors de l'achat

Ressources supplémentaires

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

Continuez de la configuration de la test de sandbox Android

Si vous utilisez Configuration de l'émulation de test Android pour planifier l'approbation de la boutique et la distribution, connectez-le à Utilisation de @capgo/native-purchases pour la capacité native dans Utilisation de @capgo/native-purchases, @capgo/capacitor-in-app-review pour le détail d'implémentation dans @capgo/capacitor-in-app-review, Utilisation de @capgo/capacitor-in-app-review pour la capacité native dans Utilisation de @capgo/capacitor-in-app-review, @capgo/capacitor-native-market pour le détail d'implémentation dans @capgo/capacitor-native-market, et Utilisez @capgo/capacitor-market natively pour la capacité native dans Utilisez @capgo/capacitor-market.