BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

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

Classi di sottoclasse dirette note AtraceCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, GcovCodeCoverageCollector, GcovKernelCodeCoverageCollector, HostStatsdMetricCollector, JavaCodeCoverageCollector, LogcatOnFailureCollector, LogcatTimingMetricCollector, RebootReasonCollector, RuntimeRestartCollector, ScreenshotOnFailureCollector AtraceCollector Un IMetricCollector che esegue atrace durante un test e raccoglie il risultato e lo registra nell'invocazione.  BugreportzOnFailureCollector Raccogliere una segnalazione di bug quando uno scenario di test non va a buon fine.  BugreportzOnTestCaseFailureCollector Raccogli una segnalazione di bug quando uno scenario di test in un'esecuzione ha esito negativo.  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.  DeviceTraceCollector Raccogli dati che avvia la traccia di Perfetto all'avvio di un test e registra il file di traccia alla fine.  FilePullerDeviceMetricCollector Un BaseDeviceMetricCollector che ascolta la chiave delle metriche proveniente dal dispositivo e le estrae come file dal dispositivo.  GcovCodeCoverageCollector Un BaseDeviceMetricCollector che estrarrà le misurazioni di copertura gcov dal dispositivo e le registri come artefatti di test.  GcovKernelCodeCoverageCollector Un BaseDeviceMetricCollector che estrae le misurazioni della copertura del kernel gcov da debugfs e dal dispositivo e poi le registra come elementi di test.  HostStatsdMetricCollector Un IMetricCollector che raccoglie le metriche StatsD lato host utilizzando i comandi della utility StatsD.  JavaCodeCoverageCollector Un BaseDeviceMetricCollector che estrarrà le misurazioni della copertura Java dal dispositivo e le registri come artefatti di test.  LogcatOnFailureCollector Raccogli dati che acquisisce e registra un logcat quando uno scenario di test non va a buon fine.  LogcatTimingMetricCollector Un raccoglitore di metriche che raccoglie informazioni sui tempi (ad es. ora di passaggio dell'utente) da logcat durante uno o più test ripetuti utilizzando determinati pattern regex per analizzare gli indicatori di inizio e fine di un evento dalle righe di logcat.  RebootReasonCollector Raccogli i riavvii del dispositivo durante l'esecuzione del test e genera un report in base al motivo e al numero.  RuntimeRestartCollector Raccoglitore che raccoglie i timestamp dei riavvii di runtime (arresti anomali del server di sistema) durante l'esecuzione del test, se presenti.  ScreenshotOnFailureCollector Raccoglitore che acquisisce e registra uno screenshot quando uno scenario di test non va a buon fine.

Classi di sottoclasse indirette note AtraceRunMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, ModuleLogcatCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector, TraceCmdCollector AtraceRunMetricCollector Raccoglie dal dispositivo di test le tracce di tutta la directory di test nella directory specificata, registra la directory di test e post-elabora i file di traccia nella directory di test e aggrega le metriche.  BluetoothConnectionLatencyCollector Il collector invierà ai dispositivi una configurazione della metrica della durata di statsd predefinita e raccoglierà la durata della connessione Bluetooth per ogni profilo.  BluetoothConnectionStateCollector Questo raccoglitore raccoglierà le metriche BluetoothConnectionStateChanged e registrerà il numero di stato della connessione per ogni profilo.  BluetoothHciSnoopLogCollector Raccogliere per attivare la registrazione di analisi HCI Bluetooth sul DUT e raccogliere il log per ogni test.  FilePullerLogCollector Logger del file segnalato dal lato del dispositivo.  ModuleLogcatCollector Versione del raccoglitore logcat, ma per il modulo.  PerfettoPullerMetricCollector Implementazione di base di FilePullerDeviceMetricCollector che consente di recuperare i file di perfetto dal dispositivo e di raccogliere le metriche.  ShowmapPullerMetricCollector Implementazione di base di FilePullerDeviceMetricCollector che consente di estrarre i file della mappa del programma dal dispositivo e di raccogliere le metriche.  TraceCmdCollector Un IMetricCollector che raccoglie le tracce durante il test utilizzando trace-cmd e le registra nell'invocazione.

---

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
void	extraInit(IInvocationContext context, ITestInvocationListener listener)
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 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.
final ITestInvocationListener	init(IInvocationContext context, ITestInvocationListener listener) Inizializzazione del raccoglitore con il contesto attuale e dove inoltrare i risultati.
final void	invocationEnded(long elapsedTime) Segnala che la chiamata è stata terminata, correttamente o a causa di una condizione di errore.
final void	invocationFailed(FailureDescription failure) Segnala una chiamata incompleta a causa di alcune condizioni di errore.
final void	invocationFailed(Throwable cause) Segnala un'invocazione 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 il trasferimento
final boolean	isDisabled() Restituisce True se l'intero oggetto è disabilitato (salta la configurazione e lo smantellamento).
boolean	isDisabledReceiver() Indica se IDeviceActionReceiver è disattivato o meno.
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 ha esito negativo con errore del presupposto.
void	onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test) Viene richiamato quando viene terminato uno scenario di test.
void	onTestEnd(DeviceMetricData testData, currentTestCaseMetrics) Richiamo al termine di un test case.
void	onTestFail(DeviceMetricData testData, TestDescription test) Viene richiamato quando uno scenario di test ha esito negativo.
void	onTestModuleEnded() Consente di acquisire l'evento di fine del modulo.
void	onTestModuleStarted() Consente di acquisire l'evento di inizio del modulo.
void	onTestRunEnd(DeviceMetricData runData, currentRunMetrics) Esegue il 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) Viene richiamato quando viene avviato uno scenario di test.
void	rebootEnded(ITestDevice device) Riceve una notifica al termine del riavvio sul dispositivo.
void	rebootStarted(ITestDevice device) Riceve una notifica all'avvio del riavvio nel dispositivo.
final void	setDisable(boolean isDisabled) Consente di impostare se l'oggetto deve essere disabilitato.
void	setDisableReceiver(boolean isDisabled) Imposta se IDeviceActionReceiver deve essere disattivato.
final void	setLogSaver(ILogSaver logSaver) Non utilizzare l'implementazione interna del raccoglitore delle metriche.
final void	testAssumptionFailure(TestDescription test, String trace) Viene chiamato quando un test atomico segnala che presuppone una condizione falsa
final void	testAssumptionFailure(TestDescription test, FailureDescription failure) Viene 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'errore di un singolo scenario di test.
final void	testFailed(TestDescription test, String trace) Segnala l'errore di un singolo test case.
final void	testIgnored(TestDescription test) Viene 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 all'interno dell'implementazione del raccoglitore delle metriche.
final void	testModuleEnded() Segnala la fine dell'esecuzione di un modulo.
final void	testModuleStarted(IInvocationContext moduleContext) Segnala 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 del test dei report non è riuscita a causa di un errore descritto da FailureDescription.
final void	testRunFailed(String errorMessage) L'esecuzione del test dei report non è riuscita a causa di un errore fatale.
final void	testRunStarted(String runName, int testCount, int attemptNumber) Segnala l'inizio di un'esecuzione del test.
final void	testRunStarted(String runName, int testCount) Callback esecuzione di test
final void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Segnala l'inizio di un'esecuzione del test.
final void	testRunStopped(long elapsedTime) Esecuzione di test dei report interrotta prima del completamento a causa di una richiesta dell'utente.
final void	testSkipped(TestDescription test, SkipReason reason) Richiamato quando un test viene ignorato e non è stato eseguito per un motivo solitamente non previsto.
final void	testStarted(TestDescription test, long startTime) Alternativa a testStarted(com.android.tradefed.result.TestDescription) in cui viene specificato anche quando è stato avviato 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

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

extraInit

public void extraInit (IInvocationContext context, 
                ITestInvocationListener listener)

Lanci
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBuildInfos

public final  getBuildInfos ()

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

Ritorni

getDispositivi

public final  getDevices ()

Restituisce l'elenco di dispositivi disponibili nella chiamata.

Ritorni

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

Recupera il file dagli artefatti di test o dagli artefatti 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 dell'artefatto di test o 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 attuale di test.

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inizializzazione del raccoglitore con il contesto corrente e dove inoltrare i risultati. Verrà chiamato solo una volta per istanza e il raccoglitore deve aggiornare il proprio contesto e ascoltatore interno. Il comando Init non verrà mai chiamato in precedenza durante l'esecuzione di un test.

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: l'ITestInvocationListener in cui inserire i risultati.

Ritorni
ITestInvocationListener	il nuovo ascoltatore che avvolge quello originale.

Lanci
DeviceNotAvailableException

chiamata terminata

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 della chiamata in ms

chiamata non riuscita

public final void invocationFailed (FailureDescription failure)

Segnala un'invocazione incompleta a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

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

invocationFailed

public final void invocationFailed (Throwable cause)

Segnala una chiamata incompleta a causa di alcune condizioni 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 il trasferimento

Parametri
context	IInvocationContext: informazioni sull'invocazione

isDisabled

public final boolean isDisabled ()

Restituisce True se l'intero oggetto è disabilitato (saltano configurazione ed 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 all'interno dell'implementazione del raccoglitore delle metriche. Si tratta di un semplice inoltro.

Parametri
dataName	String: il nome dei dati
logFile	LogFile: il LogFile registrato in precedenza e da associare al test case.

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.

Lanci
DeviceNotAvailableException

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	: mappa attuale delle metriche passate a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)).
test	TestDescription: il valore TestDescription dello scenario di test in corso.

Lanci
DeviceNotAvailableException

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 che conserva i dati per lo scenario di test. Sarà lo stesso oggetto di onTestStart(com.android.tradefed.device.metric.DeviceMetricData).
currentTestCaseMetrics	: la mappa corrente delle metriche passate a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)).

Lanci
DeviceNotAvailableException

onTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Viene richiamato quando uno scenario di test ha esito negativo.

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

Lanci
DeviceNotAvailableException

onTestModuloTerminato

public void onTestModuleEnded ()

Consente di acquisire l'evento di fine del modulo.

Lanci
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

Consente di acquisire l'evento di inizio del modulo.

Lanci
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

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

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

Lanci
DeviceNotAvailableException

OnTestRunNon riuscito

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Callback per gli eventi testRunFailed

Lanci
	com.android.tradefed.device.DeviceNotAvailableEccezione
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.

Lanci
DeviceNotAvailableException

onTestStart

public void onTestStart (DeviceMetricData testData)

Richiamo quando viene avviato un caso di test.

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

Lanci
DeviceNotAvailableException

rebootEnded

public void rebootEnded (ITestDevice device)

Riceve una notifica al termine del riavvio sul dispositivo.

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

Parametri
device	ITestDevice: ITestDevice dove è terminato il riavvio.

Lanci
DeviceNotAvailableException

rebootStarted

public void rebootStarted (ITestDevice device)

Riceve una notifica quando viene avviato il riavvio del dispositivo.

NOTA: i ricevitori dovrebbero evitare di riavviarsi durante la richiamata. Qualsiasi tentativo di riavvio verrà ignorato.

Parametri
device	ITestDevice: ITestDevice in cui è stato avviato 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 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.

setDisableReceiver

public void setDisableReceiver (boolean isDisabled)

Imposta se IDeviceActionReceiver deve essere disattivato. Se viene disattivata, non verrà registrata sul dispositivo per la ricezione di eventi di azioni del dispositivo.

Parametri
isDisabled	boolean

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Non utilizzare l'implementazione interna del raccoglitore delle metriche. Questo è puro forwarding.

Parametri
logSaver	ILogSaver: ILogSaver

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

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

Viene 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 il termine dell'esecuzione di un singolo test case.

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

Parametri
test	TestDescription: identifica il test
testMetrics	: un ERROR(/Map) delle metriche emesse

testFailed

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Segnala l'errore di un singolo scenario 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'errore di un singolo scenario di test.

Verrà chiamato tra testStarted e testEnded.

Parametri
test	TestDescription: identifica il test
trace	String: analisi dello stack degli errori

testIgnored

public final void testIgnored (TestDescription test)

Viene 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 dalla chiamata di test.

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

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

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

TestLogSalvato

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: un nome descrittivo String dei dati, ad esempio "device_logcat". Nota: il nome dataName potrebbe non essere univoco per ogni chiamata. Ad esempio, gli implementatori devono essere in grado di gestire più chiamate con lo stesso nome 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 InputStream risultante al termine.
logFile	LogFile: il valore LogFile contenente i metadati del file salvato.

testModuleEnded

public final void testModuleEnded ()

Segnala la fine dell'esecuzione di un modulo.

testModuloIniziato

public final void testModuleStarted (IInvocationContext moduleContext)

Segnala l'inizio dell'esecuzione di un modulo. Questo callback è associato a testModuleEnded() ed è facoltativo nella sequenza. Viene utilizzato solo durante un'esecuzione che utilizza i 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 sul dispositivo segnalato, in millisecondi
runMetrics	: coppie chiave-valore registrate al termine di un'esecuzione del test

testRunFailed

public final void testRunFailed (FailureDescription failure)

L'esecuzione del test dei report non è riuscita 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 è riuscita 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 del 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. Il numero di tentativi è indicizzato da 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene riavviato granularmente 3 volte, deve avere 4 esecuzioni totali con lo stesso nome esecuzione e il numero di tentativi va da 0 a 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Callback di esecuzione del test

Parametri
runName	String: il nome dell'esecuzione del 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 del test.

Parametri
runName	String: il nome dell'esecuzione del 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. Il valore attemptNumber è indicizzato da 0 e deve aumentare ogni volta che viene eseguita una nuova esecuzione. Ad esempio, un test viene riavviato granularmente 3 volte, deve avere 4 esecuzioni totali con lo stesso nome runName e il valore attemptNumber deve essere compreso tra 0 e 3.
startTime	long: l'ora di inizio dell'esecuzione, misurata tramite System.currentTimeMillis()

testRunArrestato

public final void testRunStopped (long elapsedTime)

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

DA FARE: attualmente inutilizzato, valuta la possibilità di rimuoverlo

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

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

Viene chiamato quando un test viene saltato e non viene eseguito per un motivo in genere imprevisto. Verrà tentato di ripetere questi test per ottenere un'esecuzione corretta.

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 viene specificato anche quando è stato avviato 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 in cui è iniziato il test, misurata tramite System.currentTimeMillis()

testStarted

public final void testStarted (TestDescription test)

Callback degli scenari di test

Parametri
test	TestDescription: identifica il test