ITestInvocationListener

public interface ITestInvocationListener
implements ITestLogger , ITestLifeCycleReceiver

com.android.tradefed.result.ITestInvocationListener

Sottoclassi indirette conosciute AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BugreportCollector , BugreportzOnFailureCollector , BugreportzOn TestCaseFailureCollector , ClangCodeCoverage altri . AggregatePostProcessor Un aggregatore di metriche che fornisce il minimo, il massimo, la media, la varianza, la deviazione standard, il totale, il conteggio e, facoltativamente, i percentili per le metriche numeriche raccolte durante esecuzioni di test con più iterazioni, trattandole come doppi. AtraceCollector Un IMetricCollector che esegue atrace durante un test, raccoglie il risultato e lo registra nella chiamata. AtraceRunMetricCollector Raccoglie le tracce da tutte le directory di test nella directory specificata dal dispositivo di test, registra la directory di test ed elabora i file di traccia nella directory di test e aggrega le metriche. AveragePostProcessor Implementazione di post processor che calcolano la media della lista 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 L' IPostProcessor di base che ogni implementazione dovrebbe estendere. BluetoothConnectionLatencyCollector Il raccoglitore invierà una configurazione metrica di durata statistica predefinita ai dispositivi e raccoglierà la durata della connessione Bluetooth per ciascun 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 la percentuale di successo per un profilo bluetooth Utilizzare "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]. BugreportCollector Un ITestInvocationListener pass-through che raccoglie segnalazioni di bug quando si verificano eventi configurabili e quindi chiama ITestInvocationListener#testLog sui relativi elementi figlio 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 una corsa non riesce. ClangCodeCoverageCollector Un BaseDeviceMetricCollector che estrarrà le misurazioni della copertura Clang dal dispositivo e le registrerà come artefatti di test. CollectingTest Listener Un ITestInvocationListener che raccoglierà tutti i risultati del test. CommandStatusHandler Gestore che aiuta a monitorare e aggiornare lo stato di una chiamata. ConsoleResultReporter Reporter dei risultati per stampare i risultati del test sulla console. CountTestCasesCollector Contare e segnalare il numero di casi di test per un determinato 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 genitore elabora i dispositivi da rilasciare. Dispositivo non disponibile Monitor Questo listener tenta di acquisire solo un DNAE a livello di test case. EventsLoggerListener Listener che registra tutti gli eventi ricevuti in un file FileProtoResultReporter Reporter proto 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. FilePullerLogCollector Logger del file segnalato dal lato dispositivo. FiltratoResultForwarder Variante di ResultForwarder che consente solo di segnalare 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. HostStatsdMetricCollector Un IMetricCollector che raccoglie le metriche statsd dal lato host utilizzando i comandi di utilità statsd. ICommandScheduler.IScheduledInvocationListener Listener per 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 quando si riportano i risultati dei test al fine di raccogliere le metriche corrispondenti. IPost Processor Post processor è un oggetto della Trade Federation inteso a consentire l'elaborazione di metriche e registri DOPO i test e PRIMA di riportare i risultati. IShardableListener Un ITestInvocationListener che può essere partizionato. ISupportGranularResults Interfaccia che specifica se un ITestInvocationListener supporta la ricezione dei risultati granulari o meno. ITestSummary Listener Interfaccia che consente a ITestInvocationListener di scambiare alcune informazioni limitate tramite riepiloghi. InvocationToJUnitResultForwarder Una classe che ascolta gli eventi ITestInvocationListener e li inoltra a un TestListener . JarHostTest.HostTestListener Listener wrapper 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 reporter dei risultati che codifica i risultati delle metriche di test e dirama, informazioni sul dispositivo in JSON e POST in un endpoint del servizio HTTP LastShardDetector Quando si esegue il partizionamento orizzontale locale, a volte si vogliono eseguire alcune azioni solo quando l'ultimo shard raggiunge invocationEnded(long) . LegacySubprocessResultsReporter Un'implementazione bloccata 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 salva file 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 acquisirà e registrerà un logcat quando un test case ha esito negativo. LogcatTimingMetricCollector Un raccoglitore di metriche che raccoglie informazioni sui tempi (ad es. tempo di commutazione dell'utente) da logcat durante uno o più test ripetuti utilizzando determinati modelli regex per analizzare i segnali di inizio e fine di un evento dalle righe logcat. MetricFilePostProcessor Utilizzato per caricare il file di registro delle metriche raccolto durante il test e il livello di esecuzione. MetricsXMLResultReporter MetricsXMLResultReporter scrive le metriche del test ed esegue le metriche in un file XML in una cartella specificata dal parametro metrics-folder nella fase invocationEnded del test. Ascoltatore di moduli Listener allegato ad ogni IRemoteTest di ogni modulo per raccogliere l'elenco dei risultati. ModuleLogcatCollector Versione del collettore logcat ma per modulo. NomeMangleListener Un listener proxy per tradurre i nomi di metodi, classi e pacchetti di test come risultati vengono riportati. PassingTestFileReporter ITestInvocationListener che salva l'elenco dei casi di test passati in un file di test PerfettoGenericPostProcessor Un post processor che elabora il file proto testo/metrica binaria perfetto in coppie chiave-valore espandendo ricorsivamente i messaggi proto e i campi con valori stringa fino a quando non si incontra il campo con valore numerico. PerfettoPullerMetricCollector Implementazione di base di FilePullerDeviceMetricCollector che permette di estrarre i file perfetto dal dispositivo e raccogliere le metriche da esso. PrettyTestEventLogger Logger abbinando gli eventi e registrandoli per semplificare il debug. ProtoResultReporter Il reporter dei risultati crea un TestRecord TestRecord con tutti i risultati all'interno. PythonBinaryHostTest.PythonForwarder Inoltro dei risultati per sostituire il nome dell'esecuzione con il nome binario. RebootReasonCollector 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. Segnala test superati Riporta in un file i possibili filtri per escludere la prova superata. ResultAggregator Spedizioniere speciale che aggrega i risultati quando necessario, in base alla strategia di tentativi adottata. Risultato e LogForwarder Forwarder per i risultati e registra gli eventi. Risultato Spedizioniere ITestInvocationListener che inoltra i risultati della chiamata a un elenco di altri listener. RetryLogSaverResultForwarder Spedizioniere che gestisce anche il passaggio del tentativo in corso a cui siamo. RiprovaResultForwarder Un'estensione di ResultForwarder che spinge sempre a un determinato numero di tentativi. RuntimeRestartCollector Collector che raccoglie timestamp dei riavvii del runtime (arresto anomalo del server di sistema) durante l'esecuzione del test, se presente. ScreenshotsuFailureCollector Collector che acquisirà e registrerà uno screenshot quando un test case ha esito negativo. Shard Listener ITestInvocationListener che raccoglie i risultati da uno shard di chiamata (ovvero una divisione di chiamata per l'esecuzione su più risorse in parallelo) e li inoltra a un altro listener. ShardMainResultForwarder Un ResultForwarder che combina i risultati di chiamate di test partizionate. ShowmapPullerMetricCollector Implementazione di base di FilePullerDeviceMetricCollector che consente di estrarre i file showmap dal dispositivo e raccogliere le metriche da esso. StatsdBeforeAfterGaugeMetricPostProcessor Un post processor che elabora le metriche di misurazione raccolte in un approccio "prima/dopo", ad es StatsdEventMetricPostProcessor Un post processor che elabora le metriche degli eventi nei report statsd in coppie chiave-valore, utilizzando i formattatori specificati nel processore. StatsdGenericPostProcessor Un post processor che elabora i report binari di 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 Raccogli i risultati dei test per un'intera suite di chiamate e genera i risultati finali. TestFailureListener Listener utilizzato per eseguire azioni come screenshot, bugreport, raccolta logcat in caso di errore del test quando richiesto. TestTimeoutEnforcer Listener che consentono di controllare il tempo di esecuzione di un determinato test case e fallire se supera un determinato timeout. TextResultReporter Un reporter dei risultati dei test che inoltra i risultati alla stampante dei risultati di testo JUnit. TraceCmdCollector IMetricCollector che raccoglie le tracce durante il test usando trace-cmd e le registra nella chiamata. TradefedSandboxRunner.StubScheduledInvocationListener Uno stub IScheduledInvocationListener che non fa nulla. XmlFormattedGeneratorReporter L'implementazione di FormattedGeneratorReporter che formatta la suite risulta in un formato xml. XmlResultReporter Scrive i risultati di JUnit in un file XML in un formato coerente con XMLJUnitResultFormatter di Ant.

---

Listener per i risultati del test dalla chiamata al test.

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

• invocationStarted(BuildInfo)
• testRunStarted
• testIniziato
• [test fallito]
• testTerminato
• ...
• testRunEnded
• ...
• testRunStarted
• ...
• testRunEnded
• [invocazione fallita]
• [testLog+]
• invocazioneFine
• getSommario

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 oa causa di una 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 allo spegnimento dello scheduler, dà all'invocazione l'opportunità di fare qualcosa prima di terminare.
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 di un modulo in esecuzione.

Metodi pubblici

getSommario

public TestSummary getSummary ()

Consente a InvocationListener di restituire un riepilogo.

ritorna
TestSummary	Un TestSummary riepiloga l'esecuzione o null

invocazioneFine

public void invocationEnded (long elapsedTime)

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

Verrà automaticamente chiamato dal framework TradeFederation.

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

invocazione non riuscita

public void invocationFailed (FailureDescription failure)

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

Verrà automaticamente chiamato 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à automaticamente chiamato dal framework TradeFederation.

Parametri
cause	Throwable : la causa Throwable del fallimento

invocazione Interrotto

public void invocationInterrupted ()

Chiamato allo spegnimento dello scheduler, dà all'invocazione l'opportunità di fare qualcosa prima di terminare.

invocationStarted

public void invocationStarted (IInvocationContext context)

Segnala l'inizio dell'invocazione del test.

Verrà automaticamente chiamato dal framework TradeFederation. I reporter devono sovrascrivere questo metodo per supportare più dispositivi di reporting.

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 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 : l' IInvocationContext del modulo.