NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

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


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

Zusammenfassung

Verschachtelte Klassen

class NativeDevice.AdbAction

Eine ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) zum Ausführen eines Betriebssystembefehls vom Typ „adb…“. 

class NativeDevice.AdbShellAction

 

class NativeDevice.RebootDeviceAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) zum Neustarten eines Geräts. 

Konstanten

int INVALID_USER_ID

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

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

die Standardanzahl der Wiederholungsversuche für Befehle

Felder

public static final String DEBUGFS_PATH

protected static final String SD_CARD

protected static final String STORAGE_EMULATED

protected TestDeviceOptions mOptions

protected final IDeviceStateMonitor mStateMonitor

Öffentliche Konstruktoren

NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Erstellt einen TestDevice.

Öffentliche Methoden

void batchPrefetchStartupBuildProps()

Mikrooptimierung (ca. 400 Millis), indem alle benötigten Attribute vorab abgerufen werden, anstatt für jede „adb getprop“ aufzurufen.

boolean canSwitchToHeadlessSystemUser()

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

boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

Prüfen, ob eine Funktion derzeit unterstützt wird, wenn ein Mindestsupportlevel vorhanden ist

boolean checkConnectivity()

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

boolean clearErrorDialogs()

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

void clearLastConnectedWifiNetwork()

Das zuletzt verbundene WLAN wird gelöscht.

void clearLogcat()

Löscht alle angesammelten Logcat-Daten.

boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

Verbindet sich mit einem WLAN.

boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

Verbindet sich mit einem WLAN.

boolean connectToWifiNetwork( wifiSsidToPsk)

Verbindet sich mit einem WLAN.

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

Verbindet sich mit einem WLAN.

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 dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.

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

Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

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

Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

int createUser(String name)

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

int createUserNoThrow(String name)

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

void deleteFile(String deviceFilePath, int userId)

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

void deleteFile(String deviceFilePath)

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

void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Entfernt die registrierte IDeviceActionReceiver.

boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

Hilfsmethode, um zu prüfen, ob das Gerät neu gestartet wurde, indem der aktuelle system_server mit dem vorherigen system_server ProcessInfo verglichen wird.

boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

Hilfsmethode, um zu prüfen, ob das Gerät seit der UTC-Zeit seit der Epoche vom Gerät und seiner ERROR(/TimeUnit) neu gestartet wurde.

boolean disableAdbRoot()

Deaktiviert adb root.

void disableKeyguard()

Es wird versucht, den Keyguard zu deaktivieren.

boolean disableNetworkMonitor()

Deaktiviert die Netzwerküberwachung auf dem Gerät.

boolean disconnectFromWifi()

Trennen Sie die Verbindung zu einem WLAN.

boolean doesFileExist(String deviceFilePath, int userId)

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

boolean doesFileExist(String deviceFilePath)

Hilfsmethode zum Ermitteln, ob eine Datei auf dem Gerät vorhanden ist.

File dumpHeap(String process, String devicePath)

Versuchen Sie, den Heap aus dem system_server zu dumpen.

boolean enableAdbRoot()

Aktiviert adb root.

boolean enableNetworkMonitor()

Aktiviert die Netzwerküberwachung auf dem Gerät.

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

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

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

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

String executeAdbCommand(String... cmdArgs)

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

CommandResult executeFastbootCommand(String... cmdArgs)

Hilfsmethode, die einen Fastboot-Befehl als Systembefehl mit einer Standardzeitüberschreitung von 2 Minuten ausführt.

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

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

CommandResult executeLongFastbootCommand(String... cmdArgs)

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

CommandResult executeLongFastbootCommand( envVarMap, String... cmdArgs)

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

String executeShellCommand(String command)

Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ausgabe als String zurückgibt.

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

Führt einen adb-Shell-Befehl mit mehr 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 aus, um das Befehlsverhalten zu steuern.

void executeShellCommand(String command, IShellOutputReceiver receiver)

Führt den angegebenen adb-Shell-Befehl aus und versucht bei einem Fehler mehrmals, ihn auszuführen.

CommandResult executeShellV2Command(String cmd)

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

CommandResult executeShellV2Command(String cmd, OutputStream pipeToOutput)

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

CommandResult executeShellV2Command(String cmd, File pipeAsInput)

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

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

Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.

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

Führt einen adb-Shell-Befehl mit mehr 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 mehr 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 aus, um das Befehlsverhalten zu steuern.

CommandResult fastbootWipePartition(String partition)

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

getActiveApexes()

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

getAllSettings(String namespace)

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

DeviceAllocationState getAllocationState()

Aktuellen Zuweisungsstatus des Geräts zurückgeben

String getAndroidId(int userId)

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

getAndroidIds()

Erstellen Sie eine Zuordnungstabelle mit den gefundenen Android-IDs und den zugehörigen User-IDs.

int getApiLevel()

Rufe die API-Ebene des Geräts ab.

PackageInfo getAppPackageInfo(String packageName)

Informationen zu einem auf dem Gerät installierten Paket abrufen

getAppPackageInfos()

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

String getBasebandVersion()

Diese Methode ist praktisch, um die Baseband-Version (Funkschnittstelle) dieses Geräts abzurufen.

Integer getBattery()

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

boolean getBooleanProperty(String name, boolean defaultValue)

Gibt einen booleschen Wert der angegebenen Eigenschaft zurück.

getBootHistory()

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

getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

Mit dieser Hilfsmethode wird die Boot-Verlaufskarte mit Bootzeit und Bootgrund seit dem angegebenen Zeitpunkt seit der Epoche vom Gerät und der angegebenen Zeiteinheit erfasst.

String getBootloaderVersion()

Diese Methode ist eine praktische Möglichkeit, die Bootloader-Version dieses Geräts abzurufen.

InputStreamSource getBugreport()

Ruft einen Fehlerbericht vom Gerät ab.

InputStreamSource getBugreportz()

Ruft einen Fehlerbericht vom Gerät ab

String getBuildAlias()

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

String getBuildFlavor()

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

String getBuildId()

Rufen Sie den Build ab, den das Gerät derzeit ausführt.

String getBuildSigningKeys()

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

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

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)

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

AbstractConnection getConnection()

Die aktuelle Verbindung, die dem Gerät zugeordnet ist.

ContentProviderHandler getContentProvider(int userId)

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

DeviceFoldableState getCurrentFoldableState()

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

int getCurrentUser()

Gibt die ID des aktuell laufenden Nutzers zurück.

String getDeviceClass()

Rufen Sie die Geräteklasse ab.

long getDeviceDate()

Datum des Geräts in Millisekunden seit der Epoche zurückgeben.

DeviceDescriptor getDeviceDescriptor()

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

DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

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

TestDeviceState getDeviceState()

Rufe den Status des Geräts ab.

long getDeviceTimeOffset(Date date)

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

InputStreamSource getEmulatorOutput()

Stream von stdout und stderr des Emulators abrufen

Process getEmulatorProcess()

Geben Sie 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 der Menge an freiem Speicherplatz im externen Gerätespeicher.

String getFastbootPath()

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

String getFastbootProductType()

Praktische Methode zum Abrufen des Produkttyps dieses Geräts, wenn es sich im Schnellstartmodus (Fastboot mode) befindet.

String getFastbootProductVariant()

Praktische Methode zum Abrufen des Produkttyps dieses Geräts, wenn es sich im Schnellstartmodus (Fastboot mode) befindet.

String getFastbootSerialNumber()

Gibt die Seriennummer des Fastboot-Modus zurück.

String getFastbootVariable(String variableName)

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

String getFastbootVersion()

Gibt den Versionsstring der verwendeten Fastboot-Binärdatei zurück.

IFileEntry getFileEntry(String path)

Eine Referenz auf eine Remotedatei auf dem Gerät abrufen

IFileEntry getFileEntry(FileListingService.FileEntry entry)

Inoffizieller Helfer zum Abrufen einer FileEntry von einem nicht übergeordneten Pfad.

getFoldableStates()

Liste der Zustände des faltbaren Geräts zurückgeben

IDevice getIDevice()

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

getInstalledPackageNames()

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

long getIntProperty(String name, long defaultValue)

Gibt einen ganzzahligen Wert der angegebenen Eigenschaft vom Gerät zurück.

String getIpAddress()

Ruft die IP-Adresse des Geräts ab.

KeyguardControllerState getKeyguardState()

Gibt ein Objekt zurück, um den aktuellen Status des Keyguard oder null abzurufen, wenn dies nicht unterstützt wird.

long getLastExpectedRebootTimeMillis()

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

int getLaunchApiLevel()

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

InputStreamSource getLogcat()

Erfasst einen Snapshot-Stream der Logcat-Daten.

InputStreamSource getLogcat(int maxBytes)

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

InputStreamSource getLogcatDump()

Dump des aktuellen Logcats für das Gerät abrufen

InputStreamSource getLogcatSince(long date)

Erfasst einen Snapshot-Stream der erfassten Logcat-Daten ab dem angegebenen Datum.

String getMacAddress()

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

Integer getMainUserId()

Gibt die Hauptnutzer-ID zurück.

getMainlineModuleInfo()

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

int getMaxNumberOfRunningUsersSupported()

Die maximale Anzahl der gleichzeitig unterstützten Nutzer abrufen

int getMaxNumberOfUsersSupported()

Maximal unterstützte Nutzerzahl abrufen

Process getMicrodroidProcess()
IDeviceStateMonitor getMonitor()

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

String getMountPoint(String mountName)

Gibt einen Bereitstellungspunkt zurück.

ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

Gibt ein MountPointInfo zurück, das dem angegebenen Bereitstellungspunktpfad entspricht, oder null, wenn an diesem Pfad nichts bereitgestellt ist oder er anderweitig nicht in /proc/mounts als Bereitstellungspunkt aufgeführt ist.

getMountPointInfo()

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

TestDeviceOptions getOptions()

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

long getPartitionFreeSpace(String partition)

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

Integer getPrimaryUserId()

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

ProcessInfo getProcessByName(String processName)

Die Hilfsmethode führt die Befehle "pidof" und "stat" aus und gibt das Objekt ProcessInfo mit PID und Prozessstartzeit 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()

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

String getProductVariant()

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

String getProperty(String name)

Ruft den angegebenen Attributwert vom Gerät ab.

ITestDevice.RecoveryMode getRecoveryMode()

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

InputStreamSource getScreenshot(long displayId)

Erstellt einen Screenshot von der angegebenen Anzeige-ID des Geräts.

InputStreamSource getScreenshot(String format)

Erstellt einen Screenshot auf dem Gerät.

InputStreamSource getScreenshot(String format, boolean rescale)

Erstellt einen Screenshot auf dem Gerät.

InputStreamSource getScreenshot()

Erstellt einen Screenshot auf dem Gerät.

String getSerialNumber()

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

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

Gibt den Wert der angeforderten Einstellung zurück.

String getSetting(String namespace, String key)

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

String getSimOperator()

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

String getSimState()

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

getTombstones()

Liste der Tombstones von den Geräten abrufen und zurückgeben.

long getTotalMemory()

Gibt die Gesamtgröße des physischen Arbeitsspeichers in Byte oder -1 bei einem internen Fehler zurück.

String getTrackingSerial()

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

getUninstallablePackageNames()

Rufen Sie die App-Paketnamen ab, die deinstalliert werden können.

boolean getUseFastbootErase()

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

int getUserFlags(int userId)

Die Markierungen eines bestimmten Nutzers finden und zurückgeben.

getUserInfos()

Ruft die Zuordnung von „useId“ zu „UserInfo“ auf dem Gerät ab.

int getUserSerialNumber(int userId)

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

IManagedTestDevice.DeviceEventResponse handleAllocationEvent(DeviceEvent event)

Verarbeite das angegebene DeviceEvent.

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

boolean hasFeature(String feature)

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

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

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

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

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

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

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

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

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

void invalidatePropertyCache()
boolean isAdbRoot()

boolean isAdbTcp()
boolean isAppEnumerationSupported()

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

boolean isBypassLowTargetSdkBlockSupported()

Prüfen, ob die Plattform auf dem Gerät das Umgehen eines niedrigen SDK-Zielblocks bei App-Installationen unterstützt

boolean isDebugfsMounted()

Prüfen Sie, ob debugfs bereitgestellt ist.

boolean isDeviceEncrypted()

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

boolean isDirectory(String path)

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

boolean isEnableAdbRoot()
boolean isEncryptionSupported()

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

boolean isExecutable(String fullPath)

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

boolean isFastbootEnabled()

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

boolean isHeadless()

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

boolean isHeadlessSystemUserMode()

Gibt an, ob auf dem Gerät der headless Systemnutzermodus verwendet wird.

boolean isMainUserPermanentAdmin()

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

boolean isMultiUserSupported()

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

boolean isPackageInstalled(String packageName, String userId)

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

boolean isPackageInstalled(String packageName)

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

boolean isRuntimePermissionSupported()

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

boolean isStateBootloaderOrFastbootd()

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

boolean isUserRunning(int userId)

Prüfen, ob ein bestimmter Nutzer ausgeführt wird

boolean isUserSecondary(int userId)

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

boolean isUserVisible(int userId)

Prüft, ob der angegebene Nutzer sichtbar ist.

boolean isUserVisibleOnDisplay(int userId, int displayId)

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

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

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

boolean isVisibleBackgroundUsersSupported()

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

boolean isWifiEnabled()

Teste, ob WLAN aktiviert ist.

listDisplayIds()

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

listDisplayIdsForStartingVisibleBackgroundUsers()

Ruft die Liste der Bildschirme ab, die zum start a user visible in the background verwendet werden können.

listUsers()

Ruft die Liste der Nutzer auf dem Gerät ab.

boolean logAnrs(ITestLogger logger)

Erfasst und protokolliert ANRs auf dem Gerät.

boolean logBugreport(String dataName, ITestLogger listener)

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

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

Eine Nachricht im Logcat des Geräts protokollieren

void mountDebugfs()

debugfs bereitstellen

void nonBlockingReboot()

Gibt einen Befehl zum Neustarten des Geräts aus und gibt nach Abschluss des Befehls und wenn das Gerät für adb nicht mehr sichtbar ist, zurück.

void postAdbRootAction()

Überschreibt, wenn für das Gerät bestimmte Aktionen nach dem ADB-Root und bevor das Gerät wieder online ist.

void postAdbUnrootAction()

Überschreiben Sie diese Option, wenn nach dem Entfernen des Root-Zugriffs mit adb bestimmte Aktionen auf dem Gerät ausgeführt werden müssen, bevor es wieder online ist.

void postBootSetup()

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

void postInvocationTearDown(Throwable exception)

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

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

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

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

Verzeichnisinhalte rekursiv vom Gerät abrufen.

boolean pullDir(String deviceFilePath, File localDir)

Verzeichnisinhalte rekursiv vom Gerät abrufen

boolean pullFile(String remoteFilePath, File localFile)

Ruft eine Datei vom Gerät ab.

File pullFile(String remoteFilePath, int userId)

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

File pullFile(String remoteFilePath)

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

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

Ruft eine Datei vom Gerät ab.

String pullFileContents(String remoteFilePath)

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

File pullFileFromExternal(String remoteFilePath)

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

boolean pushDir(File localFileDir, String deviceFilePath, excludedDirectories)

Verzeichnisinhalte werden rekursiv auf das Gerät übertragen und gleichzeitig einige gefilterte Verzeichnisse ausgeschlossen.

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), die optional den Bedarf an den Contentanbieter prüfen kann

boolean pushFile(File localFile, String remoteFilePath)

Übertragen Sie eine Datei per Push auf das Gerät.

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

Dateien an das Gerät senden

boolean pushString(String contents, String remoteFilePath)

Aus einem String erstellte Datei an das Gerät senden

void reboot(String reason)

Startet das Gerät im ADB-Modus neu, wobei die angegebenen reason bei jedem Neustart beibehalten werden.

void reboot()

Startet das Gerät im ADB-Modus neu.

void rebootIntoBootloader()

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

void rebootIntoFastbootd()

Startet das Gerät im Fastbootd-Modus neu.

void rebootIntoRecovery()

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

void rebootIntoSideload()

Startet das Gerät im adb-Sideload-Modus neu. Hinweis: Dies ist ein spezieller Modus unter Wiederherstellung.

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

void rebootIntoSideload(boolean autoReboot)

Startet das Gerät im adb-Sideload-Modus neu. Hinweis: Dies ist ein spezieller Modus unter Wiederherstellung.

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

void rebootUntilOnline()

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

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 Gerätekommunikation wiederherzustellen.

void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Registriert eine IDeviceActionReceiver für dieses Gerät.

void remountSystemReadOnly()

Machen Sie die Systempartition auf dem Gerät schreibgeschützt.

void remountSystemWritable()

Machen Sie die Systempartition auf dem Gerät beschreibbar.

void remountVendorReadOnly()

Die Anbieterpartition auf dem Gerät schreibgeschützt machen.

void remountVendorWritable()

Machen Sie die Anbieterpartition auf dem Gerät beschreibbar.

boolean removeAdmin(String componentName, int userId)

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

void removeOwners()

Entfernen Sie nach Möglichkeit alle vorhandenen Geräteprofileigentümer.

boolean removeUser(int userId)

Einen bestimmten Nutzer vom Gerät entfernen.

void resetContentProviderSetup()

Setzen Sie die Markierung für die Einrichtung des Contentanbieters zurück, um ihn noch einmal auszulösen.

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

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

boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

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

boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)

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

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

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

void setConfiguration(IConfiguration configuration)

Fügt den verwendeten IConfiguration ein.

final void setConnectionAvdInfo(GceAvdInfo avdInfo)
void setDate(Date date)

Datum auf dem Gerät festlegen

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

boolean setDeviceOwner(String componentName, int userId)

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

void setDeviceState(TestDeviceState deviceState)

Aktualisieren Sie den Status des Geräts.

void setEmulatorOutputStream(SizeLimitedOutputStream output)

Für den Emulator SizeLimitedOutputStream auf „Logausgabe“ festlegen

void setEmulatorProcess(Process p)

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

void setFastbootEnabled(boolean fastbootEnabled)

Legen Sie die Fastboot-Option für das Gerät fest.

void setFastbootPath(String fastbootPath)

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

void setIDevice(IDevice newDevice)

Aktualisieren Sie das mit diesem ITestDevice verknüpfte IDevice.

void setLogStartDelay(int delay)

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

void setOptions(TestDeviceOptions options)

TestDeviceOptions für das Gerät festlegen

boolean setProperty(String propKey, String propValue)

Legt den angegebenen Property-Wert auf dem Gerät fest.

void setRecovery(IDeviceRecovery recovery)

Legen Sie die IDeviceRecovery fest, die für dieses Gerät verwendet werden soll.

void setRecoveryMode(ITestDevice.RecoveryMode mode)

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

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

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

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

Dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzufügen.

void setTestLogger(ITestLogger testLogger)

ITestLogger-Instanz einschleust

void setTrackingSerial(String trackingSerial)

Für die Geräteverwaltung die Seriennummer erfassen, die wir für die Referenzierung des Geräts verwenden.

void setUseFastbootErase(boolean useFastbootErase)

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

void startLogcat()

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

boolean startUser(int userId)

Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist.

boolean startUser(int userId, boolean waitFlag)

Startet einen bestimmten Nutzer im Hintergrund, wenn er aktuell beendet ist.

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

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

void stopEmulatorOutput()

Schließen und löschen Sie die Emulatorausgabe.

void stopLogcat()

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

boolean stopUser(int userId)

Stoppt einen bestimmten Nutzer.

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

Stoppen Sie einen bestimmten Nutzer.

String switchToAdbTcp()

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

boolean switchToAdbUsb()

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

boolean switchUser(int userId)

Wechseln Sie zu einer anderen userId mit einer Standardzeitüberschreitung.

boolean switchUser(int userId, long timeout)

Wechseln Sie zu einer anderen Nutzer-ID mit dem angegebenen Zeitlimit als Frist.

boolean syncFiles(File localFileDir, String deviceFilePath)

Der Inhalt eines lokalen Dateiverzeichnisses wird inkrementell mit dem Gerät synchronisiert.

Bugreport takeBugreport()

Erstellen Sie einen Fehlerbericht und geben Sie ihn in einem Bugreport-Objekt zurück, um ihn zu verarbeiten.

String uninstallPackage(String packageName)

Deinstallation eines Android-Pakets vom Gerät

String uninstallPackageForUser(String packageName, int userId)

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

boolean unlockDevice()

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

void unmountDebugfs()

Entfernen Sie die Bereitstellung von debugfs.

boolean waitForBootComplete(long timeOut)

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

boolean waitForDeviceAvailable()

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

boolean waitForDeviceAvailable(long waitTime)

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

boolean waitForDeviceAvailableInRecoverPath(long waitTime)

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

void waitForDeviceBootloader()

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

boolean waitForDeviceInRecovery(long waitTime)

Blöcke für das Gerät, die sich im Status „ADB-Wiederherstellung“ befinden. Beachten Sie, dass dies nicht mit IDeviceRecovery zu tun ist.

boolean waitForDeviceInSideload(long waitTime)

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

boolean waitForDeviceNotAvailable(long waitTime)

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

void waitForDeviceOnline()

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

void waitForDeviceOnline(long waitTime)

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

boolean waitForDeviceShell(long waitTime)

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

Geschützte Methoden

void addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
String[] buildAdbShellCommand(String command, boolean forceExitStatusDetection)

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

void checkApiLevelAgainst(String feature, int strictMinLevel)
NativeDevice.RebootDeviceAction createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)

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

IRunUtil createRunUtil()
void doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)

Führen Sie einen ADB-Neustart durch.

void ensureRuntimePermissionSupported()

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

int getApiLevelSafe()
ITestLogger getLogger()
IRunUtil getRunUtil()

Rufen Sie die zu verwendende RunUtil-Instanz ab.

void initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
String internalGetProperty(String propName, String fastbootVar, String description)

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

boolean isInRebootCallback()

Gibt an, ob Reboot-Callbacks derzeit ausgeführt werden.

boolean isNewer(File localFile, IFileEntry entry)

Gibt true zurück, wenn die lokale Datei neuer als die Remote-Datei ist.

void notifyRebootEnded()

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

void notifyRebootStarted()

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

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

Dadurch wird eine Aktion auf diesem Gerät ausgeführt.

void postAdbReboot()

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

void prePostBootSetup()

Damit kann jeder Gerätetyp (AndroidNativeDevice, TestDevice) diese Methode für eine bestimmte Einrichtung nach dem Booten überschreiben.

boolean pullFileInternal(String remoteFilePath, File localFile)
void setClock(Clock clock)

Legen Sie die zu verwendende Uhren-Instanz fest.

void setMicrodroidProcess(Process process)

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

void setTestDeviceOptions( deviceOptions)
CommandResult simpleFastbootCommand(long timeout, envVarMap, String[] fullCmd)

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

CommandResult simpleFastbootCommand(long timeout, String[] fullCmd)

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

boolean waitForDeviceNotAvailable(String operationDesc, long time)

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

Konstanten

INVALID_USER_ID

public static final int INVALID_USER_ID

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

Konstanter Wert: −10.000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

Konstanter Wert: 5.000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

die Standardanzahl der Wiederholungsversuche für Befehle

Konstanter Wert: 2 (0x00000002)

Felder

DEBUGFS_PATH

public static final String DEBUGFS_PATH

SD_CARD

protected static final String SD_CARD

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Öffentliche Konstruktoren

NativeDevice

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

Erstellt einen TestDevice.

Parameter
device IDevice: die zugehörige IDevice

stateMonitor IDeviceStateMonitor: der zu verwendende IDeviceStateMonitor-Mechanismus

allocationMonitor IDeviceMonitor: die IDeviceMonitor, um über Änderungen des Zuweisungsstatus zu informieren. Kann null sein

Öffentliche Methoden

BatchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

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

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

Returns
boolean

Ausgabe
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

Parameter
strictMinLevel int: Die strikte Mindeststufe, die die Funktion unterstützt.

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

Ausgabe
DeviceNotAvailableException

Verbindung prüfen

public boolean checkConnectivity ()

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

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

Ausgabe
DeviceNotAvailableException

ClearErrorDialogs

public boolean clearErrorDialogs ()

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

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

Ausgabe
DeviceNotAvailableException

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

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

clearLogcat

public void clearLogcat ()

Löscht alle angesammelten Logcat-Daten.

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

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Verbindet sich mit einem WLAN.

Das WLAN wird aktiviert und blockiert, bis eine Verbindung zu einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke hergestellt wurde. Sobald eine Verbindung hergestellt wurde, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice#disconnectFromWifi() oder ITestDevice#clearLastConnectedWifiNetwork() aufgerufen wird.

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

scanSsid boolean: Gibt an, ob nach ausgeblendeten SSIDs für dieses Netzwerk gesucht werden soll.

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

Ausgabe
DeviceNotAvailableException

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Verbindet sich mit einem WLAN.

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

Parameter
wifiSsid String: das WLAN-Signal, mit dem eine Verbindung hergestellt werden soll

wifiPsk String: PSK-Passphrase oder null, falls unverschlüsselt

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

Ausgabe
DeviceNotAvailableException

connectToWifiNetwork

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Verbindet sich mit einem WLAN.

Das WLAN wird aktiviert und blockiert, bis eine Verbindung zu einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke hergestellt wurde. Sobald eine Verbindung hergestellt wurde, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice#disconnectFromWifi() oder ITestDevice#clearLastConnectedWifiNetwork() aufgerufen wird.

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

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

Ausgabe
DeviceNotAvailableException

connectToWifiNetwork

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

Verbindet sich mit einem WLAN.

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

Parameter
wifiSsid String: das WLAN-Signal, mit dem eine Verbindung hergestellt werden soll

wifiPsk String: PSK-Passphrase oder „null“, wenn nicht verschlüsselt

scanSsid boolean: Gibt an, ob nach ausgeblendeten SSIDs für dieses Netzwerk gesucht werden soll.

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

Ausgabe
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

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

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

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

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

Ausgabe
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

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

Ausgabe
DeviceNotAvailableException

createUser

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

Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

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

guest boolean: aktiviert das Nutzer-Flag --guest während der Erstellung.

ephemeral boolean: Aktivieren Sie beim Erstellen das Nutzerflag „--ephemeral“.

Returns
int ID des erstellten Nutzers

Ausgabe
DeviceNotAvailableException

createUser

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

Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

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

guest boolean: aktiviert das Nutzer-Flag --guest während der Erstellung.

ephemeral boolean: aktiviert das Nutzer-Flag „--sitzungsspezifisch“ beim Erstellen

forTesting boolean: aktiviert das Test-Flag „--for-testing“ beim Erstellen

Returns
int ID des erstellten Nutzers

Ausgabe
DeviceNotAvailableException

createUser

public int createUser (String name)

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

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

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

Ausgabe
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

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

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

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

Ausgabe
DeviceNotAvailableException

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

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

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

userId int: Die Nutzer-ID, von der aus gelöscht werden soll

Ausgabe
DeviceNotAvailableException

deleteFile

public void deleteFile (String deviceFilePath)

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

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

Ausgabe
DeviceNotAvailableException

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Entfernt die registrierte IDeviceActionReceiver.

Parameter
deviceActionReceiver IDeviceActionReceiver: Eine IDeviceActionReceiver, die entfernt wird.

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

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

Parameter
prevSystemServerProcess ProcessInfo: dem vorherigen system_server-Prozess ProcessInfo.

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

Ausgabe
DeviceNotAvailableException

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Hilfsmethode, um zu prüfen, ob das Gerät seit der UTC-Zeit seit der Epoche vom Gerät und seiner ERROR(/TimeUnit) neu gestartet wurde. Ein richtlinienbasierter Neustart bezieht sich auf einen Neustart von system_server, der nicht durch einen erzwungenen Neustart des Geräts ausgelöst wurde (z. B. angeforderter Neustart). Die aktuelle utcEpochTime des Geräts in Millisekunden kann mit der Methode getDeviceDate() abgerufen werden.

Parameter
utcEpochTime long: Die Gerätezeit in Sekunden seit der Epoche.

timeUnit TimeUnit: die Zeiteinheit TimeUnit für die angegebene utcEpochTime.

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

Ausgabe
DeviceNotAvailableException

disableAdbRoot

public boolean disableAdbRoot ()

Deaktiviert adb root.

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

Returns
boolean true, wenn der Vorgang erfolgreich war.

Ausgabe
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

Es wird versucht, den Keyguard zu deaktivieren.

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

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

VonWLAN trennen

public boolean disconnectFromWifi ()

Trennen Sie die Verbindung zu einem WLAN.

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

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

Ausgabe
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

userId int: Die Nutzer-ID, anhand derer die Existenz der Datei geprüft werden soll.

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

Ausgabe
DeviceNotAvailableException

tutFileExist

public boolean doesFileExist (String deviceFilePath)

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

Parameter
deviceFilePath String: der absolute Pfad der zu prüfenden Datei auf dem Gerät

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

Ausgabe
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

Parameter
process String: Der Name des Geräteprozesses, auf dem der Dumpheap 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 den ERROR(/File), der den Bericht enthält. Null, wenn ein Fehler aufgetreten ist.

Ausgabe
DeviceNotAvailableException

enableAdbRoot

public boolean enableAdbRoot ()

Aktiviert adb root. Wenn die Einstellung „enable-root“ auf „false“ festgelegt ist, wird eine Meldung protokolliert und die Funktion wird nicht aktiviert.

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

Returns
boolean true, wenn der Vorgang erfolgreich war.

Ausgabe
DeviceNotAvailableException

enableNetworkMonitor

public boolean enableNetworkMonitor ()

Aktiviert die Netzwerküberwachung auf dem Gerät.

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

Ausgabe
DeviceNotAvailableException

executeAdbCommand

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

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

Nach Möglichkeit sollte executeShellCommand(String) 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 antwortend eingestuft wird, 0L für keinen Zeitüberschreitung

cmdArgs String: der adb-Befehl und die Argumente, die ausgeführt werden sollen

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

Ausgabe
DeviceNotAvailableException

executeAdbCommand

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

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

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

Parameter
timeout long: die Zeit in Millisekunden, nach der das Gerät als nicht antwortend eingestuft wird, 0L für keinen Zeitüberschreitung

envMap : Umgebung, die für den Befehl festgelegt werden soll

cmdArgs String: der adb-Befehl und die Argumente, die ausgeführt werden sollen

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

Ausgabe
DeviceNotAvailableException

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

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

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

Ausgabe
DeviceNotAvailableException

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

Kann verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus (Fastboot mode) befindet.

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

Returns
CommandResult das CommandResult-Element mit der Ausgabe des Befehls

Ausgabe
DeviceNotAvailableException

Schnellstart-Befehl ausführen

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

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

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

Parameter
timeout long: die Zeit in Millisekunden, nach der der Befehl abläuft

cmdArgs String: der Fastboot-Befehl und die auszuführenden Argumente

Returns
CommandResult das CommandResult-Element mit der Ausgabe des Befehls

Ausgabe
DeviceNotAvailableException

LongFastbootCommand ausführen

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

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

Returns
CommandResult das CommandResult-Element mit der Ausgabe des Befehls

Ausgabe
DeviceNotAvailableException

executeLongFastbootCommand

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

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

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

Parameter
envVarMap : die Systemumgebungsvariablen, mit denen der Fastboot-Befehl ausgeführt wird

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

Returns
CommandResult das CommandResult-Element mit der Ausgabe des Befehls

Ausgabe
DeviceNotAvailableException

executeShellCommand

public String executeShellCommand (String command)

Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ausgabe als String zurückgibt.

Parameter
command String: der auszuführende adb-Shell-Befehl

Returns
String die Shell-Ausgabe

Ausgabe
DeviceNotAvailableException

executeShellCommand

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

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

Parameter
command String: der auszuführende adb-Shell-Befehl

receiver IShellOutputReceiver: IShellOutputReceiver, an das die Shell-Ausgabe weitergeleitet werden soll.

maxTimeToOutputShellResponse long: Die maximale Zeitspanne, während der der Befehl keine Antwort ausgeben darf. Einheit wie in timeUnit angegeben.

timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse

retryAttempts int: Die maximale Anzahl der Wiederholungen, die ein Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn retryAttempts ohne Erfolg ausgeführt wird.

Ausgabe
DeviceNotAvailableException

executeShellCommand

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

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

Parameter
command String: der auszuführende adb-Shell-Befehl

receiver IShellOutputReceiver: IShellOutputReceiver, an den die Shell-Ausgabe weitergeleitet werden soll.

maxTimeoutForCommand long: Die maximale Zeitüberschreitung für den Befehl, Einheit wie in timeUnit angegeben.

maxTimeToOutputShellResponse long: Die maximale Zeitspanne, während der der Befehl keine Antwort ausgeben darf. Einheit wie in timeUnit angegeben.

timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse

retryAttempts int: Die maximale Anzahl der Wiederholungen, die ein Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn retryAttempts ohne Erfolg ausgeführt wird.

Ausgabe
DeviceNotAvailableException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Führt den angegebenen adb-Shell-Befehl aus und versucht bei einem Fehler mehrmals, ihn auszuführen.

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

Parameter
command String: der auszuführende adb-Shell-Befehl

receiver IShellOutputReceiver: IShellOutputReceiver, an das die Shell-Ausgabe weitergeleitet werden soll.

Ausgabe
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

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

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

Returns
CommandResult Das Ergebnis in CommandResult.

Ausgabe
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

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

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

pipeToOutput OutputStream: ERROR(/OutputStream), an das die Standardausgabe weitergeleitet wird, oder null.

Returns
CommandResult Das Ergebnis in CommandResult.

Ausgabe
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

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

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

pipeAsInput File: Ein ERROR(/File), das als Eingabe an den Befehl übergeben wird, oder „null“.

Returns
CommandResult Das Ergebnis in CommandResult.

Ausgabe
DeviceNotAvailableException

executeShellV2Command

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

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

Parameter
cmd String: der auszuführende ADB-Shell-Befehl

maxTimeoutForCommand long: Die maximale Zeitüberschreitung für den Befehl, Einheit wie in timeUnit angegeben.

timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse

retryAttempts int: Die maximale Anzahl der Wiederholungen, die ein Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn retryAttempts ohne Erfolg ausgeführt wird.

Returns
CommandResult

Ausgabe
DeviceNotAvailableException

executeShellV2Command

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

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

Parameter
cmd String: der auszuführende ADB-Shell-Befehl

maxTimeoutForCommand long: Die maximale Zeitüberschreitung für den Befehl, Einheit wie in timeUnit angegeben.

timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse

Returns
CommandResult

Ausgabe
DeviceNotAvailableException

executeShellV2Command

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

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

Parameter
cmd String: der auszuführende ADB-Shell-Befehl

pipeAsInput File: Ein ERROR(/File), das als Eingabe an den Befehl übergeben wird, oder „null“.

pipeToOutput OutputStream: ERROR(/OutputStream), an die die Standardausgabe weitergeleitet wird, oder null.

maxTimeoutForCommand long: das maximale Zeitlimit für die Ausführung des Befehls; die Einheit gemäß timeUnit.

timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse

retryAttempts int: Die maximale Anzahl der Wiederholungen, die ein Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn retryAttempts ohne Erfolg ausgeführt wird.

Returns
CommandResult

Ausgabe
DeviceNotAvailableException

executeShellV2Command

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

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

Parameter
cmd String: der auszuführende adb-Shell-Befehl

pipeAsInput File: Ein ERROR(/File), das als Eingabe an den Befehl übergeben wird, oder „null“.

pipeToOutput OutputStream: ERROR(/OutputStream), an das die Standardausgabe weitergeleitet wird, oder null.

pipeToError OutputStream: ERROR(/OutputStream), an das der Standardfehler weitergeleitet wird, oder null.

maxTimeoutForCommand long: Die maximale Zeitüberschreitung für den Befehl, Einheit wie in timeUnit angegeben.

timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse

retryAttempts int: Die maximale Anzahl der Wiederholungen, die ein Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn retryAttempts ohne Erfolg ausgeführt wird.

Returns
CommandResult

Ausgabe
DeviceNotAvailableException

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

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

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

Parameter
partition String: die zu löschende Partition

Returns
CommandResult das CommandResult-Element mit der Ausgabe des Befehls

Ausgabe
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

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

Returns
Derzeit sind ERROR(/Set) von ApexInfo auf dem Gerät aktiviert

Ausgabe
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

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

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

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

Ausgabe
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

Gibt den aktuellen Zuweisungsstatus des Geräts zurück

Returns
DeviceAllocationState

getAndroidId (GetAndroid-ID)

public String getAndroidId (int userId)

Sucht nach der mit einer userId verknüpften Android-ID und gibt sie zurück. Wenn sie nicht gefunden wird, null.

Parameter
userId int

Returns
String

Ausgabe
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

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

Returns
Zuordnung von Android-IDs zu Nutzer-IDs.

Ausgabe
DeviceNotAvailableException

getApiLevel

public int getApiLevel ()

Rufe die API-Ebene des Geräts ab. Die Standardeinstellung ist UNKNOWN_API_LEVEL.

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

Ausgabe
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Informationen zu einem auf dem Gerät installierten Paket abrufen

Parameter
packageName String

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

Ausgabe
DeviceNotAvailableException

getAppPackageInfos (App-Paketinformationen abrufen)

public  getAppPackageInfos ()

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

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

Ausgabe
DeviceNotAvailableException

getBasebandVersion

public String getBasebandVersion ()

Diese Methode ist praktisch, um die Baseband-Version (Funkschnittstelle) dieses Geräts abzurufen. Das Abrufen der Radioversion ist gerätespezifisch, sodass möglicherweise nicht für alle Geräte die richtigen Informationen zurückgegeben werden. Diese Methode benötigt die Eigenschaft „gsm.version.baseband“, um die richtigen Versionsinformationen zurückzugeben. Bei einigen CDMA-Geräten ist das nicht korrekt. Die hier zurückgegebene Version stimmt möglicherweise nicht mit der von Fastboot gemeldeten Version überein und ist möglicherweise nicht die Version für das CDMA-Funkmodul. Zusammenfassung: Mit dieser Methode wird nur dann die korrekte Version erfasst, wenn die Property „gsm.version.baseband“ mit der von fastboot getvar version-baseband zurückgegebenen Version übereinstimmt.

Returns
String die String-Baseband-Version oder null, wenn diese nicht ermittelt werden kann (Gerät hat keine Funkschnittstelle 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 Name der Property

defaultValue boolean: Standardwert, der zurückgegeben wird, wenn das Attribut leer oder nicht vorhanden ist.

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

Ausgabe
DeviceNotAvailableException

getBootHistory

public  getBootHistory ()

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

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

Ausgabe
DeviceNotAvailableException

getBootVerlaufSeit

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

Parameter
utcEpochTime long: Die Gerätezeit seit der Epoche.

timeUnit TimeUnit: die Zeiteinheit TimeUnit.

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

Ausgabe
DeviceNotAvailableException

getBootloaderVersion

public String getBootloaderVersion ()

Diese Methode ist eine praktische Möglichkeit, die Bootloader-Version dieses Geräts abzurufen.

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

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

Ausgabe
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

Ruft einen Fehlerbericht vom Gerät ab.

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

Returns
InputStreamSource Ein InputStreamSource, das bei Bedarf den Inhalt des Fehlerberichts generiert. Im Falle eines Fehlers erzeugt InputStreamSource ein leeres ERROR(/InputStream).

getBugreportz

public InputStreamSource getBugreportz ()

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

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

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

getBuildAlias

public String getBuildAlias ()

Rufen Sie den Alias des Builds ab, den das Gerät derzeit ausführt.

Der Build-Alias ist in der Regel ein besser lesbarer String als die Build-ID (in der Regel eine Zahl für Nexus-Builds). Die endgültige Android-Version 4.2 hat beispielsweise den Build-Alias JDQ39 und die Build-ID 573038.

Returns
String Den Build-Alias oder Fallback auf die Build-ID, wenn diese nicht abgerufen werden konnte

Ausgabe
DeviceNotAvailableException

getBuildFlavor

public String getBuildFlavor ()

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

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

Ausgabe
DeviceNotAvailableException

getBuildId

public String getBuildId ()

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

Returns
String Die Build-ID oder IBuildInfo#UNKNOWN_BUILD_ID, falls sie nicht abgerufen werden konnte

Ausgabe
DeviceNotAvailableException

getBuildSigningKeys

public String getBuildSigningKeys ()

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

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

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

Ausgabe
DeviceNotAvailableException

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

Returns
DeviceDescriptor

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

Returns
DeviceDescriptor

getChildren

public String[] getChildren (String path)

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

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

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

Ausgabe
DeviceNotAvailableException

getConnection

public AbstractConnection getConnection ()

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

Returns
AbstractConnection

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

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

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

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

Returns
ContentProviderHandler

Ausgabe
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

Returns
DeviceFoldableState

Ausgabe
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

Returns
int

Ausgabe
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

Geräteklasse abrufen

Returns
String der Geräteklasse String.

getDeviceDate

public long getDeviceDate ()

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

Returns
long Das Datum des Geräts im Epochenformat.

Ausgabe
DeviceNotAvailableException

getDeviceDescriptor,

public DeviceDescriptor getDeviceDescriptor ()

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

Returns
DeviceDescriptor

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

Returns
DeviceDescriptor

getDeviceState

public TestDeviceState getDeviceState ()

Rufe den Status des Geräts ab.

Returns
TestDeviceState

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Hilfsfunktion, um den Zeitunterschied zwischen dem Gerät und einem bestimmten ERROR(/Date) zu ermitteln. Verwenden Sie die Epochenzeit intern.

Parameter
date Date

Returns
long Differenz in Millisekunden

Ausgabe
DeviceNotAvailableException

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

Stream von stdout und stderr des Emulators abrufen

Returns
InputStreamSource Emulatorausgabe

getEmulatorProcess

public Process getEmulatorProcess ()

Geben Sie die Process zurück, die diesem Emulator entspricht.

Returns
Process die Process oder null

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

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

Returns
File

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

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

Returns
long den freien Speicherplatz in KB

Ausgabe
DeviceNotAvailableException

getFastbootPath

public String getFastbootPath ()

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

Returns
String

getFastbootProductType (GetFastbootProductType)

public String getFastbootProductType ()

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

Diese Methode sollte nur verwendet werden, wenn sich das Gerät im Fastboot-Modus befindet. Dies ist in diesem Fall eine etwas sicherere Variante als die generische getProductType()-Methode, da ITestDevice weiß, dass das Gerät in den Fastboot-Modus wiederhergestellt werden kann, wenn sich das Gerät im falschen Zustand befindet oder nicht reagiert.

Returns
String den Namen des String-Produkttyps oder null, falls er nicht ermittelt werden kann

Ausgabe
DeviceNotAvailableException

GetFastbootProductVariant

public String getFastbootProductVariant ()

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

Diese Methode sollte nur verwendet werden, wenn das Gerät im Schnellstartmodus (Fastboot mode) aktiviert sein soll. Dies ist in diesem Fall eine etwas sicherere Variante als die generische getProductType()-Methode, da ITestDevice weiß, dass das Gerät in den Fastboot-Modus wiederhergestellt werden kann, wenn sich das Gerät im falschen Zustand befindet oder nicht reagiert.

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

Ausgabe
DeviceNotAvailableException

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Gibt die Seriennummer des Fastboot-Modus zurück.

Returns
String

getFastbootVariable

public String getFastbootVariable (String variableName)

Rufen Sie den angegebenen Wert der Fastboot-Variable vom Gerät ab.

Parameter
variableName String: den Variablennamen

Returns
String den Property-Wert oder null, falls er nicht vorhanden ist

Ausgabe
DeviceNotAvailableException

getFastbootVersion

public String getFastbootVersion ()

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

Returns
String

getFileEntry

public IFileEntry getFileEntry (String path)

Eine Referenz auf eine Remotedatei auf dem Gerät abrufen

Parameter
path String: Der Pfad zur abzurufenden Datei. Dies kann ein absoluter Pfad oder ein Pfad relativ zu „/“ sein. Das heißt, sowohl die Syntax „/system“ als auch „system“ wird unterstützt.

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

Ausgabe
DeviceNotAvailableException

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

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

Parameter
entry FileListingService.FileEntry: Ein FileEntry, das nicht unbedingt der Root sein muss, wie von Ddmlib gefordert.

Returns
IFileEntry einen FileEntryWrapper, der den FileEntry darstellt.

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

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

Returns

Ausgabe
DeviceNotAvailableException

getIDevice

public IDevice getIDevice ()

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

Jedes Mal, wenn die Verbindung des Geräts zu adb getrennt und wiederhergestellt wird, kann von DDMS eine neue IDevice zugewiesen werden. Daher sollten Aufrufer keinen Verweis auf die IDevice speichern, da dieser Verweis möglicherweise veraltet.

Returns
IDevice die IDevice

getInstalledPackageNames

public  getInstalledPackageNames ()

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

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

Ausgabe
DeviceNotAvailableException

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

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

Parameter
name String: der Property-Name

defaultValue long: Standardwert, der zurückgegeben wird, wenn das Attribut leer ist oder nicht vorhanden ist.

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

Ausgabe
DeviceNotAvailableException

getIpAddress

public String getIpAddress ()

Ruft die IP-Adresse des Geräts ab.

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

Ausgabe
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Gibt ein Objekt zurück, um den aktuellen Status des Keyguard oder null abzurufen, wenn dies nicht unterstützt wird.

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

Ausgabe
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

Gibt in Millisekunden zurück, wann die Tradefed APIs zuletzt einen Neustart ausgelöst haben, seit EPOCH von System.currentTimeMillis() zurückgegeben wurde.

Returns
long

getLaunchApiLevel

public int getLaunchApiLevel ()

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

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

Ausgabe
DeviceNotAvailableException

getLogcat

public InputStreamSource getLogcat ()

Erfasst einen Snapshot-Stream der Logcat-Daten.

Es gibt zwei Modi:

  • Wenn der Logcat derzeit im Hintergrund erfasst wird, werden bis zu TestDeviceOptions.getMaxLogcatDataSize() Byte des aktuellen Inhalts der Logcat-Aufzeichnung im Hintergrund zurückgegeben.
  • Andernfalls wird ein statischer Dump der Logcat-Daten zurückgegeben, wenn das Gerät derzeit antwortet.

    Returns
    InputStreamSource

  • getLogcat

    public InputStreamSource getLogcat (int maxBytes)

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

    Nützlich, wenn Sie häufige Snapshots der erfassten Logcat-Daten erstellen möchten, ohne den potenziellen hohen Speicherplatzbedarf für den gesamten getLogcat()-Snapshot in Kauf nehmen zu müssen.

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

    Returns
    InputStreamSource

    getLogcatDump

    public InputStreamSource getLogcatDump ()

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

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

    Returns
    InputStreamSource eine InputStreamSource der Logcat-Daten. Wenn die Erfassung von Logcat-Daten fehlschlägt, wird ein leerer Stream zurückgegeben.

    getLogcatSince

    public InputStreamSource getLogcatSince (long date)

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

    Parameter
    date long: Startzeit des Snapshots bis zum aktuellen Zeitpunkt in Millisekunden seit der Epoche. (kann über 'Datum +%s' abgerufen werden)

    Returns
    InputStreamSource

    getMacAddress

    public String getMacAddress ()

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

    Returns
    String

    getMainUserId

    public Integer getMainUserId ()

    Gibt die Hauptnutzer-ID zurück.

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

    Ausgabe
    DeviceNotAvailableException

    getMainlineModuleInfo

    public  getMainlineModuleInfo ()

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

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

    Ausgabe
    DeviceNotAvailableException

    getMaxNumberOfRunningUsersSupported

    public int getMaxNumberOfRunningUsersSupported ()

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

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

    Ausgabe
    DeviceNotAvailableException

    getMaxNumberOfUsersSupported

    public int getMaxNumberOfUsersSupported ()

    Maximal unterstützte Nutzerzahl abrufen Die Standardeinstellung ist 0.

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

    Ausgabe
    DeviceNotAvailableException

    getMicrodroidProcess

    public Process getMicrodroidProcess ()

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

    getMonitor

    public IDeviceStateMonitor getMonitor ()

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

    Returns
    IDeviceStateMonitor

    getMountPoint

    public String getMountPoint (String mountName)

    Gibt einen Bereitstellungspunkt zurück.

    Das Gerät wird direkt abgefragt, wenn die im Cache in IDevice gespeicherten Informationen nicht verfügbar sind.

    TODO: dieses Verhalten zu IDevice#getMountPoint(String) verschieben

    Parameter
    mountName String: der Name des Bereitstellungspunkts

    Returns
    String den Bereitstellungspunkt oder null

    getMountPointInfo

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

    Gibt ein MountPointInfo zurück, das dem angegebenen Bereitstellungspunktpfad entspricht, oder null, wenn an diesem Pfad nichts bereitgestellt ist oder er anderweitig nicht in /proc/mounts als Bereitstellungspunkt aufgeführt ist.

    Parameter
    mountpoint String

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

    Ausgabe
    DeviceNotAvailableException

    getMountPointInfo

    public  getMountPointInfo ()

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

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

    Ausgabe
    DeviceNotAvailableException

    getOptions

    public TestDeviceOptions getOptions ()

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

    Returns
    TestDeviceOptions TestDeviceOptions zum Testgerät.

    getPartitionFreeSpace

    public long getPartitionFreeSpace (String partition)

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

    Parameter
    partition String

    Returns
    long den freien Speicherplatz in KB

    Ausgabe
    DeviceNotAvailableException

    getPrimaryUserId

    public Integer getPrimaryUserId ()

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

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

    Ausgabe
    DeviceNotAvailableException

    getProcessByName

    public ProcessInfo getProcessByName (String processName)

    Die Hilfsmethode führt die Befehle "pidof" und "stat" aus und gibt das Objekt ProcessInfo mit PID und Prozessstartzeit des angegebenen Prozesses zurück.

    Parameter
    processName String: der String des Vorgangsnamens.

    Returns
    ProcessInfo ProcessInfo des angegebenen processName

    Ausgabe
    DeviceNotAvailableException

    getProcessPid

    public String getProcessPid (String process)

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

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

    Returns
    String

    Ausgabe
    DeviceNotAvailableException

    getProductType

    public String getProductType ()

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

    Diese Methode funktioniert, wenn sich das Gerät entweder im ADB- oder im Schnellstartmodus (Fastboot mode) befindet.

    Returns
    String den Namen des String-Produkttyps. darf nicht null sein

    Ausgabe
    DeviceNotAvailableException

    getProductVariant

    public String getProductVariant ()

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

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

    Returns
    String den Namen der String-Produktvariante oder null, falls dieser nicht ermittelt werden kann

    Ausgabe
    DeviceNotAvailableException

    getProperty

    public String getProperty (String name)

    Ruft den angegebenen Attributwert vom Gerät ab.

    Parameter
    name String: der Name der Property

    Returns
    String den Property-Wert oder null, falls er nicht vorhanden ist

    Ausgabe
    DeviceNotAvailableException

    getRecoveryMode

    public ITestDevice.RecoveryMode getRecoveryMode ()

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

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

    getScreenshot

    public InputStreamSource getScreenshot (long displayId)

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

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

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

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

    Ausgabe
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format)

    Erstellt einen Screenshot vom Gerät. Es wird empfohlen, stattdessen getScreenshot(format) mit der JPEG-Codierung für eine kleinere Größe zu verwenden.

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

    Parameter
    format String: unterstützt PNG, JPEG

    rescale boolean: ob der Screenshot neu 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 einen InputStreamSource des Screenshots im PNG-Format oder null, wenn der Screenshot nicht erfolgreich war.

    Ausgabe
    DeviceNotAvailableException

    getSerialNumber

    public String getSerialNumber ()

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

    Returns
    String die Seriennummer String

    getSetting

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

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

    Parameter
    userId int

    namespace String

    key String

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

    Ausgabe
    DeviceNotAvailableException

    getSetting

    public String getSetting (String namespace, 
                    String key)

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

    Parameter
    namespace String

    key String

    Returns
    String

    Ausgabe
    DeviceNotAvailableException

    getSimOperator

    public String getSimOperator ()

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

    Returns
    String

    getSimState

    public String getSimState ()

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

    Returns
    String

    getTombstones

    public  getTombstones ()

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

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

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

    Ausgabe
    DeviceNotAvailableException

    getTotalMemory

    public long getTotalMemory ()

    Gibt die Gesamtgröße des physischen Arbeitsspeichers in Byte zurück oder -1 bei einem internen Fehler.

    Returns
    long

    getTrackingSerial

    public String getTrackingSerial ()

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

    Returns
    String

    getUninstallablePackageNames

    public  getUninstallablePackageNames ()

    Rufen Sie die App-Paketnamen ab, die deinstalliert werden können. Dies wird derzeit als Nicht-Systempakete und aktualisierte Systempakete definiert.

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

    Ausgabe
    DeviceNotAvailableException

    getUseFastbootErase

    public boolean getUseFastbootErase ()

    Legen Sie fest, ob eine Partition auf dem Gerät mithilfe des Fastboot-Lösch- oder Fastboot-Formats gelöscht werden soll.

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

    getUserFlags

    public int getUserFlags (int userId)

    Findet die Flags eines bestimmten Nutzers und gibt sie zurück. Flags werden im Android Open Source Project in der Klasse „android.content.pm.UserInfo“ definiert.

    Parameter
    userId int

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

    Ausgabe
    DeviceNotAvailableException

    getUserInfos

    public  getUserInfos ()

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

    Returns
    Die Liste der UserInfo-Objekte.

    Ausgabe
    DeviceNotAvailableException

    getUserSerialNumber

    public int getUserSerialNumber (int userId)

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

    Parameter
    userId int

    Returns
    int

    Ausgabe
    DeviceNotAvailableException

    HandleAllocationEvent (HandleAllocationEvent)

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

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

    DeviceEvent verarbeiten, wodurch dieses Gerät möglicherweise in einen neuen Zuweisungsstatus geändert wird.

    Parameter
    event DeviceEvent

    Returns
    IManagedTestDevice.DeviceEventResponse

    hasFeature

    public boolean hasFeature (String feature)

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

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

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

    Ausgabe
    DeviceNotAvailableException

    installPackage

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

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

    Parameter
    packageFile File: die zu installierende APK-Datei

    reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll

    extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.

    Returns
    String String mit einem Fehlercode oder null bei Erfolg.

    Ausgabe
    DeviceNotAvailableException

    installPackage

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

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

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

    Parameter
    packageFile File: die zu installierende APK-Datei

    reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll

    grantPermissions boolean: ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen

    extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.

    Returns
    String String mit einem Fehlercode oder null bei Erfolg.

    Ausgabe
    DeviceNotAvailableException

    installPackageForUser

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

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

    Parameter
    packageFile File: die zu installierende APK-Datei

    reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll

    userId int: Die Ganzzahl-Nutzer-ID, für die die Installation erfolgen soll.

    extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.

    Returns
    String String mit einem Fehlercode oder null bei Erfolg.

    Ausgabe
    DeviceNotAvailableException

    installPackageForUser

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

    Sie installieren ein Android-Paket für einen bestimmten Nutzer auf dem Gerät.

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

    Parameter
    packageFile File: die zu installierende APK-Datei

    reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll

    grantPermissions boolean: ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen

    userId int: Die Ganzzahl-Nutzer-ID, für die die Installation erfolgen soll.

    extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.

    Returns
    String String mit einem Fehlercode oder null bei Erfolg.

    Ausgabe
    DeviceNotAvailableException

    invalidatePropertyCache

    public void invalidatePropertyCache ()

    isAdbRoot

    public boolean isAdbRoot ()

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    isAdbTcp

    public boolean isAdbTcp ()

    Returns
    boolean

    isAppEnumerationSupported

    public boolean isAppEnumerationSupported ()

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

    Returns
    boolean „True“, wenn die App-Enumeration unterstützt wird, andernfalls „False“

    Ausgabe
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public boolean isBypassLowTargetSdkBlockSupported ()

    Prüfen, ob die Plattform auf dem Gerät das Umgehen eines niedrigen SDK-Zielblocks bei App-Installationen unterstützt

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

    Ausgabe
    DeviceNotAvailableException

    isDebugfsMounted

    public boolean isDebugfsMounted ()

    Prüfen Sie, ob debugfs bereitgestellt ist.

    Returns
    boolean true, wenn debugfs bereitgestellt ist

    Ausgabe
    DeviceNotAvailableException

    isDeviceEncrypted

    public boolean isDeviceEncrypted ()

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

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

    Ausgabe
    DeviceNotAvailableException

    isDirectory

    public boolean isDirectory (String path)

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

    Parameter
    path String

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    isEnableAdbRoot

    public boolean isEnableAdbRoot ()

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

    isEncryptionSupported

    public boolean isEncryptionSupported ()

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

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

    Ausgabe
    DeviceNotAvailableException

    isExecutable

    public boolean isExecutable (String fullPath)

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

    Parameter
    fullPath String

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    isFastbootEnabled

    public boolean isFastbootEnabled ()

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

    Returns
    boolean

    isHeadless

    public boolean isHeadless ()

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

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    isHeadlessSystemUserMode

    public boolean isHeadlessSystemUserMode ()

    Gibt an, ob auf dem Gerät der headless Systemnutzermodus verwendet wird.

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    isMainUserPermanentAdmin

    public boolean isMainUserPermanentAdmin ()

    Gibt zurück, ob der Hauptnutzer ein dauerhafter Administrator ist und weder gelöscht noch auf einen Nicht-Administratorstatus herabgestuft werden kann.

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    isMultiUserSupported

    public boolean isMultiUserSupported ()

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

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

    Ausgabe
    DeviceNotAvailableException

    isPackageInstalled

    public boolean isPackageInstalled (String packageName, 
                    String userId)

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

    Parameter
    packageName String: Das Paket, das geprüft wird, ob es installiert ist.

    userId String: Die Nutzer-ID, für die geprüft wird, ob das Paket installiert ist. Wenn dieser Wert null ist, wird für den primären Nutzer null verwendet.

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

    Ausgabe
    DeviceNotAvailableException

    isPackageInstalliert

    public boolean isPackageInstalled (String packageName)

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

    Parameter
    packageName String

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

    Ausgabe
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public boolean isRuntimePermissionSupported ()

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

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

    Ausgabe
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public boolean isStateBootloaderOrFastbootd ()

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

    Returns
    boolean

    isUserRunning

    public boolean isUserRunning (int userId)

    Prüfen, ob ein bestimmter Nutzer aktiv ist

    Parameter
    userId int

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

    Ausgabe
    DeviceNotAvailableException

    isUserSecondary

    public boolean isUserSecondary (int userId)

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

    Parameter
    userId int

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

    Ausgabe
    DeviceNotAvailableException

    isUserVisible

    public boolean isUserVisible (int userId)

    Prüft, ob der angegebene Nutzer sichtbar ist.

    Ein „sichtbarer“ Nutzer ist ein Nutzer, der mit dem „menschlichen“ Nutzer interagiert und daher Startaktivitäten starten kann (normalerweise in der Standardanzeige).

    Parameter
    userId int

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    isUserVisibleOnDisplay

    public boolean isUserVisibleOnDisplay (int userId, 
                    int displayId)

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

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

    Parameter
    userId int

    displayId int

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    isVisibleBackgroundUsersOnDefaultDisplaySupported

    public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    isVisibleBackgroundUsersSupported

    public boolean isVisibleBackgroundUsersSupported ()

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

    In diesem Fall könnten Sie startVisibleBackgroundUser(int, int, boolean) aufrufen und eine von listDisplayIdsForStartingVisibleBackgroundUsers() zurückgegebene Anzeige ü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 zur Bestätigung des WLAN-Status vor Tests, die nicht mit dem WLAN durchgeführt werden sollten, z.B. Tests für mobile Daten.

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

    Ausgabe
    DeviceNotAvailableException

    listDisplayIds

    public  listDisplayIds ()

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

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

    Ausgabe
    DeviceNotAvailableException

    listDisplayIdsForStartingVisibleBackgroundUsers

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

    Returns

    Ausgabe
    DeviceNotAvailableException

    Nutzer auflisten

    public  listUsers ()

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

    Returns
    die Liste der Nutzer-IDs.

    Ausgabe
    DeviceNotAvailableException

    logAnrs

    public boolean logAnrs (ITestLogger logger)

    Erfasst und protokolliert ANRs auf dem Gerät.

    Parameter
    logger ITestLogger: Ein ITestLogger zum Protokollieren der ANR-Fehler.

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

    Ausgabe
    DeviceNotAvailableException

    logBugreport

    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

    Hilfsmethode, um einen Fehlerbericht zu erstellen und bei den Reportern zu protokollieren.

    Parameter
    dataName String ist der Name, unter dem der Fehlerbericht gemeldet wird.

    listener ITestLogger: Ein 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 nicht fehlschlägt, wenn die Protokollierung fehlschlägt.

    Parameter
    tag String: Das Tag, unter dem wir unsere Nachricht im Logcat protokollieren.

    level Log.LogLevel: Die Debugebene der Nachricht im Logcat.

    format String: Das Nachrichtenformat.

    args Object: Die Argumente, die über String.format() ersetzt werden sollen.

    mountDebugfs

    public void mountDebugfs ()

    debugfs bereitstellen

    Ausgabe
    DeviceNotAvailableException

    nonBlockingReboot

    public void nonBlockingReboot ()

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

    Ausgabe
    DeviceNotAvailableException

    postAdbRootAction

    public void postAdbRootAction ()

    Überschreibt, wenn für das Gerät bestimmte Aktionen nach dem ADB-Root und bevor das Gerät wieder online ist. Die Standardimplementierung enthält keine zusätzlichen Aktionen. Es ist nicht garantiert, dass der ADB-Stamm zu diesem Zeitpunkt aktiviert ist.

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postAdbUnrootAction

    public void postAdbUnrootAction ()

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

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public void postBootSetup ()

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

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

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

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

    Ausgabe
    DeviceNotAvailableException

    postInvocationTearDown

    public void postInvocationTearDown (Throwable exception)

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

    Parameter
    exception Throwable: falls vorhanden, die letzte durch den Aufruffehler ausgelöste Ausnahme.

    preInvocationSetup

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

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

    Parameter
    info IBuildInfo: Die IBuildInfo des Geräts.

    attributes MultiMap: Die im Aufrufkontext gespeicherten Attribute

    Ausgabe
    DeviceNotAvailableException
    TargetSetupError

    pullDir

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

    Verzeichnisinhalte rekursiv vom Gerät abrufen.

    Parameter
    deviceFilePath String: der absolute Dateipfad der Remote-Quelle

    localDir File: das lokale Verzeichnis, in das Dateien abgerufen werden sollen

    userId int: die Nutzer-ID, aus der Daten abgerufen werden sollen

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

    Ausgabe
    DeviceNotAvailableException

    pullDir

    public boolean pullDir (String deviceFilePath, 
                    File localDir)

    Verzeichnisinhalte rekursiv vom Gerät abrufen.

    Parameter
    deviceFilePath String: der absolute Dateipfad der Remote-Quelle

    localDir File: das lokale Verzeichnis, in das Dateien gezogen werden sollen

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

    Ausgabe
    DeviceNotAvailableException

    Pull-Datei

    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 der Inhalt gespeichert werden soll. Wenn das Feld nicht leer ist, wird der Inhalt ersetzt.

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

    Ausgabe
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath, 
                    int userId)

    Ruft eine Datei vom Gerät ab, speichert sie in einer lokalen temporären ERROR(/File) und gibt diese 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 Ein 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 Ein 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

    Pull-Datei

    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 der Inhalt gespeichert werden soll. Wenn das Feld nicht leer ist, wird der Inhalt ersetzt.

    userId int: Die Nutzer-ID, aus der Daten abgerufen werden sollen

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

    Ausgabe
    DeviceNotAvailableException

    pullFileContents

    public String pullFileContents (String remoteFilePath)

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

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

    Returns
    String Eine String mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (z. B. aufgrund von Problemen mit dem Hostdateisystem)

    Ausgabe
    DeviceNotAvailableException

    pullFileFromExternal

    public File pullFileFromExternal (String remoteFilePath)

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

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

    Returns
    File Eine ERROR(/File) mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (z. B. aufgrund von Problemen mit dem Hostdateisystem)

    Ausgabe
    DeviceNotAvailableException

    pushDir

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

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

    Parameter
    localFileDir File: das lokale Verzeichnis, das übertragen werden soll

    deviceFilePath String: der absolute Dateipfad des Remote-Ziels

    excludedDirectories : Liste der auszuschließenden Verzeichnisnamen, die nicht gepusht werden sollen.

    Returns
    boolean true, wenn die Datei ü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 ü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 gesendet werden soll

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

    Parameter
    localFile File: die lokale Datei, die gepusht werden soll

    remoteFilePath String: der absolute Dateipfad des Remote-Ziels

    evaluateContentProviderNeeded boolean: ob geprüft werden soll, ob wir den Contentanbieter benötigen

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

    Ausgabe
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

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

    Parameter
    localFile File: die lokale Datei, die gepusht werden soll

    remoteFilePath String: der absolute Dateipfad des Remote-Ziels

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

    Ausgabe
    DeviceNotAvailableException

    pushFile

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

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

    Parameter
    localFile File: die lokale Datei, die gepusht werden soll

    remoteFilePath String: der absolute Dateipfad des Remote-Ziels

    userId int: die userId, an die gepusht werden soll

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

    Ausgabe
    DeviceNotAvailableException

    Push-String

    public boolean pushString (String contents, 
                    String remoteFilePath)

    Aus einem String erstellte Datei per Push an Gerät übertragen

    Parameter
    contents String: der Inhalt der zu übertragenden Datei

    remoteFilePath String: der absolute Dateipfad des Remote-Ziels

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

    Ausgabe
    DeviceNotAvailableException

    neu starten

    public void reboot (String reason)

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

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

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

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

    Ausgabe
    DeviceNotAvailableException

    neu starten

    public void reboot ()

    Startet das Gerät im ADB-Modus neu.

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

    Ausgabe
    DeviceNotAvailableException

    NeustartIntoBootloader

    public void rebootIntoBootloader ()

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

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

    Ausgabe
    DeviceNotAvailableException

    NeustartIntoFastbootd

    public void rebootIntoFastbootd ()

    Startet das Gerät im Fastbootd-Modus neu.

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

    Ausgabe
    DeviceNotAvailableException

    rebootIntoRecovery

    public void rebootIntoRecovery ()

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

    Blockiert, bis das Gerät in den Wiederherstellungsmodus wechselt

    Ausgabe
    DeviceNotAvailableException

    NeustartIntoSideload

    public void rebootIntoSideload ()

    Startet das Gerät im adb-Sideload-Modus neu. Hinweis: Dies ist ein spezieller Modus unter Wiederherstellung.

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

    Ausgabe
    DeviceNotAvailableException

    NeustartIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

    Startet das Gerät im adb-Sideload-Modus neu. Hinweis: Dies ist ein spezieller Modus unter Wiederherstellung.

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

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

    Ausgabe
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline ()

    Eine Alternative zu reboot(), die nur blockiert, bis das Gerät online ist, 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.

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

    Ausgabe
    DeviceNotAvailableException

    Nutzerbereich neu starten

    public void rebootUserspace ()

    Startet nur den Nutzerbereich des Geräts neu.

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

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

    Ausgabe
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

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

    Ausgabe
    DeviceNotAvailableException

    recoverDevice

    public boolean recoverDevice ()

    Es wird versucht, die Gerätekommunikation wiederherzustellen.

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

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

    registerDeviceActionReceiver

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    Registriert eine IDeviceActionReceiver für dieses Gerät.

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

    Parameter
    deviceActionReceiver IDeviceActionReceiver: Ein IDeviceActionReceiver, das registriert wird.

    remountSystemReadOnly

    public void remountSystemReadOnly ()

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

    Ausgabe
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

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

    Ausgabe
    DeviceNotAvailableException

    remountVendorReadOnly

    public void remountVendorReadOnly ()

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

    Ausgabe
    DeviceNotAvailableException

    remountVendorWritable (remountVendorWritable)

    public void remountVendorWritable ()

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

    Ausgabe
    DeviceNotAvailableException

    removeAdmin

    public boolean removeAdmin (String componentName, 
                    int userId)

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

    Parameter
    componentName String: des zu entfernenden Geräteadministrators.

    userId int: des Nutzers, in dessen Land sich der Geräteadministrator befindet.

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

    Ausgabe
    DeviceNotAvailableException

    removeOwners

    public void removeOwners ()

    Entfernen Sie nach Möglichkeit alle vorhandenen Geräteprofileigentümer.

    Ausgabe
    DeviceNotAvailableException

    Nutzer entfernen

    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 die Markierung für die Einrichtung des Contentanbieters zurück, um ihn noch einmal auszulösen.

    runInstrumentationTests

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

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

    Parameter
    runner IRemoteAndroidTestRunner: die IRemoteAndroidTestRunner, die die Tests ausführt

    listeners ITestLifeCycleReceiver: die Testergebnis-Listener

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

    Ausgabe
    DeviceNotAvailableException

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                     listeners)

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

    Wenn die Verbindung zum Gerät vor Abschluss des Tests unterbrochen wird und die Wiederherstellung erfolgreich ist, werden alle Listener über „testRunFailed“ informiert und „false“ wird zurückgegeben. Der Testbefehl wird nicht noch einmal ausgeführt. Anrufer müssen bei Bedarf noch einmal versuchen, eine Verbindung herzustellen.

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

    Parameter
    runner IRemoteAndroidTestRunner: die IRemoteAndroidTestRunner, auf der die Tests ausgeführt werden

    listeners : die Testergebnis-Listener

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

    Ausgabe
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

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

    Parameter
    runner IRemoteAndroidTestRunner

    userId int

    listeners

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

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

    Parameter
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    setConfiguration

    public void setConfiguration (IConfiguration configuration)

    Fügt den verwendeten IConfiguration ein.

    Parameter
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    Parameter
    avdInfo GceAvdInfo

    setDate

    public void setDate (Date date)

    Das Datum auf dem Gerät wird festgelegt.

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

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

    Ausgabe
    DeviceNotAvailableException

    Geräteinhaber festlegen

    public boolean setDeviceOwner (String componentName, 
                    int userId)

    Komponente zur Geräteverwaltung für einen bestimmten Nutzer als Geräteinhaber festlegen

    Parameter
    componentName String: des Geräteadministrators als Geräteinhaber

    userId int: des Nutzers, in dessen Land sich der Geräteinhaber befindet.

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

    Ausgabe
    DeviceNotAvailableException

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

    Aktualisieren Sie den Status des Geräts.

    Parameter
    deviceState TestDeviceState: die TestDeviceState

    setEmulatorOutputStream

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

    Für den Emulator SizeLimitedOutputStream auf „Logausgabe“ festlegen

    Parameter
    output SizeLimitedOutputStream: Ausgabe protokollieren

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

    Legt den Process fest, wenn 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: ob Fastboot für das Gerät verfügbar ist

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

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

    Parameter
    fastbootPath String

    setIDevice

    public void setIDevice (IDevice newDevice)

    Aktualisieren Sie das mit diesem ITestDevice verknüpfte IDevice.

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

    Parameter
    newDevice IDevice: die IDevice

    setLogStartDelay

    public void setLogStartDelay (int delay)

    Legt die Wartezeit in ms fest, bevor die Logcat-Erfassung für ein Onlinegerät gestartet wird.

    Parameter
    delay int: die Verzögerung in ms

    setOptions

    public void setOptions (TestDeviceOptions options)

    TestDeviceOptions für das Gerät festlegen

    Parameter
    options TestDeviceOptions

    setProperty

    public boolean setProperty (String propKey, 
                    String propValue)

    Legt den angegebenen Property-Wert auf dem Gerät fest. Erfordert, dass „adb root“ auf „wahr“ gesetzt ist.

    Parameter
    propKey String: Der Schlüssel, der festgelegt werden soll.

    propValue String: Der festzulegende Attributwert.

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

    Ausgabe
    DeviceNotAvailableException

    Wiederherstellung festlegen

    public void setRecovery (IDeviceRecovery recovery)

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

    Parameter
    recovery IDeviceRecovery: die IDeviceRecovery

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

    Hiermit wird festgelegt, welche Wiederherstellungsmethode verwendet werden soll, wenn ein Problem mit der Gerätekommunikation auftritt. Es wird empfohlen, diese Methode nur sparsam zu verwenden, wenn sie benötigt wird (z. B. wenn das Framework ausgefallen ist usw.)

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

    setSetting

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

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

    Parameter
    namespace String

    key String

    value String

    Ausgabe
    DeviceNotAvailableException

    setSetting

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

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

    Parameter
    userId int

    namespace String

    key String

    value String

    Ausgabe
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    ITestLogger-Instanz einschleust

    Parameter
    testLogger ITestLogger

    setTrackingSerial

    public void setTrackingSerial (String trackingSerial)

    Für die Geräteverwaltung die Seriennummer erfassen, die wir für die Referenzierung des Geräts verwenden.

    Parameter
    trackingSerial String

    setUseFastbootErase

    public void setUseFastbootErase (boolean useFastbootErase)

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

    Parameter
    useFastbootErase boolean: true, wenn Daten mit Fastboot-Löschung gelöscht werden sollen, oder false, wenn das Fastboot-Format verwendet werden soll.

    startLogcat

    public void startLogcat ()

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

    Dies hat keine Auswirkungen, wenn die Logcat-Ausgabe bereits erfasst wird. Die Daten können später über getLogcat abgerufen werden.

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

    startLogcat() und stopLogcat() müssen normalerweise nicht aufgerufen werden, wenn sie sich im Kontext eines TF-Aufrufs befinden, da das TF-Framework Logcat startet und beendet.

    startUser (Startnutzer)

    public boolean startUser (int userId)

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

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

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

    Ausgabe
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId, 
                    boolean waitFlag)

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

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

    waitFlag boolean: Der Befehl wartet, bis der Nutzer gestartet und entsperrt wird.

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

    Ausgabe
    DeviceNotAvailableException

    startVisibleBackgroundUser

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

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

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

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

    displayId int: Display, auf dem die Benachrichtigung für Nutzer sichtbar sein soll

    waitFlag boolean: Der Befehl wartet, bis der Nutzer gestartet und entsperrt ist.

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

    Ausgabe
    DeviceNotAvailableException

    stopEmulatorOutput

    public void stopEmulatorOutput ()

    Schließen und löschen Sie die Emulatorausgabe.

    stopLogcat

    public void stopLogcat ()

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

    Dies hat keine Auswirkungen, wenn die Logcat-Ausgabe nicht erfasst wird.

    stopUser

    public boolean stopUser (int userId)

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

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

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

    Ausgabe
    DeviceNotAvailableException

    stopUser

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

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

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

    waitFlag boolean: Der Befehl wartet, bis der Nutzer gestoppt wird.

    forceFlag boolean: wird der Nutzer zwangsweise beendet.

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

    Ausgabe
    DeviceNotAvailableException

    switchToAdbTcp

    public String switchToAdbTcp ()

    Wechseln Sie auf dem Gerät in den ADB-over-tcp-Modus.

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

    Ausgabe
    DeviceNotAvailableException

    switchToAdbUsb

    public boolean switchToAdbUsb ()

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

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

    Ausgabe
    DeviceNotAvailableException

    SwitchUser

    public boolean switchUser (int userId)

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

    Parameter
    userId int

    Returns
    boolean "True", wenn die neue userId mit dem userId-Anbieter übereinstimmt. Andernfalls „false“.

    Ausgabe
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId, 
                    long timeout)

    Wechseln Sie zu einer anderen Nutzer-ID mit dem angegebenen Zeitlimit als Frist. Es wurde versucht, den Keyguard zu deaktivieren, nachdem die Benutzeränderung erfolgreich war.

    Parameter
    userId int

    timeout long: Wartezeit, bevor „false“ zurückgegeben wird, wenn der Wechsel des Nutzers fehlgeschlagen ist.

    Returns
    boolean "True", wenn die neue userId mit dem userId-Anbieter übereinstimmt. Andernfalls „false“.

    Ausgabe
    DeviceNotAvailableException

    syncFiles

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

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

    Entscheidet, welche Dateien gepusht werden sollen, indem Zeitstempel lokaler Dateien mit den entsprechenden Remote-Dateien verglichen werden. Es werden nur neuere oder nicht vorhandene Dateien auf das Gerät gepusht. Daher sollte der Aufwand relativ gering sein, wenn der Dateisatz auf dem Gerät bereits auf dem neuesten Stand ist.

    Ausgeblendete Dateien, deren Namen mit „.“ beginnen, werden ignoriert.

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

    Parameter
    localFileDir File: das lokale Dateiverzeichnis mit Dateien, die rekursiv gepusht werden sollen.

    deviceFilePath String: der absolute Pfad des Remote-Zielorders. Alle Verzeichnisse in diesem Dateipfad müssen lesbar sein. Wenn also adb nicht root ist, schlägt das Übertragen in /data/local/tmp fehl.

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

    Ausgabe
    DeviceNotAvailableException

    takeBugreport

    public Bugreport takeBugreport ()

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

    Returns
    Bugreport

    uninstallPackage

    public String uninstallPackage (String packageName)

    Android-Paket vom Gerät deinstallieren

    Parameter
    packageName String: das zu deinstallierende Android-Paket

    Returns
    String String mit einem Fehlercode oder null bei Erfolg.

    Ausgabe
    DeviceNotAvailableException

    deinstallierenPackageForUser

    public String uninstallPackageForUser (String packageName, 
                    int userId)

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

    Parameter
    packageName String: das zu deinstallierende Android-Paket

    userId int: Die Ganzzahl-Nutzer-ID, für die die Deinstallation erfolgen soll.

    Returns
    String String mit einem Fehlercode oder null bei Erfolg.

    Ausgabe
    DeviceNotAvailableException

    Gerät entsperren

    public boolean unlockDevice ()

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

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

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

    Ausgabe
    DeviceNotAvailableException

    unmountDebugfs

    public void unmountDebugfs ()

    Entfernen Sie die Bereitstellung von debugfs.

    Ausgabe
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

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

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

    Returns
    boolean „true“, wenn das Flag „Boot complete“ des Geräts innerhalb des Zeitlimits gesetzt wird

    Ausgabe
    DeviceNotAvailableException

    WaitForDeviceVerfügbar

    public boolean waitForDeviceAvailable ()

    Wartet, bis das Gerät reagiert und zum Testen verfügbar ist. Es wird das Standardzeitlimit verwendet.

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

    Ausgabe
    DeviceNotAvailableException

    WaitForDeviceVerfügbar

    public boolean waitForDeviceAvailable (long waitTime)

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

    Parameter
    waitTime long: die Wartezeit in ms

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

    Ausgabe
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

    Parameter
    waitTime long

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

    Ausgabe
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

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

    Ausgabe
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

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

    Parameter
    waitTime long: die Wartezeit in ms

    Returns
    boolean true, wenn das Gerät vor Ablauf des Zeitlimits in die Wiederherstellung startet. false andernfalls

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

    Blöcke für das Gerät, die sich im Status „ADB-Sideload“ befinden

    Parameter
    waitTime long: die Wartezeit in ms

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

    WaitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

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

    Parameter
    waitTime long: die Wartezeit in ms

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

    waitForDeviceOnline

    public void waitForDeviceOnline ()

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

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

    Ausgabe
    DeviceNotAvailableException

    waitForDeviceOnline

    public void waitForDeviceOnline (long waitTime)

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

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

    Parameter
    waitTime long: die Wartezeit in ms

    Ausgabe
    DeviceNotAvailableException

    waitForDeviceShell

    public boolean waitForDeviceShell (long waitTime)

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

    Parameter
    waitTime long: die Wartezeit in ms

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

    Geschützte Methoden

    addExtraConnectionBuilderArgs

    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

    Parameter
    builder DefaultConnection.ConnectionBuilder

    buildAdbShellCommand

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

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

    Parameter
    command String

    forceExitStatusDetection boolean

    Returns
    String[]

    checkApiLevelAgainst

    protected void checkApiLevelAgainst (String feature, 
                    int strictMinLevel)

    Parameter
    feature String

    strictMinLevel int

    createRebootDeviceAction

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

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

    Parameter
    rebootMode NativeDevice.RebootMode: ein Modus dieses Neustarts.

    reason String: für diesen Neustart.

    Returns
    NativeDevice.RebootDeviceAction den erstellten RebootDeviceAction.

    createRunUtil

    protected IRunUtil createRunUtil ()

    Returns
    IRunUtil

    doAdbReboot

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

    Führen Sie einen ADB-Neustart durch.

    Parameter
    rebootMode NativeDevice.RebootMode: ein Modus dieses Neustarts.

    reason String: für diesen Neustart.

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    ensureRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

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

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getApiLevelSafe

    protected int getApiLevelSafe ()

    Returns
    int

    getLogger

    protected ITestLogger getLogger ()

    Returns
    ITestLogger

    getRunUtil

    protected IRunUtil getRunUtil ()

    Rufen Sie die zu verwendende RunUtil-Instanz ab.

    Returns
    IRunUtil

    initializeConnection

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

    Parameter
    info IBuildInfo

    attributes MultiMap

    Ausgabe
    DeviceNotAvailableException
    TargetSetupError

    InterneGetProperty

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

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

    Parameter
    propName String: Der Name der Geräteeigenschaft, wie von „adb shell getprop“ zurückgegeben

    fastbootVar String: Der Name der zu abfragenden entsprechenden Fastboot-Variablen. Bei null wird keine Fastboot-Abfrage versucht.

    description String: Eine einfache Beschreibung der Variable. Der erste Buchstabe sollte großgeschrieben werden.

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

    Ausgabe
    DeviceNotAvailableException

    isInRebootCallback

    protected boolean isInRebootCallback ()

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

    Returns
    boolean

    istNeuer

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

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

    Parameter
    localFile File

    entry IFileEntry

    Returns
    boolean

    notifyRebootEnded

    protected void notifyRebootEnded ()

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

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    notifyRebootStarted

    protected void notifyRebootStarted ()

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

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Geräteaktion ausführen

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

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

    Parameter
    actionDescription String: Eine kurze Beschreibung der auszuführenden Aktion. Wird nur zu Logging-Zwecken verwendet.

    action NativeDevice.DeviceAction: die auszuführende Aktion

    retryAttempts int: Die Wiederholungsversuche für die Aktion, wenn sie fehlschlägt, die Wiederherstellung aber erfolgreich ist

    Returns
    boolean true, wenn die Aktion erfolgreich war

    Ausgabe
    DeviceNotAvailableException Wiederherstellungsversuch fehlgeschlagen oder maximale Anzahl erfolgloser Versuche

    postAdbReboot

    protected void postAdbReboot ()

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

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    PrePostBootSetup

    protected void prePostBootSetup ()

    Damit kann jeder Gerätetyp (AndroidNativeDevice, TestDevice) diese Methode für eine bestimmte Einrichtung nach dem Booten überschreiben.

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    PullFileInternal

    protected boolean pullFileInternal (String remoteFilePath, 
                    File localFile)

    Parameter
    remoteFilePath String

    localFile File

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    setClock

    protected void setClock (Clock clock)

    Legen Sie die zu verwendende Uhren-Instanz fest.

    Parameter
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

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

    Parameter
    process Process: Prozess der Microdroid-VM.

    SetTestDeviceOptions

    protected void setTestDeviceOptions ( deviceOptions)

    Parameter
    deviceOptions

    SimpleFastbootCommand

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

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

    Parameter
    timeout long

    envVarMap

    fullCmd String

    Returns
    CommandResult

    simpleFastbootCommand

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

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

    Parameter
    timeout long

    fullCmd String

    Returns
    CommandResult

    WaitForDeviceNotAvailable

    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                    long time)

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

    Parameter
    operationDesc String: Der Name des Vorgangs, der auf „nicht verfügbar“ wartet.

    time long: Die Zeit, die gewartet werden soll, bis der Status „Nicht verfügbar“ auftritt.

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