ITestLifeCycleReceiver

public interface ITestLifeCycleReceiver

com.android.tradefed.result.ITestLifeCycleReceiver

Classi di sottoclasse indirette note AggregatePostProcessor, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector e altri 80. 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.  CountingTestResultListener Un TestResultListener che monitora il numero totale di test per TestStatus  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.  ITestInvocationListener Ascoltatore per i risultati del test dall'invocazione del test.  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.  TestResultListener Una semplificazione di ITestLifecycleListener per gli implementatori che si preoccupano solo dei risultati dei singoli test.  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.

---

Riceve notifiche di eventi durante le esecuzioni dei test di misurazione.

Modellato su org.junit.runner.notification.RunListener

La sequenza di chiamate sarà:

• testRunStarted
• testStarted
• [testFailed]
• [testAssumptionFailure]
• [testIgnored]
• testEnded
• ....
• [testRunFailed]
• testRunEnded

Riepilogo

Metodi pubblici
default void	testAssumptionFailure(TestDescription test, String trace) Viene chiamato quando un test atomico segnala che presuppone una condizione falsa
default void	testAssumptionFailure(TestDescription test, FailureDescription failure) Viene chiamato quando un test atomico segnala che presuppone una condizione falsa
default void	testEnded(TestDescription test, long endTime, testMetrics) Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) in cui possiamo specificare direttamente l'ora di fine.
default void	testEnded(TestDescription test, testMetrics) Segnala il termine dell'esecuzione di un singolo test case.
default void	testFailed(TestDescription test, FailureDescription failure) Segnala l'errore di un singolo test case.
default void	testFailed(TestDescription test, String trace) Segnala l'errore di un singolo test case.
default void	testIgnored(TestDescription test) Viene chiamato quando un test non verrà eseguito, in genere perché un metodo di test è annotato con org.junit.Ignore.
default void	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 causa di un errore descritto da FailureDescription.
default void	testRunFailed(String errorMessage) L'esecuzione del test dei report non è riuscita a causa di un errore fatale.
default void	testRunStarted(String runName, int testCount, int attemptNumber) Segnala l'inizio di un'esecuzione del test.
default void	testRunStarted(String runName, int testCount) Segnala l'inizio di un'esecuzione del test.
default void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Segnala l'inizio di un'esecuzione del test.
default void	testRunStopped(long elapsedTime) L'esecuzione del test dei report è stata interrotta prima del completamento a causa di una richiesta dell'utente.
default void	testSkipped(TestDescription test, SkipReason reason) Viene chiamato quando un test viene saltato e non viene eseguito per un motivo in genere imprevisto.
default void	testStarted(TestDescription test, long startTime) Alternativa a testStarted(com.android.tradefed.result.TestDescription) in cui viene specificato anche quando è stato avviato il test, combinata con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) per una misurazione accurata.
default void	testStarted(TestDescription test) Segnala l'inizio di un singolo test case.

Metodi pubblici

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                String trace)

Viene chiamato quando un test atomico segnala che presuppone una condizione falsa

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Viene 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.

testEnded

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

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) in cui 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 di fine del test, misurata tramite System.currentTimeMillis()
testMetrics	: un ERROR(/Map) delle metriche emesse

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Segnala il termine dell'esecuzione di un singolo test case.

Se testFailed(TestDescription, FailureDescription) non è stato invocato, questo test è stato superato. Restituisce anche eventuali metriche chiave/valore che potrebbero essere state emesse durante l'esecuzione del test case.

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

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Segnala l'errore 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 l'errore di un singolo test case.

Verrà chiamato tra testStarted e testEnded.

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

testIgnored

public void testIgnored (TestDescription test)

Viene chiamato quando un test non verrà eseguito, in genere 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.

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

testRunFailed

public void testRunFailed (FailureDescription failure)

L'esecuzione del test dei report non è riuscita 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 causa di un errore fatale.

Parametri
errorMessage	String: 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 del test.

Parametri
runName	String: il nome dell'esecuzione del test
testCount	int: numero totale di test nell'esecuzione di test
attemptNumber	int: numero d'ordine, che identifica i diversi tentativi dello stesso runName eseguiti più volte. Il numero di tentativi è indicizzato da 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene riavviato granularmente 3 volte, deve avere 4 esecuzioni totali con lo stesso nome esecuzione e il numero di tentativi va da 0 a 3.

testRunStarted

public void testRunStarted (String runName, 
                int testCount)

Segnala l'inizio di un'esecuzione del test.

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

testRunStarted

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

Segnala l'inizio di un'esecuzione del test.

Parametri
runName	String: il nome dell'esecuzione del test
testCount	int: numero totale di test nell'esecuzione di test
attemptNumber	int: numero d'ordine, che identifica i diversi tentativi dello stesso runName eseguiti più volte. Il numero di tentativi è indicizzato da 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene riavviato granularmente 3 volte, deve avere 4 esecuzioni totali con lo stesso nome esecuzione e il numero di tentativi va da 0 a 3.
startTime	long: l'ora di inizio dell'esecuzione, misurata tramite System.currentTimeMillis()

testRunStopped

public void testRunStopped (long elapsedTime)

L'esecuzione del test dei report è stata interrotta prima del completamento a causa di una richiesta dell'utente.

TODO: currently unused, consider removing

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Viene chiamato quando un test viene saltato e non viene eseguito per un motivo in genere imprevisto. Verrà tentato di ripetere questi test per ottenere un'esecuzione corretta.

Parametri
test	TestDescription: identifica il test
reason	SkipReason: SkipReason

testStarted

public void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) in cui viene specificato anche quando è stato avviato il test, combinata con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) per una misurazione accurata.

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

testStarted

public void testStarted (TestDescription test)

Segnala l'inizio di un singolo test case. Interfaccia precedente, da utilizzare con testStarted(com.android.tradefed.result.TestDescription), se possibile.

Parametri
test	TestDescription: identifica il test