InstrumentationTest

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

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

Bekannte direkte Unterklassen AndroidJUnitTest, CodeCoverageTest AndroidJUnitTest Ein Test, der ein Instrumentierungstestpaket auf einem bestimmten Gerät mit android.support.test.runner.AndroidJUnitRunner ausführt.  CodeCoverageTest Ein Test, der ein Instrumentierungstestpaket auf einem bestimmten Gerät ausführt und den Code-Coverage-Bericht generiert.

---

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

Zusammenfassung

Konstanten
String	RUN_TESTS_AS_USER_KEY
String	RUN_TESTS_ON_SDK_SANDBOX

Felder
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 zum Runner
void	addInstrumentationArg(String key, String value) Fügen Sie ein Argument hinzu, das beim Ausführen der Instrumentierungstests angegeben werden soll.
IAbi	getAbi()
IConfiguration	getConfiguration() Ruft die IConfiguration für diesen Test ab.
String	getCoverageTarget() Rufen Sie das zuvor über setCoverageTarget(String) festgelegte coverageTarget ab.
boolean	getDebug() Rufen Sie die Debug-Einstellung für die Instrumentierung ab.
ITestDevice	getDevice() Besorgen Sie sich das zu testende Gerät.
String	getForceAbi()
long	getMaxTimeout() Gibt das maximale Zeitlimit zurück, das für die Instrumentierung festgelegt ist.
String	getPackageName() Rufen Sie das Android-Manifestpaket ab, das ausgeführt werden soll.
String	getRunName() Benutzerdefinierten Testlaufnamen abrufen, der an den Listener übergeben 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 Testsammlungsmodus
void	setCollectsTestsShellTimeout(int timeout) Diese Methode ist veraltet. Diese Methode ist ein No-Op.
void	setConfiguration(IConfiguration config) Fügt die verwendete IConfiguration ein.
void	setCoverageTarget(String coverageTarget) Legen Sie das Abdeckungsziel für diesen Test fest.
void	setDebug(boolean debug) Legen Sie die Debug-Einstellung für die Instrumentierung fest.
void	setDevice(ITestDevice device) Schließe das zu testende Gerät an.
void	setEnforceFormat(boolean enforce) Auf „True“ setzen, wenn das AJUR-Ausgabeformat der Instrumentierung erzwungen werden soll.
void	setForceAbi(String abi) Legt die Option „force-abi“ fest.
void	setInstallFile(File installFile) Legen Sie die optionale Datei fest, die die Tests enthält und installiert werden soll.
void	setIsolatedStorage(boolean isolatedStorage) Legen Sie fest, ob der isolierte Speicher verwendet werden soll.
void	setMethodName(String testMethodName) Legen Sie optional die auszuführende Testmethode fest.
void	setMetricCollectors( collectors) Legt die Liste der IMetricCollector fest, die für den Testlauf definiert sind.
void	setOrchestrator(boolean useOrchestrator) Legt die Option „--orchestrator“ fest.
void	setPackageName(String packageName) Legen Sie das Android-Manifestpaket fest, das ausgeführt werden soll.
void	setReRunUsingTestFile(boolean reRunUsingTestFile) Legt die Option „--rerun-from-file“ fest.
void	setRerunMode(boolean rerun) Optional können Sie den Wiederholungsmodus festlegen.
void	setRunName(String runName) Legt den benutzerdefinierten Namen für den Testlauf fest, der an den Listener übergeben wird.
void	setRunnerName(String runnerName) Legen Sie optional den zu verwendenden Android-Instrumentierungsläufer fest.
void	setShellTimeout(long timeout) Optional können Sie die maximale Zeit in Millisekunden festlegen, die auf die Shell-Ausgabe des Geräts gewartet wird.
void	setTestFilePathOnDevice(String testFilePathOnDevice) Optional können Sie den Pfad zu einer Datei auf dem Gerät festlegen, die eine Liste mit durch Zeilenumbrüche getrennten Testklassen und ‑methoden (Format: com.foo.Class#method) enthält, die ausgeführt werden sollen.
void	setTestPackageName(String testPackageName) Legt den Filter für das Testpaket fest.
void	setTestSize(String size) Legen Sie optional die Größe des auszuführenden Tests fest.
void	setTestTimeout(long timeout) Optional: Legen Sie die maximale Zeit (in Millisekunden) für jeden einzelnen Testlauf fest.
void	setTestsToRun( tests) Legen Sie 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“ und „Skipped“ heraus, um nachzuverfolgen, was noch einmal ausgeführt werden muss.
String	getClassName() Rufen Sie den Namen der auszuführenden Klasse ab.
ListInstrumentationParser	getListInstrumentationParser() Ruft die ListInstrumentationParser ab, die zum Parsen von „pm list instrumentation“-Abfragen verwendet wird.
String	getMethodName() Rufen Sie die auszuführende Testmethode ab.
String	getTestPackageName() Rufen Sie das auszuführende Java-Testpaket ab.
String	queryRunnerName() Fragen Sie das Gerät nach einem zu verwendenden Test-Runner.
void	setRunnerArgs(IRemoteAndroidTestRunner runner)

Konstanten

RUN_TESTS_AS_USER_KEY

public static final String RUN_TESTS_AS_USER_KEY

Konstanter Wert: "RUN_TESTS_AS_USER"

RUN_TESTS_ON_SDK_SANDBOX

public static final String RUN_TESTS_ON_SDK_SANDBOX

Konstanter Wert: "RUN_TESTS_ON_SDK_SANDBOX"

Felder

mDebug

protected boolean mDebug

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Öffentliche Konstruktoren

InstrumentationTest

public InstrumentationTest ()

Öffentliche Methoden

addDeviceListeners

public void addDeviceListeners ( extraListeners)

Ermöglicht das Hinzufügen weiterer benutzerdefinierter Listener zum Runner

Parameter
extraListeners

addInstrumentationArg

public void addInstrumentationArg (String key, 
                String value)

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

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

getAbi

public IAbi getAbi ()

Returns
IAbi

getConfiguration

public IConfiguration getConfiguration ()

Ruft die IConfiguration für diesen Test ab.

Returns
IConfiguration

getCoverageTarget

public String getCoverageTarget ()

Rufen Sie das zuvor über setCoverageTarget(String) festgelegte coverageTarget ab.

Returns
String

getDebug

public boolean getDebug ()

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

Returns
boolean	Die boolesche Debugging-Einstellung.

getDevice

public ITestDevice getDevice ()

Besorgen Sie sich das zu testende Gerät.

Returns
ITestDevice	die 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 ab, das ausgeführt werden soll.

Returns
String

getRunName

public String getRunName ()

Benutzerdefinierten Testlaufnamen abrufen, der an den Listener übergeben 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 zum Ausführen von Tests.
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 Testsammlungsmodus

setCollectsTestsShellTimeout

public void setCollectsTestsShellTimeout (int timeout)

Diese Methode wurde eingestellt.
Diese Methode ist eine Nulloperation.

Legen Sie die maximale Zeit in Millisekunden fest, die für die Antwort „max time to shell output response“ beim Erfassen von Tests zulässig ist.

Parameter
timeout	int

setConfiguration

public void setConfiguration (IConfiguration config)

Fügt die verwendete IConfiguration ein.

Parameter
config	IConfiguration

setCoverageTarget

public void setCoverageTarget (String coverageTarget)

Legen Sie das Abdeckungsziel dieses Tests fest.

Derzeit nicht verwendet. Diese Methode ist nur vorhanden, damit „coverageTarget“ später über getCoverageTarget() abgerufen werden kann.

Parameter
coverageTarget	String

setDebug

public void setDebug (boolean debug)

Legen Sie die Debug-Einstellung für die Instrumentierung fest.

Parameter
debug	boolean: Boolescher Wert, auf den die Debug-Einstellung für die Instrumentierung festgelegt werden soll.

setDevice

public void setDevice (ITestDevice device)

Schließe das zu testende Gerät an.

Parameter
device	ITestDevice: die zu verwendende ITestDevice

setEnforceFormat

public void setEnforceFormat (boolean enforce)

Auf „True“ setzen, wenn das AJUR-Ausgabeformat der Instrumentierung erzwungen werden soll.

Parameter
enforce	boolean

setForceAbi

public void setForceAbi (String abi)

Legt die Option „force-abi“ fest.

setInstallFile

public void setInstallFile (File installFile)

Legen Sie die optionale Datei fest, die die Tests enthält und installiert werden soll.

Parameter
installFile	File: die installierbare ERROR(/File)

setIsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

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

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 IMetricCollector fest, die für den Testlauf definiert sind.

Parameter
collectors

setOrchestrator

public void setOrchestrator (boolean useOrchestrator)

Legt die Option „--orchestrator“ fest.

Parameter
useOrchestrator	boolean

setPackageName

public void setPackageName (String packageName)

Legen Sie das Android-Manifestpaket fest, das 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)

Optional können Sie den Wiederholungsmodus festlegen.

Parameter
rerun	boolean

setRunName

public void setRunName (String runName)

Legt den benutzerdefinierten Namen für den Testlauf fest, der an den Listener übergeben wird.

Parameter
runName	String

setRunnerName

public void setRunnerName (String runnerName)

Legen Sie optional den zu verwendenden Android-Instrumentierungsläufer fest.

Parameter
runnerName	String

setShellTimeout

public void setShellTimeout (long timeout)

Optional können Sie die maximale Zeit in Millisekunden festlegen, die auf die Shell-Ausgabe des Geräts gewartet wird.

Parameter
timeout	long

setTestFilePathOnDevice

public void setTestFilePathOnDevice (String testFilePathOnDevice)

Optional können Sie den Pfad zu einer Datei auf dem Gerät festlegen, die eine Liste mit durch Zeilenumbrüche getrennten Testklassen und ‑methoden (Format: com.foo.Class#method) enthält, die ausgeführt werden sollen. Wenn diese Option festgelegt ist, wird automatisch versucht, Tests mit dieser Testdatei über InstrumentationFileTest noch einmal auszuführen, anstatt für jeden verbleibenden Test separate ADB-Befehle über „rerun“ auszuführen.

Parameter
testFilePathOnDevice	String

setTestPackageName

public void setTestPackageName (String testPackageName)

Legt den Filter für das Testpaket fest.

Wenn der Wert nicht null ist, werden nur Tests im angegebenen Java-Paket 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 auszuführenden Tests fest.

Parameter
size	String

setTestTimeout

public void setTestTimeout (long timeout)

Optional: Legen Sie die maximale Zeit (in Millisekunden) für jeden einzelnen Testlauf fest.

Parameter
timeout	long

setTestsToRun

public void setTestsToRun ( tests)

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

Parameter
tests	: Die auszuführenden Tests

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Parameter
windowAnimation	boolean

Geschützte Methoden

excludeNonExecuted

protected static  excludeNonExecuted (TestRunResult results)

Filtern Sie „NOT_EXECUTED“ und „Skipped“ heraus, um nachzuverfolgen, was noch einmal ausgeführt werden muss.

Parameter
results	TestRunResult

Returns

getClassName

protected String getClassName ()

Rufen Sie den Namen der auszuführenden Klasse ab.

Returns
String

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

Ruft die ListInstrumentationParser ab, die zum Parsen von „pm list instrumentation“-Abfragen verwendet wird.

Returns
ListInstrumentationParser

getMethodName

protected String getMethodName ()

Rufen Sie die auszuführende Testmethode ab.

Returns
String

getTestPackageName

protected String getTestPackageName ()

Rufen Sie das auszuführende Java-Testpaket ab.

Returns
String

queryRunnerName

protected String queryRunnerName ()

Fragen Sie das Gerät nach einem zu verwendenden Test-Runner.

Returns
String	Der erste Testlauf-Name, der mit dem Paket übereinstimmt, oder „null“, wenn keiner gefunden wird.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parameter
runner	IRemoteAndroidTestRunner