StrumentazioneTest

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

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

Sottoclassi dirette conosciute AndroidJUnitTest , CodeCoverageTest AndroidJUnitTest Un test che esegue un pacchetto di test della strumentazione su un determinato dispositivo usando android.support.test.runner.AndroidJUnitRunner. CodeCoverageTest Un test che esegue un pacchetto di test della strumentazione su un determinato dispositivo e genera il rapporto di copertura del codice.

---

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) Aggiungere un argomento da fornire durante l'esecuzione dei test di strumentazione.
IAbi	getAbi ()
IConfiguration	getConfiguration () Ottiene IConfiguration per questo test.
String	getCoverageTarget () Ottieni il coverageTarget precedentemente impostato tramite setCoverageTarget(String) .
boolean	getDebug () Ottieni l'impostazione di debug della strumentazione.
ITestDevice	getDevice () Fai testare il dispositivo.
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 di esecuzione del test personalizzato che verrà fornito al listener
String	getRunnerName () Ottiene il corridore di strumentazione Android da utilizzare.
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 è un no-op
void	setConfiguration ( IConfiguration config) Inserisce la IConfiguration in uso.
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 prova.
void	setEnforceFormat (boolean enforce) Impostare 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 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 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 ripetizione.
void	setRunName (String runName) Impostare il nome di esecuzione del test personalizzato che verrà fornito al listener
void	setRunnerName (String runnerName) Facoltativamente, imposta il corridore della strumentazione Android da utilizzare.
void	setShellTimeout (long timeout) Facoltativamente, impostare il tempo massimo (in millisecondi) previsto per l'output della shell dal dispositivo.
void	setTestFilePathOnDevice (String testFilePathOnDevice) Facoltativamente, impostare il percorso su un file situato nel dispositivo che dovrebbe contenere un elenco di classi di test e metodi 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) Impostare 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 usato per analizzare le query "strumentazione elenco pm".
String	getMethodName () Ottieni il metodo di prova da eseguire.
String	getTestPackageName () Ottieni l'esecuzione del pacchetto java di prova.
String	queryRunnerName () Eseguire una query sul dispositivo per l'utilizzo da parte di un corridore del test.
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)

Aggiungere 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

getConfiguration

public IConfiguration getConfiguration ()

Ottiene IConfiguration per questo test.

ritorna
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

Ottieni il coverageTarget precedentemente impostato tramite setCoverageTarget(String) .

ritorna
String

getDebug

public boolean getDebug ()

Ottieni l'impostazione di debug della strumentazione.

ritorna
boolean	L'impostazione di debug booleana.

getDevice

public ITestDevice getDevice ()

Fai testare il dispositivo.

ritorna
ITestDevice	l' ITestDevice

getForceAbi

public String getForceAbi ()

ritorna
String

getMaxTimeout

public long getMaxTimeout ()

Restituisce il timeout massimo impostato per la strumentazione.

ritorna
long

getPackageName

public String getPackageName ()

Ottieni l'esecuzione del pacchetto manifest di Android.

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

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 : l' ITestInvocationListener dei risultati del test

Tiri
DeviceNotAvailableException

setAbi

public void setAbi (IAbi abi)

Parametri
abi	IAbi

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

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

Inserisce la IConfiguration in uso.

Parametri
config	IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Impostare l'obiettivo di copertura di questo test.

Attualmente inutilizzato. Questo metodo è solo 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.

setDevice

public void setDevice (ITestDevice device)

Iniettare il dispositivo in prova.

Parametri
device	ITestDevice : l' ITestDevice da utilizzare

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Impostare 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'installabile ERROR(/File)

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Impostare 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

setPackageName

public void setPackageName (String packageName)

Imposta 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 ripetizione.

Parametri
rerun	boolean

setRunName

public void setRunName (String runName)

Impostare il nome di esecuzione del test personalizzato che verrà fornito al listener

Parametri
runName	String

setRunnerName

public void setRunnerName (String runnerName)

Facoltativamente, imposta il corridore della strumentazione Android da utilizzare.

Parametri
runnerName	String

setShellTimeout

public void setShellTimeout (long timeout)

Facoltativamente, impostare il tempo massimo (in millisecondi) previsto per l'output della shell dal dispositivo.

Parametri
timeout	long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Facoltativamente, impostare il percorso su un file situato nel dispositivo che dovrebbe contenere un elenco di classi di test e metodi 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

setTestPackageName

public void setTestPackageName (String testPackageName)

Imposta il filtro del pacchetto di prova.

Se non è null, verranno eseguiti solo i test all'interno del pacchetto java specificato.

Verrà ignorato se è stato fornito un valore non 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

setTestsToRun

public void setTestsToRun ( tests)

Impostare 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 usato per analizzare le query "strumentazione elenco pm".

ritorna
ListInstrumentationParser

getMethodName

protected String getMethodName ()

Ottieni il metodo di prova da eseguire.

ritorna
String

getTestPackageName

protected String getTestPackageName ()

Ottieni l'esecuzione del pacchetto java di prova.

ritorna
String

queryRunnerName

protected String queryRunnerName ()

Eseguire una query sul dispositivo per l'utilizzo da parte di un corridore del test.

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

Tiri
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parametri
runner	IRemoteAndroidTestRunner