ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

Sottoclassi indirette note AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BluetoothHciSnoopLogCollector , BugreportCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CollectingTestListener , and 75 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 . CountingTestResultListener Un TestResultListener che tiene traccia del numero totale di test in base a TestStatus 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. ITestInvocationListener Listener per i risultati del test dall'invocazione del test. 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 sul 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. TestResultListener Una semplificazione di ITestLifecycleListener per gli implementatori che si preoccupano solo dei singoli risultati dei test. 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.

---

Riceve le notifiche degli eventi durante le esecuzioni dei test della strumentazione.

Modellato dopo org.junit.runner.notification.RunListener

La sequenza delle chiamate sarà:

• testRunStarted
• testAvviato
• [test non riuscito]
• [testAssumptionFailure]
• [testIgnorato]
• testTerminato
• ....
• [testRunFailed]
• testRunEnded

Riepilogo

Metodi pubblici
default void	testAssumptionFailure ( TestDescription test, String trace) Chiamato quando un test atomico segnala che presuppone una condizione falsa
default void	testAssumptionFailure ( TestDescription test, FailureDescription failure) Chiamato quando un test atomico segnala che presuppone una condizione falsa
default void	testEnded ( TestDescription test, long endTime, testMetrics) testEnded ( TestDescription test, long endTime, testMetrics) Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) dove possiamo specificare direttamente l'ora di fine.
default void	testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics) Riporta la fine dell'esecuzione di un singolo test case.
default void	testFailed ( TestDescription test, FailureDescription failure) Segnala il fallimento di un singolo test case.
default void	testFailed ( TestDescription test, String trace) Segnala il fallimento di un singolo test case.
default void	testIgnored ( TestDescription test) Chiamato quando un test non verrà eseguito, generalmente perché un metodo di test è annotato con org.junit.Ignore.
default void	testRunEnded (long elapsedTimeMillis, runMetrics) testRunEnded (long elapsedTimeMillis, runMetrics) Segnala la fine dell'esecuzione del test.
default void	testRunFailed ( FailureDescription failure) L'esecuzione del test dei report non è riuscita a essere completata a causa di un errore descritto da FailureDescription .
default void	testRunFailed (String errorMessage) L'esecuzione del test dei rapporti non è riuscita a essere completata a causa di un errore irreversibile.
default void	testRunStarted (String runName, int testCount, int attemptNumber) Segnala l'inizio di un'esecuzione di test.
default void	testRunStarted (String runName, int testCount) Segnala l'inizio di un'esecuzione di test.
default void	testRunStarted (String runName, int testCount, int attemptNumber, long startTime) Segnala l'inizio di un'esecuzione di test.
default void	testRunStopped (long elapsedTime) Segnala l'interruzione dell'esecuzione del test prima del completamento a causa di una richiesta dell'utente.
default void	testStarted ( TestDescription test, long startTime) Alternativa a testStarted(com.android.tradefed.result.TestDescription) dove specifichiamo anche quando il test è stato avviato, combinato con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) per una misura accurata .
default void	testStarted ( TestDescription test) Segnala l'inizio di un singolo test case.

Metodi pubblici

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Chiamato quando un test atomico segnala che presuppone una condizione falsa

Parametri
test	TestDescription : identifica il test
trace	String : traccia dello stack dell'errore

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Chiamato quando un test atomico segnala che presuppone una condizione falsa

Parametri
test	TestDescription : identifica il test
failure	FailureDescription : FailureDescription che descrive l'errore e il relativo contesto.

testTerminato

public void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) dove possiamo specificare direttamente l'ora di fine. Combina con testStarted(com.android.tradefed.result.TestDescription, long) per una misurazione accurata.

Parametri
test	TestDescription : identifica il test
endTime	long : l'ora in cui il test è terminato, misurato tramite ERROR(/System#currentTimeMillis())
testMetrics	: un ERROR(/Map) delle metriche emesse

testTerminato

public void testEnded (TestDescription test, 
                 testMetrics)

Riporta la fine dell'esecuzione di un singolo test case.

Se testFailed(TestDescription, FailureDescription) non è stato richiamato, questo test ha avuto esito positivo. Restituisce anche qualsiasi metrica chiave/valore che potrebbe essere stata emessa durante l'esecuzione del caso di test.

Parametri
test	TestDescription : identifica il test
testMetrics	: un ERROR(/Map) delle metriche emesse

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Segnala il fallimento di un singolo test case.

Verrà chiamato tra testStarted e testEnded.

Parametri
test	TestDescription : identifica il test
failure	FailureDescription : FailureDescription che descrive l'errore e il relativo contesto.

testFailed

public void testFailed (TestDescription test, 
                String trace)

Segnala il fallimento di un singolo test case.

Verrà chiamato tra testStarted e testEnded.

Parametri
test	TestDescription : identifica il test
trace	String : traccia dello stack dell'errore

testIgnorato

public void testIgnored (TestDescription test)

Chiamato quando un test non verrà eseguito, generalmente perché un metodo di test è annotato con org.junit.Ignore.

Parametri
test	TestDescription : identifica il test

testRunEnded

public void testRunEnded (long elapsedTimeMillis, 
                 runMetrics)

Segnala la fine dell'esecuzione del test. FIXME: non possiamo avere due interfacce Map<> con tipo diverso, quindi dobbiamo usare HashMap qui.

Parametri
elapsedTimeMillis	long : tempo trascorso segnalato dal dispositivo, in millisecondi
runMetrics	: coppie chiave-valore riportate al termine di un'esecuzione di test con Metric .

testRunFailed

public void testRunFailed (FailureDescription failure)

L'esecuzione del test dei report non è riuscita a essere completata a causa di un errore descritto da FailureDescription .

Parametri
failure	FailureDescription : FailureDescription che descrive l'errore e il relativo contesto.

testRunFailed

public void testRunFailed (String errorMessage)

L'esecuzione del test dei report non è riuscita a essere completata a causa di un errore irreversibile.

Parametri
errorMessage	String : ERROR(/String) che descrive il motivo dell'errore di esecuzione.

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Segnala l'inizio di un'esecuzione di test.

Parametri
runName	String : il nome dell'esecuzione del test
testCount	int : numero totale di test nell'esecuzione del test
attemptNumber	int : numero d'ordine, che identifica i diversi tentativi dello stesso runName che vengono eseguiti più volte. Il tryNumber è indicizzato a 0 e dovrebbe incrementare ogni volta che si verifica una nuova esecuzione. ad esempio, un test viene ritentato in modo granulare 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il numero di tentativi è compreso tra 0 e 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Segnala l'inizio di un'esecuzione di test.

Parametri
runName	String : il nome dell'esecuzione del test
testCount	int : numero totale di test nell'esecuzione del test

testRunStarted

public void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Segnala l'inizio di un'esecuzione di test.

Parametri
runName	String : il nome dell'esecuzione del test
testCount	int : numero totale di test nell'esecuzione del test
attemptNumber	int : numero d'ordine, che identifica i diversi tentativi dello stesso runName che vengono eseguiti più volte. Il tryNumber è indicizzato a 0 e dovrebbe incrementare ogni volta che si verifica una nuova esecuzione. ad esempio, un test viene ritentato in modo granulare 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il numero di tentativi è compreso tra 0 e 3.
startTime	long : l'ora in cui è iniziata la corsa, misurata tramite ERROR(/System#currentTimeMillis())

testRunStopped

public void testRunStopped (long elapsedTime)

Segnala l'interruzione dell'esecuzione del test prima del completamento a causa di una richiesta dell'utente.

TODO: attualmente inutilizzato, prendere in considerazione la rimozione

Parametri
elapsedTime	long : tempo trascorso segnalato dal dispositivo, in millisecondi

testAvviato

public void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) dove specifichiamo anche quando il test è stato avviato, combinato con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) per una misura accurata .

Parametri
test	TestDescription : identifica il test
startTime	long : l'ora di inizio del test, misurata tramite ERROR(/System#currentTimeMillis())

testAvviato

public void testStarted (TestDescription test)

Segnala l'inizio di un singolo test case. Interfaccia precedente, dovrebbe usare testStarted(com.android.tradefed.result.TestDescription) quando possibile.

Parametri
test	TestDescription : identifica il test