ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

Sous-classes indirectes connues

AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BuddyInfoMetricCollector , BugreportCollector , BugreportzMetricCollector , BugreportzOnFailureCollector , CollectingTestListener , ConsoleResultReporter , DebugHostLogOnFailureCollector , DeviceUnavailEmailResultReporter , DumpHeapCollector , et 58 autres.

AggregatePostProcessor	Un agrégateur de métriques qui donne le minimum, le maximum, la moyenne, la variance et l'écart type pour les métriques numériques collectées au cours de tests à itérations multiples, en les traitant comme des doubles.
AtraceCollector	Un `IMetricCollector` qui exécute une trace pendant un test et collecte le résultat et le consigne dans l'appel.
AtraceRunMetricCollector	Collecte les traces de tout le répertoire de test sous le répertoire donné à partir du périphérique de test, enregistre le répertoire de test et post-traite les fichiers de trace sous le répertoire de test et agrège les métriques.
AveragePostProcessor	Implémentation d'un post-processeur qui calcule la moyenne de la liste des métriques.
BaseDeviceMetricCollector	`IMetricCollector` de base d' `IMetricCollector` permettant 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` base que chaque implémentation doit étendre.
BuddyInfoMetricCollector	Un `ScheduledDeviceMetricCollector` pour collecter la fragmentation à intervalles réguliers.
BugreportCollector	Un `ITestInvocationListener` pass-through qui collecte les `ITestInvocationListener` lorsque des événements configurables se produisent, puis appelle `ITestInvocationListener#testLog` sur ses enfants après la collecte de chaque rapport de `ITestInvocationListener#testLog` .
BugreportzMetricCollector	Un `ScheduledDeviceMetricCollector` pour collecter un rapport de bogue compressé à intervalles réguliers.
BugreportzOnFailureCollector	Récupérez un bugreportz lorsqu'un cas de test échoue.
CollectingTestListener	Un `ITestInvocationListener` qui collectera tous les résultats des tests.
ConsoleResultReporter	Reporteur de résultats pour imprimer les résultats du test sur la console.
DebugHostLogOnFailureCollector	Collecteur qui rassemblera et consignera les journaux côté hôte en cas d'échec du scénario de test.
DeviceUnavailEmailResultReporter	`EmailResultReporter` qui enverra un e-mail lorsque l'appel échoue en raison d'une exception de périphérique non disponible.
DumpHeapCollector	Un `ScheduledDeviceMetricCollector` pour collecter les vidages de mémoire des processus à intervalles réguliers.
EmailResultReporter	Une classe de base de rapporteur de résultats simple qui envoie des e-mails pour les résultats des tests.
FailureEmailResultReporter	`EmailResultReporter` qui envoie des notifications en cas d'échec d'un test ou d'un échec d'appel.
FileProtoResultReporter	Proto reporter qui `TestRecord` le `TestRecord` dans un fichier.
FilePullerDeviceMetricCollector	`BaseDeviceMetricCollector` qui écoute les clés de métriques provenant de l'appareil et les extrait sous forme de fichier depuis l'appareil.
FilePullerLogCollector	Enregistreur du fichier signalé par le périphérique.
FilteredResultForwarder	Variante de `ResultForwarder` qui permet uniquement de `ResultForwarder` une liste blanche de `TestDescription` .
FormattedGeneratorReporter	Reporter qui permet de générer des rapports dans un format particulier.
GraphiquesStatsMetricCollector	Un `ScheduledDeviceMetricCollector` pour collecter des statistiques graphiques à intervalles réguliers.
HostStatsdMetricCollector	Un `IMetricCollector` qui collecte les métriques statsd du côté hôte à l'aide des commandes de l'utilitaire statsd.
ICommandScheduler.IScheduledInvocationListener	Écouteur pour les événements d'appel lorsque l'appel est terminé.
ILogSaverListener	Permet à `ITestInvocationListener` s d'écouter lorsque les fichiers journaux sont enregistrés.
IMetricCollector	Cette interface sera ajoutée en tant que décorateur lors du reporting des résultats des tests afin de collecter les métriques correspondantes.
IPostProcessor	Les post-processeurs sont un objet de la fédération commerciale destiné à permettre le traitement des métriques et des journaux APRÈS les tests et AVANT le rapport des résultats.
IShardableListener	Un `ITestInvocationListener` qui peut être partitionné.
ITestInvocationListener	Écouteur des résultats de test de l'appel de test.
ITestSummaryListener	Interface qui permet à `ITestInvocationListener` d'échanger des informations limitées via des résumés.
IncidentReportCollector	Extrait et traite les rapports d'incidents signalés côté appareil.
InvocationFailureEmailResultReporter	Un `EmailResultReporter` qui peut également restreindre les notifications aux seuls échecs d'appel.
InvocationToJUnitResultForwarder	Une classe qui écoute les événements `ITestInvocationListener` et les transmet à un `TestListener` .
IonHeapInfoMetricCollector	Un `ScheduledDeviceMetricCollector` pour collecter des tas de mémoire audio et système à intervalles réguliers.
JsonHttpTestResultReporter	Un rapporteur de résultats qui encode les résultats des métriques de test et la branche, les informations de l'appareil dans JSON et POST dans un point de terminaison de service HTTP
LegacySubprocessResultsReporter	Une classe pour le rapporteur de résultats de sous-processus gelés qui est compatible avec la version M & N de CTS.
LogSaverResultForwarder	Un `ResultForwarder` pour enregistrer les journaux avec l'économiseur de fichiers global.
LogcatCrashResultForwarder	Auditeur spécial: en cas d'échec (crash du processus d'instrumentation), il tentera d'extraire du logcat le crash et l'ajoutera au message d'échec associé au test.
LogcatOnFailureCollector	Collecteur qui capturera et enregistrera un logcat lorsqu'un cas de test échoue.
MemInfoMetricCollector	Un `ScheduledDeviceMetricCollector` pour collecter des vidages de mémoire à intervalles réguliers.
MétriquesXMLResultReporter	MetricsXMLResultReporter écrit des métriques de test et exécute des métriques dans un fichier XML dans un dossier spécifié par le paramètre metrics-folder lors de la phase invocationEnded du test.
ModuleListener	Auditeur attaché à chaque `IRemoteTest` de chaque module afin de collecter la liste des résultats.
NameMangleListener	Un écouteur proxy pour traduire les noms de méthode de test, de classe et de package lorsque les résultats sont signalés.
NativeCodeCoverageListener	Un `ResultForwarder` qui `ResultForwarder` les mesures de couverture natives de l'appareil et les consignera comme artefacts de test.
PagetypeInfoMetricCollector	Un `ScheduledDeviceMetricCollector` pour collecter le nombre de pages gratuites à intervalles réguliers.
PerfettoPullerMetricCollector	`FilePullerDeviceMetricCollector` 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	Logger correspondant aux événements et les consignant afin de faciliter le débogage.
ProcessMaxMemoryCollector	`ScheduledDeviceMetricCollector` pour mesurer l'utilisation maximale de la mémoire des processus spécifiés.
ProtoResultReporter	Le rapporteur de résultats construit un `TestRecord` TestRecord avec tous les résultats à l'intérieur.
PythonBinaryHostTest.PythonForwarder	Le redirecteur de résultats remplace le nom de l'analyse par le nom binaire.
RebootReasonCollector	Collecteur qui collecte le redémarrage de l'appareil pendant l'exécution du test et les signale par raison et par nombre.
ResultAndLogForwarder	Transitaire pour les résultats et enregistre les événements.
RésultatForwarder	Un `ITestInvocationListener` qui transmet les résultats de l'appel à une liste d'autres écouteurs.
RéessayerResultForwarder	Une extension de `ResultForwarder` qui pousse toujours vers un numéro de tentative donné.
RuntimeRestartCollector	Collecteur qui collecte les horodatages des redémarrages d'exécution (le serveur système se bloque) pendant l'exécution du test, le cas échéant.
ScheduleMultipleDeviceMetricCollector	Un `IMetricCollector` qui exécute périodiquement plusieurs collecteurs de métriques.
ScheduledDeviceMetricCollector	Un `IMetricCollector` qui permet d'exécuter une tâche de collecte périodiquement à un intervalle défini.
ScreenshotOnFailureCollector	Collecteur qui capturera et consignera une capture d'écran lorsqu'un scénario de test échoue.
ShardListener	Un `ITestInvocationListener` qui collecte les résultats d'un fragment d'appel (c'est-à-dire un fractionnement d'appel pour s'exécuter sur plusieurs ressources en parallèle) et les transmet à un autre écouteur.
ShardMasterResultForwarder	`ResultForwarder` qui combine les résultats d'un appel de test partitionné.
StreamProtoResultReporter	Une implémentation de `ProtoResultReporter`
SubprocessResultsReporter	Implémente `ITestInvocationListener` pour qu'il soit spécifié en tant que result_reporter et transmette à partir du sous-processus les résultats des tests, des exécutions de test, des appels de test.
SuiteResultReporter	Collectez les résultats de test pour un appel de suite entière et sortez les résultats finaux.
TemperatureCollector	Un `ScheduledDeviceMetricCollector` pour mesurer la température minimale et maximale de l'appareil.
TestFailureEmailResultReporter	Un `EmailResultReporter` qui peut également restreindre les notifications pour tester uniquement les échecs.
TestFailureListener	L'écouteur utilisé pour effectuer des actions telles que capture d'écran, rapport de bogue, collecte de logcat en cas d'échec du test sur demande.
TextResultReporter	Un rapporteur de résultats de test qui transmet les résultats à l'imprimante de résultats de texte JUnit.
TraceCmdCollector	`IMetricCollector` qui collecte des traces pendant le test à l'aide de trace-cmd et les enregistre dans l'appel.
TraceMetricCollector	Un `ScheduledDeviceMetricCollector` pour collecter la trace de débogage du noyau à intervalles réguliers.
TradefedSandboxRunner.StubScheduledInvocationListener	Un stub `IScheduledInvocationListener` qui ne fait rien.
XmlFormattedGeneratorReporter	L'implémentation du `FormattedGeneratorReporter` qui `FormattedGeneratorReporter` la suite donne un format xml.
XmlResultReporter	Écrit les résultats JUnit dans des fichiers XML dans un format cohérent avec XMLJUnitResultFormatter d'Ant.

Reçoit des notifications d'événements pendant les exécutions de test d'instrumentation.

Inspiré de org.junit.runner.notification.RunListener

La séquence des appels sera:

testRunStarted
testStarted
[test échoué]
[testAssumptionFailure]
[testIgnored]
testEnded
....
[testRunFailed]
testRunEnded

Sommaire

Méthodes publiques
`default void`	`testAssumptionFailure ( TestDescription test, String trace)` Appelé lorsqu'un test atomique signale qu'il suppose une condition fausse
`default void`	`testEnded ( TestDescription test, long endTime, testMetrics)` `testEnded ( TestDescription test, long endTime, testMetrics)` Alternative à `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` où nous pouvons spécifier l'heure de fin directement.
`default void`	`testEnded ( TestDescription test, testMetrics)` `testEnded ( TestDescription test, testMetrics)` Signale la fin de l'exécution d'un cas 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)` `testRunEnded (long elapsedTimeMillis, runMetrics)` Signale la fin du test.
`default void`	`testRunFailed (String errorMessage)` L’exécution du test des rapports n’a pas abouti en raison d’une erreur fatale.
`default void`	`testRunStarted (String runName, int testCount, int attemptNumber)` Signale le début d'un test.
`default void`	`testRunStarted (String runName, int testCount)` Signale le début d'un test.
`default void`	`testRunStarted (String runName, int testCount, int attemptNumber, long startTime)` Signale le début d'un test.
`default void`	`testRunStopped (long elapsedTime)` Le test des rapports s'est arrêté avant la fin en raison d'une demande de l'utilisateur.
`default void`	`testStarted ( TestDescription test, long startTime)` Alternative à `testStarted(com.android.tradefed.result.TestDescription)` où nous `testStarted(com.android.tradefed.result.TestDescription)` également quand le test a été lancé, combiné avec `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map))` pour une mesure précise .
`default void`	`testStarted ( TestDescription test)` Signale 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 signale qu'il suppose une condition fausse

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

testEnded

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

Alternative à ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) où nous pouvons spécifier l'heure de fin directement. Combinez avec testStarted(com.android.tradefed.result.TestDescription, long) pour une mesure précise.

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

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

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

Si testFailed(TestDescription, String) n'a pas été testFailed(TestDescription, String) , ce test a réussi. Renvoie également toutes les métriques clé / valeur qui peuvent avoir été émises lors de l'exécution du scénario de test.

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

test échoué

public void testFailed (TestDescription test, 
                String trace)

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

Sera appelé entre testStarted et testEnded.

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

testIgnoré

public 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.

Paramètres
`test`	`TestDescription` : identifie le test

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Signale la fin du test. FIXME: Nous ne pouvons pas avoir deux interfaces Map <> avec un type différent, nous devons donc utiliser HashMap ici.

Paramètres
`elapsedTimeMillis`	`long` : l'appareil a signalé le temps écoulé, en millisecondes
`runMetrics`	: paires clé-valeur signalées à la fin d'un test avec `Metric` .

testRunFailed

public void testRunFailed (String errorMessage)

Le test des rapports n’a pas abouti 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)

Signale le début d'un test.

Paramètres
`runName`	`String` : le nom du test
`testCount`	`int` : nombre total de tests en test
`attemptNumber`	`int` : numéro de commande, identifiant les différentes tentatives du même runName exécutées plusieurs fois. Le tryNumber est indexé à 0 et doit s'incrémenter chaque fois qu'une nouvelle exécution se produit. Par exemple, un test est retenté de manière granulaire 3 fois, il doit avoir 4 exécutions au total sous le même runName et le nombre de tentatives est compris entre 0 et 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Signale le début d'un test.

Paramètres
`runName`	`String` : le nom du test
`testCount`	`int` : nombre total de tests en test

testRunStarted

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

Signale le début d'un test.

Paramètres
`runName`	`String` : le nom du test
`testCount`	`int` : nombre total de tests en test
`attemptNumber`	`int` : numéro de commande, identifiant les différentes tentatives du même runName exécutées plusieurs fois. Le tryNumber est indexé à 0 et doit s'incrémenter à chaque fois qu'une nouvelle exécution se produit. Par exemple, un test est retenté de manière granulaire 3 fois, il doit avoir 4 exécutions au total sous le même runName et le nombre de tentatives est compris entre 0 et 3.
`startTime`	`long` : l'heure de démarrage de l'analyse, mesurée via `System.currentTimeMillis()`

testRunStopped

public void testRunStopped (long elapsedTime)

Le test des rapports s'est arrêté avant la fin en raison d'une demande utilisateur.

TODO: actuellement inutilisé, envisagez de supprimer

Paramètres
`elapsedTime`	`long` : l'appareil a signalé le temps écoulé, en millisecondes

testStarted

public void testStarted (TestDescription test, 
                long startTime)

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

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

testStarted

public void testStarted (TestDescription test)

Signale le début d'un scénario de test individuel. Interface plus ancienne, devrait utiliser testStarted(com.android.tradefed.result.TestDescription) chaque fois que possible.

Paramètres
`test`	`TestDescription` : identifie le test