IRemoteAndroidTestRunner

public interface IRemoteAndroidTestRunner

com.android.ddmlib.testrunner.IRemoteAndroidTestRunner

Sottoclassi indirette note AndroidTestOrchestratorRemoteTestRunner, DefaultRemoteAndroidTestRunner, RemoteAndroidTestRunner, UiAutomatorRunner AndroidTestOrchestratorRemoteTestRunner Esegue un test Android strumentato utilizzando il comando adb e AndroidTestOrchestrator.  DefaultRemoteAndroidTestRunner Estensione di ddmlib RemoteAndroidTestRunner per impostare alcuni valori predefiniti per i casi d'uso di Tradefed.  RemoteAndroidTestRunner Esegue un comando di test Android da remoto e riporta i risultati.  UiAutomatorRunner Esegue il test UI Automator sul dispositivo e riporta i risultati.

---

Interfaccia per l'esecuzione remota di un comando di test Android e la segnalazione del risultato a un listener.

Riepilogo

Metodi pubblici
abstract void	addBooleanArg(String name, boolean value) Aggiunge un argomento booleano da includere nel comando di strumentazione.
abstract void	addInstrumentationArg(String name, String value) Aggiunge un argomento da includere nel comando di strumentazione.
abstract void	cancel() Richiede l'annullamento di questo test.
abstract IRemoteAndroidTestRunner.CoverageOutput	getCoverageOutputType() Restituisce il tipo di copertura del test prodotto dal runner.
abstract String	getPackageName() Restituisce il nome del pacchetto dell'applicazione.
abstract String	getRunnerName() Restituisce runnerName.
abstract void	removeInstrumentationArg(String name) Rimuove un argomento aggiunto in precedenza.
abstract void	run(ITestRunListener... listeners) Esegui questa esecuzione di test.
abstract void	run( listeners) Esegui questa esecuzione di test.
abstract void	setAdditionalTestOutputLocation(String additionalTestDataPath) Imposta la posizione dell'output di test aggiuntivo da copiare sull'host prima della disinstallazione dell'app di test.
abstract void	setClassName(String className) Imposta l'esecuzione solo dei test in questa classe. Deve essere chiamato prima di "run".
abstract void	setClassNames(String[] classNames) Imposta l'esecuzione solo dei test nelle classi fornite. Deve essere chiamato prima di "run".
abstract void	setCoverage(boolean coverage) Imposta questa modalità di copertura del codice dell'esecuzione del test.
abstract void	setCoverageReportLocation(String reportPath) Imposta la posizione dei report sulla copertura generati.
abstract void	setDebug(boolean debug) Imposta questa modalità di debug dell'esecuzione del test.
abstract void	setLogOnly(boolean logOnly) Imposta questa esecuzione del test in modalità solo log, ignorando l'esecuzione del test.
abstract void	setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits) Imposta il tempo massimo consentito tra l'output del comando shell che esegue i test sui dispositivi.
abstract void	setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits) Imposta il tempo massimo consentito per il completamento della strumentazione.
abstract void	setMaxtimeToOutputResponse(int maxTimeToOutputResponse) Questo metodo è obsoleto. Usa ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)).
abstract void	setMethodName(String className, String testName) Imposta l'esecuzione solo del metodo di test specificato. Deve essere chiamato prima di "run".
abstract void	setRunName(String runName) Imposta un nome di esecuzione personalizzato da comunicare a ITestRunListener il giorno run() Se non specificato, verrà utilizzato il nome del pacchetto
abstract void	setTestCollection(boolean collection) Imposta questa esecuzione test sulla modalità di raccolta test.
abstract void	setTestPackageName(String packageName) Imposta l'esecuzione di tutti i test nel pacchetto specificato. Deve essere chiamato prima di "run".
abstract void	setTestSize(IRemoteAndroidTestRunner.TestSize size) Imposta l'esecuzione solo di test di dimensioni specifiche.

Metodi pubblici

addBooleanArg

public abstract void addBooleanArg (String name, 
                boolean value)

Aggiunge un argomento booleano da includere nel comando di strumentazione.

Parametri
name	String: il nome dell'argomento del bundle di strumentazione
value	boolean: il valore dell'argomento

Vedi anche:

• RemoteAndroidTestRunner.addInstrumentationArg(String, String)

addInstrumentationArg

public abstract void addInstrumentationArg (String name, 
                String value)

Aggiunge un argomento da includere nel comando di strumentazione.

Deve essere chiamato prima di "run". Se è già stato fornito un argomento con il nome specificato, il relativo valore verrà sovrascritto.

Parametri
name	String: il nome dell'argomento del bundle di strumentazione
value	String: il valore dell'argomento

annulla

public abstract void cancel ()

Richiede l'annullamento di questo test.

getCoverageOutputType

public abstract IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

Restituisce il tipo di copertura del test prodotto dal runner. Leggi i CoverageOutput.

Ritorni
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public abstract String getPackageName ()

Restituisce il nome del pacchetto dell'applicazione.

Ritorni
String

getRunnerName

public abstract String getRunnerName ()

Restituisce runnerName.

Ritorni
String

removeInstrumentationArg

public abstract void removeInstrumentationArg (String name)

Rimuove un argomento aggiunto in precedenza.

Parametri
name	String: il nome dell'argomento del bundle di strumentazione da rimuovere

run

public abstract void run (ITestRunListener... listeners)

Esegui questa esecuzione di test.

Metodo di convenienza per ERROR(/#run(Collection)).

Parametri
listeners	ITestRunListener: ascolta i risultati del test

Lanci
TimeoutException	in caso di timeout della connessione.
AdbCommandRejectedException	se adb rifiuta il comando
ShellCommandUnresponsiveException	se il dispositivo non ha restituito alcun risultato del test per un periodo di tempo superiore al tempo massimo per l'output.
	se la connessione al dispositivo è stata interrotta.

Vedi anche:

• setMaxtimeToOutputResponse(int)

run

public abstract void run ( listeners)

Esegui questa esecuzione di test.

Parametri
listeners	: raccolta di listener per i risultati del test

Lanci
TimeoutException	in caso di timeout della connessione.
AdbCommandRejectedException	se adb rifiuta il comando
ShellCommandUnresponsiveException	se il dispositivo non ha restituito alcun risultato del test per un periodo di tempo superiore al tempo massimo per l'output.
	se la connessione al dispositivo è stata interrotta.

Vedi anche:

• setMaxtimeToOutputResponse(int)

setAdditionalTestOutputLocation

public abstract void setAdditionalTestOutputLocation (String additionalTestDataPath)

Imposta la posizione dell'output di test aggiuntivo da copiare sull'host prima della disinstallazione dell'app di test. Ad esempio, i report benchmark generati.

Parametri
additionalTestDataPath	String

setClassName

public abstract void setClassName (String className)

Imposta l'esecuzione solo dei test in questa classe. Deve essere chiamato prima di "run".

Parametri
className	String: nome della classe completo (ad es. x.y.z)

setClassNames

public abstract void setClassNames (String[] classNames)

Imposta l'esecuzione solo dei test nelle classi fornite. Deve essere chiamato prima di "run".

Se fornisci più di una classe, è necessario un InstrumentationTestRunner che supporti la sintassi dell'argomento per più classi.

Parametri
classNames	String: array di nomi di classi completi (ad es. x.y.z)

setCoverage

public abstract void setCoverage (boolean coverage)

Imposta questa modalità di copertura del codice dell'esecuzione del test.

Parametri
coverage	boolean

setCoverageReportLocation

public abstract void setCoverageReportLocation (String reportPath)

Imposta la posizione dei report sulla copertura generati.

Parametri
reportPath	String

setDebug

public abstract void setDebug (boolean debug)

Imposta questa modalità di debug dell'esecuzione del test. Se è true, Android Test Runner attenderà l'attacco di un debugger prima di procedere con l'esecuzione del test.

Parametri
debug	boolean

setLogOnly

public abstract void setLogOnly (boolean logOnly)

Imposta questa esecuzione del test in modalità solo log, ignorando l'esecuzione del test.

Parametri
logOnly	boolean

setMaxTimeToOutputResponse

public abstract void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Imposta il tempo massimo consentito tra l'output del comando shell che esegue i test sui dispositivi.

Ciò consente di impostare un timeout nel caso in cui i test possano bloccarsi e non terminare mai. Questo è diverso dal normale timeout della connessione.

Per impostazione predefinita, non verrà specificato alcun timeout.

Parametri
maxTimeToOutputResponse	long: il periodo di tempo massimo durante il quale il comando può non restituire alcuna risposta. Un valore pari a 0 indica che il metodo attenderà per sempre (finché receiver non annulla l'esecuzione) l'output del comando e non genererà mai un'eccezione.
maxTimeUnits	TimeUnit: unità per i valori non nulli di maxTimeToOutputResponse e maxTimeout.

Vedi anche:

• IShellEnabledDevice.executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, long, TimeUnit)

setMaxTimeout

public abstract void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

Imposta il tempo massimo consentito per il completamento della strumentazione.

Ciò consente di impostare un timeout nel caso in cui i test possano bloccarsi e non terminare mai. Questo è diverso dal normale timeout della connessione.

Per impostazione predefinita, non verrà specificato alcun timeout.

Parametri
maxTimeout	long: il periodo di tempo massimo durante il quale il comando non può restituire alcuna risposta. Un valore pari a 0 indica che il metodo attenderà per sempre (finché receiver non annulla l'esecuzione) l'output del comando e non genererà mai un'eccezione.
maxTimeUnits	TimeUnit: unità per i valori non nulli di maxTimeToOutputResponse e maxTimeout.

Vedi anche:

• IShellEnabledDevice.executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, long, TimeUnit)

setMaxtimeToOutputResponse

public abstract void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Questo metodo è obsoleto.
Utilizza ERROR(/#setMaxTimeToOutputResponse(long,java.util.concurrent.TimeUnit)).

Parametri
maxTimeToOutputResponse	int

setMethodName

public abstract void setMethodName (String className, 
                String testName)

Imposta l'esecuzione solo del metodo di test specificato. Deve essere chiamato prima di "run".

Parametri
className	String: nome della classe completo (ad es. x.y.z)
testName	String: nome del metodo

setRunName

public abstract void setRunName (String runName)

Imposta un nome di esecuzione personalizzato da comunicare a ITestRunListener il giorno run()

Se non specificato, verrà utilizzato il nome del pacchetto

setTestCollection

public abstract void setTestCollection (boolean collection)

Imposta questa esecuzione test sulla modalità di raccolta test. Se il valore è true, l'esecuzione del test verrà ignorata e verranno impostati tutti gli argomenti del runner appropriati necessari per una raccolta di test riuscita.

Parametri
collection	boolean

setTestPackageName

public abstract void setTestPackageName (String packageName)

Imposta l'esecuzione di tutti i test nel pacchetto specificato. Deve essere chiamato prima di "run".

Parametri
packageName	String: nome completo del pacchetto (ad es. x.y.z)

setTestSize

public abstract void setTestSize (IRemoteAndroidTestRunner.TestSize size)

Imposta l'esecuzione solo di test di dimensioni specifiche. Deve essere chiamato prima di "run".

Parametri
size	IRemoteAndroidTestRunner.TestSize: il TestSize da eseguire.