Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IMetricCollector

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


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

final getBuildInfos ()

Restituisce l'elenco delle informazioni di compilazione disponibili nella chiamata.

final getDevices ()

Restituisce l'elenco dei dispositivi disponibili nella chiamata.

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.

final ITestInvocationListener getInvocationListener ()

Restituisce l'originale ITestInvocationListener in cui stiamo inoltrando i risultati.

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.

ITestInvocationListener init ( IInvocationContext context, ITestInvocationListener listener)

Inizializzazione del raccoglitore con il contesto corrente e dove inoltrare i risultati.

final void invocationEnded (long elapsedTime)

Segnala che l'invocazione è terminata, con esito positivo oa 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.

final void invocationStarted ( IInvocationContext context)

Listener di invocazione per l'inoltro

final boolean isDisabled ()

Restituisce True se l'intero oggetto è disabilitato (salta sia l'installazione che lo smontaggio).

final void logAssociation (String dataName, LogFile logFile)

Non utilizzare l'implementazione del raccoglitore di metriche all'interno.

void onTestAssumptionFailure ( DeviceMetricData testData, TestDescription test)

Richiamata quando un test case ha esito negativo con ipotesi fallita.

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

Richiamata al termine di un test case.

void onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)

Richiamata al termine di un test case.

void onTestFail ( DeviceMetricData testData, TestDescription test)

Richiamata quando un test case ha esito negativo.

void onTestModuleEnded ()

Consente di acquisire l'evento terminato del modulo.

void onTestModuleStarted ()

Consente di acquisire l'evento avviato del modulo.

void onTestRunEnd ( DeviceMetricData runData, currentRunMetrics) onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)

Richiamata al termine di un'esecuzione di prova.

void onTestRunFailed ( DeviceMetricData testData, FailureDescription failure)

Richiamata per eventi testRunFailed

void onTestRunStart ( DeviceMetricData runData)

Richiamata all'avvio di un'esecuzione di prova.

void onTestStart ( DeviceMetricData testData)

Richiamata all'avvio di un test case.

final void setDisable (boolean isDisabled)

Imposta se l'oggetto deve essere disabilitato.

final void setLogSaver ( ILogSaver logSaver)

Non utilizzare l'implementazione del raccoglitore di metriche all'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) testEnded ( TestDescription test, long endTime, testMetrics)

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) dove possiamo specificare direttamente l'ora di fine.

final void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

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

final void testFailed ( TestDescription test, FailureDescription failure)

Segnala il fallimento di un singolo test case.

final void testFailed ( TestDescription test, String trace)

Segnala il fallimento di un singolo test case.

final void testIgnored ( TestDescription test)

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

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

Fornisce il registro associato o i dati di debug dalla chiamata al test.

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

Non utilizzare l'implementazione del raccoglitore di metriche all'interno.

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) testRunEnded (long elapsedTime, runMetrics)

Segnala la fine dell'esecuzione del test.

final void testRunFailed ( FailureDescription failure)

Segnalazione che l'esecuzione del test non è stata completata a causa di un errore descritto da FailureDescription .

final void testRunFailed (String errorMessage)

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

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

Segnala l'inizio di un'esecuzione di prova.

final void testRunStarted (String runName, int testCount)

Test di esecuzione delle richiamate

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

Segnala l'inizio di un'esecuzione di prova.

final void testRunStopped (long elapsedTime)

Segnala l'esecuzione del test interrotta prima del completamento a causa di una richiesta dell'utente.

final void testStarted ( TestDescription test, long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) dove specifichiamo anche quando è stato avviato il test, combinato con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) per una misurazione accurata .

final void testStarted ( TestDescription test)

Richiamate dei casi 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

getBuildInfos

public final  getBuildInfos ()

Restituisce l'elenco delle informazioni di compilazione disponibili nella chiamata.

ritorna

getDevices

public final  getDevices ()

Restituisce l'elenco dei dispositivi disponibili nella chiamata.

ritorna

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 : nome del file da cercare negli artefatti.

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

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

Restituisce l'originale ITestInvocationListener in cui stiamo inoltrando i risultati.

ritorna
ITestInvocationListener

getRealDevices

public final  getRealDevices ()

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

ritorna

getRunName

public String getRunName ()

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

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

dentro

public 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 dovrebbe aggiornare il proprio contesto interno e listener. Init non verrà mai chiamato durante un'esecuzione di prova sempre prima.

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

Parametri
context IInvocationContext : IInvocationContext per l'invocazione in corso.

listener ITestInvocationListener : ITestInvocationListener in cui inserire i risultati.

ritorna
ITestInvocationListener il nuovo ascoltatore che avvolge quello originale.

Tiri
DeviceNotAvailableException

invocazioneFine

public final void invocationEnded (long elapsedTime)

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

Verrà automaticamente chiamato dal framework TradeFederation.

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

invocazione non riuscita

public final void invocationFailed (FailureDescription failure)

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

Verrà automaticamente chiamato dal framework TradeFederation.

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

invocazione non riuscita

public final void invocationFailed (Throwable cause)

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

Verrà automaticamente chiamato dal framework TradeFederation.

Parametri
cause Throwable : la causa Throwable del fallimento

invocationStarted

public final void invocationStarted (IInvocationContext context)

Listener di invocazione per l'inoltro

Parametri
context IInvocationContext : informazioni sull'invocazione

è disabilitato

public final boolean isDisabled ()

Restituisce True se l'intero oggetto è disabilitato (salta sia l'installazione che lo smontaggio). Falso altrimenti.

ritorna
boolean

logAssociazione

public final void logAssociation (String dataName, 
                LogFile logFile)

Non utilizzare l'implementazione del raccoglitore di metriche all'interno. Questo è puro inoltro.

Parametri
dataName String : il nome dei dati

logFile LogFile : il LogFile che è stato registrato in precedenza e dovrebbe essere associato al test case.

suTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Richiamata quando un test case ha esito negativo con ipotesi fallita.

Parametri
testData DeviceMetricData : DeviceMetricData che contiene i dati per il test case.

test TestDescription : la TestDescription del test case in corso.

Tiri
DeviceNotAvailableException

suTestEnd

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

Richiamata al termine di un test case. Questo dovrebbe essere il momento di pulire.

Parametri
testData DeviceMetricData : DeviceMetricData che contiene i dati per il test case. Sarà lo stesso oggetto di onTestStart(com.android.tradefed.device.metric.DeviceMetricData) .

currentTestCaseMetrics : la mappa corrente delle metriche passata a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) .

test TestDescription : la TestDescription del test case in corso.

Tiri
DeviceNotAvailableException

suTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Richiamata al termine di un test case. Questo dovrebbe essere il momento di pulire.

Parametri
testData DeviceMetricData : DeviceMetricData che contiene i dati per il test case. Sarà lo stesso oggetto di onTestStart(com.android.tradefed.device.metric.DeviceMetricData) .

currentTestCaseMetrics : la mappa corrente delle metriche passata a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) .

Tiri
DeviceNotAvailableException

suTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Richiamata quando un test case ha esito negativo.

Parametri
testData DeviceMetricData : DeviceMetricData che contiene i dati per il test case.

test TestDescription : la TestDescription del test case in corso.

Tiri
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

Consente di acquisire l'evento terminato del modulo.

Tiri
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

Consente di acquisire l'evento avviato del modulo.

Tiri
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Richiamata al termine di un'esecuzione di prova. Questo dovrebbe essere il momento di pulire.

Parametri
runData DeviceMetricData : DeviceMetricData che contiene i dati per la corsa. Sarà lo stesso oggetto di onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) .

currentRunMetrics : la mappa corrente delle metriche passata a ERROR(/#testRunEnded(long,Map)) .

Tiri
DeviceNotAvailableException

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Richiamata per eventi testRunFailed

Tiri
DeviceNotAvailableException

suTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Richiamata all'avvio di un'esecuzione di prova.

Parametri
runData DeviceMetricData : DeviceMetricData che contiene i dati per la corsa.

Tiri
DeviceNotAvailableException

suTestStart

public void onTestStart (DeviceMetricData testData)

Richiamata all'avvio di un test case.

Parametri
testData DeviceMetricData : DeviceMetricData che contiene i dati per il test case.

Tiri
DeviceNotAvailableException

setDisable

public final void setDisable (boolean isDisabled)

Imposta se l'oggetto deve essere disabilitato. Disabilitato significa che entrambi i passaggi di configurazione e smontaggio devono essere saltati. Può essere utilizzato per rendere un oggetto disabilitato per impostazione predefinita nel costruttore predefinito.

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

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Non utilizzare l'implementazione del raccoglitore di metriche all'interno. Questo è puro inoltro.

Parametri
logSaver ILogSaver : l' 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 : traccia 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.

testTerminato

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

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) dove 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 il test è terminato, misurata tramite System.currentTimeMillis()

testMetrics : un ERROR(/Map) delle metriche emesse

testTerminato

public final void testEnded (TestDescription test, 
                 testMetrics)

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

Se testFailed(TestDescription, FailureDescription) non è stato richiamato, questo test è stato superato. Restituisce anche qualsiasi metrica chiave/valore che potrebbe essere stata emessa durante l'esecuzione del test case.

Parametri
test TestDescription : identifica il test

testMetrics : un ERROR(/Map) delle metriche emesse

test non riuscito

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Segnala il fallimento 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.

test non riuscito

public final void testFailed (TestDescription test, 
                String trace)

Segnala il fallimento di un singolo test case.

Verrà chiamato tra testStarted e testEnded.

Parametri
test TestDescription : identifica il test

trace String : traccia dello stack dell'errore

testIgnorato

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 il registro associato o i dati di debug dalla chiamata al test.

Deve essere chiamato prima 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 : una String nome descrittivo dei dati. ad esempio "device_logcat". Nota dataName potrebbe non essere univoco per chiamata. cioè gli implementatori devono essere in grado di gestire più chiamate con lo stesso dataName

dataType LogDataType : il LogDataType dei dati

dataStream InputStreamSource : InputStreamSource dei dati. Gli implementatori devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere InputStream risultante una volta completato. 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 all'interno. Questo è puro inoltro.

Parametri
dataName String : una String nome descrittivo dei dati. ad esempio "device_logcat". Nota dataName potrebbe non essere univoco per chiamata. cioè gli implementatori devono essere in grado di gestire più chiamate con lo stesso dataName

dataType LogDataType : il LogDataType dei dati

dataStream InputStreamSource : InputStreamSource dei dati. Gli implementatori devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere InputStream risultante una volta completato.

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 di un modulo in esecuzione. Questo callback è associato a testModuleEnded() ed è facoltativo nella sequenza. Viene utilizzato solo durante una corsa che utilizza moduli: corridori basati su suite.

Parametri
moduleContext IInvocationContext : l' IInvocationContext del modulo.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Segnala la fine dell'esecuzione del test. FIXME: Non possiamo avere due interfacce Map<> di tipo diverso, quindi dobbiamo usare HashMap qui.

Parametri
elapsedTime long : il dispositivo ha riportato il tempo trascorso, in millisecondi

runMetrics : coppie chiave-valore segnalate al termine di un'esecuzione di test con Metric .

testRunFailed

public final void testRunFailed (FailureDescription failure)

Segnalazione che l'esecuzione del test 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 rapporti non è stata completata a causa di un errore irreversibile.

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

testRunStarted

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

Segnala l'inizio di un'esecuzione di prova.

Parametri
runName String : il nome dell'esecuzione del test

testCount int : numero totale di test in esecuzione

attemptNumber int : numero d'ordine, che identifica i diversi tentativi dello stesso runName che vengono eseguiti più volte. Il numero tentativo è indicizzato a 0 e dovrebbe aumentare ogni volta che si verifica una nuova esecuzione. ad esempio, un test viene ripetuto in modo granulare 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il numero tentativo è compreso tra 0 e 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Test di esecuzione delle richiamate

Parametri
runName String : il nome dell'esecuzione del test

testCount int : numero totale di test in esecuzione

testRunStarted

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

Segnala l'inizio di un'esecuzione di prova.

Parametri
runName String : il nome dell'esecuzione del test

testCount int : numero totale di test in esecuzione

attemptNumber int : numero d'ordine, che identifica i diversi tentativi dello stesso runName che vengono eseguiti più volte. Il numero tentativo è indicizzato a 0 e dovrebbe aumentare ogni volta che si verifica una nuova esecuzione. ad esempio, un test viene ripetuto in modo granulare 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il numero tentativo è compreso tra 0 e 3.

startTime long : l'ora di inizio della corsa, misurata tramite System.currentTimeMillis()

testRunStopped

public final void testRunStopped (long elapsedTime)

Segnala l'esecuzione del test interrotta prima del completamento a causa di una richiesta dell'utente.

TODO: attualmente inutilizzato, considerare la rimozione

Parametri
elapsedTime long : il dispositivo ha riportato il tempo trascorso, in millisecondi

testIniziato

public final void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) dove specifichiamo anche quando è stato avviato il test, 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 di inizio del test, misurata tramite System.currentTimeMillis()

testIniziato

public final void testStarted (TestDescription test)

Richiamate dei casi di test

Parametri
test TestDescription : identifica il test

,

BaseDeviceMetricCollector

public class BaseDeviceMetricCollector
extends Object implements IMetricCollector

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


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

final getBuildInfos ()

Restituisce l'elenco delle informazioni di compilazione disponibili nella chiamata.

final getDevices ()

Restituisce l'elenco dei dispositivi disponibili nella chiamata.

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.

final ITestInvocationListener getInvocationListener ()

Restituisce l'originale ITestInvocationListener in cui stiamo inoltrando i risultati.

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.

ITestInvocationListener init ( IInvocationContext context, ITestInvocationListener listener)

Inizializzazione del raccoglitore con il contesto corrente e dove inoltrare i risultati.

final void invocationEnded (long elapsedTime)

Segnala che l'invocazione è terminata, con esito positivo oa 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.

final void invocationStarted ( IInvocationContext context)

Listener di invocazione per l'inoltro

final boolean isDisabled ()

Restituisce True se l'intero oggetto è disabilitato (salta sia l'installazione che lo smontaggio).

final void logAssociation (String dataName, LogFile logFile)

Non utilizzare l'implementazione del raccoglitore di metriche all'interno.

void onTestAssumptionFailure ( DeviceMetricData testData, TestDescription test)

Richiamata quando un test case ha esito negativo con ipotesi fallita.

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

Richiamata al termine di un test case.

void onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics) onTestEnd ( DeviceMetricData testData, currentTestCaseMetrics)

Richiamata al termine di un test case.

void onTestFail ( DeviceMetricData testData, TestDescription test)

Richiamata quando un test case ha esito negativo.

void onTestModuleEnded ()

Consente di acquisire l'evento terminato del modulo.

void onTestModuleStarted ()

Consente di acquisire l'evento avviato del modulo.

void onTestRunEnd ( DeviceMetricData runData, currentRunMetrics) onTestRunEnd ( DeviceMetricData runData, currentRunMetrics)

Richiamata al termine di un'esecuzione di prova.

void onTestRunFailed ( DeviceMetricData testData, FailureDescription failure)

Richiamata per eventi testRunFailed

void onTestRunStart ( DeviceMetricData runData)

Richiamata all'avvio di un'esecuzione di prova.

void onTestStart ( DeviceMetricData testData)

Richiamata all'avvio di un test case.

final void setDisable (boolean isDisabled)

Imposta se l'oggetto deve essere disabilitato.

final void setLogSaver ( ILogSaver logSaver)

Non utilizzare l'implementazione del raccoglitore di metriche all'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) testEnded ( TestDescription test, long endTime, testMetrics)

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) dove possiamo specificare direttamente l'ora di fine.

final void testEnded ( TestDescription test, testMetrics) testEnded ( TestDescription test, testMetrics)

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

final void testFailed ( TestDescription test, FailureDescription failure)

Segnala il fallimento di un singolo test case.

final void testFailed ( TestDescription test, String trace)

Segnala il fallimento di un singolo test case.

final void testIgnored ( TestDescription test)

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

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

Fornisce il registro associato o i dati di debug dalla chiamata al test.

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

Non utilizzare l'implementazione del raccoglitore di metriche all'interno.

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) testRunEnded (long elapsedTime, runMetrics)

Segnala la fine dell'esecuzione del test.

final void testRunFailed ( FailureDescription failure)

Segnalazione che l'esecuzione del test non è stata completata a causa di un errore descritto da FailureDescription .

final void testRunFailed (String errorMessage)

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

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

Segnala l'inizio di un'esecuzione di prova.

final void testRunStarted (String runName, int testCount)

Test di esecuzione delle richiamate

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

Segnala l'inizio di un'esecuzione di prova.

final void testRunStopped (long elapsedTime)

Segnala l'esecuzione del test interrotta prima del completamento a causa di una richiesta dell'utente.

final void testStarted ( TestDescription test, long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) dove specifichiamo anche quando è stato avviato il test, combinato con ERROR(/#testEnded(com.android.tradefed.result.TestDescription,long,Map)) per una misurazione accurata .

final void testStarted ( TestDescription test)

Richiamate dei casi 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

getBuildInfos

public final  getBuildInfos ()

Restituisce l'elenco delle informazioni di compilazione disponibili nella chiamata.

ritorna

getDevices

public final  getDevices ()

Restituisce l'elenco dei dispositivi disponibili nella chiamata.

ritorna

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 : nome del file da cercare negli artefatti.

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

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

Restituisce l'originale ITestInvocationListener in cui stiamo inoltrando i risultati.

ritorna
ITestInvocationListener

getRealDevices

public final  getRealDevices ()

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

ritorna

getRunName

public String getRunName ()

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

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

dentro

public 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 dovrebbe aggiornare il proprio contesto interno e listener. Init non verrà mai chiamato durante un'esecuzione di prova sempre prima.

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

Parametri
context IInvocationContext : IInvocationContext per l'invocazione in corso.

listener ITestInvocationListener : ITestInvocationListener in cui inserire i risultati.

ritorna
ITestInvocationListener il nuovo ascoltatore che avvolge quello originale.

Tiri
DeviceNotAvailableException

invocazioneFine

public final void invocationEnded (long elapsedTime)

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

Verrà automaticamente chiamato dal framework TradeFederation.

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

invocazione non riuscita

public final void invocationFailed (FailureDescription failure)

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

Verrà automaticamente chiamato dal framework TradeFederation.

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

invocazione non riuscita

public final void invocationFailed (Throwable cause)

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

Verrà automaticamente chiamato dal framework TradeFederation.

Parametri
cause Throwable : la causa Throwable del fallimento

invocationStarted

public final void invocationStarted (IInvocationContext context)

Listener di invocazione per l'inoltro

Parametri
context IInvocationContext : informazioni sull'invocazione

è disabilitato

public final boolean isDisabled ()

Restituisce True se l'intero oggetto è disabilitato (salta sia l'installazione che lo smontaggio). Falso altrimenti.

ritorna
boolean

logAssociazione

public final void logAssociation (String dataName, 
                LogFile logFile)

Non utilizzare l'implementazione del raccoglitore di metriche all'interno. Questo è puro inoltro.

Parametri
dataName String : il nome dei dati

logFile LogFile : il LogFile che è stato registrato in precedenza e dovrebbe essere associato al test case.

suTestAssumptionFailure

public void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

Richiamata quando un test case ha esito negativo con ipotesi fallita.

Parametri
testData DeviceMetricData : DeviceMetricData che contiene i dati per il test case.

test TestDescription : la TestDescription del test case in corso.

Tiri
DeviceNotAvailableException

suTestEnd

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

Richiamata al termine di un test case. Questo dovrebbe essere il momento di pulire.

Parametri
testData DeviceMetricData : DeviceMetricData che contiene i dati per il test case. Sarà lo stesso oggetto di onTestStart(com.android.tradefed.device.metric.DeviceMetricData) .

currentTestCaseMetrics : la mappa corrente delle metriche passata a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) .

test TestDescription : la TestDescription del test case in corso.

Tiri
DeviceNotAvailableException

suTestEnd

public void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

Richiamata al termine di un test case. Questo dovrebbe essere il momento di pulire.

Parametri
testData DeviceMetricData : DeviceMetricData che contiene i dati per il test case. Sarà lo stesso oggetto di onTestStart(com.android.tradefed.device.metric.DeviceMetricData) .

currentTestCaseMetrics : la mappa corrente delle metriche passata a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) .

Tiri
DeviceNotAvailableException

suTestFail

public void onTestFail (DeviceMetricData testData, 
                TestDescription test)

Richiamata quando un test case ha esito negativo.

Parametri
testData DeviceMetricData : DeviceMetricData che contiene i dati per il test case.

test TestDescription : la TestDescription del test case in corso.

Tiri
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

Consente di acquisire l'evento terminato del modulo.

Tiri
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

Consente di acquisire l'evento avviato del modulo.

Tiri
DeviceNotAvailableException

onTestRunEnd

public void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

Richiamata al termine di un'esecuzione di prova. Questo dovrebbe essere il momento di pulire.

Parametri
runData DeviceMetricData : DeviceMetricData che contiene i dati per la corsa. Sarà lo stesso oggetto di onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) .

currentRunMetrics : la mappa corrente delle metriche passata a ERROR(/#testRunEnded(long,Map)) .

Tiri
DeviceNotAvailableException

onTestRunFailed

public void onTestRunFailed (DeviceMetricData testData, 
                FailureDescription failure)

Richiamata per eventi testRunFailed

Tiri
DeviceNotAvailableException

suTestRunStart

public void onTestRunStart (DeviceMetricData runData)

Richiamata all'avvio di un'esecuzione di prova.

Parametri
runData DeviceMetricData : DeviceMetricData che contiene i dati per la corsa.

Tiri
DeviceNotAvailableException

suTestStart

public void onTestStart (DeviceMetricData testData)

Richiamata all'avvio di un test case.

Parametri
testData DeviceMetricData : DeviceMetricData che contiene i dati per il test case.

Tiri
DeviceNotAvailableException

setDisable

public final void setDisable (boolean isDisabled)

Imposta se l'oggetto deve essere disabilitato. Disabilitato significa che entrambi i passaggi di configurazione e smontaggio devono essere saltati. Può essere utilizzato per rendere un oggetto disabilitato per impostazione predefinita nel costruttore predefinito.

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

setLogSaver

public final void setLogSaver (ILogSaver logSaver)

Non utilizzare l'implementazione del raccoglitore di metriche all'interno. Questo è puro inoltro.

Parametri
logSaver ILogSaver : l' 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 : traccia 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.

testTerminato

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

Alternativa a ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) dove 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 il test è terminato, misurata tramite System.currentTimeMillis()

testMetrics : un ERROR(/Map) delle metriche emesse

testTerminato

public final void testEnded (TestDescription test, 
                 testMetrics)

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

Se testFailed(TestDescription, FailureDescription) non è stato richiamato, questo test è stato superato. Restituisce anche qualsiasi metrica chiave/valore che potrebbe essere stata emessa durante l'esecuzione del test case.

Parametri
test TestDescription : identifica il test

testMetrics : un ERROR(/Map) delle metriche emesse

test non riuscito

public final void testFailed (TestDescription test, 
                FailureDescription failure)

Segnala il fallimento 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.

test non riuscito

public final void testFailed (TestDescription test, 
                String trace)

Segnala il fallimento di un singolo test case.

Verrà chiamato tra testStarted e testEnded.

Parametri
test TestDescription : identifica il test

trace String : traccia dello stack dell'errore

testIgnorato

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 il registro associato o i dati di debug dalla chiamata al test.

Deve essere chiamato prima 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 : una String nome descrittivo dei dati. ad esempio "device_logcat". Nota dataName potrebbe non essere univoco per chiamata. cioè gli implementatori devono essere in grado di gestire più chiamate con lo stesso dataName

dataType LogDataType : il LogDataType dei dati

dataStream InputStreamSource : InputStreamSource dei dati. Gli implementatori devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere InputStream risultante una volta completato. 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 all'interno. Questo è puro inoltro.

Parametri
dataName String : una String nome descrittivo dei dati. ad esempio "device_logcat". Nota dataName potrebbe non essere univoco per chiamata. cioè gli implementatori devono essere in grado di gestire più chiamate con lo stesso dataName

dataType LogDataType : il LogDataType dei dati

dataStream InputStreamSource : InputStreamSource dei dati. Gli implementatori devono chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere InputStream risultante una volta completato.

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 di un modulo in esecuzione. Questo callback è associato a testModuleEnded() ed è facoltativo nella sequenza. Viene utilizzato solo durante una corsa che utilizza moduli: corridori basati su suite.

Parametri
moduleContext IInvocationContext : l' IInvocationContext del modulo.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

Segnala la fine dell'esecuzione del test. FIXME: Non possiamo avere due interfacce Map<> di tipo diverso, quindi dobbiamo usare HashMap qui.

Parametri
elapsedTime long : il dispositivo ha riportato il tempo trascorso, in millisecondi

runMetrics : coppie chiave-valore segnalate al termine di un'esecuzione di test con Metric .

testRunFailed

public final void testRunFailed (FailureDescription failure)

Segnalazione che l'esecuzione del test 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 rapporti non è stata completata a causa di un errore irreversibile.

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

testRunStarted

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

Segnala l'inizio di un'esecuzione di prova.

Parametri
runName String : il nome dell'esecuzione del test

testCount int : numero totale di test in esecuzione

attemptNumber int : numero d'ordine, che identifica i diversi tentativi dello stesso runName che vengono eseguiti più volte. Il numero tentativo è indicizzato a 0 e dovrebbe aumentare ogni volta che si verifica una nuova esecuzione. ad esempio, un test viene ripetuto in modo granulare 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il numero tentativo è compreso tra 0 e 3.

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Test di esecuzione delle richiamate

Parametri
runName String : il nome dell'esecuzione del test

testCount int : numero totale di test in esecuzione

testRunStarted

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

Segnala l'inizio di un'esecuzione di prova.

Parametri
runName String : il nome dell'esecuzione del test

testCount int : numero totale di test in esecuzione

attemptNumber int : numero d'ordine, che identifica i diversi tentativi dello stesso runName che vengono eseguiti più volte. Il numero tentativo è indicizzato a 0 e dovrebbe aumentare ogni volta che si verifica una nuova esecuzione. ad esempio, un test viene ripetuto in modo granulare 3 volte, dovrebbe avere 4 esecuzioni totali con lo stesso runName e il numero tentativo è compreso tra 0 e 3.

startTime long : l'ora di inizio della corsa, misurata tramite System.currentTimeMillis()

testRunStopped

public final void testRunStopped (long elapsedTime)

Segnala l'esecuzione del test interrotta prima del completamento a causa di una richiesta dell'utente.

TODO: attualmente inutilizzato, considerare la rimozione

Parametri
elapsedTime long : il dispositivo ha riportato il tempo trascorso, in millisecondi

testIniziato

public final void testStarted (TestDescription test, 
                long startTime)

Alternativa a testStarted(com.android.tradefed.result.TestDescription) dove specifichiamo anche quando è stato avviato il test, 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 di inizio del test, misurata tramite System.currentTimeMillis()

testIniziato

public final void testStarted (TestDescription test)

Richiamate dei casi di test

Parametri
test TestDescription : identifica il test