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.

ITestLogger

public interface ITestLogger

com.android.tradefed.log.ITestLogger

Sottoclassi indirette note

AggregatePostProcessor, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector e altri 83.

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 elementi secondari 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`.
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.
PtsBotTest	Esegui test PTS-bot.
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 risultati ed eventi dei 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.
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.

Un'entità in grado di eseguire la registrazione di stream di dati di vario tipo.

Riepilogo

Metodi pubblici
`default void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Fornisce i dati di log o di debug associati dall'invocazione del test.

Metodi pubblici

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Fornisce i dati di log o di debug associati dall'invocazione del test.

Deve essere chiamato prima del giorno ERROR(/ITestInvocationListener#invocationFailed(Throwable)) o del giorno ERROR(/ITestInvocationListener#invocationEnded(long))

Il framework TradeFederation chiamerà automaticamente questo metodo, fornendo il log host e, se applicabile, il logcat del dispositivo.

Parametri
`dataName`	`String`: un nome descrittivo `String` dei dati, ad es. "device_logcat". Nota dataName potrebbe non essere univoco per invocazione. Ciò significa che gli implementatori devono essere in grado di gestire più chiamate con lo stesso dataName
`dataType`	`LogDataType`: il `LogDataType` dei dati
`dataStream`	`InputStreamSource`: il `InputStreamSource` dei dati. Gli implementatori devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere l'InputStream risultante al termine dell'operazione. I chiamanti devono assicurarsi che l'origine dei dati rimanga presente e accessibile fino al completamento del metodo testLog.