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.

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

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

Sottoclassi dirette note

AtraceCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, GcovCodeCoverageCollector, GcovKernelCodeCoverageCollector, HostStatsdMetricCollector, JavaCodeCoverageCollector, LogcatOnFailureCollector, LogcatTimingMetricCollector, RebootReasonCollector, RuntimeRestartCollector, ScreenshotOnFailureCollector

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

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	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.
FilePullerLogCollector	Logger del file segnalato dal lato dispositivo.
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)`.
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.

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

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

Costruttori pubblici
`BaseDeviceMetricCollector()`

Metodi pubblici
`void`	`extraInit(IInvocationContext context, ITestInvocationListener listener)`
`final`	`getBuildInfos()` Restituisce l'elenco delle informazioni sulla build disponibili nella chiamata.
`final`	`getDevices()` Restituisce l'elenco dei dispositivi disponibili nell'invocazione.
`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()`
`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.
`String`	`getTestName()` Restituisce il nome del test `mTestName` che attiva il raccoglitore.
`final ITestInvocationListener`	`init(IInvocationContext context, ITestInvocationListener listener)` Inizializzazione del raccoglitore con il contesto corrente e la destinazione di inoltro dei risultati.
`final void`	`invocationEnded(long elapsedTime)` Segnala 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
`final boolean`	`isDisabled()` Restituisce True se l'intero oggetto è disattivato (vengono ignorati 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, currentTestCaseMetrics, TestDescription test)` Callback al termine di uno scenario di test.
`void`	`onTestEnd(DeviceMetricData testData, currentTestCaseMetrics)` 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, currentRunMetrics)` Callback quando un test viene terminato.
`void`	`onTestRunFailed(DeviceMetricData testData, FailureDescription failure)` Callback per gli eventi testRunFailed
`void`	`onTestRunStart(DeviceMetricData runData)` Callback quando viene avviata una prova.
`void`	`onTestStart(DeviceMetricData testData)` Callback quando viene avviato un caso 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.
`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.
`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, testMetrics)` Alternativa a `ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map))` in cui possiamo specificare direttamente l'ora di fine.
`final void`	`testEnded(TestDescription test, 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 caso di test.
`final void`	`testFailed(TestDescription test, String trace)` Segnala l'esito negativo di un singolo caso di test.
`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, 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 del 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 del 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(com.android.tradefed.result.TestDescription)`, in cui specifichiamo anche quando è iniziato il test, combinata con `ERROR(/#testEnded(com.android.tradefed.result.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

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

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

getBuildInfos

public final  getBuildInfos ()

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

Ritorni

getDevices

public final  getDevices ()

Restituisce l'elenco dei dispositivi disponibili nell'invocazione.

Ritorni

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

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

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

Ritorni
`File`	File dell'artefatto di test o dell'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`

getModuleName

public String getModuleName ()

Ritorni
`String`

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.

getTestName

public String getTestName ()

Restituisce il nome del test mTestName che attiva il raccoglitore.

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

init

public final 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`

invocationEnded

public final void invocationEnded (long elapsedTime)

Segnala 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

isDisabled

public final boolean isDisabled ()

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

Ritorni
`boolean`

isDisabledReceiver

public boolean isDisabledReceiver ()

Indica se IDeviceActionReceiver è disattivato o meno.

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

Lanci
`DeviceNotAvailableException`

onTestEnd

public 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 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 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
`DeviceNotAvailableException`

onTestModuleStarted

public void onTestModuleStarted ()

Consente di acquisire l'evento di avvio del modulo.

Lanci
`DeviceNotAvailableException`

onTestRunEnd

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

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Callback per gli eventi testRunFailed

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

onTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Callback quando viene avviata una prova.

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

Lanci
`DeviceNotAvailableException`

onTestStart

public void onTestStart (DeviceMetricData testData)

Callback quando viene avviato un caso di test.

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

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

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

Lanci
`DeviceNotAvailableException`

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 smontaggio devono essere ignorati. Può essere utilizzato per disabilitare 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`

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, 
                 testMetrics)

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) in cui possiamo specificare direttamente l'ora di fine. Combina con testStarted(com.android.tradefed.result.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`	: un `ERROR(/Map)` delle metriche emesse

testEnded

public final void testEnded (TestDescription test, 
                 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`	: un `ERROR(/Map)` delle metriche emesse

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Segnala l'esito negativo di un singolo caso di test.

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 caso di test.

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)) 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 `String` dei dati, ad es. "device_logcat". Nota dataName potrebbe non essere univoco per invocazione. Ciò significa che 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 `String` dei dati, ad es. "device_logcat". Nota dataName potrebbe non essere univoco per invocazione. Ciò significa che 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 un'esecuzione che utilizza moduli: runner basati su suite.

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

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Segnala la fine dell'esecuzione del test.

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

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

Parametri
`runName`	`String`: il nome dell'esecuzione di test
`testCount`	`int`: numero totale di test nell'esecuzione di 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 riprovato 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 di test

testRunStarted

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

Segnala l'inizio di un'esecuzione del test.

Parametri
`runName`	`String`: il nome dell'esecuzione di test
`testCount`	`int`: numero totale di test nell'esecuzione di 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 in cui è iniziata la 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: attualmente non utilizzato, valuta la possibilità di rimuoverlo

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(com.android.tradefed.result.TestDescription), in cui specifichiamo anche quando è iniziato il test, combinata con ERROR(/#testEnded(com.android.tradefed.result.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