A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release anziché aosp-main per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.

Questa pagina è stata tradotta dall'API Cloud Translation.

ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

Sottoclassi indirette note

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

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.
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.
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.
DeviceTraceCollector	Il raccoglitore che avvierà la traccia perfetto all'inizio di un test e registrerà il file di traccia al termine.
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.
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.
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.
InvocationProtoResultReporter	Reporter per archiviare le informazioni sulla memorizzazione nella cache a livello di invocazione e il relativo elenco di moduli
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 JSON e POST in 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.
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.
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.
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.
ProtoResultReporter	Result Reporter crea un protobuf `TestRecord` con tutti i risultati all'interno.
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.
ResultReporter
RetryLogSaverResultForwarder	Forwarder che gestisce anche il passaggio del tentativo corrente.
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.
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.
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.

Consente a ITestInvocationListener di rilevare quando vengono salvati i file di log.

Ciò consente a più ITestInvocationListener di utilizzare lo stesso file di log salvato durante la generazione dei report ed evita che ogni listener salvi il file singolarmente quando viene chiamato ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource).

Le classi che implementano questa interfaccia devono essere consapevoli che testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) verrà chiamato ogni volta che viene chiamato ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource).

Questa classe passa anche l'istanza globale ILogSaver, in modo che ITestInvocationListener possano salvare file aggiuntivi nella stessa posizione.

Riepilogo

Metodi pubblici
`default void`	`logAssociation(String dataName, LogFile logFile)` In alcuni casi, il log deve essere fortemente associato a uno scenario di test, ma l'opportunità di farlo nel callback diretto `testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile)` non è possibile.
`default void`	`setLogSaver(ILogSaver logSaver)` Imposta `ILogSaver` per consentire all'implementatore di salvare i file.
`default void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Chiamato quando viene salvato il log di test.

Metodi pubblici

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

In alcuni casi, il log deve essere fortemente associato a uno scenario di test, ma l'opportunità di farlo nel callback diretto testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) non è possibile. Pertanto, questo callback consente di fornire un'associazione forte in modo esplicito.

Parametri
`dataName`	`String`: il nome dei dati
`logFile`	`LogFile`: il `LogFile` registrato in precedenza e che deve essere associato allo scenario di test.

setLogSaver

public void setLogSaver (ILogSaver logSaver)

Imposta ILogSaver per consentire all'implementatore di salvare i file.

Parametri
`logSaver`	`ILogSaver`: il `ILogSaver`

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

Chiamato quando viene salvato il log di test.

Deve essere utilizzato al posto di ITestInvocationListener.testLog(String, LogDataType, InputStreamSource).

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.
`logFile`	`LogFile`: il `LogFile` contenente i metadati del file salvato.