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.

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IMetricCollector

java.lang.Object
↳	com.android.tradefed.device.metric.BaseDeviceMetricCollector

Classi di sottoclasse dirette note

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

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

Classi di sottoclasse indirette note

FilePullerLogCollector

FilePullerLogCollector Logger del file segnalato dal lato del dispositivo.

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

Riepilogo

Campi
`public static final String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`public static final String`	`TEST_CASE_INCLUDE_GROUP_OPTION`

Costruttori pubblici
`BaseDeviceMetricCollector()`

Metodi pubblici
`final`	`getBuildInfos()` Restituisce l'elenco delle informazioni di compilazione disponibili nell'invocazione.
`final`	`getDevices()` Restituisce l'elenco dei dispositivi disponibili nell'invocazione.
`File`	`getFileFromTestArtifacts(String fileName)` Recupera il file dagli elementi di test o dai componenti del modulo e memorizzalo nella cache in una mappa per le chiamate successive.
`final ITestInvocationListener`	`getInvocationListener()` Restituisce l'`ITestInvocationListener` originale a cui inoltriamo i risultati.
`final`	`getRealDevices()` Restituisce tutti i dispositivi non stub dall'elenco `getDevices()`.
`String`	`getRunName()` Restituisce il nome dell'esecuzione del test `mRunName` che attiva il raccoglitore.
`ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inizializzazione del raccoglitore con il contesto corrente e la destinazione dei risultati.
`final void`	`invocationEnded(long elapsedTime)`
`final void`	`invocationFailed(FailureDescription failure)`
`final void`	`invocationFailed(Throwable cause)`
`final void`	`invocationStarted(IInvocationContext context)` Listener di chiamata per il trasferimento
`final boolean`	`isDisabled()` Restituisce True se l'intero oggetto è disabilitato (salta la configurazione e lo smantellamento).
`final void`	`logAssociation(String dataName, LogFile logFile)` Non utilizzare l'implementazione interna del raccoglitore delle metriche.
`void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Callback quando uno scenario di test non va a buon fine con un errore di ipotesi.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test)` Richiamo al termine di un test case.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` Richiamo al termine di un test case.
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Callback quando uno scenario di test non va a buon fine.
`void`	`onTestRunEnd(DeviceMetricData runData, currentRunMetrics)` Richiamo al termine di un test.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)`
`void`	`onTestRunStart(DeviceMetricData runData)` Callback quando viene avviata un'esecuzione di test.
`void`	`onTestStart(DeviceMetricData testData)` Richiamo quando viene avviato un caso di test.
`final void`	`setDisable(boolean isDisabled)` Imposta se l'oggetto deve essere disattivato.
`final void`	`setLogSaver(ILogSaver logSaver)` Non utilizzare l'implementazione interna del raccoglitore delle metriche.
`final void`	`testAssumptionFailure(TestDescription test, String trace)`
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)`
`final void`	`testEnded(TestDescription test, long endTime, testMetrics)`
`final void`	`testEnded(TestDescription test, testMetrics)`
`final void`	`testFailed(TestDescription test, FailureDescription failure)`
`final void`	`testFailed(TestDescription test, String trace)`
`final void`	`testIgnored(TestDescription test)`
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)`
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Non utilizzare l'implementazione interna del raccoglitore delle metriche.
`final void`	`testModuleEnded()`
`final void`	`testModuleStarted(IInvocationContext moduleContext)`
`final void`	`testRunEnded(long elapsedTime, runMetrics)`
`final void`	`testRunFailed(FailureDescription failure)`
`final void`	`testRunFailed(String errorMessage)`
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)`
`final void`	`testRunStarted(String runName, int testCount)` Callback di esecuzione del test
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)`
`final void`	`testRunStopped(long elapsedTime)`
`final void`	`testStarted(TestDescription test, long startTime)`
`final void`	`testStarted(TestDescription test)` Callback degli scenari di test

Campi

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Costruttori pubblici

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

Metodi pubblici

getBuildInfos

public final  getBuildInfos ()

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

Ritorni

getDevices

public final  getDevices ()

Restituisce l'elenco dei dispositivi disponibili nell'invocazione.

Ritorni

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

Recupera il file dagli elementi di test o dai componenti del modulo e memorizzalo nella cache in una mappa per le chiamate successive.

Parametri
`fileName`	`String`: il nome del file da cercare negli elementi.

Ritorni
`File`	File dall'artefatto del test o dall'artefatto del modulo. Restituisce null se il file non viene trovato.

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

Restituisce l'ITestInvocationListener originale a cui inoltriamo i risultati.

Ritorni
`ITestInvocationListener`

getRealDevices

public final  getRealDevices ()

Restituisce tutti i dispositivi non stub dall'elenco getDevices().

Ritorni

getRunName

public String getRunName ()

Restituisce il nome dell'esecuzione del test mRunName che attiva il raccoglitore.

Ritorni
`String`	mRunName, il nome dell'esecuzione del test corrente.

init

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

invocationEnded

public final void invocationEnded (long elapsedTime)

Parametri
`elapsedTime`	`long`

invocationFailed

public final void invocationFailed (FailureDescription failure)

Parametri
`failure`	`FailureDescription`

invocationFailed

public final void invocationFailed (Throwable cause)

Parametri
`cause`	`Throwable`

invocationStarted

public final void invocationStarted (IInvocationContext context)

Listener di chiamata per il trasferimento

Parametri
`context`	`IInvocationContext`

isDisabled

public final boolean isDisabled ()

Restituisce True se l'intero oggetto è disabilitato (salta la configurazione e lo smantellamento). Falso negli altri casi.

Ritorni
`boolean`

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

Non utilizzare l'implementazione interna del raccoglitore delle metriche. Si tratta di un semplice inoltro.

Parametri
`dataName`	`String`
`logFile`	`LogFile`

onTestAssumptionFailure

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

onTestEnd

public 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)`.

onTestFail

public 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 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)`.

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Parametri
`testData`	`DeviceMetricData`
`failure`	`FailureDescription`

onTestRunStart

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

setDisable

public final void setDisable (boolean isDisabled)

Imposta se l'oggetto deve essere disattivato. Disattivato significa che sia i passaggi di configurazione sia quelli di smantellamento devono essere saltati. Può essere utilizzato per disattivare un oggetto per impostazione predefinita nel constructor predefinito.

Parametri
`isDisabled`	`boolean`: lo stato in cui deve essere inserito l'oggetto.

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Non utilizzare l'implementazione interna del raccoglitore delle metriche. Si tratta di un semplice inoltro.

Parametri
`logSaver`	`ILogSaver`

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Parametri
`test`	`TestDescription`
`trace`	`String`

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Parametri
`test`	`TestDescription`
`failure`	`FailureDescription`

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                 testMetrics)

Parametri
`test`	`TestDescription`
`endTime`	`long`
`testMetrics`

testEnded

public final void testEnded (TestDescription test, 
                 testMetrics)

Parametri
`test`	`TestDescription`
`testMetrics`

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Parametri
`test`	`TestDescription`
`failure`	`FailureDescription`

testFailed

public final void testFailed (TestDescription test, 
                String trace)

Parametri
`test`	`TestDescription`
`trace`	`String`

testIgnored

public final void testIgnored (TestDescription test)

Parametri
`test`	`TestDescription`

testLog

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

Parametri
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`

testLogSaved

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

Non utilizzare l'implementazione interna del raccoglitore delle metriche. Si tratta di un semplice inoltro.

Parametri
`dataName`	`String`
`dataType`	`LogDataType`
`dataStream`	`InputStreamSource`
`logFile`	`LogFile`

testModuleEnded

public final void testModuleEnded ()

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Parametri
`moduleContext`	`IInvocationContext`

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Parametri
`elapsedTime`	`long`
`runMetrics`

testRunFailed

public final void testRunFailed (FailureDescription failure)

Parametri
`failure`	`FailureDescription`

testRunFailed

public final void testRunFailed (String errorMessage)

Parametri
`errorMessage`	`String`

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber)

Parametri
`runName`	`String`
`testCount`	`int`
`attemptNumber`	`int`

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Callback di esecuzione del test

Parametri
`runName`	`String`
`testCount`	`int`

testRunStarted

public final void testRunStarted (String runName, 
                int testCount, 
                int attemptNumber, 
                long startTime)

Parametri
`runName`	`String`
`testCount`	`int`
`attemptNumber`	`int`
`startTime`	`long`

testRunStopped

public final void testRunStopped (long elapsedTime)

Parametri
`elapsedTime`	`long`

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

Parametri
`test`	`TestDescription`
`startTime`	`long`

testStarted

public final void testStarted (TestDescription test)

Callback degli scenari di test

Parametri
`test`	`TestDescription`