Ab 2026 werden wir den Quellcode im 2. und 4. Quartal in AOSP veröffentlichen, um unser trunk-stable-Entwicklungsmodell zu unterstützen und die Plattformstabilität für das Ökosystem zu gewährleisten. Für die Entwicklung und das Beitragen zu AOSP empfehlen wir die Verwendung von android-latest-release anstelle von aosp-main. Der Manifestzweig android-latest-release verweist immer auf das neueste Release, das an AOSP übertragen wurde. Weitere Informationen finden Sie unter Änderungen an AOSP.

INativeDevice

public interface INativeDevice

com.android.tradefed.device.INativeDevice

Bekannte indirekte Unterklassen

IManagedTestDevice, ITestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice, TestDevice

IManagedTestDevice	Ein ITestDevice, dessen Lebenszyklus verwaltet wird.
ITestDevice	Bietet eine zuverlässige API mit etwas höherem Niveau für eine ddmlib `IDevice`.
LocalAndroidVirtualDevice	Die Klasse für lokale virtuelle Geräte, die auf dem TradeFed-Host ausgeführt werden.
ManagedRemoteDevice	Ein Gerät, das auf einer virtuellen Maschine ausgeführt wird, die wir remote über eine Tradefed-Instanz auf der VM verwalten.
NativeDevice	Standardimplementierung von `ITestDevice` Nicht-Full-Stack-Android-Geräte
NestedRemoteDevice	Darstellung des Geräts, das in einer Remote-Cuttlefish-VM ausgeführt wird.
RemoteAndroidDevice	Implementierung eines `ITestDevice` für ein Full-Stack-Android-Gerät, das über „adb connect“ verbunden ist.
RemoteAndroidVirtualDevice	Erweitert das Verhalten von `RemoteAndroidDevice` für ein Android-Gerät mit vollständigem Stack, das in Google Compute Engine (GCE) ausgeführt wird.
TestDevice	Implementierung eines `ITestDevice` für ein Android-Gerät mit vollständigem Stack

Bietet eine zuverlässige API mit etwas höherem Niveau für eine ddmlib IDevice.

Gerätebefehle werden für einen konfigurierbaren Zeitraum wiederholt. Außerdem wird eine Schnittstelle zur Geräte-Wiederherstellung für Geräte bereitgestellt, die nicht reagieren.

Zusammenfassung

Konstanten
`int`	`UNKNOWN_API_LEVEL` Standardwert, wenn das API-Level nicht erkannt werden kann

Öffentliche Methoden
`abstract boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Prüfen, ob eine Funktion bei einem minimal unterstützten Level derzeit unterstützt wird.
`abstract void`	`clearLogcat()` Löscht alle angesammelten logcat-Daten.
`abstract void`	`deleteFile(String deviceFilePath)` Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät.
`abstract void`	`deleteFile(String deviceFilePath, int userId)` Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät.
`abstract boolean`	`deviceSoftRestarted(ProcessInfo prevSystemServerProcess)` Hilfsmethode zum Prüfen, ob das Gerät durch Vergleich des aktuellen system_server mit dem vorherigen system_server `ProcessInfo` neu gestartet wurde.
`abstract boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` Hilfsmethode, um zu prüfen, ob das Gerät seit der UTC-Zeit seit der Epoche vom Gerät und seinem `ERROR(/TimeUnit)` neu gestartet wurde.
`abstract boolean`	`disableAdbRoot()` Deaktiviert „adb root“.
`abstract boolean`	`doesFileExist(String deviceFilePath)` Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät vorhanden ist.
`abstract boolean`	`enableAdbRoot()` Aktiviert „adb root“.
`abstract String`	`executeAdbCommand(long timeout, String... commandArgs)` Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.
`abstract String`	`executeAdbCommand(String... commandArgs)` Hilfsmethode, die einen ADB-Befehl als Systembefehl ausführt.
`abstract String`	`executeAdbCommand(long timeout, envMap, String... commandArgs)` Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.
`abstract CommandResult`	`executeAdbV2Command(long timeout, envMap, String... commandArgs)` Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.
`abstract CommandResult`	`executeAdbV2Command(String... commandArgs)` Hilfsmethode, die einen ADB-Befehl als Systembefehl ausführt.
`abstract CommandResult`	`executeAdbV2Command(long timeout, String... commandArgs)` Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.
`abstract CommandResult`	`executeFastbootCommand(long timeout, String... commandArgs)` Hilfsmethode, die einen Fastboot-Befehl als Systembefehl ausführt.
`abstract CommandResult`	`executeFastbootCommand(String... commandArgs)` Hilfsmethode, die einen Fastboot-Befehl als Systembefehl mit einem Standard-Timeout von 2 Minuten ausführt.
`abstract CommandResult`	`executeLongFastbootCommand(String... commandArgs)` Hilfsmethode, die einen zeitaufwendigen Fastboot-Befehl als Systembefehl ausführt.
`abstract CommandResult`	`executeLongFastbootCommand( envVarMap, String... commandArgs)` Hilfsmethode, die einen zeitaufwendigen Fastboot-Befehl als Systembefehl mit Systemumgebungsvariablen ausführt.
`abstract String`	`executeShellCommand(String command)` Hilfsmethode, die einen ADB-Shellbefehl ausführt und die Ausgabe als `String` zurückgibt.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Führt den angegebenen adb-Shell-Befehl aus und versucht es mehrmals, wenn der Befehl fehlschlägt.
`abstract CommandResult`	`executeShellV2Command(String command)` Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als `CommandResult` zurückgibt, die mit der Befehlsstatusausgabe, stdout und stderr gefüllt ist.
`abstract CommandResult`	`executeShellV2Command(String command, OutputStream pipeToOutput)` Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als `CommandResult` zurückgibt, das mit der Befehlsstatusausgabe und stderr gefüllt ist.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput)` Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als `CommandResult` zurückgibt, die ordnungsgemäß mit der Befehlsstatusausgabe, stdout und stderr gefüllt ist.
`abstract CommandResult`	`executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
`abstract CommandResult`	`executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit)` Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
`abstract CommandResult`	`fastbootWipePartition(String partition)` Helper-Methode, mit der eine Partition für das Gerät gelöscht wird.
`abstract int`	`getApiLevel()` API-Level des Geräts abrufen.
`abstract String`	`getBasebandVersion()` Einfache Methode zum Abrufen der Baseband-Version (Funkmodul) dieses Geräts.
`abstract Integer`	`getBattery()` Gibt den aktuellen Akkustand eines Geräts oder „Null“ zurück, wenn der Akkustand nicht verfügbar ist.
`abstract boolean`	`getBooleanProperty(String name, boolean defaultValue)` Gibt den booleschen Wert der angegebenen Property zurück.
`abstract`	`getBootHistory()` Die Hilfsmethode erfasst die Bootverlaufskarte mit Bootzeit und Bootgrund.
`abstract`	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` Die Hilfsmethode ruft die Karte des Bootverlaufs mit der Bootzeit und dem Bootgrund seit der angegebenen Zeit seit der Epoche vom Gerät und der angegebenen Zeiteinheit ab.
`abstract String`	`getBootloaderVersion()` Bequeme Methode zum Abrufen der Bootloader-Version dieses Geräts.
`abstract String`	`getBuildAlias()` Rufen Sie den Alias des Builds ab, der auf dem Gerät gerade ausgeführt wird.
`abstract String`	`getBuildFlavor()` Ruft die Build-Variante für das Gerät ab.
`abstract String`	`getBuildId()` Ruft den Build ab, der derzeit auf dem Gerät ausgeführt wird.
`abstract String`	`getBuildSigningKeys()` Gibt den Schlüsseltyp zurück, der zum Signieren des Geräte-Images verwendet wurde. Android-Geräte können in der Regel mit Testschlüsseln (wie in AOSP) oder Releaseschlüsseln (die von den einzelnen Geräteherstellern verwaltet werden) signiert werden.
`abstract DeviceDescriptor`	`getCachedDeviceDescriptor()` Gibt einen im Cache gespeicherten `DeviceDescriptor` zurück, wenn das Gerät zugewiesen ist. Andernfalls wird der aktuelle `DeviceDescriptor` zurückgegeben.
`abstract DeviceDescriptor`	`getCachedDeviceDescriptor(boolean shortDescriptor)` Gibt einen im Cache gespeicherten `DeviceDescriptor` zurück, wenn das Gerät zugewiesen ist. Andernfalls wird der aktuelle `DeviceDescriptor` zurückgegeben.
`abstract String[]`	`getChildren(String deviceFilePath)` Alternative zur Verwendung von `IFileEntry`, die aufgrund von Berechtigungen manchmal nicht funktioniert.
`abstract AbstractConnection`	`getConnection()` Gibt die mit dem Gerät verknüpfte Verbindung zurück.
`abstract String`	`getDeviceClass()` Geräteklasse abrufen
`abstract long`	`getDeviceDate()` Gibt das Datum des Geräts in Millisekunden seit der Epoche zurück.
`abstract DeviceDescriptor`	`getDeviceDescriptor()` Gibt ein `DeviceDescriptor` aus den Geräteinformationen zurück, um Informationen dazu abzurufen, ohne das tatsächliche Geräteobjekt zu übergeben.
`abstract DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Gibt ein `DeviceDescriptor` aus den Geräteinformationen zurück, um Informationen dazu abzurufen, ohne das tatsächliche Geräteobjekt zu übergeben.
`abstract TestDeviceState`	`getDeviceState()` Gerätestatus abrufen
`abstract long`	`getDeviceTimeOffset(Date date)` Helper zum Abrufen des Zeitunterschieds zwischen dem Gerät und einem bestimmten `ERROR(/Date)`.
`abstract InputStreamSource`	`getEmulatorOutput()` Stream von Emulator-stdout und -stderr abrufen
`abstract long`	`getExternalStoreFreeSpace()` Hilfsmethode zum Ermitteln des freien Speicherplatzes auf dem externen Speicher des Geräts.
`abstract String`	`getFastbootProductType()` Bequeme Methode zum Abrufen des Produkttyps dieses Geräts im Fastboot-Modus.
`abstract String`	`getFastbootProductVariant()` Bequeme Methode zum Abrufen des Produkttyps dieses Geräts im Fastboot-Modus.
`abstract String`	`getFastbootSerialNumber()` Gibt die Seriennummer im Fastboot-Modus zurück.
`abstract String`	`getFastbootVariable(String variableName)` Ruft den angegebenen Fastboot-Variablenwert vom Gerät ab.
`abstract IFileEntry`	`getFileEntry(String path)` Eine Referenz auf eine Remotedatei auf dem Gerät abrufen
`abstract IDevice`	`getIDevice()` Gibt einen Verweis auf die zugehörige ddmlib-`IDevice` zurück.
`abstract long`	`getIntProperty(String name, long defaultValue)` Gibt den Ganzzahlwert der angegebenen Eigenschaft des Geräts zurück.
`abstract long`	`getLastExpectedRebootTimeMillis()` Gibt die letzte Zeit zurück, zu der Tradefed-APIs einen Neustart ausgelöst haben, in Millisekunden seit EPOCH, wie von `System.currentTimeMillis()` zurückgegeben.
`abstract int`	`getLaunchApiLevel()` Ruft das API‑Level des Geräts beim ersten Start ab.
`abstract InputStreamSource`	`getLogcat()` Erstellt einen Snapshot-Stream der Logcat-Daten.
`abstract InputStreamSource`	`getLogcat(int maxBytes)` Erstellt einen Snapshot-Stream der letzten `maxBytes` erfassten logcat-Daten.
`abstract InputStreamSource`	`getLogcatDump()` Rufen Sie einen Dump des aktuellen Logcat für das Gerät ab.
`abstract InputStreamSource`	`getLogcatSince(long date)` Ruft einen Snapshot-Stream der erfassten Logcat-Daten ab dem angegebenen Datum ab.
`abstract String`	`getMountPoint(String mountName)` Gibt einen Bereitstellungspunkt zurück.
`abstract ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` Gibt ein `MountPointInfo` zurück, das dem angegebenen Mountpoint-Pfad entspricht, oder `null`, wenn für diesen Pfad nichts gemountet ist oder er anderweitig nicht als Mountpoint in /proc/mounts angezeigt wird.
`abstract`	`getMountPointInfo()` Gibt eine geparste Version der Informationen in /proc/mounts auf dem Gerät zurück.
`abstract long`	`getPartitionFreeSpace(String partition)` Hilfsmethode zum Ermitteln des freien Speicherplatzes auf der Gerätepartition.
`abstract ProcessInfo`	`getProcessByName(String processName)` Die Hilfsmethode führt die Befehle „pidof“ und „stat“ aus und gibt das `ProcessInfo`-Objekt mit der PID und der Startzeit des angegebenen Prozesses zurück.
`abstract String`	`getProcessPid(String process)` Gibt die PID des Dienstes zurück oder „null“, wenn ein Fehler aufgetreten ist.
`abstract String`	`getProductType()` Bequeme Methode zum Abrufen des Produkttyps dieses Geräts.
`abstract String`	`getProductVariant()` Bequeme Methode zum Abrufen der Produktvariante dieses Geräts.
`abstract String`	`getProperty(String name)` Ruft den angegebenen Attributwert vom Gerät ab.
`abstract ITestDevice.RecoveryMode`	`getRecoveryMode()` Den aktuellen Wiederherstellungsmodus für das Gerät abrufen.
`abstract String`	`getSerialNumber()` Bequeme Methode zum Abrufen der Seriennummer dieses Geräts.
`abstract`	`getTombstones()` Die Liste der Tombstones von den Geräten abrufen und zurückgeben.
`abstract long`	`getTotalMemory()` Gibt die Gesamtgröße des physischen Speichers in Byte oder -1 im Falle eines internen Fehlers zurück.
`default String`	`getTrackingSerial()` Rufen Sie die Seriennummer ab, die zum Verfolgen des Geräts verwendet wird, um das Gerät zu verwalten.
`abstract boolean`	`getUseFastbootErase()` Gibt an, ob zum Löschen einer Partition auf dem Gerät „fastboot erase“ oder „fastboot format“ verwendet werden soll.
`abstract boolean`	`isAdbRoot()`
`abstract boolean`	`isAdbTcp()`
`abstract boolean`	`isAppEnumerationSupported()` Prüfen, ob die Plattform auf dem Gerät die App-Aufzählung unterstützt
`abstract boolean`	`isBypassLowTargetSdkBlockSupported()` Prüfen, ob die Plattform auf dem Gerät das Umgehen der Blockierung von App-Installationen aufgrund eines niedrigen Ziel-SDK unterstützt
`abstract boolean`	`isDebugfsMounted()` Prüfen Sie, ob debugfs gemountet ist.
`abstract boolean`	`isDeviceEncrypted()` Gibt zurück, ob das Gerät verschlüsselt ist.
`abstract boolean`	`isDirectory(String deviceFilePath)` Gibt „True“ zurück, wenn der Pfad auf dem Gerät ein Verzeichnis ist, andernfalls „False“.
`abstract boolean`	`isEncryptionSupported()` Gibt zurück, ob die Verschlüsselung auf dem Gerät unterstützt wird.
`abstract boolean`	`isExecutable(String fullPath)` Gibt „True“ zurück, wenn der Dateipfad auf dem Gerät eine ausführbare Datei ist, andernfalls „False“.
`abstract boolean`	`isHeadless()` Gibt „true“ zurück, wenn das Gerät headless ist (kein Bildschirm), andernfalls „false“.
`abstract boolean`	`isRuntimePermissionSupported()` Prüfen, ob die Plattform auf dem Gerät die Erteilung von Laufzeitberechtigungen unterstützt
`abstract boolean`	`isStateBootloaderOrFastbootd()` Gibt „true“ zurück, wenn sich das Gerät in `TestDeviceState.FASTBOOT` oder `TestDeviceState.FASTBOOTD` befindet.
`abstract boolean`	`logAnrs(ITestLogger logger)` Erfasst und protokolliert ANR-Fehler vom Gerät.
`abstract void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` Eine Nachricht im Logcat des Geräts protokollieren.
`abstract void`	`mountDebugfs()` debugfs bereitstellen.
`abstract void`	`nonBlockingReboot()` Gibt einen Befehl zum Neustarten des Geräts aus und kehrt zurück, wenn der Befehl abgeschlossen ist und das Gerät für ADB nicht mehr sichtbar ist.
`abstract void`	`postBootSetup()` Führen Sie die Anleitung aus, um das Gerät nach jedem Booten für Tests zu konfigurieren.
`default void`	`postInvocationTearDown()` Diese Methode ist veraltet. Verwenden Sie stattdessen `postInvocationTearDown(Throwable)`.
`abstract void`	`postInvocationTearDown(Throwable invocationException)` Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach dem Aufruf ausgeführt werden.
`default void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` Zusätzliche Schritte für die gerätespezifische Einrichtung, die auf dem Gerät vor dem Aufruf ausgeführt werden.
`abstract boolean`	`pullDir(String deviceFilePath, File localDir)` Verzeichnisinhalte rekursiv vom Gerät abrufen.
`abstract boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` Verzeichnisinhalte rekursiv vom Gerät abrufen.
`abstract File`	`pullFile(String remoteFilePath, int userId)` Ruft eine Datei vom Gerät ab, speichert sie in einem lokalen temporären `ERROR(/File)` und gibt diesen `File` zurück.
`abstract File`	`pullFile(String remoteFilePath)` Ruft eine Datei vom Gerät ab, speichert sie in einem lokalen temporären `ERROR(/File)` und gibt diesen `File` zurück.
`abstract boolean`	`pullFile(String remoteFilePath, File localFile)` Ruft eine Datei vom Gerät ab.
`abstract boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` Ruft eine Datei vom Gerät ab.
`abstract String`	`pullFileContents(String remoteFilePath)` Ruft eine Datei vom Gerät ab und gibt den Inhalt zurück.
`abstract File`	`pullFileFromExternal(String remoteFilePath)` Eine Hilfsmethode zum Abrufen einer Datei aus dem externen Speicher des Geräts, die sie in einem lokalen temporären `ERROR(/File)` speichert und eine Referenz zu diesem `File` zurückgibt.
`abstract boolean`	`pushDir(File localDir, String deviceFilePath, int userId)` Verzeichnisinhalte rekursiv auf das Gerät übertragen.
`abstract boolean`	`pushDir(File localDir, String deviceFilePath, excludedDirectories)` Verzeichnisinhalte rekursiv auf das Gerät übertragen, wobei einige Verzeichnisse, die gefiltert werden, ausgeschlossen werden.
`abstract boolean`	`pushDir(File localDir, String deviceFilePath)` Verzeichnisinhalte rekursiv auf das Gerät übertragen.
`abstract boolean`	`pushFile(File localFile, String deviceFilePath, boolean evaluateContentProviderNeeded)` Variante von `pushFile(File, String)`, bei der optional die Notwendigkeit für den Content-Anbieter berücksichtigt werden kann.
`abstract boolean`	`pushFile(File localFile, String deviceFilePath)` Eine Datei auf ein Gerät übertragen
`abstract boolean`	`pushFile(File localFile, String deviceFilePath, int userId)` Eine Datei auf ein Gerät übertragen
`abstract boolean`	`pushString(String contents, String deviceFilePath)` Aus einem String erstellte Datei auf ein Gerät übertragen
`abstract void`	`reboot()` Das Gerät wird im ADB-Modus neu gestartet.
`abstract void`	`reboot(String reason)` Startet das Gerät im ADB-Modus neu. Der angegebene `reason` wird beim Neustart beibehalten.
`abstract void`	`rebootIntoBootloader()` Das Gerät wird im Bootloader-Modus neu gestartet.
`abstract void`	`rebootIntoFastbootd()` Das Gerät wird im fastbootd-Modus neu gestartet.
`abstract void`	`rebootIntoRecovery()` Das Gerät wird im ADB-Wiederherstellungsmodus neu gestartet.
`abstract void`	`rebootIntoSideload(boolean autoReboot)` Das Gerät wird im ADB-Sideload-Modus neu gestartet. Das ist ein spezieller Modus unter „Recovery“. Wird blockiert, bis das Gerät in den Sideload-Modus wechselt
`abstract void`	`rebootIntoSideload()` Das Gerät wird im ADB-Sideload-Modus neu gestartet. Das ist ein spezieller Modus unter „Recovery“. Wird blockiert, bis das Gerät in den Sideload-Modus wechselt
`abstract void`	`rebootUntilOnline()` Eine Alternative zu `reboot()`, die nur blockiert, bis das Gerät online ist, d. h. für ADB sichtbar ist.
`abstract void`	`rebootUntilOnline(String reason)` Eine Alternative zu `reboot()`, die nur blockiert, bis das Gerät online ist, d. h. für ADB sichtbar ist.
`abstract void`	`rebootUserspace()` Startet nur den Nutzerbereich des Geräts neu.
`abstract void`	`rebootUserspaceUntilOnline()` Eine Alternative zu `rebootUserspace()` ()}, die nur blockiert, bis das Gerät online ist, d. h. für adb sichtbar ist.
`abstract void`	`remountSystemReadOnly()` Die Systempartition auf dem Gerät schreibgeschützt machen.
`abstract void`	`remountSystemWritable()` Machen Sie die Systempartition auf dem Gerät beschreibbar.
`abstract void`	`remountVendorReadOnly()` Machen Sie die Anbieterpartition auf dem Gerät schreibgeschützt.
`abstract void`	`remountVendorWritable()` Machen Sie die Anbieterpartition auf dem Gerät beschreibbar.
`abstract boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` Bequeme Methode zum Ausführen von `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` mit einem oder mehreren Listenern, die als Parameter übergeben werden.
`abstract boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` Führt Instrumentierungstests aus und bietet die Möglichkeit zur Geräte-Wiederherstellung.
`abstract boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)` Wie `ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection))`, führt den Test jedoch für den angegebenen Nutzer aus.
`abstract boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` Entspricht `ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)`, führt den Test jedoch für einen bestimmten Nutzer aus.
`abstract void`	`setDate(Date date)` Legt das Datum auf dem Gerät fest Hinweis: Das Festlegen des Datums auf dem Gerät erfordert Root-Zugriff.
`abstract void`	`setOptions(TestDeviceOptions options)` `TestDeviceOptions` für das Gerät festlegen
`abstract boolean`	`setProperty(String propKey, String propValue)` Legt den angegebenen Eigenschaftswert auf dem Gerät fest.
`abstract void`	`setRecovery(IDeviceRecovery recovery)` Legen Sie die `IDeviceRecovery` fest, die für dieses Gerät verwendet werden soll.
`abstract void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` Legt den aktuellen Wiederherstellungsmodus fest, der für das Gerät verwendet werden soll.
`abstract void`	`setTrackingSerial(String trackingSerial)` Zur Geräteverwaltung wird die Seriennummer erfasst, die wir zur Referenzierung des Geräts verwenden.
`abstract void`	`setUseFastbootErase(boolean useFastbootErase)` Legen Sie fest, ob zum Löschen einer Partition auf dem Gerät „fastboot erase“ oder „fastboot format“ verwendet werden soll.
`abstract void`	`startLogcat()` Logcat-Ausgabe vom Gerät im Hintergrund erfassen.
`abstract boolean`	`startTradeInModeTesting(int timeoutMs)` Testmodus für Inzahlungnahme aktivieren
`abstract void`	`stopEmulatorOutput()` Schließen Sie die Emulatorausgabe und löschen Sie sie.
`abstract void`	`stopLogcat()` Die Erfassung der Logcat-Ausgabe vom Gerät wird beendet und die aktuell gespeicherten Logcat-Daten werden verworfen.
`abstract void`	`stopTradeInModeTesting()` Testen des Trade-In-Modus beenden
`abstract String`	`switchToAdbTcp()` Gerät in den ADB-over-TCP-Modus versetzen.
`abstract boolean`	`switchToAdbUsb()` Schalten Sie das Gerät in den ADB-über-USB-Modus.
`abstract boolean`	`syncFiles(File localFileDir, String deviceFilePath)` Synchronisiert den Inhalt eines lokalen Dateiverzeichnisses inkrementell mit dem Gerät.
`abstract boolean`	`unlockDevice()` Entsperrt das Gerät, wenn es verschlüsselt ist.
`abstract void`	`unmountDebugfs()` debugfs unmounten.
`abstract boolean`	`waitForBootComplete(long timeOut)` Blockiert, bis das Flag „boot complete“ des Geräts gesetzt ist.
`abstract boolean`	`waitForDeviceAvailable()` Wartet, bis das Gerät reagiert und für Tests verfügbar ist.
`abstract boolean`	`waitForDeviceAvailable(long waitTime)` Wartet, bis das Gerät reagiert und für Tests verfügbar ist.
`abstract boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` Wartet, bis das Gerät reagiert und verfügbar ist, ohne den Wiederherstellungspfad zu berücksichtigen.
`abstract void`	`waitForDeviceBootloader()` Wird blockiert, bis das Gerät über Fastboot sichtbar ist.
`abstract boolean`	`waitForDeviceInRecovery(long waitTime)` Sperrt das Gerät, wenn es sich im Status „adb recovery“ befindet. Dieser Status unterscheidet sich von `IDeviceRecovery`.
`abstract boolean`	`waitForDeviceInSideload(long waitTime)` Blockiert, dass sich das Gerät im Status „adb sideload“ befindet
`abstract boolean`	`waitForDeviceNotAvailable(long waitTime)` Blockiert, dass das Gerät nicht verfügbar ist, d. h. in ADB fehlt.
`abstract void`	`waitForDeviceOnline()` Wird blockiert, bis das Gerät über ADB sichtbar ist.
`abstract void`	`waitForDeviceOnline(long waitTime)` Wird blockiert, bis das Gerät über ADB sichtbar ist.
`abstract boolean`	`waitForDeviceShell(long waitTime)` Wartet, bis das Gerät auf einen einfachen ADB-Shell-Befehl reagiert.

Konstanten

UNKNOWN_API_LEVEL

public static final int UNKNOWN_API_LEVEL

Standardwert, wenn das API-Level nicht erkannt werden kann

Konstanter Wert: –1 (0xffffffff)

Öffentliche Methoden

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Prüfen, ob eine Funktion bei einem minimal unterstützten Level derzeit unterstützt wird. Bei dieser Methode werden noch nicht veröffentlichte Funktionen berücksichtigt, bevor die API-Ebene erhöht wird.

Parameter
`strictMinLevel`	`int`: Die niedrigste mögliche Stufe, die das Feature unterstützt.

Returns
`boolean`	„True“, wenn die Ebene unterstützt wird. ansonsten „falsch“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

clearLogcat

public abstract void clearLogcat ()

Löscht alle angesammelten logcat-Daten.

Das ist nützlich, wenn Sie sicherstellen möchten, dass ITestDevice.getLogcat() nur Protokolldaten zurückgibt, die nach einem bestimmten Zeitpunkt erzeugt wurden, z. B. nach dem Flashen eines neuen Geräte-Builds.

deleteFile

public abstract void deleteFile (String deviceFilePath)

Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät.

Parameter
`deviceFilePath`	`String`: Der absolute Pfad der Datei auf dem Gerät.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

deleteFile

public abstract void deleteFile (String deviceFilePath, 
                int userId)

Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät.

Parameter
`deviceFilePath`	`String`: Der absolute Pfad der Datei auf dem Gerät.
`userId`	`int`: Die Nutzer-ID, die gelöscht werden soll

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Hilfsmethode zum Prüfen, ob das Gerät durch Vergleich des aktuellen system_server mit dem vorherigen system_server ProcessInfo neu gestartet wurde. Verwende getProcessByName(String) als Zahlungsmethode, um ProcessInfo zu erhalten.

Parameter
`prevSystemServerProcess`	`ProcessInfo`: Der vorherige system_server-Prozess `ProcessInfo`.

Returns
`boolean`	`true`, wenn das Gerät per Software neu gestartet wurde

Ausgabe
`RuntimeException`	wenn das Gerät einen ungewöhnlichen Startgrund hat
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

deviceSoftRestartedSince

public abstract boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Hilfsmethode, um zu prüfen, ob das Gerät seit der UTC-Zeit seit der Epoche vom Gerät und seinem ERROR(/TimeUnit) neu gestartet wurde. Ein Soft-Restart bezieht sich auf einen Neustart von system_server außerhalb eines Hard-Reboot des Geräts (z. B. ein angeforderter Neustart). Die aktuelle utcEpochTime des Geräts in Millisekunden kann mit der Methode getDeviceDate() abgerufen werden.

Parameter
`utcEpochTime`	`long`: Die Gerätezeit in Sekunden seit der Epoche.
`timeUnit`	`TimeUnit`: die Zeiteinheit `TimeUnit` für die angegebene utcEpochTime.

Returns
`boolean`	`true`, wenn das Gerät per Software neu gestartet wurde

Ausgabe
`RuntimeException`	wenn das Gerät einen ungewöhnlichen Startgrund hat
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disableAdbRoot

public abstract boolean disableAdbRoot ()

Deaktiviert „adb root“.

Wenn Sie „adb root“ deaktivieren, kann es sein, dass die Verbindung des Geräts zu ADB getrennt wird. Diese Methode wird blockiert, bis das Gerät verfügbar ist.

Returns
`boolean`	`true`, falls erfolgreich.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät vorhanden ist.

Parameter
`deviceFilePath`	`String`: Der absolute Pfad der Datei auf dem Gerät, die geprüft werden soll.

Returns
`boolean`	`true`, wenn die Datei vorhanden ist, andernfalls `false`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

enableAdbRoot

public abstract boolean enableAdbRoot ()

Aktiviert „adb root“. Wenn die Einstellung „enable-root“ auf „false“ gesetzt ist, wird eine Meldung protokolliert und die Funktion wird beendet, ohne Root zu aktivieren.

Wenn Sie „adb root“ aktivieren, kann es passieren, dass die Verbindung des Geräts zu ADB getrennt wird. Diese Methode wird blockiert, bis das Gerät verfügbar ist.

Returns
`boolean`	`true`, falls erfolgreich.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                String... commandArgs)

Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.

executeShellCommand(String) sollte nach Möglichkeit immer verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.

Parameter
`timeout`	`long`: Die Zeit in Millisekunden, nach der das Gerät als nicht reagierend gilt. 0L für kein Zeitlimit.
`commandArgs`	`String`: der auszuführende ADB-Befehl und die Argumente

Returns
`String`	die Standardausgabe des Befehls. `null`, wenn der Befehl nicht ausgeführt werden konnte.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeAdbCommand

public abstract String executeAdbCommand (String... commandArgs)

Hilfsmethode, die einen ADB-Befehl als Systembefehl ausführt.

executeShellCommand(String) sollte nach Möglichkeit immer verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.

Parameter
`commandArgs`	`String`: der auszuführende ADB-Befehl und die Argumente

Returns
`String`	die Standardausgabe des Befehls. `null`, wenn der Befehl nicht ausgeführt werden konnte.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeAdbCommand

public abstract String executeAdbCommand (long timeout, 
                 envMap, 
                String... commandArgs)

Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.

executeShellCommand(String) sollte nach Möglichkeit immer verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.

Parameter
`timeout`	`long`: Die Zeit in Millisekunden, nach der das Gerät als nicht reagierend gilt. Bei 0L gibt es kein Zeitlimit.
`envMap`	: Umgebung, die für den Befehl festgelegt werden soll
`commandArgs`	`String`: der auszuführende ADB-Befehl und die Argumente

Returns
`String`	die Standardausgabe des Befehls. `null`, wenn der Befehl nicht ausgeführt werden konnte.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (long timeout, 
                 envMap, 
                String... commandArgs)

Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.

executeShellCommand(String) sollte nach Möglichkeit immer verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.

Parameter
`timeout`	`long`: Die Zeit in Millisekunden, nach der das Gerät als nicht reagierend gilt. Bei 0L gibt es kein Zeitlimit.
`envMap`	: Umgebung, die für den Befehl festgelegt werden soll
`commandArgs`	`String`: der auszuführende ADB-Befehl und die Argumente

Returns
`CommandResult`	Das CommandResult mit der Ausgabe des Befehls.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (String... commandArgs)

Hilfsmethode, die einen ADB-Befehl als Systembefehl ausführt.

executeShellCommand(String) sollte nach Möglichkeit immer verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.

Parameter
`commandArgs`	`String`: der auszuführende ADB-Befehl und die Argumente

Returns
`CommandResult`	Das CommandResult mit der Ausgabe des Befehls.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeAdbV2Command

public abstract CommandResult executeAdbV2Command (long timeout, 
                String... commandArgs)

Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.

executeShellCommand(String) sollte nach Möglichkeit immer verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.

Parameter
`timeout`	`long`: Die Zeit in Millisekunden, nach der das Gerät als nicht reagierend gilt. 0L für kein Zeitlimit.
`commandArgs`	`String`: der auszuführende ADB-Befehl und die Argumente

Returns
`CommandResult`	Das CommandResult mit der Ausgabe des Befehls.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (long timeout, 
                String... commandArgs)

Hilfsmethode, die einen Fastboot-Befehl als Systembefehl ausführt.

Sollte verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus befindet.

Parameter
`timeout`	`long`: die Zeit in Millisekunden, bevor der Befehl abläuft
`commandArgs`	`String`: der Fastboot-Befehl und die Argumente, die ausgeführt werden sollen

Returns
`CommandResult`	Das CommandResult mit der Ausgabe des Befehls

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeFastbootCommand

public abstract CommandResult executeFastbootCommand (String... commandArgs)

Hilfsmethode, die einen Fastboot-Befehl als Systembefehl mit einem Standard-Timeout von 2 Minuten ausführt.

Sollte verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus befindet.

Parameter
`commandArgs`	`String`: der Fastboot-Befehl und die Argumente, die ausgeführt werden sollen

Returns
`CommandResult`	Das CommandResult mit der Ausgabe des Befehls

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand (String... commandArgs)

Hilfsmethode, die einen zeitaufwendigen Fastboot-Befehl als Systembefehl ausführt.

Identisch mit executeFastbootCommand(String), verwendet jedoch ein längeres Zeitlimit.

Parameter
`commandArgs`	`String`: der Fastboot-Befehl und die Argumente, die ausgeführt werden sollen

Returns
`CommandResult`	Das CommandResult mit der Ausgabe des Befehls

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeLongFastbootCommand

public abstract CommandResult executeLongFastbootCommand ( envVarMap, 
                String... commandArgs)

Hilfsmethode, die einen zeitaufwendigen Fastboot-Befehl als Systembefehl mit Systemumgebungsvariablen ausführt.

Identisch mit executeFastbootCommand(String), verwendet jedoch ein längeres Zeitlimit.

Parameter
`envVarMap`	: Die Systemumgebungsvariablen, mit denen der Fastboot-Befehl ausgeführt wird.
`commandArgs`	`String`: der Fastboot-Befehl und die Argumente, die ausgeführt werden sollen

Returns
`CommandResult`	Das CommandResult mit der Ausgabe des Befehls

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeShellCommand

public abstract String executeShellCommand (String command)

Hilfsmethode, die einen ADB-Shellbefehl ausführt und die Ausgabe als String zurückgibt.

Parameter
`command`	`String`: Der auszuführende adb shell-Befehl.

Returns
`String`	die Shell-Ausgabe

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.

Parameter
`command`	`String`: Der auszuführende adb shell-Befehl.
`receiver`	`IShellOutputReceiver`: der `IShellOutputReceiver`, an den die Shell-Ausgabe weitergeleitet werden soll.
`maxTimeToOutputShellResponse`	`long`: Die maximale Zeit, in der der Befehl keine Antwort ausgeben darf. Die Einheit wird in `timeUnit` angegeben.
`timeUnit`	`TimeUnit`: Einheit für `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn `retryAttempts` nicht erfolgreich ausgeführt werden.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

Weitere Informationen

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeoutForCommand, 
                long maxTimeToOutputShellResponse, 
                TimeUnit timeUnit, 
                int retryAttempts)

Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.

Parameter
`command`	`String`: Der auszuführende adb shell-Befehl.
`receiver`	`IShellOutputReceiver`: der `IShellOutputReceiver`, an den die Shell-Ausgabe weitergeleitet werden soll.
`maxTimeoutForCommand`	`long`: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in `timeUnit` angegeben.
`maxTimeToOutputShellResponse`	`long`: Die maximale Zeit, in der der Befehl keine Antwort ausgeben darf. Die Einheit wird in `timeUnit` angegeben.
`timeUnit`	`TimeUnit`: Einheit für `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn `retryAttempts` nicht erfolgreich ausgeführt werden.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

Weitere Informationen

executeShellCommand

public abstract void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Führt den angegebenen adb-Shell-Befehl aus und versucht es mehrmals, wenn der Befehl fehlschlägt.

Eine einfachere Form von executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int) mit Standardwerten.

Parameter
`command`	`String`: Der auszuführende adb shell-Befehl.
`receiver`	`IShellOutputReceiver`: der `IShellOutputReceiver`, an den die Shell-Ausgabe weitergeleitet werden soll.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command)

Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die mit der Befehlsstatusausgabe, stdout und stderr gefüllt ist.

Parameter
`command`	`String`: Der Befehl, der ausgeführt werden soll.

Returns
`CommandResult`	Das Ergebnis in `CommandResult`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                OutputStream pipeToOutput)

Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die mit der Befehlsstatusausgabe und stderr gefüllt ist. stdout wird an den angegebenen Stream weitergeleitet.

Parameter
`command`	`String`: Der Befehl, der ausgeführt werden soll.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)`, in die die Standardausgabe umgeleitet wird, oder „null“.

Returns
`CommandResult`	Das Ergebnis in `CommandResult`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput)

Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die ordnungsgemäß mit der Befehlsstatusausgabe, stdout und stderr gefüllt ist.

Parameter
`command`	`String`: Der Befehl, der ausgeführt werden soll.
`pipeAsInput`	`File`: Eine `ERROR(/File)`, die als Eingabe an den Befehl weitergeleitet wird, oder „null“.

Returns
`CommandResult`	Das Ergebnis in `CommandResult`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.

Parameter
`command`	`String`: der auszuführende adb shell-Befehl
`maxTimeoutForCommand`	`long`: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in `timeUnit` angegeben.
`timeUnit`	`TimeUnit`: Einheit für `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn `retryAttempts` nicht erfolgreich ausgeführt werden.

Returns
`CommandResult`

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

Weitere Informationen

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.

Parameter
`command`	`String`: der auszuführende adb shell-Befehl
`maxTimeoutForCommand`	`long`: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in `timeUnit` angegeben.
`timeUnit`	`TimeUnit`: Einheit für `maxTimeToOutputShellResponse`

Returns
`CommandResult`

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

Weitere Informationen

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.

Parameter
`command`	`String`: Der auszuführende adb shell-Befehl.
`pipeAsInput`	`File`: Eine `ERROR(/File)`, die als Eingabe an den Befehl weitergeleitet wird, oder „null“.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)`, wohin die Standardausgabe umgeleitet wird, oder „null“.
`maxTimeoutForCommand`	`long`: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in `timeUnit` angegeben.
`timeUnit`	`TimeUnit`: Einheit für `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn `retryAttempts` nicht erfolgreich ausgeführt werden.

Returns
`CommandResult`

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

Weitere Informationen

executeShellV2Command

public abstract CommandResult executeShellV2Command (String command, 
                File pipeAsInput, 
                OutputStream pipeToOutput, 
                OutputStream pipeToError, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit, 
                int retryAttempts)

Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.

Parameter
`command`	`String`: der auszuführende ADB-Shell-Befehl
`pipeAsInput`	`File`: Eine `ERROR(/File)`, die als Eingabe an den Befehl weitergeleitet wird, oder „null“.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)`, in die die Standardausgabe umgeleitet wird, oder „null“.
`pipeToError`	`OutputStream`: `ERROR(/OutputStream)`, wohin der Standardfehler weitergeleitet wird, oder „null“.
`maxTimeoutForCommand`	`long`: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in `timeUnit` angegeben.
`timeUnit`	`TimeUnit`: Einheit für `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn `retryAttempts` nicht erfolgreich ausgeführt werden.

Returns
`CommandResult`

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

Weitere Informationen

fastbootWipePartition

public abstract CommandResult fastbootWipePartition (String partition)

Helper-Methode, mit der eine Partition für das Gerät gelöscht wird.

Wenn getUseFastbootErase() true ist, wird die Partition mit „fastboot erase“ gelöscht. Das Gerät muss dann beim nächsten Booten ein Dateisystem erstellen. Andernfalls wird „fastboot format“ verwendet, wodurch ein neues Dateisystem auf dem Gerät erstellt wird.

Sollte verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus befindet.

Parameter
`partition`	`String`: die zu löschende Partition

Returns
`CommandResult`	Das CommandResult mit der Ausgabe des Befehls

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getApiLevel

public abstract int getApiLevel ()

API-Level des Geräts abrufen. Die Standardeinstellung ist UNKNOWN_API_LEVEL.

Returns
`int`	Eine Ganzzahl, die das API-Level des Geräts angibt

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBasebandVersion

public abstract String getBasebandVersion ()

Einfache Methode zum Abrufen der Baseband-Version (Funkmodul) dieses Geräts. Das Abrufen der Funkversion ist gerätespezifisch. Daher werden möglicherweise nicht für alle Geräte die richtigen Informationen zurückgegeben. Bei dieser Methode wird die Eigenschaft „gsm.version.baseband“ verwendet, um die richtigen Versionsinformationen zurückzugeben. Diese Angabe ist für einige CDMA-Geräte nicht korrekt und die hier zurückgegebene Version stimmt möglicherweise nicht mit der Version überein, die von Fastboot gemeldet wird. Außerdem wird möglicherweise nicht die Version für das CDMA-Funkmodul zurückgegeben. Kurz gesagt: Mit dieser Methode wird nur dann eine genaue Version zurückgegeben, wenn die Eigenschaft „gsm.version.baseband“ mit der von fastboot getvar version-baseband zurückgegebenen Version übereinstimmt.

Returns
`String`	die `String`-Baseband-Version oder `null`, wenn sie nicht ermittelt werden kann (das Gerät hat kein Funkmodul oder der Versionsstring kann nicht gelesen werden)

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getBattery

public abstract Integer getBattery ()

Gibt den aktuellen Akkustand eines Geräts oder „Null“ zurück, wenn der Akkustand nicht verfügbar ist.

Returns
`Integer`

getBooleanProperty

public abstract boolean getBooleanProperty (String name, 
                boolean defaultValue)

Gibt den booleschen Wert der angegebenen Property zurück.

Parameter
`name`	`String`: der Property-Name
`defaultValue`	`boolean`: Standardwert, der zurückgegeben wird, wenn die Property leer ist oder nicht vorhanden ist.

Returns
`boolean`	`true`, wenn die Property den Wert `"1"`, `"y"`, `"yes"`, `"on"` oder `"true"` hat, `false`, wenn die Property den Wert `"0"`, `"n"`, `"no"`, `"off"`, `"false"` oder `defaultValue` hat, andernfalls.

Ausgabe
`DeviceNotAvailableException`

getBootHistory

public abstract  getBootHistory ()

Die Hilfsmethode erfasst die Bootverlaufskarte mit Bootzeit und Bootgrund.

Returns
	Zuordnung von Startzeit (UTC-Zeit in Sekunden seit der Epoche) und Startgrund

Ausgabe
`DeviceNotAvailableException`

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Die Hilfsmethode ruft die Karte mit dem Bootverlauf mit Bootzeit und Bootgrund seit der angegebenen Zeit seit der Epoche vom Gerät und der angegebenen Zeiteinheit ab. Die aktuelle utcEpochTime des Geräts in Millisekunden kann mit der Methode getDeviceDate() abgerufen werden.

Parameter
`utcEpochTime`	`long`: Die Gerätezeit seit der Epoche.
`timeUnit`	`TimeUnit`: die Zeiteinheit `TimeUnit`.

Returns
	Zuordnung von Startzeit (UTC-Zeit in Sekunden seit der Epoche) und Startgrund

Ausgabe
`DeviceNotAvailableException`

getBootloaderVersion

public abstract String getBootloaderVersion ()

Bequeme Methode zum Abrufen der Bootloader-Version dieses Geräts.

Es wird versucht, die Bootloader-Version aus dem aktuellen Status des Geräts abzurufen. Wenn sich das Gerät beispielsweise im Fastboot-Modus befindet, wird versucht, die Version über Fastboot abzurufen.

Returns
`String`	Die `String`-Bootloader-Version oder `null`, wenn sie nicht gefunden werden kann

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getBuildAlias

public abstract String getBuildAlias ()

Rufen Sie den Alias des Builds ab, der auf dem Gerät gerade ausgeführt wird.

Der Build-Alias ist in der Regel ein besser lesbarer String als die Build-ID (in der Regel eine Nummer für Nexus-Builds). Das finale Release von Android 4.2 hat beispielsweise den Build-Alias JDQ39 und die Build-ID 573038.

Returns
`String`	Der Build-Alias oder die Build-ID, falls der Alias nicht abgerufen werden konnte

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildFlavor

public abstract String getBuildFlavor ()

Ruft die Build-Variante für das Gerät ab.

Returns
`String`	Die Build-Variante oder „null“, wenn sie nicht abgerufen werden konnte

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildId

public abstract String getBuildId ()

Ruft den Build ab, der derzeit auf dem Gerät ausgeführt wird.

Returns
`String`	Die Build-ID oder `IBuildInfo.UNKNOWN_BUILD_ID`, wenn sie nicht abgerufen werden konnte

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getBuildSigningKeys

public abstract String getBuildSigningKeys ()

Gibt den Schlüsseltyp zurück, der zum Signieren des Geräte-Images verwendet wurde.

Android-Geräte werden in der Regel mit Testschlüsseln (wie in AOSP) oder Releaseschlüsseln (die von den einzelnen Geräteherstellern verwaltet werden) signiert.

Returns
`String`	Der Signaturschlüssel, falls gefunden, andernfalls „null“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor ()

Gibt einen im Cache gespeicherten DeviceDescriptor zurück, wenn das Gerät zugewiesen ist. Andernfalls wird der aktuelle DeviceDescriptor zurückgegeben.

Returns
`DeviceDescriptor`

getCachedDeviceDescriptor

public abstract DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

Gibt einen im Cache gespeicherten DeviceDescriptor zurück, wenn das Gerät zugewiesen ist. Andernfalls wird der aktuelle DeviceDescriptor zurückgegeben.

Parameter
`shortDescriptor`	`boolean`: Gibt an, ob der Deskriptor auf die Mindestinformationen beschränkt werden soll.

Returns
`DeviceDescriptor`

getChildren

public abstract String[] getChildren (String deviceFilePath)

Alternative zur Verwendung von IFileEntry, die aufgrund von Berechtigungen manchmal nicht funktioniert.

Parameter
`deviceFilePath`	`String`: der Pfad auf dem Gerät, in dem die Suche durchgeführt werden soll

Returns
`String[]`	Array mit Strings, das alle Dateien in einem Pfad auf dem Gerät enthält.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getConnection

public abstract AbstractConnection getConnection ()

Gibt die mit dem Gerät verknüpfte Verbindung zurück.

Returns
`AbstractConnection`

getDeviceClass

public abstract String getDeviceClass ()

Geräteklasse abrufen

Returns
`String`	die Geräteklasse `String`.

getDeviceDate

public abstract long getDeviceDate ()

Gibt das Datum des Geräts in Millisekunden seit der Epoche zurück.

Returns
`long`	Das Datum des Geräts im Epoch-Format.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor ()

Gibt ein DeviceDescriptor aus den Geräteinformationen zurück, um Informationen dazu abzurufen, ohne das tatsächliche Geräteobjekt zu übergeben.

Returns
`DeviceDescriptor`

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Gibt ein DeviceDescriptor aus den Geräteinformationen zurück, um Informationen dazu abzurufen, ohne das tatsächliche Geräteobjekt zu übergeben.

Parameter
`shortDescriptor`	`boolean`: Gibt an, ob der Deskriptor auf die Mindestinformationen beschränkt werden soll.

Returns
`DeviceDescriptor`

getDeviceState

public abstract TestDeviceState getDeviceState ()

Gerätestatus abrufen

Returns
`TestDeviceState`

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Helper zum Abrufen des Zeitunterschieds zwischen dem Gerät und einem bestimmten ERROR(/Date). Verwenden Sie intern die Epoch-Zeit.

Parameter
`date`	`Date`

Returns
`long`	die Differenz in Millisekunden

Ausgabe
`DeviceNotAvailableException`

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Stream von Emulator-stdout und -stderr abrufen

Returns
`InputStreamSource`	Emulatorausgabe

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

Hilfsmethode zum Ermitteln des freien Speicherplatzes auf dem externen Speicher des Geräts.

Returns
`long`	die Menge an freiem Speicherplatz in KB

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getFastbootProductType

public abstract String getFastbootProductType ()

Bequeme Methode zum Abrufen des Produkttyps dieses Geräts im Fastboot-Modus.

Diese Methode sollte nur verwendet werden, wenn sich das Gerät im Fastboot-Modus befinden soll. Sie ist in diesem Fall etwas sicherer als die generische getProductType()-Methode, da ITestDevice weiß, wie das Gerät in den Fastboot-Modus versetzt wird, wenn es sich im falschen Status befindet oder nicht reagiert.

Returns
`String`	den Namen des Produkttyps `String` oder `null`, wenn er nicht ermittelt werden kann

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getFastbootProductVariant

public abstract String getFastbootProductVariant ()

Bequeme Methode zum Abrufen des Produkttyps dieses Geräts im Fastboot-Modus.

Returns
`String`	den Namen des Produkttyps `String` oder `null`, wenn er nicht ermittelt werden kann

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Gibt die Seriennummer im Fastboot-Modus zurück.

Returns
`String`

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Ruft den angegebenen Fastboot-Variablenwert vom Gerät ab.

Parameter
`variableName`	`String`: der Variablenname

Returns
`String`	Der Attributwert oder `null`, falls er nicht vorhanden ist.

Ausgabe
	UnsupportedOperationException
`DeviceNotAvailableException`

getFileEntry

public abstract IFileEntry getFileEntry (String path)

Eine Referenz auf eine Remotedatei auf dem Gerät abrufen

Parameter
`path`	`String`: Der abzurufende Dateipfad. Kann ein absoluter Pfad oder ein Pfad relativ zu „/“ sein (d. h., sowohl „/system“ als auch „system“ werden unterstützt).

Returns
`IFileEntry`	die `IFileEntry` oder `null`, wenn die Datei unter der angegebenen `path` nicht gefunden werden kann

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getIDevice

public abstract IDevice getIDevice ()

Gibt einen Verweis auf die zugehörige ddmlib-IDevice zurück.

Jedes Mal, wenn die Verbindung des Geräts zu ADB getrennt und wiederhergestellt wird, kann von DDMS ein neuer IDevice zugewiesen werden. Anrufer sollten daher keinen Verweis auf IDevice beibehalten, da dieser Verweis möglicherweise veraltet ist.

Returns
`IDevice`	die `IDevice`

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Gibt den Ganzzahlwert der angegebenen Eigenschaft des Geräts zurück.

Parameter
`name`	`String`: der Property-Name
`defaultValue`	`long`: Standardwert, der zurückgegeben wird, wenn die Property leer ist oder nicht vorhanden ist.

Returns
`long`	den Eigenschaftswert oder `defaultValue`, wenn die Eigenschaft leer ist, nicht vorhanden ist oder keinen Ganzzahlwert hat.

Ausgabe
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

Gibt die letzte Zeit zurück, zu der Tradefed-APIs einen Neustart ausgelöst haben, in Millisekunden seit EPOCH, wie von System.currentTimeMillis() zurückgegeben.

Returns
`long`

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

Ruft das API-Level des Geräts beim ersten Start ab. Die Standardeinstellung ist UNKNOWN_API_LEVEL.

Returns
`int`	Eine Ganzzahl, die das erste API-Level des Geräts angibt

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getLogcat

public abstract InputStreamSource getLogcat ()

Erstellt einen Snapshot-Stream der Logcat-Daten.

Funktioniert in zwei Modi:

Wenn der Logcat-Vorgang gerade im Hintergrund ausgeführt wird, werden bis zu TestDeviceOptions.getMaxLogcatDataSize() Bytes des aktuellen Inhalts des Hintergrund-Logcat-Vorgangs zurückgegeben.

Andernfalls wird ein statischer Dump der Logcat-Daten zurückgegeben, wenn das Gerät gerade reagiert.

Returns
`InputStreamSource`

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

Erstellt einen Snapshot-Stream der letzten maxBytes erfassten logcat-Daten.

Nützlich, wenn Sie häufig Snapshots der erfassten logcat-Daten erstellen möchten, ohne den potenziell großen Speicherplatzbedarf des gesamten getLogcat()-Snapshots in Kauf zu nehmen.

Parameter
`maxBytes`	`int`: Die maximale Menge an zurückzugebenden Daten. Sollte eine Menge sein, die problemlos in den Speicher passt

Returns
`InputStreamSource`

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

Rufen Sie einen Dump des aktuellen Logcat für das Gerät ab. Im Gegensatz zu getLogcat() gibt diese Methode immer einen statischen Dump des Logcat zurück.

Hat den Nachteil, dass nichts zurückgegeben wird, wenn das Gerät nicht erreichbar ist.

Returns
`InputStreamSource`	`InputStreamSource` der Logcat-Daten. Wenn das Erfassen von logcat-Daten fehlschlägt, wird ein leerer Stream zurückgegeben.

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

Ruft einen Snapshot-Stream der erfassten Logcat-Daten ab dem angegebenen Datum ab. Die Zeit auf dem Gerät sollte getDeviceDate() verwendet werden.

Parameter
`date`	`long`: Das Format „Millisekunden seit Epoche“ gibt an, wann der Snapshot bis zur Gegenwart beginnen soll. (kann mit „date +%s“ abgerufen werden)

Returns
`InputStreamSource`

getMountPoint

public abstract String getMountPoint (String mountName)

Gibt einen Bereitstellungspunkt zurück.

Fragt das Gerät direkt ab, wenn die im Cache gespeicherten Informationen in IDevice nicht verfügbar sind.

TODO: Dieses Verhalten zu IDevice.getMountPoint(String) verschieben

Parameter
`mountName`	`String`: der Name des Bereitstellungspunkts

Returns
`String`	den Bereitstellungspunkt oder `null`

Weitere Informationen

IDevice.getMountPoint(String)

getMountPointInfo

public abstract ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

Gibt ein MountPointInfo zurück, das dem angegebenen Mountpoint-Pfad entspricht, oder null, wenn für diesen Pfad nichts gemountet ist oder er anderweitig nicht als Mountpoint in /proc/mounts angezeigt wird.

Parameter
`mountpoint`	`String`

Returns
`ITestDevice.MountPointInfo`	Ein `ERROR(/List)` von `MountPointInfo` mit den Informationen in „/proc/mounts“

Ausgabe
`DeviceNotAvailableException`

Weitere Informationen

getMountPointInfo()

getMountPointInfo

public abstract  getMountPointInfo ()

Gibt eine geparste Version der Informationen in /proc/mounts auf dem Gerät zurück.

Returns
	Ein `ERROR(/List)` von `MountPointInfo` mit den Informationen in „/proc/mounts“

Ausgabe
`DeviceNotAvailableException`

getPartitionFreeSpace

public abstract long getPartitionFreeSpace (String partition)

Hilfsmethode zum Ermitteln des freien Speicherplatzes auf der Gerätepartition.

Parameter
`partition`	`String`

Returns
`long`	die Menge an freiem Speicherplatz in KB

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getProcessByName

public abstract ProcessInfo getProcessByName (String processName)

Die Hilfsmethode führt die Befehle „pidof“ und „stat“ aus und gibt das ProcessInfo-Objekt mit der PID und der Startzeit des angegebenen Prozesses zurück.

Parameter
`processName`	`String`: Der Prozessname als String.

Returns
`ProcessInfo`	ProcessInfo des angegebenen processName

Ausgabe
`DeviceNotAvailableException`

getProcessPid

public abstract String getProcessPid (String process)

Gibt die PID des Dienstes oder „null“ zurück, wenn ein Fehler aufgetreten ist.

Parameter
`process`	`String`: Der Prozessname als String.

Returns
`String`

Ausgabe
`DeviceNotAvailableException`

getProductType

public abstract String getProductType ()

Bequeme Methode zum Abrufen des Produkttyps dieses Geräts.

Diese Methode funktioniert, wenn sich das Gerät im ADB- oder Fastboot-Modus befindet.

Returns
`String`	den Namen des Produkttyps `String`. Darf nicht null sein

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wurde und nicht wiederhergestellt werden kann oder wenn der Produkttyp nicht ermittelt werden kann

getProductVariant

public abstract String getProductVariant ()

Bequeme Methode zum Abrufen der Produktvariante dieses Geräts.

Diese Methode funktioniert, wenn sich das Gerät im ADB- oder Fastboot-Modus befindet.

Returns
`String`	den Namen der Produktvariante `String` oder `null`, wenn er nicht ermittelt werden kann

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getProperty

public abstract String getProperty (String name)

Ruft den angegebenen Attributwert vom Gerät ab.

Parameter
`name`	`String`: der Property-Name

Returns
`String`	Der Attributwert oder `null`, falls er nicht vorhanden ist.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

Den aktuellen Wiederherstellungsmodus für das Gerät abrufen.

Returns
`ITestDevice.RecoveryMode`	Der aktuelle Wiederherstellungsmodus, der für das Gerät verwendet wird.

getSerialNumber

public abstract String getSerialNumber ()

Bequeme Methode zum Abrufen der Seriennummer dieses Geräts.

Returns
`String`	die Seriennummer `String`

getTombstones

public abstract  getTombstones ()

Die Liste der Tombstones von den Geräten abrufen und zurückgeben. Erfordert Root-Zugriff.

Die Methode ist nicht garantiert. Wenn ein Tombstone aus irgendeinem Grund nicht abgerufen werden kann, fehlt er in der Liste. Nur ein DeviceNotAvailableException beendet die Methode vorzeitig.

Returns
	Eine Liste von Tombstone-Dateien, leer, wenn kein Tombstone vorhanden ist.

Ausgabe
`DeviceNotAvailableException`

Weitere Informationen

Dokumentation zu Tombstones

getTotalMemory

public abstract long getTotalMemory ()

Gibt die Gesamtgröße des physischen Speichers in Byte oder -1 im Falle eines internen Fehlers zurück.

Returns
`long`

getTrackingSerial

public String getTrackingSerial ()

Rufen Sie die Seriennummer ab, die zum Verfolgen des Geräts verwendet wird, um das Gerät zu verwalten.

Returns
`String`

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

Gibt an, ob zum Löschen einer Partition auf dem Gerät „fastboot erase“ oder „fastboot format“ verwendet werden soll.

Returns
`boolean`	`true`, wenn „fastboot erase“ verwendet wird, oder `false`, wenn „fastboot format“ verwendet wird.

Weitere Informationen

fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

Returns
`boolean`	`true`, wenn das Gerät derzeit ADB-Root hat, andernfalls `false`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

isAdbTcp

public abstract boolean isAdbTcp ()

Returns
`boolean`	`true`, wenn das Gerät über „adb-over-tcp“ verbunden ist, andernfalls `false`.

isAppEnumerationSupported

public abstract boolean isAppEnumerationSupported ()

Prüfen, ob die Plattform auf dem Gerät die App-Aufzählung unterstützt

Returns
`boolean`	„True“, wenn die App-Aufzählung unterstützt wird, andernfalls „false“

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public abstract boolean isBypassLowTargetSdkBlockSupported ()

Prüfen, ob die Plattform auf dem Gerät das Umgehen der Blockierung von App-Installationen aufgrund eines niedrigen Ziel-SDK unterstützt

Returns
`boolean`	„True“, wenn das Umgehen des Blocks für niedrige Ziel-SDKs unterstützt wird, andernfalls „false“

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isDebugfsMounted

public abstract boolean isDebugfsMounted ()

Prüfen Sie, ob debugfs gemountet ist.

Returns
`boolean`	`true`, wenn debugfs bereitgestellt ist

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

Gibt zurück, ob das Gerät verschlüsselt ist.

Returns
`boolean`	`true`, wenn das Gerät verschlüsselt ist.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

isDirectory

public abstract boolean isDirectory (String deviceFilePath)

Gibt „True“ zurück, wenn der Pfad auf dem Gerät ein Verzeichnis ist, andernfalls „False“.

Parameter
`deviceFilePath`	`String`

Returns
`boolean`

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isEncryptionSupported

public abstract boolean isEncryptionSupported ()

Gibt zurück, ob die Verschlüsselung auf dem Gerät unterstützt wird.

Returns
`boolean`	`true`, wenn das Gerät die Verschlüsselung unterstützt.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isExecutable

public abstract boolean isExecutable (String fullPath)

Gibt „True“ zurück, wenn der Dateipfad auf dem Gerät eine ausführbare Datei ist, andernfalls „False“.

Parameter
`fullPath`	`String`

Returns
`boolean`

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isHeadless

public abstract boolean isHeadless ()

Gibt „true“ zurück, wenn das Gerät headless ist (kein Bildschirm), andernfalls „false“.

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

Prüfen, ob die Plattform auf dem Gerät die Erteilung von Laufzeitberechtigungen unterstützt

Returns
`boolean`	„True“, wenn Laufzeitberechtigungen unterstützt werden, andernfalls „false“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public abstract boolean isStateBootloaderOrFastbootd ()

Gibt „true“ zurück, wenn sich das Gerät in TestDeviceState.FASTBOOT oder TestDeviceState.FASTBOOTD befindet.

Returns
`boolean`

logAnrs

public abstract boolean logAnrs (ITestLogger logger)

Erfasst und protokolliert ANR-Fehler vom Gerät.

Parameter
`logger`	`ITestLogger`: ein `ITestLogger` zum Protokollieren der ANRs.

Returns
`boolean`	„True“, wenn die Protokollierung erfolgreich war, andernfalls „false“.

Ausgabe
`DeviceNotAvailableException`

logOnDevice

public abstract void logOnDevice (String tag, 
                Log.LogLevel level, 
                String format, 
                Object... args)

Eine Nachricht im Logcat des Geräts protokollieren. Dies ist ein sicherer Aufruf, der auch dann keine Ausnahme auslöst, wenn die Protokollierung fehlschlägt.

Parameter
`tag`	`String`: Das Tag, unter dem wir unsere Nachricht im Logcat protokollieren.
`level`	`Log.LogLevel`: Die Debugging-Stufe der Nachricht im Logcat.
`format`	`String`: Das Nachrichtenformat.
`args`	`Object`: Die Argumente, die über String.format() ersetzt werden sollen.

mountDebugfs

public abstract void mountDebugfs ()

debugfs bereitstellen.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

nonBlockingReboot

public abstract void nonBlockingReboot ()

Gibt einen Befehl zum Neustarten des Geräts aus und kehrt zurück, wenn der Befehl abgeschlossen ist und das Gerät für ADB nicht mehr sichtbar ist.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

postBootSetup

public abstract void postBootSetup ()

Führen Sie die Anleitung aus, um das Gerät nach jedem Booten für Tests zu konfigurieren.

Sollte aufgerufen werden, nachdem das Gerät vollständig hochgefahren wurde

Unter normalen Umständen muss diese Methode nicht explizit aufgerufen werden, da Implementierungen diese Schritte beim Neustart automatisch ausführen sollten.

Der Aufruf ist möglicherweise erforderlich, wenn das Gerät aufgrund anderer Ereignisse neu gestartet wird, z. B. wenn ein Fastboot-Updatebefehl abgeschlossen wurde.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

postInvocationTearDown

public void postInvocationTearDown ()

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen postInvocationTearDown(Throwable).

Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach dem Aufruf ausgeführt werden.

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach dem Aufruf ausgeführt werden.

Parameter
`invocationException`	`Throwable`: Falls vorhanden, die endgültige Ausnahme, die durch den Aufruffehler ausgelöst wurde.

preInvocationSetup

public void preInvocationSetup (IBuildInfo info, 
                MultiMap<String, String> attributes)

Zusätzliche Schritte für die gerätespezifische Einrichtung, die auf dem Gerät vor dem Aufruf ausgeführt werden.

Parameter
`info`	`IBuildInfo`: Die `IBuildInfo` des Geräts.
`attributes`	`MultiMap`: Die im Aufrufkontext gespeicherten Attribute

Ausgabe
	com.android.tradefed.targetprep.TargetSetupError
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`
`TargetSetupError`

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir)

Verzeichnisinhalte rekursiv vom Gerät abrufen.

Parameter
`deviceFilePath`	`String`: der absolute Dateipfad der Remote-Quelle
`localDir`	`File`: das lokale Verzeichnis, in das Dateien übertragen werden sollen

Returns
`boolean`	`true`, wenn die Datei abgerufen wurde. Andernfalls `false`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

pullDir

public abstract boolean pullDir (String deviceFilePath, 
                File localDir, 
                int userId)

Verzeichnisinhalte rekursiv vom Gerät abrufen.

Parameter
`deviceFilePath`	`String`: der absolute Dateipfad der Remote-Quelle
`localDir`	`File`: das lokale Verzeichnis, in das Dateien übertragen werden sollen
`userId`	`int`: die Nutzer-ID, aus der die Daten abgerufen werden sollen

Returns
`boolean`	`true`, wenn die Datei abgerufen wurde. Andernfalls `false`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

pullFile

public abstract File pullFile (String remoteFilePath, 
                int userId)

Ruft eine Datei vom Gerät ab, speichert sie in einem lokalen temporären ERROR(/File) und gibt diesen File zurück.

Parameter
`remoteFilePath`	`String`: Der absolute Pfad zur Datei auf dem Gerät.
`userId`	`int`: Die Nutzer-ID, aus der Daten abgerufen werden sollen

Returns
`File`	Eine `ERROR(/File)` mit dem Inhalt der Gerätedatei oder `null`, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem)

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

pullFile

public abstract File pullFile (String remoteFilePath)

Ruft eine Datei vom Gerät ab, speichert sie in einem lokalen temporären ERROR(/File) und gibt diesen File zurück.

Parameter
`remoteFilePath`	`String`: Der absolute Pfad zur Datei auf dem Gerät.

Returns
`File`	Eine `ERROR(/File)` mit dem Inhalt der Gerätedatei oder `null`, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem)

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile)

Ruft eine Datei vom Gerät ab.

Parameter
`remoteFilePath`	`String`: Der absolute Pfad zur Datei auf dem Gerät.
`localFile`	`File`: die lokale Datei, in der Inhalte gespeichert werden sollen. Wenn sie nicht leer ist, wird der Inhalt ersetzt.

Returns
`boolean`	`true`, wenn die Datei abgerufen wurde. Andernfalls `false`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

pullFile

public abstract boolean pullFile (String remoteFilePath, 
                File localFile, 
                int userId)

Ruft eine Datei vom Gerät ab.

Parameter
`remoteFilePath`	`String`: Der absolute Pfad zur Datei auf dem Gerät.
`localFile`	`File`: die lokale Datei, in der Inhalte gespeichert werden sollen. Wenn das Feld nicht leer ist, wird der Inhalt ersetzt.
`userId`	`int`: Die Nutzer-ID, aus der Daten abgerufen werden sollen

Returns
`boolean`	`true`, wenn die Datei abgerufen wurde. Andernfalls `false`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

pullFileContents

public abstract String pullFileContents (String remoteFilePath)

Ruft eine Datei vom Gerät ab und gibt den Inhalt zurück.

Parameter
`remoteFilePath`	`String`: Der absolute Pfad zur Datei auf dem Gerät.

Returns
`String`	Eine `String` mit dem Inhalt der Gerätedatei oder `null`, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem)

Ausgabe
`DeviceNotAvailableException`

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

Eine Hilfsmethode zum Abrufen einer Datei aus dem externen Speicher des Geräts, die sie in einem lokalen temporären ERROR(/File) speichert und eine Referenz zu diesem File zurückgibt.

Parameter
`remoteFilePath`	`String`: der Pfad zur Datei auf dem Gerät, relativ zum Mountpoint des externen Speichers des Geräts

Returns
`File`	Eine `ERROR(/File)` mit dem Inhalt der Gerätedatei oder `null`, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem)

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                int userId)

Verzeichnisinhalte rekursiv auf das Gerät übertragen.

Parameter
`localDir`	`File`: das lokale Verzeichnis, das übertragen werden soll
`deviceFilePath`	`String`: der absolute Dateipfad des Remote-Ziels
`userId`	`int`: die Nutzer-ID, an die die Push-Benachrichtigung gesendet werden soll

Returns
`boolean`	`true`, wenn die Datei erfolgreich übertragen wurde. Andernfalls `false`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath, 
                 excludedDirectories)

Verzeichnisinhalte rekursiv auf das Gerät übertragen, wobei einige Verzeichnisse, die gefiltert werden, ausgeschlossen werden.

Parameter
`localDir`	`File`: das lokale Verzeichnis, das übertragen werden soll
`deviceFilePath`	`String`: der absolute Dateipfad des Remote-Ziels
`excludedDirectories`	: Eine Reihe von ausgeschlossenen Verzeichnisnamen, die nicht übertragen werden sollen.

Returns
`boolean`	`true`, wenn die Datei erfolgreich übertragen wurde. Andernfalls `false`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

pushDir

public abstract boolean pushDir (File localDir, 
                String deviceFilePath)

Verzeichnisinhalte rekursiv auf das Gerät übertragen.

Parameter
`localDir`	`File`: das lokale Verzeichnis, das übertragen werden soll
`deviceFilePath`	`String`: der absolute Dateipfad des Remote-Ziels

Returns
`boolean`	`true`, wenn die Datei erfolgreich übertragen wurde. Andernfalls `false`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                boolean evaluateContentProviderNeeded)

Variante von pushFile(File, String), bei der optional die Notwendigkeit für den Contentanbieter berücksichtigt werden kann.

Parameter
`localFile`	`File`: die lokale Datei, die übertragen werden soll
`deviceFilePath`	`String`: der absolute Dateipfad des Remote-Ziels
`evaluateContentProviderNeeded`	`boolean`: Gibt an, ob geprüft werden soll, ob der Content-Anbieter benötigt wird.

Returns
`boolean`	`true`, wenn die Datei erfolgreich übertragen wurde. Andernfalls `false`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath)

Eine Datei auf ein Gerät übertragen Standardmäßig wird ein Contentanbieter verwendet.

Parameter
`localFile`	`File`: die lokale Datei, die übertragen werden soll
`deviceFilePath`	`String`: der absolute Dateipfad des Remote-Ziels

Returns
`boolean`	`true`, wenn die Datei erfolgreich übertragen wurde. Andernfalls `false`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

pushFile

public abstract boolean pushFile (File localFile, 
                String deviceFilePath, 
                int userId)

Eine Datei auf ein Gerät übertragen Standardmäßig wird ein Contentanbieter verwendet.

Parameter
`localFile`	`File`: die lokale Datei, die übertragen werden soll
`deviceFilePath`	`String`: der absolute Dateipfad des Remote-Ziels
`userId`	`int`: die Nutzer-ID, an die die Push-Benachrichtigung gesendet werden soll

Returns
`boolean`	`true`, wenn die Datei erfolgreich übertragen wurde. Andernfalls `false`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

pushString

public abstract boolean pushString (String contents, 
                String deviceFilePath)

Aus einem String erstellte Datei auf ein Gerät übertragen

Parameter
`contents`	`String`: der Inhalt der Datei, die übertragen werden soll
`deviceFilePath`	`String`: der absolute Dateipfad des Remote-Ziels

Returns
`boolean`	`true`, wenn der String erfolgreich übertragen wurde. Andernfalls `false`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

neu starten

public abstract void reboot ()

Das Gerät wird im ADB-Modus neu gestartet.

Blockiert, bis das Gerät verfügbar ist.

Ausgabe
`DeviceNotAvailableException`	Wenn das Gerät nach dem Neustart nicht verfügbar ist

neu starten

public abstract void reboot (String reason)

Startet das Gerät im ADB-Modus neu. Der angegebene reason wird beim Neustart beibehalten.

Blockiert, bis das Gerät verfügbar ist.

Der Grund für den letzten Neustart kann durch Abfragen der Eigenschaft sys.boot.reason ermittelt werden.

Parameter
`reason`	`String`: Ein Grund für diesen Neustart oder `null`, wenn kein Grund angegeben ist.

Ausgabe
`DeviceNotAvailableException`	Wenn das Gerät nach dem Neustart nicht verfügbar ist

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

Das Gerät wird im Bootloader-Modus neu gestartet.

Wird blockiert, bis sich das Gerät im Bootloader-Modus befindet.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

rebootIntoFastbootd

public abstract void rebootIntoFastbootd ()

Das Gerät wird im fastbootd-Modus neu gestartet.

Wird blockiert, bis sich das Gerät im Fastbootd-Modus befindet.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

rebootIntoRecovery

public abstract void rebootIntoRecovery ()

Das Gerät wird im ADB-Wiederherstellungsmodus neu gestartet.

Blöcke, bis das Gerät in den Wiederherstellungsmodus wechselt

Ausgabe
`DeviceNotAvailableException`	Wenn das Gerät nach dem Neustart nicht verfügbar ist

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

Das Gerät wird im ADB-Sideload-Modus neu gestartet. Das ist ein spezieller Modus unter „Recovery“.

Wird blockiert, bis das Gerät in den Sideload-Modus wechselt

Parameter
`autoReboot`	`boolean`: Gibt an, ob das Gerät nach dem Sideload automatisch neu gestartet werden soll.

Ausgabe
`DeviceNotAvailableException`	Wenn sich das Gerät nach dem Neustart nicht im Sideload-Modus befindet

rebootIntoSideload

public abstract void rebootIntoSideload ()

Das Gerät wird im ADB-Sideload-Modus neu gestartet. Das ist ein spezieller Modus unter „Recovery“.

Wird blockiert, bis das Gerät in den Sideload-Modus wechselt

Ausgabe
`DeviceNotAvailableException`	Wenn sich das Gerät nach dem Neustart nicht im Sideload-Modus befindet

rebootUntilOnline

public abstract void rebootUntilOnline ()

Eine Alternative zu reboot(), die nur blockiert, bis das Gerät online ist, d. h. für ADB sichtbar ist.

Ausgabe
`DeviceNotAvailableException`	Wenn das Gerät nach dem Neustart nicht verfügbar ist

rebootUntilOnline

public abstract void rebootUntilOnline (String reason)

Eine Alternative zu reboot(), die nur blockiert, bis das Gerät online ist, d. h. für ADB sichtbar ist.

Parameter
`reason`	`String`: Ein Grund für diesen Neustart oder `null`, wenn kein Grund angegeben ist.

Ausgabe
`DeviceNotAvailableException`	Wenn das Gerät nach dem Neustart nicht verfügbar ist

Weitere Informationen

reboot(String)

rebootUserspace

public abstract void rebootUserspace ()

Startet nur den Userspace-Teil des Geräts neu.

Wird blockiert, bis das Gerät verfügbar ist.

ACHTUNG: Der Neustart im Userspace befindet sich derzeit in der aktiven Entwicklung. Die Nutzung erfolgt auf eigenes Risiko.

Ausgabe
`DeviceNotAvailableException`	Wenn das Gerät nach dem Neustart nicht verfügbar ist

rebootUserspaceUntilOnline

public abstract void rebootUserspaceUntilOnline ()

Eine Alternative zu rebootUserspace() ()}, die nur blockiert, bis das Gerät online ist, d. h. für adb sichtbar ist.

Ausgabe
`DeviceNotAvailableException`	Wenn das Gerät nach dem Neustart nicht verfügbar ist

remountSystemReadOnly

public abstract void remountSystemReadOnly ()

Die Systempartition auf dem Gerät schreibgeschützt machen. Das Gerät kann neu gestartet werden.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

remountSystemWritable

public abstract void remountSystemWritable ()

Machen Sie die Systempartition auf dem Gerät beschreibbar. Das Gerät kann neu gestartet werden.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

remountVendorReadOnly

public abstract void remountVendorReadOnly ()

Machen Sie die Anbieterpartition auf dem Gerät schreibgeschützt. Das Gerät kann neu gestartet werden.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

remountVendorWritable

public abstract void remountVendorWritable ()

Machen Sie die Anbieterpartition auf dem Gerät beschreibbar. Möglicherweise muss das Gerät neu gestartet werden.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                ITestLifeCycleReceiver... listeners)

Bequeme Methode zum Ausführen von ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) mit einem oder mehreren Listenern, die als Parameter übergeben werden.

Parameter
`runner`	`IRemoteAndroidTestRunner`: die `IRemoteAndroidTestRunner`, die die Tests ausführt
`listeners`	`ITestLifeCycleReceiver`: die Listener für Testergebnisse

Returns
`boolean`	`true`, wenn der Testbefehl abgeschlossen ist. `false`, wenn der Vorgang nicht abgeschlossen werden konnte, aber die Wiederherstellung erfolgreich war

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann, d. h. der Testbefehl konnte nicht abgeschlossen werden und die Wiederherstellung ist fehlgeschlagen.

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Führt Instrumentierungstests aus und bietet die Möglichkeit zur Geräte-Wiederherstellung.

Wenn die Verbindung zum Gerät vor Abschluss des Testlaufs unterbrochen wird und die Wiederherstellung erfolgreich ist, werden alle Listener über „testRunFailed“ informiert und „false“ wird zurückgegeben. Der Testbefehl wird nicht noch einmal ausgeführt. Es liegt an den Anrufern, es bei Bedarf noch einmal zu versuchen.

Wenn die Verbindung zum Gerät vor Abschluss des Testlaufs unterbrochen wird und die Wiederherstellung fehlschlägt, werden alle Listener über „testRunFailed“ informiert und „DeviceNotAvailableException“ wird ausgelöst.

Parameter
`runner`	`IRemoteAndroidTestRunner`: die `IRemoteAndroidTestRunner`, die die Tests ausführt
`listeners`	: die Listener für Testergebnisse

Returns
`boolean`	`true`, wenn der Testbefehl abgeschlossen ist. `false`, wenn der Vorgang aufgrund einer Ausnahme bei der Gerätekommunikation nicht abgeschlossen werden konnte, die Wiederherstellung aber erfolgreich war

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann, d. h. der Testbefehl konnte nicht abgeschlossen werden und die Wiederherstellung ist fehlgeschlagen.

runInstrumentationTestsAsUser

public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                 listeners)

Wie ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), führt den Test jedoch für den angegebenen Nutzer aus.

Parameter
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

public abstract boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                int userId, 
                ITestLifeCycleReceiver... listeners)

Wie ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), führt den Test jedoch für einen bestimmten Nutzer aus.

Parameter
`runner`	`IRemoteAndroidTestRunner`
`userId`	`int`
`listeners`	`ITestLifeCycleReceiver`

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

setDate

public abstract void setDate (Date date)

Legt das Datum auf dem Gerät fest

Hinweis: Das Festlegen des Datums auf dem Gerät erfordert Root-Zugriff.

Parameter
`date`	`Date`: Gibt ein bestimmtes Datum an. Wenn `null` verwendet wird, wird das Hostdatum verwendet.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setOptions

public abstract void setOptions (TestDeviceOptions options)

TestDeviceOptions für das Gerät festlegen

Parameter
`options`	`TestDeviceOptions`

setProperty

public abstract boolean setProperty (String propKey, 
                String propValue)

Legt den angegebenen Eigenschaftswert auf dem Gerät fest. Erfordert, dass „adb root“ auf „true“ gesetzt ist.

Parameter
`propKey`	`String`: Der Schlüssel, der festgelegt werden soll.
`propValue`	`String`: Der festzulegende Property-Wert.

Returns
`boolean`	Gibt `True` zurück, wenn der Befehl „setprop“ erfolgreich war, andernfalls „False“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

setRecovery

public abstract void setRecovery (IDeviceRecovery recovery)

Legen Sie die IDeviceRecovery fest, die für dieses Gerät verwendet werden soll. Sollte festgelegt werden, wenn das Gerät zum ersten Mal zugewiesen wird.

Parameter
`recovery`	`IDeviceRecovery`: die `IDeviceRecovery`

setRecoveryMode

public abstract void setRecoveryMode (ITestDevice.RecoveryMode mode)

Legt den aktuellen Wiederherstellungsmodus fest, der für das Gerät verwendet werden soll.

Wird verwendet, um zu steuern, welche Wiederherstellungsmethode verwendet werden soll, wenn ein Problem bei der Gerätekommunikation auftritt. Es wird empfohlen, diese Methode nur sparsam zu verwenden, wenn sie erforderlich ist (z. B. wenn das Framework nicht funktioniert).

Parameter
`mode`	`ITestDevice.RecoveryMode`: Gibt an, ob der Modus „Nur bis zur Onlineverfügbarkeit wiederherstellen“ aktiviert sein soll.

setTrackingSerial

public abstract void setTrackingSerial (String trackingSerial)

Zur Geräteverwaltung wird die Seriennummer erfasst, die wir zur Referenzierung des Geräts verwenden.

Parameter
`trackingSerial`	`String`

setUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

Legen Sie fest, ob zum Löschen einer Partition auf dem Gerät „fastboot erase“ oder „fastboot format“ verwendet werden soll.

Parameter
`useFastbootErase`	`boolean`: `true`, wenn „fastboot erase“ verwendet werden soll, oder `false`, wenn „fastboot format“ verwendet werden soll.

Weitere Informationen

fastbootWipePartition(String)

startLogcat

public abstract void startLogcat ()

Logcat-Ausgabe vom Gerät im Hintergrund erfassen.

Hat keine Auswirkungen, wenn die logcat-Ausgabe bereits erfasst wird. Daten können später über „getLogcat“ abgerufen werden.

Wenn das Gerät nicht mehr verwendet wird, muss stopLogcat() aufgerufen werden.

startLogcat() und stopLogcat() müssen normalerweise nicht aufgerufen werden, wenn sie sich in einem TF-Aufrufkontext befinden, da das TF-Framework logcat startet und beendet.

startTradeInModeTesting

public abstract boolean startTradeInModeTesting (int timeoutMs)

Testmodus für Inzahlungnahme aktivieren Die Daten auf dem Gerät werden gelöscht und das Gerät wird neu gestartet.

Parameter
`timeoutMs`	`int`

Returns
`boolean`	„True“, wenn erfolgreich, andernfalls „false“

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

stopEmulatorOutput

public abstract void stopEmulatorOutput ()

Schließen Sie die Emulatorausgabe und löschen Sie sie.

stopLogcat

public abstract void stopLogcat ()

Die Erfassung der Logcat-Ausgabe vom Gerät wird beendet und die aktuell gespeicherten Logcat-Daten werden verworfen.

Hat keine Auswirkungen, wenn keine logcat-Ausgabe erfasst wird.

stopTradeInModeTesting

public abstract void stopTradeInModeTesting ()

Testen des Trade-In-Modus beenden Das Gerät wird neu gestartet.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

switchToAdbTcp

public abstract String switchToAdbTcp ()

Gerät in den ADB-over-TCP-Modus versetzen.

Returns
`String`	Die TCP-Seriennummer oder `null`, wenn das Gerät nicht umgeschaltet werden konnte

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

Schalten Sie das Gerät in den ADB-über-USB-Modus.

Returns
`boolean`	`true`, wenn der Wechsel erfolgreich war, andernfalls `false`.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

syncFiles

public abstract boolean syncFiles (File localFileDir, 
                String deviceFilePath)

Synchronisiert den Inhalt eines lokalen Dateiverzeichnisses inkrementell mit dem Gerät.

Legt fest, welche Dateien übertragen werden sollen, indem Zeitstempel lokaler Dateien mit den entsprechenden Remote-Dateien verglichen werden. Nur „neuere“ oder nicht vorhandene Dateien werden auf das Gerät übertragen. Der Aufwand sollte also relativ gering sein, wenn die Dateigruppe auf dem Gerät bereits auf dem neuesten Stand ist.

Versteckte Dateien (deren Namen mit „.“ beginnen) werden ignoriert.

Beispiel: syncFiles("/tmp/files", "/sdcard") erstellt das Verzeichnis „/sdcard/files“, falls es noch nicht vorhanden ist, und überträgt den Inhalt von „/tmp/files“ rekursiv nach „/sdcard/files“.

Parameter
`localFileDir`	`File`: Das lokale Dateiverzeichnis, das rekursiv zu übertragende Dateien enthält.
`deviceFilePath`	`String`: der absolute Dateipfad-Root des Remote-Ziels. Alle Verzeichnisse in diesem Dateipfad müssen lesbar sein. Das Pushen nach /data/local/tmp schlägt fehl, wenn ADB nicht als Root ausgeführt wird.

Returns
`boolean`	`true`, wenn Dateien synchronisiert wurden. Andernfalls `false`.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

unlockDevice

public abstract boolean unlockDevice ()

Entsperrt das Gerät, wenn es verschlüsselt ist.

Diese Methode kann das Framework neu starten, ruft jedoch nicht postBootSetup() auf. Daher ist das Gerät möglicherweise noch nicht vollständig für Tests bereit, wenn diese Methode zurückgegeben wird.

Returns
`boolean`	`true`, wenn der Vorgang erfolgreich war oder das Gerät nicht verschlüsselt ist.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
`UnsupportedOperationException`	wenn die Verschlüsselung auf dem Gerät nicht unterstützt wird.

unmountDebugfs

public abstract void unmountDebugfs ()

debugfs unmounten.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForBootComplete

public abstract boolean waitForBootComplete (long timeOut)

Blockiert, bis das Flag „boot complete“ des Geräts gesetzt ist.

Parameter
`timeOut`	`long`: Zeit in Millisekunden, die gewartet werden soll, bis das Flag gesetzt wird

Returns
`boolean`	„true“, wenn das Flag „boot_complete“ des Geräts innerhalb des Zeitlimits gesetzt ist

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

Wartet, bis das Gerät reagiert und für Tests verfügbar ist. Standardmäßiges Zeitlimit wird verwendet.

Returns
`boolean`	„True“, wenn das Gerät verfügbar ist, „False“, wenn die Wiederherstellung deaktiviert und nicht verfügbar ist.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable (long waitTime)

Wartet, bis das Gerät reagiert und für Tests verfügbar ist.

Parameter
`waitTime`	`long`: die Wartezeit in Millisekunden

Returns
`boolean`	„True“, wenn das Gerät verfügbar ist, „False“, wenn die Wiederherstellung deaktiviert und nicht verfügbar ist.

Ausgabe
`DeviceNotAvailableException`	wenn das Gerät nach Ablauf von „waitTime“ immer noch nicht reagiert.

waitForDeviceAvailableInRecoverPath

public abstract boolean waitForDeviceAvailableInRecoverPath (long waitTime)

Wartet, bis das Gerät reagiert und verfügbar ist, ohne den Wiederherstellungspfad zu berücksichtigen.

Parameter
`waitTime`	`long`

Returns
`boolean`	„Wahr“, wenn das Gerät verfügbar ist, „Falsch“, wenn es nicht verfügbar ist.

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

waitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

Wird blockiert, bis das Gerät über Fastboot sichtbar ist. Standard-Zeitlimit verwenden

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

Sperrt das Gerät, wenn es sich im Status „adb recovery“ befindet. Dieser Status unterscheidet sich von IDeviceRecovery.

Parameter
`waitTime`	`long`: die Wartezeit in Millisekunden

Returns
`boolean`	`true`, wenn das Gerät vor Ablauf der Zeit in den Wiederherstellungsmodus bootet. Andernfalls `false`

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

Blockiert, dass sich das Gerät im Status „adb sideload“ befindet

Parameter
`waitTime`	`long`: die Wartezeit in Millisekunden

Returns
`boolean`	`true`, wenn das Gerät vor Ablauf der Zeit im Sideload-Modus startet. Andernfalls `false`

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

Blockiert, dass das Gerät nicht verfügbar ist, d. h. in ADB fehlt.

Parameter
`waitTime`	`long`: die Wartezeit in Millisekunden

Returns
`boolean`	`true`, wenn das Gerät vor Ablauf der Zeit nicht mehr verfügbar ist. Andernfalls `false`

waitForDeviceOnline

public abstract void waitForDeviceOnline ()

Blockiert, bis das Gerät über ADB sichtbar ist. Standard-Zeitlimit wird verwendet

Das Gerät reagiert nach Abschluss möglicherweise nicht sofort auf Befehle. Verwenden Sie stattdessen waitForDeviceAvailable().

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

waitForDeviceOnline

public abstract void waitForDeviceOnline (long waitTime)

Wird blockiert, bis das Gerät über ADB sichtbar ist.

Das Gerät reagiert nach Abschluss möglicherweise nicht sofort auf Befehle. Verwenden Sie stattdessen waitForDeviceAvailable().

Parameter
`waitTime`	`long`: die Wartezeit in Millisekunden

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

Wartet, bis das Gerät auf einen einfachen ADB-Shell-Befehl reagiert.

Parameter
`waitTime`	`long`: die Wartezeit in Millisekunden

Returns
`boolean`	`true`, wenn das Gerät reagiert, bevor `waitTime` abgelaufen ist.