Google si impegna a promuovere l'equità razziale per le comunità nere. Vedi come.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

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

Sommario

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 build disponibili nell'invocazione.

final getDevices ()

Restituisce l'elenco dei dispositivi disponibili nell'invocazione.

final ITestInvocationListener getInvocationListener ()

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

String getRunName ()

Restituisce il nome dell'esecuzione test mRunName che attiva il collector.

String getTag ()

Restituisce l'identificatore mTag del 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, sia correttamente che 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)

Ascoltatori di invocazione per l'inoltro

final boolean isDisabled ()

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

void onTestAssumptionFailure ( DeviceMetricData testData, TestDescription test)

Richiamata quando un caso di test fallisce con ipotesi fallita.

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

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

Richiamata al termine di una prova.

void onTestRunStart ( DeviceMetricData runData)

Richiamata all'avvio di una prova.

void onTestStart ( DeviceMetricData testData)

Richiamata all'avvio di un test case.

final void setDisable (boolean isDisabled)

Imposta se l'oggetto deve essere disabilitato.

void setTag (String tag)

Imposta il mTag del collector.

final void testAssumptionFailure ( TestDescription test, String trace)

Chiamato quando un test atomico segnala che assume 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)

Riporta la fine dell'esecuzione di un singolo caso di test.

final void testFailed ( TestDescription test, String trace)

Segnala l'errore di un singolo test case.

final void testIgnored ( TestDescription test)

Chiamato quando un test non verrà eseguito, generalmente 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 dall'invocazione del test.

final void testRunEnded (long elapsedTime, runMetrics) testRunEnded (long elapsedTime, runMetrics)

Riporta la fine dell'esecuzione del test.

final void testRunFailed (String errorMessage)

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

final void testRunStarted (String runName, int testCount)

Test callback di esecuzione

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

Richiami di 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 build disponibili nell'invocazione.

ritorna

getDevices

public final  getDevices ()

Restituisce l'elenco dei dispositivi disponibili nell'invocazione.

ritorna

getInvocationListener

public final ITestInvocationListener getInvocationListener ()

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

ritorna
ITestInvocationListener

getRunName

public String getRunName ()

Restituisce il nome dell'esecuzione test mRunName che attiva il collector.

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

getTag

public String getTag ()

Restituisce l'identificatore mTag del raccoglitore.

ritorna
String mTag, l'identificatore univoco del raccoglitore.

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 collector dovrebbe aggiornare il suo contesto interno e il listener. Init non verrà mai chiamato durante un test eseguito sempre prima.

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

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

listener ITestInvocationListener : ITestInvocationListener dove inserire i risultati.

ritorna
ITestInvocationListener il nuovo ascoltatore che avvolge quello originale.

invocationEnded

public final void invocationEnded (long elapsedTime)

Segnala che l'invocazione è terminata, sia correttamente che a causa di una condizione di errore.

Verrà automaticamente chiamato dal framework TradeFederation.

parametri
elapsedTime long : il tempo trascorso dell'invocazione in ms

invocationFailed

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)

Ascoltatori di invocazione per l'inoltro

parametri
context IInvocationContext : informazioni IInvocationContext

è disabilitato

public final boolean isDisabled ()

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

ritorna
boolean

onTestAssumptionFailure

public void onTestAssumptionFailure ( DeviceMetricData testData, 
                TestDescription test)

Richiamata quando un caso di test fallisce con ipotesi fallita.

parametri
testData DeviceMetricData : DeviceMetricData che DeviceMetricData i dati per il test case.

test TestDescription : la TestDescription del test case in corso.

onTestEnd

public void onTestEnd ( DeviceMetricData testData, 
                 currentTestCaseMetrics)

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

parametri
testData DeviceMetricData : DeviceMetricData che DeviceMetricData 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)) .

onTestFail

public void onTestFail ( DeviceMetricData testData, 
                TestDescription test)

Richiamata quando un caso di test fallisce.

parametri
testData DeviceMetricData : DeviceMetricData che DeviceMetricData i dati per il test case.

test TestDescription : la TestDescription del test case in corso.

onTestRunEnd

public void onTestRunEnd ( DeviceMetricData runData, 
                 currentRunMetrics)

Richiamata al termine di una prova. Questo dovrebbe essere il momento di ripulire.

parametri
runData DeviceMetricData : DeviceMetricData che DeviceMetricData i dati per l'esecuzione. Sarà lo stesso oggetto di onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) .

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

onTestRunStart

public void onTestRunStart ( DeviceMetricData runData)

Richiamata all'avvio di una prova.

parametri
runData DeviceMetricData : DeviceMetricData che DeviceMetricData i dati per l'esecuzione.

onTestStart

public void onTestStart ( DeviceMetricData testData)

Richiamata all'avvio di un test case.

parametri
testData DeviceMetricData : DeviceMetricData che DeviceMetricData i dati per il test case.

setDisable

public final void setDisable (boolean isDisabled)

Imposta se l'oggetto deve essere disabilitato. Disabilitato significa che entrambe le fasi di installazione e smontaggio devono essere saltate. 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.

setTag

public void setTag (String tag)

Imposta il mTag del collector. Può essere utilizzato per specificare l'intervallo del raccoglitore.

parametri
tag String : l'identificatore univoco del raccoglitore.

testAssumptionFailure

public final void testAssumptionFailure ( TestDescription test, 
                String trace)

Chiamato quando un test atomico segnala che assume una condizione falsa

parametri
test TestDescription : identifica il test

trace String : traccia stack di errore

testEnded

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 : il tempo in cui il test è terminato, misurato tramite System.currentTimeMillis()

testMetrics : un ERROR(/Map) delle metriche emesse

testEnded

public final void testEnded ( TestDescription test, 
                 testMetrics)

Riporta la fine dell'esecuzione di un singolo caso di test.

Se testFailed(TestDescription, String) non è stato richiamato, questo test ha superato. Restituisce inoltre 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

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 : traccia stack di errore

testIgnored

public final void testIgnored ( TestDescription test)

Chiamato quando un test non verrà eseguito, generalmente 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 dall'invocazione del test.

Deve essere chiamato prima di ITestInvocationListener#invocationFailed(Throwable) o ITestInvocationListener#invocationEnded(long)

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

parametri
dataName String : un nome descrittivo String dei dati. ad es. "device_logcat". Nota dataName potrebbe non essere univoco per invocazione. vale a dire che gli implementatori devono essere in grado di gestire più chiamate con lo stesso dataName

dataType LogDataType : LogDataType dei dati

dataStream InputStreamSource : l'origine InputStreamSource dei dati. Gli implementatori dovrebbero chiamare createInputStream per iniziare a leggere i dati e assicurarsi di chiudere InputStream risultante al termine. I chiamanti devono assicurarsi che l'origine dei dati rimanga presente e accessibile fino al completamento del metodo testLog.

testRunEnded

public final void testRunEnded (long elapsedTime, 
                 runMetrics)

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

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

runMetrics : coppie chiave-valore riportate al termine di una prova con Metric .

testRunFailed

public final void testRunFailed (String errorMessage)

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

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

testRunStarted

public final void testRunStarted (String runName, 
                int testCount)

Test callback di esecuzione

parametri
runName String : il nome dell'esecuzione del test

testCount int : numero totale di test nell'esecuzione del test

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: attualmente inutilizzato, considera la rimozione

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

testStarted

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

testStarted

public final void testStarted ( TestDescription test)

Richiami di casi di test

parametri
test TestDescription : identifica il test