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.

IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

Sottoclassi indirette note

AtraceCollector, AtraceRunMetricCollector, BaseDeviceMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector e altri 14.

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.
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))`.
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.
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.
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.
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.
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.
HostStatsdMetricCollector	Un `IMetricCollector` che raccoglie le metriche statsd dal lato host utilizzando i comandi dell'utilità statsd.
JavaCodeCoverageCollector	Un `BaseDeviceMetricCollector` che estrae le misurazioni della copertura Java dal dispositivo e le registra come artefatti di 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.
ModuleLogcatCollector	Versione del raccoglitore logcat, ma per il modulo.
PerfettoFilePullerCollector	Un raccoglitore che estrae i file di traccia Perfetto dal dispositivo, li comprime facoltativamente e li aggiunge ai log di test.
PerfettoPullerMetricCollector	Questa classe è obsoleta. Utilizza invece `PerfettoFilePullerCollector` e `ERROR(/PerfettoTracePostProcessor)`.
RebootReasonCollector	Il raccoglitore che raccoglie i riavvii del dispositivo durante l'esecuzione del test e li segnala in base al motivo e al numero.
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.
ShowmapPullerMetricCollector	Implementazione di base di `FilePullerDeviceMetricCollector` che consente di estrarre i file showmap dal dispositivo e raccogliere le metriche.
TraceCmdCollector	Un `IMetricCollector` che raccoglie le tracce durante il test utilizzando trace-cmd e le registra nella chiamata.

Questa interfaccia verrà aggiunta come decoratore durante la generazione di report sui risultati dei test per raccogliere metriche corrispondenti.

Questa interfaccia non può essere utilizzata come anche se estende ITestInvocationListener. Il controllo della configurazione lo rifiuterà. Deve essere utilizzato come "metrics_collector".

Non è previsto che i raccoglitori mantengano uno stato interno, in quanto potrebbero essere riutilizzati in più posizioni. Se uno stato interno deve essere utilizzato, deve essere pulito su init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener).

Riepilogo

Metodi pubblici
`default boolean`	`captureModuleLevel()` Indica se il raccoglitore è applicabile all'acquisizione a livello di modulo e deve essere inizializzato.
`abstract`	`getBuildInfos()` Restituisce l'elenco delle informazioni sulla build disponibili nella chiamata.
`abstract`	`getDevices()` Restituisce l'elenco dei dispositivi disponibili nell'invocazione.
`abstract ITestInvocationListener`	`getInvocationListener()` Restituisce l'`ITestInvocationListener` originale a cui inoltriamo i risultati.
`abstract ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inizializzazione del raccoglitore con il contesto corrente e la destinazione di inoltro dei risultati.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Callback quando uno scenario di test non riesce a causa di un errore di ipotesi.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Callback al termine di uno scenario di test.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Callback al termine di uno scenario di test.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Callback quando uno scenario di test non riesce.
`default void`	`onTestModuleEnded()` Consente di acquisire l'evento di fine del modulo.
`default void`	`onTestModuleStarted()` Consente di acquisire l'evento di avvio del modulo.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Callback quando un test viene terminato.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` Callback quando viene avviata una prova.
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` Callback quando viene avviata una prova.
`abstract void`	`onTestStart(DeviceMetricData testData)` Callback quando viene avviato un caso di test.

Metodi pubblici

captureModuleLevel

public boolean captureModuleLevel ()

Indica se il raccoglitore è applicabile all'acquisizione a livello di modulo e deve essere inizializzato.

Ritorni
`boolean`

getBuildInfos

public abstract  getBuildInfos ()

Restituisce l'elenco delle informazioni sulla build disponibili nella chiamata.

Ritorni

getDevices

public abstract  getDevices ()

Restituisce l'elenco dei dispositivi disponibili nell'invocazione.

Ritorni

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

Restituisce l'ITestInvocationListener originale a cui inoltriamo i risultati.

Ritorni
`ITestInvocationListener`

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inizializzazione del raccoglitore con il contesto corrente e la destinazione di inoltro dei risultati. Verrà chiamato solo una volta per istanza e il raccoglitore deve aggiornare il contesto e il listener interni. Init non verrà mai chiamato durante l'esecuzione di un test, ma sempre prima.

Non eseguire l'override a meno che tu non sappia cosa stai facendo.

Parametri
`context`	`IInvocationContext`: il `IInvocationContext` per la chiamata in corso.
`listener`	`ITestInvocationListener`: il `ITestInvocationListener` in cui inserire i risultati.

Ritorni
`ITestInvocationListener`	il nuovo ascoltatore che avvolge quello originale.

Lanci
`DeviceNotAvailableException`

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Callback quando uno scenario di test non riesce a causa di un errore di ipotesi.

Parametri
`testData`	`DeviceMetricData`: il `DeviceMetricData` che contiene i dati per lo scenario di test.
`test`	`TestDescription`: il `TestDescription` dello scenario di test in corso.

Lanci
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

Callback al termine di uno scenario di test. Questo dovrebbe essere il momento della pulizia.

Parametri
`testData`	`DeviceMetricData`: il `DeviceMetricData` che contiene i dati per lo scenario di test. Sarà lo stesso oggetto di `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: la mappatura attuale delle metriche trasmesse a `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.
`test`	`TestDescription`: il `TestDescription` dello scenario di test in corso.

Lanci
`DeviceNotAvailableException`

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Callback al termine di uno scenario di test. Questo dovrebbe essere il momento della pulizia.

Parametri
`testData`	`DeviceMetricData`: il `DeviceMetricData` che contiene i dati per lo scenario di test. Sarà lo stesso oggetto di `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: la mappatura attuale delle metriche trasmesse a `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))`.

Lanci
`DeviceNotAvailableException`

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Callback quando uno scenario di test non riesce.

Parametri
`testData`	`DeviceMetricData`: il `DeviceMetricData` che contiene i dati per lo scenario di test.
`test`	`TestDescription`: il `TestDescription` dello scenario di test in corso.

Lanci
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Consente di acquisire l'evento di fine del modulo.

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Consente di acquisire l'evento di avvio del modulo.

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Callback quando un test viene terminato. Questo dovrebbe essere il momento della pulizia.

Parametri
`runData`	`DeviceMetricData`: il `DeviceMetricData` contenente i dati per l'esecuzione. Sarà lo stesso oggetto di `onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentRunMetrics`	: la mappatura attuale delle metriche trasmesse a `ERROR(/#testRunEnded(long,Map))`.

Lanci
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Callback quando viene avviata una prova.

Parametri
`runData`	`DeviceMetricData`: il `DeviceMetricData` contenente i dati per l'esecuzione.

Lanci
`DeviceNotAvailableException`

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

Callback quando viene avviata una prova.

Parametri
`runData`	`DeviceMetricData`: il `DeviceMetricData` contenente i dati per l'esecuzione.
`testCount`	`int`: il numero di scenari di test in questa esecuzione di test.

Lanci
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Callback quando viene avviato uno scenario di test.

Parametri
`testData`	`DeviceMetricData`: il `DeviceMetricData` che contiene i dati per lo scenario di test.

Lanci
`DeviceNotAvailableException`