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.

NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

java.lang.Object
↳	com.android.tradefed.device.NativeDevice

Bekannte direkte Unterklassen

TestDevice

TestDevice Implementierung einer ITestDevice für ein Full-Stack-Android-Gerät

Bekannte indirekte Unterklassen

LocalAndroidVirtualDevice, ManagedRemoteDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice

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.
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.

Standardimplementierung eines ITestDevice nicht vollständigen Stacks für Android-Geräte.

Zusammenfassung

Verschachtelte Klassen
`class`	`NativeDevice.AdbAction` Eine `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` zum Ausführen eines Betriebssystembefehls vom Typ „adb…“.
`class`	`NativeDevice.AdbShellAction`
`class`	`NativeDevice.RebootDeviceAction` `ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction)` zum Neustarten eines Geräts.

Konstanten
`int`	`INVALID_USER_ID` Wert, der für eine ungültige/nicht gefundene Nutzer-ID zurückgegeben wird: UserHandle hat den Wert -10000 definiert
`long`	`MAX_HOST_DEVICE_TIME_OFFSET`
`int`	`MAX_RETRY_ATTEMPTS` die Standardanzahl der Wiederholungsversuche für Befehle

Felder
`public static final String`	`DEBUGFS_PATH`
`protected static final String`	`SD_CARD`
`protected static final String`	`STORAGE_EMULATED`
`protected TestDeviceOptions`	`mOptions`
`protected final IDeviceStateMonitor`	`mStateMonitor`

Öffentliche Konstruktoren
`NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)` Erstellt einen `TestDevice`.

Öffentliche Methoden
`void`	`batchPrefetchStartupBuildProps()` Mikrooptimierung (ca. 400 Millisekunden) durch Vorabladen aller benötigten Props, anstatt für jede einzelne „adb getprop“ aufzurufen.
`boolean`	`canSwitchToHeadlessSystemUser()` Gibt an, ob der Wechsel zum headless SYSTEM-Nutzer zulässig ist.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Prüfen, ob eine Funktion derzeit unterstützt wird, wenn ein Mindestsupportlevel vorhanden ist
`boolean`	`checkConnectivity()` Prüfen Sie, ob das Gerät eine Netzwerkverbindung hat.
`boolean`	`clearErrorDialogs()` Schließen Sie alle Fehlerdialogfelder, die derzeit auf der Geräteoberfläche angezeigt werden.
`void`	`clearLastConnectedWifiNetwork()` Das zuletzt verbundene WLAN wird gelöscht.
`void`	`clearLogcat()` Löscht alle angesammelten Logcat-Daten.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` Stellt eine Verbindung zu einem WLAN her.
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` Stellt eine Verbindung zu einem WLAN her.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk)` Verbindet sich mit einem WLAN.
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` Stellt eine Verbindung zu einem WLAN her.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)` Eine Variante von `connectToWifiNetwork(String, String)`, die nur dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)` Eine Variante von `connectToWifiNetwork(String, String)`, die nur dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.
`int`	`createUser(String name, boolean guest, boolean ephemeral)` Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen
`int`	`createUser(String name)` Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
`int`	`createUserNoThrow(String name)` Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
`DeviceInspectionResult`	`debugDeviceNotAvailable()` Prüfen Sie ein Gerät und geben Sie detaillierte Informationen zurück, wenn ein Gerät nicht verfügbar ist.
`void`	`deleteFile(String deviceFilePath, int userId)` Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät.
`void`	`deleteFile(String deviceFilePath)` Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät.
`void`	`deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Entfernt die registrierte `IDeviceActionReceiver`.
`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.
`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.
`boolean`	`disableAdbRoot()` Deaktiviert adb root.
`void`	`disableKeyguard()` Es wird versucht, den Keyguard zu deaktivieren.
`boolean`	`disableNetworkMonitor()` Deaktiviert die Netzwerküberwachung auf dem Gerät.
`boolean`	`disconnectFromWifi()` Trennen Sie die Verbindung zu einem WLAN.
`boolean`	`doesFileExist(String deviceFilePath, int userId)` Hilfsmethode, um zu ermitteln, ob eine Datei auf dem Gerät für einen bestimmten Nutzer vorhanden ist.
`boolean`	`doesFileExist(String deviceFilePath)` Hilfsmethode, um zu ermitteln, ob eine Datei auf dem Gerät vorhanden ist.
`File`	`dumpHeap(String process, String devicePath)` Versuchen Sie, den Heap aus dem system_server zu dumpen.
`boolean`	`enableAdbRoot()` Aktiviert adb root.
`boolean`	`enableNetworkMonitor()` Aktiviert die Netzwerküberwachung auf dem Gerät.
`String`	`executeAdbCommand(long timeout, String... cmdArgs)` Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.
`String`	`executeAdbCommand(long timeout, envMap, String... cmdArgs)` Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.
`String`	`executeAdbCommand(String... cmdArgs)` Hilfsmethode, die einen adb-Befehl als Systembefehl ausführt.
`CommandResult`	`executeFastbootCommand(String... cmdArgs)` Hilfsmethode, die einen Fastboot-Befehl als Systembefehl mit einer Standardzeitüberschreitung von 2 Minuten ausführt.
`CommandResult`	`executeFastbootCommand(long timeout, String... cmdArgs)` Hilfsmethode, die einen Fastboot-Befehl als Systembefehl ausführt.
`CommandResult`	`executeLongFastbootCommand(String... cmdArgs)` Hilfsmethode, die einen lang laufenden Fastboot-Befehl als Systembefehl ausführt.
`CommandResult`	`executeLongFastbootCommand( envVarMap, String... cmdArgs)` Hilfsmethode, die einen lang laufenden Fastboot-Befehl als Systembefehl mit Systemumgebungsvariablen ausführt.
`String`	`executeShellCommand(String command)` Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ausgabe als `String` zurückgibt.
`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.
`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.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Führt den angegebenen adb-Shell-Befehl aus und versucht bei einem Fehler mehrmals, ihn auszuführen.
`CommandResult`	`executeShellV2Command(String cmd)` 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.
`CommandResult`	`executeShellV2Command(String cmd, 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.
`CommandResult`	`executeShellV2Command(String cmd, 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.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.
`CommandResult`	`executeShellV2Command(String cmd, 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.
`CommandResult`	`executeShellV2Command(String cmd, 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.
`CommandResult`	`fastbootWipePartition(String partition)` Hilfsmethode zum Löschen einer Partition für das Gerät.
	`getActiveApexes()` Ruft die Informationen zu den auf dem Gerät aktivierten APEX-Objekten ab.
	`getAllSettings(String namespace)` Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück.
`DeviceAllocationState`	`getAllocationState()` Gibt den aktuellen Zuweisungsstatus des Geräts zurück
`String`	`getAndroidId(int userId)` Die mit einer Nutzer-ID verknüpfte Android-ID suchen und zurückgeben. Wenn sie nicht gefunden wird, wird „null“ zurückgegeben.
	`getAndroidIds()` Erstellen Sie eine Zuordnungstabelle mit den gefundenen Android-IDs und den zugehörigen User-IDs.
`int`	`getApiLevel()` Rufe die API-Ebene des Geräts ab.
`PackageInfo`	`getAppPackageInfo(String packageName)` Ruft Informationen zu einem auf dem Gerät installierten Paket ab.
	`getAppPackageInfos()` Ruft Informationen zu auf dem Gerät installierten Paketen ab.
`String`	`getBasebandVersion()` Diese Methode ist praktisch, um die Baseband-Version (Funkschnittstelle) dieses Geräts abzurufen.
`Integer`	`getBattery()` Gibt den aktuellen Akkustand eines Geräts zurück oder „Null“, wenn der Akkustand nicht verfügbar ist.
`boolean`	`getBooleanProperty(String name, boolean defaultValue)` Gibt den booleschen Wert der angegebenen Property zurück.
	`getBootHistory()` Die Hilfsmethode erfasst die Boot-Verlaufskarte mit Bootzeit und Bootgrund.
	`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.
`String`	`getBootloaderVersion()` Diese Methode ist praktisch, um die Bootloader-Version dieses Geräts abzurufen.
`InputStreamSource`	`getBugreport()` Ruft einen Fehlerbericht vom Gerät ab.
`InputStreamSource`	`getBugreportz()` Ruft einen Fehlerbericht vom Gerät ab.
`String`	`getBuildAlias()` Ruft den Alias des Builds ab, der auf dem Gerät gerade ausgeführt wird.
`String`	`getBuildFlavor()` Ruft die Build-Variante für das Gerät ab.
`String`	`getBuildId()` Ruft den Build ab, der auf dem Gerät gerade ausgeführt wird.
`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.
`DeviceDescriptor`	`getCachedDeviceDescriptor()` Gibt einen im Cache gespeicherten `DeviceDescriptor` zurück, wenn das Gerät zugewiesen ist. Andernfalls wird der aktuelle `DeviceDescriptor` zurückgegeben.
`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.
`String[]`	`getChildren(String path)` Alternative zur Verwendung von `IFileEntry`, die manchmal aufgrund von Berechtigungen nicht funktioniert.
`AbstractConnection`	`getConnection()` Die aktuelle Verbindung, die mit dem Gerät verknüpft ist.
`ContentProviderHandler`	`getContentProvider(int userId)` Gibt `ContentProviderHandler` zurück oder NULL, wenn der Wert nicht verfügbar ist.
`DeviceFoldableState`	`getCurrentFoldableState()` Gibt den aktuellen Faltstatus des Geräts zurück oder „null“, wenn Probleme aufgetreten sind.
`int`	`getCurrentUser()` Gibt die ID des aktuell laufenden Nutzers zurück.
`String`	`getDeviceClass()` Geräteklasse abrufen
`long`	`getDeviceDate()` Gibt das Datum des Geräts in Millisekunden seit der Epoche zurück.
`DeviceDescriptor`	`getDeviceDescriptor()` Gib ein `DeviceDescriptor` aus den Geräteinformationen zurück, um Informationen dazu zu erhalten, ohne das eigentliche Geräteobjekt zu übergeben.
`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.
`TestDeviceState`	`getDeviceState()` Rufe den Status des Geräts ab.
`long`	`getDeviceTimeOffset(Date date)` Hilft, die Zeitdifferenz zwischen dem Gerät und einer bestimmten `ERROR(/Date)` zu ermitteln.
`InputStreamSource`	`getEmulatorOutput()` Stream von stdout und stderr des Emulators abrufen
`Process`	`getEmulatorProcess()` Gibt die `Process` zurück, die diesem Emulator entspricht.
`final File`	`getExecuteShellCommandLog()` Das Protokoll, das alle `executeShellCommand(String)`-Protokolle enthält.
`long`	`getExternalStoreFreeSpace()` Hilfsmethode zum Ermitteln des freien Speicherplatzes auf dem externen Speicher des Geräts.
`String`	`getFastbootPath()` Gibt den Pfad der verwendeten Fastboot-Binärdatei zurück.
`String`	`getFastbootProductType()` Diese Methode ist praktisch, um den Produkttyp dieses Geräts im Fastboot-Modus abzurufen.
`String`	`getFastbootProductVariant()` Diese Methode ist praktisch, um den Produkttyp dieses Geräts im Fastboot-Modus abzurufen.
`String`	`getFastbootSerialNumber()` Gibt die Seriennummer des Fastboot-Modus zurück.
`String`	`getFastbootVariable(String variableName)` Ruft den angegebenen Wert der Fastboot-Variablen vom Gerät ab.
`String`	`getFastbootVersion()` Gibt den Versionsstring der verwendeten Fastboot-Binärdatei zurück.
`IFileEntry`	`getFileEntry(String path)` Eine Referenz auf eine Remotedatei auf dem Gerät abrufen
`IFileEntry`	`getFileEntry(FileListingService.FileEntry entry)` Inoffizieller Helfer zum Abrufen einer `FileEntry` von einem nicht übergeordneten Pfad.
	`getFoldableStates()` Gibt die Liste der Zustände des faltbaren Geräts zurück.
`IDevice`	`getIDevice()` Gibt einen Verweis auf die zugehörige ddmlib-`IDevice` zurück.
	`getInstalledPackageNames()` Ruft die Namen der Anwendungspakete auf dem Gerät ab.
`long`	`getIntProperty(String name, long defaultValue)` Gibt den Ganzzahlwert der angegebenen Eigenschaft vom Gerät zurück.
`String`	`getIpAddress()` Ruft die IP-Adresse des Geräts ab.
`KeyguardControllerState`	`getKeyguardState()` Gib ein Objekt zurück, um den aktuellen Status des Sperrbildschirms abzurufen, oder „null“, wenn er nicht unterstützt wird.
`long`	`getLastExpectedRebootTimeMillis()` Gibt an, wann Tradefed APIs zuletzt einen Neustart in Millisekunden seit der Epoche ausgelöst haben, wie von `System.currentTimeMillis()` zurückgegeben.
`int`	`getLaunchApiLevel()` Das API-Level, mit dem das Gerät zum ersten Mal gestartet wurde.
`InputStreamSource`	`getLogcat()` Erfasst einen Snapshot-Stream der Logcat-Daten.
`InputStreamSource`	`getLogcat(int maxBytes)` Erfasst einen Snapshot-Stream der letzten `maxBytes` gespeicherten Logcat-Daten.
`InputStreamSource`	`getLogcatDump()` Einen Dump des aktuellen Logcat für das Gerät abrufen
`InputStreamSource`	`getLogcatSince(long date)` Erfasst einen Snapshot-Stream der erfassten Logcat-Daten ab dem angegebenen Datum.
`String`	`getMacAddress()` Gibt die MAC-Adresse des Geräts zurück. Wenn die Abfrage fehlschlägt, wird „null“ zurückgegeben.
`Integer`	`getMainUserId()` Gibt die Hauptnutzer-ID zurück.
	`getMainlineModuleInfo()` Informationen zu den auf dem Gerät installierten Mainline-Modulen abrufen
`int`	`getMaxNumberOfRunningUsersSupported()` Die maximale Anzahl der gleichzeitig unterstützten Nutzer abrufen
`int`	`getMaxNumberOfUsersSupported()` Maximal unterstützte Nutzerzahl abrufen
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` Gibt den mit dem Gerät verknüpften `IDeviceStateMonitor` zurück.
`String`	`getMountPoint(String mountName)` Gibt einen Bereitstellungspunkt zurück.
`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.
	`getMountPointInfo()` Gibt eine geparste Version der Informationen in /proc/mounts auf dem Gerät zurück
`TestDeviceOptions`	`getOptions()` Rufen Sie die Testoptionen für das Gerät ab.
`long`	`getPartitionFreeSpace(String partition)` Hilfsmethode zum Bestimmen des freien Speicherplatzes auf der Gerätepartition.
`Integer`	`getPrimaryUserId()` Gibt die primäre Nutzer-ID zurück.
`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.
`String`	`getProcessPid(String process)` Gibt die Prozess-ID des Dienstes zurück oder „null“, wenn ein Fehler aufgetreten ist.
`String`	`getProductType()` Eine praktische Methode, um den Produkttyp dieses Geräts zu ermitteln.
`String`	`getProductVariant()` Eine praktische Methode, um die Produktvariante dieses Geräts abzurufen.
`String`	`getProperty(String name)` Ruft den angegebenen Attributwert vom Gerät ab.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` Ruft den aktuellen Wiederherstellungsmodus ab, der für das Gerät verwendet wird.
`InputStreamSource`	`getScreenshot(long displayId)` Erfasst einen Screenshot vom Gerät mit der angegebenen Anzeige-ID.
`InputStreamSource`	`getScreenshot(String format)` Erstellt einen Screenshot auf dem Gerät.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` Erstellt einen Screenshot auf dem Gerät.
`InputStreamSource`	`getScreenshot()` Erstellt einen Screenshot auf dem Gerät.
`String`	`getSerialNumber()` Eine praktische Methode, um die Seriennummer dieses Geräts zu erhalten.
`String`	`getSetting(int userId, String namespace, String key)` Gibt den Wert der angeforderten Einstellung zurück.
`String`	`getSetting(String namespace, String key)` Siehe `getSetting(int, String, String)` und wird auf den Systemnutzer angewendet.
`String`	`getSimOperator()` Geben Sie den SIM-Kartenanbieter zurück oder „null“, wenn er nicht verfügbar ist oder das Gerät nicht verfügbar ist.
`String`	`getSimState()` Gib den Status der SIM-Karte zurück oder „null“, wenn sie nicht verfügbar ist oder das Gerät nicht verfügbar ist.
	`getTombstones()` Liste der Tombstones von den Geräten abrufen und zurückgeben.
`long`	`getTotalMemory()` Gibt die Gesamtgröße des physischen Arbeitsspeichers in Byte zurück oder -1 bei einem internen Fehler.
`String`	`getTrackingSerial()` Rufen Sie für die Geräteverwaltung die Seriennummer ab, die zum Nachverfolgen des Geräts verwendet wird.
	`getUninstallablePackageNames()` Rufen Sie die Namen der Anwendungspakete ab, die deinstalliert werden können.
`boolean`	`getUseFastbootErase()` Ermitteln Sie, ob Sie „fastboot erase“ oder „fastboot format“ verwenden müssen, um eine Partition auf dem Gerät zu löschen.
`int`	`getUserFlags(int userId)` Die Markierungen eines bestimmten Nutzers finden und zurückgeben.
	`getUserInfos()` Ruft die Zuordnung von „useId“ zu „`UserInfo`“ auf dem Gerät ab.
`int`	`getUserSerialNumber(int userId)` Gibt die Seriennummer zurück, die mit der userId verknüpft ist, falls gefunden, andernfalls -10000.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` Verarbeite das angegebene DeviceEvent. Verarbeite das DeviceEvent, wodurch dieses Gerät möglicherweise in einen neuen Zuweisungsstatus übergeht.
`boolean`	`hasFeature(String feature)` Prüfen, ob eine Funktion auf einem Gerät verfügbar ist
`String`	`installPackage(File packageFile, boolean reinstall, String... extraArgs)` Installieren Sie ein Android-Paket auf dem Gerät.
`String`	`installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)` Installieren Sie ein Android-Paket auf dem Gerät.
`String`	`installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)` Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer
`void`	`invalidatePropertyCache()`
`boolean`	`isAdbRoot()`
`boolean`	`isAdbTcp()`
`boolean`	`isAppEnumerationSupported()` Prüfen, ob die Plattform auf dem Gerät die App-Aufzählung unterstützt
`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
`boolean`	`isDebugfsMounted()` Prüfen Sie, ob debugfs bereitgestellt ist.
`boolean`	`isDeviceEncrypted()` Gibt an, ob das Gerät verschlüsselt ist.
`boolean`	`isDirectory(String path)` Gibt „True“ zurück, wenn der Pfad auf dem Gerät ein Verzeichnis ist, andernfalls „False“.
`boolean`	`isEnableAdbRoot()`
`boolean`	`isEncryptionSupported()` Gibt zurück, ob die Verschlüsselung auf dem Gerät unterstützt wird.
`boolean`	`isExecutable(String fullPath)` Gibt „True“ zurück, wenn der Dateipfad auf dem Gerät eine ausführbare Datei ist, andernfalls „False“.
`boolean`	`isFastbootEnabled()` Gehen Sie zurück, wenn Fastboot für das Gerät verfügbar ist.
`boolean`	`isHeadless()` Gibt „wahr“ zurück, wenn das Gerät headless (ohne Bildschirm) ist, andernfalls „falsch“.
`boolean`	`isHeadlessSystemUserMode()` Gibt zurück, ob das Gerät den headless-Nutzermodus des Systems verwendet.
`boolean`	`isMainUserPermanentAdmin()` Gibt an, ob der Hauptnutzer ein dauerhafter Administrator ist und nicht gelöscht oder auf den Status „Kein Administrator“ herabgestuft werden kann.
`boolean`	`isMultiUserSupported()` Bestimmt, ob die Nutzung durch mehrere Nutzer unterstützt wird.
`boolean`	`isPackageInstalled(String packageName, String userId)` Das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID abfragen, um zu prüfen, ob es für diesen Nutzer derzeit installiert ist oder nicht.
`boolean`	`isPackageInstalled(String packageName)` Das Gerät nach einem bestimmten Paketnamen abfragen, um zu prüfen, ob es derzeit installiert ist.
`boolean`	`isRuntimePermissionSupported()` Prüfen, ob die Plattform auf dem Gerät die Gewährung von Laufzeitberechtigungen unterstützt
`boolean`	`isStateBootloaderOrFastbootd()` Gibt „true“ zurück, wenn sich das Gerät in `TestDeviceState.FASTBOOT` oder `TestDeviceState.FASTBOOTD` befindet.
`boolean`	`isUserRunning(int userId)` Prüfen, ob ein bestimmter Nutzer aktiv ist
`boolean`	`isUserSecondary(int userId)` Gibt an, ob der angegebene Nutzer gemäß seinen Flags ein sekundärer Nutzer ist.
`boolean`	`isUserVisible(int userId)` Prüft, ob der angegebene Nutzer sichtbar ist.
`boolean`	`isUserVisibleOnDisplay(int userId, int displayId)` Prüft, ob der angegebene Nutzer im angegebenen Display sichtbar ist.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` Gibt an, ob Nutzer auf dem Gerät im `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)` im Hintergrund gestartet werden können.
`boolean`	`isVisibleBackgroundUsersSupported()` Gibt an, ob Nutzer auf dem Gerät im Hintergrund gestartet werden können.
`boolean`	`isWifiEnabled()` Prüfen Sie, ob das WLAN aktiviert ist.
	`listDisplayIds()` Erfassen Sie die Liste der verfügbaren Display-IDs auf dem Gerät, wie von „dumpsys SurfaceFlinger“ gemeldet.
	`listDisplayIdsForStartingVisibleBackgroundUsers()` Liste der Anzeigen, die für `start a user visible in the background` verwendet werden können.
	`listUsers()` Ruft die Liste der Nutzer auf dem Gerät ab.
`boolean`	`logAnrs(ITestLogger logger)` Erfasst und protokolliert ANRs auf dem Gerät.
`boolean`	`logBugreport(String dataName, ITestLogger listener)` Hilfsmethode, um einen Fehlerbericht zu erstellen und an die Meldenden zu senden.
`void`	`logOnDevice(String tag, Log.LogLevel level, String format, Object... args)` Eine Nachricht im Logcat des Geräts protokollieren
`void`	`mountDebugfs()` debugfs bereitstellen
`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.
`void`	`postAdbRootAction()` Überschreiben Sie diese Option, wenn nach dem Rooten mit adb bestimmte Aktionen auf dem Gerät ausgeführt werden müssen, bevor es wieder online ist.
`void`	`postAdbUnrootAction()` Überschreiben Sie diese Option, wenn nach dem Entfernen des Root-Zugriffs mit adb bestimmte Aktionen auf dem Gerät ausgeführt werden müssen, bevor es wieder online ist.
`void`	`postBootSetup()` Folgen Sie der Anleitung, um das Gerät für das Testen nach jedem Start zu konfigurieren.
`void`	`postInvocationTearDown(Throwable exception)` Zusätzliche Schritte für die erforderliche gerätespezifische Bereinigung, die nach dem Aufruf ausgeführt wird.
`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.
`boolean`	`pullDir(String deviceFilePath, File localDir, int userId)` Verzeichnisinhalte rekursiv vom Gerät abrufen
`boolean`	`pullDir(String deviceFilePath, File localDir)` Verzeichnisinhalte rekursiv vom Gerät abrufen
`boolean`	`pullFile(String remoteFilePath, File localFile)` Ruft eine Datei vom Gerät ab.
`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.
`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.
`boolean`	`pullFile(String remoteFilePath, File localFile, int userId)` Ruft eine Datei vom Gerät ab.
`String`	`pullFileContents(String remoteFilePath)` Ruft eine Datei vom Gerät ab und gibt den Inhalt zurück.
`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.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` Verzeichnisinhalte rekursiv auf das Gerät übertragen und dabei einige Verzeichnisse ausschließen, die gefiltert werden.
`boolean`	`pushDir(File localFileDir, String deviceFilePath)` Verzeichnisinhalte rekursiv auf das Gerät übertragen.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, int userId)` Verzeichnisinhalte rekursiv auf das Gerät übertragen.
`boolean`	`pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)` Variante von `pushFile(File, String)`, bei der optional die Notwendigkeit für den Inhaltsanbieter berücksichtigt werden kann.
`boolean`	`pushFile(File localFile, String remoteFilePath)` Dateien an das Gerät senden
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` Dateien an das Gerät senden
`boolean`	`pushString(String contents, String remoteFilePath)` Aus einem String erstellte Datei an das Gerät senden
`void`	`reboot(String reason)` Startet das Gerät im ADB-Modus mit der angegebenen `reason` neu, die nach dem Neustart beibehalten werden soll.
`void`	`reboot()` Startet das Gerät im ADB-Modus neu.
`void`	`rebootIntoBootloader()` Das Gerät wird im Bootloader-Modus neu gestartet.
`void`	`rebootIntoFastbootd()` Startet das Gerät im Fastbootd-Modus neu.
`void`	`rebootIntoRecovery()` Das Gerät wird im ADB-Wiederherstellungsmodus neu gestartet.
`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
`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
`void`	`rebootUntilOnline()` Eine Alternative zu `reboot()`, die nur blockiert, bis das Gerät online ist, also für adb sichtbar ist.
`void`	`rebootUntilOnline(String reason)` Eine Alternative zu `reboot()`, die nur blockiert, bis das Gerät online ist, also für adb sichtbar ist.
`void`	`rebootUserspace()` Startet nur den Nutzerbereich des Geräts neu.
`void`	`rebootUserspaceUntilOnline()` Eine Alternative zu `rebootUserspace()` ()}, die nur blockiert, bis das Gerät online ist, d. h. für adb sichtbar ist.
`boolean`	`recoverDevice()` Es wird versucht, die Gerätekommunikation wiederherzustellen.
`void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Registriert eine `IDeviceActionReceiver` für dieses Gerät.
`void`	`remountSystemReadOnly()` Die Systempartition auf dem Gerät schreibgeschützt machen.
`void`	`remountSystemWritable()` Machen Sie die Systempartition auf dem Gerät beschreibbar.
`void`	`remountVendorReadOnly()` Die Anbieterpartition auf dem Gerät schreibgeschützt machen.
`void`	`remountVendorWritable()` Machen Sie die Anbieterpartition auf dem Gerät beschreibbar.
`boolean`	`removeAdmin(String componentName, int userId)` Entfernt den angegebenen Geräteadministrator beim angegebenen Nutzer und gibt `true` zurück, wenn der Vorgang erfolgreich war, andernfalls `false`.
`void`	`removeOwners()` Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen nach Möglichkeit.
`boolean`	`removeUser(int userId)` Einen bestimmten Nutzer vom Gerät entfernen.
`void`	`resetContentProviderSetup()` Setze das Flag für die Einrichtung des Inhaltsanbieters zurück, um die Einrichtung noch einmal auszulösen.
`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.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` Führt Instrumentierungstests aus und bietet die Gerätewiederherstellung.
`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.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)` Entspricht `ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...)`, führt den Test jedoch für einen bestimmten Nutzer aus.
`void`	`setConfiguration(IConfiguration configuration)` Fügt den verwendeten `IConfiguration` ein.
`final void`	`setConnectionAvdInfo(GceAvdInfo avdInfo)`
`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.
`boolean`	`setDeviceOwner(String componentName, int userId)` Eine Geräteadministratorkomponente als Geräteinhaber für den angegebenen Nutzer festlegen
`void`	`setDeviceState(TestDeviceState deviceState)` Aktualisieren Sie den Status des Geräts.
`void`	`setEmulatorOutputStream(SizeLimitedOutputStream output)` Für den Emulator `SizeLimitedOutputStream` auf „Logausgabe“ festlegen
`void`	`setEmulatorProcess(Process p)` Legt den `Process` fest, wenn es sich bei diesem Gerät um einen Emulator handelt.
`void`	`setFastbootEnabled(boolean fastbootEnabled)` Legen Sie die Fastboot-Option für das Gerät fest.
`void`	`setFastbootPath(String fastbootPath)` Legt den Pfad zum zu verwendenden Fastboot-Binärprogramm fest.
`void`	`setIDevice(IDevice newDevice)` Aktualisieren Sie das mit diesem ITestDevice verknüpfte IDevice.
`void`	`setLogStartDelay(int delay)` Legt die Zeit in Millisekunden fest, die gewartet werden soll, bevor die Logcat-Aufzeichnung für ein online verfügbares Gerät gestartet wird.
`void`	`setOptions(TestDeviceOptions options)` `TestDeviceOptions` für das Gerät festlegen
`boolean`	`setProperty(String propKey, String propValue)` Legt den angegebenen Property-Wert auf dem Gerät fest.
`void`	`setRecovery(IDeviceRecovery recovery)` Legen Sie die `IDeviceRecovery` fest, die für dieses Gerät verwendet werden soll.
`void`	`setRecoveryMode(ITestDevice.RecoveryMode mode)` Legen Sie den aktuellen Wiederherstellungsmodus für das Gerät fest.
`void`	`setSetting(String namespace, String key, String value)` Siehe `setSetting(int, String, String, String)` und wird auf den Systemnutzer angewendet.
`void`	`setSetting(int userId, String namespace, String key, String value)` Dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzufügen.
`void`	`setTestLogger(ITestLogger testLogger)` `ITestLogger`-Instanz einschleust
`void`	`setTrackingSerial(String trackingSerial)` Verfolgen Sie für die Geräteverwaltung die Seriennummer, die wir für die Referenzierung des Geräts verwenden.
`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.
`void`	`startLogcat()` Starten Sie die Erfassung der Logcat-Ausgabe vom Gerät im Hintergrund.
`boolean`	`startTradeInModeTesting(int timeoutMs)` Testen des Trade-In-Modus aktivieren
`boolean`	`startUser(int userId)` Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist.
`boolean`	`startUser(int userId, boolean waitFlag)` Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist.
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` Startet einen bestimmten Nutzer im Hintergrund, der auf dem entsprechenden Display sichtbar ist (d.h., der Nutzer kann Aktivitäten auf diesem Display starten).
`void`	`stopEmulatorOutput()` Schließen und löschen Sie die Emulatorausgabe.
`void`	`stopLogcat()` Die Erfassung der Logcat-Ausgabe vom Gerät wird beendet und die derzeit gespeicherten Logcat-Daten werden verworfen.
`void`	`stopTradeInModeTesting()` Testen des Trade-In-Modus beenden.
`boolean`	`stopUser(int userId)` Stoppt einen bestimmten Nutzer.
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` Einen bestimmten Nutzer anhalten.
`String`	`switchToAdbTcp()` Stellen Sie das Gerät auf den adb-over-tcp-Modus um.
`boolean`	`switchToAdbUsb()` Stellen Sie das Gerät auf den Modus „adb over USB“ um.
`boolean`	`switchUser(int userId)` Wechseln Sie zu einer anderen userId mit einer Standardzeitüberschreitung.
`boolean`	`switchUser(int userId, long timeout)` Wechseln Sie zu einer anderen Nutzer-ID mit dem angegebenen Zeitlimit als Frist.
`boolean`	`syncFiles(File localFileDir, String deviceFilePath)` Synchronisiert den Inhalt eines lokalen Dateiverzeichnisses mit dem Gerät.
`Bugreport`	`takeBugreport()` Nimmt einen Fehlerbericht entgegen und gibt ihn in einem `Bugreport`-Objekt zurück, um ihn zu verarbeiten.
`String`	`uninstallPackage(String packageName)` Deinstallation eines Android-Pakets vom Gerät
`String`	`uninstallPackageForUser(String packageName, int userId)` Deinstallation eines Android-Pakets von einem Gerät für einen bestimmten Nutzer
`boolean`	`unlockDevice()` Entsperret das Gerät, wenn es verschlüsselt ist.
`void`	`unmountDebugfs()` Entfernen Sie die Bereitstellung von debugfs.
`boolean`	`waitForBootComplete(long timeOut)` Blockiert, bis das Flag „Boot complete“ des Geräts gesetzt ist.
`boolean`	`waitForDeviceAvailable()` Wartet, bis das Gerät reagiert und für den Test verfügbar ist.
`boolean`	`waitForDeviceAvailable(long waitTime)` Wartet, bis das Gerät reagiert und für den Test verfügbar ist.
`boolean`	`waitForDeviceAvailableInRecoverPath(long waitTime)` Wartet, bis das Gerät reagiert und verfügbar ist, ohne den Wiederherstellungspfad zu berücksichtigen.
`void`	`waitForDeviceBootloader()` Blockiert, bis das Gerät über Fastboot sichtbar ist.
`boolean`	`waitForDeviceInRecovery(long waitTime)` Verhindert, dass sich das Gerät im Status „adb recovery“ befindet (dies ist nicht dasselbe wie `IDeviceRecovery`).
`boolean`	`waitForDeviceInSideload(long waitTime)` Verhindert, dass sich das Gerät im Status „adb sideload“ befindet
`boolean`	`waitForDeviceNotAvailable(long waitTime)` Blockiert, dass das Gerät nicht verfügbar ist, d. h. nicht in adb vorhanden ist
`void`	`waitForDeviceOnline()` Blockiert, bis das Gerät über adb sichtbar ist.
`void`	`waitForDeviceOnline(long waitTime)` Blockiert, bis das Gerät über adb sichtbar ist.
`boolean`	`waitForDeviceShell(long waitTime)` Wartet, bis das Gerät auf einen einfachen adb-Shell-Befehl reagiert.

Geschützte Methoden
`void`	`addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)`
`String[]`	`buildAdbShellCommand(String command, boolean forceExitStatusDetection)` Erstellt den Betriebssystembefehl für die angegebene adb-Shell-Befehlssitzung und die Argumente.
`void`	`checkApiLevelAgainst(String feature, int strictMinLevel)`
`NativeDevice.RebootDeviceAction`	`createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)` Erstellen Sie eine `RebootDeviceAction`, die beim Ausführen einer Neustartaktion verwendet werden soll.
`IRunUtil`	`createRunUtil()`
`void`	`doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)` Führen Sie einen ADB-Neustart durch.
`void`	`ensureRuntimePermissionSupported()` Hilfsmethode, um eine Ausnahme zu werfen, wenn die Laufzeitberechtigung nicht unterstützt wird
`int`	`getApiLevelSafe()`
`ITestLogger`	`getLogger()`
`IRunUtil`	`getRunUtil()` Rufen Sie die zu verwendende `RunUtil`-Instanz ab.
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)`
`String`	`internalGetProperty(String propName, String fastbootVar, String description)` Eine Geräteeigenschaft wird standardmäßig aus dem ddmlib-Cache abgerufen. Je nachdem, ob sich das Gerät im Fastboot-Modus befindet, wird entweder „adb shell getprop“ oder „fastboot getvar“ verwendet.
`boolean`	`isInRebootCallback()` Gibt an, ob Reboot-Callbacks derzeit ausgeführt werden.
`boolean`	`isNewer(File localFile, IFileEntry entry)` Gibt `true` zurück, wenn die lokale Datei neuer ist als die Remotedatei.
`void`	`notifyRebootEnded()` Alle `IDeviceActionReceiver` werden über das Ereignis „Neustartendendung“ benachrichtigt.
`void`	`notifyRebootStarted()` Alle `IDeviceActionReceiver` werden über das Ereignis „Neustart gestartet“ benachrichtigt.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` Führt eine Aktion auf diesem Gerät aus.
`void`	`postAdbReboot()` Mögliche zusätzliche Aktionen, die nach einem Neustart ausgeführt werden können.
`void`	`prePostBootSetup()` Ermöglicht es jedem Gerätetyp (AndroidNativeDevice, TestDevice), diese Methode für die spezifische Einrichtung nach dem Start zu überschreiben.
`boolean`	`pullFileInternal(String remoteFilePath, File localFile)`
`void`	`setClock(Clock clock)` Legen Sie die zu verwendende Uhren-Instanz fest.
`void`	`setMicrodroidProcess(Process process)` Kennzeichnet das Testgerät als Microdroid und legt seine CID fest.
`void`	`setTestDeviceOptions( deviceOptions)`
`CommandResult`	`simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd)` Führt einen einfachen Fastboot-Befehl mit Umgebungsvariablen aus und meldet den Status des Befehls.
`CommandResult`	`simpleFastbootCommand(long timeout, String[] fullCmd)` Führt einen einfachen Fastboot-Befehl aus und meldet den Status des Befehls.
`boolean`	`waitForDeviceNotAvailable(String operationDesc, long time)` Warten Sie, bis das Gerät nicht mehr verfügbar ist (keine Berichte mehr an adb).

Konstanten

INVALID_USER_ID

public static final int INVALID_USER_ID

Wert, der für eine ungültige/nicht gefundene Nutzer-ID zurückgegeben wird: UserHandle hat den Wert -10000 definiert

Konstanter Wert: −10.000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

Konstanter Wert: 5.000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

die Standardanzahl der Wiederholungsversuche für Befehle

Konstanter Wert: 2 (0x00000002)

Felder

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SD_CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Öffentliche Konstruktoren

NativeDevice

public NativeDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

Erstellt einen TestDevice.

Parameter
`device`	`IDevice`: die zugehörige `IDevice`
`stateMonitor`	`IDeviceStateMonitor`: Der zu verwendende `IDeviceStateMonitor`-Mechanismus
`allocationMonitor`	`IDeviceMonitor`: die `IDeviceMonitor`, um über Änderungen des Zuweisungsstatus zu informieren. Kann null sein

Öffentliche Methoden

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Mikrooptimierung (ca. 400 Millisekunden) durch Vorab-Abrufen aller benötigten Props, anstatt für jede einzelne „adb getprop“ aufzurufen. Das Abrufen aller Properties ist also genauso schnell wie das Abrufen einer einzelnen Property. Funktionen wie device.getApiLevel(), checkApiLevelAgainstNextRelease und getBuildAlias rufen unter der Haube „adb getprop“ auf. Wir holen sie in einem Aufruf ab und rufen NativeDevice.setProperty auf. Auch wenn wir dies nicht tun, ruft NativeDevice selbst setProperty auf und speichert das Ergebnis für zukünftige Aufrufe im Cache. Wir tun es nur etwas früher. Wenn sich das Gerät im Wiederherstellungsmodus befindet oder es andere Fehler beim Abrufen der Props gibt, werden sie einfach ignoriert.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Gibt an, ob der Wechsel zum headless SYSTEM-Nutzer zulässig ist.

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public 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
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity ()

Prüfen Sie, ob das Gerät eine Netzwerkverbindung hat.

Returns
`boolean`	`true`, wenn das Gerät eine funktionierende Netzwerkverbindung hat, `false` andernfalls.

Ausgabe
`DeviceNotAvailableException`

clearErrorDialogs

public boolean clearErrorDialogs ()

Schließen Sie alle Fehlerdialogfelder, die derzeit auf der Geräteoberfläche angezeigt werden.

Returns
`boolean`	`true`, wenn keine Dialogfelder vorhanden waren oder die Dialogfelder erfolgreich gelöscht wurden. Andernfalls `false`.

Ausgabe
`DeviceNotAvailableException`

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

Das zuletzt verbundene WLAN wird gelöscht. Diese Funktion sollte beim Starten einer neuen Aufrufinstanz aufgerufen werden, um zu verhindern, dass nach dem Neustart des Geräts eine Verbindung zum WLAN hergestellt wird, das im vorherigen Test verwendet wurde.

clearLogcat

public 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).

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Stellt eine Verbindung zu einem WLAN her.

Aktiviert das WLAN und blockiert es, bis eine Verbindung zu einem der WLANs hergestellt wurde, die in der Zuordnungstabelle „wifiSsidToPsk“ angegeben sind. Sobald eine Verbindung hergestellt wurde, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice.disconnectFromWifi() oder ITestDevice.clearLastConnectedWifiNetwork() aufgerufen wird.

Parameter
`wifiSsidToPsk`	: Eine Zuordnung von WLAN-SSIDs zu Passwörtern.
`scanSsid`	`boolean`: Gibt an, ob nach ausgeblendeten SSIDs für dieses Netzwerk gesucht werden soll.

Returns
`boolean`	`true`, wenn eine Verbindung zum WLAN hergestellt wurde. `false` otherwise

Ausgabe
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Stellt eine Verbindung zu einem WLAN her.

Aktiviert das WLAN und blockiert es, bis eine Verbindung zum angegebenen WLAN hergestellt wurde. Sobald eine Verbindung hergestellt wurde, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice.disconnectFromWifi() oder ITestDevice.clearLastConnectedWifiNetwork() aufgerufen wird.

Parameter
`wifiSsid`	`String`: Die WLAN-SSID, mit der eine Verbindung hergestellt werden soll
`wifiPsk`	`String`: PSK-Passphrase oder „null“, wenn nicht verschlüsselt

Returns
`boolean`	`true`, wenn eine Verbindung zum WLAN hergestellt wurde. `false` andernfalls

Ausgabe
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Stellt eine Verbindung zu einem WLAN her.

Parameter
`wifiSsidToPsk`	: Eine Zuordnung von WLAN-SSIDs zu Passwörtern.

Returns
`boolean`	`true`, wenn eine Verbindung zum WLAN hergestellt wurde. `false` otherwise

Ausgabe
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Stellt eine Verbindung zu einem WLAN her.

Parameter
`wifiSsid`	`String`: Die WLAN-SSID, mit der eine Verbindung hergestellt werden soll
`wifiPsk`	`String`: PSK-Passphrase oder „null“, wenn nicht verschlüsselt
`scanSsid`	`boolean`: Gibt an, ob nach ausgeblendeten SSIDs für dieses Netzwerk gesucht werden soll.

Returns
`boolean`	`true`, wenn eine Verbindung zum WLAN hergestellt wurde. `false` andernfalls

Ausgabe
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Eine Variante von connectToWifiNetwork(String, String), die nur dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.

Parameter
`scanSsid`	`boolean`: Ob nach ausgeblendeten SSIDs für dieses Netzwerk gesucht werden soll

Returns
`boolean`	`true`, wenn eine Verbindung zum WLAN hergestellt wurde. `false` andernfalls

Ausgabe
`DeviceNotAvailableException`

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Eine Variante von connectToWifiNetwork(String, String), die nur dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.

Returns
`boolean`	`true`, wenn eine Verbindung zum WLAN hergestellt wurde. `false` andernfalls

Ausgabe
`DeviceNotAvailableException`

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

Parameter
`name`	`String`: des Nutzers, der auf dem Gerät erstellt werden soll
`guest`	`boolean`: Aktivieren Sie beim Erstellen das Nutzerflag „--guest“.
`ephemeral`	`boolean`: Aktivieren Sie beim Erstellen das Nutzerflag „--ephemeral“.

Returns
`int`	ID des erstellten Nutzers

Ausgabe
`DeviceNotAvailableException`

createUser

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral, 
                boolean forTesting)

Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

Parameter
`name`	`String`: des Nutzers, der auf dem Gerät erstellt werden soll
`guest`	`boolean`: Aktivieren Sie beim Erstellen das Nutzerflag „--guest“.
`ephemeral`	`boolean`: Aktivieren Sie beim Erstellen das Nutzerflag „--ephemeral“.
`forTesting`	`boolean`: Aktivieren Sie beim Erstellen das Testflag „--for-testing“.

Returns
`int`	ID des erstellten Nutzers

Ausgabe
`DeviceNotAvailableException`

createUser

public int createUser (String name)

Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.

Parameter
`name`	`String`: des Nutzers, der auf dem Gerät erstellt werden soll

Returns
`int`	die Ganzzahl für die erstellte Nutzer-ID

Ausgabe
`DeviceNotAvailableException`

createUserNoThrow

public int createUserNoThrow (String name)

Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.

Parameter
`name`	`String`: des Nutzers, der auf dem Gerät erstellt werden soll

Returns
`int`	Die Ganzzahl für die erstellte User-ID oder -1 für einen Fehler.

Ausgabe
`DeviceNotAvailableException`

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

Prüfen Sie ein Gerät und geben Sie detaillierte Informationen zurück, wenn ein Gerät nicht verfügbar ist.

Returns
`DeviceInspectionResult`

deleteFile

public 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
`DeviceNotAvailableException`

deleteFile

public 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
`DeviceNotAvailableException`

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Entfernt die registrierte IDeviceActionReceiver.

Parameter
`deviceActionReceiver`	`IDeviceActionReceiver`: Ein `IDeviceActionReceiver`, das entfernt wird.

deviceSoftRestarted

public 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
`DeviceNotAvailableException`

deviceSoftRestartedSince

public 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
`DeviceNotAvailableException`

disableAdbRoot

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

disableKeyguard

public void disableKeyguard ()

Es wird versucht, den Keyguard zu deaktivieren.

Warten Sie zuerst, bis die Eingabeweiterleitung bereit ist. Das geschieht ungefähr zur selben Zeit, wenn das Gerät BOOT_COMPLETE meldet, anscheinend asynchron, da die aktuelle Framework-Implementierung gelegentlich zu einer Race-Condition führt. Dann wird der Befehl gesendet, um den Sperrbildschirm zu schließen (funktioniert nur bei nicht sicheren Sperrbildschirmen).

Ausgabe
`DeviceNotAvailableException`

disableNetworkMonitor

public boolean disableNetworkMonitor ()

Deaktiviert die Netzwerküberwachung auf dem Gerät.

Returns
`boolean`	`true`, wenn das Monitoring erfolgreich deaktiviert wurde. `false` , wenn der Vorgang fehlgeschlagen ist.

Ausgabe
`DeviceNotAvailableException`

disconnectFromWifi

public boolean disconnectFromWifi ()

Trennen Sie die Verbindung zu einem WLAN.

Entfernt alle Netzwerke aus der Liste der bekannten Netzwerke und deaktiviert das WLAN.

Returns
`boolean`	`true`, wenn die Verbindung zum WLAN getrennt wurde. `false` if disconnect failed.

Ausgabe
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Hilfsmethode, um zu ermitteln, ob eine Datei auf dem Gerät für einen bestimmten Nutzer vorhanden ist.

Parameter
`deviceFilePath`	`String`: Der absolute Pfad der Datei auf dem Gerät, die geprüft werden soll.
`userId`	`int`: Die Nutzer-ID, anhand derer die Datei geprüft werden soll

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

Ausgabe
`DeviceNotAvailableException`

doesFileExist

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

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Versuchen Sie, den Heap aus dem system_server zu dumpen. Der Aufrufer ist für die Bereinigung der Dumpdatei verantwortlich.

Parameter
`process`	`String`: Der Name des Geräteprozesses, auf dem der Dumpheap erstellt werden soll.
`devicePath`	`String`: Der Pfad auf dem Gerät, unter dem der Dump gespeichert werden soll. Dies muss ein Ort sein, an dem dies gemäß den Berechtigungen zulässig ist.

Returns
`File`	den `ERROR(/File)`, der den Bericht enthält. Null, wenn ein Fehler aufgetreten ist.

Ausgabe
`DeviceNotAvailableException`

enableAdbRoot

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

enableNetworkMonitor

public boolean enableNetworkMonitor ()

Aktiviert die Netzwerküberwachung auf dem Gerät.

Returns
`boolean`	`true`, wenn das Monitoring erfolgreich aktiviert wurde. `false` , wenn der Vorgang fehlgeschlagen ist.

Ausgabe
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (long timeout, 
                String... cmdArgs)

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

executeAdbCommand

public String executeAdbCommand (long timeout, 
                 envMap, 
                String... cmdArgs)

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

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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
`cmdArgs`	`String`: der Fastboot-Befehl und die zugehörigen Argumente

Returns
`CommandResult`	„CommandResult“ mit der Befehlsausgabe

Ausgabe
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (long timeout, 
                String... cmdArgs)

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
`cmdArgs`	`String`: der Fastboot-Befehl und die zugehörigen Argumente

Returns
`CommandResult`	„CommandResult“ mit der Befehlsausgabe

Ausgabe
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

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

Returns
`CommandResult`	„CommandResult“ mit der Befehlsausgabe

Ausgabe
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand ( envVarMap, 
                String... cmdArgs)

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
`cmdArgs`	`String`: der Fastboot-Befehl und die zugehörigen Argumente

Returns
`CommandResult`	„CommandResult“ mit der Befehlsausgabe

Ausgabe
`DeviceNotAvailableException`

executeShellCommand

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

executeShellCommand

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

executeShellCommand

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

executeShellCommand

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

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

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
`cmd`	`String`: Der Befehl, der ausgeführt werden soll.

Returns
`CommandResult`	Das Ergebnis in `CommandResult`.

Ausgabe
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                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
`cmd`	`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`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                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
`cmd`	`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`

executeShellV2Command

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

Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.

Parameter
`cmd`	`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`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                long maxTimeoutForCommand, 
                TimeUnit timeUnit)

Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.

Parameter
`cmd`	`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`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                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
`cmd`	`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`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                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
`cmd`	`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`

fastbootWipePartition

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

getActiveApexes

public  getActiveApexes ()

Ruft die Informationen zu den auf dem Gerät aktivierten APEX-Objekten ab.

Returns
	`ERROR(/Set)` von `ApexInfo` derzeit auf dem Gerät aktiviert

Ausgabe
`DeviceNotAvailableException`

getAllSettings

public  getAllSettings (String namespace)

Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück.

Parameter
`namespace`	`String`: Muss eine der folgenden Optionen sein: {"system", "secure", "global"}

Returns
	die Zuordnung von Schlüssel/Wert-Paaren. Null, wenn der Namespace nicht unterstützt wird.

Ausgabe
`DeviceNotAvailableException`

getAllocationState

public DeviceAllocationState getAllocationState ()

Gibt den aktuellen Zuweisungsstatus des Geräts zurück

Returns
`DeviceAllocationState`

getAndroidId

public String getAndroidId (int userId)

Die mit einer Nutzer-ID verknüpfte Android-ID suchen und zurückgeben. Wenn sie nicht gefunden wird, wird „null“ zurückgegeben.

Parameter
`userId`	`int`

Returns
`String`

Ausgabe
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

Erstellen Sie eine Zuordnungstabelle mit den gefundenen Android-IDs und den zugehörigen User-IDs. Es kann nicht garantiert werden, dass für jede User-ID eine Android-ID gefunden wird, die mit dieser Funktion verknüpft ist. Daher kann es sein, dass einige User-IDs mit „null“ übereinstimmen.

Returns
	Zuordnung von Android-IDs zu Nutzer-IDs.

Ausgabe
`DeviceNotAvailableException`

getApiLevel

public 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
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Ruft Informationen zu einem auf dem Gerät installierten Paket ab.

Parameter
`packageName`	`String`

Returns
`PackageInfo`	`PackageInfo` oder `null`, wenn keine Informationen abgerufen werden konnten

Ausgabe
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

Ruft Informationen zu auf dem Gerät installierten Paketen ab.

Returns
	`ERROR(/List)` von `PackageInfo` auf dem Gerät installiert.

Ausgabe
`DeviceNotAvailableException`

getBasebandVersion

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

getBattery

public Integer getBattery ()

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

Returns
`Integer`

getBooleanProperty

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

getBugreport

public InputStreamSource getBugreport ()

Ruft einen Fehlerbericht vom Gerät ab.

Die Implementierung funktioniert garantiert auch auf einem Gerät ohne SD-Karte oder wenn die SD-Karte noch nicht bereitgestellt wurde.

Returns
`InputStreamSource`	Eine `InputStreamSource`, die den Inhalt des Fehlerberichts auf Anfrage generiert. Bei einem Fehler wird durch die `InputStreamSource` eine leere `ERROR(/InputStream)` zurückgegeben.

getBugreportz

public InputStreamSource getBugreportz ()

Ruft einen Fehlerbericht vom Gerät ab. Der Fehlerbericht im ZIP-Format enthält den Hauptfehlerbericht und andere Protokolldateien, die für die Fehlerbehebung hilfreich sind.

Nur für „adb version“ > 1.0.36 unterstützt

Returns
`InputStreamSource`	eine `InputStreamSource` der ZIP-Datei mit dem Fehlerbericht zurückgeben, andernfalls „null“.

getBuildAlias

public 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
`DeviceNotAvailableException`

getBuildFlavor

public 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
`DeviceNotAvailableException`

getBuildId

public 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
`DeviceNotAvailableException`

getBuildSigningKeys

public 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
`DeviceNotAvailableException`

getCachedDeviceDescriptor

public 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 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 String[] getChildren (String path)

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

Parameter
`path`	`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
`DeviceNotAvailableException`

getConnection

public AbstractConnection getConnection ()

Die aktuelle Verbindung, die mit dem Gerät verknüpft ist.

Returns
`AbstractConnection`

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

Gibt ContentProviderHandler zurück oder NULL, wenn der Wert nicht verfügbar ist.

Der Contentanbieter kann wiederverwendet werden, wenn er zuvor mit derselben userId erstellt wurde.

Parameter
`userId`	`int`: die Nutzer-ID, mit der der Inhaltsanbieter initialisiert werden soll.

Returns
`ContentProviderHandler`

Ausgabe
`DeviceNotAvailableException`

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Gibt den aktuellen Faltstatus des Geräts zurück oder „null“, wenn Probleme aufgetreten sind.

Returns
`DeviceFoldableState`

Ausgabe
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

Gibt die ID des aktuell laufenden Nutzers zurück. Bei einem Fehler -10.000 zurückgeben.

Returns
`int`

Ausgabe
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

Geräteklasse abrufen

Returns
`String`	der Geräteklasse `String`.

getDeviceDate

public 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
`DeviceNotAvailableException`

getDeviceDescriptor

public 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 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 TestDeviceState getDeviceState ()

Rufe den Status des Geräts ab.

Returns
`TestDeviceState`

getDeviceTimeOffset

public 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 InputStreamSource getEmulatorOutput ()

Stream von stdout und stderr des Emulators abrufen

Returns
`InputStreamSource`	Emulatorausgabe

getEmulatorProcess

public Process getEmulatorProcess ()

Gibt die Process zurück, die diesem Emulator entspricht.

Returns
`Process`	die `Process` oder `null`

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

Das Protokoll, das alle executeShellCommand(String)-Protokolle enthält.

Returns
`File`

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

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

Returns
`long`	den freien Speicherplatz in KB

Ausgabe
`DeviceNotAvailableException`

getFastbootPath

public String getFastbootPath ()

Gibt den Pfad der verwendeten Fastboot-Binärdatei zurück. Damit Fastboot-Funktionen aktiviert werden können, muss isFastbootEnabled() weiterhin „wahr“ sein.

Returns
`String`

getFastbootProductType

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

getFastbootProductVariant

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

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Gibt die Seriennummer des Fastboot-Modus zurück.

Returns
`String`

getFastbootVariable

public 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
`DeviceNotAvailableException`

getFastbootVersion

public String getFastbootVersion ()

Gibt den Versionsstring der verwendeten Fastboot-Binärdatei zurück. Andernfalls wird „null“ zurückgegeben.

Returns
`String`

getFileEntry

public 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
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Inoffizieller Helfer zum Abrufen einer FileEntry von einem nicht übergeordneten Pfad. FIXME: FileEntry-System so umstrukturieren, dass es von jedem Pfad aus verfügbar ist. (auch nicht als Root-Benutzer).

Parameter
`entry`	`FileListingService.FileEntry`: Ein `FileEntry`, das nicht unbedingt der Root sein muss, wie es Ddmlib erfordert.

Returns
`IFileEntry`	einen FileEntryWrapper, der den FileEntry darstellt.

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

getFoldableStates

public  getFoldableStates ()

Gibt die Liste der Zustände des faltbaren Geräts zurück. Kann mit „cmd device_state print-states“ abgerufen werden.

Returns

Ausgabe
`DeviceNotAvailableException`

getIDevice

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

getInstalledPackageNames

public  getInstalledPackageNames ()

Ruft die Namen der Anwendungspakete auf dem Gerät ab.

Returns
	`ERROR(/Set)` von `String` Paketnamen, die derzeit auf dem Gerät installiert sind.

Ausgabe
`DeviceNotAvailableException`

getIntProperty

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

getIpAddress

public String getIpAddress ()

Ruft die IP-Adresse des Geräts ab.

Returns
`String`	die IP-Adresse des Geräts oder `null`, wenn das Gerät keine IP-Adresse hat

Ausgabe
`DeviceNotAvailableException`

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Gib ein Objekt zurück, um den aktuellen Status des Sperrbildschirms abzurufen, oder „null“, wenn er nicht unterstützt wird.

Returns
`KeyguardControllerState`	eine `KeyguardControllerState` mit einem Snapshot des Status des Sperrbildschirms und gibt „Null“ zurück, wenn die Sperrbildschirmabfrage nicht unterstützt wird.

Ausgabe
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public 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 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
`DeviceNotAvailableException`

getLogcat

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

getMacAddress

public String getMacAddress ()

Gibt die MAC-Adresse des Geräts zurück. Wenn die Abfrage fehlschlägt, wird „null“ zurückgegeben.

Returns
`String`

getMainUserId

public Integer getMainUserId ()

Gibt die Hauptnutzer-ID zurück.

Returns
`Integer`	die userId des Hauptnutzers, falls vorhanden, andernfalls „null“.

Ausgabe
`DeviceNotAvailableException`

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Informationen zu den auf dem Gerät installierten Mainline-Modulen abrufen

Returns
	`ERROR(/Set)` von `String` Mainline-Modulen, die derzeit auf dem Gerät installiert sind.

Ausgabe
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

Die maximale Anzahl der gleichzeitig unterstützten Nutzer abrufen Die Standardeinstellung ist 0.

Returns
`int`	eine Ganzzahl, die die Anzahl der gleichzeitig ausgeführten Nutzer angibt

Ausgabe
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

Maximal unterstützte Nutzerzahl abrufen Die Standardeinstellung ist 0.

Returns
`int`	eine Ganzzahl, die die Anzahl der unterstützten Nutzer angibt

Ausgabe
`DeviceNotAvailableException`

getMicrodroidProcess

public Process getMicrodroidProcess ()

Returns
`Process`	Gibt den Prozess der Microdroid-VM zurück. Wenn TestDevice kein Microdroid ist, wird „null“ zurückgegeben.

getMonitor

public IDeviceStateMonitor getMonitor ()

Gibt den mit dem Gerät verknüpften IDeviceStateMonitor zurück.

Returns
`IDeviceStateMonitor`

getMountPoint

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

getMountPointInfo

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

getMountPointInfo

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

getOptions

public TestDeviceOptions getOptions ()

Rufen Sie die Testoptionen für das Gerät ab.

Returns
`TestDeviceOptions`	`TestDeviceOptions` zum Testgerät.

getPartitionFreeSpace

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

getPrimaryUserId

public Integer getPrimaryUserId ()

Gibt die primäre Nutzer-ID zurück.

Returns
`Integer`	die userId des Hauptnutzers, falls vorhanden, andernfalls „null“.

Ausgabe
`DeviceNotAvailableException`

getProcessByName

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

getProductVariant

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

getProperty

public 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
`DeviceNotAvailableException`

getRecoveryMode

public 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.

getScreenshot

public InputStreamSource getScreenshot (long displayId)

Erfasst einen Screenshot vom Gerät mit der angegebenen Anzeige-ID. Das Format ist PNG.

TODO: Extend the implementations above to support 'format' and 'rescale'

Parameter
`displayId`	`long`: Die Display-ID des Bildschirms, von dem ein Screenshot erstellt werden soll.

Returns
`InputStreamSource`	einen `InputStreamSource` des Screenshots im Format oder `null`, wenn der Screenshot nicht erfolgreich war.

Ausgabe
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

Erstellt einen Screenshot auf dem Gerät. Stattdessen wird empfohlen, getScreenshot(format) mit JPEG-Codierung zu verwenden, um eine kleinere Dateigröße zu erzielen.

Parameter
`format`	`String`: unterstützt PNG, JPEG

Returns
`InputStreamSource`	einen `InputStreamSource` des Screenshots im Format oder `null`, wenn der Screenshot nicht erfolgreich war.

Ausgabe
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Erstellt einen Screenshot auf dem Gerät. Wir empfehlen, stattdessen getScreenshot(String) mit JPEG-Codierung zu verwenden, um die Größe zu verringern.

Parameter
`format`	`String`: unterstützt PNG, JPEG
`rescale`	`boolean`: Gibt an, ob der Screenshot neu skaliert werden soll, um die Größe des resultierenden Bildes zu verringern.

Returns
`InputStreamSource`	einen `InputStreamSource` des Screenshots im Format oder `null`, wenn der Screenshot nicht erfolgreich war.

Ausgabe
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

Erstellt einen Screenshot auf dem Gerät.

Returns
`InputStreamSource`	einen `InputStreamSource` des Screenshots im PNG-Format oder `null`, wenn der Screenshot nicht erfolgreich war.

Ausgabe
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

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

Returns
`String`	die Seriennummer `String`

getSetting

public String getSetting (int userId, 
                String namespace, 
                String key)

Gibt den Wert der angeforderten Einstellung zurück. namespace muss eine der folgenden Optionen sein: {"system", "secure", "global"}

Parameter
`userId`	`int`
`namespace`	`String`
`key`	`String`

Returns
`String`	Der Wert, der mit dem namespace:key eines Nutzers verknüpft ist. Null, wenn nicht gefunden.

Ausgabe
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

Siehe getSetting(int, String, String) und wird auf den Systemnutzer angewendet.

Parameter
`namespace`	`String`
`key`	`String`

Returns
`String`

Ausgabe
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

Geben Sie den SIM-Kartenanbieter zurück oder „null“, wenn er nicht verfügbar ist oder das Gerät nicht verfügbar ist.

Returns
`String`

getSimState

public String getSimState ()

Gib den Status der SIM-Karte zurück oder „null“, wenn sie nicht verfügbar ist oder das Gerät nicht verfügbar ist.

Returns
`String`

getTombstones

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

getTotalMemory

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

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Rufen Sie die Namen der Anwendungspakete ab, die deinstalliert werden können. Derzeit sind das nicht systemeigene Pakete und aktualisierte Systempakete.

Returns
	`ERROR(/Set)` der Namen von nicht deinstallierbaren `String`-Paketen, die derzeit auf dem Gerät installiert sind.

Ausgabe
`DeviceNotAvailableException`

getUseFastbootErase

public 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.

getUserFlags

public int getUserFlags (int userId)

Die Markierungen eines bestimmten Nutzers finden und zurückgeben. Flags werden in der Klasse „android.content.pm.UserInfo“ im Open-Source-Projekt von Android definiert.

Parameter
`userId`	`int`

Returns
`int`	die mit der angegebenen Nutzer-ID verknüpften Flags, falls gefunden, andernfalls -10000.

Ausgabe
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

Ruft die Zuordnung von „useId“ zu „UserInfo“ auf dem Gerät ab. Wird DeviceRuntimeException ausgegeben, wenn die Ausgabe des Geräts nicht wie erwartet ist.

Returns
	die Liste der UserInfo-Objekte.

Ausgabe
`DeviceNotAvailableException`

getUserSerialNumber

public int getUserSerialNumber (int userId)

Gibt die Seriennummer zurück, die mit der userId verknüpft ist, falls gefunden, andernfalls -10000.

Parameter
`userId`	`int`

Returns
`int`

Ausgabe
`DeviceNotAvailableException`

handleAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

Verarbeite das angegebene DeviceEvent. Das Gerät wird möglicherweise in einen neuen Status versetzt. Informiert die IDeviceMonitor über alle Statusübergänge.

Verarbeite das DeviceEvent, wodurch dieses Gerät möglicherweise in einen neuen Zuweisungsstatus übergeht.

Parameter
`event`	`DeviceEvent`

Returns
`IManagedTestDevice.DeviceEventResponse`

hasFeature

public boolean hasFeature (String feature)

Prüfen, ob eine Funktion auf einem Gerät verfügbar ist

Parameter
`feature`	`String`: Das Format sollte „feature:“ oder direkt „“ sein.

Returns
`boolean`	„True“, wenn die Funktion gefunden wird, andernfalls „false“.

Ausgabe
`DeviceNotAvailableException`

installPackage

public String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

Installieren Sie ein Android-Paket auf dem Gerät.

Parameter
`packageFile`	`File`: die zu installierende APK-Datei
`reinstall`	`boolean`: `true`, wenn eine Neuinstallation durchgeführt werden soll
`extraArgs`	`String`: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.

Returns
`String`	`String` mit einem Fehlercode oder `null` bei Erfolg.

Ausgabe
`DeviceNotAvailableException`

installPackage

public String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Installieren Sie ein Android-Paket auf dem Gerät.

Hinweis: Diese Funktion sollte nur bei Anwendungsfällen aufgerufen werden, bei denen die Laufzeitberechtigung bei der Installation explizit gesteuert werden muss.

Parameter
`packageFile`	`File`: die zu installierende APK-Datei
`reinstall`	`boolean`: `true`, wenn eine Neuinstallation durchgeführt werden soll
`grantPermissions`	`boolean`: ob alle Laufzeitberechtigungen bei der Installation erteilt werden sollen
`extraArgs`	`String`: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.

Returns
`String`	`String` mit einem Fehlercode oder `null` bei Erfolg.

Ausgabe
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer

Parameter
`packageFile`	`File`: die zu installierende APK-Datei
`reinstall`	`boolean`: `true`, wenn eine Neuinstallation durchgeführt werden soll
`userId`	`int`: Die Ganzzahl-Nutzer-ID, für die die Installation erfolgen soll.
`extraArgs`	`String`: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.

Returns
`String`	`String` mit einem Fehlercode oder `null` bei Erfolg.

Ausgabe
`DeviceNotAvailableException`

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer

Hinweis: Diese Funktion sollte nur bei Anwendungsfällen aufgerufen werden, bei denen die Laufzeitberechtigung bei der Installation explizit gesteuert werden muss.

Parameter
`packageFile`	`File`: die zu installierende APK-Datei
`reinstall`	`boolean`: `true`, wenn eine Neuinstallation durchgeführt werden soll
`grantPermissions`	`boolean`: ob alle Laufzeitberechtigungen bei der Installation erteilt werden sollen
`userId`	`int`: Die Ganzzahl-Nutzer-ID, für die die Installation erfolgen soll.
`extraArgs`	`String`: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.

Returns
`String`	`String` mit einem Fehlercode oder `null` bei Erfolg.

Ausgabe
`DeviceNotAvailableException`

invalidatePropertyCache

public void invalidatePropertyCache ()

isAdbRoot

public boolean isAdbRoot ()

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isAdbTcp

public boolean isAdbTcp ()

Returns
`boolean`

isAppEnumerationSupported

public 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
`DeviceNotAvailableException`

isBypassLowTargetSdkBlockSupported

public 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
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

Prüfen Sie, ob debugfs bereitgestellt ist.

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

Ausgabe
`DeviceNotAvailableException`

isDeviceEncrypted

public boolean isDeviceEncrypted ()

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

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

Ausgabe
`DeviceNotAvailableException`

isDirectory

public boolean isDirectory (String path)

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

Parameter
`path`	`String`

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isEnableAdbRoot

public boolean isEnableAdbRoot ()

Returns
`boolean`	`true`, ob adb root auf dem Gerät aktiviert werden soll

isEncryptionSupported

public 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
`DeviceNotAvailableException`

isExecutable

public 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
`DeviceNotAvailableException`

isFastbootEnabled

public boolean isFastbootEnabled ()

Gehen Sie zurück, wenn Fastboot für das Gerät verfügbar ist.

Returns
`boolean`

isHeadless

public boolean isHeadless ()

Gibt „wahr“ zurück, wenn das Gerät headless (ohne Bildschirm) ist, andernfalls „falsch“.

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Gibt zurück, ob das Gerät den headless-Nutzermodus des Systems verwendet.

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

Gibt an, ob der Hauptnutzer ein dauerhafter Administrator ist und nicht gelöscht oder auf den Status „Kein Administrator“ herabgestuft werden kann.

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

Bestimmt, ob die Nutzung durch mehrere Nutzer unterstützt wird.

Returns
`boolean`	„true“, wenn mehrere Nutzer unterstützt werden, andernfalls „false“

Ausgabe
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

Das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID abfragen, um zu prüfen, ob es für diesen Nutzer derzeit installiert ist oder nicht.

Parameter
`packageName`	`String`: das Paket, für das geprüft wird, ob es installiert ist.
`userId`	`String`: Die Nutzer-ID, für die geprüft wird, ob das Paket installiert ist. Wenn „null“ festgelegt ist, wird „0“ für den Hauptnutzer verwendet.

Returns
`boolean`	„True“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“.

Ausgabe
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

Das Gerät nach einem bestimmten Paketnamen abfragen, um zu prüfen, ob es derzeit installiert ist.

Parameter
`packageName`	`String`

Returns
`boolean`	„True“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“.

Ausgabe
`DeviceNotAvailableException`

isRuntimePermissionSupported

public 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
`DeviceNotAvailableException`

isStateBootloaderOrFastbootd

public boolean isStateBootloaderOrFastbootd ()

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

Returns
`boolean`

isUserRunning

public boolean isUserRunning (int userId)

Prüfen, ob ein bestimmter Nutzer aktiv ist

Parameter
`userId`	`int`

Returns
`boolean`	„True“, wenn der Nutzer läuft, andernfalls „False“.

Ausgabe
`DeviceNotAvailableException`

isUserSecondary

public boolean isUserSecondary (int userId)

Gibt an, ob der angegebene Nutzer gemäß seinen Flags ein sekundärer Nutzer ist.

Parameter
`userId`	`int`

Returns
`boolean`	„true“, wenn der Nutzer sekundär ist, andernfalls „false“.

Ausgabe
`DeviceNotAvailableException`

isUserVisible

public boolean isUserVisible (int userId)

Prüft, ob der angegebene Nutzer sichtbar ist.

Ein „sichtbarer“ Nutzer ist ein Nutzer, der mit dem „menschlichen“ Nutzer interagiert und daher Aktivitäten starten kann (in der Regel im Standarddisplay).

Parameter
`userId`	`int`

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Prüft, ob der angegebene Nutzer im angegebenen Display sichtbar ist.

Ein „sichtbarer“ Nutzer ist ein Nutzer, der mit dem „menschlichen“ Nutzer interagiert und daher Aktivitäten in diesem Display starten kann.

Parameter
`userId`	`int`
`displayId`	`int`

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Gibt an, ob Nutzer auf dem Gerät im ERROR(/java.android.view.Display#DEFAULT_DISPLAY) im Hintergrund gestartet werden können.

In diesem Fall kannst du startVisibleBackgroundUser(int, int, boolean) aufrufen und ein Display übergeben, das von listDisplayIdsForStartingVisibleBackgroundUsers() zurückgegeben wurde (und ERROR(/java.android.view.Display#DEFAULT_DISPLAY) enthalten sollte).

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

Gibt an, ob Nutzer auf dem Gerät im Hintergrund gestartet werden können.

In diesem Fall können Sie startVisibleBackgroundUser(int, int, boolean) aufrufen und ein Display übergeben, das von listDisplayIdsForStartingVisibleBackgroundUsers() zurückgegeben wird.

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Prüfen Sie, ob das WLAN aktiviert ist.

Prüft, ob WLAN auf dem Gerät aktiviert ist. Nützlich, um den WLAN-Status vor Tests zu prüfen, die nicht über WLAN ausgeführt werden sollten, z.B. Tests für mobile Daten.

Returns
`boolean`	`true`, wenn WLAN aktiviert ist. `false`, wenn deaktiviert

Ausgabe
`DeviceNotAvailableException`

listDisplayIds

public  listDisplayIds ()

Erfassen Sie die Liste der verfügbaren Display-IDs auf dem Gerät, wie von „dumpsys SurfaceFlinger“ gemeldet.

Returns
	Die Liste der Displays. Standardmäßig wird immer der Standardwert „0“ zurückgegeben.

Ausgabe
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

Liste der Anzeigen, die für start a user visible in the background verwendet werden können.

Returns

Ausgabe
`DeviceNotAvailableException`

listUsers

public  listUsers ()

Ruft die Liste der Nutzer auf dem Gerät ab. Wird DeviceRuntimeException ausgegeben, wenn die Ausgabe des Geräts nicht wie erwartet ist.

Returns
	die Liste der Nutzer-IDs.

Ausgabe
`DeviceNotAvailableException`

logAnrs

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

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Hilfsmethode, um einen Fehlerbericht zu erstellen und an die Meldenden zu senden.

Parameter
`dataName`	`String`: Name, unter dem der Fehlerbericht gemeldet wird.
`listener`	`ITestLogger`: einen `ITestLogger`, um den Fehlerbericht zu protokollieren.

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

logOnDevice

public 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 void mountDebugfs ()

debugfs bereitstellen

Ausgabe
`DeviceNotAvailableException`

nonBlockingReboot

public 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
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

Überschreiben Sie diese Option, wenn nach dem Rooten mit adb bestimmte Aktionen auf dem Gerät ausgeführt werden müssen, bevor es wieder online ist. Die Standardimplementierung enthält keine zusätzlichen Aktionen. Es ist nicht garantiert, dass „adb root“ in dieser Phase aktiviert ist.

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

postAdbUnrootAction

public void postAdbUnrootAction ()

Überschreiben Sie diese Option, wenn nach dem Entfernen des Root-Zugriffs mit adb bestimmte Aktionen auf dem Gerät ausgeführt werden müssen, bevor es wieder online ist. Die Standardimplementierung umfasst keine zusätzlichen Aktionen. Es kann nicht garantiert werden, dass adb root in dieser Phase deaktiviert ist.

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

postBootSetup

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

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

Parameter
`exception`	`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
`DeviceNotAvailableException`
`TargetSetupError`

pullDir

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

pullDir

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

pullFile

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

pullFile

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

pullFile

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

pullFile

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

pullFileContents

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

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                 excludedDirectories)

Verzeichnisinhalte rekursiv auf das Gerät übertragen und dabei einige Verzeichnisse ausschließen, die gefiltert werden.

Parameter
`localFileDir`	`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`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

Verzeichnisinhalte rekursiv auf das Gerät übertragen.

Parameter
`localFileDir`	`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`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                int userId)

Verzeichnisinhalte rekursiv auf das Gerät übertragen.

Parameter
`localFileDir`	`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`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                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
`remoteFilePath`	`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`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

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

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

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

Ausgabe
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                int userId)

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

Parameter
`localFile`	`File`: die lokale Datei, die gepusht werden soll
`remoteFilePath`	`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`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

Aus einem String erstellte Datei an das Gerät senden

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

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

Ausgabe
`DeviceNotAvailableException`

neu starten

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

neu starten

public void reboot ()

Startet das Gerät im ADB-Modus neu.

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

Ausgabe
`DeviceNotAvailableException`

rebootIntoBootloader

public void rebootIntoBootloader ()

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

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

Ausgabe
`DeviceNotAvailableException`

rebootIntoFastbootd

public void rebootIntoFastbootd ()

Startet das Gerät im Fastbootd-Modus neu.

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

Ausgabe
`DeviceNotAvailableException`

rebootIntoRecovery

public void rebootIntoRecovery ()

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

Blockiert, bis das Gerät in den Wiederherstellungsmodus wechselt

Ausgabe
`DeviceNotAvailableException`

rebootIntoSideload

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

rebootIntoSideload

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

rebootUntilOnline

public void rebootUntilOnline ()

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

Ausgabe
`DeviceNotAvailableException`

rebootUntilOnline

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

rebootUserspace

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

rebootUserspaceUntilOnline

public void rebootUserspaceUntilOnline ()

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

Ausgabe
`DeviceNotAvailableException`

recoverDevice

public boolean recoverDevice ()

Es wird versucht, die Gerätekommunikation wiederherzustellen.

Returns
`boolean`	„True“, wenn die Wiederherstellung versucht und erfolgreich war, „False“, wenn die Wiederherstellung übersprungen wurde

Ausgabe
`DeviceNotAvailableException`	Wenn das Gerät nicht mehr verfügbar ist

registerDeviceActionReceiver

public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registriert eine IDeviceActionReceiver für dieses Gerät.

Alle registrierten IDeviceActionReceivers werden vor Beginn und nach Ende einer Geräteaktion benachrichtigt.

Parameter
`deviceActionReceiver`	`IDeviceActionReceiver`: Ein `IDeviceActionReceiver`, das registriert wird.

remountSystemReadOnly

public void remountSystemReadOnly ()

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

Ausgabe
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

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

Ausgabe
`DeviceNotAvailableException`

remountVendorReadOnly

public void remountVendorReadOnly ()

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

Ausgabe
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

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

Ausgabe
`DeviceNotAvailableException`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Entfernt den angegebenen Geräteadministrator beim angegebenen Nutzer und gibt true zurück, wenn der Vorgang erfolgreich war, andernfalls false.

Parameter
`componentName`	`String`: der zu entfernenden Geräteverwaltung.
`userId`	`int`: des Nutzers, in dessen Land sich der Geräteadministrator befindet.

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

Ausgabe
`DeviceNotAvailableException`

removeOwners

public void removeOwners ()

Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen nach Möglichkeit.

Ausgabe
`DeviceNotAvailableException`

removeUser

public boolean removeUser (int userId)

Einen bestimmten Nutzer vom Gerät entfernen.

Parameter
`userId`	`int`: des zu entfernenden Nutzers

Returns
`boolean`	„true“, wenn der Nutzer entfernt werden konnte, andernfalls „false“.

Ausgabe
`DeviceNotAvailableException`

resetContentProviderSetup

public void resetContentProviderSetup ()

Setze das Flag für die Einrichtung des Inhaltsanbieters zurück, um die Einrichtung noch einmal auszulösen.

runInstrumentationTests

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

runInstrumentationTests

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

runInstrumentationTestsAsUser

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

setConfiguration

public void setConfiguration (IConfiguration configuration)

Fügt den verwendeten IConfiguration ein.

Parameter
`configuration`	`IConfiguration`

setConnectionAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

Parameter
`avdInfo`	`GceAvdInfo`

setDate

public 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
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Eine Geräteadministratorkomponente als Geräteinhaber für den angegebenen Nutzer festlegen

Parameter
`componentName`	`String`: des Geräteadministrators als Geräteinhaber.
`userId`	`int`: des Nutzers, in dessen Land sich der Geräteinhaber befindet.

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

Ausgabe
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

Aktualisieren Sie den Status des Geräts.

Parameter
`deviceState`	`TestDeviceState`: die `TestDeviceState`

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

Für den Emulator SizeLimitedOutputStream auf „Logausgabe“ festlegen

Parameter
`output`	`SizeLimitedOutputStream`: Ausgabe protokollieren

setEmulatorProcess

public void setEmulatorProcess (Process p)

Legt den Process fest, wenn es sich bei diesem Gerät um einen Emulator handelt.

Parameter
`p`	`Process`

setFastbootEnabled

public void setFastbootEnabled (boolean fastbootEnabled)

Legen Sie die Fastboot-Option für das Gerät fest. Sollte festgelegt werden, wenn das Gerät zum ersten Mal zugewiesen wird.

Parameter
`fastbootEnabled`	`boolean`: ob Fastboot für das Gerät verfügbar ist

setFastbootPath

public void setFastbootPath (String fastbootPath)

Legt den Pfad zum zu verwendenden Fastboot-Binärprogramm fest. Damit Fastboot-Funktionen aktiviert werden können, muss isFastbootEnabled() weiterhin „wahr“ sein.

Parameter
`fastbootPath`	`String`

setIDevice

public void setIDevice (IDevice newDevice)

Aktualisieren Sie das mit diesem ITestDevice verknüpfte IDevice.

Das neue IDevice muss sich auf dasselbe physische Gerät beziehen wie die aktuelle Referenz. Diese Methode wird aufgerufen, wenn DDMS ein neues IDevice zugewiesen hat.

Parameter
`newDevice`	`IDevice`: die `IDevice`

setLogStartDelay

public void setLogStartDelay (int delay)

Legt die Zeit in Millisekunden fest, die gewartet werden soll, bevor die Logcat-Aufzeichnung für ein online verfügbares Gerät gestartet wird.

Parameter
`delay`	`int`: Verzögerung in ms

setOptions

public void setOptions (TestDeviceOptions options)

TestDeviceOptions für das Gerät festlegen

Parameter
`options`	`TestDeviceOptions`

setProperty

public 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
`DeviceNotAvailableException`

setRecovery

public 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 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

setSetting

public void setSetting (String namespace, 
                String key, 
                String value)

Siehe setSetting(int, String, String, String) und wird auf den Systemnutzer angewendet.

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

Ausgabe
`DeviceNotAvailableException`

setSetting

public void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

Dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzufügen. Einige Einstellungen sind erst nach einem Neustart verfügbar. namespace muss eine der folgenden Optionen sein: {"system", "secure", "global"}

Parameter
`userId`	`int`
`namespace`	`String`
`key`	`String`
`value`	`String`

Ausgabe
`DeviceNotAvailableException`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

ITestLogger-Instanz einschleust

Parameter
`testLogger`	`ITestLogger`

setTrackingSerial

public 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 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.

startLogcat

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

startUser

public boolean startUser (int userId)

Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist. Wenn der Nutzer bereits im Hintergrund ausgeführt wird, ist diese Methode ein NOOP.

Parameter
`userId`	`int`: des Nutzers, der im Hintergrund gestartet werden soll

Returns
`boolean`	„wahr“, wenn der Nutzer im Hintergrund gestartet wurde.

Ausgabe
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist. Wenn der Nutzer bereits im Hintergrund ausgeführt wird, ist diese Methode ein NOOP. Es ist möglich, ein zusätzliches Flag anzugeben, um zu warten, bis der Vorgang wirksam wird.

Parameter
`userId`	`int`: des Nutzers, der im Hintergrund gestartet werden soll
`waitFlag`	`boolean`: Der Befehl wartet, bis der Nutzer gestartet und entsperrt ist.

Returns
`boolean`	„wahr“, wenn der Nutzer im Hintergrund gestartet wurde.

Ausgabe
`DeviceNotAvailableException`

startVisibleBackgroundUser

public boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

Startet einen bestimmten Nutzer im Hintergrund, der auf dem entsprechenden Display sichtbar ist (d.h., der Nutzer kann Aktivitäten auf diesem Display starten).

HINWEIS : Mit diesem Befehl wird nicht geprüft, ob der Nutzer vorhanden ist, das Display verfügbar ist usw.device supports such feature

Parameter
`userId`	`int`: des Nutzers, der im Hintergrund gestartet werden soll
`displayId`	`int`: Display, auf dem die Benachrichtigung für Nutzer sichtbar sein soll
`waitFlag`	`boolean`: Der Befehl wartet, bis der Nutzer gestartet und entsperrt ist.

Returns
`boolean`	`true`, wenn der Nutzer erfolgreich gestartet wurde und im Hintergrund sichtbar ist.

Ausgabe
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

Schließen und löschen Sie die Emulatorausgabe.

stopLogcat

public 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 void stopTradeInModeTesting ()

Testen des Trade-In-Modus beenden.

Ausgabe
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId)

Stoppt einen bestimmten Nutzer. Wenn der Nutzer bereits angehalten hat, ist diese Methode ein NOOP. Der aktuelle Nutzer und der Systemnutzer können nicht angehalten werden.

Parameter
`userId`	`int`: des Nutzers, der beendet werden soll.

Returns
`boolean`	„wahr“, wenn der Nutzer erfolgreich gestoppt wurde.

Ausgabe
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

Einen bestimmten Nutzer anhalten. Es ist möglich, zusätzliche Flags anzugeben, um zu warten, bis der Vorgang wirksam wird, und den Nutzer zu zwingen, die Sitzung zu beenden. Der aktuelle Nutzer und der Systemnutzer können nicht angehalten werden.

Parameter
`userId`	`int`: des Nutzers, der beendet werden soll.
`waitFlag`	`boolean`: Der Befehl wartet, bis der Nutzer gestoppt wird.
`forceFlag`	`boolean`: wird der Nutzer zwangsweise beendet.

Returns
`boolean`	„wahr“, wenn der Nutzer erfolgreich gestoppt wurde.

Ausgabe
`DeviceNotAvailableException`

switchToAdbTcp

public 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
`DeviceNotAvailableException`

switchToAdbUsb

public 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
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId)

Wechseln Sie zu einer anderen userId mit einer Standardzeitüberschreitung. switchUser(int, long).

Parameter
`userId`	`int`

Returns
`boolean`	„True“, wenn die neue User-ID mit dem Anbieter der User-ID übereinstimmt. Andernfalls „false“.

Ausgabe
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

Wechseln Sie zu einer anderen Nutzer-ID mit dem angegebenen Zeitlimit als Frist. Versuchen Sie, den Sperrbildschirm zu deaktivieren, nachdem die Nutzeränderung erfolgreich war.

Parameter
`userId`	`int`
`timeout`	`long`: Wartezeit, bevor „false“ für „switch-user failed“ zurückgegeben wird.

Returns
`boolean`	„True“, wenn die neue User-ID mit dem Anbieter der User-ID übereinstimmt. Andernfalls „false“.

Ausgabe
`DeviceNotAvailableException`

syncFiles

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

takeBugreport

public Bugreport takeBugreport ()

Nimmt einen Fehlerbericht entgegen und gibt ihn in einem Bugreport-Objekt zurück, um ihn zu verarbeiten. Gibt bei Problemen „null“ zurück. Die im Bugberichtsobjekt referenzierte Datei muss über Bugreport.close() bereinigt werden.

Returns
`Bugreport`

uninstallPackage

public String uninstallPackage (String packageName)

Deinstallation eines Android-Pakets vom Gerät

Parameter
`packageName`	`String`: das zu deinstallierende Android-Paket

Returns
`String`	`String` mit einem Fehlercode oder `null` bei Erfolg.

Ausgabe
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Deinstallation eines Android-Pakets von einem Gerät für einen bestimmten Nutzer

Parameter
`packageName`	`String`: das zu deinstallierende Android-Paket
`userId`	`int`: Die Ganzzahl-Nutzer-ID, für die die Deinstallation erfolgen soll.

Returns
`String`	`String` mit einem Fehlercode oder `null` bei Erfolg.

Ausgabe
`DeviceNotAvailableException`

unlockDevice

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

unmountDebugfs

public void unmountDebugfs ()

Entfernen Sie die Bereitstellung von debugfs.

Ausgabe
`DeviceNotAvailableException`

waitForBootComplete

public 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
`DeviceNotAvailableException`

waitForDeviceAvailable

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

waitForDeviceAvailable

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

waitForDeviceAvailableInRecoverPath

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

waitForDeviceBootloader

public void waitForDeviceBootloader ()

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

Ausgabe
`DeviceNotAvailableException`

waitForDeviceInRecovery

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

waitForDeviceOnline

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

waitForDeviceShell

public 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.

Geschützte Methoden

addExtraConnectionBuilderArgs

protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

Parameter
`builder`	`DefaultConnection.ConnectionBuilder`

buildAdbShellCommand

protected String[] buildAdbShellCommand (String command, 
                boolean forceExitStatusDetection)

Erstellt den Betriebssystembefehl für die angegebene adb-Shell-Befehlssitzung und die Argumente.

Parameter
`command`	`String`
`forceExitStatusDetection`	`boolean`

Returns
`String[]`

checkApiLevelAgainst

protected void checkApiLevelAgainst (String feature, 
                int strictMinLevel)

Parameter
`feature`	`String`
`strictMinLevel`	`int`

createRebootDeviceAction

protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, 
                String reason)

Erstellen Sie eine RebootDeviceAction, die beim Ausführen einer Neustartaktion verwendet werden soll.

Parameter
`rebootMode`	`NativeDevice.RebootMode`: einen Modus dieses Neustarts.
`reason`	`String`: für diesen Neustart.

Returns
`NativeDevice.RebootDeviceAction`	den erstellten `RebootDeviceAction`.

createRunUtil

protected IRunUtil createRunUtil ()

Returns
`IRunUtil`

doAdbReboot

protected void doAdbReboot (NativeDevice.RebootMode rebootMode, 
                String reason)

Führen Sie einen ADB-Neustart durch.

Parameter
`rebootMode`	`NativeDevice.RebootMode`: einen Modus dieses Neustarts.
`reason`	`String`: für diesen Neustart.

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

ensureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

Hilfsmethode, um eine Ausnahme zu werfen, wenn die Laufzeitberechtigung nicht unterstützt wird

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

getApiLevelSafe

protected int getApiLevelSafe ()

Returns
`int`

getLogger

protected ITestLogger getLogger ()

Returns
`ITestLogger`

getRunUtil

protected IRunUtil getRunUtil ()

Rufen Sie die zu verwendende RunUtil-Instanz ab.

Returns
`IRunUtil`

initializeConnection

protected void initializeConnection (IBuildInfo info, 
                MultiMap<String, String> attributes)

Parameter
`info`	`IBuildInfo`
`attributes`	`MultiMap`

Ausgabe
`DeviceNotAvailableException`
`TargetSetupError`

internalGetProperty

protected String internalGetProperty (String propName, 
                String fastbootVar, 
                String description)

Eine Geräteeigenschaft wird standardmäßig aus dem ddmlib-Cache abgerufen. Je nachdem, ob sich das Gerät im Fastboot-Modus befindet, wird entweder „adb shell getprop“ oder „fastboot getvar“ verwendet.

Parameter
`propName`	`String`: Der Name der Geräteeigenschaft, wie von „adb shell getprop“ zurückgegeben
`fastbootVar`	`String`: Der Name der zu abfragenden entsprechenden Fastboot-Variablen. Bei `null` wird keine Fastboot-Abfrage versucht.
`description`	`String`: Eine einfache Beschreibung der Variablen. Der erste Buchstabe sollte großgeschrieben werden.

Returns
`String`	Ein String, möglicherweise `null` oder leer, der den Wert der angegebenen Property enthält

Ausgabe
`DeviceNotAvailableException`

isInRebootCallback

protected boolean isInRebootCallback ()

Gibt an, ob Reboot-Callbacks derzeit ausgeführt werden. Alle öffentlichen APIs für den Neustart sollten deaktiviert werden, wenn diese Option aktiviert ist.

Returns
`boolean`

isNewer

protected boolean isNewer (File localFile, 
                IFileEntry entry)

Gibt true zurück, wenn die lokale Datei neuer ist als die Remotedatei. IFileEntry muss auf die Minute genau sein. Bei gleicher Uhrzeit gilt die Datei als neuer.

Parameter
`localFile`	`File`
`entry`	`IFileEntry`

Returns
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

Alle IDeviceActionReceiver werden über das Ereignis „Neustartendendung“ benachrichtigt.

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

notifyRebootStarted

protected void notifyRebootStarted ()

Alle IDeviceActionReceiver werden über das Ereignis „Neustart gestartet“ benachrichtigt.

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

performDeviceAction

protected boolean performDeviceAction (String actionDescription, 
                NativeDevice.DeviceAction action, 
                int retryAttempts)

Führt eine Aktion auf diesem Gerät aus. Versucht, das Gerät wiederherzustellen, und führt den Befehl optional noch einmal aus, wenn die Aktion fehlschlägt.

Parameter
`actionDescription`	`String`: Eine kurze Beschreibung der auszuführenden Aktion. Wird nur zu Protokollierungszwecken verwendet.
`action`	`NativeDevice.DeviceAction`: die auszuführende Aktion
`retryAttempts`	`int`: Die Wiederholungsversuche für die Aktion, wenn sie fehlschlägt, die Wiederherstellung aber erfolgreich ist

Returns
`boolean`	`true`, wenn die Aktion erfolgreich war

Ausgabe
`DeviceNotAvailableException`	if recovery attempt fails or max attempts done without success

postAdbReboot

protected void postAdbReboot ()

Mögliche zusätzliche Aktionen, die nach einem Neustart ausgeführt werden können.

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

prePostBootSetup

protected void prePostBootSetup ()

Ermöglicht es jedem Gerätetyp (AndroidNativeDevice, TestDevice), diese Methode für die spezifische Einrichtung nach dem Start zu überschreiben.

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

pullFileInternal

protected boolean pullFileInternal (String remoteFilePath, 
                File localFile)

Parameter
`remoteFilePath`	`String`
`localFile`	`File`

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

setClock

protected void setClock (Clock clock)

Legen Sie die zu verwendende Uhren-Instanz fest.

Parameter
`clock`	`Clock`

setMicrodroidProcess

protected void setMicrodroidProcess (Process process)

Kennzeichnet das Testgerät als Microdroid und legt seine CID fest.

Parameter
`process`	`Process`: Prozess der Microdroid-VM.

setTestDeviceOptions

protected void setTestDeviceOptions ( deviceOptions)

Parameter
`deviceOptions`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                 envVarMap, 
                String[] fullCmd)

Führt einen einfachen Fastboot-Befehl mit Umgebungsvariablen aus und meldet den Status des Befehls.

Parameter
`timeout`	`long`
`envVarMap`
`fullCmd`	`String`

Returns
`CommandResult`

simpleFastbootCommand

protected CommandResult simpleFastbootCommand (long timeout, 
                String[] fullCmd)

Führt einen einfachen Fastboot-Befehl aus und meldet den Status des Befehls.

Parameter
`timeout`	`long`
`fullCmd`	`String`

Returns
`CommandResult`

waitForDeviceNotAvailable

protected boolean waitForDeviceNotAvailable (String operationDesc, 
                long time)

Warten Sie, bis das Gerät nicht mehr verfügbar ist (keine Berichte mehr an adb).

Parameter
`operationDesc`	`String`: Der Name des Vorgangs, der auf „nicht verfügbar“ wartet.
`time`	`long`: Die Zeit, die gewartet werden soll, bis der Status „Nicht verfügbar“ auftritt.

Returns
`boolean`	„True“, wenn das Gerät nicht mehr verfügbar ist.

NativeDevice

Zusammenfassung

Verschachtelte Klassen

Konstanten

Felder

Öffentliche Konstruktoren

Öffentliche Methoden

Geschützte Methoden

Konstanten

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

Felder

DEBUGFS_PATH

SD_CARD

STORAGE_EMULATED

mOptions

mStateMonitor

Öffentliche Konstruktoren

NativeDevice

Öffentliche Methoden

batchPrefetchStartupBuildProps

canSwitchToHeadlessSystemUser

checkApiLevelAgainstNextRelease

checkConnectivity

clearErrorDialogs

clearLastConnectedWifiNetwork

clearLogcat

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetwork

connectToWifiNetworkIfNeeded

connectToWifiNetworkIfNeeded

createUser

createUser

createUser

createUserNoThrow

debugDeviceNotAvailable

deleteFile

deleteFile

deregisterDeviceActionReceiver

deviceSoftRestarted

deviceSoftRestartedSince

disableAdbRoot

disableKeyguard

disableNetworkMonitor

disconnectFromWifi

doesFileExist

doesFileExist

dumpHeap

enableAdbRoot

enableNetworkMonitor

executeAdbCommand

executeAdbCommand

executeAdbCommand

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootWipePartition

getActiveApexes

getAllSettings

getAllocationState

getAndroidId

getAndroidIds

getApiLevel

getAppPackageInfo

getAppPackageInfos