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' |
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. |
boolean | isOrchestrator () Restituisce il valore di |
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 | setOrchestrator (boolean useOrchestrator) Imposta l'opzione --orchestrator |
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
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 |
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 |
è Orchestrator
public boolean isOrchestrator ()
Restituisce il valore di ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator)
ritorna | |
---|---|
boolean |
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 |
setOrchestratore
public void setOrchestrator (boolean useOrchestrator)
Imposta l'opzione --orchestrator
Parametri | |
---|---|
useOrchestrator | boolean |
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 |