StrumentazioneTest
public class InstrumentationTest
extends Object
implements IDeviceTest , IRemoteTest , ITestCollector , IAbiReceiver , IConfigurationReceiver , IMetricCollectorReceiver
java.lang.Oggetto | |
↳ | com.android.tradefed.testtype.InstrumentationTest |
Un test che esegue un pacchetto di test di 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 coverageTarget precedentemente impostato tramite |
boolean | getDebug () Ottenere l'impostazione di debug della strumentazione. |
ITestDevice | getDevice () Ottieni il dispositivo in prova. |
String | getForceAbi () |
long | getMaxTimeout () Restituisce il timeout massimo impostato per la strumentazione. |
String | getPackageName () Ottieni il pacchetto manifest Android da eseguire. |
String | getRunName () Ottieni il nome di esecuzione del test personalizzato che verrà fornito al listener |
String | getRunnerName () Ottiene il corridore di strumentazione Android da usare. |
void | run ( TestInformation testInfo, ITestInvocationListener listener) Esegue i test e riporta i risultati al listener. |
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 è un no-op |
void | setConfiguration ( IConfiguration config) Inietta l' |
void | setCoverageTarget (String coverageTarget) Impostare l'obiettivo di copertura di questo test. |
void | setDebug (boolean debug) Impostare l'impostazione di debug della strumentazione. |
void | setDevice ( ITestDevice device) Iniettare il dispositivo in esame. |
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) Impostare se utilizzare o meno l'archiviazione 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) Impostare l'esecuzione del pacchetto manifest di Android. |
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 di esecuzione del test personalizzato che verrà fornito al listener |
void | setRunnerName (String runnerName) Facoltativamente, impostare il corridore di strumentazione Android da utilizzare. |
void | setShellTimeout (long timeout) Facoltativamente, imposta il tempo massimo (in millisecondi) in attesa dell'output della shell dal dispositivo. |
void | setTestFilePathOnDevice (String testFilePathOnDevice) Facoltativamente, imposta 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 test. |
void | setTestSize (String size) Facoltativamente, imposta 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 rieseguito. |
String | getClassName () Ottenere il nome della classe da eseguire. |
ListInstrumentationParser | getListInstrumentationParser () Ottenere il |
String | getMethodName () Ottieni il metodo di test da eseguire. |
String | getTestPackageName () Ottieni il pacchetto Java di prova da eseguire. |
String | queryRunnerName () Interrogare il dispositivo per l'utilizzo da parte di un test runner. |
void | setRunnerArgs (IRemoteAndroidTestRunner runner) |
Campi
RUN_TESTS_AS_USER_KEY
public static final String RUN_TESTS_AS_USER_KEY
RUN_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 |
addInstrumentationArg
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 |
getConfiguration
public IConfiguration getConfiguration ()
Ottiene l' IConfiguration
per questo test.
ritorna | |
---|---|
IConfiguration |
getCoverageTarget
public String getCoverageTarget ()
Ottieni il coverageTarget precedentemente impostato tramite setCoverageTarget(String)
.
ritorna | |
---|---|
String |
getDebug
public boolean getDebug ()
Ottenere l'impostazione di debug della strumentazione.
ritorna | |
---|---|
boolean | L'impostazione di debug booleana. |
getDispositivo
public ITestDevice getDevice ()
Ottieni il dispositivo in prova.
ritorna | |
---|---|
ITestDevice | il 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 il pacchetto manifest Android da eseguire.
ritorna | |
---|---|
String |
getRunName
public String getRunName ()
Ottieni il nome di esecuzione del test personalizzato che verrà fornito al listener
ritorna | |
---|---|
String |
getRunnerName
public String getRunnerName ()
Ottiene il corridore di strumentazione Android da usare.
ritorna | |
---|---|
String |
correre
public void run (TestInformation testInfo, ITestInvocationListener listener)
Esegue i test e riporta i risultati al listener.
Parametri | |
---|---|
testInfo | TestInformation : l'oggetto TestInformation contenente informazioni utili per eseguire i test. |
listener | ITestInvocationListener : ITestInvocationListener dei risultati del test |
Getta | |
---|---|
DeviceNotAvailableException |
setClassName
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 è un no-op
Imposta il tempo massimo in ms per consentire il "tempo massimo per la risposta dell'output della shell" durante la raccolta dei test.
Parametri | |
---|---|
timeout | int |
setConfigurazione
public void setConfiguration (IConfiguration config)
Inietta l' IConfiguration
in uso.
Parametri | |
---|---|
config | IConfiguration |
setCoverageTarget
public void setCoverageTarget (String coverageTarget)
Impostare l'obiettivo di copertura di questo test.
Attualmente inutilizzato. Questo metodo è appena presente in modo che coverageTarget possa essere successivamente recuperato tramite getCoverageTarget()
Parametri | |
---|---|
coverageTarget | String |
setDebug
public void setDebug (boolean debug)
Impostare l'impostazione di debug della strumentazione.
Parametri | |
---|---|
debug | boolean : valore booleano su cui impostare l'impostazione di debug della strumentazione. |
setDispositivo
public void setDevice (ITestDevice device)
Iniettare il dispositivo in esame.
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)
Impostare se utilizzare o meno l'archiviazione 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)
Impostare l'esecuzione del pacchetto manifest di Android.
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 di esecuzione del test personalizzato che verrà fornito al listener
Parametri | |
---|---|
runName | String |
setRunnerName
public void setRunnerName (String runnerName)
Facoltativamente, impostare il corridore di strumentazione Android da utilizzare.
Parametri | |
---|---|
runnerName | String |
setShellTimeout
public void setShellTimeout (long timeout)
Facoltativamente, imposta il tempo massimo (in millisecondi) in attesa dell'output della shell dal dispositivo.
Parametri | |
---|---|
timeout | long |
setTestFilePathOnDevice
public void setTestFilePathOnDevice (String testFilePathOnDevice)
Facoltativamente, imposta 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 rerun.
Parametri | |
---|---|
testFilePathOnDevice | String |
setTestPackageName
public void setTestPackageName (String testPackageName)
Imposta il filtro del pacchetto di test.
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, imposta 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 |
setTestsToRun
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 rieseguito.
Parametri | |
---|---|
results | TestRunResult |
ritorna | |
---|---|
getClassName
protected String getClassName ()
Ottenere il nome della classe da eseguire.
ritorna | |
---|---|
String |
getListInstrumentationParser
protected ListInstrumentationParser getListInstrumentationParser ()
Ottenere il ListInstrumentationParser
utilizzato per analizzare le query 'pm list instrumentation'.
ritorna | |
---|---|
ListInstrumentationParser |
getMethodName
protected String getMethodName ()
Ottieni il metodo di test da eseguire.
ritorna | |
---|---|
String |
getTestPackageName
protected String getTestPackageName ()
Ottieni il pacchetto Java di prova da eseguire.
ritorna | |
---|---|
String |
queryRunnerName
protected String queryRunnerName ()
Interrogare il dispositivo per l'utilizzo da parte di un test runner.
ritorna | |
---|---|
String | il nome del primo test runner che corrisponde al pacchetto o null se non ne troviamo nessuno. |
Getta | |
---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
setRunnerArgs
protected void setRunnerArgs (IRemoteAndroidTestRunner runner)
Parametri | |
---|---|
runner | IRemoteAndroidTestRunner |