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 ILogSaverListener, IDisableable

com.android.tradefed.device.metric.IMetricCollector

Classi di sottoclasse indirette note

BaseDeviceMetricCollector, BugreportzOnFailureCollector, ClangCodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector, GcovCodeCoverageCollector, JavaCodeCoverageCollector, LogcatOnFailureCollector, ScreenshotOnFailureCollector

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))`.
BugreportzOnFailureCollector	Raccogliere una segnalazione di bug quando uno scenario di test 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.
CountTestCasesCollector	Conta e genera 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.
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.
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.
ScreenshotOnFailureCollector	Raccoglitore che acquisisce e registra uno screenshot quando uno scenario di test non va a buon fine.

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
`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)` Richiamo al termine di un test case.
`abstract void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` 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.
`abstract void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Richiamo al termine di un test.
`abstract void`	`onTestRunStart(DeviceMetricData runData)` Callback quando viene avviata un'esecuzione di test.
`abstract void`	`onTestStart(DeviceMetricData testData)` Richiamo quando viene avviato un caso di test.

Metodi pubblici

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 deve 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.

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.

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 `ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map)`.

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 `ITestLifeCycleReceiver.testEnded(com.android.tradefed.result.TestDescription, Map)`.
`test`	`TestDescription`: il `TestDescription` dello scenario di test in corso.

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.

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Richiamo al termine di un 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 `ITestLifeCycleReceiver.testRunEnded(long, Map)`.

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.

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.