Aller directement au contenu

Configurer les tests de sandbox Android

La mise en œuvre des achats 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 tests de sandbox pour votre application Android.

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.
  • Signature de version de sortie AAB téléchargée sur le console Play: Nécessaire pour des tests de facturation 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 ce build 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.

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

Avant de passer du temps sur la configuration des factures, créez l'application dans la 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 bundle d'application Android (.aab) pour les nouvelles applications de magasin Play :

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

Vérifiez que votre signature de publication Android est déjà configurée avant de lancer. bundleReleaseSi votre clé de signature, votre configuration de signature ou vos mots de passe de publication ne sont pas encore définis, créez le bundle signé à partir de Android Studio avec Génération > Générez un bundle signé ou un APKProcessus de configuration

Section intitulée “Processus de configuration”

Ajouter un compte de test
  1. 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 la flux de test Play au lieu d'essayer un véritable paiement.

    Ajouter un compte de test

    Processus de configuration

  2. Choisissez un parcours de test

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

    • Test interne: Chemin le plus rapide pour les tests de qualité et de fumée de facturation. Les nouvelles versions sont normalement disponibles dans les 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 publication, Play peut afficher un nom d'application temporaire et des informations de liste pour les testeurs internes pendant jusqu'à 48 heures.

    Créer un parcours de test

  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 sur l'accès en production sur un compte personnel créé récemment, assurez-vous d'utiliser la version de test fermée et gardez au moins 12 testeurs optés pour 14 jours consécutifs.

    Créer la liste des testeurs

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

    Créer une nouvelle version dans le chemin de test sélectionné et téléchargez votre .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.

    Télécharger la build de la version

  5. Rejoignez 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 l'App Store créée par ce flux d'opt-in, et non à partir d'un APK exporté localement.

    Rejoignez les tests

  6. Construire et tester

    Lancez la version de build Play installée sur le dispositif de test et effectuez une commande d'achat. Vous devriez voir un message comme :

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

    Commande d'achat de test

  • Avant de procéder à la facturation QA, supprimez toute copie de l'application installée par sidérisation avant d'installer la version de test de l'App Store.
  • Les tests internes sont parfaits pour les tests rapides de fumée, mais la testification fermée est la voie qui compte pour l'accès à la production avec un compte personnel.
  • Les comptes de test ne seront pas facturés pour les achats
  • Les commandes d'achat de test utilisent le même flux que les achats en production
  • Vous pouvez tester toutes les fonctionnalités d'abonnement, y compris les essais et les offres d'introduction
  • Les essais d'abonnement 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 magasin Play sur le dispositif, le flux d'adhésion du testeur et la mise à l'épreuve de la licence

Les 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 mise à l'épreuve de la licence
  • Vérifiez que les produits sont actifs dans le console Google Play
  • Confirmez que la build a été installée à partir de Google Play, et non téléchargée localement

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 le console de Play
  • Vérifiez que vous êtes connecté avec un compte de test
  • Confirmez que vous avez téléchargé la version signée de la mise en production qui pointe vers le même nom de package et le catalogue de produits

Testez les achats qui apparaissent comme des frais réels :

  • Vérifiez que le compte est ajouté à la licence de test
  • Vérifiez que vous utilisez la version de la piste de test
  • Vérifiez que le bandeau de test apparaît lors de l'achat