IRemoteAndroidTestRunner

public interface IRemoteAndroidTestRunner

com.android.ddmlib.testrunner.IRemoteAndroidTestRunner

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

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.

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.

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.

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.

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.