Instrumentierungstest

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

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

Bekannte direkte abgeleitete Klassen AndroidJUnitTest, CodeAbdeckungTest AndroidJUnitTest Ein Test, bei dem ein Instrumentierungstestpaket auf einem bestimmten Gerät mit dem android.support.test.runner.AndroidJUnitRunner.  Codeabdeckungstest Ein Test, der ein Instrumentierungstestpaket auf einem bestimmten Gerät ausführt wird der Bericht zur Codeabdeckung erstellt.

---

Test, der ein Instrumentierungstestpaket auf einem bestimmten Gerät ausführt.

Zusammenfassung

Felder
public static final String	RUN_TESTS_AS_USER_KEY
public static final String	RUN_TESTS_ON_SDK_SANDBOX
protected boolean	mDebug
protected boolean	mInstrumentSdkInSandbox
protected boolean	mInstrumentSdkSandbox

Öffentliche Konstruktoren
InstrumentationTest()

Öffentliche Methoden
void	addDeviceListeners( extraListeners) Ermöglicht das Hinzufügen weiterer benutzerdefinierter Listener für den Runner
void	addInstrumentationArg(String key, String value) Fügen Sie ein Argument hinzu, das beim Ausführen der Instrumentierungstests bereitgestellt werden soll.
IAbi	getAbi()
IConfiguration	getConfiguration() Ruft den IConfiguration für diesen Test ab.
String	getCoverageTarget() Ruft das zuvor über setCoverageTarget(String) festgelegte Einstellung für „AbdeckungTarget“ ab.
boolean	getDebug() Rufen Sie die Debugging-Einstellung für die Instrumentierung ab.
ITestDevice	getDevice() Holen Sie sich das zu testende Gerät.
String	getForceAbi()
long	getMaxTimeout() Gibt das für die Instrumentierung festgelegte maximale Zeitlimit zurück.
String	getPackageName() Rufen Sie das Android-Manifestpaket zur Ausführung ab.
String	getRunName() Benutzerdefinierten Testlaufnamen abrufen, der für den Listener bereitgestellt wird
String	getRunnerName() Ruft den zu verwendenden Android-Instrumentierungs-Runner ab.
boolean	isOrchestrator() Gibt den Wert von ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator) zurück
void	run(TestInformation testInfo, ITestInvocationListener listener) Führt die Tests aus und meldet das Ergebnis an den Listener.
void	setAbi(IAbi abi)
void	setClassName(String testClassName) Legen Sie optional den Namen der Testklasse fest, die ausgeführt werden soll.
void	setCollectTestsOnly(boolean shouldCollectTest) Aktiviert oder deaktiviert den Testerfassungsmodus
void	setCollectsTestsShellTimeout(int timeout) <ph type="x-smartling-placeholder"></ph> Diese Methode wurde eingestellt. Diese Methode ist ein Leerbefehl.
void	setConfiguration(IConfiguration config) Injiziertes IConfiguration in Gebrauch.
void	setCoverageTarget(String coverageTarget) Legen Sie das Abdeckungsziel für diesen Test fest.
void	setDebug(boolean debug) Legen Sie die Fehlerbehebungseinstellung für die Instrumentierung fest.
void	setDevice(ITestDevice device) Injizieren Sie das zu testende Gerät.
void	setEnforceFormat(boolean enforce) Legen Sie „True“ fest, wenn das AJUR-Ausgabeformat der Instrumentierung erzwungen wird.
void	setForceAbi(String abi) Legt die Force-Abi-Option fest.
void	setInstallFile(File installFile) Legen Sie die optionale zu installierende Datei fest, die die Tests enthält.
void	setIsolatedStorage(boolean isolatedStorage) Legen Sie fest, ob der isolierte Speicher verwendet werden soll oder nicht.
void	setMethodName(String testMethodName) Legen Sie optional die auszuführende Testmethode fest.
void	setMetricCollectors( collectors) Legt die Liste der für den Testlauf definierten IMetricCollector fest.
void	setOrchestrator(boolean useOrchestrator) Legt die Option --orchestrator fest
void	setPackageName(String packageName) Legen Sie fest, dass das Android-Manifestpaket ausgeführt werden soll.
void	setReRunUsingTestFile(boolean reRunUsingTestFile) Legt die Option "--rerun-from-file" fest.
void	setRerunMode(boolean rerun) Legen Sie optional den Modus für die erneute Ausführung fest.
void	setRunName(String runName) Legen Sie den Namen der benutzerdefinierten Testausführung fest, der für den Listener bereitgestellt wird
void	setRunnerName(String runnerName) Optional können Sie den zu verwendenden Android-Instrumentierungs-Runner festlegen.
void	setShellTimeout(long timeout) Optional können Sie die maximale Zeit (in Millisekunden) für die Shell-Ausgabe des Geräts festlegen.
void	setTestFilePathOnDevice(String testFilePathOnDevice) Geben Sie optional als Pfad eine Datei auf dem Gerät an, die eine Liste mit Zeilen enthalten sollte. separate Testklassen und -methoden (Format: com.foo.Class#method), die ausgeführt werden sollen.
void	setTestPackageName(String testPackageName) Legt den Testpaketfilter fest.
void	setTestSize(String size) Legen Sie optional die Größe des Tests fest, der ausgeführt werden soll.
void	setTestTimeout(long timeout) Legen Sie optional für jeden einzelnen Testlauf eine maximale Dauer (in Millisekunden) fest.
void	setTestsToRun( tests) Legt die Sammlung von Tests fest, die von diesem InstrumentationTest ausgeführt werden sollen.
void	setWindowAnimation(boolean windowAnimation)

Geschützte Methoden
static	excludeNonExecuted(TestRunResult results) Filtern Sie "NOT_EXECUTED" heraus. und Skipped, um zu erfassen, was erneut ausgeführt werden muss.
String	getClassName() Rufen Sie den auszuführenden Kursnamen ab.
ListInstrumentationParser	getListInstrumentationParser() ListInstrumentationParser abrufen, die zum Parsen von „pm list instrumentation“ verwendet wird Abfragen.
String	getMethodName() Rufen Sie die Testmethode ab, die ausgeführt werden soll.
String	getTestPackageName() Rufen Sie das Java-Testpaket zur Ausführung ab.
String	queryRunnerName() Fragen Sie das Gerät nach einem Test-Runner ab, der verwendet werden soll.
void	setRunnerArgs(IRemoteAndroidTestRunner runner)

Felder

TEST_AS_USER_KEY_RUN_TESTS

public static final String RUN_TESTS_AS_USER_KEY

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

Fehlerbehebung

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Öffentliche Konstruktoren

Instrumentierungstest

public InstrumentationTest ()

Öffentliche Methoden

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Ermöglicht das Hinzufügen weiterer benutzerdefinierter Listener für den Runner

Parameter
extraListeners

InstrumentationArg hinzufügen

public void addInstrumentationArg (String key, 
                String value)

Fügen Sie ein Argument hinzu, das beim Ausführen der Instrumentierungstests bereitgestellt werden soll.

Parameter
key	String: der Name des Arguments
value	String: der Wert des Arguments

getAbi

public IAbi getAbi ()

Returns
IAbi

getConfiguration

public IConfiguration getConfiguration ()

Ruft den IConfiguration für diesen Test ab.

Returns
IConfiguration

getAbdeckungTarget

public String getCoverageTarget ()

Ruft das zuvor über setCoverageTarget(String) festgelegte Einstellung für „AbdeckungTarget“ ab.

Returns
String

Fehler beheben

public boolean getDebug ()

Rufen Sie die Debugging-Einstellung für die Instrumentierung ab.

Returns
boolean	Die boolesche Einstellung zur Fehlerbehebung.

getDevice

public ITestDevice getDevice ()

Holen Sie sich das zu testende Gerät.

Returns
ITestDevice	ITestDevice

getForceAbi

public String getForceAbi ()

Returns
String

getMaxTimeout

public long getMaxTimeout ()

Gibt das für die Instrumentierung festgelegte maximale Zeitlimit zurück.

Returns
long

getPackageName

public String getPackageName ()

Rufen Sie das Android-Manifestpaket zur Ausführung ab.

Returns
String

getRunName

public String getRunName ()

Benutzerdefinierten Testlaufnamen abrufen, der für den Listener bereitgestellt wird

Returns
String

getRunnerName

public String getRunnerName ()

Ruft den zu verwendenden Android-Instrumentierungs-Runner ab.

Returns
String

isOrchestrator

public boolean isOrchestrator ()

Gibt den Wert von ERROR(InstrumentationTest#mOrchestrator/com.android.tradefed.testtype.InstrumentationTest#mOrchestrator InstrumentationTest#mOrchestrator) zurück

Returns
boolean

Homerun

public void run (TestInformation testInfo, 
                ITestInvocationListener listener)

Führt die Tests aus und meldet das Ergebnis an den Listener.

Parameter
testInfo	TestInformation: Das TestInformation-Objekt mit nützlichen Informationen, die ausgeführt werden sollen. Tests durchführen.
listener	ITestInvocationListener: die ITestInvocationListener der Testergebnisse

Ausgabe
DeviceNotAvailableException

SetAbi

public void setAbi (IAbi abi)

Parameter
abi	IAbi

SetClassName

public void setClassName (String testClassName)

Legen Sie optional den Namen der Testklasse fest, die ausgeführt werden soll.

Parameter
testClassName	String

setCollectTestsOnly

public void setCollectTestsOnly (boolean shouldCollectTest)

Aktiviert oder deaktiviert den Testerfassungsmodus

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

<ph type="x-smartling-placeholder"></ph> Diese Methode wurde eingestellt.
Diese Methode ist ein No-Op

Legen Sie die maximale Zeit in ms fest, um die maximale Zeit für die Shell-Ausgabeantwort zu berücksichtigen bei der Erfassung Tests durchführen.

Parameter
timeout	int

setConfiguration

public void setConfiguration (IConfiguration config)

Injiziertes IConfiguration in Gebrauch.

Parameter
config	IConfiguration

Abdeckungsziel festlegen

public void setCoverageTarget (String coverageTarget)

Legen Sie das Abdeckungsziel für diesen Test fest.

Derzeit nicht verwendet. Diese Methode ist gerade vorhanden, sodass „AbdeckungTarget“ später über getCoverageTarget()

Parameter
coverageTarget	String

Fehlerbehebung festlegen

public void setDebug (boolean debug)

Legen Sie die Fehlerbehebungseinstellung für die Instrumentierung fest.

Parameter
debug	boolean: Boolescher Wert, auf den die Fehlerbehebungseinstellung für die Instrumentierung gesetzt werden soll.

Gerät festlegen

public void setDevice (ITestDevice device)

Injizieren Sie das zu testende Gerät.

Parameter
device	ITestDevice: die zu verwendende ITestDevice

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Legen Sie „True“ fest, wenn das AJUR-Ausgabeformat der Instrumentierung erzwungen wird.

Parameter
enforce	boolean

SetForceAbi

public void setForceAbi (String abi)

Legt die Force-Abi-Option fest.

Datei installieren

public void setInstallFile (File installFile)

Legen Sie die optionale zu installierende Datei fest, die die Tests enthält.

Parameter
installFile	File: die installierbare ERROR(/File)

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Legen Sie fest, ob der isolierte Speicher verwendet werden soll oder nicht.

Parameter
isolatedStorage	boolean

setMethodName

public void setMethodName (String testMethodName)

Legen Sie optional die auszuführende Testmethode fest.

Parameter
testMethodName	String

setMetricCollectors

public void setMetricCollectors ( collectors)

Legt die Liste der für den Testlauf definierten IMetricCollector fest.

Parameter
collectors

SetOrchestrator

public void setOrchestrator (boolean useOrchestrator)

Legt die Option --orchestrator fest

Parameter
useOrchestrator	boolean

SetPackageName

public void setPackageName (String packageName)

Legen Sie fest, dass das Android-Manifestpaket ausgeführt werden soll.

Parameter
packageName	String

setReRunUsingTestFile

public void setReRunUsingTestFile (boolean reRunUsingTestFile)

Legt die Option "--rerun-from-file" fest.

Parameter
reRunUsingTestFile	boolean

setRerunMode

public void setRerunMode (boolean rerun)

Legen Sie optional den Modus für die erneute Ausführung fest.

Parameter
rerun	boolean

setRunName

public void setRunName (String runName)

Legen Sie den Namen der benutzerdefinierten Testausführung fest, der für den Listener bereitgestellt wird

Parameter
runName	String

SetRunnerName

public void setRunnerName (String runnerName)

Optional können Sie den zu verwendenden Android-Instrumentierungs-Runner festlegen.

Parameter
runnerName	String

setShellTimeout

public void setShellTimeout (long timeout)

Optional können Sie die maximale Zeit (in Millisekunden) für die Shell-Ausgabe des Geräts festlegen.

Parameter
timeout	long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Geben Sie optional als Pfad eine Datei auf dem Gerät an, die eine Liste mit Zeilen enthalten sollte. separate Testklassen und -methoden (Format: com.foo.Class#method), die ausgeführt werden sollen. Wenn festgelegt, Es wird automatisch versucht, Tests mit dieser Testdatei über InstrumentationFileTest erneut auszuführen, anstatt für jeden verbleibenden Test separate ADB-Befehle auszuführen. durch Wiederholung.

Parameter
testFilePathOnDevice	String

SetTestPackageName

public void setTestPackageName (String testPackageName)

Legt den Testpaketfilter fest.

Wenn nicht null, werden nur Tests innerhalb des angegebenen Java-Pakets ausgeführt.

Wird ignoriert, wenn für setClassName(String) ein Wert ungleich null angegeben wurde

Parameter
testPackageName	String

setTestSize

public void setTestSize (String size)

Legen Sie optional die Größe des Tests fest, der ausgeführt werden soll.

Parameter
size	String

setTestTimeout

public void setTestTimeout (long timeout)

Legen Sie optional für jeden einzelnen Testlauf eine maximale Dauer (in Millisekunden) fest.

Parameter
timeout	long

setTestsToRun

public void setTestsToRun ( tests)

Legt die Sammlung von Tests fest, die von diesem InstrumentationTest ausgeführt werden sollen.

Parameter
tests	: die auszuführenden Tests

Fensteranimation festlegen

public void setWindowAnimation (boolean windowAnimation)

Parameter
windowAnimation	boolean

Geschützte Methoden

ausschließenNicht ausgeführt

protected static  excludeNonExecuted (TestRunResult results)

Filtern Sie "NOT_EXECUTED" heraus. und Skipped, um zu erfassen, was erneut ausgeführt werden muss.

Parameter
results	TestRunResult

Returns

GetClassName

protected String getClassName ()

Rufen Sie den auszuführenden Kursnamen ab.

Returns
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

ListInstrumentationParser abrufen, die zum Parsen von „pm list instrumentation“ verwendet wird Abfragen.

Returns
ListInstrumentationParser

getMethodName

protected String getMethodName ()

Rufen Sie die Testmethode ab, die ausgeführt werden soll.

Returns
String

getTestPackageName

protected String getTestPackageName ()

Rufen Sie das Java-Testpaket zur Ausführung ab.

Returns
String

queryRunnerName (Abfragename)

protected String queryRunnerName ()

Fragen Sie das Gerät nach einem Test-Runner ab, der verwendet werden soll.

Returns
String	den Namen des ersten Test-Runners, der mit dem Paket übereinstimmt, oder null, wenn kein Name gefunden wird.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parameter
runner	IRemoteAndroidTestRunner