ITestInvocationListener

public interface ITestInvocationListener
implements ITestLogger , ITestLifeCycleReceiver

com.android.tradefed.result.ITestInvocationListener

Sottoclassi indirette conosciute AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BluetoothHciSnoopLogCollector , BugreportCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CollectingTestListener , and 72 others. AggregatePostProcessor Un aggregatore di metriche che fornisce minimo, massimo, media, varianza, deviazione standard, totale, conteggio e, facoltativamente, percentili per le metriche numeriche raccolte durante le esecuzioni di test a più iterazioni, trattandole come doppie. Atrace Collector Oggetto IMetricCollector che esegue atrace durante un test, raccoglie i risultati e li registra nell'invocazione. AtraceRunMetric Collector Raccoglie le tracce da tutta la directory di test nella directory specificata dal dispositivo di test, registra la directory di test e post-elabora i file di traccia nella directory di test e aggrega le metriche. AveragePostProcessor Implementazione di post processor che calcolano la media dell'elenco di metriche. BaseDeviceMetric Collector 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 L' IPostProcessor di base che deve essere esteso da ogni implementazione. BluetoothConnectionLatencyCollector Il raccoglitore invierà una configurazione della metrica di durata statsd predefinita ai dispositivi e raccoglierà la durata della connessione Bluetooth per ciascun profilo. BluetoothConnectionState Collector Questo raccoglitore raccoglierà le metriche BluetoothConnectionStateChanged e registrerà il numero dello stato della connessione per ogni profilo. BluetoothConnectionSuccessRatePostProcessor Implementazione del postprocessore che calcola la percentuale di successo per un profilo bluetooth Utilizzare "metric-key-match" per specificare le metriche che contengono gli stati della connessione Bluetooth nell'array numerico Esempio [0, 1, 2, 3, 0, 1, 2, 3]. BluetoothHciSnoopLog Collector Collector per abilitare la registrazione snoop Bluetooth HCI sul DUT e per raccogliere il registro per ogni test. Bugreport Collector Un pass-through ITestInvocationListener che raccoglie le segnalazioni di bug quando si verificano eventi configurabili e quindi chiama ITestInvocationListener#testLog sui relativi figli dopo la raccolta di ogni segnalazione di bug. BugreportzOnFailureCollector Raccogli un bugreportz quando un test case fallisce. BugreportzOnTestCaseFailureCollector Raccogli un bugreportz quando un test case in un'esecuzione fallisce. ClangCodeCoverageCollector Un BaseDeviceMetricCollector che estrarrà le misurazioni della copertura Clang dal dispositivo e le registrerà come artefatti di test. RaccoltaTestListener Un ITestInvocationListener che raccoglierà tutti i risultati del test. CommandStatusHandler Gestore che aiuta a monitorare e aggiornare lo stato di una chiamata. ConditionFailureMonitor Monitorare eventuali errori dall'invocazione. ConsoleResultReporter Reporter dei risultati per stampare i risultati del test sulla console. CountTestCasesCollector Contare e segnalare il numero di casi di test per un dato IRemoteTest . DebugHostLogOnFailureCollector Collector che raccoglierà e registrerà i log lato host quando si verifica un errore del test case. DeviceReleaseReporter Reporter di rilascio del dispositivo che gestisce la comunicazione con il processo padre dei dispositivi da rilasciare. DeviceTrace Collector Collector che avvierà la perfetta traccia all'avvio di un'esecuzione di test e alla fine registrerà il file di traccia. Dispositivo non disponibile Monitor Questo listener tenta di acquisire solo un DNAE a livello di test case. EventsLoggerListener Listener che registra tutti gli eventi che riceve in un file FileProtoResultReporter Proto reporter che scarica il TestRecord in un file. FilePullerDeviceMetricCollector Un BaseDeviceMetricCollector che ascolta la chiave delle metriche proveniente dal dispositivo e le estrae come file dal dispositivo. FilePullerLog Collector Logger del file segnalato dal lato dispositivo. FilteredResultForwarder Variante di ResultForwarder che consente di segnalare solo una lista consentita di TestDescription . FormattedGeneratorReporter Reporter che permette di generare report in un formato particolare. GcovCodeCoverageCollector Un BaseDeviceMetricCollector che estrarrà le misurazioni della copertura gcov dal dispositivo e le registrerà come artefatti di test. GcovKernelCodeCoverageCollector Un BaseDeviceMetricCollector che estrarrà le misurazioni della copertura del kernel gcov dai debugf e dal dispositivo e infine le registrerà come artefatti di test. GranularRetriableTestWrapper.StartEndCollector Assistente di classe per rilevare l'inizio e la fine della corsa mancante. HostStatsdMetricCollector Oggetto IMetricCollector che raccoglie le metriche statsd dal lato host utilizzando i comandi dell'utilità statsd. ICommandScheduler.IScheduledInvocationListener Listener per gli eventi di chiamata al termine della chiamata. ILogSaverListener Consente a ITestInvocationListener di restare in ascolto quando i file di registro vengono salvati. IMetricCollector Questa interfaccia verrà aggiunta come decoratore durante la segnalazione dei risultati dei test al fine di raccogliere le metriche corrispondenti. IPostProcessor I post processori sono un oggetto della Federazione commerciale pensato per consentire l'elaborazione di metriche e registri DOPO i test e PRIMA della segnalazione dei risultati. IShardableListener Un ITestInvocationListener che può essere partizionato. ISupportGranularResults Interfaccia che specifica se un ITestInvocationListener supporta o meno la ricezione dei risultati granulari. ITestSummaryListener Interfaccia che consente ITestInvocationListener di scambiare alcune informazioni limitate tramite riepiloghi. InvocationToJUnitResultForwarder Una classe che ascolta gli eventi ITestInvocationListener e li inoltra a un TestListener . JarHostTest.HostTestListener Wrapper listener che inoltra tutti gli eventi tranne testRunStarted() e testRunEnded() al listener incorporato. JavaCodeCoverageCollector Un BaseDeviceMetricCollector che estrarrà le misurazioni della copertura Java dal dispositivo e le registrerà come artefatti di test. JsonHttpTestResultReporter Un report dei risultati che codifica i risultati delle metriche di test e dirama le informazioni sul dispositivo in JSON e POST in un endpoint del servizio HTTP LastShardDetector Quando si esegue lo sharding locale, a volte vogliamo solo eseguire alcune azioni quando l'ultimo shard raggiunge invocationEnded(long) . LegacySubprocessResultsReporter Un'implementazione congelata del reporter dei risultati del sottoprocesso che dovrebbe rimanere compatibile con le versioni precedenti di TF/CTS (ad esempio 8+), nonostante i cambiamenti nella sua superclasse. LogSaverResultForwarder Un ResultForwarder per il salvataggio dei registri con il file saver globale. LogcatCrashResultForwarder Listener speciale: in caso di guasti (crash del processo di strumentazione) tenterà di estrarre dal logcat il crash e lo aggiungerà al messaggio di errore associato al test. LogcatOnFailureCollector Collector che catturerà e registrerà un logcat quando un test case fallisce. LogcatTimingMetric Collector Un collettore di metriche che raccoglie informazioni temporali (ad es. tempo di cambio utente) da logcat durante uno o più test ripetuti utilizzando determinati pattern regex per analizzare i segnali di inizio e fine di un evento dalle linee logcat. MetricFilePostProcessor Utilizzato per caricare il file di registro delle metriche raccolto durante il test e il livello di esecuzione. MetricheXMLResultReporter MetricsXMLResultReporter scrive i parametri del test ed esegue i parametri in un file XML in una cartella specificata dal parametro metrics-folder nella fase invocationEnded del test. ModuleListener Listener collegato a ciascun IRemoteTest di ciascun modulo per raccogliere l'elenco dei risultati. ModuloLogcat Collector Versione del raccoglitore logcat ma per il modulo. NomeMangleListener Un listener proxy per tradurre i nomi dei metodi, delle classi e dei pacchetti di test man mano che vengono riportati i risultati. PassandoTestFileReporter Oggetto ITestInvocationListener che salva l'elenco dei casi di test superati in un file di test PerfettoGenericPostProcessor Un post processore che elabora il file proto metrico testo/binario in coppie chiave-valore espandendo in modo ricorsivo i messaggi proto e i campi con valori stringa finché non viene rilevato il campo con valore numerico. PerfettoPullerMetricCollector Implementazione di base di FilePullerDeviceMetricCollector che consente di estrarre i file perfetti dal dispositivo e raccogliere le metriche da esso. PrettyTestEventLogger Logger che abbina gli eventi e li registra per semplificare il debug. ProtoResultReporter Il giornalista dei risultati crea un protobuf TestRecord con tutti i risultati all'interno. PythonBinaryHostTest.PythonForwarder Inoltro dei risultati per sostituire il nome dell'esecuzione con il nome binario. RiavviaReasonCollector Collector che raccoglie il riavvio del dispositivo durante l'esecuzione del test e li segnala per motivo e conteggi. RemoteTestTimeOutEnforcer Listener che consentono di controllare il tempo di esecuzione di una determinata configurazione di test e fallire se supera un determinato timeout. ReportPassedTests Riporta in un file eventuali filtri per escludere test superati. Risultato Aggregatore Spedizioniere speciale che aggrega i risultati quando necessario, in base alla strategia di ripetizione adottata. ResultAndLogForwarder Inoltro per i risultati e gli eventi dei log. RisultatoForwarder Oggetto ITestInvocationListener che inoltra i risultati della chiamata a un elenco di altri listener. RiprovaLogSaverResultForwarder Spedizioniere che si occupa anche del superamento del tentativo in corso in cui ci troviamo. RetryResultForwarder Un'estensione di ResultForwarder che spinge sempre a un determinato numero di tentativi. RuntimeRestartCollector Collector che raccoglie i timestamp dei riavvii di runtime (arresto anomalo del server di sistema) durante l'esecuzione del test, se presente. ScreenshotOnFailureCollector Collector che catturerà e registrerà uno screenshot quando un test case fallisce. ShardListener Un ITestInvocationListener che raccoglie i risultati da un frammento di chiamata (ovvero una divisione di chiamata da eseguire su più risorse in parallelo) e li inoltra a un altro listener. ShardMainResultForwarder Un ResultForwarder che combina i risultati di chiamate di test sharded. Mostra mappaPullerMetricCollector Implementazione di base di FilePullerDeviceMetricCollector che consente di estrarre i file showmap dal dispositivo e raccogliere le metriche da esso. StatsdBeforeAfterGaugeMetricPostProcessor Un post processore che elabora le metriche di misurazione raccolte in un approccio "prima/dopo", ad es StatsdEventMetricPostProcessor Un post processore che elabora le metriche degli eventi nei report statsd in coppie chiave-valore, utilizzando i formattatori specificati nel processore. StatsdGenericPostProcessor Un post processore che elabora i report binari proto statsd in coppie chiave-valore espandendo il report come una struttura ad albero. StreamProtoResultReporter Un'implementazione di ProtoResultReporter SubprocessResultsReporter Implementa ITestInvocationListener da specificare come result_reporter e inoltra dal sottoprocesso i risultati di test, esecuzioni di test, chiamate di test. SuiteResultReporter Raccogliere i risultati dei test per un'intera chiamata di suite e produrre i risultati finali. TestFailureListener L'ascoltatore era solito eseguire azioni come screenshot, segnalazione di bug, raccolta di logcat in caso di errore del test quando richiesto. TestTimeoutEnforcer Listener che consentono di controllare il tempo di esecuzione di un determinato caso di test e fallirlo se supera un determinato timeout. TextResultReporter Un reporter dei risultati dei test che inoltra i risultati alla stampante dei risultati di testo JUnit. TraceCmdCollector Oggetto IMetricCollector che raccoglie le tracce durante il test usando trace-cmd e le registra nella chiamata. TradefedSandboxRunner.StubScheduledInvocationListener Uno stub IScheduledInvocationListener che non esegue alcuna operazione. XmlFormattedGeneratorReporter Implementazione del FormattedGeneratorReporter che formatta la suite risulta in un formato xml. XmlResultReporter Scrive i risultati JUnit in un file XML in un formato coerente con XMLJUnitResultFormatter di Ant.

---

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

Una chiamata di test può essa stessa includere più esecuzioni di test, quindi la sequenza delle chiamate sarà

• invocazioneStarted(BuildInfo)
• testRunStarted
• testAvviato
• [test non riuscito]
• testTerminato
• ...
• testRunEnded
• ...
• testRunStarted
• ...
• testRunEnded
• [invocazione non riuscita]
• [testLog+]
• invocazioneEnded
• getSummary

Riepilogo

Metodi pubblici
default TestSummary	getSummary () Consente a InvocationListener di restituire un riepilogo.
default void	invocationEnded (long elapsedTime) Segnala che la chiamata è stata terminata, con successo oa causa di qualche condizione di errore.
default void	invocationFailed ( FailureDescription failure) Segnala una chiamata incompleta a causa di una condizione di errore.
default void	invocationFailed (Throwable cause) Segnala una chiamata incompleta a causa di una condizione di errore.
default void	invocationInterrupted () Chiamato all'arresto dello scheduler, offre all'invocazione l'opportunità di fare qualcosa prima di terminare.
default void	invocationStarted ( IInvocationContext context) Segnala l'inizio della chiamata di test.
default void	testModuleEnded () Segnala la fine dell'esecuzione di un modulo.
default void	testModuleStarted ( IInvocationContext moduleContext) Segnala l'inizio di un modulo in esecuzione.

Metodi pubblici

getSummary

public TestSummary getSummary ()

Consente a InvocationListener di restituire un riepilogo.

ritorna
TestSummary	Un TestSummary che riepiloga l'esecuzione o null

invocazioneEnded

public void invocationEnded (long elapsedTime)

Segnala che la chiamata è stata terminata, con successo oa causa di qualche condizione di errore.

Verrà richiamato automaticamente dal framework TradeFederation.

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

invocazione non riuscita

public void invocationFailed (FailureDescription failure)

Segnala una chiamata incompleta a causa di una condizione di errore.

Verrà richiamato automaticamente dal framework TradeFederation.

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

invocazione non riuscita

public void invocationFailed (Throwable cause)

Segnala una chiamata incompleta a causa di una condizione di errore.

Verrà richiamato automaticamente dal framework TradeFederation.

Parametri
cause	Throwable : la causa ERROR(/Throwable) dell'errore

invocazioneInterrotto

public void invocationInterrupted ()

Chiamato all'arresto dello scheduler, offre all'invocazione l'opportunità di fare qualcosa prima di terminare.

invocazioneAvviato

public void invocationStarted (IInvocationContext context)

Segnala l'inizio della chiamata di test.

Verrà richiamato automaticamente dal framework TradeFederation. I reporter devono eseguire l'override di questo metodo per supportare la segnalazione di più dispositivi.

Parametri
context	IInvocationContext : informazioni sulla chiamata

testModuleEnded

public void testModuleEnded ()

Segnala la fine dell'esecuzione di un modulo.

testModuleAvviato

public void testModuleStarted (IInvocationContext moduleContext)

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

Parametri
moduleContext	IInvocationContext : IInvocationContext del modulo.