Ab 2026 werden wir, um unser stabiles Entwicklungsmodell für den Trunk zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten, den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen. Verwenden Sie android-latest-release, um AOSP zu entwickeln und dazu beizutragen. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 dem android.support.test.runner.AndroidJUnitRunner ausführt.
CodeCoverageTest	Ein Test, der ein Instrumentierungstestpaket auf einem bestimmten Gerät ausführt und den Codeabdeckungsbericht 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`	`mInstrumentInPcc`
`protected boolean`	`mInstrumentSdkInSandbox`
`protected boolean`	`mInstrumentSdkSandbox`

Öffentliche Konstruktoren
`InstrumentationTest()`

Öffentliche Methoden
`void`	`addDeviceListeners(Set<String> 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 für die Instrumentierung festgelegte maximale Zeitlimit zurück.
`String`	`getPackageName()` Das Android-Manifestpaket zum Ausführen abrufen.
`String`	`getRunName()` Benutzerdefinierten Testlaufnamen abrufen, der an den Listener übergeben wird
`String`	`getRunnerName()` Ruft den zu verwendenden Android-Instrumentierungs-Runner ab.
`boolean`	`isCollectTestsOnly()`
`boolean`	`isOrchestrator()` Gibt den Wert von `ERROR(InstrumentationTest.mOrchestrator/#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 wurde eingestellt. 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)` Schleusen Sie das zu testende Gerät ein.
`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(List<IMetricCollector> 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`	`setRetryAttemptNumber(int attemptNumber)` Legt die Anzahl der Wiederholungsversuche für den Test fest. Legt die Nummer des Wiederholungsversuchs fest, indem sie als Instrumentierungsargument „retry_attempt“ an den geräteseitigen Runner übergeben wird.
`void`	`setRunName(String runName)` Benutzerdefinierten Testlaufnamen festlegen, der an den Listener übergeben wird
`void`	`setRunnerName(String runnerName)` Legen Sie optional den zu verwendenden Android-Instrumentierungslaufzeit fest.
`void`	`setShellTimeout(long timeout)` Optional können Sie die maximale Zeit in Millisekunden festlegen, die auf die Shell-Ausgabe vom Gerät 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(Collection<TestDescription> tests)` Legen Sie die Sammlung von Tests fest, die von diesem InstrumentationTest ausgeführt werden sollen.
`void`	`setWindowAnimation(boolean windowAnimation)`

Geschützte Methoden
`static Set<TestDescription>`	`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 Java-Testpaket ab, das ausgeführt werden soll.
`String`	`queryRunnerName()` Fragen Sie das Gerät nach einem zu verwendenden Test-Runner ab.
`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

mInstrumentInPcc

protected boolean mInstrumentInPcc

mInstrumentSdkInSandbox

protected boolean mInstrumentSdkInSandbox

mInstrumentSdkSandbox

protected boolean mInstrumentSdkSandbox

Öffentliche Konstruktoren

InstrumentationTest

public InstrumentationTest ()

Öffentliche Methoden

addDeviceListeners

public void addDeviceListeners (Set<String> extraListeners)

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

Parameter
`extraListeners`	`Set`

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 ()

Gibt Folgendes zurück:
`IAbi`

getConfiguration

public IConfiguration getConfiguration ()

Ruft die IConfiguration für diesen Test ab.

Gibt Folgendes zurück:
`IConfiguration`

getCoverageTarget

public String getCoverageTarget ()

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

Gibt Folgendes zurück:
`String`

getDebug

public boolean getDebug ()

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

Gibt Folgendes zurück:
`boolean`	Die boolesche Debugging-Einstellung.

getDevice

public ITestDevice getDevice ()

Besorgen Sie sich das zu testende Gerät.

Gibt Folgendes zurück:
`ITestDevice`	die `ITestDevice`

getForceAbi

public String getForceAbi ()

Gibt Folgendes zurück:
`String`

getMaxTimeout

public long getMaxTimeout ()

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

Gibt Folgendes zurück:
`long`

getPackageName

public String getPackageName ()

Das Android-Manifestpaket zum Ausführen abrufen.

Gibt Folgendes zurück:
`String`

getRunName

public String getRunName ()

Benutzerdefinierten Testlaufnamen abrufen, der an den Listener übergeben wird

Gibt Folgendes zurück:
`String`

getRunnerName

public String getRunnerName ()

Ruft den zu verwendenden Android-Instrumentierungs-Runner ab.

Gibt Folgendes zurück:
`String`

isCollectTestsOnly

public boolean isCollectTestsOnly ()

Gibt Folgendes zurück:
`boolean`	Gibt an, ob sich dieser Test im Modus „Nur Tests erfassen“ befindet.

isOrchestrator

public boolean isOrchestrator ()

Gibt den Wert von ERROR(InstrumentationTest.mOrchestrator/#mOrchestrator InstrumentationTest.mOrchestrator) zurück.

Gibt Folgendes zurück:
`boolean`

run

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

Löst aus
`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 für diesen Test 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)

Schleusen Sie das zu testende Gerät ein.

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 `File`

IsolatedStorage

public void setIsolatedStorage (boolean isolatedStorage)

Gibt an, 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 (List<IMetricCollector> collectors)

Legt die Liste der IMetricCollector fest, die für den Testlauf definiert sind.

Parameter
`collectors`	`List`

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`

setRetryAttemptNumber

public void setRetryAttemptNumber (int attemptNumber)

Legt die Anzahl der Wiederholungsversuche für den Test fest. Standardmäßig wird nichts ausgeführt.

Legt die Nummer des Wiederholungsversuchs fest, indem sie als Instrumentierungsargument „retry_attempt“ an den geräteseitigen Runner übergeben wird.

Parameter
`attemptNumber`	`int`

setRunName

public void setRunName (String runName)

Benutzerdefinierten Testlaufnamen festlegen, der an den Listener übergeben wird

Parameter
`runName`	`String`

setRunnerName

public void setRunnerName (String runnerName)

Legen Sie optional den zu verwendenden Android-Instrumentierungslaufzeit 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 vom Gerät 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 nicht null, 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 (Collection<TestDescription> tests)

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

Parameter
`tests`	`Collection`: Die auszuführenden Tests.

setWindowAnimation

public void setWindowAnimation (boolean windowAnimation)

Parameter
`windowAnimation`	`boolean`

Geschützte Methoden

excludeNonExecuted

protected static Set<TestDescription> excludeNonExecuted (TestRunResult results)

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

Parameter
`results`	`TestRunResult`

Gibt Folgendes zurück:
`Set<TestDescription>`

getClassName

protected String getClassName ()

Rufen Sie den Namen der auszuführenden Klasse ab.

Gibt Folgendes zurück:
`String`

getListInstrumentationParser

protected ListInstrumentationParser getListInstrumentationParser ()

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

Gibt Folgendes zurück:
`ListInstrumentationParser`

getMethodName

protected String getMethodName ()

Rufen Sie die auszuführende Testmethode ab.

Gibt Folgendes zurück:
`String`

getTestPackageName

protected String getTestPackageName ()

Rufen Sie das Java-Testpaket ab, das ausgeführt werden soll.

Gibt Folgendes zurück:
`String`

queryRunnerName

protected String queryRunnerName ()

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

Gibt Folgendes zurück:
`String`	Der erste Testrunner-Name, der mit dem Paket übereinstimmt, oder „null“, wenn keiner gefunden wird.

Löst aus
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setRunnerArgs

protected void setRunnerArgs (IRemoteAndroidTestRunner runner)

Parameter
`runner`	`IRemoteAndroidTestRunner`