BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IDeviceActionReceiver, IMetricCollector

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

Sottoclassi dirette note .Bugreportz. ; AtraceCollector Un IMetricCollector che esegue un atrace durante un test e raccoglie il risultato e il log alla chiamata.  BugreportzOnFailureCollector Raccogli una segnalazione di bug quando uno scenario di test ha esito negativo.  BugreportzOnTestCaseFailureCollector Raccogli una segnalazione di bug quando uno scenario di test in un'esecuzione ha esito negativo.  ClangCodeCoperturaCollector Un BaseDeviceMetricCollector che estrarrà Clang le misurazioni di copertura dal dispositivo e le registrano come artefatti di test.  CountTestCasesCollector Conteggia e segnala il numero di scenari di test per un determinato IRemoteTest.  DebugHostLogOnFailureCollector Il raccoglitore che raccoglierà e registrerà i log del lato host quando si verifica un errore dello scenario di test.  DeviceTraceCollector Il raccoglitore che avvierà l'analisi perfetta all'avvio di un test e il file di traccia del log alla fine.  FilePullerDeviceMetricCollector Un BaseDeviceMetricCollector che ascolta la chiave delle metriche proveniente dal dispositivo ed esegue il pull come file dal dispositivo.  GcovCodeCoperturaCollector Un BaseDeviceMetricCollector che eseguirà il pull dei gcov le misurazioni di copertura dal dispositivo e le registrano come artefatti di test.  GcovKernelCodeReachCollector Un BaseDeviceMetricCollector che eseguirà il pull del kernel gcov misurazioni della copertura dai debug e dal dispositivo e alla fine le registra come test artefatti.  HostStatsdMetricCollector Un IMetricCollector che raccoglie le metriche statistiche dal lato host utilizzando l'utilità Statistiche tramite comandi SQL.  JavaCodeCoperturaCollector Un'BaseDeviceMetricCollector che eseguirà il pull di Java le misurazioni di copertura dal dispositivo e le registrano come artefatti di test.  LogcatOnFailureCollector Raccoglitore che acquisirà e registra un logcat quando uno scenario di test ha esito negativo.  LogcatTimingMetricCollector Un raccoglitore di metriche che raccoglie informazioni sulle tempistiche (ad es. l'ora di cambio dell'utente) da logcat durante uno o più test ripetuti utilizzando determinati pattern regex per analizzare gli indicatori di inizio e fine di un dell'evento dalle righe logcat.  RiavviaReasonCollector Il raccoglitore che raccoglie il riavvio del dispositivo durante l'esecuzione del test e li segnala per motivo e conteggi.  RuntimeRiavviaCollector Raccoglitore che raccoglie i timestamp dei riavvii del runtime (arresti anomali del server di sistema) durante il test se ce ne sono.  ScreenshotOnFailureCollector Il raccoglitore che acquisirà e registrerà uno screenshot quando uno scenario di test non va a buon fine.

Sottoclassi indirette note AtraceRunMetricCollector, BluetoothConnectionLatenzaCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, FilePullerLogCollector, ModuleLogcatCollector, PerfettoPullerMetricCollector, ShowmapPullerMetricCollector, 17Trace17Trace AtraceRunMetricCollector Raccoglie le tracce da tutta la directory di test nella directory specificata dal dispositivo di test, registrare la directory di test e pubblicare i file di traccia nella directory di test e aggregare le metriche.  BluetoothConnectionLatenzaCollector Il raccoglitore invierà ai dispositivi una configurazione predefinita della metrica relativa alla durata delle statistiche e raccoglierà Durata della connessione Bluetooth per ogni profilo.  BluetoothConnectionStateCollector Questo raccoglitore raccoglierà le metriche BluetoothConnectionStateChanged e registrerà lo stato di connessione numero per ogni profilo.  BluetoothHciSnoopLogCollector Collettore per abilitare il logging di analisi HCI Bluetooth sul DUT e raccogliere il registro per ogni test.  FilePullerLogCollector Logger del file segnalato dal lato dispositivo.  ModuleLogcatCollector Versione del raccoglitore logcat ma per il modulo.  PerfettoPullerMetricCollector Implementazione di base di FilePullerDeviceMetricCollector che consente estrarre i file perfetti dal dispositivo e raccogliere le metriche al suo interno.  ShowmapPullerMetricCollector Implementazione di base di FilePullerDeviceMetricCollector che consente di estrarre la showmap i file dal dispositivo e raccoglierne le metriche.  TraceCmdCollector Un IMetricCollector che raccoglie le tracce durante il test utilizzando trace-cmd e le registra in la chiamata.

---

Base dell'implementazione 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 di informazioni sulla build disponibili nella chiamata.
final	getDevices() Restituisce l'elenco di dispositivi disponibili nella chiamata.
File	getFileFromTestArtifacts(String fileName) Recupera il file dagli artefatti di test o dagli artefatti del modulo e dalla cache in una mappa per le chiamate successive.
final ITestInvocationListener	getInvocationListener() Restituisce il valore ITestInvocationListener originale a cui inoltriamo i risultati.
String	getModuleName()
final	getRealDevices() Restituisce tutti i dispositivi non testati dall'elenco getDevices().
String	getRunName() Restituisce il nome dell'esecuzione di 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) Report che la chiamata è stata terminata, correttamente o a causa di un errore .
final void	invocationFailed(FailureDescription failure) Segnala una chiamata incompleta a causa di alcune condizioni di errore.
final void	invocationFailed(Throwable cause) Segnala una chiamata incompleta a causa di alcune condizioni di errore.
void	invocationSkipped(SkipReason reason) Segnala una chiamata come saltata
final void	invocationStarted(IInvocationContext context) Listener di chiamata per l'inoltro
final boolean	isDisabled() Restituisce True se l'intero oggetto è disabilitato (saltano configurazione ed eliminazione).
boolean	isDisabledReceiver() Indica se IDeviceActionReceiver è disattivato o meno.
final void	logAssociation(String dataName, LogFile logFile) Non utilizzare all'interno dell'implementazione del raccoglitore 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) Viene richiamato quando viene terminato uno scenario di test.
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 modulo.
void	onTestModuleStarted() Consente di acquisire l'evento di modulo avviato.
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) Esegui il callback quando viene avviata l'esecuzione di un 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) Consente di impostare se IDeviceActionReceiver deve essere disattivato.
final void	setLogSaver(ILogSaver logSaver) Non utilizzare all'interno dell'implementazione del raccoglitore metriche.
final void	testAssumptionFailure(TestDescription test, String trace) Richiamato quando un test atomico segnala che assume una condizione falsa
final void	testAssumptionFailure(TestDescription test, FailureDescription failure) Richiamato quando un test atomico segnala che assume una condizione falsa
final void	testEnded(TestDescription test, long endTime, testMetrics) Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) in cui è possibile specificare l'ora di fine strato Add.
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 scenario di test.
final void	testIgnored(TestDescription test) Richiamato quando non verrà eseguito un test, in genere perché un metodo di test è annotato con org.junit.Ignora.
final void	testLog(String dataName, LogDataType dataType, InputStreamSource dataStream) Fornisce i dati di log o di debug associati dalla chiamata di test.
final void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) Non utilizzare all'interno dell'implementazione del raccoglitore metriche.
final void	testModuleEnded() Segnala la fine dell'esecuzione di un modulo.
final void	testModuleStarted(IInvocationContext moduleContext) Segnala l'inizio di un modulo in esecuzione.
final void	testRunEnded(long elapsedTime, runMetrics) Fine dell'esecuzione del test nei report.
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 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) Callback esecuzione di test
final void	testRunStarted(String runName, int testCount, int attemptNumber, long startTime) Segnala l'inizio di un'esecuzione di 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), dove specifichiamo anche quando il test è stato iniziare, combinato 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

OPZIONE_GRUPPO_EXCLUDE_TEST_CASE_EXCLUDE

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

getBuildInfo

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 dalla cache in una mappa per le chiamate successive.

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

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

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

Restituisce il valore ITestInvocationListener originale a cui inoltriamo i risultati.

Ritorni
ITestInvocationListener

getModuleName

public String getModuleName ()

Ritorni
String

getRealDispositivi

public final  getRealDevices ()

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

Ritorni

getRunName

public String getRunName ()

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

Ritorni
String	mRunName, il nome dell'esecuzione attuale di test.

Inizia

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inizializzazione del raccoglitore con il contesto attuale e dove inoltrare i risultati. Marco essere chiamato solo una volta per istanza e il raccoglitore deve aggiornare la sua contesto e listener. Il comando Init non verrà mai chiamato in precedenza durante l'esecuzione di un test.

Non eseguire l'override se non sai che cosa stai facendo.

Parametri
context	IInvocationContext: il IInvocationContext per la chiamata in corso.
listener	ITestInvocationListener: ITestInvocationListener dove inserire i risultati.

Ritorni
ITestInvocationListener	il nuovo listener che aggrega quello originale.

Lanci
DeviceNotAvailableException

chiamata terminata

public final void invocationEnded (long elapsedTime)

Report che la chiamata è stata terminata, correttamente o a causa di un 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 una chiamata incompleta a causa di alcune condizioni di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

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

chiamata non riuscita

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

chiamataIgnorata

public void invocationSkipped (SkipReason reason)

Segnala una chiamata come saltata

Parametri
reason	SkipReason

chiamataIniziata

public final void invocationStarted (IInvocationContext context)

Listener di chiamata per l'inoltro

Parametri
context	IInvocationContext: informazioni sulla chiamata

non è disabilitato

public final boolean isDisabled ()

Restituisce True se l'intero oggetto è disabilitato (saltano configurazione ed eliminazione). Falso negli altri casi.

Ritorni
boolean

isDisabledRicevir

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 metriche. Questo è puro forwarding.

Parametri
dataName	String: il nome dei dati
logFile	LogFile: il valore LogFile registrato in precedenza e che deve essere associato al caso di test.

onTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Callback quando uno scenario di test ha esito negativo con errore del presupposto.

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

Lanci
DeviceNotAvailableException

OnTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

Viene richiamato quando viene terminato uno scenario di test. Questo dovrebbe essere il momento per la pulizia.

Parametri
testData	DeviceMetricData: il DeviceMetricData che conserva i dati per lo scenario di test. Sarà il nello 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)

Viene richiamato quando viene terminato uno scenario di test. Questo dovrebbe essere il momento per la pulizia.

Parametri
testData	DeviceMetricData: il DeviceMetricData che conserva i dati per lo scenario di test. Sarà il nello 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)).

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 valore TestDescription dello scenario di test in corso.

Lanci
DeviceNotAvailableException

onTestModuloTerminato

public void onTestModuleEnded ()

Consente di acquisire l'evento di fine modulo.

Lanci
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

Consente di acquisire l'evento di modulo avviato.

Lanci
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Esegue il callback al termine di un test. Questo dovrebbe essere il momento per la pulizia.

Parametri
runData	DeviceMetricData: il DeviceMetricData che conserva i dati per l'esecuzione. Sarà lo stesso durante onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData).
currentRunMetrics	: mappa attuale 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)

Esegui il callback quando viene avviata l'esecuzione di un test.

Parametri
runData	DeviceMetricData: il DeviceMetricData che conserva i dati per l'esecuzione.

Lanci
DeviceNotAvailableException

onTestStart

public void onTestStart (DeviceMetricData testData)

Viene richiamato quando viene avviato uno scenario di test.

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

Lanci
DeviceNotAvailableException

riavvio terminato

public void rebootEnded (ITestDevice device)

Riceve una notifica al termine del riavvio sul dispositivo.

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

Parametri
device	ITestDevice: ITestDevice dove è terminato il riavvio.

Lanci
DeviceNotAvailableException

riavvioavvio

public void rebootStarted (ITestDevice device)

Riceve una notifica all'avvio del riavvio nel dispositivo.

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

Parametri
device	ITestDevice: ITestDevice in cui è stato avviato il riavvio.

Lanci
DeviceNotAvailableException

impostareDisattiva

public final void setDisable (boolean isDisabled)

Consente di impostare se l'oggetto deve essere disabilitato. Disabilitata significa che sia i passaggi di configurazione che quelli di eliminazione deve essere ignorato. Può essere utilizzato per rendere un oggetto disabilitato per impostazione predefinita come costruttore.

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

setDisattivaRicevitore

public void setDisableReceiver (boolean isDisabled)

Consente di impostare se IDeviceActionReceiver deve essere disattivato. La disattivazione comporta non essere registrati sul dispositivo per ricevere eventi di azioni del dispositivo.

Parametri
isDisabled	boolean

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Non utilizzare all'interno dell'implementazione del raccoglitore metriche. Questo è puro forwarding.

Parametri
logSaver	ILogSaver: ILogSaver

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                String trace)

Richiamato quando un test atomico segnala che assume una condizione falsa

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

testAssumptionFailure

public final void testAssumptionFailure (TestDescription test, 
                FailureDescription failure)

Richiamato quando un test atomico segnala che assume una condizione falsa

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

testTerminato

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

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) in cui è possibile specificare l'ora di fine strato Add. Combinalo 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	: una percentuale pari a ERROR(/Map) delle metriche emesse

testTerminato

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 qualsiasi coppia chiave-valore metriche emesse durante l'esecuzione dello scenario di test.

Parametri
test	TestDescription: identifica il test
testMetrics	: una percentuale pari a ERROR(/Map) delle metriche emesse

testNon riuscito

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.

testNon riuscito

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

testIgnorato

public final void testIgnored (TestDescription test)

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

Parametri
test	TestDescription: identifica il test

Diariotest

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

Fornisce i dati di log o di debug associati dalla chiamata di test.

La chiamata deve essere effettuata prima di ERROR(/ITestInvocationListener#invocationFailed(Throwable)) oppure 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 non può essere univoco per ogni chiamata. ovvero gli implementer devono essere in grado di più chiamate con lo stesso dataName
dataType	LogDataType: il LogDataType dei dati
dataStream	InputStreamSource: il InputStreamSource dei dati. Gli addetti all'implementazione devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere InputStream al termine. I chiamanti devono garantire che l'origine dei dati rimanga e accessibile fino al completamento del metodo testLog.

TestLogSalvato

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

Non utilizzare all'interno dell'implementazione del raccoglitore metriche. Questo è puro forwarding.

Parametri
dataName	String: un nome descrittivo String dei dati. ad es. "device_logcat". Nota dataName non può essere univoco per ogni chiamata. ovvero gli implementer devono essere in grado di più chiamate con lo stesso dataName
dataType	LogDataType: il LogDataType dei dati
dataStream	InputStreamSource: il InputStreamSource dei dati. Gli addetti all'implementazione devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere InputStream al termine.
logFile	LogFile: il valore LogFile contenente i metadati del file salvato.

testModuloTerminato

public final void testModuleEnded ()

Segnala la fine dell'esecuzione di un modulo.

testModuloIniziato

public final void testModuleStarted (IInvocationContext moduleContext)

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

Parametri
moduleContext	IInvocationContext: il IInvocationContext del modulo.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Fine dell'esecuzione del test nei report. FIXME: Non possiamo avere due mappe<> si interfaccia con tipi diversi, dobbiamo usare HashMap qui.

Parametri
elapsedTime	long: tempo trascorso sul dispositivo segnalato, in millisecondi
runMetrics	: coppie chiave-valore segnalate al termine di un'esecuzione di test con Metric.

testRunNon riuscito

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.

testRunNon riuscito

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 dell'esecuzione.

testRunStarted

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

Segnala l'inizio di un'esecuzione di test.

Parametri
runName	String: 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 che vengono eseguite più volte. Il numero tentato è indicizzato a 0 e deve aumentare ogni volta quando si verifica una nuova esecuzione. ad es. Un test viene ripetuto tre volte in modo granulare e dovrebbe avere in totale 4 viene eseguito con lo stesso runName e il numero di tentativi è compreso tra 0 e 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Callback esecuzione di test

Parametri
runName	String: 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 di test.

Parametri
runName	String: 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 che vengono eseguite più volte. Il numero di tentativi è indicizzato a 0 e deve aumentare ogni volta che una nuova esecuzione. ad es. Un test viene ripetuto tre volte in modo granulare e dovrebbe avere in totale 4 esecuzioni. sotto lo stesso runName e il numero tentato è compreso tra 0 e 3.
startTime	long: l'ora di inizio della corsa, misurata tramite System.currentTimeMillis()

testRunArrestato

public final void testRunStopped (long elapsedTime)

Esecuzione di test dei report 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 sul dispositivo segnalato, in millisecondi

testIgnorato

public final void testSkipped (TestDescription test, 
                SkipReason reason)

Richiamato quando un test viene ignorato e non è stato eseguito per un motivo solitamente non previsto. Si cercherà di ritentare questi test per ottenere un'esecuzione corretta.

Parametri
test	TestDescription: identifica il test
reason	SkipReason: SkipReason

testIniziato

public final void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription), dove specifichiamo anche quando il test è stato iniziare, combinato 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()

testIniziato

public final void testStarted (TestDescription test)

Callback degli scenari di test

Parametri
test	TestDescription: identifica il test