Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.

Diese Seite wurde von der Cloud Translation API übersetzt.

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 und etwas höhere API 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 in einer virtuellen Maschine ausgeführt wird, die wir per Fernzugriff über eine Tradefed-Instanz in der VM verwalten.
NativeDevice	Standardimplementierung eines `ITestDevice` nicht vollständigen Stacks für Android-Geräte.
NestedRemoteDevice	Darstellung des Geräts, das in einer Remote-Cuttlefish-VM ausgeführt wird.
RemoteAndroidDevice	Implementierung einer `ITestDevice` für ein Full-Stack-Android-Gerät, das über adb connect verbunden ist.
RemoteAndroidVirtualDevice	Erweitert das Verhalten von `RemoteAndroidDevice` für ein Full-Stack-Android-Gerät, das in der Google Compute Engine (GCE) ausgeführt wird.
TestDevice	Implementierung einer `ITestDevice` für ein Full-Stack-Android-Gerät

Bietet eine zuverlässige und etwas höhere API für eine ddmlib IDevice.

Wiederholt Gerätebefehle eine konfigurierbare Anzahl von Malen und bietet eine Benutzeroberfläche zur Gerätewiederherstellung für Geräte, die nicht mehr reagieren.

Zusammenfassung

Konstanten
`int`	`UNKNOWN_API_LEVEL` Standardwert, wenn die API-Ebene nicht erkannt werden kann

Öffentliche Methoden
`abstract boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Prüfen, ob eine Funktion derzeit unterstützt wird, wenn ein Mindestsupportlevel vorhanden ist
`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, um zu prüfen, ob das Gerät neu gestartet wurde, indem der aktuelle system_server mit dem vorherigen system_server `ProcessInfo` verglichen wird.
`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 seiner `ERROR(/TimeUnit)` neu gestartet wurde.
`abstract boolean`	`disableAdbRoot()` Deaktiviert adb root.
`abstract boolean`	`doesFileExist(String deviceFilePath)` Hilfsmethode, um zu ermitteln, 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`	`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 einer Standardzeitüberschreitung von 2 Minuten ausführt.
`abstract CommandResult`	`executeLongFastbootCommand(String... commandArgs)` Hilfsmethode, die einen lang laufenden Fastboot-Befehl als Systembefehl ausführt.
`abstract CommandResult`	`executeLongFastbootCommand( envVarMap, String... commandArgs)` Hilfsmethode, die einen lang laufenden Fastboot-Befehl als Systembefehl mit Systemumgebungsvariablen ausführt.
`abstract String`	`executeShellCommand(String command)` Hilfsmethode, die einen adb-Shell-Befehl 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 aus, um das Befehlsverhalten zu steuern.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.
`abstract void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Führt den angegebenen adb-Shell-Befehl aus und versucht bei einem Fehler mehrmals, ihn auszuführen.
`abstract CommandResult`	`executeShellV2Command(String command)` Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als `CommandResult` zurückgibt, die korrekt mit dem Befehlsstatus, stdout und stderr ausgefüllt ist.
`abstract CommandResult`	`executeShellV2Command(String command, OutputStream pipeToOutput)` Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als `CommandResult` zurückgibt, die korrekt mit der Befehlsstatusausgabe und stderr ausgefü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 korrekt mit dem Befehlsstatus, stdout und stderr ausgefüllt ist.
`abstract CommandResult`	`executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.
`abstract CommandResult`	`executeShellV2Command(String command, long maxTimeoutForCommand, TimeUnit timeUnit)` Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.
`abstract CommandResult`	`executeShellV2Command(String command, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.
`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 aus, um das Befehlsverhalten zu steuern.
`abstract CommandResult`	`fastbootWipePartition(String partition)` Hilfsmethode zum Löschen einer Partition für das Gerät.
`abstract int`	`getApiLevel()` Rufe die API-Ebene des Geräts ab.
`abstract String`	`getBasebandVersion()` Diese Methode ist praktisch, um die Baseband-Version (Funkschnittstelle) dieses Geräts abzurufen.
`abstract Integer`	`getBattery()` Gibt den aktuellen Akkustand eines Geräts zurück oder „Null“, 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 Boot-Verlaufskarte mit Bootzeit und Bootgrund.
`abstract`	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` Mit dieser Hilfsmethode wird die Boot-Verlaufskarte mit Bootzeit und Bootgrund seit dem angegebenen Zeitpunkt seit der Epoche vom Gerät und der angegebenen Zeiteinheit erfasst.
`abstract String`	`getBootloaderVersion()` Diese Methode ist praktisch, um die Bootloader-Version dieses Geräts abzurufen.
`abstract String`	`getBuildAlias()` Ruft 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 auf dem Gerät gerade ausgeführt wird.
`abstract String`	`getBuildSigningKeys()` Gibt den Schlüsseltyp zurück, der zum Signieren des Geräte-Images verwendet wurde. Normalerweise können Android-Geräte mit Testschlüsseln (z. B. in AOSP) oder Release-Schlüsseln (von einzelnen Geräteherstellern gesteuert) 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 manchmal aufgrund von Berechtigungen 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()` Gib ein `DeviceDescriptor` aus den Geräteinformationen zurück, um Informationen dazu zu erhalten, ohne das eigentliche Geräteobjekt zu übergeben.
`abstract DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Gib ein `DeviceDescriptor` aus den Geräteinformationen zurück, um Informationen dazu zu erhalten, ohne das eigentliche Geräteobjekt zu übergeben.
`abstract TestDeviceState`	`getDeviceState()` Rufe den Status des Geräts ab.
`abstract long`	`getDeviceTimeOffset(Date date)` Hilft, die Zeitdifferenz zwischen dem Gerät und einer bestimmten `ERROR(/Date)` zu ermitteln.
`abstract InputStreamSource`	`getEmulatorOutput()` Stream von stdout und stderr des Emulators abrufen
`abstract long`	`getExternalStoreFreeSpace()` Hilfsmethode zum Ermitteln des freien Speicherplatzes auf dem externen Speicher des Geräts.
`abstract String`	`getFastbootProductType()` Diese Methode ist praktisch, um den Produkttyp dieses Geräts im Fastboot-Modus abzurufen.
`abstract String`	`getFastbootProductVariant()` Diese Methode ist praktisch, um den Produkttyp dieses Geräts im Fastboot-Modus abzurufen.
`abstract String`	`getFastbootSerialNumber()` Gibt die Seriennummer des Fastboot-Modus zurück.
`abstract String`	`getFastbootVariable(String variableName)` Ruft den angegebenen Wert der Fastboot-Variablen 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 vom Gerät zurück.
`abstract long`	`getLastExpectedRebootTimeMillis()` Gibt an, wann Tradefed APIs zuletzt einen Neustart in Millisekunden seit der Epoche ausgelöst haben, wie von `System.currentTimeMillis()` zurückgegeben.
`abstract int`	`getLaunchApiLevel()` Das API-Level, mit dem das Gerät zum ersten Mal gestartet wurde.
`abstract InputStreamSource`	`getLogcat()` Erfasst einen Snapshot-Stream der Logcat-Daten.
`abstract InputStreamSource`	`getLogcat(int maxBytes)` Erfasst einen Snapshot-Stream der letzten `maxBytes` gespeicherten Logcat-Daten.
`abstract InputStreamSource`	`getLogcatDump()` Einen Dump des aktuellen Logcat für das Gerät abrufen
`abstract InputStreamSource`	`getLogcatSince(long date)` Erfasst einen Snapshot-Stream der erfassten Logcat-Daten ab dem angegebenen Datum.
`abstract String`	`getMountPoint(String mountName)` Gibt einen Bereitstellungspunkt zurück.
`abstract ITestDevice.MountPointInfo`	`getMountPointInfo(String mountpoint)` Gibt ein `MountPointInfo` zurück, das dem angegebenen Bereitstellungspunktpfad entspricht, oder `null`, wenn an diesem Pfad nichts bereitgestellt ist oder er anderweitig nicht in /proc/mounts als Bereitstellungspunkt aufgeführt ist.
`abstract`	`getMountPointInfo()` Gibt eine geparste Version der Informationen in /proc/mounts auf dem Gerät zurück
`abstract long`	`getPartitionFreeSpace(String partition)` Hilfsmethode zum Bestimmen des freien Speicherplatzes auf der Gerätepartition.
`abstract ProcessInfo`	`getProcessByName(String processName)` Die Hilfsmethode führt die Befehle „pidof“ und „stat“ aus und gibt ein `ProcessInfo`-Objekt mit der PID und dem Prozessstartzeitpunkt des angegebenen Prozesses zurück.
`abstract String`	`getProcessPid(String process)` Gibt die Prozess-ID des Dienstes zurück oder „null“, wenn ein Fehler aufgetreten ist.
`abstract String`	`getProductType()` Eine praktische Methode, um den Produkttyp dieses Geräts zu ermitteln.
`abstract String`	`getProductVariant()` Eine praktische Methode, um die Produktvariante dieses Geräts abzurufen.
`abstract String`	`getProperty(String name)` Ruft den angegebenen Attributwert vom Gerät ab.
`abstract ITestDevice.RecoveryMode`	`getRecoveryMode()` Ruft den aktuellen Wiederherstellungsmodus ab, der für das Gerät verwendet wird.
`abstract String`	`getSerialNumber()` Eine praktische Methode, um die Seriennummer dieses Geräts zu erhalten.
`abstract`	`getTombstones()` Liste der Tombstones von den Geräten abrufen und zurückgeben.
`abstract long`	`getTotalMemory()` Gibt die Gesamtgröße des physischen Arbeitsspeichers in Byte zurück oder -1 bei einem internen Fehler.
`default String`	`getTrackingSerial()` Rufen Sie für die Geräteverwaltung die Seriennummer ab, die zum Nachverfolgen des Geräts verwendet wird.
`abstract boolean`	`getUseFastbootErase()` Ermitteln Sie, ob Sie „fastboot erase“ oder „fastboot format“ verwenden müssen, um eine Partition auf dem Gerät zu löschen.
`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 die Umgehung der Blockierung von App-Installationen aufgrund eines niedrigen Ziel-SDK unterstützt
`abstract boolean`	`isDebugfsMounted()` Prüfen Sie, ob debugfs bereitgestellt ist.
`abstract boolean`	`isDeviceEncrypted()` Gibt an, 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 „wahr“ zurück, wenn das Gerät headless (ohne Bildschirm) ist, andernfalls „falsch“.
`abstract boolean`	`isRuntimePermissionSupported()` Prüfen, ob die Plattform auf dem Gerät die Gewährung 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 ANRs auf dem 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 gibt nach Abschluss des Befehls und wenn das Gerät für adb nicht mehr sichtbar ist, zurück.
`abstract void`	`postBootSetup()` Folgen Sie der Anleitung, um das Gerät für das Testen nach jedem Start 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 erforderliche gerätespezifische Bereinigung, die nach dem Aufruf ausgeführt wird.
`default void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` Zusätzliche Schritte für die erforderliche gerätespezifische Einrichtung, die vor dem Aufrufvorgang auf dem Gerät 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 praktische Methode, um eine Datei aus dem externen Speicher des Geräts abzurufen, in einem lokalen temporären `ERROR(/File)` zu speichern und einen Verweis auf diesen `File` zurückzugeben.
`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 und dabei einige Verzeichnisse ausschließen, die gefiltert 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 Inhaltsanbieter berücksichtigt werden kann.
`abstract boolean`	`pushFile(File localFile, String deviceFilePath)` Dateien an das Gerät senden
`abstract boolean`	`pushFile(File localFile, String deviceFilePath, int userId)` Dateien an das Gerät senden
`abstract boolean`	`pushString(String contents, String deviceFilePath)` Aus einem String erstellte Datei an das Gerät senden
`abstract void`	`reboot()` Startet das Gerät im ADB-Modus neu.
`abstract void`	`reboot(String reason)` Startet das Gerät im ADB-Modus mit der angegebenen `reason` neu, die nach dem Neustart beibehalten werden soll.
`abstract void`	`rebootIntoBootloader()` Das Gerät wird im Bootloader-Modus neu gestartet.
`abstract void`	`rebootIntoFastbootd()` Startet das Gerät im Fastbootd-Modus neu.
`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. Hinweis: Dies ist ein spezieller Modus unter Wiederherstellung. Blockiert, bis das Gerät in den Sideload-Modus wechselt
`abstract void`	`rebootIntoSideload()` Das Gerät wird im adb-Sideload-Modus neu gestartet. Hinweis: Dies ist ein spezieller Modus unter Wiederherstellung. 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, also für adb sichtbar ist.
`abstract void`	`rebootUntilOnline(String reason)` Eine Alternative zu `reboot()`, die nur blockiert, bis das Gerät online ist, also 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()` Die Anbieterpartition auf dem Gerät schreibgeschützt machen.
`abstract void`	`remountVendorWritable()` Machen Sie die Anbieterpartition auf dem Gerät beschreibbar.
`abstract boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` Diese praktische Methode führt `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` mit einem oder mehreren Listenern aus, die als Parameter übergeben werden.
`abstract boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` Führt Instrumentierungstests aus und bietet die Gerätewiederherstellung.
`abstract boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)` Entspricht `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)` Das Datum auf dem Gerät wird festgelegt. Hinweis: Zum Festlegen des Datums auf dem Gerät ist Root-Zugriff erforderlich.
`abstract void`	`setOptions(TestDeviceOptions options)` `TestDeviceOptions` für das Gerät festlegen
`abstract boolean`	`setProperty(String propKey, String propValue)` Legt den angegebenen Property-Wert 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)` Legen Sie den aktuellen Wiederherstellungsmodus für das Gerät fest.
`abstract void`	`setTrackingSerial(String trackingSerial)` Verfolgen Sie für die Geräteverwaltung die Seriennummer, die wir für die Referenzierung des Geräts verwenden.
`abstract void`	`setUseFastbootErase(boolean useFastbootErase)` Legen Sie fest, ob Sie „fastboot erase“ oder „fastboot format“ verwenden möchten, um eine Partition auf dem Gerät zu löschen.
`abstract void`	`startLogcat()` Starten Sie die Erfassung der Logcat-Ausgabe vom Gerät im Hintergrund.
`abstract boolean`	`startTradeInModeTesting(int timeoutMs)` Testen des Trade-In-Modus aktivieren
`abstract void`	`stopEmulatorOutput()` Schließen und löschen Sie die Emulatorausgabe.
`abstract void`	`stopLogcat()` Die Erfassung der Logcat-Ausgabe vom Gerät wird beendet und die derzeit gespeicherten Logcat-Daten werden verworfen.
`abstract void`	`stopTradeInModeTesting()` Testen des Trade-In-Modus beenden.
`abstract String`	`switchToAdbTcp()` Stellen Sie das Gerät auf den adb-over-tcp-Modus um.
`abstract boolean`	`switchToAdbUsb()` Stellen Sie das Gerät auf den Modus „adb over USB“ um.
`abstract boolean`	`syncFiles(File localFileDir, String deviceFilePath)` Synchronisiert den Inhalt eines lokalen Dateiverzeichnisses mit dem Gerät.
`abstract boolean`	`unlockDevice()` Entsperret das Gerät, wenn es verschlüsselt ist.
`abstract void`	`unmountDebugfs()` Entfernen Sie die Bereitstellung von debugfs.
`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 den Test verfügbar ist.
`abstract boolean`	`waitForDeviceAvailable(long waitTime)` Wartet, bis das Gerät reagiert und für den Test 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()` Blockiert, bis das Gerät über Fastboot sichtbar ist.
`abstract boolean`	`waitForDeviceInRecovery(long waitTime)` Verhindert, dass sich das Gerät im Status „adb recovery“ befindet (dies ist nicht dasselbe wie `IDeviceRecovery`).
`abstract boolean`	`waitForDeviceInSideload(long waitTime)` Verhindert, 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. nicht in adb vorhanden ist
`abstract void`	`waitForDeviceOnline()` Blockiert, bis das Gerät über adb sichtbar ist.
`abstract void`	`waitForDeviceOnline(long waitTime)` 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 die API-Ebene nicht erkannt werden kann

Konstanter Wert: −1 (0xffffffff)

Öffentliche Methoden

checkApiLevelAgainstNextRelease

public abstract boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Prüfen, ob eine Funktion derzeit unterstützt wird, wenn ein Mindestsupportlevel vorhanden ist Bei dieser Methode werden noch nicht veröffentlichte Funktionen berücksichtigt, bevor die API-Ebene erhöht wird.

Parameter
`strictMinLevel`	`int`: Die strengste minimale Stufe, die das Feature unterstützt.

Returns
`boolean`	„True“, wenn das Level unterstützt wird. Andernfalls „false“.

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

clearLogcat

public abstract void clearLogcat ()

Löscht alle angesammelten Logcat-Daten.

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

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, von der aus gelöscht werden soll

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

deviceSoftRestarted

public abstract boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Hilfsmethode, um zu prüfen, ob das Gerät neu gestartet wurde, indem der aktuelle system_server mit dem vorherigen system_server ProcessInfo verglichen wird. Verwende getProcessByName(String) als Zahlungsmethode, um ProcessInfo zu erhalten.

Parameter
`prevSystemServerProcess`	`ProcessInfo`: den vorherigen system_server-Prozess `ProcessInfo`.

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

Ausgabe
`RuntimeException`	if device has abnormal boot reason
	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 seiner ERROR(/TimeUnit) neu gestartet wurde. Ein richtlinienbasierter Neustart bezieht sich auf einen Neustart von system_server, der nicht durch einen erzwungenen Neustart des Geräts ausgelöst wurde (z. B. 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 neu gestartet wurde

Ausgabe
`RuntimeException`	if device has abnormal boot reason
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

disableAdbRoot

public abstract boolean disableAdbRoot ()

Deaktiviert adb root.

Wenn Sie adb root deaktivieren, wird die Verbindung des Geräts zu adb möglicherweise getrennt. Bei dieser Methode wird die Blockierung aufrechterhalten, bis das Gerät verfügbar ist.

Returns
`boolean`	`true`, wenn der Vorgang erfolgreich war.

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

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath)

Hilfsmethode, um zu ermitteln, 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“ festgelegt ist, wird eine Meldung protokolliert und die Funktion wird nicht aktiviert.

Wenn Sie „adb root“ aktivieren, wird die Verbindung des Geräts zu ADB möglicherweise getrennt. Bei dieser Methode wird die Blockierung aufrechterhalten, bis das Gerät verfügbar ist.

Returns
`boolean`	`true`, wenn der Vorgang erfolgreich war.

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.

Verwenden Sie stattdessen nach Möglichkeit executeShellCommand(String), da diese Methode eine bessere Fehlererkennung und Leistung bietet.

Parameter
`timeout`	`long`: die Zeit in Millisekunden, nach der das Gerät als nicht antwortend eingestuft wird, 0L für keinen Zeitüberschreitung
`commandArgs`	`String`: der adb-Befehl und die Argumente, die ausgeführt werden sollen

Returns
`String`	den stdout aus dem Befehl. `null`, wenn die Ausführung des Befehls fehlgeschlagen ist.

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.

Verwenden Sie stattdessen nach Möglichkeit executeShellCommand(String), da diese Methode eine bessere Fehlererkennung und Leistung bietet.

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

Returns
`String`	den stdout aus dem Befehl. `null`, wenn die Ausführung des Befehls fehlgeschlagen ist.

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.

Verwenden Sie stattdessen nach Möglichkeit executeShellCommand(String), da diese Methode eine bessere Fehlererkennung und Leistung bietet.

Parameter
`timeout`	`long`: die Zeit in Millisekunden, nach der das Gerät als nicht antwortend eingestuft wird, 0L für keinen Zeitüberschreitung
`envMap`	: Umgebung, die für den Befehl festgelegt werden soll
`commandArgs`	`String`: der adb-Befehl und die Argumente, die ausgeführt werden sollen

Returns
`String`	den stdout aus dem Befehl. `null`, wenn die Ausführung des Befehls fehlgeschlagen ist.

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.

Wird verwendet, wenn sich das Gerät bereits im Fastboot-Modus befindet.

Parameter
`timeout`	`long`: die Zeit in Millisekunden, nach der der Befehl abläuft
`commandArgs`	`String`: der Fastboot-Befehl und die zugehörigen Argumente

Returns
`CommandResult`	„CommandResult“ mit der Befehlsausgabe

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 einer Standardzeitüberschreitung von 2 Minuten ausführt.

Wird verwendet, wenn sich das Gerät bereits im Fastboot-Modus befindet.

Parameter
`commandArgs`	`String`: der Fastboot-Befehl und die zugehörigen Argumente

Returns
`CommandResult`	„CommandResult“ mit der Befehlsausgabe

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 lang laufenden Fastboot-Befehl als Systembefehl ausführt.

Identisch mit executeFastbootCommand(String), mit Ausnahme einer längeren Zeitüberschreitung.

Parameter
`commandArgs`	`String`: der Fastboot-Befehl und die zugehörigen Argumente

Returns
`CommandResult`	„CommandResult“ mit der Befehlsausgabe

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 lang laufenden Fastboot-Befehl als Systembefehl mit Systemumgebungsvariablen ausführt.

Identisch mit executeFastbootCommand(String), mit Ausnahme einer längeren Zeitüberschreitung.

Parameter
`envVarMap`	: die Systemumgebungsvariablen, mit denen der Befehl „fastboot“ ausgeführt wird
`commandArgs`	`String`: der Fastboot-Befehl und die zugehörigen Argumente

Returns
`CommandResult`	„CommandResult“ mit der Befehlsausgabe

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-Shell-Befehl 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 aus, um das Befehlsverhalten zu steuern.

Parameter
`command`	`String`: der auszuführende adb-Shell-Befehl
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver`, an das die Shell-Ausgabe weitergeleitet werden soll.
`maxTimeToOutputShellResponse`	`long`: Die maximale Zeitspanne, während der der Befehl keine Antwort ausgeben darf. Maßeinheit wie in `timeUnit` angegeben.
`timeUnit`	`TimeUnit`: Einheit für `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Die maximale Anzahl der Wiederholungen, die ein Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn `retryAttempts` ohne Erfolg ausgeführt wird.

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 aus, um das Befehlsverhalten zu steuern.

Parameter
`command`	`String`: der auszuführende adb-Shell-Befehl
`receiver`	`IShellOutputReceiver`: `IShellOutputReceiver`, an das die Shell-Ausgabe weitergeleitet werden soll.
`maxTimeoutForCommand`	`long`: Die maximale Zeitüberschreitung für den Befehl, Einheit wie in `timeUnit` angegeben
`maxTimeToOutputShellResponse`	`long`: Die maximale Zeitspanne, während der der Befehl keine Antwort ausgeben darf. Maßeinheit wie in `timeUnit` angegeben.
`timeUnit`	`TimeUnit`: Einheit für `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Die maximale Anzahl der Wiederholungen, die der Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn `retryAttempts` ohne Erfolg ausgeführt wird.

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 bei einem Fehler mehrmals, ihn auszuführen.

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`: `IShellOutputReceiver`, an das 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 korrekt mit dem Befehlsstatus, stdout und stderr ausgefü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 korrekt mit der Befehlsstatusausgabe und stderr ausgefüllt ist. stdout wird an den angegebenen Stream weitergeleitet.

Parameter
`command`	`String`: Der Befehl, der ausgeführt werden soll.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)`, an das die Standardausgabe 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, 
                File pipeAsInput)

Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die korrekt mit dem Befehlsstatus, stdout und stderr ausgefüllt ist.

Parameter
`command`	`String`: Der Befehl, der ausgeführt werden soll.
`pipeAsInput`	`File`: Ein `ERROR(/File)`, das als Eingabe an den Befehl übergeben 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 aus, um das Befehlsverhalten zu steuern.

Parameter
`command`	`String`: der auszuführende adb-Shell-Befehl
`maxTimeoutForCommand`	`long`: Die maximale Zeitüberschreitung für den Befehl, Einheit wie in `timeUnit` angegeben
`timeUnit`	`TimeUnit`: Einheit für `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Die maximale Anzahl der Wiederholungen, die der Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn `retryAttempts` ohne Erfolg ausgeführt wird.

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 aus, um das Befehlsverhalten zu steuern.

Parameter
`command`	`String`: der auszuführende adb-Shell-Befehl
`maxTimeoutForCommand`	`long`: Die maximale Zeitüberschreitung für den Befehl, Einheit wie 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 aus, um das Befehlsverhalten zu steuern.

Parameter
`command`	`String`: der auszuführende adb-Shell-Befehl
`pipeAsInput`	`File`: Ein `ERROR(/File)`, das als Eingabe an den Befehl übergeben wird, oder „null“.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)`, an das die Standardausgabe weitergeleitet wird, oder null.
`maxTimeoutForCommand`	`long`: Die maximale Zeitüberschreitung für den Befehl, Einheit wie in `timeUnit` angegeben
`timeUnit`	`TimeUnit`: Einheit für `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Die maximale Anzahl der Wiederholungen, die der Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn `retryAttempts` ohne Erfolg ausgeführt wird.

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 aus, um das Befehlsverhalten zu steuern.

Parameter
`command`	`String`: der auszuführende adb-Shell-Befehl
`pipeAsInput`	`File`: Ein `ERROR(/File)`, das als Eingabe an den Befehl übergeben wird, oder „null“.
`pipeToOutput`	`OutputStream`: `ERROR(/OutputStream)`, an das die Standardausgabe weitergeleitet wird, oder null.
`pipeToError`	`OutputStream`: `ERROR(/OutputStream)`, an das der Standardfehler weitergeleitet wird, oder null.
`maxTimeoutForCommand`	`long`: Die maximale Zeitüberschreitung für den Befehl, Einheit wie in `timeUnit` angegeben
`timeUnit`	`TimeUnit`: Einheit für `maxTimeToOutputShellResponse`
`retryAttempts`	`int`: Die maximale Anzahl der Wiederholungen, die der Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn `retryAttempts` ohne Erfolg ausgeführt wird.

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)

Hilfsmethode zum Löschen einer Partition für das Gerät.

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

Wird verwendet, wenn sich das Gerät bereits im Fastboot-Modus befindet.

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

Returns
`CommandResult`	„CommandResult“ mit der Befehlsausgabe

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

getApiLevel

public abstract int getApiLevel ()

Rufe die API-Ebene des Geräts ab. 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 ()

Diese Methode ist praktisch, um die Baseband-Version (Funkschnittstelle) dieses Geräts abzurufen. Die Abfrage der Funkversion ist gerätespezifisch und 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. Bei einigen CDMA-Geräten ist das nicht korrekt. Die hier zurückgegebene Version stimmt möglicherweise nicht mit der von fastboot gemeldeten Version überein und ist möglicherweise nicht die Version für das CDMA-Funkmodul. Zusammenfassung: Mit dieser Methode wird nur dann die korrekte Version erfasst, wenn die Property „gsm.version.baseband“ mit der von fastboot getvar version-baseband zurückgegebenen Version übereinstimmt.

Returns
`String`	die Baseband-Version `String` oder `null`, wenn sie nicht ermittelt werden kann (kein Funkschnittstellenmodul oder 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 zurück oder „Null“, 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 das Attribut 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.

Ausgabe
`DeviceNotAvailableException`

getBootHistory

public abstract  getBootHistory ()

Die Hilfsmethode erfasst die Boot-Verlaufskarte mit Bootzeit und Bootgrund.

Returns
	Zuordnung von Bootzeit (UTC-Zeit in Sekunden seit der Epoche) und Bootgrund

Ausgabe
`DeviceNotAvailableException`

getBootHistorySince

public abstract  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

Mit dieser Hilfsmethode wird die Boot-Verlaufskarte mit Bootzeit und Bootgrund seit dem angegebenen Zeitpunkt seit der Epoche vom Gerät und der angegebenen Zeiteinheit erfasst. Die aktuelle utcEpochTime des Geräts in Millisekunden kann über die Methode getDeviceDate() abgerufen werden.

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

Returns
	Zuordnung von Bootzeit (UTC-Zeit in Sekunden seit der Epoche) und Bootgrund

Ausgabe
`DeviceNotAvailableException`

getBootloaderVersion

public abstract String getBootloaderVersion ()

Diese Methode ist praktisch, um die Bootloader-Version dieses Geräts abzurufen.

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

Returns
`String`	die `String`-Bootloaderversion oder `null`, falls diese nicht gefunden werden kann

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

getBuildAlias

public abstract String getBuildAlias ()

Ruft 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 Zahl für Nexus-Builds). Der finale Android 4.2-Release hat beispielsweise den Build-Alias JDQ39 und die Build-ID 573038.

Returns
`String`	den Build-Alias oder die Build-ID, falls er 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 auf dem Gerät gerade ausgeführt wird.

Returns
`String`	die Build-ID oder `IBuildInfo.UNKNOWN_BUILD_ID`, falls 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.

Normalerweise können Android-Geräte mit Testschlüsseln (z. B. in AOSP) oder Release-Schlüsseln (von einzelnen Geräteherstellern gesteuert) signiert werden.

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`: Ob der Deskriptor auf die minimalen Informationen beschränkt werden soll

Returns
`DeviceDescriptor`

getChildren

public abstract String[] getChildren (String deviceFilePath)

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

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

Returns
`String[]`	String-Array, 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`	der 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 ()

Gib ein DeviceDescriptor aus den Geräteinformationen zurück, um Informationen dazu zu erhalten, ohne das eigentliche Geräteobjekt zu übergeben.

Returns
`DeviceDescriptor`

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

Gib ein DeviceDescriptor aus den Geräteinformationen zurück, um Informationen dazu zu erhalten, ohne das eigentliche Geräteobjekt zu übergeben.

Parameter
`shortDescriptor`	`boolean`: Ob der Deskriptor auf die minimalen Informationen beschränkt werden soll

Returns
`DeviceDescriptor`

getDeviceState

public abstract TestDeviceState getDeviceState ()

Rufe den Status des Geräts ab.

Returns
`TestDeviceState`

getDeviceTimeOffset

public abstract long getDeviceTimeOffset (Date date)

Hilft, die Zeitdifferenz zwischen dem Gerät und einer bestimmten ERROR(/Date) zu ermitteln. Verwenden Sie die Epochenzeit intern.

Parameter
`date`	`Date`

Returns
`long`	den Unterschied in Millisekunden

Ausgabe
`DeviceNotAvailableException`

getEmulatorOutput

public abstract InputStreamSource getEmulatorOutput ()

Stream von stdout und stderr des Emulators abrufen

Returns
`InputStreamSource`	Emulatorausgabe

getExternalStoreFreeSpace

public abstract long getExternalStoreFreeSpace ()

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

Returns
`long`	den freien Speicherplatz in KB

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

getFastbootProductType

public abstract String getFastbootProductType ()

Diese Methode ist praktisch, um den Produkttyp dieses Geräts im Fastboot-Modus abzurufen.

Diese Methode sollte nur verwendet werden, wenn sich das Gerät im Fastboot-Modus befindet. Das ist in diesem Fall eine etwas sicherere Variante als die generische getProductType()-Methode, da ITestDevice das Gerät wieder in den Fastboot-Modus versetzen kann, wenn es sich in einem falschen Status befindet oder nicht reagiert.

Returns
`String`	den Namen des `String`-Produkttyps oder `null`, falls 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 ()

Diese Methode ist praktisch, um den Produkttyp dieses Geräts im Fastboot-Modus abzurufen.

Returns
`String`	den Namen des `String`-Produkttyps oder `null`, falls 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 des Fastboot-Modus zurück.

Returns
`String`

getFastbootVariable

public abstract String getFastbootVariable (String variableName)

Ruft den angegebenen Wert der Fastboot-Variablen vom Gerät ab.

Parameter
`variableName`	`String`: der Variablenname

Returns
`String`	den Property-Wert 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 Dateipfad, der abgerufen werden soll. Kann ein absoluter Pfad oder ein Pfad relativ zu „/“ sein. Das heißt, sowohl die Syntax „/system“ als auch „system“ wird unterstützt.

Returns
`IFileEntry`	`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 eine neue IDevice zugewiesen werden. Daher sollten Aufrufer keinen Verweis auf die IDevice speichern, da dieser Verweis möglicherweise veraltet.

Returns
`IDevice`	die `IDevice`

getIntProperty

public abstract long getIntProperty (String name, 
                long defaultValue)

Gibt den Ganzzahlwert der angegebenen Eigenschaft vom Gerät zurück.

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

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

Ausgabe
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public abstract long getLastExpectedRebootTimeMillis ()

Gibt an, wann Tradefed APIs zuletzt einen Neustart in Millisekunden seit der Epoche ausgelöst haben, wie von System.currentTimeMillis() zurückgegeben.

Returns
`long`

getLaunchApiLevel

public abstract int getLaunchApiLevel ()

Das API-Level, mit dem das Gerät zum ersten Mal gestartet wurde. Die Standardeinstellung ist UNKNOWN_API_LEVEL.

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

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

getLogcat

public abstract InputStreamSource getLogcat ()

Erfasst einen Snapshot-Stream der Logcat-Daten.

Es gibt zwei Modi:

Wenn der Logcat derzeit im Hintergrund erfasst wird, werden bis zu TestDeviceOptions.getMaxLogcatDataSize() Byte des aktuellen Inhalts der Logcat-Aufzeichnung im Hintergrund zurückgegeben.

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

Returns
`InputStreamSource`

getLogcat

public abstract InputStreamSource getLogcat (int maxBytes)

Erfasst einen Snapshot-Stream der letzten maxBytes gespeicherten Logcat-Daten.

Nützlich, wenn Sie häufige Snapshots der erfassten Logcat-Daten erstellen möchten, ohne den potenziellen großen Speicherplatzverbrauch durch den gesamten getLogcat()-Snapshot in Kauf nehmen zu müssen.

Parameter
`maxBytes`	`int`: Die maximale Anzahl der zurückzugebenden Daten. Sollte ein Wert sein, der problemlos in den Arbeitsspeicher passt.

Returns
`InputStreamSource`

getLogcatDump

public abstract InputStreamSource getLogcatDump ()

Einen Dump des aktuellen Logcat für das Gerät abrufen 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`	eine `InputStreamSource` der Logcat-Daten. Wenn die Erfassung von Logcat-Daten fehlschlägt, wird ein leerer Stream zurückgegeben.

getLogcatSince

public abstract InputStreamSource getLogcatSince (long date)

Erfasst einen Snapshot-Stream der erfassten Logcat-Daten ab dem angegebenen Datum. Die Uhrzeit auf dem Gerät sollte getDeviceDate() sein.

Parameter
`date`	`long`: Startzeit des Snapshots bis zum aktuellen Zeitpunkt in Millisekunden seit der Epoche. (kann mit „date +%s“ abgerufen werden)

Returns
`InputStreamSource`

getMountPoint

public abstract String getMountPoint (String mountName)

Gibt einen Bereitstellungspunkt zurück.

Das Gerät wird direkt abgefragt, wenn die im Cache in IDevice gespeicherten Informationen 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 Bereitstellungspunktpfad entspricht, oder null, wenn an diesem Pfad nichts bereitgestellt ist oder er anderweitig nicht in /proc/mounts als Bereitstellungspunkt aufgeführt ist.

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 Bestimmen des freien Speicherplatzes auf der Gerätepartition.

Parameter
`partition`	`String`

Returns
`long`	den freien 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 ein ProcessInfo-Objekt mit der PID und dem Prozessstartzeitpunkt des angegebenen Prozesses zurück.

Parameter
`processName`	`String`: Der String für den Prozessnamen.

Returns
`ProcessInfo`	ProcessInfo des angegebenen processName

Ausgabe
`DeviceNotAvailableException`

getProcessPid

public abstract String getProcessPid (String process)

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

Parameter
`process`	`String`: Der String für den Prozessnamen.

Returns
`String`

Ausgabe
`DeviceNotAvailableException`

getProductType

public abstract String getProductType ()

Eine praktische Methode, um den Produkttyp dieses Geräts zu ermitteln.

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

Returns
`String`	den Namen des `String`-Produkttyps. 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 ()

Eine praktische Methode, um die Produktvariante dieses Geräts abzurufen.

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

Returns
`String`	den Namen der `String`-Produktvariante oder `null`, falls dieser 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`	den Property-Wert oder `null`, falls er nicht vorhanden ist

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

getRecoveryMode

public abstract ITestDevice.RecoveryMode getRecoveryMode ()

Ruft den aktuellen Wiederherstellungsmodus ab, der für das Gerät verwendet wird.

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

getSerialNumber

public abstract String getSerialNumber ()

Eine praktische Methode, um die Seriennummer dieses Geräts zu erhalten.

Returns
`String`	die Seriennummer `String`

getTombstones

public abstract  getTombstones ()

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

Methode ist ein Best-Effort-Verfahren. 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 Arbeitsspeichers in Byte zurück oder -1 bei einem internen Fehler.

Returns
`long`

getTrackingSerial

public String getTrackingSerial ()

Rufen Sie für die Geräteverwaltung die Seriennummer ab, die zum Nachverfolgen des Geräts verwendet wird.

Returns
`String`

getUseFastbootErase

public abstract boolean getUseFastbootErase ()

Ermitteln Sie, ob Sie „fastboot erase“ oder „fastboot format“ verwenden müssen, um eine Partition auf dem Gerät zu löschen.

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

Weitere Informationen

fastbootWipePartition(String)

isAdbRoot

public abstract boolean isAdbRoot ()

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

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 mit adb-over-tcp verbunden ist, `false` andernfalls.

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 die Umgehung 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 bereitgestellt ist.

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

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

isDeviceEncrypted

public abstract boolean isDeviceEncrypted ()

Gibt an, 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 „wahr“ zurück, wenn das Gerät headless (ohne Bildschirm) ist, andernfalls „falsch“.

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isRuntimePermissionSupported

public abstract boolean isRuntimePermissionSupported ()

Prüfen, ob die Plattform auf dem Gerät die Gewährung 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 ANRs auf dem Gerät.

Parameter
`logger`	`ITestLogger`: einen `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 nicht fehlschlägt, wenn die Protokollierung fehlschlägt.

Parameter
`tag`	`String`: Das Tag, unter dem wir unsere Nachricht im Logcat protokollieren.
`level`	`Log.LogLevel`: Die Debugebene 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 gibt nach Abschluss des Befehls und wenn das Gerät für adb nicht mehr sichtbar ist, zurück.

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

postBootSetup

public abstract void postBootSetup ()

Folgen Sie der Anleitung, um das Gerät für das Testen nach jedem Start zu konfigurieren.

Sollte aufgerufen werden, nachdem das Gerät vollständig gestartet wurde bzw. verfügbar ist

Normalerweise muss diese Methode nicht explizit aufgerufen werden, da diese Schritte bei einem Neustart automatisch ausgeführt werden sollten.

Dies kann erforderlich sein, wenn das Gerät aufgrund anderer Ereignisse neu gestartet wird, z. B. wenn ein Fastboot-Update-Befehl abgeschlossen wurde.

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

postInvocationTearDown

public void postInvocationTearDown ()

Diese Methode ist veraltet.
Verwenden Sie stattdessen postInvocationTearDown(Throwable).

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

postInvocationTearDown

public abstract void postInvocationTearDown (Throwable invocationException)

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

Parameter
`invocationException`	`Throwable`: die letzte Ausnahme, die durch den Aufruffehler ausgelöst wurde, falls vorhanden.

preInvocationSetup

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

Zusätzliche Schritte für die erforderliche gerätespezifische Einrichtung, die vor dem Aufrufvorgang auf dem Gerät 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 gezogen werden sollen

Returns
`boolean`	`true`, wenn die Datei erfolgreich 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 gezogen werden sollen
`userId`	`int`: die Nutzer-ID, aus der Daten abgerufen werden sollen

Returns
`boolean`	`true`, wenn die Datei erfolgreich 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 (z. B. aufgrund von 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 (z. B. aufgrund von 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 die Inhalte gespeichert werden sollen. Wenn das Feld nicht leer ist, wird der Inhalt ersetzt.

Returns
`boolean`	`true`, wenn die Datei erfolgreich 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 die 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 erfolgreich 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 (z. B. aufgrund von Problemen mit dem Hostdateisystem)

Ausgabe
`DeviceNotAvailableException`

pullFileFromExternal

public abstract File pullFileFromExternal (String remoteFilePath)

Eine praktische Methode, um eine Datei aus dem externen Speicher des Geräts abzurufen, in einem lokalen temporären ERROR(/File) zu speichern und einen Verweis auf diesen File zurückzugeben.

Parameter
`remoteFilePath`	`String`: Pfad zur Datei auf dem Gerät, relativ zum Bereitstellungspunkt 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 (z. B. aufgrund von 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 gepusht werden soll
`deviceFilePath`	`String`: der absolute Dateipfad des Remote-Ziels
`userId`	`int`: die Nutzer-ID, an die gesendet werden soll

Returns
`boolean`	`true`, wenn die Datei erfolgreich gepusht 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 und dabei einige Verzeichnisse ausschließen, die gefiltert werden.

Parameter
`localDir`	`File`: das lokale Verzeichnis, das gepusht werden soll
`deviceFilePath`	`String`: der absolute Dateipfad des Remote-Ziels
`excludedDirectories`	: Liste der auszuschließenden Verzeichnisnamen, die nicht gepusht werden sollen.

Returns
`boolean`	`true`, wenn die Datei erfolgreich gepusht 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 gepusht werden soll
`deviceFilePath`	`String`: der absolute Dateipfad des Remote-Ziels

Returns
`boolean`	`true`, wenn die Datei erfolgreich gepusht 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 Inhaltsanbieter berücksichtigt werden kann.

Parameter
`localFile`	`File`: die lokale Datei, die gepusht werden soll
`deviceFilePath`	`String`: der absolute Dateipfad des Remote-Ziels
`evaluateContentProviderNeeded`	`boolean`: ob geprüft werden soll, ob wir den Contentanbieter benötigen

Returns
`boolean`	`true`, wenn die Datei erfolgreich gepusht 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)

Dateien an das Gerät senden Standardmäßig wird ein Contentanbieter verwendet.

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

Returns
`boolean`	`true`, wenn die Datei erfolgreich gepusht 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)

Dateien an das Gerät senden Standardmäßig wird ein Contentanbieter verwendet.

Parameter
`localFile`	`File`: die lokale Datei, die gepusht werden soll
`deviceFilePath`	`String`: der absolute Dateipfad des Remote-Ziels
`userId`	`int`: die userId, an die gepusht werden soll

Returns
`boolean`	`true`, wenn die Datei erfolgreich gepusht 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 an das Gerät senden

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

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

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

neu starten

public abstract void reboot ()

Startet das Gerät im ADB-Modus neu.

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

Ausgabe
`DeviceNotAvailableException`	if device is not available after reboot

neu starten

public abstract void reboot (String reason)

Startet das Gerät im ADB-Modus mit der angegebenen reason neu, die nach dem Neustart beibehalten werden soll.

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

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

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

Ausgabe
`DeviceNotAvailableException`	if device is not available after reboot

rebootIntoBootloader

public abstract void rebootIntoBootloader ()

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

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

Startet das Gerät im Fastbootd-Modus neu.

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.

Blockiert, bis das Gerät in den Wiederherstellungsmodus wechselt

Ausgabe
`DeviceNotAvailableException`	if device is not available after reboot

rebootIntoSideload

public abstract void rebootIntoSideload (boolean autoReboot)

Das Gerät wird im adb-Sideload-Modus neu gestartet. Hinweis: Dies ist ein spezieller Modus unter Wiederherstellung.

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

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

Ausgabe
`DeviceNotAvailableException`	if device is not in sideload after reboot

rebootIntoSideload

public abstract void rebootIntoSideload ()

Das Gerät wird im adb-Sideload-Modus neu gestartet. Hinweis: Dies ist ein spezieller Modus unter Wiederherstellung.

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

Ausgabe
`DeviceNotAvailableException`	if device is not in sideload after reboot

rebootUntilOnline

public abstract void rebootUntilOnline ()

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

Ausgabe
`DeviceNotAvailableException`	if device is not available after reboot

rebootUntilOnline

public abstract void rebootUntilOnline (String reason)

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

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

Ausgabe
`DeviceNotAvailableException`	if device is not available after reboot

Weitere Informationen

reboot(String)

rebootUserspace

public abstract void rebootUserspace ()

Startet nur den Nutzerbereich des Geräts neu.

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

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

Ausgabe
`DeviceNotAvailableException`	if device is not available after reboot

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`	if device is not available after reboot

remountSystemReadOnly

public abstract void remountSystemReadOnly ()

Die Systempartition auf dem Gerät schreibgeschützt machen. Das Gerät wird möglicherweise neu gestartet.

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

remountSystemWritable

public abstract void remountSystemWritable ()

Machen Sie die Systempartition auf dem Gerät beschreibbar. Das Gerät wird möglicherweise neu gestartet.

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

remountVendorReadOnly

public abstract void remountVendorReadOnly ()

Die Anbieterpartition auf dem Gerät schreibgeschützt machen. Das Gerät wird möglicherweise neu gestartet.

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

remountVendorWritable

public abstract void remountVendorWritable ()

Machen Sie die Anbieterpartition auf dem Gerät beschreibbar. Das Gerät wird möglicherweise neu gestartet.

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

runInstrumentationTests

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

Diese praktische Methode führt ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection)) mit einem oder mehreren Listenern aus, die als Parameter übergeben werden.

Parameter
`runner`	`IRemoteAndroidTestRunner`: die `IRemoteAndroidTestRunner`, auf der die Tests ausgeführt werden
`listeners`	`ITestLifeCycleReceiver`: die Testergebnis-Listener

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

Ausgabe
`DeviceNotAvailableException`	Wenn die Verbindung zum Gerät unterbrochen wurde und nicht wiederhergestellt werden kann. Das bedeutet, dass der Testbefehl nicht abgeschlossen und die Wiederherstellung fehlgeschlagen ist.

runInstrumentationTests

public abstract boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

Führt Instrumentierungstests aus und bietet die Gerätewiederherstellung.

Wenn die Verbindung zum Gerät vor Abschluss des Tests 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. Anrufer müssen bei Bedarf noch einmal versuchen, sich zu verbinden.

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

Parameter
`runner`	`IRemoteAndroidTestRunner`: die `IRemoteAndroidTestRunner`, auf der die Tests ausgeführt werden
`listeners`	: die Testergebnis-Listener

Returns
`boolean`	`true`, wenn der Testbefehl abgeschlossen ist. `false`, wenn die Ausführung aufgrund einer Ausnahme bei der Gerätekommunikation fehlgeschlagen ist, die Wiederherstellung aber erfolgreich war

Ausgabe
`DeviceNotAvailableException`	Wenn die Verbindung zum Gerät unterbrochen wurde und nicht wiederhergestellt werden kann. Das bedeutet, dass der Testbefehl nicht abgeschlossen und die Wiederherstellung fehlgeschlagen ist.

runInstrumentationTestsAsUser

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

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

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

Das Datum auf dem Gerät wird festgelegt.

Hinweis: Zum Festlegen des Datums auf dem Gerät ist Root-Zugriff erforderlich.

Parameter
`date`	`Date`: ein bestimmtes Datum angeben; es wird das Datum des Hosts verwendet, wenn `null`

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 Property-Wert auf dem Gerät fest. Erfordert, dass „adb root“ auf „wahr“ 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)

Legen Sie den aktuellen Wiederherstellungsmodus für das Gerät fest.

Hiermit wird festgelegt, welche Wiederherstellungsmethode verwendet werden soll, wenn ein Problem mit der Gerätekommunikation auftritt. Wir empfehlen, diese Methode nur sparsam zu verwenden, wenn sie erforderlich ist (z. B. wenn das Framework ausgefallen ist).

Parameter
`mode`	`ITestDevice.RecoveryMode`: ob der Modus „Nur bis zur Onlinewiederherstellung“ aktiviert sein soll

setTrackingSerial

public abstract void setTrackingSerial (String trackingSerial)

Verfolgen Sie für die Geräteverwaltung die Seriennummer, die wir für die Referenzierung des Geräts verwenden.

Parameter
`trackingSerial`	`String`

setUseFastbootErase

public abstract void setUseFastbootErase (boolean useFastbootErase)

Legen Sie fest, ob Sie „fastboot erase“ oder „fastboot format“ verwenden möchten, um eine Partition auf dem Gerät zu löschen.

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

Starten Sie die Erfassung der Logcat-Ausgabe vom Gerät im Hintergrund.

Hat keine Auswirkungen, wenn die Logcat-Ausgabe bereits erfasst wird. Die 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)

Testen des Trade-In-Modus aktivieren Das Gerät wird gelöscht und 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 und löschen Sie die Emulatorausgabe.

stopLogcat

public abstract void stopLogcat ()

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

Hat keine Auswirkungen, wenn die Logcat-Ausgabe nicht 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 ()

Stellen Sie das Gerät auf den adb-over-tcp-Modus um.

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

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

switchToAdbUsb

public abstract boolean switchToAdbUsb ()

Stellen Sie das Gerät auf den Modus „adb over USB“ um.

Returns
`boolean`	`true`, wenn die Umstellung 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 mit dem Gerät.

Entscheidet, welche Dateien gepusht werden sollen, indem Zeitstempel lokaler Dateien mit den entsprechenden Remote-Dateien verglichen werden. Nur neuere oder nicht vorhandene Dateien werden auf das Gerät gepusht. Der Overhead sollte also relativ gering sein, wenn die Datei auf dem Gerät bereits auf dem neuesten Stand ist.

Ausgeblendete Dateien (mit Namen, die mit einem Punkt beginnen) werden ignoriert.

Beispiel: Mit syncFiles("/tmp/files", "/sdcard") wird das Verzeichnis „/sdcard/files“ erstellt, falls es noch nicht vorhanden ist, und der Inhalt von „/tmp/files“ wird rekursiv in „/sdcard/files“ kopiert.

Parameter
`localFileDir`	`File`: das lokale Dateiverzeichnis mit Dateien, die rekursiv gepusht werden sollen.
`deviceFilePath`	`String`: der absolute Pfad des Remote-Zielorders. Alle Verzeichnisse in diesem Dateipfad müssen lesbar sein. Wenn also adb nicht root ist, schlägt das Übertragen in /data/local/tmp fehl.

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

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

unlockDevice

public abstract boolean unlockDevice ()

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

Diese Methode kann das Framework neu starten, ruft aber postBootSetup() nicht auf. Daher ist das Gerät möglicherweise noch nicht vollständig für den Test 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 ()

Entfernen Sie die Bereitstellung von debugfs.

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 wird

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

waitForDeviceAvailable

public abstract boolean waitForDeviceAvailable ()

Wartet, bis das Gerät reagiert und für den Test verfügbar ist. Es wird das Standardzeitlimit 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 den Test verfügbar ist.

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

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

Ausgabe
`DeviceNotAvailableException`	if device is still unresponsive after waitTime expires.

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`	„True“, wenn das Gerät verfügbar ist, „False“, wenn nicht.

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

waitForDeviceBootloader

public abstract void waitForDeviceBootloader ()

Blockiert, bis das Gerät über Fastboot sichtbar ist. Standardzeitlimit verwenden

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

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

Verhindert, dass sich das Gerät im Status „adb recovery“ befindet (dies ist nicht dasselbe wie IDeviceRecovery).

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

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

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

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

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

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

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

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

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

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

waitForDeviceOnline

public abstract void waitForDeviceOnline ()

Blockiert, bis das Gerät über adb sichtbar ist. Standardzeitlimit wird verwendet

Das Gerät reagiert nach Abschluss möglicherweise nicht 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)

Blockiert, bis das Gerät über adb sichtbar ist.

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

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

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 ms

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