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 eines ITestDevice für ein Android-Gerät mit vollständigem Stack

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 auf einer virtuellen Maschine ausgeführt wird, die wir remote über eine Tradefed-Instanz auf der VM verwalten.
NestedRemoteDevice	Darstellung des Geräts, das in einer Remote-Cuttlefish-VM ausgeführt wird.
RemoteAndroidDevice	Implementierung eines `ITestDevice` für ein Full-Stack-Android-Gerät, das über „adb connect“ verbunden ist.
RemoteAndroidVirtualDevice	Erweitert das Verhalten von `RemoteAndroidDevice` für ein Android-Gerät mit vollständigem Stack, das in Google Compute Engine (GCE) ausgeführt wird.

Standardimplementierung von ITestDevice Nicht-Full-Stack-Android-Geräte

Zusammenfassung

Verschachtelte Klassen
`class`	`NativeDevice.AdbAction` Ein `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
`String`	`DEBUGFS_PATH`
`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
`String`	`SD_CARD`
`String`	`STORAGE_EMULATED`

Felder
`protected TestDeviceOptions`	`mOptions`
`protected final IDeviceStateMonitor`	`mStateMonitor`

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

Öffentliche Methoden
`void`	`batchPrefetchStartupBuildProps()` Mikrooptimierung (ca. 400 Millisekunden) durch Vorabrufen aller benötigten Attribute anstatt „adb getprop“ für jedes Attribut aufzurufen.
`boolean`	`canSwitchToHeadlessSystemUser()` Gibt zurück, ob der Wechsel zum monitorlosen SYSTEM-Nutzer zulässig ist.
`boolean`	`checkApiLevelAgainstNextRelease(int strictMinLevel)` Prüfen, ob eine Funktion bei einem minimal unterstützten Level derzeit unterstützt wird.
`boolean`	`checkConnectivity()` Prüfen Sie, ob das Gerät eine Netzwerkverbindung hat.
`boolean`	`clearErrorDialogs()` Schließen Sie alle Fehlerdialogfelder, die derzeit auf der Geräte-UI angezeigt werden.
`void`	`clearLastConnectedWifiNetwork()` Löscht das zuletzt verbundene WLAN.
`void`	`clearLogcat()` Löscht alle angesammelten logcat-Daten.
`boolean`	`connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)` Verbindung zu einem WLAN herstellen
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk)` Verbindung zu einem WLAN herstellen
`boolean`	`connectToWifiNetwork( wifiSsidToPsk)` Verbindet sich mit einem WLAN.f
`boolean`	`connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)` Verbindung zu einem WLAN herstellen
`boolean`	`connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)` Eine Variante von `connectToWifiNetwork(String, String)`, die nur 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 eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.
`int`	`createUser(String name, boolean guest, boolean ephemeral)` Erstelle einen Nutzer mit einem bestimmten Namen und den angegebenen Flags.
`int`	`createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)` Erstelle einen Nutzer mit einem bestimmten Namen und den angegebenen Flags.
`int`	`createUser(String name)` Erstellt einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
`int`	`createUserNoThrow(String name)` Erstellt einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
`DeviceInspectionResult`	`debugDeviceNotAvailable()` Ein Gerät prüfen und detaillierte Informationen zurückgeben, wenn ein Gerät nicht mehr 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 zum Prüfen, ob das Gerät durch Vergleich des aktuellen system_server mit dem vorherigen system_server `ProcessInfo` neu gestartet wurde.
`boolean`	`deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)` Hilfsmethode, um zu prüfen, ob das Gerät seit der UTC-Zeit seit der Epoche vom Gerät und seinem `ERROR(/TimeUnit)` neu gestartet wurde.
`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()` Die Verbindung zu einem WLAN wird getrennt.
`boolean`	`doesFileExist(String deviceFilePath, int userId)` Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät für einen bestimmten Nutzer vorhanden ist.
`boolean`	`doesFileExist(String deviceFilePath)` Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät vorhanden ist.
`File`	`dumpHeap(String process, String devicePath)` Versuchen Sie, den Heap aus dem system_server zu sichern.
`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`	`executeAdbV2Command(String... cmdArgs)` Hilfsmethode, die einen ADB-Befehl als Systembefehl ausführt.
`CommandResult`	`executeAdbV2Command(long timeout, String... cmdArgs)` Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.
`CommandResult`	`executeAdbV2Command(long timeout, envMap, String... cmdArgs)` Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.
`CommandResult`	`executeFastbootCommand(String... cmdArgs)` Hilfsmethode, die einen Fastboot-Befehl als Systembefehl mit einem Standard-Timeout 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 zeitaufwendigen Fastboot-Befehl als Systembefehl ausführt.
`CommandResult`	`executeLongFastbootCommand( envVarMap, String... cmdArgs)` Hilfsmethode, die einen zeitaufwendigen Fastboot-Befehl als Systembefehl mit Systemumgebungsvariablen ausführt.
`String`	`executeShellCommand(String command)` Hilfsmethode, die einen ADB-Shellbefehl 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 zur Steuerung des Befehlsverhaltens aus.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)` Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Führt den angegebenen adb-Shell-Befehl aus und versucht es mehrmals, wenn der Befehl fehlschlägt.
`CommandResult`	`executeShellV2Command(String cmd)` Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als `CommandResult` zurückgibt, die mit der Befehlsstatusausgabe, stdout und stderr gefüllt ist.
`CommandResult`	`executeShellV2Command(String cmd, OutputStream pipeToOutput)` Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als `CommandResult` zurückgibt, das mit der Befehlsstatusausgabe und stderr gefüllt ist.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput)` Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als `CommandResult` zurückgibt, die ordnungsgemäß mit der Befehlsstatusausgabe, stdout und stderr gefüllt ist.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
`CommandResult`	`executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)` Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
`CommandResult`	`executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)` Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
`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 zur Steuerung des Befehlsverhaltens aus.
`CommandResult`	`fastbootWipePartition(String partition)` Helper-Methode, mit der eine Partition für das Gerät gelöscht wird.
	`getActiveApexes()` Ruft die Informationen zu den auf dem Gerät aktivierten APEX-Modulen ab.
`String`	`getAdbPath()` Gibt den Pfad der verwendeten ADB-Binärdatei zurück.
	`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)` Sucht die Android-ID, die einem Nutzer zugeordnet ist, und gibt sie zurück. Wenn sie nicht gefunden wird, wird „null“ zurückgegeben.
	`getAndroidIds()` Erstellen Sie eine Zuordnung von Android-IDs zu übereinstimmenden User-IDs.
`int`	`getApiLevel()` API-Level des Geräts abrufen.
`PackageInfo`	`getAppPackageInfo(String packageName)` Informationen zu einem auf dem Gerät installierten Paket abrufen.
	`getAppPackageInfos()` Informationen zu auf dem Gerät installierten Paketen abrufen.
`String`	`getBasebandVersion()` Einfache Methode zum Abrufen der Baseband-Version (Funkmodul) dieses Geräts.
`Integer`	`getBattery()` Gibt den aktuellen Akkustand eines Geräts oder „Null“ zurück, 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 Bootverlaufskarte mit Bootzeit und Bootgrund.
	`getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)` Die Hilfsmethode ruft die Karte mit dem Bootverlauf mit Bootzeit und Bootgrund seit der angegebenen Zeit seit der Epoche vom Gerät und der angegebenen Zeiteinheit ab.
`String`	`getBootloaderVersion()` Bequeme Methode zum Abrufen der Bootloader-Version dieses Geräts.
`InputStreamSource`	`getBugreport()` Ruft einen Fehlerbericht vom Gerät ab.
`InputStreamSource`	`getBugreportz()` Ruft einen Bugreportz vom Gerät ab.
`String`	`getBuildAlias()` Rufen Sie 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 derzeit auf dem Gerät ausgeführt wird.
`String`	`getBuildSigningKeys()` Gibt den Schlüsseltyp zurück, der zum Signieren des Geräte-Images verwendet wurde. Android-Geräte können in der Regel mit Testschlüsseln (wie in AOSP) oder Releaseschlüsseln (die von den einzelnen Geräteherstellern verwaltet werden) signiert werden.
`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 aufgrund von Berechtigungen manchmal nicht funktioniert.
`AbstractConnection`	`getConnection()` Die aktuelle Verbindung des Geräts.
`ContentProviderHandler`	`getContentProvider(int userId)` Gibt `ContentProviderHandler` zurück oder „null“, wenn nicht verfügbar.
`DeviceFoldableState`	`getCurrentFoldableState()` Gibt den aktuellen Status des faltbaren Geräts zurück oder „null“, wenn Probleme aufgetreten sind.
`int`	`getCurrentUser()` Gibt die ID des aktuell ausgeführten 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()` Gibt ein `DeviceDescriptor` aus den Geräteinformationen zurück, um Informationen dazu abzurufen, ohne das tatsächliche Geräteobjekt zu übergeben.
`DeviceDescriptor`	`getDeviceDescriptor(boolean shortDescriptor)` Gibt ein `DeviceDescriptor` aus den Geräteinformationen zurück, um Informationen dazu abzurufen, ohne das tatsächliche Geräteobjekt zu übergeben.
`TestDeviceState`	`getDeviceState()` Gerätestatus abrufen
`long`	`getDeviceTimeOffset(Date date)` Helper zum Abrufen des Zeitunterschieds zwischen dem Gerät und einem bestimmten `ERROR(/Date)`.
`InputStreamSource`	`getEmulatorOutput()` Stream von Emulator-stdout und -stderr abrufen
`Process`	`getEmulatorProcess()` Gibt die `Process` zurück, die diesem Emulator entspricht.
`final File`	`getExecuteShellCommandLog()` Das Log, das alle `executeShellCommand(String)`-Logs 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()` Bequeme Methode zum Abrufen des Produkttyps dieses Geräts im Fastboot-Modus.
`String`	`getFastbootProductVariant()` Bequeme Methode zum Abrufen des Produkttyps dieses Geräts im Fastboot-Modus.
`String`	`getFastbootSerialNumber()` Gibt die Seriennummer im Fastboot-Modus zurück.
`String`	`getFastbootVariable(String variableName)` Ruft den angegebenen Fastboot-Variablenwert 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 eines `FileEntry` aus einem Nicht-Root-Pfad.
	`getFoldableStates()` Gibt die Liste der faltbaren Status auf dem Gerät zurück.
`IDevice`	`getIDevice()` Gibt einen Verweis auf die zugehörige ddmlib-`IDevice` zurück.
	`getInstalledPackageNames()` Ruft die Paketnamen der auf dem Gerät vorhandenen Anwendungen ab.
`long`	`getIntProperty(String name, long defaultValue)` Gibt den Ganzzahlwert der angegebenen Eigenschaft des Geräts zurück.
`String`	`getIpAddress()` Ruft die IP-Adresse des Geräts ab.
`KeyguardControllerState`	`getKeyguardState()` Gibt ein Objekt zurück, um den aktuellen Status des Keyguards abzurufen, oder „null“, wenn er nicht unterstützt wird.
`long`	`getLastExpectedRebootTimeMillis()` Gibt die letzte Zeit zurück, zu der Tradefed-APIs einen Neustart ausgelöst haben, in Millisekunden seit EPOCH, wie von `System.currentTimeMillis()` zurückgegeben.
`int`	`getLaunchApiLevel()` Ruft das API‑Level des Geräts beim ersten Start ab.
`InputStreamSource`	`getLogcat()` Erstellt einen Snapshot-Stream der Logcat-Daten.
`InputStreamSource`	`getLogcat(int maxBytes)` Erstellt einen Snapshot-Stream der letzten `maxBytes` erfassten logcat-Daten.
`InputStreamSource`	`getLogcatDump()` Rufen Sie einen Dump des aktuellen Logcat für das Gerät ab.
`InputStreamSource`	`getLogcatSince(long date)` Ruft einen Snapshot-Stream der erfassten Logcat-Daten ab dem angegebenen Datum ab.
`String`	`getMacAddress()` Gibt die MAC-Adresse des Geräts zurück. Wenn die Abfrage des Geräts fehlschlägt, wird „null“ zurückgegeben.
`Integer`	`getMainUserId()` Gibt die Hauptnutzer-ID zurück.
	`getMainlineModuleInfo()` Ruft Informationen zu den auf dem Gerät installierten Mainline-Modulen ab.
`int`	`getMaxNumberOfRunningUsersSupported()` Die maximale Anzahl der unterstützten gleichzeitig aktiven Nutzer abrufen.
`int`	`getMaxNumberOfUsersSupported()` Maximale Anzahl der unterstützten Nutzer abrufen
`Process`	`getMicrodroidProcess()`
`IDeviceStateMonitor`	`getMonitor()` Gibt die mit dem Gerät verknüpfte `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 Mountpoint-Pfad entspricht, oder `null`, wenn für diesen Pfad nichts gemountet ist oder er anderweitig nicht als Mountpoint in /proc/mounts angezeigt wird.
	`getMountPointInfo()` Gibt eine geparste Version der Informationen in /proc/mounts auf dem Gerät zurück.
`TestDeviceOptions`	`getOptions()` Ruft die Testoptionen für das Gerät ab.
`long`	`getPartitionFreeSpace(String partition)` Hilfsmethode zum Ermitteln 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 das `ProcessInfo`-Objekt mit der PID und der Startzeit des angegebenen Prozesses zurück.
`String`	`getProcessPid(String process)` Gibt die PID des Dienstes oder „null“ zurück, wenn ein Fehler aufgetreten ist.
`String`	`getProductType()` Bequeme Methode zum Abrufen des Produkttyps dieses Geräts.
`String`	`getProductVariant()` Bequeme Methode zum Abrufen der Produktvariante dieses Geräts.
`String`	`getProperty(String name)` Ruft den angegebenen Attributwert vom Gerät ab.
`ITestDevice.RecoveryMode`	`getRecoveryMode()` Den aktuellen Wiederherstellungsmodus für das Gerät abrufen.
`InputStreamSource`	`getScreenshot(long displayId)` Erstellt einen Screenshot des Geräts mit der angegebenen Anzeige-ID.
`InputStreamSource`	`getScreenshot(String format)` Erstellt einen Screenshot vom Gerät.
`InputStreamSource`	`getScreenshot(String format, boolean rescale)` Erstellt einen Screenshot vom Gerät.
`InputStreamSource`	`getScreenshot()` Erstellt einen Screenshot vom Gerät.
`String`	`getSerialNumber()` Bequeme Methode zum Abrufen der Seriennummer dieses Geräts.
`String`	`getSetting(int userId, String namespace, String key)` Gibt den Wert der angeforderten Einstellung zurück.
`String`	`getSetting(String namespace, String key)` Weitere Informationen finden Sie unter `getSetting(int, String, String)`.
`String`	`getSimOperator()` Gibt den SIM-Kartenbetreiber zurück oder „null“, wenn er nicht verfügbar ist oder das Gerät nicht verfügbar ist.
`String`	`getSimState()` Gibt den SIM-Kartenstatus zurück oder „null“, wenn er nicht verfügbar ist oder das Gerät nicht verfügbar ist.
	`getTombstones()` Die Liste der Tombstones von den Geräten abrufen und zurückgeben.
`long`	`getTotalMemory()` Gibt die Gesamtgröße des physischen Speichers in Byte oder -1 im Falle eines internen Fehlers zurück.
`String`	`getTrackingSerial()` Rufen Sie die Seriennummer ab, die zum Verfolgen des Geräts verwendet wird, um das Gerät zu verwalten.
	`getUninstallablePackageNames()` Ruft die Paketnamen der Anwendungen ab, die deinstalliert werden können.
`boolean`	`getUseFastbootErase()` Gibt an, ob zum Löschen einer Partition auf dem Gerät „fastboot erase“ oder „fastboot format“ verwendet werden soll.
`int`	`getUserFlags(int userId)` Sucht die Flags eines bestimmten Nutzers und gibt sie zurück.
	`getUserInfos()` Ruft die Zuordnung von useId zu `UserInfo` auf dem Gerät ab.
`int`	`getUserSerialNumber(int userId)` Gibt die dem userId zugeordnete Seriennummer zurück, falls gefunden, andernfalls -10000.
`IManagedTestDevice.DeviceEventResponse`	`handleAllocationEvent(DeviceEvent event)` Verarbeite das angegebene DeviceEvent. Verarbeite das DeviceEvent. Dadurch wird das Gerät möglicherweise in einen neuen Zuweisungsstatus versetzt.
`boolean`	`hasFeature(String feature)` Prüfen, ob eine Funktion auf einem Gerät verfügbar ist
`void`	`initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)` Stellen Sie die Verbindung zum Gerät her.
`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 Sie ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.
`String`	`installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)` Installieren Sie ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.
`boolean`	`installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)` Installiert APKs im inkrementellen Modus.
`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 das Umgehen der Blockierung von App-Installationen aufgrund eines niedrigen Ziel-SDK unterstützt
`boolean`	`isDebugfsMounted()` Prüfen Sie, ob debugfs gemountet ist.
`boolean`	`isDeviceEncrypted()` Gibt zurück, 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()` Gibt zurück, ob Fastboot für das Gerät verfügbar ist.
`boolean`	`isHeadless()` Gibt „true“ zurück, wenn das Gerät headless ist (kein Bildschirm), andernfalls „false“.
`boolean`	`isHeadlessSystemUserMode()` Gibt zurück, ob auf dem Gerät der monitorlose Systemnutzermodus verwendet wird.
`boolean`	`isMainUserPermanentAdmin()` Gibt zurück, ob der Hauptnutzer ein permanenter Administrator ist und nicht gelöscht oder auf den Status „Kein Administrator“ herabgestuft werden kann.
`boolean`	`isMultiUserSupported()` Gibt an, ob mehrere Nutzer unterstützt werden.
`boolean`	`isPackageInstalled(String packageName, String userId)` Fragen Sie das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID ab, um zu prüfen, ob die App für diesen Nutzer derzeit installiert ist.
`boolean`	`isPackageInstalled(String packageName)` Fragen Sie das Gerät nach einem bestimmten Paketnamen, um zu prüfen, ob das Paket derzeit installiert ist.
`boolean`	`isRuntimePermissionSupported()` Prüfen, ob die Plattform auf dem Gerät die Erteilung 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 zurück, ob der angegebene Nutzer anhand seiner 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 auf dem angegebenen Display sichtbar ist.
`boolean`	`isVisibleBackgroundUsersOnDefaultDisplaySupported()` Gibt zurück, ob Nutzer auf dem Gerät im Hintergrund in `ERROR(/java.android.view.Display#DEFAULT_DISPLAY)` sichtbar sein können.
`boolean`	`isVisibleBackgroundUsersSupported()` Gibt zurück, ob Nutzer im Hintergrund sichtbar gestartet werden dürfen.
`boolean`	`isWifiEnabled()` Prüfen, ob WLAN aktiviert ist.
	`listDisplayIds()` Erfassen Sie die Liste der verfügbaren Display-IDs auf dem Gerät, wie von „dumpsys SurfaceFlinger“ gemeldet.
	`listDisplayIdsForStartingVisibleBackgroundUsers()` Ruft die Liste der Displays ab, 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 ANR-Fehler vom Gerät.
`boolean`	`logBugreport(String dataName, ITestLogger listener)` Hilfsmethode zum Erstellen eines Fehlerberichts und Protokollieren des Berichts für die Reporter.
`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 kehrt zurück, wenn der Befehl abgeschlossen ist und das Gerät für ADB nicht mehr sichtbar ist.
`void`	`postAdbRootAction()` Überschreiben, wenn auf dem Gerät nach dem Ausführen von „adb root“ und bevor das Gerät wieder online ist, bestimmte Aktionen ausgeführt werden müssen.
`void`	`postAdbUnrootAction()` Überschreiben, wenn auf dem Gerät nach dem Aufheben des Rootings über ADB und vor dem erneuten Onlinegehen des Geräts bestimmte Aktionen ausgeführt werden müssen.
`void`	`postBootSetup()` Führen Sie die Anleitung aus, um das Gerät nach jedem Booten für Tests zu konfigurieren.
`void`	`postInvocationTearDown(Throwable exception)` Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach dem Aufruf ausgeführt werden.
`void`	`preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)` Zusätzliche Schritte für die gerätespezifische Einrichtung, die auf dem Gerät vor dem Aufruf ausgeführt werden.
`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 Hilfsmethode zum Abrufen einer Datei aus dem externen Speicher des Geräts, die sie in einem lokalen temporären `ERROR(/File)` speichert und eine Referenz zu diesem `File` zurückgibt.
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` Verzeichnisinhalte rekursiv auf das Gerät übertragen, wobei einige Verzeichnisse, die gefiltert werden, ausgeschlossen 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 Contentanbieter berücksichtigt werden kann.
`boolean`	`pushFile(File localFile, String remoteFilePath)` Eine Datei auf ein Gerät übertragen
`boolean`	`pushFile(File localFile, String remoteFilePath, int userId)` Eine Datei auf ein Gerät übertragen
`boolean`	`pushString(String contents, String remoteFilePath)` Aus einem String erstellte Datei auf ein Gerät übertragen
`void`	`reboot(String reason)` Startet das Gerät im ADB-Modus neu. Der angegebene `reason` wird beim Neustart beibehalten.
`void`	`reboot()` Das Gerät wird im ADB-Modus neu gestartet.
`void`	`rebootIntoBootloader()` Das Gerät wird im Bootloader-Modus neu gestartet.
`void`	`rebootIntoFastbootd()` Das Gerät wird im fastbootd-Modus neu gestartet.
`void`	`rebootIntoRecovery()` Das Gerät wird im ADB-Wiederherstellungsmodus neu gestartet.
`void`	`rebootIntoSideload()` Das Gerät wird im ADB-Sideload-Modus neu gestartet. Das ist ein spezieller Modus unter „Recovery“. Wird blockiert, bis das Gerät in den Sideload-Modus wechselt
`void`	`rebootIntoSideload(boolean autoReboot)` Das Gerät wird im ADB-Sideload-Modus neu gestartet. Das ist ein spezieller Modus unter „Recovery“. Wird blockiert, bis das Gerät in den Sideload-Modus wechselt
`void`	`rebootUntilOnline()` Eine Alternative zu `reboot()`, die nur blockiert, bis das Gerät online ist, d. h. für ADB sichtbar ist.
`void`	`rebootUntilOnline(String reason)` Eine Alternative zu `reboot()`, die nur blockiert, bis das Gerät online ist, d. h. 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 Kommunikation mit dem Gerät wiederherzustellen.
`void`	`registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)` Registriert ein `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()` Machen Sie die Anbieterpartition auf dem Gerät schreibgeschützt.
`void`	`remountVendorWritable()` Machen Sie die Anbieterpartition auf dem Gerät beschreibbar.
`boolean`	`removeAdmin(String componentName, int userId)` Entfernt den angegebenen Geräteadministrator für den angegebenen Nutzer und gibt `true` zurück, wenn der Vorgang erfolgreich war, andernfalls `false`.
`void`	`removeOwners()` Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen.
`boolean`	`removeUser(int userId)` Einen bestimmten Nutzer vom Gerät entfernen.
`void`	`resetContentProviderSetup()` Setzen Sie das Flag für die Einrichtung des Content-Anbieters zurück, um es noch einmal auszulösen.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)` Bequeme Methode zum Ausführen von `ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))` mit einem oder mehreren Listenern, die als Parameter übergeben werden.
`boolean`	`runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)` Führt Instrumentierungstests aus und bietet die Möglichkeit zur Geräte-Wiederherstellung.
`boolean`	`runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)` Wie `ERROR(ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner, Collection))`, führt den Test jedoch für den angegebenen Nutzer aus.
`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`	`setAdbPath(String adbPath)` Legt den Pfad zum zu verwendenden ADB-Binärprogramm fest.
`void`	`setConfiguration(IConfiguration configuration)` Fügt die verwendete `IConfiguration` ein.
`final void`	`setConnectionAvdInfo(GceAvdInfo avdInfo)`
`void`	`setDate(Date date)` Legt das Datum auf dem Gerät fest Hinweis: Das Festlegen des Datums auf dem Gerät erfordert Root-Zugriff.
`boolean`	`setDeviceOwner(String componentName, int userId)` Legt eine Geräteadministrator-Komponente als Geräteinhaber für einen bestimmten Nutzer fest.
`void`	`setDeviceState(TestDeviceState deviceState)` Aktualisieren Sie den Gerätestatus.
`void`	`setEmulatorOutputStream(SizeLimitedOutputStream output)` Für den Emulator legen Sie `SizeLimitedOutputStream` auf die Logausgabe fest.
`void`	`setEmulatorProcess(Process p)` Legt die `Process` fest, wenn dieses Gerät ein Emulator ist.
`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 IDevice, das mit diesem ITestDevice verknüpft ist.
`void`	`setLogStartDelay(int delay)` Legt die Zeit in Millisekunden fest, die gewartet werden soll, bevor die Logcat-Erfassung für ein Onlinegerät gestartet wird.
`void`	`setOptions(TestDeviceOptions options)` `TestDeviceOptions` für das Gerät festlegen
`boolean`	`setProperty(String propKey, String propValue)` Legt den angegebenen Eigenschaftswert 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)` Legt den aktuellen Wiederherstellungsmodus fest, der für das Gerät verwendet werden soll.
`void`	`setSetting(String namespace, String key, String value)` Weitere Informationen finden Sie unter `setSetting(int, String, String, String)`.
`void`	`setSetting(int userId, String namespace, String key, String value)` Fügen Sie dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzu.
`void`	`setTestLogger(ITestLogger testLogger)` Fügt die `ITestLogger`-Instanz ein.
`void`	`setTrackingSerial(String trackingSerial)` Zur Geräteverwaltung wird die Seriennummer erfasst, die wir zur Referenzierung des Geräts verwenden.
`void`	`setUseFastbootErase(boolean useFastbootErase)` Legen Sie fest, ob zum Löschen einer Partition auf dem Gerät „fastboot erase“ oder „fastboot format“ verwendet werden soll.
`void`	`startLogcat()` Logcat-Ausgabe vom Gerät im Hintergrund erfassen.
`boolean`	`startTradeInModeTesting(int timeoutMs)` Testmodus für Inzahlungnahme aktivieren
`boolean`	`startUser(int userId)` Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit beendet ist.
`boolean`	`startUser(int userId, boolean waitFlag)` Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit beendet ist.
`boolean`	`startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)` Startet einen bestimmten Nutzer im Hintergrund, der auf dem angegebenen Display sichtbar ist (d.h. der Nutzer kann Aktivitäten auf diesem Display starten).
`void`	`stopEmulatorOutput()` Schließen Sie die Emulatorausgabe und löschen Sie sie.
`void`	`stopLogcat()` Die Erfassung der Logcat-Ausgabe vom Gerät wird beendet und die aktuell gespeicherten Logcat-Daten werden verworfen.
`void`	`stopTradeInModeTesting()` Test des Eintauschmodus beenden
`boolean`	`stopUser(int userId)` Stoppt einen bestimmten Nutzer.
`boolean`	`stopUser(int userId, boolean waitFlag, boolean forceFlag)` Einen bestimmten Nutzer stoppen.
`String`	`switchToAdbTcp()` Gerät in den ADB-over-TCP-Modus versetzen.
`boolean`	`switchToAdbUsb()` Schalten Sie das Gerät in den ADB-über-USB-Modus.
`boolean`	`switchUser(int userId)` Wechseln Sie mit einem Standard-Timeout zu einer anderen userId.
`boolean`	`switchUser(int userId, long timeout)` Wechseln Sie innerhalb des angegebenen Zeitlimits zu einer anderen Nutzer-ID.
`boolean`	`syncFiles(File localFileDir, String deviceFilePath)` Synchronisiert den Inhalt eines lokalen Dateiverzeichnisses inkrementell mit dem Gerät.
`Bugreport`	`takeBugreport()` Erstellt einen Fehlerbericht und gibt ihn in einem `Bugreport`-Objekt zurück, um ihn zu verarbeiten.
`String`	`uninstallPackage(String packageName)` Ein Android-Paket vom Gerät deinstallieren.
`String`	`uninstallPackageForUser(String packageName, int userId)` Deinstalliert ein Android-Paket für einen bestimmten Nutzer von einem Gerät.
`boolean`	`unlockDevice()` Entsperrt das Gerät, wenn es verschlüsselt ist.
`void`	`unmountDebugfs()` debugfs unmounten.
`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 Tests verfügbar ist.
`boolean`	`waitForDeviceAvailable(long waitTime)` Wartet, bis das Gerät reagiert und für Tests 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()` Wird blockiert, bis das Gerät über Fastboot sichtbar ist.
`void`	`waitForDeviceFastbootD()`
`boolean`	`waitForDeviceInRecovery(long waitTime)` Sperrt das Gerät, wenn es sich im Status „adb recovery“ befindet. Dieser Status unterscheidet sich von `IDeviceRecovery`.
`boolean`	`waitForDeviceInSideload(long waitTime)` Blockiert, 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. in ADB fehlt.
`void`	`waitForDeviceOnline()` Wird blockiert, bis das Gerät über ADB sichtbar ist.
`void`	`waitForDeviceOnline(long waitTime)` Wird 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 ein `RebootDeviceAction`, das 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 zum Auslösen einer Ausnahme, wenn die Laufzeitberechtigung nicht unterstützt wird
`int`	`getApiLevelSafe()`
`ITestLogger`	`getLogger()`
`IRunUtil`	`getRunUtil()` Rufen Sie die zu verwendende `RunUtil`-Instanz ab.
`String`	`internalGetProperty(String propName, String fastbootVar, String description)` Ruft eine Geräteeigenschaft ab, standardmäßig aus dem ddmlib-Cache, und greift entweder auf „adb shell getprop“ oder „fastboot getvar“ zurück, je nachdem, ob sich das Gerät im Fastboot-Modus befindet oder nicht.
`boolean`	`isInRebootCallback()` Gibt zurück, ob Rückrufe für den Neustart gerade ausgeführt werden.
`boolean`	`isNewer(File localFile, IFileEntry entry)` Gibt `true` zurück, wenn die lokale Datei neuer als die Remotedatei ist.
`void`	`notifyRebootEnded()` Benachrichtigt alle `IDeviceActionReceiver` über das Ende des Neustarts.
`void`	`notifyRebootStarted()` Benachrichtigt alle `IDeviceActionReceiver` über das Start-Event für den Neustart.
`boolean`	`performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)` Führt eine Aktion auf diesem Gerät aus.
`void`	`postAdbReboot(NativeDevice.RebootMode rebootMode)` 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 Booten zu überschreiben.
`boolean`	`pullFileInternal(String remoteFilePath, File localFile)`
`void`	`setClock(Clock clock)` Legen Sie die zu verwendende Clock-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 gesendet werden).

Konstanten

DEBUG_PATH

public static final String DEBUGFS_PATH

Konstanter Wert: "/sys/kernel/debug"

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: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

Konstanter Wert: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

Die Standardanzahl der Wiederholungsversuche für Befehle

Konstanter Wert: 2 (0x00000002)

SD_CARD

protected static final String SD_CARD

Konstanter Wert: "/sdcard/"

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

Konstanter Wert: "/storage/emulated/"

Felder

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Öffentliche Konstruktoren

NativeDevice

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

Erstellt ein TestDevice.

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

Öffentliche Methoden

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Mikrooptimierung (ca. 400 Millisekunden) durch Vorabrufen aller benötigten Attribute anstatt „adb getprop“ für jedes Attribut aufzurufen. Das heißt, es ist genauso schnell, alle Attribute abzurufen wie nur eines. Funktionen wie device.getApiLevel(), checkApiLevelAgainstNextRelease und getBuildAlias rufen im Hintergrund alle `adb getprop` auf. Wir rufen sie in einem Aufruf ab und rufen NativeDevice.setProperty auf. Auch wenn wir das nicht tun, ruft NativeDevice selbst „setProperty“ auf und speichert das Ergebnis für zukünftige Aufrufe im Cache. Wir machen es nur etwas früher. Wenn sich das Gerät im Wiederherstellungsmodus befindet oder beim Abrufen der Eigenschaften andere Fehler auftreten, werden diese einfach ignoriert.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Gibt zurück, ob der Wechsel zum monitorlosen SYSTEM-Nutzer zulässig ist.

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

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

Ausgabe
`DeviceNotAvailableException`

checkConnectivity

public boolean checkConnectivity ()

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

Returns
`boolean`	`true`, wenn das Gerät über eine funktionierende Netzwerkverbindung verfügt, `false` andernfalls.

Ausgabe
`DeviceNotAvailableException`

clearErrorDialogs

public boolean clearErrorDialogs ()

Schließen Sie alle Fehlerdialogfelder, die derzeit auf der Geräte-UI angezeigt werden.

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

Ausgabe
`DeviceNotAvailableException`

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

Löscht das zuletzt verbundene WLAN. Diese Methode sollte beim Starten eines neuen Aufrufs aufgerufen werden, um zu vermeiden, 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.

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

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Verbindung zu einem WLAN herstellen

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

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

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

Ausgabe
`DeviceNotAvailableException`

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Verbindung zu einem WLAN herstellen

Aktiviert WLAN und blockiert, bis eine Verbindung zum angegebenen WLAN hergestellt wurde. Sobald eine Verbindung hergestellt wurde, versucht die Instanz, die Verbindung nach jedem Neustart 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)

Verbindung zu einem WLAN herstellen

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

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

Ausgabe
`DeviceNotAvailableException`

connectToWifiNetwork

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

Verbindung zu einem WLAN herstellen

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 für dieses Netzwerk nach verborgenen SSIDs 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 eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.

Parameter
`scanSsid`	`boolean`: Gibt an, ob für dieses Netzwerk nach einer verborgenen SSID 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 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)

Erstelle einen Nutzer mit einem bestimmten Namen und den angegebenen Flags.

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

Returns
`int`	ID des erstellten Nutzers

Ausgabe
`DeviceNotAvailableException`

createUser

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

Erstelle einen Nutzer mit einem bestimmten Namen und den angegebenen Flags.

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

Returns
`int`	ID des erstellten Nutzers

Ausgabe
`DeviceNotAvailableException`

createUser

public int createUser (String name)

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

Erstellt 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 oder -1 bei einem Fehler.

Ausgabe
`DeviceNotAvailableException`

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

Ein Gerät prüfen und detaillierte Informationen zurückgeben, wenn ein Gerät nicht mehr 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, die 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 zum Prüfen, ob das Gerät durch Vergleich des aktuellen system_server mit dem vorherigen system_server ProcessInfo neu gestartet wurde. Verwende getProcessByName(String) als Zahlungsmethode, um ProcessInfo zu erhalten.

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

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

Ausgabe
`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 seinem ERROR(/TimeUnit) neu gestartet wurde. Ein Soft-Restart bezieht sich auf einen Neustart von system_server außerhalb eines Hard-Reboot des Geräts (z. B. ein angeforderter Neustart). Die aktuelle utcEpochTime des Geräts in Millisekunden kann mit der Methode getDeviceDate() abgerufen werden.

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

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

Ausgabe
`DeviceNotAvailableException`

disableAdbRoot

public boolean disableAdbRoot ()

Deaktiviert „adb root“.

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

Returns
`boolean`	`true`, falls erfolgreich.

Ausgabe
`DeviceNotAvailableException`

disableKeyguard

public void disableKeyguard ()

Es wird versucht, den Keyguard zu deaktivieren.

Warten Sie zuerst, bis die Eingabeübermittlung bereit ist. Das passiert ungefähr zur selben Zeit, zu der das Gerät BOOT_COMPLETE meldet. Das geschieht anscheinend asynchron, da die aktuelle Framework-Implementierung gelegentlich Race-Bedingungen aufweist. Anschließend wird der Befehl zum Schließen des Keyguards gesendet (funktioniert nur bei nicht sicheren Keyguards).

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

Die Verbindung zu einem WLAN wird getrennt.

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

Returns
`boolean`	`true`, wenn die Verbindung zum WLAN getrennt wurde. `false` wenn das Trennen der Verbindung fehlgeschlagen ist.

Ausgabe
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Hilfsmethode, um festzustellen, 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 der die Dateiexistenz geprüft werden soll.

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

Ausgabe
`DeviceNotAvailableException`

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

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

Ausgabe
`DeviceNotAvailableException`

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Versuchen Sie, den Heap aus dem system_server zu sichern. Der Aufrufer ist für das Bereinigen der gesicherten Datei verantwortlich.

Parameter
`process`	`String`: Der Name des Geräteprozesses, für den „dumpheap“ ausgeführt werden soll.
`devicePath`	`String`: Der Pfad auf dem Gerät, unter dem der Dump abgelegt werden soll. Dies muss ein Ort sein, an dem dies gemäß den Berechtigungen zulässig ist.

Returns
`File`	`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“ gesetzt ist, wird eine Meldung protokolliert und die Funktion wird beendet, ohne Root zu aktivieren.

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

Returns
`boolean`	`true`, falls erfolgreich.

Ausgabe
`DeviceNotAvailableException`

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.

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

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

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

Ausgabe
`DeviceNotAvailableException`

executeAdbCommand

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

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

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

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

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

Ausgabe
`DeviceNotAvailableException`

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

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

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

Ausgabe
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (String... cmdArgs)

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

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

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

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

Ausgabe
`DeviceNotAvailableException`

executeAdbV2Command

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

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

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

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

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

Ausgabe
`DeviceNotAvailableException`

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                 envMap, 
                String... cmdArgs)

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

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

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

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

Ausgabe
`DeviceNotAvailableException`

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

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

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

Returns
`CommandResult`	Das CommandResult mit der Ausgabe des Befehls

Ausgabe
`DeviceNotAvailableException`

executeFastbootCommand

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

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

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

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

Returns
`CommandResult`	Das CommandResult mit der Ausgabe des Befehls

Ausgabe
`DeviceNotAvailableException`

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

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

Returns
`CommandResult`	Das CommandResult mit der Ausgabe des Befehls

Ausgabe
`DeviceNotAvailableException`

executeLongFastbootCommand

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

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

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

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

Returns
`CommandResult`	Das CommandResult mit der Ausgabe des Befehls

Ausgabe
`DeviceNotAvailableException`

executeShellCommand

public String executeShellCommand (String command)

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

Parameter
`command`	`String`: der auszuführende ADB-Shell-Befehl

Returns
`String`	die Shell-Ausgabe

Ausgabe
`DeviceNotAvailableException`

executeShellCommand

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

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

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

Ausgabe
`DeviceNotAvailableException`

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 zur Steuerung des Befehlsverhaltens aus.

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

Ausgabe
`DeviceNotAvailableException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

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

Ausgabe
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

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

Parameter
`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 mit der Befehlsstatusausgabe und stderr gefüllt ist. stdout wird an den angegebenen Stream weitergeleitet.

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

Returns
`CommandResult`	Das Ergebnis in `CommandResult`.

Ausgabe
`DeviceNotAvailableException`

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

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

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

Returns
`CommandResult`	Das Ergebnis in `CommandResult`.

Ausgabe
`DeviceNotAvailableException`

executeShellV2Command

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

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

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

Returns
`CommandResult`

Ausgabe
`DeviceNotAvailableException`

executeShellV2Command

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

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

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

Returns
`CommandResult`

Ausgabe
`DeviceNotAvailableException`

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 zur Steuerung des Befehlsverhaltens aus.

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

Returns
`CommandResult`

Ausgabe
`DeviceNotAvailableException`

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 zur Steuerung des Befehlsverhaltens aus.

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

Returns
`CommandResult`

Ausgabe
`DeviceNotAvailableException`

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

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

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

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

Returns
`CommandResult`	Das CommandResult mit der Ausgabe des Befehls

Ausgabe
`DeviceNotAvailableException`

getActiveApexes

public  getActiveApexes ()

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

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

Ausgabe
`DeviceNotAvailableException`

getAdbPath

public String getAdbPath ()

Gibt den Pfad der verwendeten ADB-Binärdatei zurück.

Returns
`String`

getAllSettings

public  getAllSettings (String namespace)

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

Parameter
`namespace`	`String`: Muss einer der folgenden Werte 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)

Sucht die Android-ID, die einem Nutzer zugeordnet ist, und gibt sie zurück. Wenn sie nicht gefunden wird, wird „null“ zurückgegeben.

Parameter
`userId`	`int`

Returns
`String`

Ausgabe
`DeviceNotAvailableException`

getAndroidIds

public  getAndroidIds ()

Erstellen Sie eine Zuordnung von Android-IDs zu übereinstimmenden User-IDs. Es gibt keine Garantie, dass für jede User-ID eine zugehörige Android-ID gefunden wird. Daher kann es vorkommen, dass einige User-IDs mit „null“ übereinstimmen.

Returns
	Karte der Android-IDs, die mit Nutzer-IDs übereinstimmen.

Ausgabe
`DeviceNotAvailableException`

getApiLevel

public int getApiLevel ()

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

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

Ausgabe
`DeviceNotAvailableException`

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Informationen zu einem auf dem Gerät installierten Paket abrufen.

Parameter
`packageName`	`String`

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

Ausgabe
`DeviceNotAvailableException`

getAppPackageInfos

public  getAppPackageInfos ()

Informationen zu auf dem Gerät installierten Paketen abrufen.

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

Ausgabe
`DeviceNotAvailableException`

getBasebandVersion

public String getBasebandVersion ()

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

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

Ausgabe
`DeviceNotAvailableException`

getBattery

public Integer getBattery ()

Gibt den aktuellen Akkustand eines Geräts oder „Null“ zurück, 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 die Property leer ist oder nicht vorhanden ist.

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

Ausgabe
`DeviceNotAvailableException`

getBootHistory

public  getBootHistory ()

Die Hilfsmethode erfasst die Bootverlaufskarte mit Bootzeit und Bootgrund.

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

Ausgabe
`DeviceNotAvailableException`

getBootHistorySince

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

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

Ausgabe
`DeviceNotAvailableException`

getBootloaderVersion

public String getBootloaderVersion ()

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

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

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

Ausgabe
`DeviceNotAvailableException`

getBugreport

public InputStreamSource getBugreport ()

Ruft einen Fehlerbericht vom Gerät ab.

Die Implementierung dieser Funktion funktioniert garantiert auch auf Geräten ohne SD-Karte (oder wenn die SD-Karte noch nicht eingebunden ist).

Returns
`InputStreamSource`	Ein `InputStreamSource`, das die Inhalte des Fehlerberichts auf Anfrage generiert. Im Fehlerfall gibt `InputStreamSource` eine leere `ERROR(/InputStream)` zurück.

getBugreportz

public InputStreamSource getBugreportz ()

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

Wird nur für „adb version“ > 1.0.36 unterstützt.

Returns
`InputStreamSource`	`InputStreamSource` der ZIP-Datei mit den Fehlerberichten. Bei einem Fehler wird „null“ zurückgegeben.

getBuildAlias

public String getBuildAlias ()

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

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

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

Ausgabe
`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 derzeit auf dem Gerät ausgeführt wird.

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

Ausgabe
`DeviceNotAvailableException`

getBuildSigningKeys

public String getBuildSigningKeys ()

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

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

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`: Gibt an, ob der Deskriptor auf die Mindestinformationen beschränkt werden soll.

Returns
`DeviceDescriptor`

getChildren

public String[] getChildren (String path)

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

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

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

Ausgabe
`DeviceNotAvailableException`

getConnection

public AbstractConnection getConnection ()

Die aktuelle Verbindung des Geräts.

Returns
`AbstractConnection`

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

Gibt ContentProviderHandler zurück oder „null“, wenn nicht verfügbar.

Der Content-Anbieter kann wiederverwendet werden, wenn er zuvor mit demselben 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 Status des faltbaren Geräts zurück oder „null“, wenn Probleme aufgetreten sind.

Returns
`DeviceFoldableState`

Ausgabe
`DeviceNotAvailableException`

getCurrentUser

public int getCurrentUser ()

Gibt die ID des aktuell ausgeführten Nutzers zurück. Im Fehlerfall wird -10000 zurückgegeben.

Returns
`int`

Ausgabe
`DeviceNotAvailableException`

getDeviceClass

public String getDeviceClass ()

Geräteklasse abrufen

Returns
`String`	die 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 ()

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

Returns
`DeviceDescriptor`

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

Returns
`DeviceDescriptor`

getDeviceState

public TestDeviceState getDeviceState ()

Gerätestatus abrufen

Returns
`TestDeviceState`

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

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

Parameter
`date`	`Date`

Returns
`long`	die Differenz in Millisekunden

Ausgabe
`DeviceNotAvailableException`

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

Stream von Emulator-stdout und -stderr abrufen

Returns
`InputStreamSource`	Emulatorausgabe

getEmulatorProcess

public Process getEmulatorProcess ()

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

Returns
`Process`	`Process` oder `null`

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

Das Log, das alle executeShellCommand(String)-Logs enthält.

Returns
`File`

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

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

Returns
`long`	die Menge an freiem Speicherplatz in KB

Ausgabe
`DeviceNotAvailableException`

getFastbootPath

public String getFastbootPath ()

Gibt den Pfad der verwendeten Fastboot-Binärdatei zurück. isFastbootEnabled() muss weiterhin „true“ sein, damit Fastboot-Funktionen aktiviert sind.

Returns
`String`

getFastbootProductType

public String getFastbootProductType ()

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

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

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

Ausgabe
`DeviceNotAvailableException`

getFastbootProductVariant

public String getFastbootProductVariant ()

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

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

Ausgabe
`DeviceNotAvailableException`

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Gibt die Seriennummer im Fastboot-Modus zurück.

Returns
`String`

getFastbootVariable

public String getFastbootVariable (String variableName)

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

Parameter
`variableName`	`String`: der Variablenname

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

Ausgabe
`DeviceNotAvailableException`

getFastbootVersion

public String getFastbootVersion ()

Gibt den Versionsstring der verwendeten Fastboot-Binärdatei zurück. Oder „null“, wenn etwas schiefgeht.

Returns
`String`

getFileEntry

public IFileEntry getFileEntry (String path)

Eine Referenz auf eine Remotedatei auf dem Gerät abrufen

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

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

Ausgabe
`DeviceNotAvailableException`

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

Inoffizieller Helfer zum Abrufen eines FileEntry aus einem Nicht-Root-Pfad. FIXME: Das FileEntry-System muss so umgestaltet werden, dass es von jedem Pfad aus verfügbar ist. (auch ohne Root-Zugriff).

Parameter
`entry`	`FileListingService.FileEntry`: ein `FileEntry`, das nicht unbedingt das Stammverzeichnis sein muss, wie es für Ddmlib erforderlich ist.

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

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

getFoldableStates

public  getFoldableStates ()

Gibt die Liste der faltbaren Status auf dem Gerät 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 ein neuer IDevice zugewiesen werden. Anrufer sollten daher keinen Verweis auf IDevice beibehalten, da dieser Verweis möglicherweise veraltet ist.

Returns
`IDevice`	die `IDevice`

getInstalledPackageNames

public  getInstalledPackageNames ()

Ruft die Paketnamen der auf dem Gerät vorhandenen Anwendungen 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 des Geräts zurück.

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

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

Ausgabe
`DeviceNotAvailableException`

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

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

Returns
`KeyguardControllerState`	ein `KeyguardControllerState` mit einem Snapshot des Status des Keyguard zurückgegeben. Wenn die Keyguard-Abfrage nicht unterstützt wird, wird „Null“ zurückgegeben.

Ausgabe
`DeviceNotAvailableException`

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

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

Returns
`long`

getLaunchApiLevel

public int getLaunchApiLevel ()

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

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

Ausgabe
`DeviceNotAvailableException`

getLogcat

public InputStreamSource getLogcat ()

Erstellt einen Snapshot-Stream der Logcat-Daten.

Funktioniert in zwei Modi:

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

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

Returns
`InputStreamSource`

getLogcat

public InputStreamSource getLogcat (int maxBytes)

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

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

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

Returns
`InputStreamSource`

getLogcatDump

public InputStreamSource getLogcatDump ()

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

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

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

getLogcatSince

public InputStreamSource getLogcatSince (long date)

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

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

Returns
`InputStreamSource`

getMacAddress

public String getMacAddress ()

Gibt die MAC-Adresse des Geräts zurück. Wenn die Abfrage des Geräts 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 ()

Ruft Informationen zu den auf dem Gerät installierten Mainline-Modulen ab.

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

Ausgabe
`DeviceNotAvailableException`

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

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

Returns
`int`	Eine Ganzzahl, die die Anzahl der gleichzeitig aktiven Nutzer angibt

Ausgabe
`DeviceNotAvailableException`

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

Maximale Anzahl der unterstützten Nutzer 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 die mit dem Gerät verknüpfte IDeviceStateMonitor zurück.

Returns
`IDeviceStateMonitor`

getMountPoint

public String getMountPoint (String mountName)

Gibt einen Bereitstellungspunkt zurück.

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

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

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

Returns
`String`	den Bereitstellungspunkt oder `null`

getMountPointInfo

public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

Parameter
`mountpoint`	`String`

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

Ausgabe
`DeviceNotAvailableException`

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

Ruft die Testoptionen für das Gerät ab.

Returns
`TestDeviceOptions`	`TestDeviceOptions` in Bezug auf das zu testende Gerät.

getPartitionFreeSpace

public long getPartitionFreeSpace (String partition)

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

Parameter
`partition`	`String`

Returns
`long`	die Menge an freiem Speicherplatz in KB

Ausgabe
`DeviceNotAvailableException`

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 das ProcessInfo-Objekt mit der PID und der Startzeit des angegebenen Prozesses zurück.

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

Returns
`ProcessInfo`	ProcessInfo des angegebenen processName

Ausgabe
`DeviceNotAvailableException`

getProcessPid

public String getProcessPid (String process)

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

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

Returns
`String`

Ausgabe
`DeviceNotAvailableException`

getProductType

public String getProductType ()

Bequeme Methode zum Abrufen des Produkttyps dieses Geräts.

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

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

Ausgabe
`DeviceNotAvailableException`

getProductVariant

public String getProductVariant ()

Bequeme Methode zum Abrufen der Produktvariante dieses Geräts.

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

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

Ausgabe
`DeviceNotAvailableException`

getProperty

public String getProperty (String name)

Ruft den angegebenen Attributwert vom Gerät ab.

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

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

Ausgabe
`DeviceNotAvailableException`

getRecoveryMode

public ITestDevice.RecoveryMode getRecoveryMode ()

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

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

getScreenshot

public InputStreamSource getScreenshot (long displayId)

Erstellt einen Screenshot des Geräts mit der angegebenen Anzeige-ID. Das Format ist PNG.

AUFGABE: Die Implementierungen oben müssen erweitert werden, um „format“ und „rescale“ zu unterstützen.

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

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

Ausgabe
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot (String format)

Erstellt einen Screenshot vom Gerät. Es wird empfohlen, stattdessen „getScreenshot(format)“ mit JPEG-Codierung zu verwenden, um die Größe zu verringern.

Parameter
`format`	`String`: Unterstützte PNG- und JPEG-Dateien

Returns
`InputStreamSource`	`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 vom Gerät. Wir empfehlen, stattdessen getScreenshot(String) mit JPEG-Codierung zu verwenden, um die Größe zu verringern.

Parameter
`format`	`String`: Unterstützte PNG- und JPEG-Dateien
`rescale`	`boolean`: Gibt an, ob der Screenshot skaliert werden soll, um die Größe des resultierenden Bildes zu verringern.

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

Ausgabe
`DeviceNotAvailableException`

getScreenshot

public InputStreamSource getScreenshot ()

Erstellt einen Screenshot vom Gerät.

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

Ausgabe
`DeviceNotAvailableException`

getSerialNumber

public String getSerialNumber ()

Bequeme Methode zum Abrufen der Seriennummer dieses Geräts.

Returns
`String`	die Seriennummer `String`

getSetting

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

Gibt den Wert der angeforderten Einstellung zurück. Der Namespace muss einer der folgenden Werte sein: {"system", "secure", "global"}

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

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

Ausgabe
`DeviceNotAvailableException`

getSetting

public String getSetting (String namespace, 
                String key)

Weitere Informationen finden Sie unter getSetting(int, String, String).

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

Returns
`String`

Ausgabe
`DeviceNotAvailableException`

getSimOperator

public String getSimOperator ()

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

Returns
`String`

getSimState

public String getSimState ()

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

Returns
`String`

getTombstones

public  getTombstones ()

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

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

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

Ausgabe
`DeviceNotAvailableException`

getTotalMemory

public long getTotalMemory ()

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

Returns
`long`

getTrackingSerial

public String getTrackingSerial ()

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

Returns
`String`

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Ruft die Paketnamen der Anwendungen ab, die deinstalliert werden können. Derzeit sind das Nicht-Systempakete und aktualisierte Systempakete.

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

Ausgabe
`DeviceNotAvailableException`

getUseFastbootErase

public boolean getUseFastbootErase ()

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

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

getUserFlags

public int getUserFlags (int userId)

Sucht die Flags eines bestimmten Nutzers und gibt sie zurück. Flags werden in der Klasse „android.content.pm.UserInfo“ im Open-Source-Projekt für Android definiert.

Parameter
`userId`	`int`

Returns
`int`	Die mit der angegebenen userId verknüpften Flags, falls vorhanden, andernfalls -10000.

Ausgabe
`DeviceNotAvailableException`

getUserInfos

public  getUserInfos ()

Ruft die Zuordnung von useId zu UserInfo auf dem Gerät ab. Löst DeviceRuntimeException aus, 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 dem userId zugeordnete Seriennummer zurück, falls gefunden, andernfalls -10000.

Parameter
`userId`	`int`

Returns
`int`

Ausgabe
`DeviceNotAvailableException`

handleAllocationEvent

public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

Verarbeite das angegebene DeviceEvent. Kann das Gerät in einen neuen Status versetzen. Informiert IDeviceMonitor über alle Statusübergänge.

Verarbeite das DeviceEvent. Dadurch wird das Gerät möglicherweise in einen neuen Zuweisungsstatus versetzt.

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 das Feature gefunden wird, andernfalls „false“.

Ausgabe
`DeviceNotAvailableException`

initializeConnection

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

Stellen Sie die Verbindung zum Gerät her. Diese Methode wird von „preInvocationSetup“ aufgerufen, muss aber in seltenen Fällen möglicherweise separat aufgerufen werden, wenn die Verbindung während der Geräteeinrichtung erstellt wird.

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

Ausgabe
`DeviceNotAvailableException`
`TargetSetupError`

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. Verfügbare 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 für Anwendungsfälle aufgerufen werden, die eine explizite Steuerung der Erteilung der Laufzeitberechtigung bei der Installation erfordern.

Parameter
`packageFile`	`File`: die zu installierende APK-Datei
`reinstall`	`boolean`: `true`, wenn eine Neuinstallation durchgeführt werden soll
`grantPermissions`	`boolean`: Gibt an, ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen.
`extraArgs`	`String`: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare 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 Sie ein Android-Paket auf einem 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 Nutzer-ID als Ganzzahl, für die die Installation erfolgen soll.
`extraArgs`	`String`: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare 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 Sie ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.

Hinweis: Diese Funktion sollte nur für Anwendungsfälle aufgerufen werden, die eine explizite Steuerung der Erteilung der Laufzeitberechtigung bei der Installation erfordern.

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

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

Ausgabe
`DeviceNotAvailableException`

installPackageWithIncrementalMode

public boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

Installiert APKs im inkrementellen Modus.

Parameter
`apkFiles`	`File`: die zu installierenden APK-Dateien.
`extraArgs`	`String`
`userId`	`String`

Returns
`boolean`

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 das Umgehen der Blockierung von App-Installationen aufgrund eines niedrigen Ziel-SDK unterstützt

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

Ausgabe
`DeviceNotAvailableException`

isDebugfsMounted

public boolean isDebugfsMounted ()

Prüfen Sie, ob debugfs gemountet ist.

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

Ausgabe
`DeviceNotAvailableException`

isDeviceEncrypted

public boolean isDeviceEncrypted ()

Gibt zurück, 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`, wenn „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 ()

Gibt zurück, ob Fastboot für das Gerät verfügbar ist.

Returns
`boolean`

isHeadless

public boolean isHeadless ()

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

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Gibt zurück, ob auf dem Gerät der monitorlose Systemnutzermodus verwendet wird.

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

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

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isMultiUserSupported

public boolean isMultiUserSupported ()

Gibt an, ob mehrere Nutzer unterstützt werden.

Returns
`boolean`	„true“, wenn die Funktion für mehrere Nutzer unterstützt wird, andernfalls „false“

Ausgabe
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

Fragen Sie das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID ab, um zu prüfen, ob die App für diesen Nutzer derzeit installiert ist.

Parameter
`packageName`	`String`: Das Paket, für das wir prüfen, ob es installiert ist.
`userId`	`String`: Die Nutzer-ID, für die wir prüfen, ob das Paket installiert ist. Wenn null, wird der primäre Nutzer 0 verwendet.

Returns
`boolean`	„True“, wenn das Paket als installiert gemeldet wird. ansonsten „falsch“.

Ausgabe
`DeviceNotAvailableException`

isPackageInstalled

public boolean isPackageInstalled (String packageName)

Fragen Sie das Gerät nach einem bestimmten Paketnamen, um zu prüfen, ob das Paket derzeit installiert ist.

Parameter
`packageName`	`String`

Returns
`boolean`	„True“, wenn das Paket als installiert gemeldet wird. ansonsten „falsch“.

Ausgabe
`DeviceNotAvailableException`

isRuntimePermissionSupported

public boolean isRuntimePermissionSupported ()

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

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

Ausgabe
`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 zurück, ob der angegebene Nutzer anhand seiner 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 Launch-Aktivitäten (in der Regel auf dem Standarddisplay) starten kann.

Parameter
`userId`	`int`

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

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

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Gibt zurück, ob Nutzer auf dem Gerät im Hintergrund in ERROR(/java.android.view.Display#DEFAULT_DISPLAY) sichtbar sein können.

Wenn das der Fall ist, können Sie startVisibleBackgroundUser(int, int, boolean) aufrufen und ein von listDisplayIdsForStartingVisibleBackgroundUsers() zurückgegebenes Display übergeben, das ERROR(/java.android.view.Display#DEFAULT_DISPLAY) enthalten sollte.

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

Gibt zurück, ob Nutzer im Hintergrund sichtbar gestartet werden dürfen.

Wenn dies der Fall ist, können Sie startVisibleBackgroundUser(int, int, boolean) aufrufen und ein von listDisplayIdsForStartingVisibleBackgroundUsers() zurückgegebenes Display übergeben.

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

isWifiEnabled

public boolean isWifiEnabled ()

Prüfen, ob WLAN aktiviert ist.

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

Returns
`boolean`	`true`, wenn WLAN aktiviert ist. `false`, falls 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. „Default“ gibt immer das Standarddisplay 0 zurück.

Ausgabe
`DeviceNotAvailableException`

listDisplayIdsForStartingVisibleBackgroundUsers

public  listDisplayIdsForStartingVisibleBackgroundUsers ()

Ruft die Liste der Displays ab, 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. Löst DeviceRuntimeException aus, 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 ANR-Fehler vom Gerät.

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

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

Ausgabe
`DeviceNotAvailableException`

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Hilfsmethode zum Erstellen eines Fehlerberichts und Protokollieren des Berichts für die Reporter.

Parameter
`dataName`	`String`: Der Name, unter dem der Fehlerbericht gemeldet wird.
`listener`	`ITestLogger`: eine `ITestLogger` zum Protokollieren des Fehlerberichts.

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 keine Ausnahme auslöst, wenn die Protokollierung fehlschlägt.

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

mountDebugfs

public void mountDebugfs ()

debugfs bereitstellen.

Ausgabe
`DeviceNotAvailableException`

nonBlockingReboot

public void nonBlockingReboot ()

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

Ausgabe
`DeviceNotAvailableException`

postAdbRootAction

public void postAdbRootAction ()

Überschreiben, wenn auf dem Gerät nach dem Ausführen von „adb root“ und bevor das Gerät wieder online ist, bestimmte Aktionen ausgeführt werden müssen. Die Standardimplementierung umfasst 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, wenn auf dem Gerät nach dem Aufheben des Rootings über ADB und vor dem erneuten Onlinegehen des Geräts bestimmte Aktionen ausgeführt werden müssen. Die Standardimplementierung umfasst keine zusätzlichen Aktionen. Es ist nicht garantiert, dass „adb root“ in dieser Phase deaktiviert wird.

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

postBootSetup

public void postBootSetup ()

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

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

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

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

Ausgabe
`DeviceNotAvailableException`

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

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

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

preInvocationSetup

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

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

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

Ausgabe
`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 übertragen werden sollen
`userId`	`int`: die Nutzer-ID, aus der die Daten abgerufen werden sollen

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

Ausgabe
`DeviceNotAvailableException`

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 übertragen werden sollen

Returns
`boolean`	`true`, wenn die Datei 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 Inhalte gespeichert werden sollen. Wenn sie nicht leer ist, wird der Inhalt ersetzt.

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

Ausgabe
`DeviceNotAvailableException`

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 (einschließlich 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 (einschließlich 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 Inhalte gespeichert werden sollen. Wenn das Feld nicht leer ist, wird der Inhalt ersetzt.
`userId`	`int`: Die Nutzer-ID, aus der Daten abgerufen werden sollen

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

Ausgabe
`DeviceNotAvailableException`

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 (einschließlich Problemen mit dem Hostdateisystem)

Ausgabe
`DeviceNotAvailableException`

pullFileFromExternal

public File pullFileFromExternal (String remoteFilePath)

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

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

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

Ausgabe
`DeviceNotAvailableException`

pushDir

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

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

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

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

Ausgabe
`DeviceNotAvailableException`

pushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath)

Verzeichnisinhalte rekursiv auf das Gerät übertragen.

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

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

Ausgabe
`DeviceNotAvailableException`

pushDir

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

Verzeichnisinhalte rekursiv auf das Gerät übertragen.

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

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

Ausgabe
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath, 
                boolean evaluateContentProviderNeeded)

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

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

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

Ausgabe
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File localFile, 
                String remoteFilePath)

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

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

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

Ausgabe
`DeviceNotAvailableException`

pushFile

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

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

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

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

Ausgabe
`DeviceNotAvailableException`

pushString

public boolean pushString (String contents, 
                String remoteFilePath)

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

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

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

Ausgabe
`DeviceNotAvailableException`

neu starten

public void reboot (String reason)

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

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

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

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

Ausgabe
`DeviceNotAvailableException`

neu starten

public void reboot ()

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

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

Ausgabe
`DeviceNotAvailableException`

rebootIntoBootloader

public void rebootIntoBootloader ()

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

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

Ausgabe
`DeviceNotAvailableException`

rebootIntoFastbootd

public void rebootIntoFastbootd ()

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

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

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

Ausgabe
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload ()

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

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

Ausgabe
`DeviceNotAvailableException`

rebootIntoSideload

public void rebootIntoSideload (boolean autoReboot)

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

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

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

Ausgabe
`DeviceNotAvailableException`

rebootUntilOnline

public void rebootUntilOnline ()

Eine Alternative zu reboot(), die nur blockiert, bis das Gerät online ist, d. h. 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, d. h. für ADB sichtbar ist.

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

Ausgabe
`DeviceNotAvailableException`

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 der aktiven 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 Kommunikation mit dem Gerät 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 ein IDeviceActionReceiver für dieses Gerät.

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

Parameter
`deviceActionReceiver`	`IDeviceActionReceiver`: Eine `IDeviceActionReceiver`, die registriert wird.

remountSystemReadOnly

public void remountSystemReadOnly ()

Die Systempartition auf dem Gerät schreibgeschützt machen. Möglicherweise muss das Gerät neu gestartet werden.

Ausgabe
`DeviceNotAvailableException`

remountSystemWritable

public void remountSystemWritable ()

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

Ausgabe
`DeviceNotAvailableException`

remountVendorReadOnly

public void remountVendorReadOnly ()

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

Ausgabe
`DeviceNotAvailableException`

remountVendorWritable

public void remountVendorWritable ()

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

Ausgabe
`DeviceNotAvailableException`

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

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

Parameter
`componentName`	`String`: des zu entfernenden Geräteadministrators.
`userId`	`int`: des Nutzers, in dem 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.

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 erfolgreich entfernt wurde, andernfalls „false“.

Ausgabe
`DeviceNotAvailableException`

resetContentProviderSetup

public void resetContentProviderSetup ()

Setzen Sie das Flag für die Einrichtung des Content-Anbieters zurück, um es noch einmal auszulösen.

runInstrumentationTests

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

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

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

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

Ausgabe
`DeviceNotAvailableException`

runInstrumentationTests

public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                 listeners)

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

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

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

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

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

Ausgabe
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

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

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

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

Returns
`boolean`

Ausgabe
`DeviceNotAvailableException`

runInstrumentationTestsAsUser

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

setAdbPath

public void setAdbPath (String adbPath)

Legt den Pfad zum zu verwendenden ADB-Binärprogramm fest.

Parameter
`adbPath`	`String`

setConfiguration

public void setConfiguration (IConfiguration configuration)

Fügt die verwendete IConfiguration ein.

Parameter
`configuration`	`IConfiguration`

setConnectionAvdInfo

public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

Parameter
`avdInfo`	`GceAvdInfo`

setDate

public void setDate (Date date)

Legt das Datum auf dem Gerät fest

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

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

Ausgabe
`DeviceNotAvailableException`

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Legt eine Geräteadministrator-Komponente als Geräteinhaber für einen bestimmten Nutzer fest.

Parameter
`componentName`	`String`: des Geräteadministrators als Geräteinhaber.
`userId`	`int`: des Nutzers, in dem der Geräteinhaber lebt.

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

Ausgabe
`DeviceNotAvailableException`

setDeviceState

public void setDeviceState (TestDeviceState deviceState)

Aktualisieren Sie den Gerätestatus.

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

setEmulatorOutputStream

public void setEmulatorOutputStream (SizeLimitedOutputStream output)

Für den Emulator legen Sie SizeLimitedOutputStream auf die Logausgabe fest.

Parameter
`output`	`SizeLimitedOutputStream`: zum Protokollieren der Ausgabe

setEmulatorProcess

public void setEmulatorProcess (Process p)

Legt die Process fest, wenn dieses Gerät ein Emulator ist.

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`: Gibt an, ob Fastboot für das Gerät verfügbar ist oder nicht.

setFastbootPath

public void setFastbootPath (String fastbootPath)

Legt den Pfad zum zu verwendenden Fastboot-Binärprogramm fest. isFastbootEnabled() muss weiterhin „true“ sein, damit Fastboot-Funktionen aktiviert sind.

Parameter
`fastbootPath`	`String`

setIDevice

public void setIDevice (IDevice newDevice)

Aktualisieren Sie das IDevice, das mit diesem ITestDevice verknüpft ist.

Die neue IDevice muss sich auf dasselbe physische Gerät wie die aktuelle Referenz beziehen. 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-Erfassung für ein Onlinegerät gestartet wird.

Parameter
`delay`	`int`: die Verzögerung in Millisekunden

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 Eigenschaftswert auf dem Gerät fest. Erfordert, dass „adb root“ auf „true“ gesetzt ist.

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

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

Ausgabe
`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)

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

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

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

setSetting

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

Weitere Informationen finden Sie unter setSetting(int, String, String, String).

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

Ausgabe
`DeviceNotAvailableException`

setSetting

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

Fügen Sie dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzu. Einige Einstellungen sind erst nach einem Neustart verfügbar. Der Namespace muss einer der folgenden Werte sein: {"system", "secure", "global"}

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

Ausgabe
`DeviceNotAvailableException`

setTestLogger

public void setTestLogger (ITestLogger testLogger)

Fügt die ITestLogger-Instanz ein.

Parameter
`testLogger`	`ITestLogger`

setTrackingSerial

public void setTrackingSerial (String trackingSerial)

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

Parameter
`trackingSerial`	`String`

setUseFastbootErase

public void setUseFastbootErase (boolean useFastbootErase)

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

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

startLogcat

public void startLogcat ()

Logcat-Ausgabe vom Gerät im Hintergrund erfassen.

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

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

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

startTradeInModeTesting

public boolean startTradeInModeTesting (int timeoutMs)

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

Parameter
`timeoutMs`	`int`

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

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

startUser

public boolean startUser (int userId)

Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit beendet 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`	„true“, wenn der Nutzer erfolgreich im Hintergrund gestartet wurde.

Ausgabe
`DeviceNotAvailableException`

startUser

public boolean startUser (int userId, 
                boolean waitFlag)

Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit beendet 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 wird erst ausgeführt, wenn der Nutzer gestartet und entsperrt wurde.

Returns
`boolean`	„true“, wenn der Nutzer erfolgreich 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 angegebenen 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, ob die Anzeige verfügbar ist, ob device supports such feature usw.

Parameter
`userId`	`int`: des Nutzers, der im Hintergrund gestartet werden soll
`displayId`	`int`: Display, auf dem der Nutzer die Anzeige sehen soll
`waitFlag`	`boolean`: Der Befehl wird erst ausgeführt, wenn der Nutzer gestartet und entsperrt wurde.

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

Ausgabe
`DeviceNotAvailableException`

stopEmulatorOutput

public void stopEmulatorOutput ()

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

stopLogcat

public void stopLogcat ()

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

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

stopTradeInModeTesting

public void stopTradeInModeTesting ()

Test des Eintauschmodus beenden

Ausgabe
`DeviceNotAvailableException`

stopUser

public boolean stopUser (int userId)

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

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

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

Ausgabe
`DeviceNotAvailableException`

stopUser

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

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

Parameter
`userId`	`int`: des Nutzers, der gestoppt werden soll.
`waitFlag`	`boolean`: Der Befehl wartet, bis der Nutzer gestoppt wurde.
`forceFlag`	`boolean`: Der Nutzer wird zum Beenden gezwungen.

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

Ausgabe
`DeviceNotAvailableException`

switchToAdbTcp

public String switchToAdbTcp ()

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

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

Ausgabe
`DeviceNotAvailableException`

switchToAdbUsb

public boolean switchToAdbUsb ()

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

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

Ausgabe
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId)

Wechseln Sie mit einem Standard-Timeout zu einer anderen userId. switchUser(int, long).

Parameter
`userId`	`int`

Returns
`boolean`	„True“, wenn die neue User-ID mit dem User-ID-Anbieter übereinstimmt. ansonsten „falsch“.

Ausgabe
`DeviceNotAvailableException`

switchUser

public boolean switchUser (int userId, 
                long timeout)

Wechseln Sie innerhalb des angegebenen Zeitlimits zu einer anderen Nutzer-ID. Versuche, Keyguard zu deaktivieren, nachdem der Nutzerwechsel erfolgreich war.

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

Returns
`boolean`	„True“, wenn die neue User-ID mit dem User-ID-Anbieter übereinstimmt. ansonsten „falsch“.

Ausgabe
`DeviceNotAvailableException`

syncFiles

public boolean syncFiles (File localFileDir, 
                String deviceFilePath)

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

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

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

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

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

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

Ausgabe
`DeviceNotAvailableException`

takeBugreport

public Bugreport takeBugreport ()

Erstellt einen Fehlerbericht und gibt ihn in einem Bugreport-Objekt zurück, um ihn zu verarbeiten. Gibt bei Problemen „null“ zurück. Dateien, auf die im Bugreport-Objekt verwiesen wird, müssen über Bugreport.close() bereinigt werden.

Returns
`Bugreport`

uninstallPackage

public String uninstallPackage (String packageName)

Ein Android-Paket vom Gerät deinstallieren.

Parameter
`packageName`	`String`: das Android-Paket, das deinstalliert werden soll

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

Ausgabe
`DeviceNotAvailableException`

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Deinstalliert ein Android-Paket für einen bestimmten Nutzer von einem Gerät.

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

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

Ausgabe
`DeviceNotAvailableException`

unlockDevice

public boolean unlockDevice ()

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

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

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

Ausgabe
`DeviceNotAvailableException`

unmountDebugfs

public void unmountDebugfs ()

debugfs unmounten.

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 ist

Ausgabe
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable ()

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

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

Ausgabe
`DeviceNotAvailableException`

waitForDeviceAvailable

public boolean waitForDeviceAvailable (long waitTime)

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

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

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

Ausgabe
`DeviceNotAvailableException`

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

Ausgabe
`DeviceNotAvailableException`

waitForDeviceBootloader

public void waitForDeviceBootloader ()

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

Ausgabe
`DeviceNotAvailableException`

waitForDeviceFastbootD

public void waitForDeviceFastbootD ()

Ausgabe
`DeviceNotAvailableException`

waitForDeviceInRecovery

public boolean waitForDeviceInRecovery (long waitTime)

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

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

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

waitForDeviceInSideload

public boolean waitForDeviceInSideload (long waitTime)

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

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

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

waitForDeviceNotAvailable

public boolean waitForDeviceNotAvailable (long waitTime)

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

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

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

waitForDeviceOnline

public void waitForDeviceOnline ()

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

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

Ausgabe
`DeviceNotAvailableException`

waitForDeviceOnline

public void waitForDeviceOnline (long waitTime)

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

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

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

Ausgabe
`DeviceNotAvailableException`

waitForDeviceShell

public boolean waitForDeviceShell (long waitTime)

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

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

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

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 ein RebootDeviceAction, das beim Ausführen einer Neustartaktion verwendet werden soll.

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

Returns
`NativeDevice.RebootDeviceAction`	die erstellte `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`: Ein Modus dieses Neustarts.
`reason`	`String`: für diesen Neustart.

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

ensureRuntimePermissionSupported

protected void ensureRuntimePermissionSupported ()

Hilfsmethode zum Auslösen einer Ausnahme, 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`

internalGetProperty

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

Ruft eine Geräteeigenschaft ab, standardmäßig aus dem ddmlib-Cache, und greift entweder auf „adb shell getprop“ oder „fastboot getvar“ zurück, je nachdem, ob sich das Gerät im Fastboot-Modus befindet oder nicht.

Parameter
`propName`	`String`: Der Name der Geräte-Property, wie von `adb shell getprop` zurückgegeben
`fastbootVar`	`String`: Der Name der entsprechenden Fastboot-Variablen, die abgefragt werden soll. Wenn `null`, wird kein Fastboot-Befehl ausgeführt.
`description`	`String`: Eine einfache Beschreibung der Variablen. Der erste Buchstabe sollte großgeschrieben werden.

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

Ausgabe
`DeviceNotAvailableException`

isInRebootCallback

protected boolean isInRebootCallback ()

Gibt zurück, ob Rückrufe für den Neustart gerade ausgeführt werden. Alle öffentlichen APIs für den Neustart sollten deaktiviert werden, wenn „true“ (wahr) zurückgegeben wird.

Returns
`boolean`

isNewer

protected boolean isNewer (File localFile, 
                IFileEntry entry)

Gibt true zurück, wenn die lokale Datei neuer als die Remotedatei ist. IFileEntry ist auf die Minute genau. Bei gleichen Zeiten wird die Datei als neuer betrachtet.

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

Returns
`boolean`

notifyRebootEnded

protected void notifyRebootEnded ()

Benachrichtigt alle IDeviceActionReceiver über das Ende des Neustarts.

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

notifyRebootStarted

protected void notifyRebootStarted ()

Benachrichtigt alle IDeviceActionReceiver über das Ereignis zum Start des Neustarts.

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 den Befehl optional noch einmal auszuführen, 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 Anzahl der Wiederholungsversuche für die Aktion, wenn sie fehlschlägt, aber die Wiederherstellung erfolgreich ist.

Returns
`boolean`	`true`, wenn die Aktion erfolgreich ausgeführt wurde

Ausgabe
`DeviceNotAvailableException`	wenn der Wiederherstellungsversuch fehlschlägt oder die maximale Anzahl von Versuchen ohne Erfolg erreicht wurde

postAdbReboot

protected void postAdbReboot (NativeDevice.RebootMode rebootMode)

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

Parameter
`rebootMode`	`NativeDevice.RebootMode`

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 Booten 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 Clock-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 gesendet werden).

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

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

DEBUG_PATH

INVALID_USER_ID

MAX_HOST_DEVICE_TIME_OFFSET

MAX_RETRY_ATTEMPTS

SD_CARD

STORAGE_EMULATED

Felder

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

executeAdbV2Command

executeAdbV2Command

executeAdbV2Command

executeFastbootCommand

executeFastbootCommand

executeLongFastbootCommand

executeLongFastbootCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellCommand

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

executeShellV2Command

fastbootWipePartition

getActiveApexes

getAdbPath

getAllSettings

getAllocationState

getAndroidId