NativeDevice

public class NativeDevice
extends Object implements IManagedTestDevice, IConfigurationReceiver, ITestLoggerReceiver

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


Standardimplementierung eines ITestDevice Nicht-Full-Stack-Android-Geräts.

Zusammenfassung

Verschachtelte Klassen

class NativeDevice.AdbAction

Ein ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) zum Ausführen des Betriebssystembefehls „adb ....“. 

class NativeDevice.AdbShellAction

 

class NativeDevice.RebootDeviceAction

ERROR(DeviceAction/com.android.tradefed.device.NativeDevice.DeviceAction DeviceAction) für den Neustart eines Geräts. 

Konstanten

int INVALID_USER_ID

Zurückgegebener Wert für ungültige oder nicht gefundene Nutzer-IDs: UserHandle hat -10000 definiert

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

die Standardanzahl der Wiederholungsversuche für den Befehl

Fields

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 ein 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 zurück, ob ein Wechsel zum monitorlosen SYSTEM-Nutzer zulässig ist.

boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

Prüfen Sie, ob eine Funktion derzeit mit einer minimal unterstützten Stufe unterstützt wird.

boolean checkConnectivity()

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

boolean clearErrorDialogs()

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

void clearLastConnectedWifiNetwork()

Löscht das zuletzt verbundene WLAN.

void clearLogcat()

Löscht alle akkumulierten Logcat-Daten.

boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

Stellt eine WLAN-Verbindung her.

boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

Stellt eine WLAN-Verbindung her.

boolean connectToWifiNetwork( wifiSsidToPsk)

Stellt eine Verbindung zu einem WLAN her.

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

Stellt eine WLAN-Verbindung her.

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

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

boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

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

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

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 weich gestartet wurde. Dazu wird der aktuelle Systemserver mit dem vorherigen „system_server“ ProcessInfo verglichen.

boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

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

boolean disableAdbRoot()

Deaktiviert den ADB-Root.

void disableKeyguard()

Versucht, den Keyguard zu deaktivieren.

boolean disableNetworkMonitor()

Deaktiviert die Netzwerküberwachung auf dem Gerät.

boolean disconnectFromWifi()

Trennt die Verbindung zum WLAN.

boolean doesFileExist(String deviceFilePath, int userId)

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

boolean doesFileExist(String deviceFilePath)

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

File dumpHeap(String process, String devicePath)

Dump des Heaps vom system_server.

boolean enableAdbRoot()

Aktiviert den ADB-Stamm.

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 bestimmten Zeitlimit ausführt.

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

Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem bestimmten 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 einem Standardzeitlimit 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 lange laufenden Fastboot-Befehl als Systembefehl ausführt.

CommandResult executeLongFastbootCommand( envVarMap, String... cmdArgs)

Hilfsmethode, die einen lange 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 mehr Parametern zur Steuerung des Befehlsverhaltens aus.

void executeShellCommand(String command, IShellOutputReceiver receiver)

Führt den angegebenen adb-Shell-Befehl aus und wiederholt einen mehrfachen Versuch, wenn der Befehl fehlschlägt.

CommandResult executeShellV2Command(String cmd)

Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die ordnungsgemäß mit der Ausgabe des 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 ordnungsgemäß mit der Befehlsausgabe 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 ordnungsgemäß mit der Befehlsausgabeausgabe, 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 mehr Parametern zur Steuerung des Befehlsverhaltens aus.

CommandResult fastbootWipePartition(String partition)

Hilfsmethode zum Löschen einer Partition auf dem Gerät.

getActiveApexes()

Rufen Sie die Informationen zu den auf dem Gerät aktivierten APEXes 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)

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

getAndroidIds()

Erstellen Sie eine Karte mit Android-IDs, die mit Nutzer-IDs übereinstimmen.

int getApiLevel()

API-Level des Geräts abrufen

PackageInfo getAppPackageInfo(String packageName)

Informationen zu einem auf dem Gerät installierten Paket abrufen

getAppPackageInfos()

Informationen zu Paketen abrufen, die auf dem Gerät installiert sind

String getBasebandVersion()

Praktische Methode zum Abrufen der Baseband- bzw. Funkversion dieses Geräts.

Integer getBattery()

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

boolean getBooleanProperty(String name, boolean defaultValue)

Gibt einen booleschen Wert der angegebenen Eigenschaft zurück.

getBootHistory()

Die Hilfsmethode erfasst die Boot-Verlaufszuordnung mit Startzeit und Startgrund.

getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

Die Hilfsmethode erfasst die Bootverlaufszuordnung mit Bootzeit und Bootgrund seit der angegebenen Zeit seit der Epoche ab dem Gerät und der angegebenen Zeiteinheit.

String getBootloaderVersion()

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

InputStreamSource getBugreport()

Ruft einen Fehlerbericht vom Gerät ab.

InputStreamSource getBugreportz()

Ruft einen Fehlerbericht vom Gerät ab

String getBuildAlias()

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

String getBuildFlavor()

Rufen Sie den Build-Flavor 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

Android-Geräte können in der Regel mit Testschlüsseln (wie in AOSP) oder Release-Schlüsseln (von den einzelnen Geräteherstellern kontrolliert) signiert sein.

DeviceDescriptor getCachedDeviceDescriptor()

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

DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

Gibt ein im Cache gespeichertes 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 oder null zurück, wenn nicht verfügbar.

DeviceFoldableState getCurrentFoldableState()

Gibt den aktuellen faltbaren Status des Geräts oder null zurück, wenn Probleme aufgetreten sind.

int getCurrentUser()

Gibt die ID des aktuell ausgeführten Nutzers zurück.

String getDeviceClass()

Rufen Sie die Geräteklasse ab.

long getDeviceDate()

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

DeviceDescriptor getDeviceDescriptor()

Gib ein DeviceDescriptor aus den Geräteinformationen zurück, um Informationen 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 zu erhalten, ohne das tatsächliche Geräteobjekt zu übergeben.

TestDeviceState getDeviceState()

Rufen Sie den Status des Geräts ab.

long getDeviceTimeOffset(Date date)

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

InputStreamSource getEmulatorOutput()

Stream für Emulatoren stdout und stderr 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)

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

String getFastbootVersion()

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

IFileEntry getFileEntry(String path)

Rufen Sie einen Verweis auf eine Remote-Datei auf dem Gerät ab.

IFileEntry getFileEntry(FileListingService.FileEntry entry)

Inoffizielles Hilfsprogramm zum Abrufen eines FileEntry aus einem Nicht-Root-Pfad.

getFoldableStates()

Gibt die Liste der Status des faltbaren Geräts zurück.

IDevice getIDevice()

Gibt einen Verweis auf die verknüpfte ddmlib-IDevice zurück.

getInstalledPackageNames()

Rufen Sie die auf dem Gerät vorhandenen App-Paketnamen 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 in Millisekunden zurück, wann die Tradefed APIs zuletzt einen Neustart ausgelöst haben, seit EPOCH von System.currentTimeMillis() zurückgegeben wurde.

int getLaunchApiLevel()

Das erste API-Level des Geräts abrufen.

InputStreamSource getLogcat()

Erfasst einen Snapshot-Stream der Logcat-Daten.

InputStreamSource getLogcat(int maxBytes)

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

InputStreamSource getLogcatDump()

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

InputStreamSource getLogcatSince(long date)

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

String getMacAddress()

Gibt die MAC-Adresse des Geräts zurück. Wenn keine Abfrage vom Gerät durchgeführt werden kann, wird null zurückgegeben.

Integer getMainUserId()

Gibt die Hauptnutzer-ID zurück.

getMainlineModuleInfo()

Rufen Sie die Informationen zu den auf dem Gerät installierten Mainline-Modulen ab.

int getMaxNumberOfRunningUsersSupported()

Holen Sie sich die maximale Anzahl von Nutzern, die gleichzeitig ausgeführt werden.

int getMaxNumberOfUsersSupported()

Rufen Sie die maximale Anzahl der unterstützten Nutzer ab.

Process getMicrodroidProcess()
IDeviceStateMonitor getMonitor()

Gib die IDeviceStateMonitor zurück, die dem Gerät zugeordnet ist.

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 in diesem Pfad nichts bereitgestellt ist oder anderweitig nicht in /proc/mounts als Bereitstellungspunkt angezeigt wird.

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 Ermitteln der Menge an freiem Speicherplatz 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()

Praktische Methode zum Abrufen des Produkttyps dieses Geräts.

String getProductVariant()

Praktische Methode zum Abrufen der Produktvariante dieses Geräts.

String getProperty(String name)

Ruft den angegebenen Attributwert vom Gerät ab.

ITestDevice.RecoveryMode getRecoveryMode()

Rufen Sie den aktuellen Wiederherstellungsmodus des Geräts ab.

InputStreamSource getScreenshot(String format)

Erstellt einen Screenshot vom Gerät.

InputStreamSource getScreenshot(long displayId)

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

InputStreamSource getScreenshot(String format, boolean rescale)

Erstellt einen Screenshot vom Gerät.

InputStreamSource getScreenshot()

Erstellt einen Screenshot vom Gerät.

String getSerialNumber()

Eine praktische Methode zum Abrufen der Seriennummer dieses Geräts.

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

Gibt den Wert der angeforderten Einstellung zurück.

String getSetting(String namespace, String key)

Siehe getSetting(int, String, String) und wird für einen Systemnutzer ausgeführt.

String getSimOperator()

Geben Sie den Anbieter der SIM-Karte 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 oder den Wert "null" zurück, falls nicht verfügbar oder das Gerät nicht verfügbar ist.

getTombstones()

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

long getTotalMemory()

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

getUninstallablePackageNames()

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

boolean getUseFastbootErase()

Legen Sie fest, ob eine Partition auf dem Gerät mit der Funktion „Fastboot Deletion“ oder „Fastboot“ gelöscht werden soll.

int getUserFlags(int userId)

Findet die Flags eines bestimmten Nutzers und gibt sie zurück.

getUserInfos()

Ruft die Map of useId zu UserInfo auf dem Gerät ab.

int getUserSerialNumber(int userId)

Gibt die Seriennummer zurück, die der userId zugeordnet ist, falls sie gefunden wird; in allen anderen Fällen -10000.

IManagedTestDevice.DeviceEventResponse handleAllocationEvent(DeviceEvent event)

Verarbeitet das angegebene DeviceEvent.

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

boolean hasFeature(String feature)

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

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

Ein Android-Paket auf dem Gerät installieren

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

Ein Android-Paket auf dem Gerät installieren

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

Ein Android-Paket für einen bestimmten Nutzer auf dem Gerät installieren

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

Ein Android-Paket für einen bestimmten Nutzer auf dem Gerät installieren

void invalidatePropertyCache()
boolean isAdbRoot()

boolean isAdbTcp()
boolean isAppEnumerationSupported()

Prüfen, ob die Plattform auf dem Gerät die Auflistung von Apps 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()

Rückgabe, 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 das Gerät den monitorlosen Systemnutzermodus verwendet.

boolean isMainUserPermanentAdmin()

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

boolean isMultiUserSupported()

Legt fest, ob mehrere Nutzer unterstützt werden.

boolean isPackageInstalled(String packageName, String userId)

Frag das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID ab, um zu prüfen, ob es bei diesem 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 „true“ zurück, wenn sich das Gerät in TestDeviceState#FASTBOOT oder TestDeviceState.FASTBOOTD befindet.

boolean isUserRunning(int userId)

Prüfen Sie, 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 auf dem Display sichtbar ist.

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

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

boolean isVisibleBackgroundUsersSupported()

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

boolean isWifiEnabled()

Teste, ob WLAN aktiviert ist.

listDisplayIds()

Erfassen Sie die Liste der verfügbaren Anzeige-IDs auf dem Gerät, 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 ANR-Fehler vom Gerät.

boolean logBugreport(String dataName, ITestLogger listener)

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

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

Protokolliert eine Nachricht im Logcat des Geräts.

void mountDebugfs()

Stellen Sie debugfs bereit.

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.

void postAdbRootAction()

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

void postAdbUnrootAction()

Diese Einstellung kann überschrieben werden, wenn nach dem Aufheben des Root-Vorgangs von ADB und bevor das Gerät wieder online ist, bestimmte Aktionen ausgeführt werden müssen.

void postBootSetup()

Führen Sie die Anweisungen aus, um das Gerät nach jedem Start so zu konfigurieren, dass es getestet wird.

void postInvocationTearDown(Throwable exception)

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

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

Zusätzliche Schritte für die gerätespezifische erforderliche Einrichtung, die vor dem Aufruffluss 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 einer lokalen temporären ERROR(/File) und gibt diese File zurück.

File pullFile(String remoteFilePath)

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

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

boolean pushString(String contents, String remoteFilePath)

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

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

Startet das Gerät im Bootloader-Modus neu.

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. Beachten Sie, dass dies ein spezieller Modus für die Wiederherstellung ist.

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

void rebootIntoSideload(boolean autoReboot)

Startet das Gerät im ADB-Sideload-Modus neu. Beachten Sie, dass dies ein spezieller Modus für die Wiederherstellung ist.

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

void rebootUntilOnline()

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

void rebootUntilOnline(String reason)

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

void rebootUserspace()

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

void rebootUserspaceUntilOnline()

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

boolean recoverDevice()

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

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

void remountVendorWritable()

Machen Sie die Anbieterpartition auf dem Gerät beschreibbar.

boolean removeAdmin(String componentName, int userId)

Den angegebenen Geräteadministrator für den Nutzer entfernen und true zurückgeben, 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)

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

boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, listeners)

Führt Instrumentierungstests durch und bietet Gerätewiederherstellung.

boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, listeners)

Hat dieselbe Funktion wie ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), führt aber den Test für den angegebenen Nutzer aus.

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

Hat dieselbe Funktion wie ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), führt aber den Test für einen bestimmten Nutzer aus.

void setConfiguration(IConfiguration configuration)

Injiziertes IConfiguration in Gebrauch.

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

Legt das Datum auf dem Gerät fest

Hinweis: Zum Festlegen des Datums auf dem Gerät ist ein Root erforderlich

boolean setDeviceOwner(String componentName, int userId)

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

void setDeviceState(TestDeviceState deviceState)

Aktualisieren Sie den Status des Geräts.

void setEmulatorOutputStream(SizeLimitedOutputStream output)

Legen Sie für den Emulator SizeLimitedOutputStream fest, um die Ausgabe zu protokollieren

void setEmulatorProcess(Process p)

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

void setFastbootEnabled(boolean fastbootEnabled)

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

void setFastbootPath(String fastbootPath)

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

void setIDevice(IDevice newDevice)

Aktualisiere das mit diesem ITestDevice verknüpfte IDevice.

void setLogStartDelay(int delay)

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

void setOptions(TestDeviceOptions options)

TestDeviceOptions für das Gerät festlegen

boolean setProperty(String propKey, String propValue)

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

void setRecovery(IDeviceRecovery recovery)

Lege 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 für einen Systemnutzer ausgeführt.

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

Fügt dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzu.

void setTestLogger(ITestLogger testLogger)

ITestLogger-Instanz einschleusen

void setUseFastbootErase(boolean useFastbootErase)

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

void startLogcat()

Starte die Aufzeichnung der Logcat-Ausgabe vom Gerät im Hintergrund.

boolean startUser(int userId)

Startet einen bestimmten Nutzer im Hintergrund, wenn er aktuell beendet 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 jeweiligen Bildschirm sichtbar ist (d.h., der Nutzer kann Aktivitäten auf dieser Anzeige starten).

void stopEmulatorOutput()

Schließen und löschen Sie die Emulatorausgabe.

void stopLogcat()

Erfassen der Logcat-Ausgabe vom Gerät beenden und aktuell gespeicherte Logcat-Daten verwerfen.

boolean stopUser(int userId)

Stoppt einen bestimmten Nutzer.

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

Stoppen Sie einen bestimmten Nutzer.

String switchToAdbTcp()

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

boolean switchToAdbUsb()

Schalte das Gerät in den ADB-over-USB-Modus um.

boolean switchUser(int userId)

Zu einer anderen Nutzer-ID mit Standardzeitlimit wechseln.

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)

Android-Paket vom Gerät deinstallieren

String uninstallPackageForUser(String packageName, int userId)

Android-Paket für einen bestimmten Nutzer vom Gerät deinstallieren

boolean unlockDevice()

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

void unmountDebugfs()

Trennen Sie „debugfs“.

boolean waitForBootComplete(long timeOut)

Blockiert, bis das Flag „Boot abgeschlossen“ des Geräts gesetzt wird.

boolean waitForDeviceAvailable()

Wartet, bis das Gerät reagiert und zum Testen verfügbar ist.

boolean waitForDeviceAvailable(long waitTime)

Wartet, bis das Gerät reagiert und zum Testen verfügbar ist.

boolean waitForDeviceAvailableInRecoverPath(long waitTime)

Wartet, bis das Gerät responsiv 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)

Blöcke für das Gerät, die sich im Status „ADB-Sideload“ befinden

boolean waitForDeviceNotAvailable(long waitTime)

Blockierungen für das Gerät, die nicht verfügbar sind, d. h. in ADB fehlen

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 eines Neustarts verwendet werden soll.

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

Starten Sie ADB-Neustart.

void ensureRuntimePermissionSupported()

Hilfsmethode zum Auslösen einer Ausnahme, wenn die Laufzeitberechtigung nicht unterstützt wird

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

Rufen Sie die zu verwendende RunUtil-Instanz ab.

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

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

boolean isInRebootCallback()

Gibt zurück, ob gerade Neustart-Callbacks ausgeführt werden oder nicht.

boolean isNewer(File localFile, IFileEntry entry)

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

void notifyRebootEnded()

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

void notifyRebootStarted()

Benachrichtigt alle IDeviceActionReceiver über das Ereignis „Neustart“.

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

Führt eine Aktion auf diesem Gerät aus.

void postAdbReboot()

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

void prePostBootSetup()

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

void setMicrodroidProcess(Process process)

Kennzeichnet das Testgerät als Mikrodroid und legt seine Kundennummer 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 (beenden Sie die Berichterstellung an ADB).

Konstanten

UNGÜLTIGE_NUTZER-ID

public static final int INVALID_USER_ID

Zurückgegebener Wert für ungültige oder nicht gefundene Nutzer-IDs: UserHandle hat -10000 definiert

Konstante Wert: -10000 (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 den Befehl

Konstantenwert: 2 (0x00000002)

Fields

DEBUGFS_PATH (FEHLERBEHEBUNG)

public static final String DEBUGFS_PATH

SD-KARTE

protected static final String SD_CARD

SPEICHER_EMPULIERT

protected static final String STORAGE_EMULATED

Optionen

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Öffentliche Konstruktoren

NativeDevice

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

Erstellt ein TestDevice.

Parameter
device IDevice: die zugehörige IDevice

stateMonitor IDeviceStateMonitor: der zu verwendende IDeviceStateMonitor-Mechanismus

allocationMonitor IDeviceMonitor: IDeviceMonitor zur Information über Änderungen des Zuweisungsstatus. Kann null sein

Öffentliche Methoden

BatchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

Mikrooptimierung (ca. 400 Millis), indem alle benötigten Attribute vorab abgerufen werden, anstatt für jedes Attribut „adb getprop“ aufzurufen, d.h. das Abrufen aller Eigenschaften ist genauso schnell wie das Abrufen einer Property. Dinge wie device.getApiLevel(), checkApiLevelAgainstNextRelease und getBuildAlias rufen alle im Hintergrund „adb getprop“ auf. Sie werden in einem Aufruf abgerufen und „NativeDevice.setProperty“ aufgerufen. Auch wenn das nicht der Fall ist, ruft NativeDevice selbst „setProperty“ auf und speichert das Ergebnis für zukünftige Aufrufe im Cache. Wir machen das nur etwas früher. Wenn das Gerät gerade wiederhergestellt wird oder andere Fehler beim Abrufen der Eigenschaften auftreten, werden sie einfach ignoriert.

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

Returns
boolean

Ausgabe
DeviceNotAvailableException

checkApiLevelAgainstNextRelease (API-LevelAgainstNextRelease)

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

Prüfen Sie, ob eine Funktion derzeit mit einer minimal unterstützten Stufe unterstützt wird. Bei dieser Methode werden noch nicht veröffentlichte Funktionen berücksichtigt, bevor das API-Level 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.

Ausgabe
DeviceNotAvailableException

ClearErrorDialogs

public boolean clearErrorDialogs ()

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

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

Ausgabe
DeviceNotAvailableException

ClearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

Löscht das zuletzt verbundene WLAN. Diese sollte beim Starten eines neuen Aufrufs aufgerufen werden, um nach dem Neustart des Geräts keine Verbindung zum WLAN herzustellen, das im vorherigen Test verwendet wurde.

ClearLogcat

public void clearLogcat ()

Löscht alle akkumulierten Logcat-Daten.

Das ist in Fällen nützlich, in denen ITestDevice#getLogcat() nur Logdaten zurückgibt, die nach einem bestimmten Zeitpunkt erstellt wurden (z. B. nach dem Flashen eines neuen Geräte-Builds).

mit Wifi-Netzwerk verbinden

public boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Stellt eine WLAN-Verbindung her.

Aktiviert das WLAN und blockiert, bis eine Verbindung zu einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke 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
wifiSsidToPsk : Eine Zuordnung der WLAN-SSIDs zu Passwörtern.

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

Returns
boolean true, wenn eine Verbindung mit dem WLAN hergestellt wurde. Andernfalls false

Ausgabe
DeviceNotAvailableException

mit Wifi-Netzwerk verbinden

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Stellt eine WLAN-Verbindung her.

Aktiviert das WLAN und blockiert, 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 mit dem WLAN hergestellt wurde. Andernfalls false

Ausgabe
DeviceNotAvailableException

mit Wifi-Netzwerk verbinden

public boolean connectToWifiNetwork ( wifiSsidToPsk)

Stellt eine WLAN-Verbindung her.

Aktiviert das WLAN und blockiert, bis eine Verbindung zu einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke 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
wifiSsidToPsk : Eine Zuordnung der WLAN-SSIDs zu Passwörtern.

Returns
boolean true, wenn eine Verbindung mit dem WLAN hergestellt wurde. Andernfalls false

Ausgabe
DeviceNotAvailableException

mit Wifi-Netzwerk verbinden

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

Stellt eine WLAN-Verbindung her.

Aktiviert das WLAN und blockiert, 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

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

Returns
boolean true, wenn eine Verbindung mit dem WLAN hergestellt wurde. Andernfalls false

Ausgabe
DeviceNotAvailableException

Verbindung mit WLAN-Netzwerk herstellen (falls erforderlich)

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

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

Parameter
scanSsid boolean: ob für dieses Netzwerk nach versteckter SSID gesucht werden soll

Returns
boolean true, wenn eine Verbindung mit dem WLAN hergestellt wurde. Andernfalls false

Ausgabe
DeviceNotAvailableException

Verbindung mit WLAN-Netzwerk herstellen (falls erforderlich)

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

Returns
boolean true, wenn eine Verbindung mit dem WLAN hergestellt wurde. Andernfalls false

Ausgabe
DeviceNotAvailableException

Nutzer erstellen

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: aktiviert das Nutzer-Flag „--sitzungsspezifisch“ beim Erstellen

Returns
int ID des erstellten Nutzers

Ausgabe
DeviceNotAvailableException

Nutzer erstellen

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

Nutzer erstellen

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 Ganzzahl für die erstellte User-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 Ganzzahl für die erstellte User-ID oder -1 für Fehler.

Ausgabe
DeviceNotAvailableException

Datei löschen

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

Ausgabe
DeviceNotAvailableException

Datei löschen

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

RegistrierungDeviceActionReceiver abmelden

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Entfernt die registrierte IDeviceActionReceiver.

Parameter
deviceActionReceiver IDeviceActionReceiver: Eine IDeviceActionReceiver, die entfernt wird.

deviceSoftNeustart

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. getProcessByName(String) verwenden, um ProcessInfo zu erhalten.

Parameter
prevSystemServerProcess ProcessInfo: der vorherige Systemserver-Prozess ProcessInfo

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

Ausgabe
DeviceNotAvailableException

deviceSoftneustart seit

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Hilfsmethode, um zu prüfen, ob das Gerät seit der UTC-Zeit seit der Epoche vom Gerät und seinem ERROR(/TimeUnit) vorläufig neu gestartet wurde. Ein vorläufiger Neustart bezieht sich auf den Neustart des Systemservers, der außerhalb eines harten Neustarts des Geräts neu gestartet wurde (z. B. angeforderter Neustart). Die aktuelle utcEpochTime des Geräts in Milliseccond 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 vorläufig neu gestartet wurde

Ausgabe
DeviceNotAvailableException

deaktiviereAdbRoot

public boolean disableAdbRoot ()

Deaktiviert den ADB-Root.

Das Deaktivieren der ADB-Root-Instanz kann dazu führen, dass das Gerät von ADB getrennt wird. Diese Methode wird blockiert, bis das Gerät verfügbar ist.

Returns
boolean true, wenn der Vorgang erfolgreich war.

Ausgabe
DeviceNotAvailableException

Keyguard deaktivieren

public void disableKeyguard ()

Versucht, den Keyguard zu deaktivieren.

Warten Sie zuerst, bis die Eingabeweiterleitung bereit ist. Dies geschieht ungefähr zur gleichen Zeit, zu der das Gerät BOOT_COMPLETE scheinbar asynchron meldet, da die aktuelle Framework-Implementierung gelegentlich eine Race-Bedingung aufweist. Anschließend wird der Befehl zum Schließen von Keyguard gesendet (funktioniert nur bei nicht sicheren).

Ausgabe
DeviceNotAvailableException

Netzwerkmonitor deaktivieren

public boolean disableNetworkMonitor ()

Deaktiviert die Netzwerküberwachung auf dem Gerät.

Returns
boolean true, wenn das Monitoring erfolgreich deaktiviert wurde. false wenn er fehlgeschlagen ist.

Ausgabe
DeviceNotAvailableException

VonWLAN trennen

public boolean disconnectFromWifi ()

Trennt die Verbindung zum WLAN.

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

Returns
boolean true, wenn die Verbindung zum WLAN erfolgreich getrennt wurde. false, wenn die Verbindung nicht getrennt werden konnte.

Ausgabe
DeviceNotAvailableException

tutFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

Dump des Heaps vom system_server. Der Aufrufer ist dafür verantwortlich, die Dumpdatei zu bereinigen.

Parameter
process String: der Name des Geräteprozesses, für den Dumpheap durchgeführt werden soll.

devicePath String: Pfad auf dem Gerät, in dem der Dump gespeichert wird Dies muss ein Standort sein, für den die Berechtigungen dies zulassen.

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

Ausgabe
DeviceNotAvailableException

EnableAdbRoot

public boolean enableAdbRoot ()

Aktiviert den ADB-Stamm. Wenn die Einstellung „enable-root“ auf „false“ gesetzt ist, wird eine Meldung protokolliert und ohne Root-Aktivierung zurückgegeben.

Wenn du den ADB-Root aktivierst, wird möglicherweise die Verbindung zwischen dem Gerät und ADB getrennt. Diese Methode wird blockiert, 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 er fehlgeschlagen ist.

Ausgabe
DeviceNotAvailableException

Befehl ausführen

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

Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem bestimmten 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 mehr reagiert; 0 L für kein Zeitlimit

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

Returns
String den Befehl „stdout“. null, wenn der Befehl nicht ausgeführt werden konnte.

Ausgabe
DeviceNotAvailableException

Befehl ausführen

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

Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem bestimmten 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 mehr reagiert; 0 L für kein Zeitlimit

envMap ist die für den Befehl festzulegende Umgebung.

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

Returns
String den Befehl „stdout“. null, wenn der Befehl nicht ausgeführt werden konnte.

Ausgabe
DeviceNotAvailableException

Befehl ausführen

public String executeAdbCommand (String... cmdArgs)

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

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

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

Returns
String den Befehl „stdout“. null, wenn der Befehl nicht ausgeführt werden konnte.

Ausgabe
DeviceNotAvailableException

Schnellstart-Befehl ausführen

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 auszuführenden 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.

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

Parameter
timeout long: die Zeit in Millisekunden, bevor 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 lange laufenden Fastboot-Befehl als Systembefehl ausführt.

Identisch mit executeFastbootCommand(String), mit dem Unterschied, dass ein längeres Zeitlimit verwendet wird.

Parameter
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 ( envVarMap, 
                String... cmdArgs)

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

Identisch mit executeFastbootCommand(String), mit dem Unterschied, dass ein längeres Zeitlimit verwendet wird.

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

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

Returns
CommandResult das CommandResult-Element mit der Ausgabe des Befehls

Ausgabe
DeviceNotAvailableException

AusführenShellCommand

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

AusführenShellCommand

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

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

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

maxTimeToOutputShellResponse long: die maximale Zeitspanne, während der der Befehl keine Antwort ausgeben darf; Einheit gemäß timeUnit

timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse

retryAttempts int: die maximale Anzahl der Wiederholungen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. DeviceNotResponsiveException wird geworfen, wenn retryAttempts erfolglos ausgeführt wird.

Ausgabe
DeviceNotAvailableException

AusführenShellCommand

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

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

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

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

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

maxTimeToOutputShellResponse long: die maximale Zeitspanne, während der der Befehl keine Antwort ausgeben darf; Einheit gemäß timeUnit

timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse

retryAttempts int: die maximale Anzahl der Wiederholungen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. DeviceNotResponsiveException wird geworfen, wenn retryAttempts erfolglos ausgeführt wird.

Ausgabe
DeviceNotAvailableException

AusführenShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Führt den angegebenen adb-Shell-Befehl aus und wiederholt einen mehrfachen Versuch, wenn der Befehl fehlschlägt.

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

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

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

Ausgabe
DeviceNotAvailableException

AusführenShellV2Command

public CommandResult executeShellV2Command (String cmd)

Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die ordnungsgemäß mit der Ausgabe des 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

AusführenShellV2Command

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 Befehlsausgabe und stderr. stdout ausgefüllt sind und an den angegebenen Stream weitergeleitet werden.

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

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

Returns
CommandResult Das Ergebnis in CommandResult.

Ausgabe
DeviceNotAvailableException

AusführenShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

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

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

pipeAsInput File: Ein ERROR(/File)-Wert, der als Eingabe für den Befehl verwendet wird, oder null.

Returns
CommandResult Das Ergebnis in CommandResult.

Ausgabe
DeviceNotAvailableException

AusführenShellV2Command

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

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

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

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 für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. DeviceNotResponsiveException wird geworfen, wenn retryAttempts erfolglos ausgeführt wird.

Returns
CommandResult

Ausgabe
DeviceNotAvailableException

AusführenShellV2Command

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

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

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

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

timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse

Returns
CommandResult

Ausgabe
DeviceNotAvailableException

AusführenShellV2Command

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

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

pipeAsInput File: Ein ERROR(/File)-Wert, der als Eingabe für den Befehl verwendet 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 für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. DeviceNotResponsiveException wird geworfen, wenn retryAttempts erfolglos ausgeführt wird.

Returns
CommandResult

Ausgabe
DeviceNotAvailableException

AusführenShellV2Command

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

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

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

pipeAsInput File: Ein ERROR(/File)-Wert, der als Eingabe für den Befehl verwendet wird, oder null.

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

pipeToError OutputStream: ERROR(/OutputStream), an die der Standardfehler 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 für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. DeviceNotResponsiveException wird geworfen, wenn retryAttempts erfolglos ausgeführt wird.

Returns
CommandResult

Ausgabe
DeviceNotAvailableException

FastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

Hilfsmethode zum Löschen einer Partition auf dem Gerät.

Wenn getUseFastbootErase() den Wert true hat, wird die Partition mit Fastboot-Löschungen gelöscht. Das Gerät muss beim nächsten Start ein Dateisystem erstellen. Andernfalls wird das Fastboot-Format verwendet, wodurch ein neues Dateisystem auf dem Gerät erstellt wird.

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

Parameter
partition String: die zu löschende Partition

Returns
CommandResult das CommandResult-Element mit der Ausgabe des Befehls

Ausgabe
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

Rufen Sie die Informationen zu den auf dem Gerät aktivierten APEXes ab.

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

Ausgabe
DeviceNotAvailableException

Einstellungen abrufen

public  getAllSettings (String namespace)

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

Parameter
namespace String: muss einer dieser Werte sein: {"system", "secure", "global"}

Returns
der Schlüssel/Wert-Paare. Null, wenn der Namespace nicht unterstützt wird.

Ausgabe
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

Aktuellen Zuweisungsstatus des Geräts zurückgeben

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 (Abrufen von Android-IDs)

public  getAndroidIds ()

Erstellen Sie eine Karte mit Android-IDs, die mit Nutzer-IDs übereinstimmen. Es gibt keine Versicherung, dass jede Nutzer-ID eine Android-ID findet, die mit dieser Funktion verknüpft ist. Daher können einige Nutzer-IDs mit null übereinstimmen.

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

Ausgabe
DeviceNotAvailableException

getApiLevel

public int getApiLevel ()

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

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

Ausgabe
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Informationen zu einem auf dem Gerät installierten Paket abrufen

Parameter
packageName String

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

Ausgabe
DeviceNotAvailableException

GetAppPackageInfos

public  getAppPackageInfos ()

Informationen zu Paketen abrufen, die auf dem Gerät installiert sind

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

Ausgabe
DeviceNotAvailableException

getBasebandVersion

public String getBasebandVersion ()

Praktische Methode zum Abrufen der Baseband- bzw. Funkversion dieses Geräts. 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 dies nicht korrekt und die hier zurückgegebene Version stimmt möglicherweise nicht mit der von Fastboot gemeldeten Version überein und gibt nicht die Version für das CDMA-Radio zurück. Zusammenfassung: Diese Methode gibt nur dann eine korrekte Version zurück, wenn das Attribut „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

getAkku

public Integer getBattery ()

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

Returns
Integer

getBoolescheProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

Gibt einen booleschen Wert der angegebenen Eigenschaft 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 das Attribut den Wert "1", "y", "yes", "on" oder "true" hat, false, wenn das Attribut den Wert "0", "n", "no", "off", "false" oder defaultValue hat.

Ausgabe
DeviceNotAvailableException

getBootVerlauf

public  getBootHistory ()

Die Hilfsmethode erfasst die Boot-Verlaufszuordnung mit Startzeit und Startgrund.

Returns
Karte der Bootzeit (UTC-Zeit in Sekunden seit Epoche) und des Bootgrunds

Ausgabe
DeviceNotAvailableException

getBootVerlaufSeit

public  getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

Parameter
utcEpochTime long: die Gerätezeit seit Epoche.

timeUnit TimeUnit: die Zeiteinheit TimeUnit.

Returns
Karte der Bootzeit (UTC-Zeit in Sekunden seit Epoche) und des Bootgrunds

Ausgabe
DeviceNotAvailableException

getBootloaderVersion

public String getBootloaderVersion ()

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

Es wird versucht, die Bootloader-Version aus dem aktuellen Gerätezustand abzurufen. (d. h., wenn sich das Gerät im Fastboot-Modus befindet, versucht es, die Version über Fastboot abzurufen)

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

Ausgabe
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

Ruft einen Fehlerbericht vom Gerät ab.

Die Implementierung funktioniert garantiert auch auf Geräten ohne SD-Karte (oder auf denen 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 hilfreich sind.

Nur unterstützt für "adb version" > 1.0.36

Returns
InputStreamSource Ein InputStreamSource der ZIP-Datei mit den Fehlerbericht. Bei Fehlern wird null zurückgegeben.

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 eine lesbarere Zeichenfolge als die Build-ID (in der Regel eine Nummer 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 ()

Rufen Sie den Build-Flavor für das Gerät ab.

Returns
String Den Build-Flavor oder null, wenn er nicht abgerufen werden konnte.

Ausgabe
DeviceNotAvailableException

getBuildId

public String getBuildId ()

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

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

Android-Geräte können in der Regel mit Testschlüsseln (wie in AOSP) oder Release-Schlüsseln (von den einzelnen Geräteherstellern kontrolliert) signiert sein.

Returns
String Signaturschlüssel, falls gefunden, andernfalls null.

Ausgabe
DeviceNotAvailableException

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

Gibt ein im Cache gespeichertes 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 ein im Cache gespeichertes DeviceDescriptor zurück, wenn das Gerät zugewiesen ist. Andernfalls wird der aktuelle DeviceDescriptor zurückgegeben.

Parameter
shortDescriptor boolean: Gibt an, ob der Deskriptor auf das Minimum der 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 die gesamte Datei in einem Pfad auf dem Gerät enthält

Ausgabe
DeviceNotAvailableException

getConnection

public AbstractConnection getConnection ()

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

Returns
AbstractConnection

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

Gibt ContentProviderHandler oder null zurück, 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 Contentanbieter initialisiert werden soll.

Returns
ContentProviderHandler

Ausgabe
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Gibt den aktuellen faltbaren Status des Geräts oder null zurück, wenn Probleme aufgetreten sind.

Returns
DeviceFoldableState

Ausgabe
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

Gibt die ID des aktuell ausgeführten Nutzers zurück. Falls ein Fehler auftritt, geben Sie -10000 zurück.

Returns
int

Ausgabe
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

Rufen Sie die Geräteklasse ab.

Returns
String 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 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 zu erhalten, ohne das tatsächliche Geräteobjekt zu übergeben.

Parameter
shortDescriptor boolean: Gibt an, ob der Deskriptor auf das Minimum der Informationen beschränkt werden soll

Returns
DeviceDescriptor

getDeviceState

public TestDeviceState getDeviceState ()

Rufen Sie 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 für Emulatoren stdout und stderr abrufen

Returns
InputStreamSource Emulatorausgabe

getEmulatorProcess

public Process getEmulatorProcess ()

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

Returns
Process Process oder null

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

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

Returns
File

GetExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

Hilfsmethode zum Ermitteln der Menge an freiem Speicherplatz im externen Gerätespeicher.

Returns
long die Menge an freiem Speicherplatz in KB

Ausgabe
DeviceNotAvailableException

getFastbootPath

public String getFastbootPath ()

Gibt den Pfad der verwendeten Fastboot-Binärdatei zurück. Damit die Schnellstart-Funktionen aktiviert sind, muss isFastbootEnabled() weiterhin "true" sein.

Returns
String

getFastbootProductType (GetFastbootProductType)

public String getFastbootProductType ()

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

Diese Methode sollte nur verwendet werden, wenn das Gerät im Schnellstartmodus (Fastboot mode) aktiviert sein soll. Dies ist eine etwas sicherere Variante als die generische getProductType()-Methode in diesem Fall, 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

GetFastbootProductVariant

public String getFastbootProductVariant ()

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

Diese Methode sollte nur verwendet werden, wenn das Gerät im Schnellstartmodus (Fastboot mode) aktiviert sein soll. Dies ist eine etwas sicherere Variante als die generische getProductType()-Methode in diesem Fall, 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 (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: der Variablenname

Returns
String den Attributwert oder null, falls nicht vorhanden

Ausgabe
DeviceNotAvailableException

getFastbootVersion

public String getFastbootVersion ()

Gibt den Versionsstring der verwendeten Fastboot-Binärdatei zurück. Oder null, wenn ein Fehler auftritt.

Returns
String

getFileEntry

public IFileEntry getFileEntry (String path)

Rufen Sie einen Verweis auf eine Remote-Datei auf dem Gerät ab.

Parameter
path String: der abzurufende Dateipfad. Kann ein absoluter Pfad oder Pfad relativ zu „/“ sein (d. h., 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)

Inoffizielles Hilfsprogramm zum Abrufen eines FileEntry aus einem Nicht-Root-Pfad. PROBLEM: Refaktorieren Sie das FileEntry-System, damit es über jeden Pfad verfügbar ist. (auch Nicht-Root-Zertifikate).

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

Returns
IFileEntry Ein FileEntryWrapper, der das FileEntry-Element 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 verknüpfte ddmlib-IDevice zurück.

Jedes Mal, wenn das Gerät die Verbindung zu ADB trennt und wieder eine Verbindung herstellt, kann von DDMS eine neue IDevice zugewiesen werden. Aufrufer sollten daher keinen Verweis auf IDevice beibehalten, da dieser Verweis möglicherweise veraltet ist.

Returns
IDevice IDevice

GetInstalldPackageNames

public  getInstalledPackageNames ()

Rufen Sie die auf dem Gerät vorhandenen App-Paketnamen 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 einen ganzzahligen Wert der angegebenen Eigenschaft vom Gerät zurück.

Parameter
name String: der Name der Property

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

Returns
long Den Attributwert oder defaultValue, wenn das Attribut leer ist, nicht vorhanden ist oder keinen ganzzahligen Wert hat

Ausgabe
DeviceNotAvailableException

getIpAddress

public String getIpAddress ()

Ruft die IP-Adresse des Geräts ab.

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

Ausgabe
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

Returns
KeyguardControllerState Eine KeyguardControllerState mit einem Snapshot des Status des Keyguard und gibt Null zurück, wenn die Keyguard-Abfrage nicht unterstützt wird.

Ausgabe
DeviceNotAvailableException

getLastErwarteteNeustartzeitMillis

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.

Funktioniert in zwei Modi:

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

    Returns
    InputStreamSource

  • getLogcat

    public InputStreamSource getLogcat (int maxBytes)

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

    Dies ist nützlich, wenn Sie häufige Snapshots der erfassten Logcat-Daten erfassen möchten, ohne dass durch das Abrufen des gesamten getLogcat()-Snapshots die Speicherplatzstrafe erhöht wird.

    Parameter
    maxBytes int: Die maximale Datenmenge, die zurückgegeben werden soll. 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 Logcats 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 Logcat-Daten nicht erfasst werden können, wird ein leerer Stream zurückgegeben.

    getLogcatDa

    public InputStreamSource getLogcatSince (long date)

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

    Parameter
    date long: in Millisekunden seit dem Epochenformat für den Start des Snapshots bis zum aktuellen Zeitpunkt. (kann über 'Datum +%s' abgerufen werden)

    Returns
    InputStreamSource

    getMacAddress

    public String getMacAddress ()

    Gibt die MAC-Adresse des Geräts zurück. Wenn keine Abfrage vom Gerät durchgeführt werden kann, wird null zurückgegeben.

    Returns
    String

    getMainUserId

    public Integer getMainUserId ()

    Gibt die Hauptnutzer-ID zurück.

    Returns
    Integer Die userId des Hauptnutzers, falls vorhanden, und null, wenn es keinen Hauptnutzer gibt

    Ausgabe
    DeviceNotAvailableException

    getMainlineModuleInfo

    public  getMainlineModuleInfo ()

    Rufen Sie die Informationen zu den auf dem Gerät installierten Mainline-Modulen ab.

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

    Ausgabe
    DeviceNotAvailableException

    getMaxNumberOfRunningUsersSupported

    public int getMaxNumberOfRunningUsersSupported ()

    Holen Sie sich die maximale Anzahl von Nutzern, die gleichzeitig ausgeführt werden. Die Standardeinstellung ist 0.

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

    Ausgabe
    DeviceNotAvailableException

    getMaxNumberOfUsersUnterstützt

    public int getMaxNumberOfUsersSupported ()

    Rufen Sie die maximale Anzahl der unterstützten Nutzer ab. 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 ()

    Gib die IDeviceStateMonitor zurück, die dem Gerät zugeordnet ist.

    Returns
    IDeviceStateMonitor

    MountPoint abrufen

    public String getMountPoint (String mountName)

    Gibt einen Bereitstellungspunkt zurück.

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

    AUFGABE: Dieses Verhalten auf IDevice#getMountPoint(String) verschieben

    Parameter
    mountName String: der Name des Bereitstellungspunkts

    Returns
    String den Bereitstellungspunkt oder null

    MountPointInfo abrufen

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    Parameter
    mountpoint String

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

    Ausgabe
    DeviceNotAvailableException

    MountPointInfo abrufen

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

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

    Returns
    TestDeviceOptions TestDeviceOptions bezieht sich auf das zu testende Gerät.

    getPartitionFreeSpace

    public long getPartitionFreeSpace (String partition)

    Hilfsmethode zum Ermitteln der Menge an freiem Speicherplatz auf der Gerätepartition.

    Parameter
    partition String

    Returns
    long die Menge an freiem Speicherplatz in KB

    Ausgabe
    DeviceNotAvailableException

    getPrimaryUserId (Primäre Nutzer-ID)

    public Integer getPrimaryUserId ()

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

    Returns
    Integer Die userId des primären Nutzers (falls vorhanden) und null, wenn kein Primärnutzer vorhanden ist

    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 zu angegebenem processName

    Ausgabe
    DeviceNotAvailableException

    getProcessPid

    public String getProcessPid (String process)

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

    Parameter
    process String: Der String des Vorgangsnamens.

    Returns
    String

    Ausgabe
    DeviceNotAvailableException

    GetProductType

    public String getProductType ()

    Praktische Methode zum Abrufen des Produkttyps dieses Geräts.

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

    Returns
    String den Namen des Produkttyps String. Ist nicht null

    Ausgabe
    DeviceNotAvailableException

    GetProductVariant

    public String getProductVariant ()

    Praktische Methode zum Abrufen der Produktvariante dieses Geräts.

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

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

    Ausgabe
    DeviceNotAvailableException

    getProperty

    public String getProperty (String name)

    Ruft den angegebenen Attributwert vom Gerät ab.

    Parameter
    name String: der Name der Property

    Returns
    String den Attributwert oder null, falls nicht vorhanden

    Ausgabe
    DeviceNotAvailableException

    getRecoveryMode

    public ITestDevice.RecoveryMode getRecoveryMode ()

    Rufen Sie den aktuellen Wiederherstellungsmodus des Geräts ab.

    Returns
    ITestDevice.RecoveryMode den aktuellen Wiederherstellungsmodus des Geräts.

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

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

    AUFGABE: Erweitern Sie die oben genannten Implementierungen, um "format" und "rescale" zu unterstützen

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

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

    Ausgabe
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

    Erstellt einen Screenshot vom Gerät. Wir empfehlen, stattdessen getScreenshot(String) mit JPEG-Codierung für eine kleinere Größe zu verwenden.

    Parameter
    format String: unterstützte PNG- und JPEG-Dateien

    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 InputStreamSource des Screenshots im PNG-Format oder null, wenn der Screenshot nicht erfolgreich erstellt werden konnte.

    Ausgabe
    DeviceNotAvailableException

    getSerialNumber

    public String getSerialNumber ()

    Eine praktische Methode zum Abrufen der Seriennummer dieses Geräts.

    Returns
    String die String-Seriennummer

    getSetting

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

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

    Parameter
    userId int

    namespace String

    key String

    Returns
    String Wert, der mit „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 für einen Systemnutzer ausgeführt.

    Parameter
    namespace String

    key String

    Returns
    String

    Ausgabe
    DeviceNotAvailableException

    getSimOperator

    public String getSimOperator ()

    Geben Sie den Anbieter der SIM-Karte 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 oder den Wert "null" zurück, falls nicht verfügbar oder das Gerät nicht verfügbar ist.

    Returns
    String

    Tombstones abrufen

    public  getTombstones ()

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

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

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

    Ausgabe
    DeviceNotAvailableException

    getTotalMemory

    public long getTotalMemory ()

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

    Returns
    long

    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 derzeit auf dem Gerät installierten String-Paketnamen, die deinstalliert werden können.

    Ausgabe
    DeviceNotAvailableException

    getUseFastbootDELETE

    public boolean getUseFastbootErase ()

    Legen Sie fest, ob eine Partition auf dem Gerät mit der Funktion „Fastboot Deletion“ oder „Fastboot“ gelöscht werden soll.

    Returns
    boolean true, wenn die Daten über Fastboot gelöscht werden, oder false, wenn das Schnellstart-Format verwendet wird.

    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 Flags, die mit der angegebenen Nutzer-ID verknüpft sind, falls gefunden, andernfalls „-10000“.

    Ausgabe
    DeviceNotAvailableException

    getUserInfos (Nutzerinformationen abrufen)

    public  getUserInfos ()

    Ruft die Map of useId zu UserInfo auf dem Gerät ab. DeviceRuntimeException wird ausgegeben, wenn die Ausgabe vom Gerät nicht wie erwartet ist.

    Returns
    Die Liste der UserInfo-Objekte.

    Ausgabe
    DeviceNotAvailableException

    getUserSerialNumber

    public int getUserSerialNumber (int userId)

    Gibt die Seriennummer zurück, die der userId zugeordnet ist, falls sie gefunden wird; in allen anderen Fällen -10000.

    Parameter
    userId int

    Returns
    int

    Ausgabe
    DeviceNotAvailableException

    HandleAllocationEvent (HandleAllocationEvent)

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

    Verarbeitet das angegebene DeviceEvent. Kann das Gerät auf einen neuen Zustand zurücksetzen. 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: Gibt an, welches Format direkt „feature:“ oder „“ sein sollte.

    Returns
    boolean "True", wenn das Feature gefunden wird, andernfalls "False".

    Ausgabe
    DeviceNotAvailableException

    installPackage

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

    Ein Android-Paket auf dem Gerät installieren

    Parameter
    packageFile File: die zu installierende APK-Datei

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

    extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“.

    Returns
    String ein String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.

    Ausgabe
    DeviceNotAvailableException

    installPackage

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

    Ein Android-Paket auf dem Gerät installieren

    Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, in denen das Erteilen von Laufzeitberechtigungen zum Zeitpunkt 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: wenn bei der Installation alle Laufzeitberechtigungen gewährt werden sollen

    extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“.

    Returns
    String ein String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.

    Ausgabe
    DeviceNotAvailableException

    installPackageForUser

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

    Ein Android-Paket für einen bestimmten Nutzer auf dem Gerät installieren

    Parameter
    packageFile File: die zu installierende APK-Datei

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

    userId int: die ganzzahlige Nutzer-ID, für die die Installation durchgeführt werden soll.

    extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“.

    Returns
    String ein String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.

    Ausgabe
    DeviceNotAvailableException

    installPackageForUser

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

    Ein Android-Paket für einen bestimmten Nutzer auf dem Gerät installieren

    Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, in denen das Erteilen von Laufzeitberechtigungen zum Zeitpunkt 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: wenn bei der Installation alle Laufzeitberechtigungen gewährt werden sollen

    userId int: die ganzzahlige Nutzer-ID, für die die Installation durchgeführt werden soll.

    extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“.

    Returns
    String ein String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.

    Ausgabe
    DeviceNotAvailableException

    invalidPropertyCache

    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 Auflistung von Apps unterstützt

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

    Ausgabe
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported (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 einer niedrigen SDK-Blockierung 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, wenn der ADB-Root auf dem Gerät aktiviert werden soll

    isEncryptionSupported

    public boolean isEncryptionSupported ()

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

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

    Ausgabe
    DeviceNotAvailableException

    isExecutable (Kann ausgeführt werden)

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

    Rückgabe, wenn Fastboot für das Gerät verfügbar ist.

    Returns
    boolean

    ist monitorlos

    public boolean isHeadless ()

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

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    isHeadlessSystemUserMode

    public boolean isHeadlessSystemUserMode ()

    Gibt an, ob das Gerät den monitorlosen Systemnutzermodus verwendet.

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

    Legt fest, ob mehrere Nutzer unterstützt werden.

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

    Ausgabe
    DeviceNotAvailableException

    isPackageInstalliert

    public boolean isPackageInstalled (String packageName, 
                    String userId)

    Frag das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID ab, um zu prüfen, ob es bei diesem Nutzer derzeit installiert ist oder nicht.

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

    userId String: Die Nutzer-ID, auf 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 „True“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“.

    Ausgabe
    DeviceNotAvailableException

    isPackageInstalliert

    public boolean isPackageInstalled (String packageName)

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

    Parameter
    packageName String

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

    Ausgabe
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public boolean isRuntimePermissionSupported ()

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

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

    Ausgabe
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public boolean isStateBootloaderOrFastbootd ()

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

    Returns
    boolean

    isUserRunning

    public boolean isUserRunning (int userId)

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

    Parameter
    userId int

    Returns
    boolean "True", wenn der Nutzer ausgeführt wird, "False" in allen anderen Fällen.

    Ausgabe
    DeviceNotAvailableException

    istUserSekundär

    public boolean isUserSecondary (int userId)

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

    Parameter
    userId int

    Returns
    boolean „true“, wenn der Nutzer ein sekundärer Nutzer 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 auf dem Display sichtbar ist.

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

    Parameter
    userId int

    displayId int

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    isVisibleBackgroundUsersOnDefaultDisplaySupported

    public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

    In diesem Fall könnten Sie startVisibleBackgroundUser(int, int, boolean) aufrufen und eine von listDisplayIdsForStartingVisibleBackgroundUsers() zurückgegebene Anzeige übergeben, die ERROR(/java.android.view.Display#DEFAULT_DISPLAY) enthalten sollte.

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    IsVisibleBackgroundUsersSupported

    public boolean isVisibleBackgroundUsersSupported ()

    Gibt an, ob auf dem Gerät Nutzer im Hintergrund sichtbar gemacht 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 ()

    Teste, ob WLAN aktiviert ist.

    Prüft, ob auf dem Gerät WLAN 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 ()

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

    Returns
    Die Liste der Bildschirme. Die Standardeinstellung gibt immer die Standardanzeige 0 zurück.

    Ausgabe
    DeviceNotAvailableException

    listDisplayIdsForStartingVisibleBackgroundUsers

    public  listDisplayIdsForStartingVisibleBackgroundUsers ()

    Ruft die Liste der Bildschirme ab, die zum 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. Gibt DeviceRuntimeException aus, wenn die Ausgabe vom Gerät nicht wie erwartet ist.

    Returns
    der Liste der Nutzer-IDs.

    Ausgabe
    DeviceNotAvailableException

    Loganr

    public boolean logAnrs (ITestLogger logger)

    Erfasst und protokolliert ANR-Fehler vom Gerät.

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

    Returns
    boolean Der Wert ist "True", wenn das Logging 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 Der Wert ist "True", wenn das Logging erfolgreich war, andernfalls "False".

    LogOnDevice

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

    Protokolliert eine Nachricht im Logcat des Geräts. Dies ist ein sicherer Aufruf, der auch dann nicht ausgelöst wird, wenn das Logging fehlschlägt.

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

    level Log.LogLevel: Die Debug-Ebene der Nachricht im Logcat.

    format String: Das Nachrichtenformat.

    args Object: die Argumente, die durch String.format() ersetzt werden sollen.

    mountDebugfs

    public void mountDebugfs ()

    Stellen Sie debugfs bereit.

    Ausgabe
    DeviceNotAvailableException

    Neustart ohne Blockierung

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

    public void postAdbRootAction ()

    Überschreibt, wenn das Gerät bestimmte Aktionen nach dem ADB-Root ausführen und bevor das Gerät wieder online ist. Die Standardimplementierung enthält keine Hinzufügungsaktionen. Es kann nicht garantiert werden, dass der adb-Stamm zu diesem Zeitpunkt aktiviert ist.

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postAdbUnrootAction

    public void postAdbUnrootAction ()

    Diese Einstellung kann überschrieben werden, wenn nach dem Aufheben des Root-Vorgangs von ADB und bevor das Gerät wieder online ist, bestimmte Aktionen ausgeführt werden müssen. Die Standardimplementierung enthält keine zusätzlichen Aktionen. Es kann nicht garantiert werden, dass der adb-Root zu diesem Zeitpunkt deaktiviert ist.

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    PostBoot-Einrichtung

    public void postBootSetup ()

    Führen Sie die Anweisungen aus, um das Gerät nach jedem Start so zu konfigurieren, dass es getestet wird.

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

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

    Er muss möglicherweise aufgerufen werden, wenn das Gerät aufgrund anderer Ereignisse neu startet (z. B. wenn ein fastboot-Updatebefehl abgeschlossen wurde).

    Ausgabe
    DeviceNotAvailableException

    postInvocationTearDown

    public void postInvocationTearDown (Throwable exception)

    Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach dem Aufruf ausgeführt 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 gerätespezifische erforderliche Einrichtung, die vor dem Aufruffluss 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 abgerufen werden soll

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

    Ausgabe
    DeviceNotAvailableException

    PullDir

    public boolean pullDir (String deviceFilePath, 
                    File localDir)

    Verzeichnisinhalte rekursiv vom Gerät abrufen.

    Parameter
    deviceFilePath String: der absolute Dateipfad der Remote-Quelle

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

    Returns
    boolean true, wenn die Datei 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 Inhalte gespeichert werden sollen. Wenn das Feld nicht leer ist, werden Inhalte ersetzt.

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

    Ausgabe
    DeviceNotAvailableException

    Pull-Datei

    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 abgerufen werden soll

    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 File pullFile (String remoteFilePath)

    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.

    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 Inhalte gespeichert werden sollen. Wenn das Feld nicht leer ist, werden Inhalte ersetzt.

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

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

    Ausgabe
    DeviceNotAvailableException

    PullFileContents

    public String pullFileContents (String remoteFilePath)

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

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

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

    Ausgabe
    DeviceNotAvailableException

    PullFileFromExternal

    public File pullFileFromExternal (String remoteFilePath)

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

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

    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

    PushDir

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

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

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

    deviceFilePath String: der absolute Dateipfad des Remote-Ziels

    excludedDirectories : Satz ausgeschlossener Verzeichnisnamen, die nicht übertragen 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 übertragen werden soll

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

    Ausgabe
    DeviceNotAvailableException

    Push-Datei

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

    Variante von pushFile(File, String), die optional den Bedarf an den Contentanbieter prüfen kann

    Parameter
    localFile File: die lokale Datei, die übertragen werden soll

    remoteFilePath String: der absolute Dateipfad des Remote-Ziels

    evaluateContentProviderNeeded boolean: ob geprüft werden soll, ob der Contentanbieter benötigt wird

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

    Ausgabe
    DeviceNotAvailableException

    Push-Datei

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

    Übertragen Sie eine Datei per Push auf das Gerät. Standardmäßig wird ein Contentanbieter verwendet.

    Parameter
    localFile File: die lokale Datei, die übertragen werden soll

    remoteFilePath String: der absolute Dateipfad des Remote-Ziels

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

    Ausgabe
    DeviceNotAvailableException

    Push-Datei

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

    Übertragen Sie eine Datei per Push auf das Gerät. Standardmäßig wird ein Contentanbieter verwendet.

    Parameter
    localFile File: die lokale Datei, die übertragen werden soll

    remoteFilePath String: der absolute Dateipfad des Remote-Ziels

    userId int: die Nutzer-ID, an die übertragen 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 übertragen wurde. Andernfalls false.

    Ausgabe
    DeviceNotAvailableException

    neu starten

    public void reboot (String reason)

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

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

    Der Grund für den letzten Neustart kann durch Abfrage der sys.boot.reason-Eigenschaft 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.

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

    Ausgabe
    DeviceNotAvailableException

    NeustartIntoBootloader

    public void rebootIntoBootloader ()

    Startet das Gerät im Bootloader-Modus neu.

    Wird 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

    NeustartIntoRecovery

    public void rebootIntoRecovery ()

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

    Blockiert, bis das Gerät mit der Wiederherstellung beginnt

    Ausgabe
    DeviceNotAvailableException

    NeustartIntoSideload

    public void rebootIntoSideload ()

    Startet das Gerät im ADB-Sideload-Modus neu. Beachten Sie, dass dies ein spezieller Modus für die Wiederherstellung ist.

    Wird 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. Beachten Sie, dass dies ein spezieller Modus für die Wiederherstellung ist.

    Wird 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

    NeustartUntilOnline

    public void rebootUntilOnline ()

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

    Ausgabe
    DeviceNotAvailableException

    NeustartUntilOnline

    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 Userspace-Teil des Geräts neu.

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

    WARNUNG. Der Neustart des Userspaces wird derzeit aktiv entwickelt. Sie können ihn auf eigenes Risiko verwenden.

    Ausgabe
    DeviceNotAvailableException

    NeustartUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

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

    Ausgabe
    DeviceNotAvailableException

    Gerät wiederherstellen

    public boolean recoverDevice ()

    Versuche, die Gerätekommunikation wiederherzustellen.

    Returns
    boolean „True“, wenn die Wiederherstellung erfolgreich war, und „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 benachrichtigt, bevor eine Geräteaktion beginnt und nachdem die Geräteaktion endet.

    Parameter
    deviceActionReceiver IDeviceActionReceiver: Eine IDeviceActionReceiver, die registriert wird.

    remountSystemReadOnly

    public void remountSystemReadOnly ()

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

    Ausgabe
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

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

    Ausgabe
    DeviceNotAvailableException

    remountVendorReadOnly

    public void remountVendorReadOnly ()

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

    Ausgabe
    DeviceNotAvailableException

    remountVendorWritable (remountVendorWritable)

    public void remountVendorWritable ()

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

    Ausgabe
    DeviceNotAvailableException

    Admin entfernen

    public boolean removeAdmin (String componentName, 
                    int userId)

    Den angegebenen Geräteadministrator für den Nutzer entfernen und true zurückgeben, wenn der Vorgang erfolgreich war, andernfalls false.

    Parameter
    componentName String: des Geräteadministrators, der entfernt werden soll

    userId int: des Nutzers, in dem der Geräteadministrator lebt.

    Returns
    boolean „True“, wenn der Vorgang erfolgreich ist, andernfalls „False“.

    Ausgabe
    DeviceNotAvailableException

    Inhaber entfernen

    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

    resetContentProvider-Einrichtung

    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)

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

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

    listeners ITestLifeCycleReceiver: die 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 durch und bietet Gerätewiederherstellung.

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

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

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

    listeners : die Testergebnis-Listener

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

    Ausgabe
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

    Hat dieselbe Funktion wie ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)), führt aber den Test 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)

    Hat dieselbe Funktion wie ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, ITestLifeCycleReceiver...), führt aber den Test für einen bestimmten Nutzer aus.

    Parameter
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Returns
    boolean

    Ausgabe
    DeviceNotAvailableException

    setConfiguration

    public void setConfiguration (IConfiguration configuration)

    Injiziertes IConfiguration in Gebrauch.

    Parameter
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    Parameter
    avdInfo GceAvdInfo

    Datum festlegen

    public void setDate (Date date)

    Legt das Datum auf dem Gerät fest

    Hinweis: Zum Festlegen des Datums auf dem Gerät ist ein Root erforderlich

    Parameter
    date Date: gibt ein bestimmtes Datum an. Es wird das Hostdatum 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 wird der Geräteeigentümer sein.

    userId int: des Nutzers, in dem der Geräteeigentümer wohnt.

    Returns
    boolean „True“, wenn der Vorgang erfolgreich ist, 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)

    Legen Sie für den Emulator SizeLimitedOutputStream fest, um die Ausgabe zu protokollieren

    Parameter
    output SizeLimitedOutputStream: zum Protokollieren der Ausgabe

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

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

    Parameter
    p Process

    setFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

    Legen Sie die Fastboot-Option für das Gerät fest. Sollte bei der ersten Zuweisung des Geräts festgelegt werden.

    Parameter
    fastbootEnabled boolean: gibt an, ob Fastboot für das Gerät verfügbar ist oder nicht

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

    Legt den Pfad zum zu verwendenden Fastboot-Binärprogramm fest. Damit die Schnellstart-Funktionen aktiviert sind, muss isFastbootEnabled() weiterhin "true" sein.

    Parameter
    fastbootPath String

    SetIDevice

    public void setIDevice (IDevice newDevice)

    Aktualisiere das mit diesem ITestDevice verknüpfte IDevice.

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

    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

    Optionen

    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 der ADB-Stamm „true“ ist.

    Parameter
    propKey String: Der festzulegende Schlüssel.

    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 bei der ersten Zuweisung des Geräts festgelegt werden.

    Parameter
    recovery IDeviceRecovery: die IDeviceRecovery

    Wiederherstellungsmodus festlegen

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

    Damit wird gesteuert, welche Wiederherstellungsmethode bei Problemen mit der Gerätekommunikation verwendet werden soll. 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: Gibt an, ob der Modus „Nur bis online wiederherstellen“ aktiviert sein soll oder nicht.

    Einstellung festlegen

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

    Siehe setSetting(int, String, String, String) und wird für einen Systemnutzer ausgeführt.

    Parameter
    namespace String

    key String

    value String

    Ausgabe
    DeviceNotAvailableException

    Einstellung festlegen

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

    Fügt dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzu. 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

    setTestProtokollierung

    public void setTestLogger (ITestLogger testLogger)

    ITestLogger-Instanz einschleusen

    Parameter
    testLogger ITestLogger

    Schnellstart-Funktion verwenden

    public void setUseFastbootErase (boolean useFastbootErase)

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

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

    startLogcat

    public void startLogcat ()

    Starte die Aufzeichnung 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 aktuell beendet 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 true, wenn der Nutzer im Hintergrund gestartet wurde.

    Ausgabe
    DeviceNotAvailableException

    startUser (Startnutzer)

    public boolean startUser (int userId, 
                    boolean waitFlag)

    Startet einen bestimmten Nutzer im Hintergrund, wenn er aktuell beendet ist. Wenn der Nutzer bereits im Hintergrund ausgeführt wird, ist diese Methode eine NOOP-Methode. Es kann ein zusätzliches Flag angegeben werden, um auf die Wirkung des Vorgangs zu warten.

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

    waitFlag boolean: sorgt dafür, dass der Befehl wartet, bis der Nutzer gestartet und entsperrt wird.

    Returns
    boolean true, 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 jeweiligen Bildschirm sichtbar ist (d.h., der Nutzer kann Aktivitäten auf dieser Anzeige starten).

    HINWEIS : Mit diesem Befehl wird nicht geprüft, ob der Nutzer existiert, die Anzeige verfügbar ist, device supports such feature usw.

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

    displayId int: Anzeige zum Starten des Nutzers sichtbar auf

    waitFlag boolean: sorgt dafür, dass der Befehl wartet, bis der Nutzer gestartet und entsperrt wird.

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

    Erfassen der Logcat-Ausgabe vom Gerät beenden und aktuell gespeicherte Logcat-Daten verwerfen.

    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 gestoppt wurde, ist diese Methode eine NOOP-Methode. Aktuellen Nutzer und Systemnutzer können nicht beendet werden.

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

    Returns
    boolean true, wenn der Nutzer erfolgreich beendet wurde.

    Ausgabe
    DeviceNotAvailableException

    stopUser

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

    Stoppen Sie einen bestimmten Nutzer. Es können zusätzliche Flags bereitgestellt werden, um auf den Vorgang zu warten und die Beendigung des Nutzers zu erzwingen. Aktuellen Nutzer und Systemnutzer können nicht beendet werden.

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

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

    forceFlag boolean: erzwingt das Beenden des Nutzers.

    Returns
    boolean true, wenn der Nutzer erfolgreich beendet 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 gewechselt werden konnte

    Ausgabe
    DeviceNotAvailableException

    Wechsel zu AdBUsb

    public boolean switchToAdbUsb ()

    Schalte das Gerät in den ADB-over-USB-Modus um.

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

    Ausgabe
    DeviceNotAvailableException

    SwitchUser

    public boolean switchUser (int userId)

    Zu einer anderen Nutzer-ID mit Standardzeitlimit wechseln. 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: Warten, bis „false“ für Switch-User zurückgegeben wird.

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

    Ausgabe
    DeviceNotAvailableException

    Dateien synchronisieren

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

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

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

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

    Beispielanwendung: syncFiles("/tmp/files", "/sdcard") erstellt ein /sdcard/files-Verzeichnis, falls es noch nicht vorhanden ist, und überträgt die /tmp/files-Inhalte rekursiv in das Verzeichnis /sdcard/files.

    Parameter
    localFileDir File: das lokale Dateiverzeichnis, das die Dateien enthält, die rekursiv übertragen werden sollen.

    deviceFilePath String: Stamm des absoluten Dateipfads des Remote-Ziels Alle Verzeichnisse in diesem Dateipfad müssen lesbar sein, d. h., das Senden von Push-Nachrichten an „/data/local/tmp“, wenn ADB kein Root ist, schlägt fehl.

    Returns
    boolean true, wenn die Dateien 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. Geben Sie im Falle eines Problems null zurück. Die Datei, auf die im Fehlerbericht-Objekt verwiesen wird, muss mit Bugreport.close() bereinigt werden.

    Returns
    Bugreport

    Deinstallationspaket

    public String uninstallPackage (String packageName)

    Android-Paket vom Gerät deinstallieren

    Parameter
    packageName String: das zu deinstallierende Android-Paket

    Returns
    String ein String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.

    Ausgabe
    DeviceNotAvailableException

    deinstallierenPackageForUser

    public String uninstallPackageForUser (String packageName, 
                    int userId)

    Android-Paket für einen bestimmten Nutzer vom Gerät deinstallieren

    Parameter
    packageName String: das zu deinstallierende Android-Paket

    userId int: die ganzzahlige Nutzer-ID, für die deinstalliert werden soll.

    Returns
    String ein String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.

    Ausgabe
    DeviceNotAvailableException

    Gerät entsperren

    public boolean unlockDevice ()

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

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

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

    Ausgabe
    DeviceNotAvailableException

    unmountDebugfs

    public void unmountDebugfs ()

    Trennen Sie „debugfs“.

    Ausgabe
    DeviceNotAvailableException

    WartefürBootAbgeschlossen

    public boolean waitForBootComplete (long timeOut)

    Blockiert, bis das Flag „Boot abgeschlossen“ des Geräts gesetzt wird.

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

    Returns
    boolean "true", wenn das Flag "Boot abgeschlossen" des Geräts innerhalb des Zeitlimits gesetzt ist

    Ausgabe
    DeviceNotAvailableException

    WaitForDeviceVerfügbar

    public boolean waitForDeviceAvailable ()

    Wartet, bis das Gerät reagiert und zum Testen verfügbar ist. Verwendet das Standardzeitlimit.

    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 zum Testen 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

    WaitForDeviceAvailableInRecoveryPath

    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 verfügbar.

    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)

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

    Parameter
    waitTime long: die Wartezeit in ms

    Returns
    boolean true, wenn das Gerät vor Ablauf des Zeitlimits in die Wiederherstellung startet. Andernfalls false

    WartefürGerätInSideload

    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 Sideload startet. Andernfalls false

    WaitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

    Blockierungen für das Gerät, die nicht verfügbar sind, d. h. in ADB fehlen

    Parameter
    waitTime long: die Wartezeit in ms

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

    WarteFürGerätOnline

    public void waitForDeviceOnline ()

    Blockiert, bis das Gerät über ADB sichtbar ist. Verwendet Standardzeitüberschreitung

    Beachten Sie, dass das Gerät nach Abschluss der Ausführung nicht unbedingt auf Befehle reagiert. Verwende stattdessen waitForDeviceAvailable().

    Ausgabe
    DeviceNotAvailableException

    WarteFürGerätOnline

    public void waitForDeviceOnline (long waitTime)

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

    Beachten Sie, dass das Gerät nach Abschluss der Ausführung nicht unbedingt auf Befehle reagiert. 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 vor Ablauf des waitTime responsiv wird.

    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

    neustartgerätaktion erstellen

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

    Erstellen Sie eine RebootDeviceAction, die beim Ausführen eines Neustarts verwendet werden soll.

    Parameter
    rebootMode NativeDevice.RebootMode: ein Modus dieses Neustarts.

    reason String: für diesen Neustart.

    Returns
    NativeDevice.RebootDeviceAction die erstellte RebootDeviceAction.

    createRunUtil

    protected IRunUtil createRunUtil ()

    Returns
    IRunUtil

    doAdbNeustart

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

    Starten Sie ADB-Neustart.

    Parameter
    rebootMode NativeDevice.RebootMode: ein Modus dieses Neustarts.

    reason String: für diesen Neustart.

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    KeepRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

    Hilfsmethode zum Auslösen einer Ausnahme, wenn die Laufzeitberechtigung nicht unterstützt wird

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getApiLevelSafe

    protected int getApiLevelSafe ()

    Returns
    int

    getProtokollierung

    protected ITestLogger getLogger ()

    Returns
    ITestLogger

    getRunUtil (GetRunUtil)

    protected IRunUtil getRunUtil ()

    Rufen Sie die zu verwendende RunUtil-Instanz ab.

    Returns
    IRunUtil

    InitialConnection (Initialisieren)

    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)

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

    Parameter
    propName String: Name des Geräteattributs, wie von „adb shell getprop“ zurückgegeben

    fastbootVar String: der Name der entsprechenden Fastboot-Variable, die abgefragt werden soll. Wenn null, wird keine Fastboot-Abfrage ausgeführt.

    description String: Eine einfache Beschreibung der Variable. Der erste Buchstabe sollte großgeschrieben werden.

    Returns
    String Ein String, der den Wert des angegebenen Attributs enthält und möglicherweise null oder leer ist

    Ausgabe
    DeviceNotAvailableException

    isInNeustartCallback

    protected boolean isInRebootCallback ()

    Gibt zurück, ob gerade Neustart-Callbacks ausgeführt werden oder nicht. Alle öffentlichen APIs für den Neustart sollten deaktiviert werden, wenn sie auf „true“ gesetzt ist.

    Returns
    boolean

    istNeuer

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

    Gibt true zurück, wenn die lokale Datei neuer als die Remote-Datei ist. IFileEntry ist minutengenau. Bei identischen Zeiten gilt die Datei als neuer.

    Parameter
    localFile File

    entry IFileEntry

    Returns
    boolean

    Benachrichtigt das Ende des Neustarts

    protected void notifyRebootEnded ()

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

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Benachrichtigunneustarted

    protected void notifyRebootStarted ()

    Benachrichtigt alle IDeviceActionReceiver über das Ereignis „Neustart“.

    Ausgabe
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    Geräteaktion ausführen

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

    Führt eine Aktion auf diesem Gerät aus. Versucht, das Gerät wiederherzustellen und den Befehl optional zu wiederholen, wenn 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: Wiederholungsversuche, wenn die Wiederherstellung fehlschlägt, die Wiederherstellung aber erfolgreich ist

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

    Ausgabe
    DeviceNotAvailableException Wiederherstellungsversuch fehlgeschlagen oder maximale Anzahl erfolgloser Versuche

    postAdbNeustart

    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

    Uhr einstellen

    protected void setClock (Clock clock)

    Legen Sie die zu verwendende Uhrinstanz fest.

    Parameter
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

    Kennzeichnet das Testgerät als Mikrodroid und legt seine Kundennummer 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 (beenden Sie die Berichterstellung an ADB).

    Parameter
    operationDesc String: Der Name des Vorgangs, der auf Nichtverfügbarkeit wartet.

    time long: Die Zeit, die gewartet wird, bis nichts verfügbar ist.

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