RemoteAndroidTestRunner

public class RemoteAndroidTestRunner
extends Object implements IRemoteAndroidTestRunner

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

---

Führt einen Android-Testbefehl remote aus und meldet die Ergebnisse.

Zusammenfassung

Öffentliche Konstruktoren
RemoteAndroidTestRunner(String packageName, IShellEnabledDevice remoteDevice) Alternativer Konstruktor.
RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice) Alternativer Konstruktor.
RemoteAndroidTestRunner(String packageName, String runnerName, IShellEnabledDevice remoteDevice, RemoteAndroidTestRunner.StatusReporterMode statusReporterMode) Erstellt einen Remote-Android-Testrunner.

Öffentliche Methoden
void	addBooleanArg(String name, boolean value) Fügt dem Instrumentierungsbefehl ein boolesches Argument hinzu.
void	addInstrumentationArg(String name, String value) Fügt dem Instrumentierungsbefehl ein Argument hinzu.
void	cancel() Fordert die Stornierung dieses Testlaufs an.
IInstrumentationResultParser	createParser(String runName, listeners) Erstellen Sie den InstrumentationResultParser, der zum Parsen der Instrumentierungsausgabe verwendet wird.
String	getAmInstrumentCommand()
IRemoteAndroidTestRunner.CoverageOutput	getCoverageOutputType() Gibt den Typ der Testabdeckung zurück, die vom Runner erzeugt wird.
String	getPackageName() Gibt den Paketnamen der Anwendung zurück.
String	getRunOptions() Gibt Optionen für den Befehl „am instrument“ zurück.
String	getRunnerName() Gibt den runnerName zurück.
void	removeInstrumentationArg(String name) Entfernt ein zuvor hinzugefügtes Argument.
void	run(ITestRunListener... listeners) Führen Sie diesen Testlauf aus.
void	run( listeners) Führen Sie diesen Testlauf aus.
void	setAdditionalTestOutputLocation(String additionalTestDataPath) Legt den Speicherort der zusätzlichen Testausgabe fest, die auf den Host kopiert werden soll, bevor die Test-App deinstalliert wird.
void	setClassName(String className) Legt fest, dass nur Tests in dieser Klasse ausgeführt werden. Muss vor „run“ aufgerufen werden.
void	setClassNames(String[] classNames) Legt fest, dass nur Tests in den angegebenen Klassen ausgeführt werden sollen. Muss vor „run“ aufgerufen werden.
void	setCoverage(boolean coverage) Legt den Code-Coverage-Modus für diesen Testlauf fest.
void	setCoverageReportLocation(String reportPath) Legt den Speicherort der generierten Abdeckungsberichte fest.
void	setDebug(boolean debug) Legt den Debug-Modus für diesen Testlauf fest.
void	setLogOnly(boolean logOnly) Legt für diesen Testlauf den reinen Protokollierungsmodus fest. Die Testausführung wird übersprungen.
void	setMaxTimeToOutputResponse(long maxTimeToOutputResponse, TimeUnit maxTimeUnits) Legt die maximal zulässige Zeit zwischen der Ausgabe des Shell-Befehls, mit dem die Tests auf den Geräten ausgeführt werden, fest.
void	setMaxTimeout(long maxTimeout, TimeUnit maxTimeUnits) Legt die maximal zulässige Zeit für den Abschluss der Instrumentierung fest.
void	setMaxtimeToOutputResponse(int maxTimeToOutputResponse)
void	setMethodName(String className, String testName) Legt fest, dass nur die angegebene Testmethode ausgeführt wird. Muss vor „run“ aufgerufen werden.
void	setRunName(String runName) Legen Sie einen benutzerdefinierten Namen für den Lauf fest, der am run() an ITestRunListener gemeldet werden soll. Wenn nichts angegeben ist, wird der Paketname verwendet.
void	setRunOptions(String options) Legt Optionen für den Befehl „am instrument“ fest.
void	setTestCollection(boolean collect) Legt für diesen Testlauf den Testsammlungsmodus fest.
void	setTestPackageName(String packageName) Legt fest, dass alle Tests im angegebenen Paket ausgeführt werden. Muss vor „run“ aufgerufen werden.
void	setTestSize(IRemoteAndroidTestRunner.TestSize size) Legt fest, dass nur Tests der angegebenen Größe ausgeführt werden.

Geschützte Methoden
String	getArgsCommand() Gibt die vollständige Befehlszeilensyntax für die bereitgestellten Instrumentierungsargumente zurück.
String	getRunnerPath() Gibt den vollständigen Pfad der Instrumentation-Komponente zurück.

Öffentliche Konstruktoren

RemoteAndroidTestRunner

public RemoteAndroidTestRunner (String packageName, 
                IShellEnabledDevice remoteDevice)

Alternativer Konstruktor. Verwendet den Standard-Instrumentierungs-Runner.

Parameter
packageName	String: Das Android-Anwendungspaket, das die auszuführenden Tests enthält
remoteDevice	IShellEnabledDevice: das Android-Gerät, auf dem Tests ausgeführt werden sollen

RemoteAndroidTestRunner

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

Alternativer Konstruktor. Verwendet den Standardwert statusReporterMode.

Parameter
packageName	String: Das Android-Anwendungspaket, das die auszuführenden Tests enthält
runnerName	String: Der Instrumentation-Testrunner, der ausgeführt werden soll. Wenn „null“, wird der Standard-Runner verwendet.
remoteDevice	IShellEnabledDevice: das Android-Gerät, auf dem Tests ausgeführt werden sollen

RemoteAndroidTestRunner

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

Erstellt einen Remote-Android-Testrunner.

Parameter
packageName	String: Das Android-Anwendungspaket, das die auszuführenden Tests enthält
runnerName	String: Der Instrumentation-Testrunner, der ausgeführt werden soll. Wenn „null“, wird der Standard-Runner verwendet.
remoteDevice	IShellEnabledDevice: das Android-Gerät, auf dem Tests ausgeführt werden sollen
statusReporterMode	RemoteAndroidTestRunner.StatusReporterMode: Der Statusberichtsmodus, der für einen Gerätebefehl verwendet werden soll.

Öffentliche Methoden

addBooleanArg

public void addBooleanArg (String name, 
                boolean value)

Fügt dem Instrumentierungsbefehl ein boolesches Argument hinzu.

Parameter
name	String: der Name des Arguments für das Instrumentierungs-Bundle
value	boolean: der Wert des Arguments

addInstrumentationArg

public void addInstrumentationArg (String name, 
                String value)

Fügt dem Instrumentierungsbefehl ein Argument hinzu.

Muss vor „run“ aufgerufen werden. Wenn ein Argument mit dem angegebenen Namen bereits bereitgestellt wurde, wird sein Wert überschrieben.

Parameter
name	String: der Name des Arguments für das Instrumentierungs-Bundle
value	String: der Wert des Arguments

Abbrechen

public void cancel ()

Fordert die Stornierung dieses Testlaufs an.

createParser

public IInstrumentationResultParser createParser (String runName, 
                 listeners)

Erstellen Sie den InstrumentationResultParser, der zum Parsen der Instrumentierungsausgabe verwendet wird.

Parameter
runName	String: Der Name des zu verwendenden Laufs.
listeners	: Die Listener, an die die Ergebnisse gemeldet werden sollen.

Returns
IInstrumentationResultParser	Eine Instanz von InstrumentationResultParser.

getAmInstrumentCommand

public String getAmInstrumentCommand ()

Returns
String

getCoverageOutputType

public IRemoteAndroidTestRunner.CoverageOutput getCoverageOutputType ()

Gibt den Typ der Testabdeckung zurück, die vom Runner erzeugt wird. CoverageOutput ansehen.

Returns
IRemoteAndroidTestRunner.CoverageOutput

getPackageName

public String getPackageName ()

Gibt den Paketnamen der Anwendung zurück.

Returns
String

getRunOptions

public String getRunOptions ()

Gibt Optionen für den Befehl „am instrument“ zurück.

Returns
String

getRunnerName

public String getRunnerName ()

Gibt den runnerName zurück.

Returns
String

removeInstrumentationArg

public void removeInstrumentationArg (String name)

Entfernt ein zuvor hinzugefügtes Argument.

Parameter
name	String: der Name des zu entfernenden Arguments für das Instrumentierungs-Bundle

Homerun

public void run (ITestRunListener... listeners)

Führen Sie diesen Testlauf aus.

Convenience-Methode für ERROR(/#run(Collection)).

Parameter
listeners	ITestRunListener: wartet auf Testergebnisse

Ausgabe
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

Homerun

public void run ( listeners)

Führen Sie diesen Testlauf aus.

Parameter
listeners	: Sammlung von Listenern für Testergebnisse

Ausgabe
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

setAdditionalTestOutputLocation

public void setAdditionalTestOutputLocation (String additionalTestDataPath)

Legt den Speicherort der zusätzlichen Testausgabe fest, die auf den Host kopiert werden soll, bevor die Test-App deinstalliert wird. z.B. generierte Benchmarkberichte.

Parameter
additionalTestDataPath	String

setClassName

public void setClassName (String className)

Legt fest, dass nur Tests in dieser Klasse ausgeführt werden. Muss vor „run“ aufgerufen werden.

Parameter
className	String: Vollständig qualifizierter Klassenname (z. B. x.y.z)

setClassNames

public void setClassNames (String[] classNames)

Legt fest, dass nur Tests in den angegebenen Klassen ausgeführt werden sollen. Muss vor „run“ aufgerufen werden.

Wenn Sie mehr als eine Klasse angeben, ist ein InstrumentationTestRunner erforderlich, der die Syntax für mehrere Klassenargumente unterstützt.

Parameter
classNames	String: Array mit vollständig qualifizierten Klassennamen (z. B. x.y.z)

setCoverage

public void setCoverage (boolean coverage)

Legt den Code-Coverage-Modus für diesen Testlauf fest.

Parameter
coverage	boolean

setCoverageReportLocation

public void setCoverageReportLocation (String reportPath)

Legt den Speicherort der generierten Abdeckungsberichte fest.

Parameter
reportPath	String

setDebug

public void setDebug (boolean debug)

Legt den Debug-Modus für diesen Testlauf fest. Wenn „true“, wartet der Android-Test-Runner, bis ein Debugger angehängt wird, bevor er mit der Testausführung fortfährt.

Parameter
debug	boolean

setLogOnly

public void setLogOnly (boolean logOnly)

Legt für diesen Testlauf den reinen Protokollierungsmodus fest. Die Testausführung wird übersprungen.

Parameter
logOnly	boolean

setMaxTimeToOutputResponse

public void setMaxTimeToOutputResponse (long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Legt die maximal zulässige Zeit zwischen der Ausgabe des Shell-Befehls, mit dem die Tests auf den Geräten ausgeführt werden, fest.

So kann ein Zeitlimit festgelegt werden, falls die Tests hängen bleiben und nie abgeschlossen werden. Dies unterscheidet sich von der normalen Zeitüberschreitung bei der Verbindung.

Standardmäßig wird kein Zeitlimit angegeben.

Parameter
maxTimeToOutputResponse	long: Die maximale Zeit, in der der Befehl keine Ausgabe erzeugen darf. Ein Wert von 0 bedeutet, dass die Methode unbegrenzt auf die Befehlsausgabe wartet (bis receiver die Ausführung abbricht) und nie eine Ausnahme auslöst.
maxTimeUnits	TimeUnit: Einheiten für maxTimeToOutputResponse- und maxTimeout-Werte ungleich null.

setMaxTimeout

public void setMaxTimeout (long maxTimeout, 
                TimeUnit maxTimeUnits)

Legt die maximal zulässige Zeit für den Abschluss der Instrumentierung fest.

So kann ein Zeitlimit festgelegt werden, falls die Tests hängen bleiben und nie abgeschlossen werden. Dies unterscheidet sich von der normalen Zeitüberschreitung bei der Verbindung.

Standardmäßig wird kein Zeitlimit angegeben.

Parameter
maxTimeout	long: Die maximale Zeit, in der der Befehl keine Antwort ausgeben darf. Ein Wert von 0 bedeutet, dass die Methode unbegrenzt auf die Befehlsausgabe wartet (bis receiver die Ausführung abbricht) und nie eine Ausnahme auslöst.
maxTimeUnits	TimeUnit: Einheiten für maxTimeToOutputResponse- und maxTimeout-Werte ungleich null.

setMaxtimeToOutputResponse

public void setMaxtimeToOutputResponse (int maxTimeToOutputResponse)

Parameter
maxTimeToOutputResponse	int

setMethodName

public void setMethodName (String className, 
                String testName)

Legt fest, dass nur die angegebene Testmethode ausgeführt wird. Muss vor „run“ aufgerufen werden.

Parameter
className	String: Vollständig qualifizierter Klassenname (z. B. x.y.z)
testName	String: Name der Methode

setRunName

public void setRunName (String runName)

Legen Sie einen benutzerdefinierten Namen für den Lauf fest, der am run() an ITestRunListener gemeldet werden soll.

Wenn nichts angegeben ist, wird der Paketname verwendet.

setRunOptions

public void setRunOptions (String options)

Legt Optionen für den Befehl „am instrument“ fest. Eine vollständige Liste der Optionen finden Sie unter com/android/commands/am/Am.java.

Parameter
options	String

setTestCollection

public void setTestCollection (boolean collect)

Legt für diesen Testlauf den Testsammlungsmodus fest. Bei „true“ wird die Testausführung übersprungen und alle entsprechenden Runner-Argumente festgelegt, die für eine erfolgreiche Testsammlung erforderlich sind.

Parameter
collect	boolean

setTestPackageName

public void setTestPackageName (String packageName)

Legt fest, dass alle Tests im angegebenen Paket ausgeführt werden. Muss vor „run“ aufgerufen werden.

Parameter
packageName	String: Vollständig qualifizierter Paketname (z. B. x.y.z)

setTestSize

public void setTestSize (IRemoteAndroidTestRunner.TestSize size)

Legt fest, dass nur Tests der angegebenen Größe ausgeführt werden. Muss vor „run“ aufgerufen werden.

Parameter
size	IRemoteAndroidTestRunner.TestSize: Die auszuführende TestSize.

Geschützte Methoden

getArgsCommand

protected String getArgsCommand ()

Gibt die vollständige Befehlszeilensyntax für die bereitgestellten Instrumentierungsargumente zurück. Gibt einen leeren String zurück, wenn keine Argumente angegeben wurden.

Returns
String

getRunnerPath

protected String getRunnerPath ()

Gibt den vollständigen Pfad der Instrumentation-Komponente zurück.

Returns
String