ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener
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é. 
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. 
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. 
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. 

Écouteur des résultats des tests à partir de l'appel de test.

Une invocation de test peut elle-même inclure plusieurs exécutions de test. La séquence d'appels sera donc

  • invocationStarted(BuildInfo)
  • testRunStarted
  • testStarted
  • [testFailed]
  • testEnded
  • ...
  • testRunEnded
  • ...
  • testRunStarted
  • ...
  • testRunEnded
  • [invocationFailed]
  • [testLog+]
  • invocationEnded
  • getSummary

Résumé

Méthodes publiques

default TestSummary getSummary()

Permet à InvocationListener de renvoyer un récapitulatif.

default void invocationEnded(long elapsedTime)

Indique que l'appel a pris fin, que ce soit avec succès ou en raison d'une condition d'erreur.

default void invocationFailed(FailureDescription failure)

Signale une invocation incomplète en raison d'une condition d'erreur.

default void invocationFailed(Throwable cause)

Signale une invocation incomplète en raison d'une condition d'erreur.

default void invocationInterrupted()

Appelé lors de l'arrêt du planificateur, permet à l'appel d'effectuer une action avant de s'arrêter.

default void invocationSkipped(SkipReason reason)

Signale une invocation comme ignorée

default void invocationStarted(IInvocationContext context)

Indique le début de l'appel du test.

default void testModuleEnded()

Signale la fin de l'exécution d'un module.

default void testModuleStarted(IInvocationContext moduleContext)

Indique le début de l'exécution d'un module.

Méthodes publiques

getSummary

public TestSummary getSummary ()

Permet à InvocationListener de renvoyer un récapitulatif.

Renvoie
TestSummary TestSummary résumant l'exécution ou valeur nulle

invocationEnded

public void invocationEnded (long elapsedTime)

Indique que l'appel a pris fin, que ce soit avec succès ou en raison d'une condition d'erreur.

Appelé automatiquement par le framework TradeFederation.

Paramètres
elapsedTime long: temps écoulé de l'appel en ms

invocationFailed

public void invocationFailed (FailureDescription failure)

Signale une invocation incomplète en raison d'une condition d'erreur.

Appelé automatiquement par le framework TradeFederation.

Paramètres
failure FailureDescription: FailureDescription décrivant la cause de l'échec

invocationFailed

public void invocationFailed (Throwable cause)

Signale une invocation incomplète en raison d'une condition d'erreur.

Appelé automatiquement par le framework TradeFederation.

Paramètres
cause Throwable: cause Throwable de l'échec

invocationInterrupted

public void invocationInterrupted ()

Appelé lors de l'arrêt du planificateur, permet à l'appel d'effectuer une action avant de s'arrêter.

invocationSkipped

public void invocationSkipped (SkipReason reason)

Signale une invocation comme ignorée

Paramètres
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Indique le début de l'appel du test.

Appelé automatiquement par le framework TradeFederation. Les rapporteurs doivent remplacer cette méthode pour prendre en charge les rapports sur plusieurs appareils.

Paramètres
context IInvocationContext: informations sur l'appel

testModuleEnded

public void testModuleEnded ()

Signale la fin de l'exécution d'un module.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Indique le début de l'exécution d'un module. Ce rappel est associé à testModuleEnded() et est facultatif dans la séquence. Il n'est utilisé que lors d'une exécution qui utilise des modules: les exécuteurs basés sur une suite.

Paramètres
moduleContext IInvocationContext: IInvocationContext du module.