RicevitoreITestLifeCycle

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, CollectingTestListener e altri 77. AggregatePostProcessor Un aggregatore di metriche che fornisce i percentili minimo, massimo, media, varianza, deviazione standard, totale, conteggio e, facoltativamente, per le metriche numeriche raccolte durante le esecuzioni di test di 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 tutta la 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.  MediaPostProcessor Implementazione di post-processore che calcola la media dell'elenco di 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 Raccogli una segnalazione di bug quando un caso di test in un'esecuzione non va a buon fine.  ClangCodeCoperturaCollector Un BaseDeviceMetricCollector che estrae le misurazioni della copertura di Clang 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 Conteggia e segnala il numero di scenari di test per un determinato IRemoteTest.  CountingTestResultListener Un valore 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 di rilascio 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 Listener 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 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 estrarrà le misurazioni di copertura gcov dal dispositivo e le registri come artefatti di test.  GcovKernelCodeCoverageCollector Un BaseDeviceMetricCollector che estrarrà le misurazioni della copertura del kernel gcov dai debugf e dal dispositivo e poi le registri come artefatti 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 della utility 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 decoratore quando generi report sui risultati dei test per raccogliere metriche corrispondenti.  IPostProcessor I post-processori sono oggetti Trade Federation progettati 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 Listener per i risultati del test dalla chiamata al test.  ITestSummaryListener 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 di wrapper che inoltra tutti gli eventi tranne 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 i dati del ramo e del dispositivo in JSON e li 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 reporter sui risultati del sottoprocesso che dovrebbe rimanere compatibile con le versioni precedenti di TF/CTS (ad es. 8+), nonostante le modifiche nella sua 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'errore il logcat 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 ed esegue le metriche in un file XML in una cartella specificata dal parametro Metrics-folder nella fase invocationEnded del test.  ModuleListener Listener associato 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 perfetto metrico 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 eseguire il pull dei file perfetti dal dispositivo e di raccoglierne 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 numero.  RemoteTestTimeOutEnforcer Listener che consentono di controllare il tempo di esecuzione di una determinata configurazione di test e di non riuscire se supera un determinato timeout.  ReportPassedTest 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 Forwarder per i risultati e gli eventi dei log.  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 elemento 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 listener.  ShardMainResultForwarder Un elemento ResultForwarder che combina i risultati delle chiamate di test con sharding.  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 i processi valuta le metriche raccolte con un approccio "prima/dopo", ovvero StatsdEventMetricPostProcessor Un post-processore che elabora le metriche degli eventi nei report statistici in coppie chiave-valore, utilizzando i formattatori specificati sul 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 nella chiamata.  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 delle chiamate sarà:

• testRunStarted
• testStarted
• [testFailed]
• [testAssumptionFailure]
• [testIgnored]
• testTerminato
• ....
• [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 è possibile 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) Richiamato quando non verrà eseguito un test, in genere perché un metodo di test è annotato con org.junit.Ignora.
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 irreversibile.
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 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) Esecuzione di test dei report interrotta prima del completamento a causa di una richiesta dell'utente.
default void	testSkipped(TestDescription test, SkipReason reason) Richiamato quando un test viene ignorato e non è stato eseguito per un motivo solitamente non previsto.
default void	testStarted(TestDescription test, long startTime) In alternativa a testStarted(com.android.tradefed.result.TestDescription), in cui specifichiamo anche quando è stato avviato il test, combinato 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)

Richiamato quando un test atomico segnala che assume una condizione falsa

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

testAssumptionFailure

public void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Richiamato quando un test atomico segnala che assume 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)), in cui è possibile 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	: una percentuale pari a 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)

Fine dell'esecuzione del test nei report.

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

testRunNon riuscito

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: 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: 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: nome dell'esecuzione del test
testCount	int: numero totale di test nell'esecuzione di test
attemptNumber	int: numero ordine che identifica i diversi tentativi eseguiti dallo stesso runName più volte. Il valore attemptNumber è 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 runName e il valore attemptNumber deve essere compreso tra 0 e 3.
startTime	long: l'ora di inizio dell'esecuzione, misurata tramite System.currentTimeMillis()

testRunArrestato

public void testRunStopped (long elapsedTime)

Esecuzione di test dei report interrotta prima del completamento a causa di una richiesta dell'utente.

DA FARE: attualmente inutilizzato, valuta la possibilità di rimuoverlo

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

testIgnorato

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. L'interfaccia precedente dovrebbe utilizzare testStarted(com.android.tradefed.result.TestDescription) quando possibile.

Parametri
test	TestDescription: identifica il test