Cette page a été traduite par l'API Cloud Translation.

ITestLifeCycleReceiverITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

Sous-classes indirectes connues

AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BugreportCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CollectingTestListener , CommandStatusHandler , and 74 others.

AggregatePostProcessor	Un agrégateur de métriques qui donne le minimum, le maximum, la moyenne, la variance, l'écart type, le total, le nombre et éventuellement les centiles pour les métriques numériques collectées lors des exécutions de tests à plusieurs itérations, en les traitant comme des doubles.
AtraceCollector	Un `IMetricCollector` qui exécute atrace pendant un test et collecte le résultat et le consigne dans l'invocation.
AtraceRunMetricCollectorAtraceRunMetricCollector	Collecte les traces de tous les répertoires 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	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))` .
BasePostProcessorBasePostProcessor	Le `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 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 qui contiennent les états de connexion Bluetooth dans un tableau numérique Exemple [0, 1, 2, 3, 0, 1, 2, 3].
BugreportCollector	Un `ITestInvocationListener` passe-système qui collecte les rapports de bogue lorsque des événements configurables se produisent, puis appelle `ITestInvocationListener#testLog` sur ses enfants après la collecte de chaque rapport de bogue.
Rapport de bugzOnFailureCollector	Collectez un rapport de boguez lorsqu'un scénario de test échoue.
Rapport de boguezOnTestCaseFailureCollector	Collectez un rapport de boguez lorsqu'un cas de test dans une exécution échoue.
ClangCodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extrait les mesures de couverture Clang de l'appareil et les enregistre en tant qu'artefacts de test.
CollectingTestListener	Un `ITestInvocationListener` qui collectera tous les résultats de test.
CommandStatusHandlerCommandStatusHandler	Gestionnaire aidant à surveiller et à mettre à jour le statut d'une invocation.
ConditionFailureMonitor	Surveillez les échecs de l'appel.
ConsoleResultReporterConsoleResultReporter	Reporter de résultats pour imprimer les résultats du test sur la console.
CountTestCasesCollector	Comptez et signalez le nombre de cas de test pour un `IRemoteTest` donné.
CountingTestResultListener	Un `TestResultListener` qui suit le nombre total de tests par `TestStatus`
DebugHostLogOnFailureCollector	Collecteur qui rassemblera et consignera les journaux côté hôte en cas d'échec d'un scénario de test.
DeviceReleaseReporter	Journaliste de libération de périphérique qui gère la communication avec le processus parent du ou des périphériques à libérer.
DeviceTraceCollector	Collecteur qui démarrera la trace perfetto au démarrage d'une exécution de test et consignera le fichier de trace à la fin.
DeviceUnavailableMonitor	Cet écouteur tente de capturer un ADNE de niveau cas de test uniquement.
EventsLoggerListener	Écouteur qui enregistre tous les événements qu'il reçoit dans un fichier
FileProtoReporterReporterFileProtoResultReporter	Proto reporter qui vide le `TestRecord` dans un fichier.
FilePullerDeviceMetricCollector	Un `BaseDeviceMetricCollector` qui écoute la clé de mesures provenant de l'appareil et les extrait sous forme de fichier à partir de l'appareil.
FilePullerLogCollector	Enregistreur du fichier signalé par le côté appareil.
FilteredResultForwarder	Variante de `ResultForwarder` qui permet uniquement de signaler une liste d'autorisation de `TestDescription` .
FormattedGeneratorReporterFormatedGeneratorReporter	Reporter qui permet 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 enregistre en tant qu'artefacts de test.
GcovKernelCodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extrait les mesures de couverture du noyau gcov des débogages et de l'appareil, puis les enregistre finalement en tant qu'artefacts de test.
GranularRetriableTestWrapper.StartEndCollector	Aide de classe pour détecter le début et la fin de l'exécution manquante.
HostStatsdMetricCollectorHostStatsdMetricCollector	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é.
ILogSaverListenerILogSaverListener	Permet aux `ITestInvocationListener` d'écouter lorsque les fichiers journaux sont enregistrés.
IMetricCollector	Cette interface sera ajoutée en tant que décorateur lors du rapport des résultats des tests afin de collecter les métriques correspondantes.
IPostProcesseur	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é.
ISupportGranularResults	Interface spécifiant si un `ITestInvocationListener` prend en charge ou non la réception des résultats granulaires.
ITestInvocationListenerITestInvocationListener	Écouteur des résultats de test de l'appel de test.
ITestSummaryListenerITestSummaryListener	Interface qui permet à `ITestInvocationListener` d'échanger des informations limitées via des résumés.
InvocationToJUnitResultForwarder	Une classe qui écoute les événements `ITestInvocationListener` et les transmet à un `TestListener` .
JarHostTest.HostTestListener	Écouteur wrapper qui transfère tous les événements sauf testRunStarted() et testRunEnded() à l'écouteur intégré.
JavaCodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extrait les mesures de couverture Java de l'appareil et les enregistre en tant qu'artefacts de test.
JsonHttpTestReporterReporter	Un rapporteur de résultats qui encode les résultats des métriques de test et la branche, les informations sur l'appareil dans JSON et POST dans un point de terminaison de service HTTP
LastShardDetector	Lors de l'exécution d'un partitionnement local, nous souhaitons parfois n'exécuter certaines actions que lorsque le dernier fragment atteint `invocationEnded(long)` .
LegacySubprocessResultsReporter	Une implémentation gelée du rapporteur de résultats de sous-processus qui devrait rester compatible avec les versions antérieures de TF/CTS (par exemple 8+), malgré les modifications apportées à sa superclasse.
LogSaverResultForwarder	Un `ResultForwarder` pour enregistrer les journaux avec l'économiseur de fichiers global.
LogcatCrashResultForwarder	Ecouteur 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 capture et enregistre un logcat lorsqu'un scénario de test échoue.
LogcatTimingMetricCollector	Un collecteur de métriques qui collecte des informations de synchronisation (par exemple, l'heure de commutation de l'utilisateur) à partir de logcat pendant un ou plusieurs tests répétés en utilisant des modèles regex donnés pour analyser les signaux de début et de fin d'un événement à partir de lignes logcat.
MetricFilePostProcessorMetricFilePostProcessor	Utilisé pour télécharger le fichier journal des métriques collecté au niveau du test et de l'exécution.
MetricsXMLReporterReporterMetricsXMLResultReporter	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	Listener attaché à chaque `IRemoteTest` de chaque module afin de collecter la liste des résultats.
ModuleLogcatCollector	Version du collecteur logcat mais pour le module.
NomMangleListener	Un écouteur proxy pour traduire les noms de méthode de test, de classe et de package au fur et à mesure que les résultats sont rapportés.
PassingTestFileReporter	Un `ITestInvocationListener` qui enregistre la liste des cas de test réussis dans un fichier de test
PerfettoGenericPostProcessor	Un post-processeur qui traite le fichier proto de métrique perfetto texte/binaire en paires clé-valeur en développant de manière récursive les messages proto et les champs 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 d'en collecter les métriques.
PrettyTestEventLogger	Enregistreur faisant correspondre les événements et les journalisant afin de faciliter le débogage.
ProtoResultReporter	Le rapporteur de résultats construit un `TestRecord` TestRecord avec tous les résultats à l'intérieur.
PythonBinaryHostTest.PythonForwarder	Transmetteur de résultat pour remplacer le nom d'exécution 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 nombre.
RemoteTestTimeOutEnforcerRemoteTestTimeOutEnforcer	Des écouteurs qui permettent de vérifier le temps d'exécution d'une configuration de test donnée et de l'échouer s'il dépasse un délai d'attente donné.
ReportPassedTests	Reportez dans un fichier les filtres possibles pour exclure les tests réussis.
Agrégateur de résultats	Transitaire spécial qui agrège les résultats en cas de besoin, en fonction de la stratégie de nouvelle tentative qui a été adoptée.
ResultAndLogForwarderResultAndLogForwarder	Transitaire pour les événements de résultats et de journaux.
ResultForwarder	Un `ITestInvocationListener` qui transfère les résultats d'appel à une liste d'autres écouteurs.
RetryLogSaverResultForwarderRetryLogSaverResultForwarder	Transitaire qui gère également le passage de la tentative actuelle à laquelle nous sommes.
RetryResultForwarder	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 (pannes du serveur système) pendant l'exécution du test, le cas échéant.
Capture d'écranOnFailureCollector	Collecteur qui capture et enregistre une capture d'écran lorsqu'un cas de test échoue.
ShardListener	Un `ITestInvocationListener` qui collecte les résultats d'une partition d'invocation (c'est-à-dire une division d'invocation pour s'exécuter sur plusieurs ressources en parallèle) et les transmet à un autre écouteur.
ShardMainResultForwarder	Un `ResultForwarder` qui combine les résultats d'appels de test fragmentés.
AffichercartePullerMetricCollector	Implémentation de base de `FilePullerDeviceMetricCollector` qui permet d'extraire les fichiers showmap de l'appareil et d'en collecter les métriques.
StatsdBeforeAfterGaugeMetricPostProcessor	Un post-processeur qui traite les métriques de jauge collectées dans une approche "avant/après", c'est-à-dire
StatsdEventMetricPostProcessorStatsdEventMetricPostProcessor	Un post-processeur qui traite les métriques d'événement dans les rapports statsd en paires clé-valeur, à l'aide des formateurs spécifiés sur le processeur.
StatsdGenericPostProcessor	Un post-processeur qui traite les rapports proto statsd binaires en paires clé-valeur en développant le rapport sous forme d'arborescence.
StreamProtoResultReporterStreamProtoResultReporterStreamProtoResultReporter	Une implémentation de `ProtoResultReporter`
SubprocessResultsReporterSubprocessResultsReporter	Implémente `ITestInvocationListener` à spécifier en tant que result_reporter et transmet depuis le sous-processus les résultats des tests, des exécutions de test, des appels de test.
SuiteResultReporterSuiteResultReporter	Collectez les résultats des tests pour l'ensemble d'un appel de suite et affichez les résultats finaux.
TestFailureListener	L'écouteur avait l'habitude de prendre des mesures telles qu'une capture d'écran, un rapport de bogue, une collecte de logcat en cas d'échec d'un test lorsqu'il était demandé.
TestResultListenerTestResultListener	Une simplification de ITestLifecycleListener pour les implémenteurs qui ne se soucient que des résultats de test individuels.
TestTimeoutEnforcer	Les écouteurs qui permettent de vérifier le temps d'exécution d'un cas de test donné et de l'échouer s'il dépasse un délai d'attente donné.
TextResultReporter	Un rapporteur de résultats de test qui transmet les résultats à l'imprimante de résultats de texte JUnit.
TraceCmdCollector	Un `IMetricCollector` qui collecte les traces pendant le test à l'aide de trace-cmd et les enregistre dans l'invocation.
TradefedSandboxRunner.StubScheduledInvocationListener	Un stub `IScheduledInvocationListener` qui ne fait rien.
XmlFormattedGeneratorReporterXmlFormattedGeneratorReporter	L'implémentation du `FormattedGeneratorReporter` qui formate la suite donne un format xml.
XmlResultReporterXmlResultReporter	Écrit les résultats JUnit dans des fichiers XML dans un format compatible avec XMLJUnitResultFormatter d'Ant.

Reçoit des notifications d'événements pendant les tests d'instrumentation.

Modelé après org.junit.runner.notification.RunListener

La séquence d'appels sera :

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

Résumé

Méthodes publiques
`default void`	`testAssumptionFailure ( TestDescription test, String trace)` Appelé lorsqu'un test atomique signale qu'il suppose une condition fausse
`default void`	`testAssumptionFailure ( TestDescription test, FailureDescription failure)` 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 directement l'heure de fin.
`default void`	`testEnded ( TestDescription test, testMetrics)` `testEnded ( TestDescription test, testMetrics)` Signale la fin de l'exécution d'un scénario de test individuel.
`default void`	`testFailed ( TestDescription test, FailureDescription failure)` Signale l'échec d'un scénario de test individuel.
`default void`	`testFailed ( TestDescription test, String trace)` Signale l'échec d'un scénario 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 de l'exécution du test.
`default void`	`testRunFailed ( FailureDescription failure)` L'exécution du test de rapports n'a pas abouti en raison d'un échec décrit par `FailureDescription` .
`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'une exécution de test.
`default void`	`testRunStarted (String runName, int testCount)` Signale le début d'une exécution de test.
`default void`	`testRunStarted (String runName, int testCount, int attemptNumber, long startTime)` Signale 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 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 spécifions é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

testAssumptionFailuretestAssumptionFailure

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 pile de l'échec

testAssumptionFailuretestAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Appelé lorsqu'un test atomique signale 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 avec testStarted(com.android.tradefed.result.TestDescription, long) pour une mesure précise.

Paramètres
`test`	`TestDescription` : identifie le test
`endTime`	`long` : l'heure à laquelle le test s'est terminé, 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 scénario de test individuel.

Si testFailed(TestDescription, FailureDescription) n'a pas été appelé, ce test a réussi. Renvoie également toute métrique clé/valeur qui peut avoir été émise lors de l'exécution du cas de test.

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

test échoué

public void testFailed (TestDescription test, 
                FailureDescription failure)

Signale l'échec d'un scénario de test individuel.

Sera appelé entre testStarted et testEnded.

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

test échoué

public void testFailed (TestDescription test, 
                String trace)

Signale l'échec d'un scénario de test individuel.

Sera appelé entre testStarted et testEnded.

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

testIgnored

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 de l'exécution du test. FIXME : nous ne pouvons pas avoir deux interfaces Map<> de type différent, nous devons donc utiliser HashMap ici.

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

testRunFailed

public void testRunFailed (FailureDescription failure)

L'exécution du test de rapports n'a pas abouti 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)

L'exécution du 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'une exécution de test.

Paramètres
`runName`	`String` : le nom de l'exécution du test
`testCount`	`int` : nombre total de tests en cours de test
`attemptNumber`	`int` : numéro de commande, identifiant les différentes tentatives du même runName qui s'exécutent 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 réessayé 3 fois de manière granulaire, il doit avoir 4 exécutions au total sous le même nom d'exécution et le nombre de tentatives est compris entre 0 et 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

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

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

testRunStarted

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

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

Paramètres
`runName`	`String` : le nom de l'exécution du test
`testCount`	`int` : nombre total de tests en cours de test
`attemptNumber`	`int` : numéro de commande, identifiant les différentes tentatives du même runName qui s'exécutent 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 réessayé 3 fois de manière granulaire, il doit avoir 4 exécutions au total sous le même nom d'exécution et le nombre de tentatives est compris entre 0 et 3.
`startTime`	`long` : l'heure à laquelle l'exécution a commencé, mesurée via `System.currentTimeMillis()`

testRunStopped

public void testRunStopped (long elapsedTime)

L'exécution du test des rapports s'est arrêtée avant la fin en raison d'une demande de l'utilisateur.

TODO : actuellement inutilisé, pensez à supprimer

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

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternative à testStarted(com.android.tradefed.result.TestDescription) où nous spécifions é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 à laquelle le test a commencé, mesurée via `System.currentTimeMillis()`

testStarted

public void testStarted (TestDescription test)

Signale le début d'un scénario de test individuel. L'ancienne interface doit utiliser testStarted(com.android.tradefed.result.TestDescription) chaque fois que possible.

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