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 verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

DeviceTestRunOptions

public class DeviceTestRunOptions
extends Object

java.lang.Object
↳	com.android.tradefed.testtype.junit4.DeviceTestRunOptions

Eine Builder-Klasse für Optionen im Zusammenhang mit dem Ausführen von Gerätetests über BaseHostJUnit4Test.

Zusammenfassung

Öffentliche Konstruktoren
`DeviceTestRunOptions(String packageName)`

Öffentliche Methoden
`DeviceTestRunOptions`	`addExtraListener(ITestLifeCycleReceiver listener)` Fügen Sie der ausgeführten Instrumentierung einen zusätzlichen Listener hinzu.
`DeviceTestRunOptions`	`addInstrumentationArg(String key, String value)` Fügen Sie ein Argument hinzu, das an die Instrumentierung übergeben wird.
`void`	`clearExtraListeners()`
`void`	`clearInstrumentationArgs()` Löschen Sie alle Instrumentierungsargumente, die zuvor mit `addInstrumentationArg(String,String)` festgelegt wurden.
`String`	`getApkFileName()` Gibt den Namen der APK-Datei für die APK-Installation zurück.
`ITestDevice`	`getDevice()`
`List<ITestLifeCycleReceiver>`	`getExtraListeners()`
`String[]`	`getInstallArgs()` Gibt zusätzliche Optionen des Installationsbefehls zurück.
`Map<String, String>`	`getInstrumentationArgs()`
`Long`	`getMaxInstrumentationTimeoutMs()`
`Long`	`getMaxTimeToOutputMs()`
`String`	`getPackageName()`
`String`	`getRunner()`
`String`	`getTestClassName()`
`String`	`getTestMethodName()`
`Long`	`getTestTimeoutMs()`
`Integer`	`getUserId()`
`boolean`	`isForceQueryable()` Gibt an, ob die zu installierende APK abgefragt werden soll.
`boolean`	`isGrantPermission()` Gibt an, ob Berechtigungen für die APK-Installation erteilt werden sollen.
`boolean`	`isHiddenApiCheckDisabled()`
`boolean`	`isInstrumentInPcc()` Gibt an, ob „--instrument-in-pcc“ zum „am instrument“ hinzugefügt werden soll, das von der Hostseite aus verwendet wird.
`boolean`	`isIsolatedStorageDisabled()`
`boolean`	`isRestartDisabled()`
`boolean`	`isTestApiCheckDisabled()`
`boolean`	`isWindowAnimationDisabled()`
`DeviceTestRunOptions`	`setApkFileName(String apkFileName)` Legt den Namen der APK-Datei für die APK-Installation fest.
`DeviceTestRunOptions`	`setCheckResults(boolean checkResults)` Legt fest, ob die Ergebnisse des Instrumentierungslaufs geprüft werden sollen und ob Fehler aufgetreten sind.
`DeviceTestRunOptions`	`setDevice(ITestDevice device)`
`DeviceTestRunOptions`	`setDisableHiddenApiCheck(boolean disableHiddenApiCheck)` Legt fest, ob der „am instrument“-Befehl, der auf der Hostseite verwendet wird, um die Option „--no-hidden-api-checks“ ergänzt werden soll.
`DeviceTestRunOptions`	`setDisableIsolatedStorage(boolean disableIsolatedStorage)` Legt fest, ob der Option „am instrument“ auf Hostseite „--no-isolated-storage“ hinzugefügt werden soll.
`DeviceTestRunOptions`	`setDisableRestart(boolean disableRestart)` Legt fest, ob dem von der Hostseite verwendeten „am instrument“-Befehl die Option „--no-restart“ hinzugefügt werden soll.
`DeviceTestRunOptions`	`setDisableTestApiCheck(boolean disableTestApiCheck)` Legt fest, ob der „am instrument“-Befehl, der von der Hostseite aus verwendet wird, die Option „--no-test-api-access“ enthalten soll.
`DeviceTestRunOptions`	`setDisableWindowAnimation(boolean disableWindowAnimation)` Legt fest, ob der „am instrument“-Befehl, der auf der Hostseite verwendet wird, die Option „--no-window-animation“ enthalten soll.
`DeviceTestRunOptions`	`setForceQueryable(boolean forceQueryable)` Legt `false` fest, wenn das zu installierende APK nicht abgefragt werden soll.
`DeviceTestRunOptions`	`setGrantPermission(boolean grantPermission)` Gewährt Berechtigungen für die APK-Installation.
`DeviceTestRunOptions`	`setInstallArgs(String... installArgs)` Legt zusätzliche Optionen für den Installationsbefehl fest.
`DeviceTestRunOptions`	`setInstrumentInPcc(boolean instrumentInPcc)` Legt fest, ob dem „am instrument“-Befehl, der vom Host aus verwendet wird, „--instrument-in-pcc“ hinzugefügt werden soll.
`DeviceTestRunOptions`	`setMaxInstrumentationTimeoutMs(Long maxInstrumentationTimeoutMs)` Legt die maximale Zeit in Millisekunden fest, die für die Ausführung und den Abschluss der gesamten Instrumentierung zur Verfügung steht.
`DeviceTestRunOptions`	`setMaxTimeToOutputMs(Long maxTimeToOutputMs)` Legt die maximale Zeit in Millisekunden fest, die die Instrumentierung mit der Ausgabe warten kann, bevor sie beendet wird.
`DeviceTestRunOptions`	`setRunner(String runner)` Legt den Instrumentation Runner fest, der zum Ausführen der Instrumentation verwendet werden soll.
`DeviceTestRunOptions`	`setTestClassName(String testClassName)` Legt den Klassennamen fest, für den die Instrumentierung ausgeführt werden soll.
`DeviceTestRunOptions`	`setTestMethodName(String testMethodName)` Legt den Methodennamen fest, für den die Instrumentierung ausgeführt werden soll.
`DeviceTestRunOptions`	`setTestTimeoutMs(Long testTimeoutMs)` Legt die maximale Zeit (in Millisekunden) fest, die ein Test ausgeführt werden kann, bevor er unterbrochen wird.
`DeviceTestRunOptions`	`setUserId(Integer userId)` Legt die Nutzer-ID fest, für die die Instrumentierung ausgeführt werden soll.
`boolean`	`shouldCheckResults()`

Öffentliche Konstruktoren

DeviceTestRunOptions

public DeviceTestRunOptions (String packageName)

Parameter
`packageName`	`String`

Öffentliche Methoden

addExtraListener

public DeviceTestRunOptions addExtraListener (ITestLifeCycleReceiver listener)

Fügen Sie der ausgeführten Instrumentierung einen zusätzlichen Listener hinzu.

Parameter
`listener`	`ITestLifeCycleReceiver`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

addInstrumentationArg

public DeviceTestRunOptions addInstrumentationArg (String key, 
                String value)

Fügen Sie ein Argument hinzu, das an die Instrumentierung übergeben wird.

Parameter
`key`	`String`
`value`	`String`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

clearExtraListeners

public void clearExtraListeners ()

clearInstrumentationArgs

public void clearInstrumentationArgs ()

Löschen Sie alle Instrumentierungsargumente, die zuvor mit addInstrumentationArg(String,String) festgelegt wurden.

getApkFileName

public String getApkFileName ()

Gibt den Namen der APK-Datei für die APK-Installation zurück.

Gibt Folgendes zurück:
`String`

getDevice

public ITestDevice getDevice ()

Gibt Folgendes zurück:
`ITestDevice`

getExtraListeners

public List<ITestLifeCycleReceiver> getExtraListeners ()

Gibt Folgendes zurück:
`List<ITestLifeCycleReceiver>`

getInstallArgs

public String[] getInstallArgs ()

Gibt zusätzliche Optionen des Installationsbefehls zurück.

Gibt Folgendes zurück:
`String[]`

getInstrumentationArgs

public Map<String, String> getInstrumentationArgs ()

Gibt Folgendes zurück:
`Map<String, String>`

getMaxInstrumentationTimeoutMs

public Long getMaxInstrumentationTimeoutMs ()

Gibt Folgendes zurück:
`Long`

getMaxTimeToOutputMs

public Long getMaxTimeToOutputMs ()

Gibt Folgendes zurück:
`Long`

getPackageName

public String getPackageName ()

Gibt Folgendes zurück:
`String`

getRunner

public String getRunner ()

Gibt Folgendes zurück:
`String`

getTestClassName

public String getTestClassName ()

Gibt Folgendes zurück:
`String`

getTestMethodName

public String getTestMethodName ()

Gibt Folgendes zurück:
`String`

getTestTimeoutMs

public Long getTestTimeoutMs ()

Gibt Folgendes zurück:
`Long`

getUserId

public Integer getUserId ()

Gibt Folgendes zurück:
`Integer`

isForceQueryable

public boolean isForceQueryable ()

Gibt an, ob die zu installierende APK abgefragt werden soll. Der Standardwert ist true.

Gibt Folgendes zurück:
`boolean`

isGrantPermission

public boolean isGrantPermission ()

Gibt an, ob Berechtigungen für die APK-Installation erteilt werden sollen.

Gibt Folgendes zurück:
`boolean`

isHiddenApiCheckDisabled

public boolean isHiddenApiCheckDisabled ()

Gibt Folgendes zurück:
`boolean`

isInstrumentInPcc

public boolean isInstrumentInPcc ()

Gibt an, ob „--instrument-in-pcc“ zum „am instrument“ hinzugefügt werden soll, das von der Hostseite aus verwendet wird.

Gibt Folgendes zurück:
`boolean`

isIsolatedStorageDisabled

public boolean isIsolatedStorageDisabled ()

Gibt Folgendes zurück:
`boolean`

isRestartDisabled

public boolean isRestartDisabled ()

Gibt Folgendes zurück:
`boolean`

isTestApiCheckDisabled

public boolean isTestApiCheckDisabled ()

Gibt Folgendes zurück:
`boolean`

isWindowAnimationDisabled

public boolean isWindowAnimationDisabled ()

Gibt Folgendes zurück:
`boolean`

setApkFileName

public DeviceTestRunOptions setApkFileName (String apkFileName)

Legt den Namen der APK-Datei für die APK-Installation fest.

Parameter
`apkFileName`	`String`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setCheckResults

public DeviceTestRunOptions setCheckResults (boolean checkResults)

Legt fest, ob die Ergebnisse des Instrumentierungslaufs geprüft werden sollen und ob Fehler aufgetreten sind.

Parameter
`checkResults`	`boolean`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setDevice

public DeviceTestRunOptions setDevice (ITestDevice device)

Parameter
`device`	`ITestDevice`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setDisableHiddenApiCheck

public DeviceTestRunOptions setDisableHiddenApiCheck (boolean disableHiddenApiCheck)

Legt fest, ob der „am instrument“-Befehl, der auf der Hostseite verwendet wird, um die Option „--no-hidden-api-checks“ ergänzt werden soll.

Parameter
`disableHiddenApiCheck`	`boolean`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setDisableIsolatedStorage

public DeviceTestRunOptions setDisableIsolatedStorage (boolean disableIsolatedStorage)

Legt fest, ob der Option „am instrument“ auf Hostseite „--no-isolated-storage“ hinzugefügt werden soll.

Parameter
`disableIsolatedStorage`	`boolean`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setDisableRestart

public DeviceTestRunOptions setDisableRestart (boolean disableRestart)

Legt fest, ob dem von der Hostseite verwendeten „am instrument“-Befehl die Option „--no-restart“ hinzugefügt werden soll.

Parameter
`disableRestart`	`boolean`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setDisableTestApiCheck

public DeviceTestRunOptions setDisableTestApiCheck (boolean disableTestApiCheck)

Legt fest, ob der „am instrument“-Befehl, der von der Hostseite aus verwendet wird, die Option „--no-test-api-access“ enthalten soll.

Parameter
`disableTestApiCheck`	`boolean`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setDisableWindowAnimation

public DeviceTestRunOptions setDisableWindowAnimation (boolean disableWindowAnimation)

Legt fest, ob der „am instrument“-Befehl, der auf der Hostseite verwendet wird, die Option „--no-window-animation“ enthalten soll.

Parameter
`disableWindowAnimation`	`boolean`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setForceQueryable

public DeviceTestRunOptions setForceQueryable (boolean forceQueryable)

Legt false fest, wenn das zu installierende APK nicht abgefragt werden soll.

Parameter
`forceQueryable`	`boolean`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setGrantPermission

public DeviceTestRunOptions setGrantPermission (boolean grantPermission)

Gewährt Berechtigungen für die APK-Installation.

Parameter
`grantPermission`	`boolean`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setInstallArgs

public DeviceTestRunOptions setInstallArgs (String... installArgs)

Legt zusätzliche Optionen für den Installationsbefehl fest.

Parameter
`installArgs`	`String`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setInstrumentInPcc

public DeviceTestRunOptions setInstrumentInPcc (boolean instrumentInPcc)

Legt fest, ob dem „am instrument“-Befehl, der vom Host aus verwendet wird, „--instrument-in-pcc“ hinzugefügt werden soll.

Parameter
`instrumentInPcc`	`boolean`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setMaxInstrumentationTimeoutMs

public DeviceTestRunOptions setMaxInstrumentationTimeoutMs (Long maxInstrumentationTimeoutMs)

Legt die maximale Zeit in Millisekunden fest, die für die Ausführung und den Abschluss der gesamten Instrumentierung zur Verfügung steht. Legen Sie diese Option auf 0 fest, wenn kein Zeitlimit gelten soll. Optional.

Parameter
`maxInstrumentationTimeoutMs`	`Long`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setMaxTimeToOutputMs

public DeviceTestRunOptions setMaxTimeToOutputMs (Long maxTimeToOutputMs)

Legt die maximale Zeit in Millisekunden fest, die die Instrumentierung mit der Ausgabe warten kann, bevor sie beendet wird. Legen Sie diese Option auf 0 fest, wenn kein Zeitlimit gelten soll. Optional.

Parameter
`maxTimeToOutputMs`	`Long`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setRunner

public DeviceTestRunOptions setRunner (String runner)

Legt den Instrumentation Runner fest, der zum Ausführen der Instrumentation verwendet werden soll. Der Standard-Runner ist „android.support.test.runner.AndroidJUnitRunner“. Optional.

Parameter
`runner`	`String`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setTestClassName

public DeviceTestRunOptions setTestClassName (String testClassName)

Legt den Klassennamen fest, für den die Instrumentierung ausgeführt werden soll. Die Instrumentierung wird gefiltert, sodass nur die Klasse ausgeführt wird. Kann mit setTestMethodName(String) verwendet werden. Optional.

Parameter
`testClassName`	`String`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setTestMethodName

public DeviceTestRunOptions setTestMethodName (String testMethodName)

Legt den Methodennamen fest, für den die Instrumentierung ausgeführt werden soll. Damit die Funktion richtig funktioniert, muss setTestClassName(String) festgelegt sein. Optional.

Parameter
`testMethodName`	`String`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setTestTimeoutMs

public DeviceTestRunOptions setTestTimeoutMs (Long testTimeoutMs)

Legt die maximale Zeit (in Millisekunden) fest, die ein Test ausgeführt werden kann, bevor er unterbrochen wird. Auf 0 setzen, wenn kein Zeitlimit festgelegt werden soll. Optional.

Parameter
`testTimeoutMs`	`Long`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

setUserId

public DeviceTestRunOptions setUserId (Integer userId)

Legt die Nutzer-ID fest, für die die Instrumentierung ausgeführt werden soll. Optional.

Parameter
`userId`	`Integer`

Gibt Folgendes zurück:
`DeviceTestRunOptions`

shouldCheckResults

public boolean shouldCheckResults ()

Gibt Folgendes zurück:
`boolean`