StrumentazioneTest

public class InstrumentationTest
extends Object implements IDeviceTest , IRemoteTest , ITestCollector , IAbiReceiver , IConfigurationReceiver , IMetricCollectorReceiver

java.lang.Object
com.android.tradefed.testtype.InstrumentationTest


Un test che esegue un pacchetto di test della strumentazione su un determinato dispositivo.

Riepilogo

Campi

public static final String RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_ON_SDK_SANDBOX

protected boolean mDebug

protected boolean mInstrumentSdkInSandbox

protected boolean mInstrumentSdkSandbox

Costruttori pubblici

InstrumentationTest ()

Metodi pubblici

void addDeviceListeners ( extraListeners) addDeviceListeners ( extraListeners)

Consente di aggiungere più ascoltatori personalizzati al corridore

void addInstrumentationArg (String key, String value)

Aggiungi un argomento da fornire durante l'esecuzione dei test di strumentazione.

IAbi getAbi ()
IConfiguration getConfiguration ()

Ottiene l' IConfiguration per questo test.

String getCoverageTarget ()

Ottieni il coverTarget precedentemente impostato tramite setCoverageTarget(String) .

boolean getDebug ()

Ottieni l'impostazione di debug della strumentazione.

ITestDevice getDevice ()

Metti il ​​dispositivo in prova.

String getForceAbi ()
long getMaxTimeout ()

Restituisce il timeout massimo impostato per la strumentazione.

String getPackageName ()

Ottieni l'esecuzione del pacchetto manifest di Android.

String getRunName ()

Ottieni il nome dell'esecuzione del test personalizzato che verrà fornito all'ascoltatore

String getRunnerName ()

Ottiene l'utilizzo del runner della strumentazione Android.

void run ( TestInformation testInfo, ITestInvocationListener listener)

Esegue i test e segnala i risultati all'ascoltatore.

void setAbi ( IAbi abi)
void setClassName (String testClassName)

Facoltativamente, impostare il nome della classe di test da eseguire.

void setCollectTestsOnly (boolean shouldCollectTest)

Abilita o disabilita la modalità di raccolta dei test

void setCollectsTestsShellTimeout (int timeout)

Questo metodo è deprecato. Questo metodo non è operativo

void setConfiguration ( IConfiguration config)

Inietta la IConfiguration in uso.

void setCoverageTarget (String coverageTarget)

Imposta l'obiettivo di copertura di questo test.

void setDebug (boolean debug)

Configurare l'impostazione di debug della strumentazione.

void setDevice ( ITestDevice device)

Iniettare il dispositivo in prova.

void setEnforceFormat (boolean enforce)

Imposta True se applichiamo il formato di output AJUR della strumentazione.

void setForceAbi (String abi)

Imposta l'opzione force-abi.

void setInstallFile (File installFile)

Impostare il file facoltativo da installare che contiene i test.

void setIsolatedStorage (boolean isolatedStorage)

Imposta se utilizzare o meno la memoria isolata.

void setMethodName (String testMethodName)

Facoltativamente, impostare il metodo di test da eseguire.

void setMetricCollectors ( collectors) setMetricCollectors ( collectors)

Imposta l'elenco di IMetricCollector definiti per l'esecuzione del test.

void setPackageName (String packageName)

Imposta il pacchetto manifest Android per l'esecuzione.

void setReRunUsingTestFile (boolean reRunUsingTestFile)

Imposta l'opzione --rerun-from-file.

void setRerunMode (boolean rerun)

Facoltativamente, impostare la modalità di riesecuzione.

void setRunName (String runName)

Imposta il nome dell'esecuzione del test personalizzato che verrà fornito all'ascoltatore

void setRunnerName (String runnerName)

Facoltativamente, impostare il runner della strumentazione Android da utilizzare.

void setShellTimeout (long timeout)

Facoltativamente, imposta il tempo massimo (in millisecondi) di attesa dell'output della shell dal dispositivo.

void setTestFilePathOnDevice (String testFilePathOnDevice)

Facoltativamente, impostare il percorso di un file situato sul dispositivo che dovrebbe contenere un elenco di classi e metodi di test separati da righe (formato: com.foo.Class#method) da eseguire.

void setTestPackageName (String testPackageName)

Imposta il filtro del pacchetto di prova.

void setTestSize (String size)

Facoltativamente, impostare la dimensione del test da eseguire.

void setTestTimeout (long timeout)

Facoltativamente, impostare il tempo massimo (in millisecondi) per ogni singola esecuzione del test.

void setTestsToRun ( tests) setTestsToRun ( tests)

Imposta la raccolta di test che devono essere eseguiti da questo InstrumentationTest.

void setWindowAnimation (boolean windowAnimation)

Metodi protetti

static excludeNonExecuted ( TestRunResult results)

Filtra "NOT_EXECUTED" allo scopo di tenere traccia di ciò che deve essere eseguito nuovamente.

String getClassName ()

Ottieni il nome della classe da eseguire.

ListInstrumentationParser getListInstrumentationParser ()

Ottieni ListInstrumentationParser utilizzato per analizzare le query "pm list instrumentation".

String getMethodName ()

Ottieni il metodo di test da eseguire.

String getTestPackageName ()

Ottieni il pacchetto Java di prova da eseguire.

String queryRunnerName ()

Richiedi il dispositivo per un test runner da utilizzare.

void setRunnerArgs (IRemoteAndroidTestRunner runner)

Campi

ESEGUIRE_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

ESEGUIRE_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

mDebug

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Costruttori pubblici

StrumentazioneTest

public InstrumentationTest ()

Metodi pubblici

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Consente di aggiungere più ascoltatori personalizzati al corridore

Parametri
extraListeners

aggiungiStrumentazioneArg

public void addInstrumentationArg (String key, 
                String value)

Aggiungi un argomento da fornire durante l'esecuzione dei test di strumentazione.

Parametri
key String : il nome dell'argomento

value String : il valore dell'argomento

getAbi

public IAbi getAbi ()

ritorna
IAbi

getConfigurazione

public IConfiguration getConfiguration ()

Ottiene l' IConfiguration per questo test.

ritorna
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

Ottieni il coverTarget precedentemente impostato tramite setCoverageTarget(String) .

ritorna
String

getDebug

public boolean getDebug ()

Ottieni l'impostazione di debug della strumentazione.

ritorna
boolean L'impostazione booleana di debug.

getDevice

public ITestDevice getDevice ()

Metti il ​​dispositivo in prova.

ritorna
ITestDevice l' ITestDevice

getForceAbi

public String getForceAbi ()

ritorna
String

getMaxTimeout

public long getMaxTimeout ()

Restituisce il timeout massimo impostato per la strumentazione.

ritorna
long

getNomePacchetto

public String getPackageName ()

Ottieni l'esecuzione del pacchetto manifest di Android.

ritorna
String

getRunName

public String getRunName ()

Ottieni il nome dell'esecuzione del test personalizzato che verrà fornito all'ascoltatore

ritorna
String

getNomeCorridore

public String getRunnerName ()

Ottiene l'utilizzo del runner della strumentazione Android.

ritorna
String

correre

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Esegue i test e segnala i risultati all'ascoltatore.

Parametri
testInfo TestInformation : l'oggetto TestInformation contenente informazioni utili per eseguire i test.

listener ITestInvocationListener : ITestInvocationListener dei risultati del test

Lancia
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Parametri
abi IAbi

setClassNome

public void setClassName (String testClassName)

Facoltativamente, impostare il nome della classe di test da eseguire.

Parametri
testClassName String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Abilita o disabilita la modalità di raccolta dei test

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Questo metodo è deprecato.
Questo metodo non è operativo

Imposta il tempo massimo in ms per consentire il "tempo massimo per la risposta in uscita della shell" durante la raccolta dei test.

Parametri
timeout int

setConfigurazione

public void setConfiguration (IConfiguration config)

Inietta la IConfiguration in uso.

Parametri
config IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Imposta l'obiettivo di copertura di questo test.

Attualmente inutilizzato. Questo metodo è appena presente, quindi coverTarget può essere successivamente recuperato tramite getCoverageTarget()

Parametri
coverageTarget String

setDebug

public void setDebug (boolean debug)

Configurare l'impostazione di debug della strumentazione.

Parametri
debug boolean : valore booleano su cui impostare l'impostazione di debug della strumentazione.

setDevice

public void setDevice (ITestDevice device)

Iniettare il dispositivo in prova.

Parametri
device ITestDevice : l' ITestDevice da utilizzare

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Imposta True se applichiamo il formato di output AJUR della strumentazione.

Parametri
enforce boolean

setForceAbi

public void setForceAbi (String abi)

Imposta l'opzione force-abi.

setInstallFile

public void setInstallFile (File installFile)

Impostare il file facoltativo da installare che contiene i test.

Parametri
installFile File : l' ERROR(/File)

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Imposta se utilizzare o meno la memoria isolata.

Parametri
isolatedStorage boolean

setMethodName

public void setMethodName (String testMethodName)

Facoltativamente, impostare il metodo di test da eseguire.

Parametri
testMethodName String

setMetricCollectors

public void setMetricCollectors ( collectors)

Imposta l'elenco di IMetricCollector definiti per l'esecuzione del test.

Parametri
collectors

setNomePacchetto

public void setPackageName (String packageName)

Imposta il pacchetto manifest Android per l'esecuzione.

Parametri
packageName String

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

Imposta l'opzione --rerun-from-file.

Parametri
reRunUsingTestFile boolean

setRerunMode

public void setRerunMode (boolean rerun)

Facoltativamente, impostare la modalità di riesecuzione.

Parametri
rerun boolean

setRunName

public void setRunName (String runName)

Imposta il nome dell'esecuzione del test personalizzato che verrà fornito all'ascoltatore

Parametri
runName String

setNomeRunner

public void setRunnerName (String runnerName)

Facoltativamente, impostare il runner della strumentazione Android da utilizzare.

Parametri
runnerName String

setShellTimeout

public void setShellTimeout (long timeout)

Facoltativamente, imposta il tempo massimo (in millisecondi) di attesa dell'output della shell dal dispositivo.

Parametri
timeout long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Facoltativamente, impostare il percorso di un file situato sul dispositivo che dovrebbe contenere un elenco di classi e metodi di test separati da righe (formato: com.foo.Class#method) da eseguire. Se impostato, tenterà automaticamente di rieseguire i test utilizzando questo file di test tramite InstrumentationFileTest invece di eseguire comandi adb separati per ogni test rimanente tramite riesecuzione.

Parametri
testFilePathOnDevice String

setNomePacchettoTest

public void setTestPackageName (String testPackageName)

Imposta il filtro del pacchetto di prova.

Se diverso da null, verranno eseguiti solo i test all'interno del pacchetto Java specificato.

Verrà ignorato se è stato fornito un valore diverso da null a setClassName(String)

Parametri
testPackageName String

setTestSize

public void setTestSize (String size)

Facoltativamente, impostare la dimensione del test da eseguire.

Parametri
size String

setTestTimeout

public void setTestTimeout (long timeout)

Facoltativamente, impostare il tempo massimo (in millisecondi) per ogni singola esecuzione del test.

Parametri
timeout long

setTestDaEseguire

public void setTestsToRun ( tests)

Imposta la raccolta di test che devono essere eseguiti da questo InstrumentationTest.

Parametri
tests : i test da eseguire

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Parametri
windowAnimation boolean

Metodi protetti

excludeNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

Filtra "NOT_EXECUTED" allo scopo di tenere traccia di ciò che deve essere eseguito nuovamente.

Parametri
results TestRunResult

ritorna

getClassName

protected String getClassName ()

Ottieni il nome della classe da eseguire.

ritorna
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Ottieni ListInstrumentationParser utilizzato per analizzare le query "pm list instrumentation".

ritorna
ListInstrumentationParser

getNomeMetodo

protected String getMethodName ()

Ottieni il metodo di test da eseguire.

ritorna
String

getNomePacchettoTest

protected String getTestPackageName ()

Ottieni il pacchetto Java di prova da eseguire.

ritorna
String

queryRunnerName

protected String queryRunnerName ()

Richiedi il dispositivo per un test runner da utilizzare.

ritorna
String il nome del primo test runner che corrisponde al pacchetto o null se non ne troviamo alcuno.

Lancia
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parametri
runner IRemoteAndroidTestRunner