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, CodeCoverageCollector, 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 Raccogliere una segnalazione di bug quando un caso di test in un'esecuzione non va a buon fine.  ClangCodeCoverageCollector Un BaseDeviceMetricCollector che estrae le misurazioni della copertura di Clang dal dispositivo e le registra come elementi di test.  CodeCoverageCollector Un BaseDeviceMetricCollector che estrae le misurazioni della copertura Java e nativa dal dispositivo e le registra come elementi di test.  CountTestCasesCollector Conta e genera un 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 una prova 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 estrae le misurazioni della copertura di gcov dal dispositivo e le registra come elementi 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 dell'utilità StatsD.  JavaCodeCoverageCollector Un BaseDeviceMetricCollector che estrae le misurazioni della copertura Java dal dispositivo e le registra come elementi di test.  LogcatOnFailureCollector Raccogli dati che acquisisce e registra un logcat quando uno scenario di test non va a buon fine.  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 conteggio.  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 le tracce da tutte le directory di test nella directory specificata dal dispositivo di test, registra la directory di test e esegue il post-trattamento dei 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 dello 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 corrente e la destinazione dei risultati.
final void	invocationEnded(long elapsedTime) Segnala che l'invocazione è terminata, con esito positivo o a causa di una condizione di errore.
final void	invocationFailed(FailureDescription failure) Segnala un'invocazione incompleta a causa di una condizione 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 non va a buon fine con un errore di ipotesi.
void	onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test) Richiamo al termine di un test case.
void	onTestEnd(DeviceMetricData testData, currentTestCaseMetrics) Richiamo al termine di un test case.
void	onTestFail(DeviceMetricData testData, TestDescription test) Callback quando uno scenario di test non va a buon fine.
void	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) Richiamo al termine di un'esecuzione del 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) Richiamo quando viene avviato un caso di test.
void	rebootEnded(ITestDevice device) Riceve una notifica al termine del riavvio del dispositivo.
void	rebootStarted(ITestDevice device) Riceve una notifica quando viene avviato il riavvio del dispositivo.
final void	setDisable(boolean isDisabled) Imposta se l'oggetto deve essere disattivato.
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 il termine dell'esecuzione di un singolo test case.
final void	testFailed(TestDescription test, FailureDescription failure) Segnala l'errore di un singolo test case.
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 l'implementazione interna 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 di esecuzione del 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) L'esecuzione del test dei report è stata interrotta prima del completamento a causa di una richiesta dell'utente.
final void	testSkipped(TestDescription test, SkipReason reason) Viene chiamato quando un test viene saltato e non viene eseguito per un motivo in genere imprevisto.
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 delle informazioni di compilazione disponibili nell'invocazione.

Ritorni

getDevices

public final  getDevices ()

Restituisce l'elenco dei dispositivi disponibili nell'invocazione.

Ritorni

getFileFromTestArtifacts

public File getFileFromTestArtifacts (String fileName)

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

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

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

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

Restituisce l'ITestInvocationListener originale a cui inoltriamo i risultati.

Ritorni
ITestInvocationListener

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.

init

public final ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

Inizializzazione del raccoglitore con il contesto corrente e la destinazione dei risultati. Verrà chiamato solo una volta per istanza e il collector dovrebbe aggiornare il proprio contesto e ascoltatore interno. Init non verrà mai chiamato durante l'esecuzione di un test, sempre prima.

Non eseguire l'override a meno che tu non sappia cosa stai facendo.

Parametri
context	IInvocationContext: il IInvocationContext per l'invocazione in corso.
listener	ITestInvocationListener: l'ITestInvocationListener in cui inserire i risultati.

Ritorni
ITestInvocationListener	il nuovo ascoltatore che avvolge quello originale.

Lanci
DeviceNotAvailableException

invocationEnded

public final void invocationEnded (long elapsedTime)

Segnala che l'invocazione è terminata, con esito positivo o a causa di una condizione di errore.

Verrà chiamato automaticamente dal framework TradeFederation.

Parametri
elapsedTime	long: il tempo trascorso dall'invocazione in ms

invocationFailed

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 FailureDescription che descrive la causa dell'errore

invocationFailed

public final void invocationFailed (Throwable cause)

Segnala un'invocazione 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 il trasferimento

Parametri
context	IInvocationContext: informazioni sull'invocazione

isDisabled

public final boolean isDisabled ()

Restituisce True se l'intero oggetto è disabilitato (salta la configurazione e lo smantellamento). 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 interna 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	: la mappa corrente delle metriche passate 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)

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

Parametri
testData	DeviceMetricData: il DeviceMetricData contenente i dati per il caso di test. Sarà lo stesso oggetto di onTestStart(com.android.tradefed.device.metric.DeviceMetricData).
currentTestCaseMetrics	: la mappa corrente delle metriche passate a 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 va a buon fine.

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

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 inizio del modulo.

Lanci
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

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

Parametri
runData	DeviceMetricData: il DeviceMetricData contenente i dati per l'esecuzione. Sarà lo stesso oggetto utilizzato durante onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData).
currentRunMetrics	: la mappa corrente delle metriche passate a 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 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 contenente i dati per il caso di test.

Lanci
DeviceNotAvailableException

rebootEnded

public void rebootEnded (ITestDevice device)

Riceve una notifica al termine del riavvio del dispositivo.

NOTA: i destinatari devono evitare di riavviare il sistema durante questo callback. Eventuali tentativi di riavvio verranno ignorati.

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 destinatari devono evitare di riavviare il sistema durante questo callback. Eventuali tentativi di riavvio verranno ignorati.

Parametri
device	ITestDevice: ITestDevice da dove è 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 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, la funzionalità 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. Si tratta di un semplice inoltro.

Parametri
logSaver	ILogSaver: il 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 di fine del 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 test case.

Verrà chiamato tra testStarted e testEnded.

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

testFailed

public final void testFailed (TestDescription test, 
                String trace)

Segnala l'errore di un singolo test case.

Verrà chiamato tra testStarted e testEnded.

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

testIgnored

public final void testIgnored (TestDescription test)

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 dall'invocazione del 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. Gli utenti che chiamano 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 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 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)

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 segnalato dal dispositivo, 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 fatale.

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 di 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 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 del 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. 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.
startTime	long: l'ora di inizio dell'esecuzione, misurata tramite System.currentTimeMillis()

testRunStopped

public final void testRunStopped (long elapsedTime)

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

TODO: currently unused, consider removing

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

testSkipped

public final void testSkipped (TestDescription test, 
                SkipReason reason)

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