À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release au lieu de aosp-main pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.

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

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, CodeCoverageCollector et 80 autres.

AggregatePostProcessor	Agrégateur de métriques qui indique la valeur minimale, maximale, moyenne, variance, écart type, total, nombre et éventuellement des centiles pour les métriques numériques collectées lors d'exécutions de test à plusieurs itérations, 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 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))`.
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.
CodeCoverageCollector	Un `BaseDeviceMetricCollector` qui extrait les mesures de couverture Java et native 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	Outil de création de rapports sur les résultats pour imprimer les résultats des tests 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 démarre le traçage perfetto au début d'une exécution de test et enregistre le fichier de traçage à 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 `BaseDeviceMetricCollector` qui écoute la clé de métrique provenant de l'appareil et la récupère en tant que fichier de l'appareil.
FilePullerLogCollector	Enregistreur du fichier signalé 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 des commandes de l'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	`ITestInvocationListener` pouvant être partitionné
ISupportGranularResults	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 qui permet à `ITestInvocationListener` d'échanger certaines informations limitées via des récapitulatifs.
InvocationProtoResultReporter	Rapporteurs permettant de stocker des informations de mise en cache au niveau de l'appel et sa liste de modules
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, vous ne souhaitez parfois exécuter certaines actions que lorsque le dernier fragment 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 du logcat le plantage 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 temporelles (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	Un 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 d'en collecter les métriques.
PrettyTestEventLogger	Journalisation des événements afin de faciliter le débogage.
ProtoResultReporter	Le rapporteur de résultats 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.
RebootReasonCollector	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	Signalez dans un fichier les filtres possibles pour exclure les tests réussis.
ResultAggregator	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.
ResultDBReporter	Outil de création de rapports sur les résultats qui importe les résultats des tests dans ResultDB.
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 de la carte de présentation de l'appareil et d'en collecter les métriques.
StatsdBeforeAfterGaugeMetricPostProcessor	Un post-processeur qui traite les métriques de jauge collectées selon une approche "avant/après", c'est-à-dire :
StatsdEventMetricPostProcessor	Post-processeur qui convertit les métriques d'événement dans les rapports statsd en paires clé-valeur, à l'aide des formats spécifiés sur le processeur.
StatsdGenericPostProcessor	Post-traitement qui convertit les rapports proto statsd binaires en paires clé-valeur en développant le rapport sous forme de structure arborescente.
StreamProtoResultReporter	Implémentation de `ProtoResultReporter`
SubprocessResultsReporter	Implémente `ITestInvocationListener` pour être spécifié en tant que résultat_reporter et transmet depuis le sous-processus les résultats des tests, des cycles de test et des invocations de test.
SuiteResultReporter	Collectez les résultats des tests pour une invocation de suite complète et affichez 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	Écouteur permettant de lire l'état de l'exécution finale du test.
TestTimeoutEnforcer	Écouteurs permettant 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'inactivité donné.
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 `IScheduledInvocationListener` bouchon qui ne fait rien.
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.

Il reç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
testStarted
[testFailed]
[testAssumptionFailure]
[testIgnored]
testEnded
....
[testRunFailed]
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 cas de test individuel.
`default void`	`testFailed(TestDescription test, FailureDescription failure)` Signale l'échec 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)` 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 a été arrêtée avant la fin 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 à testStarted(com.android.tradefed.result.TestDescription, long) pour obtenir une mesure précise.

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

testFailed

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

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.

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)

L'exécution du test des rapports a échoué 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 a échoué 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 du test
`attemptNumber`	`int`: numéro de commande, identifiant les différentes tentatives du même runName exécutées plusieurs fois. Le nombre d'essais est indexé à 0 et doit augmenter à chaque exécution. Par exemple, si un test est réessayé trois fois, il doit comporter quatre exécutions au total sous le même nom d'exécution, et le nombre d'essais doit être 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 du test

testRunStarted

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 du test
`attemptNumber`	`int`: numéro de commande, identifiant les différentes tentatives du même runName exécutées plusieurs fois. Le nombre d'essais est indexé à 0 et doit augmenter à chaque nouvelle exécution. Par exemple, si un test est réessayé trois fois, il doit comporter quatre exécutions au total sous le même nom d'exécution, et le nombre d'essais doit être compris 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 la fin 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 n'a pas été exécuté pour une raison inhabituelle. 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 à laquelle le test a commencé, 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