ITestInvocationListener

public interface ITestInvocationListener
implements ITestLifeCycleReceiver, ITestLogger

com.android.tradefed.result.ITestInvocationListener
AggregatePostProcessor Un aggregatore di metriche che fornisce i valori minimo, massimo, medio, varianza, deviazione standard, totale, conteggio e, facoltativamente, percentile per le metriche numeriche raccolte durante le esecuzioni di test con più iterazioni, trattandole come doppi. 
AtraceCollector Un IMetricCollector che esegue atrace durante un test e raccoglie il risultato e lo registra nell'invocazione. 
AtraceRunMetricCollector Raccoglie le tracce da tutte le directory di test nella directory specificata dal dispositivo di test, registra la directory di test e esegue il post-trattamento dei file di traccia nella directory di test e aggrega le metriche. 
AveragePostProcessor Implementazione del post-processore che calcola la media dell'elenco delle metriche. 
BaseDeviceMetricCollector Implementazione di base di IMetricCollector che consente di avviare e interrompere la raccolta su onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) e ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map))
BasePostProcessor La classe IPostProcessor di base che ogni implementazione deve estendere. 
BluetoothConnectionLatencyCollector Il collector invierà ai dispositivi una configurazione della metrica della durata di statsd predefinita e raccoglierà la durata della connessione Bluetooth per ogni profilo. 
BluetoothConnectionStateCollector Questo raccoglitore raccoglierà le metriche BluetoothConnectionStateChanged e registrerà il numero dello stato della connessione per ogni profilo. 
BluetoothConnectionSuccessRatePostProcessor Implementazione del postprocessore che calcola il tasso di successo per un profilo Bluetooth

Utilizza "metric-key-match" per specificare le metriche che contengono gli stati di connessione Bluetooth nell'array numerico Esempio [0, 1, 2, 3, 0, 1, 2, 3]. 

BluetoothHciSnoopLogCollector Raccogliere per attivare la registrazione di analisi HCI Bluetooth sul DUT e raccogliere il log per ogni test. 
BugreportCollector Un ITestInvocationListener pass-through che raccoglie i report di bug quando si verificano eventi configurabili e poi chiama ITestInvocationListener.testLog sui suoi elementi secondari dopo la raccolta di ogni report di bug. 
BugreportzOnFailureCollector Raccogliere una segnalazione di bug quando uno scenario di test non va a buon fine. 
BugreportzOnTestCaseFailureCollector Raccogliere una segnalazione di bug quando un caso di test in un'esecuzione non va a buon fine. 
ClangCodeCoverageCollector Un BaseDeviceMetricCollector che estrae le misurazioni della copertura di Clang dal dispositivo e le registra come elementi di test. 
CodeCoverageCollector Un BaseDeviceMetricCollector che estrae le misurazioni della copertura Java e nativa dal dispositivo e le registra come elementi di test. 
CollectingTestListener Un ITestInvocationListener che raccoglierà tutti i risultati del test. 
CommandStatusHandler Handler che consente di monitorare e aggiornare lo stato di un'invocazione. 
ConditionFailureMonitor Monitora eventuali errori dell'invocazione. 
ConsoleResultReporter Report sui risultati per stampare i risultati del test nella console. 
CountTestCasesCollector Conta e genera un report sul numero di casi di test per un determinato IRemoteTest
DebugHostLogOnFailureCollector Raccogli i log lato host e registrali quando si verifica un errore dello scenario di test. 
DeviceReleaseReporter Report sulle release del dispositivo che gestisce la comunicazione con il processo principale dei dispositivi da rilasciare. 
DeviceTraceCollector Raccogli dati che avvia la traccia di Perfetto all'avvio di un test e registra il file di traccia alla fine. 
DeviceUnavailableMonitor Questo ascoltatore tenta di acquisire solo un DNAE a livello di test case. 
EventsLoggerListener Ascoltatore che registra tutti gli eventi ricevuti in un file 
FileProtoResultReporter Proto reporter che scarica TestRecord in un file. 
FilePullerDeviceMetricCollector Un BaseDeviceMetricCollector che ascolta la chiave delle metriche proveniente dal dispositivo e le estrae come file dal dispositivo. 
FilePullerLogCollector Logger del file segnalato dal lato del dispositivo. 
FilteredResultForwarder Variante di ResultForwarder che consente di segnalare solo una lista consentita di TestDescription
FormattedGeneratorReporter Report che consente di generare report in un determinato formato. 
GcovCodeCoverageCollector Un BaseDeviceMetricCollector che estrae le misurazioni della copertura di gcov dal dispositivo e le registra come elementi di test. 
GcovKernelCodeCoverageCollector Un BaseDeviceMetricCollector che estrae le misurazioni della copertura del kernel gcov da debugfs e dal dispositivo e poi le registra come elementi di test. 
GranularRetriableTestWrapper.StartEndCollector Helper di classe per rilevare l'inizio e la fine mancanti della corsa. 
HostStatsdMetricCollector Un IMetricCollector che raccoglie le metriche StatsD lato host utilizzando i comandi dell'utilità StatsD. 
ICommandScheduler.IScheduledInvocationListener Listener per gli eventi di chiamata al termine dell'invocazione. 
ILogSaverListener Consente ai ITestInvocationListener di rilevare quando vengono salvati i file di log. 
IMetricCollector Questa interfaccia verrà aggiunta come decorazione quando vengono generati i report sui risultati dei test per raccogliere le metriche corrispondenti. 
IPostProcessor I post-processor sono oggetti Trade Federation pensati per consentire l'elaborazione di metriche e log DOPO i test e PRIMA della generazione di report sui risultati. 
IShardableListener Un ITestInvocationListener che può essere suddiviso in parti. 
ISupportGranularResults Interfaccia che specifica se un ITestInvocationListener supporta o meno la ricezione dei risultati granulari. 
ITestSummaryListener Interfaccia che consente a ITestInvocationListener di scambiare alcune informazioni limitate tramite riepiloghi. 
InvocationProtoResultReporter Report per memorizzare le informazioni sulla memorizzazione nella cache a livello di chiamata e l'elenco dei moduli 
InvocationToJUnitResultForwarder Una classe che ascolta gli eventi ITestInvocationListener e li inoltra a un TestListener
JarHostTest.HostTestListener Listener wrapper che inoltra tutti gli eventi, ad eccezione di testRunStarted() e testRunEnded(), al listener incorporato. 
JavaCodeCoverageCollector Un BaseDeviceMetricCollector che estrae le misurazioni della copertura Java dal dispositivo e le registra come elementi di test. 
JsonHttpTestResultReporter Un report sui risultati che codifica i risultati delle metriche di test e le informazioni su branch e dispositivo in JSON e le invia tramite POST a un endpoint di servizio HTTP 
LUCIResultReporter Un report sui risultati che salva i risultati dei test necessari per ResultDB e LUCI in formato JSON (go/result-sink) e registra la posizione del file nella console. 
LastShardDetector Quando eseguiamo lo sharding locale, a volte vogliamo eseguire alcune azioni solo quando l'ultimo frammento raggiunge invocationEnded(long)
LegacySubprocessResultsReporter Un'implementazione bloccata del report sui risultati del sottoprocesso che dovrebbe rimanere compatibile con le versioni precedenti di TF/CTS (ad es. 8 e versioni successive), nonostante le modifiche al superclasse. 
LogSaverResultForwarder Un ResultForwarder per salvare i log con il salvataggio file globale. 
LogcatCrashResultForwarder Ascoltatore speciale: in caso di errori (arresto anomalo del processo di ispezione) tenterà di estrarre dall'logcat l'arresto anomalo e lo aggiungerà al messaggio di errore associato al test. 
LogcatOnFailureCollector Raccogli dati che acquisisce e registra un logcat quando uno scenario di test non va a buon fine. 
LogcatTimingMetricCollector Un raccoglitore di metriche che raccoglie informazioni sui tempi (ad es. ora di passaggio dell'utente) da logcat durante uno o più test ripetuti utilizzando determinati pattern regex per analizzare gli indicatori di inizio e fine di un evento dalle righe di logcat. 
MetricFilePostProcessor Utilizzato per il caricamento del file di log delle metriche raccolto durante il livello di test ed esecuzione. 
MetricsXMLResultReporter MetricsXMLResultReporter scrive le metriche di test e di esecuzione in un file XML in una cartella specificata dal parametro metrics-folder nella fase invocationEnded del test. 
ModuleListener Listener collegato a ogni IRemoteTest di ogni modulo per raccogliere l'elenco dei risultati. 
ModuleLogcatCollector Versione del raccoglitore logcat, ma per il modulo. 
ModuleProtoResultReporter Un report sui risultati destinato a registrare solo i risultati a livello di modulo. 
NameMangleListener Un ascoltatore proxy per tradurre i nomi del metodo di test, della classe e del pacchetto quando vengono generati i risultati. 
PassingTestFileReporter Un ITestInvocationListener che salva l'elenco degli scenari di test superati in un file di test 
PerfettoGenericPostProcessor Un post-processore che elabora il file proto metrico perfetto di testo/binario in coppie chiave-valore espandendo in modo ricorsivo i messaggi e i campi proto con valori di stringa fino a quando non viene rilevato il campo con valore numerico. 
PerfettoPullerMetricCollector Implementazione di base di FilePullerDeviceMetricCollector che consente di recuperare i file di perfetto dal dispositivo e di raccogliere le metriche. 
PrettyTestEventLogger Il logger abbina gli eventi e li registra per semplificare il debug. 
ProtoResultReporter Il Report sui risultati genera un TestRecord protobuf con tutti i risultati al suo interno. 
PythonBinaryHostTest.PythonForwarder Inoltro dei risultati per sostituire il nome dell'esecuzione con il nome binario. 
RebootReasonCollector Raccogli i riavvii del dispositivo durante l'esecuzione del test e genera un report in base al motivo e al conteggio. 
RemoteTestTimeOutEnforcer Listener che consentono di controllare il tempo di esecuzione di una determinata configurazione di test e di segnalare un errore se supera un determinato timeout. 
ReportPassedTests Segnala in un file i possibili filtri per escludere il test superato. 
ResultAggregator Inoltra i risultati in modo aggregato, se necessario, in base alla strategia di ripetizione adottata. 
ResultAndLogForwarder Inoltra i risultati e registra gli eventi. 
ResultDBReporter Report sui risultati che carica i risultati dei test in ResultDB. 
ResultForwarder Un ITestInvocationListener che inoltra i risultati dell'invocazione a un elenco di altri ascoltatori. 
RetryLogSaverResultForwarder Inoltra che gestisce anche il passaggio al tentativo corrente. 
RetryResultForwarder Un'estensione di ResultForwarder che esegue sempre push su un determinato numero di tentativi. 
RuntimeRestartCollector Raccoglitore che raccoglie i timestamp dei riavvii di runtime (arresti anomali del server di sistema) durante l'esecuzione del test, se presenti. 
ScreenshotOnFailureCollector Raccoglitore che acquisisce e registra uno screenshot quando uno scenario di test non va a buon fine. 
ShardListener Un ITestInvocationListener che raccoglie i risultati da uno shard di chiamata (ovvero una suddivisione di chiamata da eseguire su più risorse in parallelo) e li inoltra a un altro ascoltatore. 
ShardMainResultForwarder Un ResultForwarder che combina i risultati delle invocazioni di test suddivise in parti. 
ShowmapPullerMetricCollector Implementazione di base di FilePullerDeviceMetricCollector che consente di estrarre i file della mappa del programma dal dispositivo e di raccogliere le metriche. 
StatsdBeforeAfterGaugeMetricPostProcessor Un post-processore che elabora le metriche degli indicatori raccolte con un approccio "prima/dopo", ovvero 
StatsdEventMetricPostProcessor Un post-processore che elabora le metriche relative agli eventi nei report di statsd in coppie chiave-valore utilizzando i formattatori specificati nel processore. 
StatsdGenericPostProcessor Un post-processore che elabora i report di statsd proto binari in coppie chiave-valore espandendo il report come struttura ad albero. 
StreamProtoResultReporter Un'implementazione di ProtoResultReporter 
SubprocessResultsReporter Implementa ITestInvocationListener da specificare come result_reporter e inoltra dal subprocesso i risultati di test, esecuzioni di test e invocazioni di test. 
SuiteResultReporter Raccogliere i risultati dei test per un'intera chiamata della suite e generare i risultati finali. 
TestRunResultListener Listener che consente di leggere lo stato finale dell'esecuzione del test. 
TestTimeoutEnforcer Listener che consentono di controllare il tempo di esecuzione di un determinato test case e di non superarlo se supera un determinato timeout. 
TextResultReporter Un reporter dei risultati del test che inoltra i risultati alla stampante di risultati di testo JUnit. 
TraceCmdCollector Un IMetricCollector che raccoglie le tracce durante il test utilizzando trace-cmd e le registra nell'invocazione. 
TradefedSandboxRunner.StubScheduledInvocationListener Uno stub IScheduledInvocationListener che non fa nulla. 
XmlFormattedGeneratorReporter Implementazione del FormattedGeneratorReporter che formatta la suite in un formato XML. 
XmlResultReporter Scrive i risultati di JUnit in file XML in un formato coerente con XMLJUnitResultFormatter di Ant. 


Ascoltatore per i risultati del test dall'invocazione del test.

Un'invocazione di test può includere più esecuzioni di test, quindi la sequenza di chiamate sarà

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

Riepilogo

Metodi pubblici

default TestSummary getSummary()

Consente a InvocationListener di restituire un riepilogo.

default void invocationEnded(long elapsedTime)

Segnala che l'invocazione è terminata, con esito positivo o a causa di una condizione di errore.

default void invocationFailed(FailureDescription failure)

Segnala un'invocazione incompleta a causa di una condizione di errore.

default void invocationFailed(Throwable cause)

Segnala un'invocazione incompleta a causa di una condizione di errore.

default void invocationInterrupted()

Chiamato al momento dell'arresto del programma di pianificazione, offre all'invocazione l'opportunità di fare qualcosa prima di terminare.

default void invocationSkipped(SkipReason reason)

Segnala un'invocazione come ignorata

default void invocationStarted(IInvocationContext context)

Segnala l'inizio dell'invocazione del test.

default void testModuleEnded()

Segnala la fine dell'esecuzione di un modulo.

default void testModuleStarted(IInvocationContext moduleContext)

Segnala l'inizio dell'esecuzione di un modulo.

Metodi pubblici

getSummary

public TestSummary getSummary ()

Consente a InvocationListener di restituire un riepilogo.

Ritorni
TestSummary Un TestSummary che riassume l'esecuzione o null

invocationEnded

public void invocationEnded (long elapsedTime)

Segnala che l'invocazione è terminata, con esito positivo o a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
elapsedTime long: il tempo trascorso dall'invocazione in ms

invocationFailed

public void invocationFailed (FailureDescription failure)

Segnala un'invocazione incompleta a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
failure FailureDescription: il FailureDescription che descrive la causa dell'errore

invocationFailed

public void invocationFailed (Throwable cause)

Segnala un'invocazione incompleta a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
cause Throwable: la causa Throwable dell'errore

invocationInterrupted

public void invocationInterrupted ()

Chiamato al momento dell'arresto del programma pianificatore, offre all'invocazione l'opportunità di fare qualcosa prima di terminare.

invocationSkipped

public void invocationSkipped (SkipReason reason)

Segnala un'invocazione come ignorata

Parametri
reason SkipReason

invocationStarted

public void invocationStarted (IInvocationContext context)

Segnala l'inizio dell'invocazione del test.

Verrà chiamato automaticamente dal framework TradeFederation. I reporter devono eseguire l'override di questo metodo per supportare i report su più dispositivi.

Parametri
context IInvocationContext: informazioni sull'invocazione

testModuleEnded

public void testModuleEnded ()

Segnala la fine dell'esecuzione di un modulo.

testModuleStarted

public void testModuleStarted (IInvocationContext moduleContext)

Segnala l'inizio dell'esecuzione di un modulo. Questo callback è associato a testModuleEnded() ed è facoltativo nella sequenza. Viene utilizzato solo durante un'esecuzione che utilizza i moduli: runner basati su suite.

Parametri
moduleContext IInvocationContext: il IInvocationContext del modulo.