ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

Sous-classes indirectes connues AggregatePostProcessor, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CollectingTestListener, et 77 autres. AggregatePostProcessor Agrégateur de métriques qui donne les centiles minimum, max, moyenne, variance, écart type, total, nombre et éventuellement centiles pour les métriques numériques collectées lors d'exécutions de tests d'itérations multiples, en les traitant comme des doubles.  AtraceCollector IMetricCollector qui exécute une trace pendant un test, collecte le résultat et les consigne dans l'appel.  AtraceRunMetricCollector Collecte les traces de l'ensemble du répertoire de test sous le répertoire donné à partir de l'appareil de test, consigne le répertoire de test et post-traite les fichiers de trace sous le répertoire de test, puis agrège les métriques.  AveragePostProcessor Implémentation de la fonction de post-traitement permettant de calculer la moyenne de la liste de métriques.  BaseDeviceMetricCollector Implémentation de base de IMetricCollector qui permet de démarrer et d'arrêter la collecte sur onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) et ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)).  BasePostProcessor IPostProcessor de base que chaque implémentation doit étendre.  BluetoothConnectionLatencyCollector Le collecteur transmettra une configuration de métrique de durée statsd prédéfinie aux appareils et collectera la durée de connexion Bluetooth pour chaque profil.  BluetoothConnectionStateCollector Ce collecteur collectera les métriques BluetoothConnectionStateChanged et enregistrera le numéro d'état de la connexion pour chaque profil.  BluetoothConnectionSuccessRatePostProcessor Implémentation d'un post-processeur qui calcule le taux de réussite d'un profil Bluetooth Utilisez "metric-key-match" pour spécifier les métriques contenant des états de connexion Bluetooth dans un tableau numérique (par exemple, [0, 1, 2, 3, 0, 1, 2, 3]).  BluetoothHciSnoopLogCollector Collecteur permettant d'activer l'enregistrement des données relatives à la connectivité HCI Bluetooth dans un journal snoop sur l'appareil testé et de collecter le journal pour chaque test.  BugreportCollector ITestInvocationListener de passthrough qui collecte les rapports de bugs lorsque des événements configurables se produisent, puis appelle ITestInvocationListener#testLog sur ses enfants après chaque rapport de bug collecté.  BugreportzOnFailureCollector Collectez un bugreportz lorsqu'un scénario de test échoue.  BugreportzOnTestCaseFailureCollector Collectez un bugreportz lorsqu'un cas de test d'une exécution échoue.  ClangCodeCoverageCollector Un BaseDeviceMetricCollector qui extrait les mesures de couverture Clang de l'appareil et les consigne en tant qu'artefacts de test.  CollectingTestListener Un ITestInvocationListener qui collecte tous les résultats des tests.  CommandStatusHandler Gestionnaire permettant de surveiller et de mettre à jour l'état d'une invocation.  ConditionFailureMonitor Surveillez les échecs de l'appel.  ConsoleResultReporter Rapporteur de résultats pour imprimer les résultats du test dans la console.  CountTestCasesCollector Comptez et signalez le nombre de scénarios de test pour un IRemoteTest donné.  CountingTestResultListener Un TestResultListener qui suit le nombre total de tests par TestStatus  DebugHostLogOnFailureCollector Collecteur qui collecte et consigne les journaux côté hôte en cas d'échec d'un cas de test.  DeviceReleaseReporter Outil de signalement de la libération de l'appareil qui gère la communication avec le processus parent de l'appareil ou des appareils à libérer.  DeviceTraceCollector Collecteur qui lancera la trace Perfetto au début d'une exécution de test et le fichier de suivi du journal à la fin.  DeviceUnavailableMonitor Cet écouteur tente de capturer un DNAE au niveau du scénario de test uniquement.  EventsLoggerListener Écouteur qui consigne tous les événements qu'il reçoit dans un fichier FileProtoResultReporter Enregistreur Proto qui vide le TestRecord dans un fichier.  FilePullerDeviceMetricCollector Un objet BaseDeviceMetricCollector qui écoute les clés de métriques provenant de l'appareil et les extrait en tant que fichier à partir de l'appareil.  FilePullerLogCollector Enregistreur du fichier signalé par l'appareil côté appareil.  FilteredResultForwarder Variante de ResultForwarder qui n'autorise qu'une liste d'autorisation de TestDescription à être signalée.  FormattedGeneratorReporter Outil de création de rapports permettant de générer des rapports dans un format particulier.  GcovCodeCoverageCollector Un BaseDeviceMetricCollector qui extrait les mesures de couverture gcov de l'appareil et les consigne en tant qu'artefacts de test.  GcovKernelCodeCoverageCollector Un BaseDeviceMetricCollector qui extrait les mesures de couverture du kernel gcov des debugfs et de l'appareil, puis les consigne en tant qu'artefacts de test.  GranularRetriableTestWrapper.StartEndCollector Assistant de classe pour détecter le début et la fin de l'exécution manquants.  HostStatsdMetricCollector Un IMetricCollector qui collecte des métriques statsd côté hôte à l'aide de commandes d'utilitaire statsd.  ICommandScheduler.IScheduledInvocationListener Écouteur des événements d'invocation une fois l'invocation terminée.  ILogSaverListener Permet aux ITestInvocationListener d'écouter les fichiers journaux lorsqu'ils sont enregistrés.  IMetricCollector Cette interface sera ajoutée en tant que décorateur lors de la création de rapports sur les résultats des tests afin de collecter les métriques correspondantes.  IPostProcessor Les post-traitements sont des objets Trade Federation destinés à permettre le traitement des métriques et des journaux APRÈS les tests et AVANT la création de rapports sur les résultats.  IShardableListener Un ITestInvocationListener qui peut être segmenté.  ISupportGranularResults (en anglais) Interface spécifiant si un ITestInvocationListener est compatible avec la réception des résultats détaillés ou non.  ITestInvocationListener Écouteur des résultats des tests à partir de l'appel de test.  ITestSummaryListener Interface permettant à ITestInvocationListener d'échanger certaines informations limitées via des récapitulatifs.  InvocationToJUnitResultForwarder Classe qui écoute les événements ITestInvocationListener et les transmet à un TestListener.  JarHostTest.HostTestListener Écouteur de wrapper qui transfère tous les événements, à l'exception de testRunStarted() et testRunEnded(), à l'écouteur intégré.  JavaCodeCoverageCollector Un BaseDeviceMetricCollector qui extrait les mesures de couverture Java de l'appareil et les consigne en tant qu'artefacts de test.  JsonHttpTestResultReporter Un outil de création de rapports sur les résultats qui encode les résultats des métriques de test et les informations sur la branche et l'appareil au format JSON, puis les envoie en POST vers un point de terminaison de service HTTP LUCIResultReporter Un outil de création de rapports sur les résultats qui enregistre les résultats des tests nécessaires à ResultDB et LUCI au format JSON (go/result-sink) et consigne l'emplacement du fichier dans la console.  LastShardDetector. Lorsque vous exécutez le fractionnement local, il arrive que vous ne souhaitiez exécuter certaines actions que lorsque le dernier segment atteint invocationEnded(long).  LegacySubprocessResultsReporter Implémentation figée du rapporteur de résultats du sous-processus qui devrait rester compatible avec les versions antérieures de TF/CTS (par exemple, version 8 et ultérieures), malgré les modifications apportées à sa superclasse.  LogSaverResultForwarder ResultForwarder pour enregistrer les journaux avec l'outil d'enregistrement de fichiers global.  LogcatCrashResultForwarder Écouteur spécial: en cas d'échec (plantage du processus d'instrumentation), il tente d'extraire le plantage du fichier logcat et l'ajoute au message d'échec associé au test.  LogcatOnFailureCollector Collecteur qui capture et consigne un logcat en cas d'échec d'un scénario de test.  LogcatTimingMetricCollector Collecteur de métriques qui collecte des informations de synchronisation (par exemple, le temps de changement d'utilisateur) à partir de logcat lors d'un ou de plusieurs tests répétés à l'aide de modèles d'expression régulière donnés pour analyser les signaux de début et de fin d'un événement à partir des lignes logcat.  MetricFilePostProcessor Permet d'importer le fichier de journal des métriques collecté au niveau du test et de l'exécution.  MetricsXMLResultReporter MetricsXMLResultReporter écrit les métriques de test et les métriques d'exécution dans un fichier XML dans un dossier spécifié par le paramètre metrics-folder lors de la phase invocationEnded du test.  ModuleListener Écouteur associé à chaque IRemoteTest de chaque module afin de collecter la liste des résultats.  ModuleLogcatCollector Version du collecteur Logcat, mais pour le module.  ModuleProtoResultReporter Outil de création de rapports sur les résultats destiné à générer uniquement des rapports au niveau du module.  NameMangleListener Un écouteur proxy pour traduire les noms de méthode, de classe et de package de test lorsque les résultats sont signalés.  PassingTestFileReporter Un ITestInvocationListener qui enregistre la liste des scénarios de test réussis dans un fichier de test PerfettoGenericPostProcessor Post-processeur qui convertit le fichier proto de métrique textuelle/binaire perfetto en paires clé-valeur en développant de manière récursive les messages et les champs proto avec des valeurs de chaîne jusqu'à ce que le champ avec une valeur numérique soit rencontré.  PerfettoPullerMetricCollector Implémentation de base de FilePullerDeviceMetricCollector qui permet d'extraire les fichiers Perfetto de l'appareil et de collecter les métriques à partir de celui-ci.  PrettyTestEventLogger Journalisation des événements afin de faciliter le débogage.  ProtoResultReporter Result Reporter crée un protobuf TestRecord contenant tous les résultats.  PythonBinaryHostTest.PythonForwarder Transmetteur de résultats pour remplacer le nom de l'exécution par le nom binaire.  RedémarrerReasonCollector Collecteur qui collecte les redémarrages de l'appareil pendant l'exécution du test et les signale par raison et nombre.  RemoteTestTimeOutEnforcer Écouteurs permettant de vérifier le temps d'exécution d'une configuration de test donnée et de l'échouer si elle dépasse un délai d'inactivité donné.  ReportPassedTests Enregistrez dans un fichier les filtres possibles pour exclure les tests réussis.  ResultAggregator (Agrégateur de résultats) Transmetteur spécial qui agrège les résultats si nécessaire, en fonction de la stratégie de nouvelle tentative adoptée.  ResultAndLogForwarder Redirecteur des résultats et des événements de journalisation.  ResultForwarder ITestInvocationListener qui transfère les résultats d'invocation à une liste d'autres écouteurs.  RetryLogSaverResultForwarder Transmetteur qui gère également la transmission de la tentative en cours.  RetryResultForwarder Extension de ResultForwarder qui pousse toujours vers un numéro d'essai donné.  RuntimeRestartCollector Collecteur qui collecte les codes temporels des redémarrages d'exécution (plantages du serveur système) pendant l'exécution du test, le cas échéant.  ScreenshotOnFailureCollector Collecteur qui capture et consigne une capture d'écran lorsqu'un cas de test échoue.  ShardListener ITestInvocationListener qui collecte les résultats d'un segment d'invocation (également appelé fractionnement d'invocation pour s'exécuter sur plusieurs ressources en parallèle) et les transfère à un autre écouteur.  ShardMainResultForwarder ResultForwarder qui combine les résultats d'appels de test segmentés.  ShowmapPullerMetricCollector Implémentation de base de FilePullerDeviceMetricCollector qui permet d'extraire les fichiers showmap de l'appareil et de collecter les métriques à partir de celui-ci.  StatsdBeforeAfterGaugeMetricPostProcessor Un post-processeur qui traite les métriques de jauge collectées selon une approche "avant/après", c'est-à-dire : StatsdEventMetricPostProcessor Post-traitement qui traite les métriques d'événement dans les rapports statsd sous forme de paires clé/valeur, à l'aide des outils de mise en forme spécifiés sur le processeur.  StatsdGenericPostProcessor Post-traitement qui convertit les rapports binaires proto statsd en paires clé-valeur en développant le rapport sous forme de structure arborescente.  StreamProtoResultReporter Implémentation de ProtoResultReporter SubprocessResultsReporter Met en œuvre ITestInvocationListener pour être spécifié en tant que result_reporter et transférer à partir du sous-processus les résultats des tests, des exécutions de test et des appels de test.  SuiteResultReporter Collecter les résultats des tests pour un appel de suite entier et générer les résultats finaux  TestResultListener Simplification de ITestLifecycleListener pour les implémentateurs qui ne s'intéressent qu'aux résultats de test individuels.  TestRunResultListener Paramètre "Listener" permettant de lire l'état final de l'exécution du test  TestTimeoutEnforcer Les écouteurs permettent de vérifier la durée d'exécution d'un scénario de test donné et d'échouer en cas de dépassement du délai avant expiration.  TextResultReporter Un outil de création de rapports sur les résultats des tests qui transfère les résultats à l'imprimante de résultats textuels JUnit.  TraceCmdCollector Un IMetricCollector qui collecte des traces pendant le test à l'aide de trace-cmd et les consigne dans l'appel.  TradefedSandboxRunner.StubScheduledInvocationListener Un bouchon IScheduledInvocationListener qui n'a aucun effet.  XmlFormattedGeneratorReporter Implémentation de FormattedGeneratorReporter qui met en forme les résultats de la suite au format XML.  XmlResultReporter Écrit les résultats JUnit dans un fichier XML au format compatible avec XMLJUnitResultFormatter d'Ant.

---

Réçoit des notifications d'événements lors des exécutions de tests d'instrumentation.

Modélisé sur org.junit.runner.notification.RunListener

La séquence d'appels sera la suivante:

• testRunStarted
• Démarrage du test démarré
• [testFailed]
• [testAssumptionFailure]
• [testIgnored]
• testEnded
• ....
• TestRunEnded

Résumé

Méthodes publiques
default void	testAssumptionFailure(TestDescription test, String trace) Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse
default void	testAssumptionFailure(TestDescription test, FailureDescription failure) Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse
default void	testEnded(TestDescription test, long endTime, testMetrics) Alternative à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), où nous pouvons spécifier directement l'heure de fin.
default void	testEnded(TestDescription test, testMetrics) Indique la fin de l'exécution d'un scénario de test individuel.
default void	testFailed(TestDescription test, FailureDescription failure) Indique l'échec d'un scénario de test individuel.
default void	testFailed(TestDescription test, String trace) Signale l'échec d'un cas de test individuel.
default void	testIgnored(TestDescription test) Appelé lorsqu'un test ne sera pas exécuté, généralement parce qu'une méthode de test est annotée avec org.junit.Ignore.
default void	testRunEnded(long elapsedTimeMillis, runMetrics) Signale la fin de l'exécution du test.
default void	testRunFailed(FailureDescription failure) L'exécution du test des rapports a échoué en raison d'un échec décrit par FailureDescription.
default void	testRunFailed(String errorMessage) L'exécution du test des rapports a échoué en raison d'une erreur fatale.
default void	testRunStarted(String runName, int testCount, int attemptNumber) Indique le début d'une exécution de test.
default void	testRunStarted(String runName, int testCount) Indique le début d'une exécution de test.
default void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Indique le début d'une exécution de test.
default void	testRunStopped(long elapsedTime) L'exécution du test des rapports s'est arrêtée avant d'être terminée en raison d'une requête de l'utilisateur.
default void	testSkipped(TestDescription test, SkipReason reason) Appelé lorsqu'un test est ignoré et n'a pas été exécuté pour une raison inhabituelle.
default void	testStarted(TestDescription test, long startTime) Alternative à testStarted(com.android.tradefed.result.TestDescription), où nous spécifions également le moment où le test a commencé, combiné à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) pour une mesure précise.
default void	testStarted(TestDescription test) Indique le début d'un scénario de test individuel.

Méthodes publiques

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse

Paramètres
test	TestDescription: identifie le test.
trace	String: trace de la pile de l'échec

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Appelé lorsqu'un test atomique indique qu'il suppose une condition fausse

Paramètres
test	TestDescription: identifie le test
failure	FailureDescription: FailureDescription décrivant l'échec et son contexte.

testEnded

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternative à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)), où nous pouvons spécifier directement l'heure de fin. Combinez-le avec testStarted(com.android.tradefed.result.TestDescription, long) pour obtenir des mesures précises.

Paramètres
test	TestDescription: identifie le test
endTime	long: heure de fin du test, mesurée via System.currentTimeMillis()
testMetrics	: ERROR(/Map) des métriques émises

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Indique la fin de l'exécution d'un cas de test individuel.

Si testFailed(TestDescription, FailureDescription) n'a pas été appelé, ce test est réussi. Renvoie également toutes les métriques clé/valeur qui ont pu être émises lors de l'exécution du cas de test.

Paramètres
test	TestDescription: identifie le test
testMetrics	: ERROR(/Map) des métriques émises

Échec du test

public void testFailed (TestDescription test, 
                FailureDescription failure)

Signale l'échec d'un cas de test individuel.

Appelé entre testStarted et testEnded.

Paramètres
test	TestDescription: identifie le test
failure	FailureDescription: FailureDescription décrivant l'échec et son contexte.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Signale l'échec d'un cas de test individuel.

Appelé entre testStarted et testEnded.

Paramètres
test	TestDescription: identifie le test.
trace	String: trace de la pile de l'échec

TestIgnoré

public void testIgnored (TestDescription test)

Appelé lorsqu'un test n'est pas exécuté, généralement parce qu'une méthode de test est annotée avec org.junit.Ignore.

Paramètres
test	TestDescription: identifie le test

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Signale la fin de l'exécution du test.

Paramètres
elapsedTimeMillis	long: durée écoulée, en millisecondes, indiquée par l'appareil
runMetrics	: paires clé-valeur signalées à la fin d'une exécution de test

testRunFailed

public void testRunFailed (FailureDescription failure)

Échec de l'exécution du test des rapports en raison d'un échec décrit par FailureDescription.

Paramètres
failure	FailureDescription: FailureDescription décrivant l'échec et son contexte.

TestRunFailed

public void testRunFailed (String errorMessage)

Échec de l'exécution du test des rapports en raison d'une erreur fatale.

Paramètres
errorMessage	String: String décrivant la raison de l'échec de l'exécution.

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Indique le début d'une exécution de test.

Paramètres
runName	String: nom de l'exécution du test
testCount	int: nombre total de tests dans l'exécution de test
attemptNumber	int: numéro de commande, identifiant les différentes tentatives du même runName exécutées plusieurs fois. Le numéro "tentative" est indexé par 0 et doit être incrémenté à chaque nouvelle exécution. Par exemple, un test précis a été relancé trois fois, il doit comporter quatre exécutions au total sous le même nom d'exécution, et le numéro de tentative est compris entre 0 et 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Indique le début d'une exécution de test.

Paramètres
runName	String: nom de l'exécution du test
testCount	int: nombre total de tests dans l'exécution de test

Exécution du test démarrée

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Indique le début d'une exécution de test.

Paramètres
runName	String: nom de l'exécution du test
testCount	int: nombre total de tests dans l'exécution de test
attemptNumber	int: numéro de commande, identifiant les différentes tentatives du même runName exécutées plusieurs fois. Le numéro "tentative" est indexé par 0 et doit s'incrémenter à chaque nouvelle exécution. Par exemple, un test précis a été relancé trois fois. Il doit comporter quatre exécutions au total sous le même nom d'exécution, et la valeur de "tryNumber" est comprise entre 0 et 3.
startTime	long: heure de début de l'exécution, mesurée via System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

L'exécution du test des rapports a été arrêtée avant d'être terminée en raison d'une requête de l'utilisateur.

TODO: currently unused, consider removing

Paramètres
elapsedTime	long: durée écoulée, en millisecondes, indiquée par l'appareil

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Appelé lorsqu'un test est ignoré et ne s'est pas exécuté pour une raison inattendue. Nous allons tenter de réexécuter ces tests pour obtenir une exécution correcte.

Paramètres
test	TestDescription: identifie le test
reason	SkipReason : SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternative à testStarted(com.android.tradefed.result.TestDescription), où nous spécifions également le moment où le test a commencé, combiné à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) pour une mesure précise.

Paramètres
test	TestDescription: identifie le test
startTime	long: heure de début du test, mesurée via System.currentTimeMillis()

testStarted

public void testStarted (TestDescription test)

Indique le début d'un scénario de test individuel. Interface plus ancienne. Utilisez testStarted(com.android.tradefed.result.TestDescription) dans la mesure du possible.

Paramètres
test	TestDescription: identifie le test.