A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

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

Sottoclassi dirette note

AtraceCollector	Un `IMetricCollector` che esegue una traccia durante un test e raccoglie il risultato e il log per l'invocazione.
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 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	Agente di raccolta che raccoglierà e registrerà i log lato host quando si verifica un errore dello 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 le estrae come file dal 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 o un'esecuzione di test non riesce.
LogcatTimingMetricCollector	Un agente di raccolta di metriche che raccoglie informazioni sulla sincronizzazione (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.
ModulePerfettoCollector	Collector che avvierà la traccia Perfetto all'inizio e alla fine di un modulo di test e al riavvio del dispositivo.
RebootReasonCollector	Agente di raccolta che raccoglie i riavvii del dispositivo durante l'esecuzione del test e li segnala per motivo e conteggio.
RuntimeRestartCollector	Agente di raccolta che raccoglie i timestamp dei riavvii del runtime (arresti anomali del server di sistema) durante l'esecuzione del test, se presenti.
ScreenRecordOnFailureCollector	Il raccoglitore che acquisisce e registra una registrazione dello schermo quando uno scenario di test non riesce.
ScreenshotOnFailureCollector	Il raccoglitore che acquisisce e registra uno screenshot quando uno scenario di test non va a buon fine.

Sottoclassi indirette note

AtraceRunMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, ModuleLogcatCollector, PerfettoFilePullerCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector, TraceCmdCollector

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.
BluetoothConnectionLatencyCollector	L'agente di raccolta invierà ai dispositivi una configurazione predefinita della metrica di durata statsd e raccoglierà la durata della connessione Bluetooth per ogni profilo.
BluetoothConnectionStateCollector	Questo agente di raccolta raccoglierà le metriche BluetoothConnectionStateChanged e registrerà il numero di stato della connessione per ogni profilo.
BluetoothHciSnoopLogCollector	Collector per attivare la registrazione di esame HCI Bluetooth sul DUT e raccogliere il log per ogni test.
FilePullerLogCollector	Logger del file segnalato dal lato dispositivo.
ModuleLogcatCollector	Versione del raccoglitore logcat, ma per il modulo.
PerfettoFilePullerCollector	Un agente di raccolta che esegue il pull dei 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)`.
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 nell'invocazione.

Implementazione di base di IMetricCollector che consente di avviare e interrompere la raccolta su onTestRunStart(DeviceMetricData) e onTestRunEnd(DeviceMetricData,Map).

Riepilogo

Costanti
`String`	`TEST_CASE_EXCLUDE_GROUP_OPTION`
`String`	`TEST_CASE_INCLUDE_GROUP_OPTION`

Costruttori pubblici
`BaseDeviceMetricCollector()`

Metodi pubblici
`boolean`	`doesModuleContainFailure()` Restituisce true se il modulo corrente contiene errori di test case o di esecuzione dei test.
`void`	`enableDefaultMetricCollection()` Consente agli agenti di raccolta di abilitare la raccolta delle metriche predefinita.
`void`	`extraInit(IInvocationContext context, ITestInvocationListener listener)`
`IMetricCollector.MetricCollectionLevel`	`getAlwaysOnCollectionLevel()`
`final List<IBuildInfo>`	`getBuildInfos()` Restituisce l'elenco delle informazioni sulla build disponibili nella chiamata.
`final List<ITestDevice>`	`getDevices()` Restituisce l'elenco dei dispositivi disponibili nella chiamata.
`File`	`getFileFromTestArtifacts(String fileName)` Recupera il file dagli artefatti di test o del modulo e memorizzalo in una mappa per le chiamate successive.
`final ITestInvocationListener`	`getInvocationListener()` Restituisce l'`ITestInvocationListener` originale a cui inoltriamo i risultati.
`String`	`getModuleName()`
`IMetricCollector.MetricCollectionLevel`	`getOnFailureCollectionLevel()`
`final List<ITestDevice>`	`getRealDevices()` Restituisce tutti i dispositivi non stub dall'elenco `getDevices()`.
`String`	`getRunName()` Restituisce il nome dell'esecuzione del test `mRunName` che attiva il raccoglitore.
`String`	`getTestName()` Restituisce il nome del test `mTestName` che attiva il raccoglitore.
`final ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inizializzazione dell'agente di raccolta con il contesto corrente e la destinazione a cui inoltrare i risultati.
`final void`	`invocationEnded(long elapsedTime)` Indica che l'invocazione è terminata, correttamente o a causa di una condizione di errore.
`final void`	`invocationFailed(FailureDescription failure)` Segnala una chiamata incompleta a causa di una condizione di errore.
`final void`	`invocationFailed(Throwable cause)` Segnala una chiamata incompleta a causa di una condizione di errore.
`void`	`invocationSkipped(SkipReason reason)` Segnala un'invocazione come ignorata
`final void`	`invocationStarted(IInvocationContext context)` Listener di chiamata per l'inoltro
`boolean`	`isDefaultMetricCollectionEnabled()` Indica se l'agente di raccolta raccoglie metriche nell'ambito della raccolta di metriche predefinita.
`final boolean`	`isDisabled()` Restituisce True se l'intero oggetto è disattivato (salta sia la configurazione che l'eliminazione).
`boolean`	`isDisabledReceiver()` Indica se `IDeviceActionReceiver` è disattivato o meno.
`final void`	`logAssociation(String dataName, LogFile logFile)` Non utilizzare l'implementazione del raccoglitore di metriche interno.
`void`	`onTestAssumptionFailure(DeviceMetricData testData, TestDescription test)` Callback quando uno scenario di test non riesce a causa di un errore di ipotesi.
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)` Callback al termine di uno scenario di test.
`void`	`onTestEnd(DeviceMetricData testData, Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, TestDescription test)` Callback al termine di uno scenario di test.
`void`	`onTestFail(DeviceMetricData testData, TestDescription test)` Callback quando uno scenario di test non riesce.
`void`	`onTestModuleEnded()` Consente di acquisire l'evento di fine del modulo.
`void`	`onTestModuleStarted()` Consente di acquisire l'evento di avvio del modulo.
`void`	`onTestRunEnd(DeviceMetricData runData, Map<String, MetricMeasurement.Metric> currentRunMetrics)` Callback al termine di un test.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)` Callback per gli eventi testRunFailed
`void`	`onTestRunStart(DeviceMetricData runData)` Callback quando viene avviata un'esecuzione di test.
`void`	`onTestStart(DeviceMetricData testData)` Callback quando viene avviato uno scenario di test.
`void`	`rebootEnded(ITestDevice device)` Riceve una notifica quando il riavvio è terminato sul dispositivo.
`void`	`rebootStarted(ITestDevice device)` Riceve una notifica quando il riavvio è iniziato sul dispositivo.
`void`	`setAlwaysOnCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Imposta il livello a cui l'agente di raccolta deve raccogliere i log indipendentemente dagli errori.
`final void`	`setDisable(boolean isDisabled)` Imposta se l'oggetto deve essere disattivato.
`void`	`setDisableReceiver(boolean isDisabled)` Specifica se `IDeviceActionReceiver` deve essere disattivato.
`final void`	`setLogSaver(ILogSaver logSaver)` Non utilizzare l'implementazione del raccoglitore di metriche interno.
`void`	`setModuleContainsFailure()` Indica se il modulo ha avuto errori (scenario di test, esecuzione del test).
`void`	`setOnFailureCollectionLevel(IMetricCollector.MetricCollectionLevel level)` Imposta il livello a cui l'agente di raccolta deve raccogliere i log durante gli errori.
`final void`	`testAssumptionFailure(TestDescription test, String trace)` Chiamato quando un test atomico segnala che presuppone una condizione falsa
`final void`	`testAssumptionFailure(TestDescription test, FailureDescription failure)` Chiamato quando un test atomico segnala che presuppone una condizione falsa
`final void`	`testEnded(TestDescription test, long endTime, HashMap<String, MetricMeasurement.Metric> testMetrics)` Alternativa a `testEnded(TestDescription,Map)` in cui possiamo specificare direttamente l'ora di fine.
`final void`	`testEnded(TestDescription test, HashMap<String, MetricMeasurement.Metric> testMetrics)` Segnala la fine dell'esecuzione di un singolo scenario di test.
`final void`	`testFailed(TestDescription test, FailureDescription failure)` Segnala l'esito negativo di un singolo test case.
`final void`	`testFailed(TestDescription test, String trace)` Segnala l'esito negativo di un singolo test case.
`final void`	`testIgnored(TestDescription test)` Chiamato quando un test non verrà eseguito, in genere perché un metodo di test è annotato con org.junit.Ignore.
`final void`	`testLog(String dataName, LogDataType dataType, InputStreamSource dataStream)` Fornisce i dati di log o di debug associati dall'invocazione del test.
`final void`	`testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile)` Non utilizzare l'implementazione del raccoglitore di metriche interno.
`final void`	`testModuleEnded()` Segnala la fine dell'esecuzione di un modulo.
`final void`	`testModuleStarted(IInvocationContext moduleContext)` Indica l'inizio dell'esecuzione di un modulo.
`final void`	`testRunEnded(long elapsedTime, HashMap<String, MetricMeasurement.Metric> runMetrics)` Segnala la fine dell'esecuzione del test.
`final void`	`testRunFailed(FailureDescription failure)` L'esecuzione di test dei report non è stata completata a causa di un errore descritto da `FailureDescription`.
`final void`	`testRunFailed(String errorMessage)` L'esecuzione del test dei report non è stata completata a causa di un errore irreversibile.
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber)` Segnala l'inizio di un'esecuzione di test.
`final void`	`testRunStarted(String runName, int testCount)` Test run callbacks
`final void`	`testRunStarted(String runName, int testCount, int attemptNumber, long startTime)` Segnala l'inizio di un'esecuzione di test.
`final void`	`testRunStopped(long elapsedTime)` L'esecuzione di prova dei report è stata interrotta prima del completamento a causa di una richiesta dell'utente.
`final void`	`testSkipped(TestDescription test, SkipReason reason)` Chiamato quando un test viene ignorato e non eseguito per un motivo insolito.
`final void`	`testStarted(TestDescription test, long startTime)` Alternativa a `testStarted(TestDescription)`, in cui specifichiamo anche quando è iniziato il test, combinata con `testEnded(TestDescription,long,Map)` per una misurazione accurata.
`final void`	`testStarted(TestDescription test)` Callback degli scenari di test

Costanti

TEST_CASE_EXCLUDE_GROUP_OPTION

public static final String TEST_CASE_EXCLUDE_GROUP_OPTION

Valore costante: "test-case-exclude-group"

TEST_CASE_INCLUDE_GROUP_OPTION

public static final String TEST_CASE_INCLUDE_GROUP_OPTION

Valore costante: "test-case-include-group"

Costruttori pubblici

BaseDeviceMetricCollector

public BaseDeviceMetricCollector ()

Metodi pubblici

doesModuleContainFailure

public boolean doesModuleContainFailure ()

Restituisce true se il modulo corrente contiene errori di test case o di esecuzione dei test.

Resi
`boolean`

enableDefaultMetricCollection

public void enableDefaultMetricCollection ()

Consente agli agenti di raccolta di abilitare la raccolta delle metriche predefinita. Quando la raccolta predefinita delle metriche è abilitata, l'agente di raccolta deve raccogliere solo al livello di raccolta specificato.

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getAlwaysOnCollectionLevel

public IMetricCollector.MetricCollectionLevel getAlwaysOnCollectionLevel ()

Resi
`IMetricCollector.MetricCollectionLevel`

getBuildInfos

public final List<IBuildInfo> getBuildInfos ()

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

Resi
`List<IBuildInfo>`

getDevices

public final List<ITestDevice> getDevices ()

Restituisce l'elenco dei dispositivi disponibili nella chiamata.

Resi
`List<ITestDevice>`

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

Recupera il file dagli artefatti di test o dagli artefatti del modulo e memorizzalo in una mappa per le chiamate successive.

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

Resi
`File`	File dall'artefatto di 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.

Resi
`ITestInvocationListener`

getModuleName

public String getModuleName ()

Resi
`String`

getOnFailureCollectionLevel

public IMetricCollector.MetricCollectionLevel getOnFailureCollectionLevel ()

Resi
`IMetricCollector.MetricCollectionLevel`

getRealDevices

public final List<ITestDevice> getRealDevices ()

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

Resi
`List<ITestDevice>`

getRunName

public String getRunName ()

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

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

getTestName

public String getTestName ()

Restituisce il nome del test mTestName che attiva il raccoglitore.

Resi
`String`	mTestName, il nome del test attuale.

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inizializzazione dell'agente di raccolta con il contesto corrente e la destinazione a cui inoltrare i risultati. Verrà chiamato una sola volta per istanza e l'agente di raccolta 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.

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

Genera
`DeviceNotAvailableException`

invocationEnded

public final void invocationEnded (long elapsedTime)

Indica che l'invocazione è terminata, correttamente o a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
`elapsedTime`	`long`: il tempo trascorso dell'invocazione in ms

invocationFailed

public final void invocationFailed (FailureDescription failure)

Segnala una chiamata incompleta a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
`failure`	`FailureDescription`: il `FailureDescription` che descrive la causa dell'errore

invocationFailed

public final void invocationFailed (Throwable cause)

Segnala una chiamata incompleta a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
`cause`	`Throwable`: la causa `Throwable` dell'errore

invocationSkipped

public void invocationSkipped (SkipReason reason)

Segnala un'invocazione come ignorata

Parametri
`reason`	`SkipReason`

invocationStarted

public final void invocationStarted (IInvocationContext context)

Listener di chiamata per l'inoltro

Parametri
`context`	`IInvocationContext`: informazioni sulla chiamata

isDefaultMetricCollectionEnabled

public boolean isDefaultMetricCollectionEnabled ()

Indica se l'agente di raccolta raccoglie metriche nell'ambito della raccolta di metriche predefinita.

Resi
`boolean`

isDisabled

public final boolean isDisabled ()

Restituisce True se l'intero oggetto è disattivato (salta sia la configurazione che l'eliminazione). Falso negli altri casi.

Resi
`boolean`

isDisabledReceiver

public boolean isDisabledReceiver ()

Indica se IDeviceActionReceiver è disattivato o meno.

Resi
`boolean`	restituisce true se disattivato, false in caso contrario.

logAssociation

public final void logAssociation (String dataName, 
                LogFile logFile)

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

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

onTestAssumptionFailure

public 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` contenente i dati per lo scenario di test.
`test`	`TestDescription`: il `TestDescription` dello scenario di test in corso.

Genera
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics)

Callback al termine di uno scenario di test. Questo dovrebbe essere il momento di liberare spazio.

Parametri
`testData`	`DeviceMetricData`: il `DeviceMetricData` contenente i dati per lo scenario di test. Sarà lo stesso oggetto di `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: la mappa attuale delle metriche trasmesse a `testEnded(TestDescription,Map)`.

Genera
`DeviceNotAvailableException`

onTestEnd

public void onTestEnd (DeviceMetricData testData, 
                Map<String, MetricMeasurement.Metric> currentTestCaseMetrics, 
                TestDescription test)

Callback al termine di uno scenario di test. Questo dovrebbe essere il momento di liberare spazio.

Parametri
`testData`	`DeviceMetricData`: il `DeviceMetricData` contenente i dati per lo scenario di test. Sarà lo stesso oggetto di `onTestStart(DeviceMetricData)`.
`currentTestCaseMetrics`	`Map`: la mappa attuale delle metriche trasmesse a `testEnded(TestDescription,Map)`.
`test`	`TestDescription`: il `TestDescription` dello scenario di test in corso.

Genera
`DeviceNotAvailableException`

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Callback quando uno scenario di test non riesce.

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

Genera
`DeviceNotAvailableException`

onTestModuleEnded

public void onTestModuleEnded ()

Consente di acquisire l'evento di fine del modulo.

Genera
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Consente di acquisire l'evento di avvio del modulo.

Genera
`DeviceNotAvailableException`

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                Map<String, MetricMeasurement.Metric> currentRunMetrics)

Callback al termine di un test. Questo dovrebbe essere il momento di liberare spazio.

Parametri
`runData`	`DeviceMetricData`: il `DeviceMetricData` contenente i dati per l'esecuzione. Sarà lo stesso oggetto di `onTestRunStart(DeviceMetricData)`.
`currentRunMetrics`	`Map`: la mappa attuale delle metriche trasmesse a `testRunEnded(long,Map)`.

Genera
`DeviceNotAvailableException`

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Callback per gli eventi testRunFailed

Genera
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

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.

Genera
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

Callback quando viene avviato uno scenario di test.

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

Genera
`DeviceNotAvailableException`

rebootEnded

public void rebootEnded (ITestDevice device)

Riceve una notifica quando il riavvio è terminato sul dispositivo.

NOTA: i ricevitori devono evitare di riavviare il dispositivo durante questo callback. Qualsiasi tentativo di riavvio verrà ignorato.

Parametri
`device`	`ITestDevice`: `ITestDevice` in cui è terminato il riavvio.

Genera
`DeviceNotAvailableException`

rebootStarted

public void rebootStarted (ITestDevice device)

Riceve una notifica quando il riavvio è iniziato sul dispositivo.

NOTA: i ricevitori devono evitare di riavviare il dispositivo durante questo callback. Qualsiasi tentativo di riavvio verrà ignorato.

Parametri
`device`	`ITestDevice`: `ITestDevice` in cui è iniziato il riavvio.

Genera
`DeviceNotAvailableException`

setAlwaysOnCollectionLevel

public void setAlwaysOnCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Imposta il livello a cui l'agente di raccolta deve raccogliere i log indipendentemente dagli errori.

Il livello NULL non comporterà alcuna raccolta.

Parametri
`level`	`IMetricCollector.MetricCollectionLevel`: `MetricCollectionLevel` in cui verranno raccolti i log.

setDisable

public final void setDisable (boolean isDisabled)

Imposta se l'oggetto deve essere disattivato. Disattivato significa che i passaggi di configurazione e smontaggio devono essere ignorati. Può essere utilizzato per disattivare un oggetto per impostazione predefinita nel costruttore predefinito.

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

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

Specifica se IDeviceActionReceiver deve essere disattivato. Se lo disattivi, non verrà registrato sul dispositivo per la ricezione di eventi di azione del dispositivo.

Parametri
`isDisabled`	`boolean`

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

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

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

setModuleContainsFailure

public void setModuleContainsFailure ()

Indica se il modulo ha avuto errori (scenario di test, esecuzione del test).

setOnFailureCollectionLevel

public void setOnFailureCollectionLevel (IMetricCollector.MetricCollectionLevel level)

Imposta il livello a cui l'agente di raccolta deve raccogliere i log durante gli errori.

Il livello NULL non comporterà alcuna raccolta.

Parametri
`level`	`IMetricCollector.MetricCollectionLevel`: `MetricCollectionLevel` in cui verranno raccolti i log.

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Chiamato quando un test atomico segnala che presuppone una condizione falsa

Parametri
`test`	`TestDescription`: identifica il test
`trace`	`String`: analisi dello stack dell'errore

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Chiamato quando un test atomico segnala che presuppone una condizione falsa

Parametri
`test`	`TestDescription`: identifica il test
`failure`	`FailureDescription`: `FailureDescription` che descrive l'errore e il relativo contesto.

testEnded

public final void testEnded (TestDescription test, 
                long endTime, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Alternativa a testEnded(TestDescription,Map) in cui possiamo specificare direttamente l'ora di fine. Combina con testStarted(TestDescription,long) per una misurazione accurata.

Parametri
`test`	`TestDescription`: identifica il test
`endTime`	`long`: l'ora in cui è terminato il test, misurata tramite `System.currentTimeMillis()`
`testMetrics`	`HashMap`: un `Map` delle metriche emesse

testEnded

public final void testEnded (TestDescription test, 
                HashMap<String, MetricMeasurement.Metric> testMetrics)

Segnala la fine dell'esecuzione di un singolo scenario di test.

Se testFailed(TestDescription, FailureDescription) non è stato richiamato, questo test è stato superato. Restituisce anche eventuali metriche chiave/valore che potrebbero essere state emesse durante l'esecuzione dello scenario di test.

Parametri
`test`	`TestDescription`: identifica il test
`testMetrics`	`HashMap`: un `Map` delle metriche emesse

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Segnala l'esito negativo di un singolo test case.

Verrà chiamato tra testStarted e testEnded.

Parametri
`test`	`TestDescription`: identifica il test
`failure`	`FailureDescription`: `FailureDescription` che descrive l'errore e il relativo contesto.

testFailed

public final void testFailed (TestDescription test, 
                String trace)

Segnala l'esito negativo di un singolo test case.

Verrà chiamato tra testStarted e testEnded.

Parametri
`test`	`TestDescription`: identifica il test
`trace`	`String`: analisi dello stack dell'errore

testIgnored

public final void testIgnored (TestDescription test)

Chiamato quando un test non verrà eseguito, in genere perché un metodo di test è annotato con org.junit.Ignore.

Parametri
`test`	`TestDescription`: identifica il test

testLog

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

Fornisce i dati di log o di debug associati dall'invocazione del test.

Deve essere chiamato prima del giorno ERROR(ITestInvocationListener.invocationFailed(Throwable)/ITestInvocationListener#invocationFailed(java.lang.Throwable) ITestInvocationListener.invocationFailed(Throwable)) o del giorno ERROR(/ITestInvocationListener#invocationEnded(long))

Il framework TradeFederation chiamerà automaticamente questo metodo, fornendo il log host e, se applicabile, il logcat del dispositivo.

Parametri
`dataName`	`String`: un nome descrittivo dei dati, ad esempio "device_logcat".`String` Nota dataName potrebbe non essere univoco per invocazione. Ad esempio, 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. I chiamanti devono assicurarsi che l'origine dei dati rimanga presente e accessibile fino al completamento del metodo testLog.

testLogSaved

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

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

Parametri
`dataName`	`String`: un nome descrittivo dei dati, ad esempio "device_logcat".`String` Nota dataName potrebbe non essere univoco per invocazione. Ad esempio, 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.

testModuleEnded

public final void testModuleEnded ()

Segnala la fine dell'esecuzione di un modulo.

testModuleStarted

public final void testModuleStarted (IInvocationContext moduleContext)

Indica l'inizio dell'esecuzione di un modulo. Questo callback è associato a testModuleEnded() ed è facoltativo nella sequenza. Viene utilizzato solo durante una corsa che utilizza moduli: runner basati su suite.

Parametri
`moduleContext`	`IInvocationContext`: il `IInvocationContext` del modulo.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                HashMap<String, MetricMeasurement.Metric> runMetrics)

Segnala la fine dell'esecuzione del test. FIXME: We cannot have two Map<> interfaces with different type, so we have to use HashMap here.

Parametri
`elapsedTime`	`long`: tempo trascorso segnalato dal dispositivo, in millisecondi
`runMetrics`	`HashMap`: coppie chiave-valore riportate alla fine di un'esecuzione del test con `Metric`.

testRunFailed

public final void testRunFailed (FailureDescription failure)

L'esecuzione di test dei report non è stata completata a causa di un errore descritto da FailureDescription.

Parametri
`failure`	`FailureDescription`: `FailureDescription` che descrive l'errore e il relativo contesto.

testRunFailed

public final void testRunFailed (String errorMessage)

L'esecuzione del test dei report non è stata completata a causa di un errore irreversibile.

Parametri
`errorMessage`	`String`: `String` che descrive il motivo dell'errore di esecuzione.

testRunStarted

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

Segnala l'inizio di un'esecuzione di test.

Parametri
`runName`	`String`: il nome dell'esecuzione di test
`testCount`	`int`: numero totale di test nell'esecuzione del test
`attemptNumber`	`int`: numero d'ordine, che identifica i diversi tentativi dello stesso runName eseguiti più volte. attemptNumber è indicizzato a 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene ritentato in modo granulare 3 volte, deve avere 4 esecuzioni totali con lo stesso runName e attemptNumber va da 0 a 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Test run callbacks

Parametri
`runName`	`String`: il nome dell'esecuzione di test
`testCount`	`int`: numero totale di test nell'esecuzione del test

testRunStarted

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

Segnala l'inizio di un'esecuzione di test.

Parametri
`runName`	`String`: il nome dell'esecuzione di test
`testCount`	`int`: numero totale di test nell'esecuzione del test
`attemptNumber`	`int`: numero d'ordine, che identifica i diversi tentativi dello stesso runName eseguiti più volte. attemptNumber è indicizzato a 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene ritentato in modo granulare 3 volte, deve avere 4 esecuzioni totali con lo stesso runName e attemptNumber va da 0 a 3.
`startTime`	`long`: l'ora di inizio della corsa, misurata tramite `System.currentTimeMillis()`

testRunStopped

public final void testRunStopped (long elapsedTime)

L'esecuzione di prova dei report è stata interrotta prima del completamento a causa di una richiesta dell'utente.

TODO: currently unused, consider removing

Parametri
`elapsedTime`	`long`: tempo trascorso segnalato dal dispositivo, in millisecondi

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

Chiamato quando un test viene ignorato e non eseguito per un motivo insolito. Verrà effettuato un nuovo tentativo di esecuzione di questi test.

Parametri
`test`	`TestDescription`: identifica il test
`reason`	`SkipReason`: `SkipReason`

testStarted

public final void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(TestDescription), in cui specifichiamo anche quando è iniziato il test, combinata con testEnded(TestDescription,long,Map) per una misurazione accurata.

Parametri
`test`	`TestDescription`: identifica il test
`startTime`	`long`: l'ora di inizio del test, misurata tramite `System.currentTimeMillis()`

testStarted

public final void testStarted (TestDescription test)

Callback degli scenari di test

Parametri
`test`	`TestDescription`: identifica il test