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
|
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' |
String | getCoverageTarget () Ottieni il coverTarget precedentemente impostato tramite |
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 |
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 |
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 |
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
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 |
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 |
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 |
setWindowAnimation
public void setWindowAnimation (boolean windowAnimation)
Parametri | |
---|---|
windowAnimation | boolean |
Metodi protetti
excludeNonExecuted
protected staticexcludeNonExecuted (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 |