RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

java.lang.Object
   ↳ com.android.ddmlib.testrunner.RemoteAndroidTestRunner

Esegue un comando di test Android da remoto e riporta i risultati.

Riepilogo

Costruttori pubblici

RemoteAndroidTestRunner(String packageName, IShellEnabledDevice remoteDevice)

Costruttore alternativo.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice)

Costruttore alternativo.

RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice, RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

Crea un test runner Android remoto.

Metodi pubblici

void addBooleanArg(String name, boolean value)

Aggiunge un argomento booleano da includere nel comando di strumentazione.

void addInstrumentationArg(String name, String value)

Aggiunge un argomento da includere nel comando di strumentazione.

void cancel()

Richiede l'annullamento di questo test.

IInstrumentationResultParser createParser(String runName, listeners)

Crea il InstrumentationResultParser che verrà utilizzato per analizzare l'output della strumentazione.

String getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType()

Restituisce il tipo di copertura del test prodotto dal runner.

String getPackageName()

Restituisce il nome del pacchetto dell'applicazione.

String getRunOptions()

Restituisce le opzioni per il comando dello strumento am.

String getRunnerName()

Restituisce runnerName.

void removeInstrumentationArg(String name)

Rimuove un argomento aggiunto in precedenza.

void run(ITestRunListener... listeners)

Esegui questa esecuzione di test.

void run( listeners)

Esegui questa esecuzione di test.

void setAdditionalTestOutputLocation(String additionalTestDataPath)

Imposta la posizione dell'output di test aggiuntivo da copiare sull'host prima della disinstallazione dell'app di test.

void setClassName(String className)

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

void setClassNames(String[] classNames)

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

void setCoverage(boolean coverage)

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

void setCoverageReportLocation(String reportPath)

Imposta la posizione dei report sulla copertura generati.

void setDebug(boolean debug)

Imposta questa modalità di debug dell'esecuzione del test.

void setLogOnly(boolean logOnly)

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

void setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits)

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

void setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits)

Imposta il tempo massimo consentito per il completamento della strumentazione.

void setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
void setMethodName(String className, String testName)

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

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

void setRunOptions(String options)

Imposta le opzioni per il comando am instrument.

void setTestCollection(boolean collect)

Imposta questa esecuzione test sulla modalità di raccolta test.

void setTestPackageName(String packageName)

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

void setTestSize(IRemoteAndroidTestRunner.TestSize size)

Imposta l'esecuzione solo di test di dimensioni specifiche.

Metodi protetti

String getArgsCommand()

Restituisce la sintassi completa della riga di comando di strumentazione per gli argomenti di strumentazione forniti.

String getRunnerPath()

Restituisce il percorso completo del componente di strumentazione.

Costruttori pubblici

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

Costruttore alternativo. Utilizza il runner di strumentazione predefinito.

Parametri
packageName String: il pacchetto dell'applicazione Android che contiene i test da eseguire
remoteDevice IShellEnabledDevice: il dispositivo Android su cui eseguire i test

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice)

Costruttore alternativo. Utilizza il valore predefinito statusReporterMode.

Parametri
packageName String: il pacchetto dell'applicazione Android che contiene i test da eseguire
runnerName String: il runner di test di strumentazione da eseguire. Se null, verrà utilizzato il runner predefinito
remoteDevice IShellEnabledDevice: il dispositivo Android su cui eseguire i test

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                String runnerName, 
                IShellEnabledDevice remoteDevice, 
                RemoteAndroidTestRunner.StatusReporterMode statusReporterMode)

Crea un test runner Android remoto.

Parametri
packageName String: il pacchetto dell'applicazione Android che contiene i test da eseguire
runnerName String: il runner di test di strumentazione da eseguire. Se null, verrà utilizzato il runner predefinito
remoteDevice IShellEnabledDevice: il dispositivo Android su cui eseguire i test
statusReporterMode RemoteAndroidTestRunner.StatusReporterMode: la modalità di reporter di stato da utilizzare per un comando di strumentazione

Metodi pubblici

addBooleanArg

public 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 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 void cancel ()

Richiede l'annullamento di questo test.

createParser

public IInstrumentationResultParser createParser (String runName, 
                 listeners)

Crea il InstrumentationResultParser che verrà utilizzato per analizzare l'output della strumentazione.

Parametri
runName String: il nome dell'esecuzione da utilizzare.
listeners : i listener a cui segnalare i risultati.
Ritorni
IInstrumentationResultParser Un'istanza di InstrumentationResultParser.

getAmInstrumentCommand

public String getAmInstrumentCommand ()

Ritorni
String

getCoverageOutputType

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

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

Ritorni
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public String getPackageName ()

Restituisce il nome del pacchetto dell'applicazione.

Ritorni
String

getRunOptions

public String getRunOptions ()

Restituisce le opzioni per il comando dello strumento am.

Ritorni
String

getRunnerName

public String getRunnerName ()

Restituisce runnerName.

Ritorni
String

removeInstrumentationArg

public 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 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
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

run

public void run ( listeners)

Esegui questa esecuzione di test.

Parametri
listeners : raccolta di listener per i risultati del test
Lanci
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation

public 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 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 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 void setCoverage (boolean coverage)

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

Parametri
coverage boolean

setCoverageReportLocation

public void setCoverageReportLocation (String reportPath)

Imposta la posizione dei report sulla copertura generati.

Parametri
reportPath String

setDebug

public 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 void setLogOnly (boolean logOnly)

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

Parametri
logOnly boolean

setMaxTimeToOutputResponse

public 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 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 void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Parametri
maxTimeToOutputResponse int

setMethodName

public 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 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

setRunOptions

public void setRunOptions (String options)

Imposta le opzioni per il comando am instrument. Per l'elenco completo delle opzioni, consulta com/android/commands/am/Am.java.

Parametri
options String

setTestCollection

public void setTestCollection (boolean collect)

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
collect boolean

setTestPackageName

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

Metodi protetti

getArgsCommand

protected String getArgsCommand ()

Restituisce la sintassi completa della riga di comando di strumentazione per gli argomenti di strumentazione forniti. Restituisce una stringa vuota se non sono stati specificati argomenti.

Ritorni
String

getRunnerPath

protected String getRunnerPath ()

Restituisce il percorso completo del componente di strumentazione.

Ritorni
String