A partire dal 2026, per allinearci al nostro modello di sviluppo stabile del trunk e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per la creazione e il contributo ad AOSP, consigliamo di utilizzare android-latest-release anziché aosp-main. Il ramo del manifest android-latest-release farà sempre riferimento alla release più recente inviata ad AOSP. Per saperne di più, vedi Modifiche ad AOSP.

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, CodeCoverageCollector e altri 84.

AggregatePostProcessor	Un aggregatore di metriche che fornisce i valori minimo, massimo, medio, varianza, deviazione standard, totale, conteggio e facoltativamente i percentili per le metriche numeriche raccolte durante le esecuzioni di test a più iterazioni, trattandole come numeri reali.
AtraceCollector	Un `IMetricCollector` che esegue una traccia durante un test e raccoglie il risultato e il log per l'invocazione.
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 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 base `IPostProcessor` che ogni implementazione deve estendere.
BluetoothConnectionLatencyCollector	Il raccoglitore invierà ai dispositivi una configurazione predefinita della metrica di durata statsd e raccoglierà la durata della connessione Bluetooth per ogni profilo.
BluetoothConnectionStateCollector	Questo raccoglitore raccoglierà le metriche BluetoothConnectionStateChanged e registrerà il numero di stati di connessione per ogni profilo.
BluetoothConnectionSuccessRatePostProcessor	Implementazione del post-processore che calcola il tasso di successo per un profilo Bluetooth Utilizza "metric-key-match" per specificare le metriche che contengono stati di connessione Bluetooth in formato numerico Esempio di array [0, 1, 2, 3, 0, 1, 2, 3].
BluetoothHciSnoopLogCollector	Collector per attivare la registrazione di esame HCI Bluetooth sul DUT e raccogliere il log per ogni test.
BugreportCollector	Un pass-through `ITestInvocationListener` che raccoglie i report di bug quando si verificano eventi configurabili e poi chiama `ITestInvocationListener.testLog` sui suoi figli dopo ogni report di bug raccolto.
BugreportzOnFailureCollector	Raccogli un bugreportz quando uno scenario di test non riesce.
BugreportzOnTestCaseFailureCollector	Raccogli un bugreportz quando uno scenario di test in un'esecuzione non riesce.
ClangCodeCoverageCollector	Un `BaseDeviceMetricCollector` che estrae le misurazioni della copertura di Clang dal dispositivo e le registra come artefatti di test.
CodeCoverageCollector	Un `BaseDeviceMetricCollector` che estrae le misurazioni della copertura Java e nativa dal dispositivo e le registra come artefatti di test.
CollectingTestListener	Un `ITestInvocationListener` che raccoglierà tutti i risultati del test.
CommandStatusHandler	Gestore che aiuta a monitorare e aggiornare lo stato di un'invocazione.
ConditionFailureMonitor	Monitora eventuali errori durante la chiamata.
ConsoleResultReporter	Reporter dei risultati per stampare i risultati del test nella console.
CountTestCasesCollector	Conta e segnala il numero di scenari di test per un determinato `IRemoteTest`.
CountingTestResultListener	Un `TestResultListener` che monitora il numero totale di test per `TestStatus`
DebugHostLogOnFailureCollector	Il raccoglitore che raccoglierà e registrerà i log lato host quando si verifica un errore nello scenario di test.
DeviceReleaseReporter	Reporter di rilascio del dispositivo che gestisce la comunicazione con il processo principale del dispositivo o dei dispositivi da rilasciare.
DeviceTraceCollector	Il raccoglitore che avvierà la traccia perfetto all'inizio di un test e registrerà il file di traccia al termine.
DeviceUnavailableMonitor	Questo listener tenta di acquisire solo un DNAE a livello di scenario di test.
EventsLoggerListener	Listener che registra tutti gli eventi ricevuti in un file
FileProtoResultReporter	Proto reporter che esegue il dump di `TestRecord` in un file.
FilePullerDeviceMetricCollector	Un `BaseDeviceMetricCollector` che ascolta la chiave delle metriche proveniente dal dispositivo e la 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	Reporter che consente di generare report in un formato specifico.
GcovCodeCoverageCollector	Un `BaseDeviceMetricCollector` che estrae le misurazioni della copertura gcov dal dispositivo e le registra come artefatti di test.
GcovKernelCodeCoverageCollector	Un `BaseDeviceMetricCollector` che estrae le misurazioni della copertura del kernel gcov da debugfs e dal dispositivo e le registra infine come artefatti di test.
GranularRetriableTestWrapper.StartEndCollector	Assistente per le lezioni per rilevare l'inizio e la fine delle corse mancanti.
HostStatsdMetricCollector	Un `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 rilevare quando vengono salvati i file di log.
IMetricCollector	Questa interfaccia verrà aggiunta come decoratore durante la generazione di report sui risultati dei test per raccogliere metriche corrispondenti.
IPostProcessor	I post-processor sono un oggetto Trade Federation che consente l'elaborazione di metriche e log DOPO i test e PRIMA della generazione dei report sui risultati.
IShardableListener	Un `ITestInvocationListener` che può essere suddiviso in shard.
ISupportGranularResults	Interfaccia che specifica se un `ITestInvocationListener` supporta la ricezione dei risultati granulari o meno.
ITestInvocationListener	Listener per i risultati dei test dall'invocazione del test.
ITestSummaryListener	Interfaccia che consente a `ITestInvocationListener` di scambiare alcune informazioni limitate tramite riepiloghi.
InvocationProtoResultReporter	Reporter per archiviare le informazioni sulla memorizzazione nella cache a livello di invocazione e il relativo elenco di moduli
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 estrae le misurazioni della copertura Java dal dispositivo e le registra come artefatti di test.
JsonHttpTestResultReporter	Un reporter dei risultati che codifica i risultati delle metriche di test e le informazioni su ramo e dispositivo in formato JSON e li invia a un endpoint di servizio HTTP
LUCIResultReporter	Un reporter dei 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 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 es. 8+), nonostante le modifiche alla superclasse.
LogSaverResultForwarder	Un `ResultForwarder` per salvare i log con il salvataggio globale dei file.
LogcatCrashResultForwarder	Listener speciale: in caso di errori (arresto anomalo del processo di strumentazione), tenta di estrarre l'arresto anomalo da logcat e lo aggiunge al messaggio di errore associato al test.
LogcatOnFailureCollector	Il raccoglitore che acquisisce e registra un logcat quando uno scenario di test non riesce.
LogcatTimingMetricCollector	Un raccoglitore di metriche che raccoglie informazioni sui tempi (ad es. tempo di cambio utente) da logcat durante uno o più test ripetuti utilizzando espressioni regolari fornite per analizzare i segnali di inizio e fine di un evento dalle righe di logcat.
MetricFilePostProcessor	Utilizzato per caricare il file di log delle metriche raccolte durante il test e il livello di 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 reporter dei risultati pensato per segnalare solo i risultati a livello di modulo.
ModuleResultsAndMetricsForwarder	Un'estensione di `ResultAndLogForwarder` che aggiunge metriche aggiuntive relative al modulo ai risultati del test.
NameMangleListener	Un listener proxy per tradurre i nomi di metodi, classi e pacchetti di test man mano che vengono segnalati i risultati.
PassingTestFileReporter	Un `ITestInvocationListener` che salva l'elenco degli scenari di test superati in un file di test
PerfettoFilePullerCollector	Un raccoglitore che estrae i file di traccia Perfetto dal dispositivo, li comprime facoltativamente e li aggiunge ai log di test.
PerfettoGenericPostProcessor	Un post-processore che elabora il file proto della metrica perfetto di testo/binario in coppie chiave-valore espandendo in modo ricorsivo i messaggi e i campi proto con valori stringa finché non viene rilevato il campo con valore numerico.
PerfettoPullerMetricCollector	Questa classe è obsoleta. Utilizza invece `PerfettoFilePullerCollector` e `ERROR(/PerfettoTracePostProcessor)`.
PerfettoTracePostProcessor	Un post-processore che recupera i file di traccia Perfetto dai log di test ed esegue il processore di traccia per produrre un proto di metrica Perfetto.
PrettyTestEventLogger	Logger che corrisponde agli eventi e li registra in ordine per semplificare il debug.
ProtoResultReporter	Result Reporter crea un protobuf `TestRecord` con tutti i risultati all'interno.
PythonBinaryHostTest.PythonForwarder	Result forwarder per sostituire il nome dell'esecuzione con il nome del file binario.
RebootReasonCollector	Il raccoglitore che raccoglie i riavvii del dispositivo durante l'esecuzione del test e li segnala 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 interromperlo se supera un determinato timeout.
ReportPassedTests	Report in a file possible filters to exclude passed test.
ResultAggregator	Special forwarder che aggrega i risultati quando necessario, in base alla strategia di ripetizione adottata.
ResultAndLogForwarder	Forwarder per eventi di risultati e log.
ResultDBReporter	Reporter dei risultati che carica i risultati dei test in ResultDB.
ResultForwarder	Un `ITestInvocationListener` che inoltra i risultati dell'invocazione a un elenco di altri listener.
ResultReporter
RetryLogSaverResultForwarder	Forwarder che gestisce anche il passaggio del tentativo corrente.
RetryResultForwarder	Un'estensione di `ResultForwarder` che esegue sempre il push a un determinato numero di tentativi.
RuntimeRestartCollector	Il raccoglitore che raccoglie i timestamp dei riavvii del runtime (arresti anomali del server di sistema) durante l'esecuzione del test, se presenti.
ScreenshotOnFailureCollector	Il 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 invocazione (ovvero un'invocazione suddivisa per essere eseguita in parallelo su più risorse) e li inoltra a un altro listener.
ShardMainResultForwarder	Un `ResultForwarder` che combina i risultati di invocazioni di test suddivise.
ShowmapPullerMetricCollector	Implementazione di base di `FilePullerDeviceMetricCollector` che consente di estrarre i file showmap dal dispositivo e raccogliere le metriche.
StatsdBeforeAfterGaugeMetricPostProcessor	Un post-processore che elabora le metriche di tipo gauge raccolte con un approccio "prima/dopo", ovvero
StatsdEventMetricPostProcessor	Un post-processore che elabora le metriche evento 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 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 e chiamate di test.
SuiteResultReporter	Raccogli i risultati dei test per l'intera chiamata della suite e genera i risultati finali.
TestResultListener	Una semplificazione di ITestLifecycleListener per gli implementatori che si interessano solo ai 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 caso di test e di non superarlo se supera un determinato timeout.
TextResultReporter	Un reporter dei risultati del test che inoltra i risultati alla stampante dei 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 di `FormattedGeneratorReporter` che formatta i risultati della suite in formato XML.
XmlResultReporter	Scrive i risultati JUnit in file XML in un formato coerente con XMLJUnitResultFormatter di Ant.

Riceve notifiche di eventi durante l'esecuzione dei test di strumentazione.

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)` 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)` 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 la fine dell'esecuzione di un singolo scenario di test.
`default void`	`testFailed(TestDescription test, FailureDescription failure)` Segnala l'esito negativo di un singolo caso di test.
`default void`	`testFailed(TestDescription test, String trace)` Segnala l'esito negativo di un singolo caso di test.
`default void`	`testIgnored(TestDescription test)` 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 di test dei report non è stata completata a causa di un errore descritto da `FailureDescription`.
`default void`	`testRunFailed(String errorMessage)` L'esecuzione del test dei report non è stata completata 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 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 di prova dei report è stata interrotta prima del completamento a causa di una richiesta dell'utente.
`default void`	`testSkipped(TestDescription test, SkipReason reason)` Chiamato quando un test viene ignorato e non eseguito per un motivo insolito.
`default void`	`testStarted(TestDescription test, long startTime)` Alternativa a `testStarted(com.android.tradefed.result.TestDescription)`, in cui specifichiamo anche quando è iniziato 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 scenario di test.

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`: analisi 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.

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 in cui è terminato il test, misurata tramite `System.currentTimeMillis()`
`testMetrics`	: un `ERROR(/Map)` delle metriche emesse

testEnded

public void testEnded (TestDescription test, 
                 testMetrics)

Segnala la fine dell'esecuzione di un singolo scenario di test.

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

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

testFailed

public void testFailed (TestDescription test, 
                FailureDescription failure)

Segnala l'esito negativo di un singolo caso di test.

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'esito negativo di un singolo caso di test.

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)

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 segnalate alla fine di un'esecuzione del test

testRunFailed

public void testRunFailed (FailureDescription failure)

L'esecuzione di test dei report non è stata 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 è stata completata a causa di un errore irreversibile.

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 di 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. attemptNumber è indicizzato a 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene riprovato in modo granulare 3 volte, deve avere 4 esecuzioni totali con lo stesso runName e attemptNumber 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 di 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 di 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. attemptNumber è indicizzato a 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene ritentato in modo granulare 3 volte, deve avere 4 esecuzioni totali con lo stesso runName e attemptNumber va da 0 a 3.
`startTime`	`long`: l'ora in cui è iniziata la corsa, misurata tramite `System.currentTimeMillis()`

testRunStopped

public void testRunStopped (long elapsedTime)

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

TODO: attualmente non utilizzato, valuta la possibilità di rimuoverlo

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

testSkipped

public void testSkipped (TestDescription test, 
                SkipReason reason)

Chiamato quando un test viene ignorato e non eseguito per un motivo insolito. Verrà effettuato un nuovo tentativo di esecuzione di questi test.

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 specifichiamo anche quando è iniziato 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 scenario di test. Interfaccia precedente, deve utilizzare testStarted(com.android.tradefed.result.TestDescription) quando possibile.

Parametri
`test`	`TestDescription`: identifica il test