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.

IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

Classi di sottoclasse indirette note

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

AtraceCollector	Un `IMetricCollector` che esegue atrace durante un test e raccoglie il risultato e lo registra nell'invocazione.
AtraceRunMetricCollector	Raccoglie le tracce da tutte le 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.
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 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.
BluetoothHciSnoopLogCollector	Raccogliere per attivare la registrazione di analisi HCI Bluetooth sul DUT e raccogliere il log per ogni test.
BugreportzOnFailureCollector	Raccogliere una segnalazione di bug quando uno scenario di test non va a buon fine.
BugreportzOnTestCaseFailureCollector	Raccogliere una segnalazione di bug quando un caso di test in un'esecuzione non va a buon fine.
ClangCodeCoverageCollector	Un `BaseDeviceMetricCollector` che estrae le misurazioni della copertura di Clang dal dispositivo e le registra come elementi di test.
CodeCoverageCollector	Un `BaseDeviceMetricCollector` che estrae le misurazioni della copertura Java e nativa dal dispositivo e le registra come elementi di test.
CountTestCasesCollector	Conta e genera un report sul numero di casi di test per un determinato `IRemoteTest`.
DebugHostLogOnFailureCollector	Raccogli i log lato host e registrali quando si verifica un errore dello scenario di test.
DeviceTraceCollector	Raccogli dati che avvia la traccia di Perfetto all'avvio di un test e registra il file di traccia alla fine.
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 del dispositivo.
GcovCodeCoverageCollector	Un `BaseDeviceMetricCollector` che estrae le misurazioni della copertura di gcov dal dispositivo e le registra come elementi di test.
GcovKernelCodeCoverageCollector	Un `BaseDeviceMetricCollector` che estrae le misurazioni della copertura del kernel gcov da debugfs e dal dispositivo e poi le registra come elementi di test.
HostStatsdMetricCollector	Un `IMetricCollector` che raccoglie le metriche StatsD lato host utilizzando i comandi dell'utilità StatsD.
JavaCodeCoverageCollector	Un `BaseDeviceMetricCollector` che estrae le misurazioni della copertura Java dal dispositivo e le registra come elementi di 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.
ModuleLogcatCollector	Versione del raccoglitore logcat, ma per il modulo.
PerfettoPullerMetricCollector	Implementazione di base di `FilePullerDeviceMetricCollector` che consente di recuperare i file di perfetto dal dispositivo e di raccogliere le metriche.
RebootReasonCollector	Raccogli i riavvii del dispositivo durante l'esecuzione del test e genera un report in base al motivo e al conteggio.
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.
ShowmapPullerMetricCollector	Implementazione di base di `FilePullerDeviceMetricCollector` che consente di estrarre i file della mappa del programma dal dispositivo e di raccogliere le metriche.
TraceCmdCollector	Un `IMetricCollector` che raccoglie le tracce durante il test utilizzando trace-cmd e le registra nell'invocazione.

Questa interfaccia verrà aggiunta come decorazione quando vengono generati i report sui risultati dei test per raccogliere le 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 collezionisti mantengano uno stato interno, in quanto potrebbero essere riutilizzati in più punti. Se è davvero necessario utilizzare uno stato interno, questo 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 se deve essere inizializzato.
`abstract`	`getBuildInfos()` Restituisce l'elenco delle informazioni di compilazione disponibili nell'invocazione.
`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 dei risultati.
`abstract void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Callback quando uno scenario di test non va a buon fine con un errore di ipotesi.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Richiamo al termine di un test case.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Richiamo al termine di un test case.
`abstract void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Callback quando uno scenario di test non va a buon fine.
`default void`	`onTestModuleEnded()` Consente di acquisire l'evento di fine del modulo.
`default void`	`onTestModuleStarted()` Consente di acquisire l'evento di inizio del modulo.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Richiamo al termine di un'esecuzione del test.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` Callback quando viene avviata un'esecuzione di test.
`default void`	`onTestRunStart(DeviceMetricData runData, int testCount)` Callback quando viene avviata un'esecuzione di test.
`abstract void`	`onTestStart(DeviceMetricData testData)` Richiamo 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 se deve essere inizializzato.

Ritorni
`boolean`

getBuildInfos

public abstract  getBuildInfos ()

Restituisce l'elenco delle informazioni di compilazione disponibili nell'invocazione.

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 dei risultati. Verrà chiamato solo una volta per istanza e il collector dovrebbe aggiornare il proprio contesto e ascoltatore interno. Init non verrà mai chiamato durante l'esecuzione di un test, sempre prima.

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

Parametri
`context`	`IInvocationContext`: il `IInvocationContext` per l'invocazione in corso.
`listener`	`ITestInvocationListener`: l'`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 va a buon fine con un errore di ipotesi.

Parametri
`testData`	`DeviceMetricData`: il `DeviceMetricData` contenente i dati per il caso di test.
`test`	`TestDescription`: il `TestDescription` dello scenario di test in corso.

Lanci
`DeviceNotAvailableException`

onTestEnd

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

Richiamo al termine di un test case. È il momento di eseguire la pulizia.

Parametri
`testData`	`DeviceMetricData`: il `DeviceMetricData` contenente i dati per il caso di test. Sarà lo stesso oggetto di `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: la mappa corrente delle metriche passate 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)

Richiamo al termine di un test case. È il momento di eseguire la pulizia.

Parametri
`testData`	`DeviceMetricData`: il `DeviceMetricData` contenente i dati per il caso di test. Sarà lo stesso oggetto di `onTestStart(com.android.tradefed.device.metric.DeviceMetricData)`.
`currentTestCaseMetrics`	: la mappa corrente delle metriche passate 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 va a buon fine.

Parametri
`testData`	`DeviceMetricData`: il `DeviceMetricData` contenente i dati per il caso 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 inizio del modulo.

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

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Richiamo al termine di un'esecuzione del test. È il momento di eseguire la pulizia.

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

Lanci
`DeviceNotAvailableException`

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

Callback quando viene avviata un'esecuzione di test.

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 un'esecuzione di test.

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

Lanci
`DeviceNotAvailableException`

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

Richiamo quando viene avviato un caso di test.

Parametri
`testData`	`DeviceMetricData`: il `DeviceMetricData` contenente i dati per il caso di test.

Lanci
`DeviceNotAvailableException`