Cet article explique le fonctionnement des rapports pré-lancement. Si vous avez généré un rapport pré-lancement et souhaitez savoir comment interpréter ses résultats, consultez la page Comprendre votre rapport pré-lancement.
Les rapports pré-lancement sont générés automatiquement lorsque vous importez un app bundle ou un APK, sous réserve de capacité dans notre laboratoire d'appareils. Lorsque les rapports pré-lancement sont générés, nous testons chaque artefact lors de son importation et de son enregistrement en production afin d'identifier les problèmes de manière proactive avant que les utilisateurs aient accès à votre application. Cela comprend des tests visant à détecter les problèmes suivants :
- Problèmes de stabilité
- Problèmes de compatibilité avec Android
- Problèmes de performances
- Problèmes d'accessibilité
Fonctionnement du rapport pré-lancement
Une fois que vous avez importé un app bundle ou enregistré une version dans le canal de production, nous l'installons sur un ensemble d'appareils Android dans Test Lab. Nous lançons ensuite automatiquement votre application et un robot l'explore pendant quelques minutes. Le robot d'exploration effectue des actions de base, par exemple taper du texte, appuyer sur l'écran et le balayer. Vous pouvez également fournir des tests personnalisés ou des identifiants de compte de test au robot d'exploration.
Une fois l'exploration terminée, nous compilons vos résultats dans le rapport pré-lancement. Nous désinstallons également votre application de tous les appareils Test Lab.
Évaluer si votre application est adaptée à un rapport pré-lancement
Le rapport pré-lancement fonctionne dès lors que nous pouvons installer et explorer votre application. Cependant, de légères modifications du code peuvent être nécessaires pour certaines applications, par exemple celles dont l'installation doit être approuvée ou dont la validation dépend du pays. Pour en savoir plus, consultez les questions fréquentes.
Remarque : Les appareils de test ne sont pas en mesure d'exécuter des tests sur les applications dépourvues d'activité de lancement principale, comme les lanceurs d'applications, les widgets, les claviers et les cadrans.
Tout réduire Tout développer
Générer un rapport pré-lancement
Nous générons automatiquement des rapports pré-lancement en fonction de la capacité globale de notre laboratoire d'appareils. Si la capacité le permet, ils s'exécutent automatiquement lors de l'importation d'un app bundle ou de l'enregistrement d'une version de production.
Personnaliser vos tests
Pour obtenir des rapports pré-lancement plus complets et pertinents pour votre application, vous pouvez personnaliser vos tests.
Si votre application dispose d'un écran de connexion et que vous souhaitez que le robot d'exploration teste le processus de connexion ou le contenu lié à ce processus, vous devez fournir des identifiants de compte.
Remarque : Vous n'avez pas besoin de fournir d'identifiants si votre application est compatible avec la fonctionnalité Se connecter avec Google (qui permet au robot d'exploration de se connecter automatiquement), ou si vous avez déjà fourni des identifiants sur le Page "Contenu de l'application".
Voici quelques points importants à prendre en compte lors du test des identifiants :
- Les identifiants que vous fournissez ne sont utilisés qu'à des fins de test.
- Sachez que nous faisons tout notre possible pour préserver la sécurité de vos identifiants. Nous vous recommandons toutefois de ne pas inclure d'identifiants officiels dans le rapport pré-lancement. Il est préférable de créer un nom d'utilisateur et un mot de passe spécifiques au compte de test.
- Les identifiants ne peuvent être automatiquement insérés que dans des applications Android utilisant des widgets Android standards. Les identifiants ne peuvent pas être utilisés ni dans les applications qui font appel à OpenGL pour afficher des commandes personnalisées, ni dans celles qui utilisent WebView pour fournir un flux d'authentification Web.
- Google se connecte automatiquement si votre application est compatible avec la fonctionnalité Se connecter avec Google.
- Ouvrez la Play Console.
- Sélectionnez une application.
- Dans le menu de gauche, accédez à la page Paramètres du rapport pré-lancement (Tester et publier
> Tests > Rapport pré-lancement > Paramètres). Dans la section "Identifiant de compte test", sélectionnez "Fournir les identifiants". Dans la section "Identifiant de compte test", sélectionnez Fournir les identifiants.
- Saisissez les informations suivantes :
- Nom d'utilisateur : nom d'utilisateur associé à votre compte de test.
- Mot de passe : mot de passe associé à votre compte de test.
- Cliquez sur Enregistrer. Ces identifiants seront utilisés pour tous les prochains tests, sauf si vous les modifiez.
- Ouvrez la Play Console.
- Sélectionnez une application.
- Dans le menu de gauche, accédez à la page Paramètres du rapport pré-lancement (Tester et publier
> Tests > Rapport pré-lancement > Paramètres).
- Apportez vos modifications :
- Pour modifier les identifiants : dans la section "Identifiant de compte test", saisissez vos identifiants mis à jour dans les champs "Nom d'utilisateur" et "Mot de passe".
- Pour supprimer les identifiants : dans la section "Identifiant de compte test", sélectionnez Ne pas fournir d'identifiants.
- Remarque : Si vous supprimez les identifiants de test de votre application, vous devrez en ajouter de nouveaux avant de pouvoir vous connecter à votre application dans le cadre de prochains tests.
- Cliquez sur Enregistrer. Ces identifiants seront utilisés pour tous les prochains tests, sauf si vous les modifiez.
Si vous souhaitez contrôler les actions du robot d'exploration pendant les tests de votre application, vous pouvez fournir un script Robo ou une boucle de jeu.
Vous pouvez fournir un script Robo afin d'indiquer au robot d'exploration d'effectuer des actions spécifiques pendant les tests de votre application (par exemple, tester le parcours habituel de l'utilisateur ou une nouvelle section de votre application).
Lorsque vous exécutez un test avec un script, le robot d'exploration réalise d'abord les actions décrites dans le script, puis explore l'application comme d'habitude.
Pour importer un script dans votre rapport pré-lancement, procédez comme suit :
- Enregistrez votre script à l'aide de l'outil Firebase dans Android Studio (Android Studio > Tools (Outils) > Firebase > Test Lab > Record Robo Script (Enregistrer un script Robo)). Pour en savoir plus, consultez le Centre d'aide Firebase.
- Remarque : Vous n'avez pas besoin d'un compte Firebase pour créer un script Robo.
- Lorsque votre script est prêt, ouvrez la Play Console.
- Sélectionnez une application.
- Dans le menu de gauche, accédez à la page Paramètres du rapport pré-lancement (Tester et publier
> Tests > Rapport pré-lancement > Paramètres). Dans la section "Contrôler comment le rapport pré-lancement explore votre application", importez votre script. Vous pouvez glisser-déposer votre fichier, ou sélectionner Importer.
- Cliquez sur Enregistrer.
Si vous testez un jeu ou une application qui utilise OpenGL, vous devez fournir une boucle de jeu pour obtenir un rapport pré-lancement de qualité. Une boucle de jeu définit les actions que vous souhaitez que le robot d'exploration effectue. Vous pouvez tester plusieurs boucles de jeu dans la même application.
Pour utiliser des boucles de jeu dans votre rapport pré-lancement, procédez comme suit :
- Modifiez votre jeu pour :
- lancer la boucle ;
- exécuter la boucle ;
- Fermez la boucle (facultatif). Vous devez effectuer ces modifications dans votre environnement de développement. Pour en savoir plus, consultez le Centre d'aide Firebase.
- Remarque : Vous n'avez pas besoin d'un compte Firebase pour utiliser des boucles de jeu dans le rapport pré-lancement.
- Importez la version de votre jeu. Le robot d'exploration détectera et exécutera automatiquement la boucle de jeu.
Vous pouvez ajouter jusqu'à trois liens profonds dans votre rapport pré-lancement afin de tester des points d'entrée supplémentaires pour votre application.
Le robot d'exploration fonctionne comme d'habitude pendant plusieurs minutes, puis ferme l'application et explore chaque lien profond l'un après l'autre pendant 30 secondes. Tous les problèmes détectés lors de ces explorations supplémentaires sont inclus dans le rapport.
Si vous souhaitez savoir comment créer et tester des liens profonds pour votre application, consultez le site pour les développeurs Android.
Si vous souhaitez afficher les résultats des tests pour des langues spécifiques, vous pouvez définir vos préférences de langue sur la page Paramètres du rapport pré-lancement. Vous pouvez sélectionner jusqu'à cinq langues.
Conseil : Comme le rapport pré-lancement est généré automatiquement lorsque vous importez un app bundle de test, vous ne pouvez ajouter des préférences de langue qu'au terme du test initial.
- Ouvrez la Play Console.
- Sélectionnez une application.
- Dans le menu de gauche, accédez à la page Paramètres du rapport pré-lancement (Tester et publier
> Tests > Rapport pré-lancement > Paramètres).
- Sous "Tester votre application dans des langues spécifiques", sélectionnez + Ajouter une langue.
- Sélectionnez jusqu'à cinq langues. Les prochains tests ne porteront que sur les langues que vous avez choisies.
- Remarque : Si vous ne choisissez aucune langue, nous sélectionnons automatiquement les langues dans lesquelles votre application a été le plus souvent installée.
- Cliquez sur Enregistrer.
Afficher votre rapport pré-lancement
Lorsque votre rapport pré-lancement est disponible, vous avez accès à un résumé des tests incluant le nombre d'erreurs, d'avertissements et de problèmes mineurs détectés pendant les tests, classés par type de problème. Une recommandation de lancement basée sur les résultats des tests de votre application s'affiche également.
Pour afficher le résumé de votre rapport pré-lancement, procédez comme suit :
- Ouvrez la Play Console.
- Sélectionnez une application.
- Sélectionnez Tester et publier
> Tests > Rapport pré-lancement > Vue d'ensemble.
- Passez en revue chaque section :
- Stabilité
- Performances
- Accessibilité
- Sécurité et fiabilité
- Si des problèmes ont été détectés pour une section, sélectionnez Afficher le résumé pour la développer.
- Sélectionnez Afficher les détails pour obtenir des informations plus détaillées sur les problèmes.
- Pour afficher les précédents rapports pré-lancement, faites défiler la page jusqu'au tableau de la section "Détails du rapport" en bas de la page.
Remarque : Si le message "Test en cours" s'affiche, cela signifie que votre dernier test n'est pas encore terminé. Si le dernier test n'a pas pu être exécuté, l'état "Échec du test" peut s'afficher. Pour exécuter un autre test, publiez un autre app bundle.
Pour afficher les résultats détaillés de votre rapport pré-lancement, procédez comme suit :
- Ouvrez la Play Console.
- Sélectionnez une application.
- Dans le menu de gauche, accédez à la page Détails du rapport pré-lancement ( Tester et publier
> Tests > Rapport pré-lancement > Détails).
- Consultez les onglets Stabilité, Performances, Accessibilité et Captures d'écran. Sur chaque page, vous trouverez tous les détails des résultats de votre dernier test, y compris les traces de pile, des captures d'écran et des graphiques.
Remarque : Si le message "Test en cours" s'affiche, cela signifie que votre dernier test n'est pas encore terminé. Si le dernier test n'a pas pu être exécuté, l'état "Échec du test" peut s'afficher. Pour exécuter un autre test, publiez un autre app bundle.
Tout réduire Tout développer
Vous recevrez généralement les résultats des tests dans l'heure qui suit l'importation de votre app bundle. Toutefois, il vous faudra parfois attendre plusieurs heures après l'importation. Si le rapport n'est pas prêt au bout de deux jours, réessayez d'importer votre artefact. Cela a pour effet de déclencher un nouveau rapport.
Vous pouvez toujours obtenir un rapport pré-lancement si vous êtes disposé à apporter de légères modifications à votre code.
Les appareils de test se trouvent aux États-Unis. Si votre application utilise la géolocalisation ou applique des restrictions liées au contenu en fonction du pays, les appareils de test ne pourront accéder qu'au contenu disponible pour leur zone géographique.
Si vous devez tester votre application dans une zone géographique différente de celle des appareils de test, vous pouvez publier un app bundle de manière à éliminer les exigences de zone géographique, à des fins de test. Il existe deux manières de vérifier que les rapports pré-lancement sont exécutés dans Test Lab :
La plate-forme de test n'est pas compatible avec les applications qui vérifient si un appareil dispose d'un contrôle privilégié (accès en mode root) sur Android.
Pour savoir comment limiter les revenus publicitaires frauduleux avec des tests d'application automatisés, consultez le site Google Developers.
Il n'est pas possible d'effectuer des achats avec des appareils de test. Si l'achat d'abonnements ou de produits intégrés à l'application est requis pour accéder à certaines parties de votre application, les scénarios de test risquent d'être limités.
Oui. Les tests du rapport pré-lancement seront tout de même exécutés.
Cependant, les traces de la pile associées aux plantages ou erreurs ANR détectés pendant les tests seront également obscurcies ou supprimées. Pour nous permettre de faciliter le débogage de vos traces de pile, nous vous recommandons d'importer un fichier de désobscurcissement ou de décodage.
Vous pouvez obtenir davantage d'informations sur l'importation de fichiers de désobscurcissement ou de décodage.
Non. La plate-forme de test n'est pas compatible avec le préchargement de contenus multimédias ou d'applications préinstallées.
Toutefois, si vous souhaitez exécuter des tests sur une application avec des données préchargées, vous pouvez publier une version de test de votre application avec vos fichiers multimédias intégrés dans l'app bundle.
Si votre application est en phase de test ouvert ou a été publiée en version de production, les tests du rapport pré-lancement utilisent un ID faisant office d'identifiant autorisé pour votre application.
Si votre application n'est pas en phase de test ouvert et qu'elle ne possède pas d'app bundle actif publié en version de production, elle échouera au contrôle de licence. Vous recevrez les résultats du rapport pré-lancement, mais l'état de votre application indiquera qu'elle ne possède pas de licence. Pour tester ce type d'application, vous pouvez publier votre application en version fermée et désactiver le service de gestion des licences.
Les appareils de test sont configurés pour exécuter les tests en mode Portrait par défaut. Toutefois, si votre application est verrouillée en mode Paysage, les vidéos et captures d'écran devraient s'afficher en mode Paysage.
Nous choisissons des appareils de test qui couvrent la majeure partie de l'écosystème, et nous prenons en compte leur popularité, la fréquence des plantages, les résolutions d'écran, les fabricants, la version du système d'exploitation Android, etc. La sélection des appareils de test peut varier.
Si vous avez exclu certains appareils du ciblage dans le fichier manifeste de votre application, le rapport pré-lancement les exclut également pendant les tests, mais ne cible aucun appareil supplémentaire pour votre application.
Le rapport pré-lancement est fourni par Firebase Test Lab. Pour personnaliser les appareils testés, envisagez d'effectuer vos propres tests dans la console Firebase.
Oui, nous exécuterons l'application sur un émulateur et l'explorerons comme nous le ferions avec un appareil physique.
Seuls les téléphones, les tablettes, les appareils Wear OS et les ordinateurs, comme les Chromebooks, sont acceptés. Vous ne pouvez pas tester d'applications directement sur Android Automotive OS ou sur des appareils Android TV.
Seuls les appareils dotés d'Android 9 ou version ultérieure sont acceptés.