NativeDevice

public class NativeDevice
extends Object implements IConfigurationReceiver, IManagedTestDevice, ITestLoggerReceiver

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


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

Zusammenfassung

Verschachtelte Klassen

class NativeDevice.AdbAction

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

class NativeDevice.AdbShellAction

 

class NativeDevice.RebootDeviceAction

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

Konstanten

String DEBUGFS_PATH

int INVALID_USER_ID

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

long MAX_HOST_DEVICE_TIME_OFFSET

int MAX_RETRY_ATTEMPTS

die Standardanzahl der Wiederholungsversuche für Befehle

String SD_CARD

String STORAGE_EMULATED

Felder

protected TestDeviceOptions mOptions

protected final IDeviceStateMonitor mStateMonitor

Öffentliche Konstruktoren

NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Erstellt ein TestDevice.

Öffentliche Methoden

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

Installieren Sie ein Android-Paket mit dem adb-Befehl auf einem Gerät.

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

Installieren Sie ein Android-Paket mit dem adb-Befehl auf einem Gerät.

void batchPrefetchStartupBuildProps()

Mikrooptimierung (ca. 400 Millisekunden) durch Vorabrufen aller benötigten Attribute anstatt „adb getprop“ für jedes Attribut aufzurufen.

boolean canSwitchToHeadlessSystemUser()

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

boolean checkApiLevelAgainstNextRelease(int strictMinLevel)

Prüfen, ob eine Funktion bei einem minimal unterstützten Level derzeit unterstützt wird.

boolean checkConnectivity()

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

boolean clearErrorDialogs()

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

void clearLastConnectedWifiNetwork()

Löscht das zuletzt verbundene WLAN.

void clearLogcat()

Löscht alle angesammelten Logcat-Daten.

IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult(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.

IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk)

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

IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)

Verbindung zu einem WLAN herstellen

IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk)

Verbindung zu einem WLAN herstellen

IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk, boolean scanSsid)

Verbindung zu einem WLAN herstellen

IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk)

Verbindung zu einem WLAN herstellen

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

Einen Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

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

Einen Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

int createUser(String name)

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

int createUserNoThrow(String name)

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

DeviceInspectionResult debugDeviceNotAvailable()

Ein Gerät prüfen und detaillierte Informationen zurückgeben, wenn ein Gerät nicht mehr verfügbar ist.

void deleteFile(String deviceFilePath, int userId)

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

void deleteFile(String deviceFilePath)

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

void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Entfernt die registrierte IDeviceActionReceiver.

boolean deviceSoftRestarted(ProcessInfo prevSystemServerProcess)

Hilfsmethode zum Prüfen, ob das Gerät durch Vergleich des aktuellen system_server mit dem vorherigen system_server ProcessInfo neu gestartet wurde.

boolean deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)

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

boolean disableAdbRoot()

Deaktiviert den ADB-Root-Zugriff.

void disableKeyguard()

Es wird versucht, die Keyguard-Funktion zu deaktivieren.

boolean disableNetworkMonitor()

Deaktiviert die Netzwerküberwachung auf dem Gerät.

boolean disconnectFromWifi()

Die Verbindung zu einem WLAN wird getrennt.

boolean doesFileExist(String deviceFilePath, int userId)

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

boolean doesFileExist(String deviceFilePath)

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

File dumpHeap(String process, String devicePath)

Versuchen Sie, den Heap aus dem system_server zu sichern.

boolean enableAdbRoot()

Aktiviert den ADB-Root-Zugriff.

boolean enableNetworkMonitor()

Aktiviert die Netzwerküberwachung auf dem Gerät.

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

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

String executeAdbCommand(String... cmdArgs)

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

String executeAdbCommand(long timeout, Map<String, String> envMap, String... cmdArgs)

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

CommandResult executeAdbV2Command(String... cmdArgs)

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

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

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

CommandResult executeAdbV2Command(long timeout, Map<String, String> envMap, String... cmdArgs)

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

CommandResult executeAdbV2Command(long timeout, Map<String, String> envMap, int retryAttempts, String... cmdArgs)

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

CommandResult executeFastbootCommand(String... cmdArgs)

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

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

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

CommandResult executeLongFastbootCommand(String... cmdArgs)

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

CommandResult executeLongFastbootCommand(Map<String, String> envVarMap, String... cmdArgs)

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

String executeShellCommand(String command)

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

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

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

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

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

void executeShellCommand(String command, IShellOutputReceiver receiver)

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

CommandResult executeShellV2Command(String cmd)

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

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

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

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

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

CommandResult executeShellV2Command(String cmd, File pipeAsInput)

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

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

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

CommandResult executeShellV2Command(String cmd, OutputStream pipeToOutput)

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

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

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

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

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

CommandResult executeShellV2Command(String cmd, IShellOutputReceiver receiver)

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

CommandResult fastbootOemRamdumpNow()

Hilfsmethode, die einen RAM-Dump über den Fastboot-Modus auslöst.

CommandResult fastbootWipePartition(String partition)

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

Set<ITestDevice.ApexInfo> getActiveApexes()

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

String getAdbPath()

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

Map<String, String> getAllSettings(String namespace)

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

DeviceAllocationState getAllocationState()

Gibt den aktuellen Zuweisungsstatus des Geräts zurück

String getAndroidId(int userId)

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

Map<Integer, String> getAndroidIds()

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

int getApiLevel()

Das API-Level des Geräts abrufen.

int getApiLevelFull()

Ähnlich wie getApiLevel(), gibt aber die vollständige Version zurück.

PackageInfo getAppPackageInfo(String packageName)

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

List<PackageInfo> getAppPackageInfos()

Informationen zu auf dem Gerät installierten Paketen abrufen.

String getBasebandVersion()

Einfache Methode zum Abrufen der Baseband-Version (Funkmodul) dieses Geräts.

Integer getBattery()

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

boolean getBooleanProperty(String name, boolean defaultValue)

Gibt den booleschen Wert der angegebenen Property zurück.

Map<Long, String> getBootHistory()

Die Hilfsmethode erfasst die Bootverlaufskarte mit Bootzeit und Bootgrund.

Map<Long, String> getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)

Die Hilfsmethode ruft die Karte mit dem Bootverlauf mit Bootzeit und Bootgrund seit der angegebenen Zeit seit der Epoche vom Gerät und der angegebenen Zeiteinheit ab.

String getBootloaderVersion()

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

InputStreamSource getBugreport()

Ruft einen Fehlerbericht vom Gerät ab.

InputStreamSource getBugreportz()

Ruft einen Fehlerbericht vom Gerät ab.

String getBuildAlias()

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

String getBuildFlavor()

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

String getBuildId()

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

String getBuildSigningKeys()

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

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

DeviceDescriptor getCachedDeviceDescriptor()

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

DeviceDescriptor getCachedDeviceDescriptor(boolean shortDescriptor)

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

String[] getChildren(String path)

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

AbstractConnection getConnection()

Die aktuelle Verbindung des Geräts.

ContentProviderHandler getContentProvider(int userId)

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

DeviceFoldableState getCurrentFoldableState()

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

int getCurrentUser()

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

String getDeviceClass()

Geräteklasse abrufen

long getDeviceDate()

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

DeviceDescriptor getDeviceDescriptor()

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

DeviceDescriptor getDeviceDescriptor(boolean shortDescriptor)

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

TestDeviceState getDeviceState()

Gerätestatus abrufen

long getDeviceTimeOffset(Date date)

Helper zum Abrufen der Zeitdifferenz zwischen dem Gerät und einem bestimmten Date.

InputStreamSource getEmulatorOutput()

Stream von Emulator-stdout und -stderr abrufen

Process getEmulatorProcess()

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

final File getExecuteShellCommandLog()

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

long getExternalStoreFreeSpace()

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

String getFastbootPath()

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

String getFastbootProductType()

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

String getFastbootProductVariant()

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

String getFastbootSerialNumber()

Gibt die Seriennummer im Fastboot-Modus zurück.

String getFastbootVariable(String variableName)

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

String getFastbootVersion()

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

IFileEntry getFileEntry(String path)

Eine Referenz auf eine Remotedatei auf dem Gerät abrufen

IFileEntry getFileEntry(FileListingService.FileEntry entry)

Inoffizieller Helfer zum Abrufen eines FileEntry aus einem Nicht-Root-Pfad.

Set<DeviceFoldableState> getFoldableStates()

Gibt die Liste der faltbaren Status auf dem Gerät zurück.

IDevice getIDevice()

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

Set<String> getInstalledPackageNames()

Die Paketnamen der auf dem Gerät vorhandenen Anwendungen abrufen.

long getIntProperty(String name, long defaultValue)

Gibt den Ganzzahlwert der angegebenen Eigenschaft des Geräts zurück.

String getIpAddress()

Ruft die IP-Adresse des Geräts ab.

KeyguardControllerState getKeyguardState()

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

long getLastExpectedRebootTimeMillis()

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

int getLaunchApiLevel()

Ruft das API-Level des Geräts bei der ersten Markteinführung ab.

InputStreamSource getLogcat()

Erstellt einen Snapshot-Stream der logcat-Daten.

InputStreamSource getLogcat(int maxBytes)

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

InputStreamSource getLogcatDump()

Rufen Sie einen Dump des aktuellen Logcat für das Gerät ab.

InputStreamSource getLogcatSince(long date)

Ruft einen Snapshot-Stream der erfassten logcat-Daten ab, beginnend mit dem angegebenen Datum.

String getMacAddress()

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

Integer getMainUserId()

Gibt die Hauptnutzer-ID zurück.

Set<String> getMainlineModuleInfo()

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

int getMaxNumberOfRunningUsersSupported()

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

int getMaxNumberOfUsersSupported(String userType)

Ruft die maximale Anzahl der unterstützten Nutzer des angegebenen Nutzertyps ab.

int getMaxNumberOfUsersSupported()

Ruft die maximale Anzahl der unterstützten wechselbaren Nutzer ab, ohne Gäste.

Process getMicrodroidProcess()
IDeviceStateMonitor getMonitor()

Gibt die mit dem Gerät verknüpfte IDeviceStateMonitor zurück.

String getMountPoint(String mountName)

Gibt einen Bereitstellungspunkt zurück.

ITestDevice.MountPointInfo getMountPointInfo(String mountpoint)

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

List<ITestDevice.MountPointInfo> getMountPointInfo()

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

TestDeviceOptions getOptions()

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

long getPartitionFreeSpace(String partition)

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

Integer getPrimaryUserId()

Gibt die Hauptnutzer-ID zurück.

ProcessInfo getProcessByName(String processName)

Die Hilfsmethode führt die Befehle „pidof“ und „stat“ aus und gibt das ProcessInfo-Objekt mit der PID und der Startzeit des angegebenen Prozesses zurück.

String getProcessPid(String process)

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

String getProductType()

Bequeme Methode zum Abrufen des Produkttyps dieses Geräts.

String getProductVariant()

Bequeme Methode zum Abrufen der Produktvariante dieses Geräts.

String getProperty(String name)

Ruft den angegebenen Attributwert vom Gerät ab.

ITestDevice.RecoveryMode getRecoveryMode()

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

int getRemainingCreatableUserCount(String userType)

Gibt zurück, wie viele Nutzer des angegebenen Nutzertyps auf diesem Gerät erstellt werden können.

InputStreamSource getScreenshot(Long displayId, String format, boolean rescale)

Erstellt einen Screenshot des Displays mit der angegebenen ID im unterstützten Format.

InputStreamSource getScreenshot(String format)

Erstellt einen Screenshot vom Gerät.

InputStreamSource getScreenshot(long displayId)

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

InputStreamSource getScreenshot(String format, boolean rescale)

Erstellt einen Screenshot vom Gerät.

InputStreamSource getScreenshot()

Erstellt einen Screenshot vom Gerät.

String getSerialNumber()

Bequeme Methode zum Abrufen der Seriennummer dieses Geräts.

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

Gibt den Wert der angeforderten Einstellung zurück.

String getSetting(String namespace, String key)

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

String getSimOperator()

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

String getSimState()

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

List<File> getTombstones()

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

long getTotalMemory()

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

String getTrackingSerial()

Rufen Sie die Seriennummer ab, die zum Verfolgen des Geräts verwendet wird.

Set<String> getUninstallablePackageNames()

Ruft die Paketnamen der Anwendungen ab, die deinstalliert werden können.

boolean getUseFastbootErase()

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

int getUserFlags(int userId)

Sucht nach den Markierungen eines bestimmten Nutzers und gibt sie zurück.

Map<Integer, UserInfo> getUserInfos()

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

int getUserSerialNumber(int userId)

Gibt die dem userId zugeordnete Seriennummer zurück, falls gefunden, andernfalls -10000.

int getUserVisibleOnDisplay(int displayId)

Ruft die Nutzer-ID des sichtbaren Nutzers auf dem angegebenen Display ab.

IManagedTestDevice.DeviceEventResponse handleAllocationEvent(DeviceEvent event)

Verarbeite das angegebene DeviceEvent.

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

boolean hasFeature(String feature)

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

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

Stellen Sie die Verbindung zum Gerät her.

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

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

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

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

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

Installiert ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.

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

Installiert ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.

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

Installiert APKs im inkrementellen Modus.

void invalidatePropertyCache()
boolean isAdbRoot()

boolean isAdbTcp()
boolean isAppEnumerationSupported()

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

boolean isBypassLowTargetSdkBlockSupported()

Prüfen, ob die Plattform auf dem Gerät das Umgehen der Blockierung aufgrund des niedrigen Ziel-SDK bei der App-Installation unterstützt

boolean isDebugfsMounted()

Prüfen Sie, ob „debugfs“ gemountet ist.

boolean isDeviceEncrypted()

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

boolean isDirectory(String path)

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

boolean isEnableAdbRoot()
boolean isEncryptionSupported()

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

boolean isExecutable(String fullPath)

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

boolean isFastbootEnabled()

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

boolean isHeadless()

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

boolean isHeadlessSystemUserMode()

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

boolean isMainUserPermanentAdmin()

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

boolean isMultiUserSupported()

Gibt zurück, ob dieses Gerät mehrere umschaltbare Nutzer mit eigenem Login und anpassbarem Bereich unterstützt.

boolean isPackageInstalled(String packageName, String userId)

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

boolean isPackageInstalled(String packageName)

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

boolean isRuntimePermissionSupported()

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

boolean isShellV2Support()
boolean isStateBootloaderOrFastbootd()

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

boolean isUserRunning(int userId)

Prüfen, ob ein bestimmter Nutzer aktiv ist.

boolean isUserSecondary(int userId)

Gibt zurück, ob der angegebene Nutzer anhand seiner Flags ein sekundärer Nutzer ist.

boolean isUserVisible(int userId)

Prüft, ob der angegebene Nutzer sichtbar ist.

boolean isUserVisibleOnDisplay(int userId, int displayId)

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

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

Gibt zurück, ob Nutzer im Hintergrund in ERROR(/java.android.view.Display#DEFAULT_DISPLAY) sichtbar sein dürfen.

boolean isVisibleBackgroundUsersSupported()

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

boolean isWifiEnabled()

Prüfen, ob WLAN aktiviert ist.

Set<Long> listDisplayIds()

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

Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers()

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

ArrayList<Integer> 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)

Helper-Methode zum Erstellen eines Fehlerberichts und zum Protokollieren des Berichts für die Reporter.

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

Eine Nachricht im Logcat des Geräts protokollieren.

void mountDebugfs()

debugfs bereitstellen.

void nonBlockingReboot()

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

void postAdbRootAction()

Überschreiben, wenn auf dem Gerät nach dem Ausführen von „adb root“ und bevor das Gerät wieder online ist, bestimmte Aktionen ausgeführt werden müssen.

void postAdbUnrootAction()

Überschreiben, wenn auf dem Gerät nach dem Aufheben des Rootings über ADB und vor dem erneuten Onlinegehen des Geräts bestimmte Aktionen ausgeführt werden müssen.

void postBootSetup()

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

void postInvocationTearDown(Throwable exception)

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

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

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

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

Verzeichnisinhalte rekursiv vom Gerät abrufen.

boolean pullDir(String deviceFilePath, File localDir)

Verzeichnisinhalte rekursiv vom Gerät abrufen.

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

Verzeichnisinhalte rekursiv vom Gerät abrufen.

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

Ruft eine Datei vom Gerät ab.

boolean pullFile(String remoteFilePath, File localFile)

Ruft eine Datei vom Gerät ab.

File pullFile(String remoteFilePath, int userId)

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

File pullFile(String remoteFilePath)

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

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

Ruft eine Datei vom Gerät ab.

String pullFileContents(String remoteFilePath)

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

File pullFileFromExternal(String remoteFilePath)

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

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

Verzeichnisinhalte rekursiv auf das Gerät übertragen.

boolean pushDir(File localFileDir, String deviceFilePath, Set<String> excludedDirectories)

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

boolean pushDir(File localFileDir, String deviceFilePath)

Verzeichnisinhalte rekursiv auf das Gerät übertragen.

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

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

boolean pushFile(File localFile, String remoteFilePath)

Eine Datei auf ein Gerät übertragen

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

Eine Datei auf ein Gerät übertragen

boolean pushString(String contents, String remoteFilePath)

Aus einem String erstellte Datei an ein Gerät senden

void reboot(String reason)

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

String reboot(String command, String reason)

Startet das Gerät mit dem angegebenen command neu.

void reboot()

Startet das Gerät im ADB-Modus neu.

void rebootIntoBootloader()

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

void rebootIntoFastbootd()

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

void rebootIntoRecovery()

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

void rebootIntoSideload()

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

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

void rebootIntoSideload(boolean autoReboot)

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

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

void rebootUntilOnline()

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

void rebootUntilOnline(String reason)

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

void rebootUserspace()

Startet nur den 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 sichtbar ist.

boolean recoverDevice()

Es wird versucht, die Gerätekommunikation wiederherzustellen.

void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Registriert ein IDeviceActionReceiver für dieses Gerät.

void remountSystemReadOnly()

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

void remountSystemWritable()

Machen Sie die Systempartition auf dem Gerät beschreibbar.

void remountVendorReadOnly()

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

void remountVendorWritable()

Machen Sie die Anbieterpartition auf dem Gerät beschreibbar.

boolean removeAdmin(String componentName, int userId)

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

void removeOwners()

Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen.

boolean removeUser(int userId)

Einen bestimmten Nutzer vom Gerät entfernen.

void resetContentProviderSetup()

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

boolean runInstrumentationTests(IRemoteAndroidTestRunner runner, Collection<ITestLifeCycleReceiver> listeners)

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

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

Bequeme Methode zum Ausführen von runInstrumentationTests(IRemoteAndroidTestRunner,Collection) mit einem oder mehreren Listenern, die als Parameter übergeben werden.

boolean runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, Collection<ITestLifeCycleReceiver> listeners)

Wie ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,Collection), führt den Test jedoch für den angegebenen Nutzer aus.

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

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

void setAdbPath(String adbPath)

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

void setConfiguration(IConfiguration configuration)

Fügt die verwendete IConfiguration ein.

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

Legt das Datum auf dem Gerät fest

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

boolean setDeviceOwner(String componentName, int userId)

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

void setDeviceState(TestDeviceState deviceState)

Aktualisieren Sie den Gerätestatus.

void setEmulatorOutputStream(SizeLimitedOutputStream output)

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

void setEmulatorProcess(Process p)

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

void setFastbootEnabled(boolean fastbootEnabled)

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

void setFastbootPath(String fastbootPath)

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

void setIDevice(IDevice newDevice)

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

void setLogStartDelay(int delay)

Legt die Zeit in Millisekunden fest, die gewartet werden soll, bevor die Logcat-Erfassung für ein Onlinegerät gestartet wird.

void setOptions(TestDeviceOptions options)

TestDeviceOptions für das Gerät festlegen

boolean setProperty(String propKey, String propValue)

Legt den angegebenen Eigenschaftswert auf dem Gerät fest.

void setRecovery(IDeviceRecovery recovery)

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

void setRecoveryMode(ITestDevice.RecoveryMode mode)

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

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

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

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

Fügen Sie dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzu.

void setTestLogger(ITestLogger testLogger)

Fügt die ITestLogger-Instanz ein.

void setTrackingSerial(String trackingSerial)

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

void setUseFastbootErase(boolean useFastbootErase)

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

void startLogcat()

Logcat-Ausgabe vom Gerät im Hintergrund erfassen.

boolean startTradeInModeTesting(int timeoutMs)

Aktivieren Sie den Testmodus für die Inzahlungnahme.

boolean startUser(int userId)

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

boolean startUser(int userId, boolean waitFlag)

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

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

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

void stopEmulatorOutput()

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

void stopLogcat()

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

void stopTradeInModeTesting()

Test des Trade-In-Modus beenden

boolean stopUser(int userId)

Stoppt einen bestimmten Nutzer.

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

Einen bestimmten Nutzer stoppen.

String switchToAdbTcp()

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

boolean switchToAdbUsb()

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

boolean switchUser(int userId)

Wechseln Sie mit einem Standard-Timeout zu einer anderen userId.

boolean switchUser(int userId, long timeout)

Wechseln Sie mit dem angegebenen Zeitlimit zu einer anderen userId.

boolean syncFiles(File localFileDir, String deviceFilePath)

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

Bugreport takeBugreport()

Nimmt einen Fehlerbericht entgegen und gibt ihn in einem Bugreport-Objekt zurück, um ihn zu verarbeiten.

String uninstallPackage(String packageName)

Ein Android-Paket vom Gerät deinstallieren.

String uninstallPackageForUser(String packageName, int userId)

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

boolean unlockDevice()

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

void unmountDebugfs()

debugfs trennen.

boolean waitForBootComplete(long timeOut)

Blockiert, bis das Boot-Complete-Flag des Geräts gesetzt ist.

boolean waitForDeviceAvailable()

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

boolean waitForDeviceAvailable(long waitTime)

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

boolean waitForDeviceAvailableInRecoverPath(long waitTime)

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

void waitForDeviceBootloader()

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

void waitForDeviceFastbootD()
boolean waitForDeviceInRecovery(long waitTime)

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

boolean waitForDeviceInSideload(long waitTime)

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

boolean waitForDeviceNotAvailable(long waitTime)

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

void waitForDeviceOnline()

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

void waitForDeviceOnline(long waitTime)

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

boolean waitForDeviceShell(long waitTime)

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

Geschützte Methoden

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

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

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

Erstellt ein RebootDeviceAction, das beim Ausführen einer Neustartaktion verwendet werden soll.

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

Führen Sie einen ADB-Neustart durch.

void ensureRuntimePermissionSupported()

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

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

Rufen Sie die zu verwendende RunUtil-Instanz ab.

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

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

boolean isInRebootCallback()

Gibt zurück, ob Rückrufe für Neustarts gerade ausgeführt werden.

boolean isNewer(File localFile, IFileEntry entry)

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

void notifyRebootEnded()

Benachrichtigt alle IDeviceActionReceiver über das Ende des Neustarts.

void notifyRebootStarted()

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

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

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

void postAdbReboot(NativeDevice.RebootMode rebootMode)

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

void prePostBootSetup()

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

boolean pullFileWithAdbCommand(String remoteFilePath, File localFile, long timeout)
void setClock(Clock clock)

Legen Sie die zu verwendende Clock-Instanz fest.

void setMicrodroidProcess(Process process)

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

void setTestDeviceOptions(Map<String, String> deviceOptions)
CommandResult simpleFastbootCommand(long timeout, String[] fullCmd)

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

CommandResult simpleFastbootCommand(long timeout, Map<String, String> envVarMap, String[] fullCmd)

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

boolean waitForDeviceNotAvailable(String operationDesc, long time)

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

Konstanten

DEBUGFS_PATH

public static final String DEBUGFS_PATH

Konstanter Wert: "/sys/kernel/debug"

INVALID_USER_ID

public static final int INVALID_USER_ID

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

Konstanter Wert: -10000 (0xffffd8f0)

MAX_HOST_DEVICE_TIME_OFFSET

protected static final long MAX_HOST_DEVICE_TIME_OFFSET

Konstanter Wert: 5000 (0x0000000000001388)

MAX_RETRY_ATTEMPTS

protected static final int MAX_RETRY_ATTEMPTS

die Standardanzahl der Wiederholungsversuche für Befehle

Konstanter Wert: 2 (0x00000002)

SD_CARD

protected static final String SD_CARD

Konstanter Wert: "/sdcard/"

STORAGE_EMULATED

protected static final String STORAGE_EMULATED

Konstanter Wert: "/storage/emulated/"

Felder

mOptions

protected TestDeviceOptions mOptions

mStateMonitor

protected final IDeviceStateMonitor mStateMonitor

Öffentliche Konstruktoren

NativeDevice

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

Erstellt ein TestDevice.

Parameter
device IDevice: die zugehörige IDevice

stateMonitor IDeviceStateMonitor: der zu verwendende IDeviceStateMonitor-Mechanismus

allocationMonitor IDeviceMonitor: Die IDeviceMonitor, die über Änderungen des Zuweisungsstatus informiert werden soll. Kann null sein.

Öffentliche Methoden

adbInstallPackage

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

Installieren Sie ein Android-Paket mit dem adb-Befehl auf einem Gerät.

Parameter
packageFile File: die zu installierende APK-Datei

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

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

Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.

Löst aus
DeviceNotAvailableException

adbInstallPackage

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

Installieren Sie ein Android-Paket mit dem adb-Befehl auf einem Gerät.

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

Parameter
packageFile File: die zu installierende APK-Datei

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

grantPermissions boolean: Gibt an, ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen.

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

Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.

Löst aus
DeviceNotAvailableException

batchPrefetchStartupBuildProps

public void batchPrefetchStartupBuildProps ()

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

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

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

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

checkApiLevelAgainstNextRelease

public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)

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

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

Gibt Folgendes zurück:
boolean „True“, wenn die Stufe unterstützt wird. Andernfalls „Falsch”.

Löst aus
DeviceNotAvailableException

checkConnectivity

public boolean checkConnectivity ()

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

Gibt Folgendes zurück:
boolean true, wenn das Gerät über eine funktionierende Netzwerkverbindung verfügt, false andernfalls.

Löst aus
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

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

Gibt Folgendes zurück:
boolean true, wenn keine Dialogfelder vorhanden waren oder Dialogfelder erfolgreich gelöscht wurden. Andernfalls false.

Löst aus
DeviceNotAvailableException

clearLastConnectedWifiNetwork

public void clearLastConnectedWifiNetwork ()

Löscht das zuletzt verbundene WLAN. Diese Methode sollte beim Starten eines neuen Aufrufs aufgerufen werden, um zu vermeiden, dass nach dem Neustart des Geräts eine Verbindung zum WLAN hergestellt wird, das im vorherigen Test verwendet wurde.

clearLogcat

public void clearLogcat ()

Löscht alle angesammelten Logcat-Daten.

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

connectToWifiNetworkIfNeededWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

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

Gibt Folgendes zurück:
IWifiHelper.WifiConnectionResult WifiConnectionResult gibt den Status der Verbindung an.

Löst aus
DeviceNotAvailableException

connectToWifiNetworkIfNeededWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk)

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

Gibt Folgendes zurück:
IWifiHelper.WifiConnectionResult WifiConnectionResult gibt den Status der Verbindung an.

Löst aus
DeviceNotAvailableException

connectToWifiNetworkWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Verbindung zu einem WLAN herstellen

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

Parameter
wifiSsid String: Die WLAN-SSID, mit der eine Verbindung hergestellt werden soll

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

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

Gibt Folgendes zurück:
IWifiHelper.WifiConnectionResult WifiConnectionResult gibt den Status der Verbindung an.

Löst aus
DeviceNotAvailableException

connectToWifiNetworkWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk)

Verbindung zu einem WLAN herstellen

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

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

Gibt Folgendes zurück:
IWifiHelper.WifiConnectionResult WifiConnectionResult gibt den Status der Verbindung an.

Löst aus
DeviceNotAvailableException

connectToWifiNetworkWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

Verbindung zu einem WLAN herstellen

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

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

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

Gibt Folgendes zurück:
IWifiHelper.WifiConnectionResult WifiConnectionResult gibt den Status der Verbindung an.

Löst aus
DeviceNotAvailableException

connectToWifiNetworkWithResult

public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk)

Verbindung zu einem WLAN herstellen

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

Parameter
wifiSsid String: Die WLAN-SSID, mit der eine Verbindung hergestellt werden soll

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

Gibt Folgendes zurück:
IWifiHelper.WifiConnectionResult WifiConnectionResult gibt den Status der Verbindung an.

Löst aus
DeviceNotAvailableException

createUser

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

Einen Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

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

guest boolean: Aktivieren Sie das Nutzer-Flag „--guest“ während der Erstellung.

ephemeral boolean: Aktivieren Sie das Nutzer-Flag „--ephemeral“ bei der Erstellung.

Gibt Folgendes zurück:
int ID des erstellten Nutzers

Löst aus
DeviceNotAvailableException
IllegalStateException

createUser

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

Einen Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

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

guest boolean: Aktivieren Sie das Nutzer-Flag „--guest“ während der Erstellung.

ephemeral boolean: Aktivieren Sie das Nutzer-Flag „--ephemeral“ bei der Erstellung.

forTesting boolean: Aktivieren Sie beim Erstellen das Testflag „--for-testing“.

Gibt Folgendes zurück:
int ID des erstellten Nutzers

Löst aus
DeviceNotAvailableException
IllegalStateException

createUser

public int createUser (String name)

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

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

Gibt Folgendes zurück:
int Die Ganzzahl für die erstellte Nutzer-ID.

Löst aus
DeviceNotAvailableException
IllegalStateException

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

Gibt Folgendes zurück:
int Die Ganzzahl für die erstellte Nutzer-ID oder -1 bei einem Fehler.

Löst aus
DeviceNotAvailableException

debugDeviceNotAvailable

public DeviceInspectionResult debugDeviceNotAvailable ()

Ein Gerät prüfen und detaillierte Informationen zurückgeben, wenn ein Gerät nicht mehr verfügbar ist.

Gibt Folgendes zurück:
DeviceInspectionResult

deleteFile

public void deleteFile (String deviceFilePath, 
                int userId)

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

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

userId int: Die Nutzer-ID, die gelöscht werden soll

Löst aus
DeviceNotAvailableException

deleteFile

public void deleteFile (String deviceFilePath)

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

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

Löst aus
DeviceNotAvailableException

deregisterDeviceActionReceiver

public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Entfernt die registrierte IDeviceActionReceiver.

Parameter
deviceActionReceiver IDeviceActionReceiver: Ein IDeviceActionReceiver, das entfernt wird.

deviceSoftRestarted

public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)

Hilfsmethode zum Prüfen, ob das Gerät durch Vergleich des aktuellen system_server mit dem vorherigen system_server ProcessInfo neu gestartet wurde. Verwende getProcessByName(String) als Zahlungsmethode, um ProcessInfo zu erhalten.

Parameter
prevSystemServerProcess ProcessInfo: Der vorherige system_server-Prozess ProcessInfo.

Gibt Folgendes zurück:
boolean true, wenn das Gerät per Software neu gestartet wurde

Löst aus
DeviceNotAvailableException

deviceSoftRestartedSince

public boolean deviceSoftRestartedSince (long utcEpochTime, 
                TimeUnit timeUnit)

Hilfsmethode, um zu prüfen, ob das Gerät seit der UTC-Zeit seit der Epoche vom Gerät und seinem TimeUnit neu gestartet wurde. Ein Soft-Restart bezieht sich auf einen Neustart von system_server außerhalb eines Hard-Reboot des Geräts (z. B. ein angeforderter Neustart). Die aktuelle utcEpochTime des Geräts in Millisekunden kann mit der Methode getDeviceDate() abgerufen werden.

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

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

Gibt Folgendes zurück:
boolean true, wenn das Gerät per Software neu gestartet wurde

Löst aus
DeviceNotAvailableException

disableAdbRoot

public boolean disableAdbRoot ()

Deaktiviert den ADB-Root-Zugriff.

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

Gibt Folgendes zurück:
boolean true, falls erfolgreich.

Löst aus
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

Es wird versucht, die Keyguard-Funktion zu deaktivieren.

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

Löst aus
DeviceNotAvailableException

disableNetworkMonitor

public boolean disableNetworkMonitor ()

Deaktiviert die Netzwerküberwachung auf dem Gerät.

Gibt Folgendes zurück:
boolean true, wenn das Monitoring erfolgreich deaktiviert wurde. false, wenn der Vorgang fehlgeschlagen ist.

Löst aus
DeviceNotAvailableException

disconnectFromWifi

public boolean disconnectFromWifi ()

Die Verbindung zu einem WLAN wird getrennt.

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

Gibt Folgendes zurück:
boolean true, wenn die Verbindung zum WLAN getrennt wurde. false wenn das Trennen der Verbindung fehlgeschlagen ist.

Löst aus
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

Gibt Folgendes zurück:
boolean true, wenn die Datei vorhanden ist, andernfalls false.

Löst aus
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

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

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

Gibt Folgendes zurück:
boolean true, wenn die Datei vorhanden ist, andernfalls false.

Löst aus
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

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

Parameter
process String: Der Name des Geräteprozesses, für den „dumpheap“ ausgeführt werden soll.

devicePath String: Der Pfad auf dem Gerät, unter dem der Dump abgelegt werden soll. Das muss ein Ort sein, an dem dies aufgrund der Berechtigungen zulässig ist.

Gibt Folgendes zurück:
File File, der den Bericht enthält. „Null“, wenn ein Fehler aufgetreten ist.

Löst aus
DeviceNotAvailableException

enableAdbRoot

public boolean enableAdbRoot ()

Aktiviert „adb root“. Wenn die Einstellung „enable-root“ auf „false“ gesetzt ist, wird eine Meldung protokolliert und die Funktion wird beendet, ohne Root zu aktivieren.

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

Gibt Folgendes zurück:
boolean true, falls erfolgreich.

Löst aus
DeviceNotAvailableException

enableNetworkMonitor

public boolean enableNetworkMonitor ()

Aktiviert die Netzwerküberwachung auf dem Gerät.

Gibt Folgendes zurück:
boolean true, wenn das Monitoring erfolgreich aktiviert wurde. false, wenn der Vorgang fehlgeschlagen ist.

Löst aus
DeviceNotAvailableException

executeAdbCommand

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

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

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

Parameter
timeout long: Die Zeit in Millisekunden, nach der das Gerät als nicht reagierend gilt. 0L für kein Zeitlimit.

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

Gibt Folgendes zurück:
String die Standardausgabe des Befehls. null, wenn der Befehl nicht ausgeführt werden konnte.

Löst aus
DeviceNotAvailableException

executeAdbCommand

public String executeAdbCommand (String... cmdArgs)

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

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

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

Gibt Folgendes zurück:
String die Standardausgabe des Befehls. null, wenn der Befehl nicht ausgeführt werden konnte.

Löst aus
DeviceNotAvailableException

executeAdbCommand

public String executeAdbCommand (long timeout, 
                Map<String, String> envMap, 
                String... cmdArgs)

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

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

Parameter
timeout long: Die Zeit in Millisekunden, nach der das Gerät als nicht reagierend gilt. 0L für kein Zeitlimit.

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

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

Gibt Folgendes zurück:
String die Standardausgabe des Befehls. null, wenn der Befehl nicht ausgeführt werden konnte.

Löst aus
DeviceNotAvailableException

executeAdbV2Command

public CommandResult executeAdbV2Command (String... cmdArgs)

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

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

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

Gibt Folgendes zurück:
CommandResult Das CommandResult mit der Ausgabe des Befehls.

Löst aus
DeviceNotAvailableException

executeAdbV2Command

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

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

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

Parameter
timeout long: Die Zeit in Millisekunden, nach der das Gerät als nicht reagierend gilt. 0L für kein Zeitlimit.

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

Gibt Folgendes zurück:
CommandResult Das CommandResult mit der Ausgabe des Befehls.

Löst aus
DeviceNotAvailableException

executeAdbV2Command

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

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

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

Parameter
timeout long: Die Zeit in Millisekunden, nach der das Gerät als nicht reagierend gilt. 0L für kein Zeitlimit.

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

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

Gibt Folgendes zurück:
CommandResult Das CommandResult mit der Ausgabe des Befehls.

Löst aus
DeviceNotAvailableException

executeAdbV2Command

public CommandResult executeAdbV2Command (long timeout, 
                Map<String, String> envMap, 
                int retryAttempts, 
                String... cmdArgs)

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

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

Parameter
timeout long: Die Zeit in Millisekunden, nach der das Gerät als nicht reagierend gilt. 0L für kein Zeitlimit.

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

retryAttempts int: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn retryAttempts nicht erfolgreich ausgeführt werden.

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

Gibt Folgendes zurück:
CommandResult Das CommandResult mit der Ausgabe des Befehls.

Löst aus
DeviceNotAvailableException

executeFastbootCommand

public CommandResult executeFastbootCommand (String... cmdArgs)

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

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

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

Gibt Folgendes zurück:
CommandResult das CommandResult mit der Ausgabe des Befehls

Löst aus
DeviceNotAvailableException
UnsupportedOperationException

executeFastbootCommand

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

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

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

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

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

Gibt Folgendes zurück:
CommandResult das CommandResult mit der Ausgabe des Befehls

Löst aus
DeviceNotAvailableException
UnsupportedOperationException

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (String... cmdArgs)

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

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

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

Gibt Folgendes zurück:
CommandResult das CommandResult mit der Ausgabe des Befehls

Löst aus
DeviceNotAvailableException
UnsupportedOperationException

executeLongFastbootCommand

public CommandResult executeLongFastbootCommand (Map<String, String> envVarMap, 
                String... cmdArgs)

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

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

Parameter
envVarMap Map: Die Systemumgebungsvariablen, mit denen der Fastboot-Befehl ausgeführt wird.

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

Gibt Folgendes zurück:
CommandResult das CommandResult mit der Ausgabe des Befehls

Löst aus
DeviceNotAvailableException
UnsupportedOperationException

executeShellCommand

public String executeShellCommand (String command)

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

Parameter
command String: Der auszuführende ADB-Shell-Befehl.

Gibt Folgendes zurück:
String die Shell-Ausgabe

Löst aus
DeviceNotAvailableException

executeShellCommand

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

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

Parameter
command String: Der auszuführende ADB-Shell-Befehl.

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

maxTimeToOutputShellResponse long: Die maximale Zeit, in der der Befehl keine Antwort ausgeben darf. Die Einheit wird in timeUnit angegeben.

timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse

retryAttempts int: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn retryAttempts nicht erfolgreich ausgeführt werden.

Löst aus
DeviceNotAvailableException

executeShellCommand

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

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

Parameter
command String: Der auszuführende ADB-Shell-Befehl.

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

maxTimeoutForCommand long: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in timeUnit angegeben.

maxTimeToOutputShellResponse long: Die maximale Zeit, in der der Befehl keine Antwort ausgeben darf. Die Einheit wird in timeUnit angegeben.

timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse

retryAttempts int: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn retryAttempts nicht erfolgreich ausgeführt werden.

Löst aus
DeviceNotAvailableException

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

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

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

Parameter
command String: Der auszuführende ADB-Shell-Befehl.

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

Löst aus
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd)

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

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

Gibt Folgendes zurück:
CommandResult Das Ergebnis in CommandResult.

Löst aus
DeviceNotAvailableException

executeShellV2Command

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

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

Parameter
cmd String: Der auszuführende ADB-Shell-Befehl.

pipeAsInput File: Eine File, die als Eingabe an den Befehl weitergeleitet wird, oder „null“.

pipeToOutput OutputStream: OutputStream, in die die Standardausgabe umgeleitet wird, oder „null“.

maxTimeoutForCommand long: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in timeUnit angegeben.

timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse

retryAttempts int: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn retryAttempts nicht erfolgreich ausgeführt werden.

Gibt Folgendes zurück:
CommandResult

Löst aus
DeviceNotAvailableException

executeShellV2Command

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

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

Parameter
cmd String: Der auszuführende ADB-Shell-Befehl.

maxTimeoutForCommand long: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in timeUnit angegeben.

timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse

Gibt Folgendes zurück:
CommandResult

Löst aus
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                File pipeAsInput)

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

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

pipeAsInput File: Ein File, das als Eingabe an den Befehl weitergeleitet wird, oder „null“.

Gibt Folgendes zurück:
CommandResult Das Ergebnis in CommandResult.

Löst aus
DeviceNotAvailableException

executeShellV2Command

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

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

Parameter
cmd String: Der auszuführende ADB-Shell-Befehl.

maxTimeoutForCommand long: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in timeUnit angegeben.

timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse

retryAttempts int: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn retryAttempts nicht erfolgreich ausgeführt werden.

Gibt Folgendes zurück:
CommandResult

Löst aus
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                OutputStream pipeToOutput)

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

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

pipeToOutput OutputStream: OutputStream, in die die Standardausgabe umgeleitet wird, oder „null“.

Gibt Folgendes zurück:
CommandResult Das Ergebnis in CommandResult.

Löst aus
DeviceNotAvailableException

executeShellV2Command

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

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

Parameter
cmd String: Der auszuführende ADB-Shell-Befehl.

pipeAsInput File: Ein File, das als Eingabe an den Befehl weitergeleitet wird, oder „null“.

pipeToOutput OutputStream: OutputStream, in die die Standardausgabe umgeleitet wird, oder „null“.

pipeToError OutputStream: OutputStream, wohin der Standardfehler weitergeleitet wird, oder „null“.

maxTimeoutForCommand long: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in timeUnit angegeben.

timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse

retryAttempts int: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn retryAttempts nicht erfolgreich ausgeführt werden.

Gibt Folgendes zurück:
CommandResult

Löst aus
DeviceNotAvailableException

executeShellV2Command

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

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

Parameter
cmd String: Der auszuführende ADB-Shell-Befehl.

pipeAsInput File: Ein File, das als Eingabe an den Befehl weitergeleitet wird, oder „null“.

pipeToOutput OutputStream: OutputStream, in die die Standardausgabe umgeleitet wird, oder „null“.

pipeToError OutputStream: OutputStream, wohin der Standardfehler weitergeleitet wird, oder „null“.

maxTimeoutForCommand long: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in timeUnit angegeben.

maxTimeToOutputShellResponse long: Die maximale Zeit, in der der Befehl keine Antwort ausgeben darf. Die Einheit wird in timeUnit angegeben.

timeUnit TimeUnit: Einheit für maxTimeToOutputShellResponse

retryAttempts int: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn retryAttempts nicht erfolgreich ausgeführt werden.

Gibt Folgendes zurück:
CommandResult

Löst aus
DeviceNotAvailableException

executeShellV2Command

public CommandResult executeShellV2Command (String cmd, 
                IShellOutputReceiver receiver)

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

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

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

Gibt Folgendes zurück:
CommandResult Das Ergebnis in CommandResult.

Löst aus
DeviceNotAvailableException

fastbootOemRamdumpNow

public CommandResult fastbootOemRamdumpNow ()

Hilfsmethode, die einen RAM-Dump über den Fastboot-Modus auslöst.

Bei dieser Methode wird der Befehl „oem ramdump now“ ausgeführt. Im Gegensatz zu ERROR(/#executeFastbootCommand()) werden keine Wiederholungen oder Geräte-Recovery-Versuche unternommen, wenn der Befehl fehlschlägt oder der Status ungültig ist, da ein Geräteabsturz das beabsichtigte Ergebnis ist. Sollte verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus befindet.

Gibt Folgendes zurück:
CommandResult das CommandResult mit der Ausgabe des Befehls

fastbootWipePartition

public CommandResult fastbootWipePartition (String partition)

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

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

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

Parameter
partition String: die zu löschende Partition

Gibt Folgendes zurück:
CommandResult das CommandResult mit der Ausgabe des Befehls

Löst aus
DeviceNotAvailableException

getActiveApexes

public Set<ITestDevice.ApexInfo> getActiveApexes ()

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

Gibt Folgendes zurück:
Set<ITestDevice.ApexInfo> Set von ApexInfo ist derzeit auf dem Gerät aktiviert

Löst aus
DeviceNotAvailableException

getAdbPath

public String getAdbPath ()

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

Gibt Folgendes zurück:
String

getAllSettings

public Map<String, String> getAllSettings (String namespace)

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

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

Gibt Folgendes zurück:
Map<String, String> Die Zuordnung von Schlüssel/Wert-Paaren. „Null“, wenn der Namespace nicht unterstützt wird.

Löst aus
DeviceNotAvailableException

getAllocationState

public DeviceAllocationState getAllocationState ()

Gibt den aktuellen Zuweisungsstatus des Geräts zurück

Gibt Folgendes zurück:
DeviceAllocationState

getAndroidId

public String getAndroidId (int userId)

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

Parameter
userId int

Gibt Folgendes zurück:
String

Löst aus
DeviceNotAvailableException

getAndroidIds

public Map<Integer, String> getAndroidIds ()

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

Gibt Folgendes zurück:
Map<Integer, String> Zuordnung von Android-IDs, die mit Nutzer-IDs übereinstimmen.

Löst aus
DeviceNotAvailableException

getApiLevel

public int getApiLevel ()

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

Gibt Folgendes zurück:
int Eine Ganzzahl, die das API-Level des Geräts angibt

Löst aus
DeviceNotAvailableException

getApiLevelFull

public int getApiLevelFull ()

Ähnlich wie getApiLevel(), gibt aber die vollständige Version zurück.

Gibt Folgendes zurück:
int Eine Ganzzahl, die das vollständige API-Level des Geräts angibt.

Löst aus
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

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

Parameter
packageName String

Gibt Folgendes zurück:
PackageInfo PackageInfo oder null, wenn Informationen nicht abgerufen werden konnten

Löst aus
DeviceNotAvailableException

getAppPackageInfos

public List<PackageInfo> getAppPackageInfos ()

Informationen zu auf dem Gerät installierten Paketen abrufen.

Gibt Folgendes zurück:
List<PackageInfo> List von PackageInfo, die auf dem Gerät installiert sind.

Löst aus
DeviceNotAvailableException

getBasebandVersion

public String getBasebandVersion ()

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

Gibt Folgendes zurück:
String die String-Baseband-Version oder null, wenn sie nicht ermittelt werden kann (Gerät hat kein Funkmodul oder der Versionsstring kann nicht gelesen werden)

Löst aus
DeviceNotAvailableException

getBattery

public Integer getBattery ()

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

Gibt Folgendes zurück:
Integer

getBooleanProperty

public boolean getBooleanProperty (String name, 
                boolean defaultValue)

Gibt den booleschen Wert der angegebenen Property zurück.

Parameter
name String: der Property-Name

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

Gibt Folgendes zurück:
boolean true, wenn die Property den Wert "1", "y", "yes", "on" oder "true" hat, false, wenn die Property den Wert "0", "n", "no", "off", "false" oder defaultValue hat, andernfalls.

Löst aus
DeviceNotAvailableException

getBootHistory

public Map<Long, String> getBootHistory ()

Die Hilfsmethode erfasst die Bootverlaufskarte mit Bootzeit und Bootgrund.

Gibt Folgendes zurück:
Map<Long, String> Zuordnung von Startzeit (UTC-Zeit in Sekunden seit der Epoche) und Startgrund

Löst aus
DeviceNotAvailableException

getBootHistorySince

public Map<Long, String> getBootHistorySince (long utcEpochTime, 
                TimeUnit timeUnit)

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

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

timeUnit TimeUnit: die Zeiteinheit TimeUnit.

Gibt Folgendes zurück:
Map<Long, String> Zuordnung von Startzeit (UTC-Zeit in Sekunden seit der Epoche) und Startgrund

Löst aus
DeviceNotAvailableException

getBootloaderVersion

public String getBootloaderVersion ()

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

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

Gibt Folgendes zurück:
String die String-Bootloader-Version oder null, wenn sie nicht gefunden werden kann

Löst aus
DeviceNotAvailableException
UnsupportedOperationException

getBugreport

public InputStreamSource getBugreport ()

Ruft einen Fehlerbericht vom Gerät ab.

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

Gibt Folgendes zurück:
InputStreamSource Ein InputStreamSource, das die Inhalte des Fehlerberichts auf Anfrage generiert. Im Fehlerfall gibt InputStreamSource eine leere InputStream zurück.

getBugreportz

public InputStreamSource getBugreportz ()

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

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

Gibt Folgendes zurück:
InputStreamSource InputStreamSource der ZIP-Datei mit den Bugreportz. Bei einem Fehler wird „null“ zurückgegeben.

getBuildAlias

public String getBuildAlias ()

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

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

Gibt Folgendes zurück:
String Der Build-Alias oder die Build-ID, falls der Alias nicht abgerufen werden konnte

Löst aus
DeviceNotAvailableException

getBuildFlavor

public String getBuildFlavor ()

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

Gibt Folgendes zurück:
String die Build-Variante oder „null“, wenn sie nicht abgerufen werden konnte

Löst aus
DeviceNotAvailableException

getBuildId

public String getBuildId ()

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

Gibt Folgendes zurück:
String Die Build-ID oder IBuildInfo.UNKNOWN_BUILD_ID, wenn sie nicht abgerufen werden konnte

Löst aus
DeviceNotAvailableException

getBuildSigningKeys

public String getBuildSigningKeys ()

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

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

Gibt Folgendes zurück:
String Der Signaturschlüssel, falls gefunden, andernfalls „null“.

Löst aus
DeviceNotAvailableException

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor ()

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

Gibt Folgendes zurück:
DeviceDescriptor

getCachedDeviceDescriptor

public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)

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

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

Gibt Folgendes zurück:
DeviceDescriptor

getChildren

public String[] getChildren (String path)

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

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

Gibt Folgendes zurück:
String[] Array mit Strings, das alle Dateien in einem Pfad auf dem Gerät enthält.

Löst aus
DeviceNotAvailableException

getConnection

public AbstractConnection getConnection ()

Die aktuelle Verbindung des Geräts.

Gibt Folgendes zurück:
AbstractConnection

getContentProvider

public ContentProviderHandler getContentProvider (int userId)

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

Der Content-Anbieter kann wiederverwendet werden, wenn er zuvor mit demselben userId erstellt wurde.

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

Gibt Folgendes zurück:
ContentProviderHandler

Löst aus
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

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

Gibt Folgendes zurück:
DeviceFoldableState

Löst aus
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

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

Gibt Folgendes zurück:
int

Löst aus
DeviceNotAvailableException

getDeviceClass

public String getDeviceClass ()

Geräteklasse abrufen

Gibt Folgendes zurück:
String die Geräteklasse String.

getDeviceDate

public long getDeviceDate ()

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

Gibt Folgendes zurück:
long Das Datum des Geräts im Epoch-Format.

Löst aus
DeviceNotAvailableException

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor ()

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

Gibt Folgendes zurück:
DeviceDescriptor

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)

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

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

Gibt Folgendes zurück:
DeviceDescriptor

getDeviceState

public TestDeviceState getDeviceState ()

Gerätestatus abrufen

Gibt Folgendes zurück:
TestDeviceState

getDeviceTimeOffset

public long getDeviceTimeOffset (Date date)

Helper zum Abrufen der Zeitdifferenz zwischen dem Gerät und einem bestimmten Date. Verwenden Sie intern die Epoch-Zeit.

Parameter
date Date

Gibt Folgendes zurück:
long die Differenz in Millisekunden

Löst aus
DeviceNotAvailableException

getEmulatorOutput

public InputStreamSource getEmulatorOutput ()

Stream von Emulator-stdout und -stderr abrufen

Gibt Folgendes zurück:
InputStreamSource Emulatorausgabe

getEmulatorProcess

public Process getEmulatorProcess ()

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

Gibt Folgendes zurück:
Process Process oder null

getExecuteShellCommandLog

public final File getExecuteShellCommandLog ()

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

Gibt Folgendes zurück:
File

getExternalStoreFreeSpace

public long getExternalStoreFreeSpace ()

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

Gibt Folgendes zurück:
long die Menge an freiem Speicherplatz in KB

Löst aus
DeviceNotAvailableException

getFastbootPath

public String getFastbootPath ()

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

Gibt Folgendes zurück:
String

getFastbootProductType

public String getFastbootProductType ()

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

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

Gibt Folgendes zurück:
String den Namen des Produkttyps String oder null, wenn er nicht ermittelt werden kann

Löst aus
DeviceNotAvailableException
UnsupportedOperationException

getFastbootProductVariant

public String getFastbootProductVariant ()

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

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

Gibt Folgendes zurück:
String den Namen des Produkttyps String oder null, wenn er nicht ermittelt werden kann

Löst aus
DeviceNotAvailableException
UnsupportedOperationException

getFastbootSerialNumber

public String getFastbootSerialNumber ()

Gibt die Seriennummer im Fastboot-Modus zurück.

Gibt Folgendes zurück:
String

getFastbootVariable

public String getFastbootVariable (String variableName)

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

Parameter
variableName String: der Variablenname

Gibt Folgendes zurück:
String Der Attributwert oder null, falls er nicht vorhanden ist.

Löst aus
DeviceNotAvailableException
UnsupportedOperationException

getFastbootVersion

public String getFastbootVersion ()

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

Gibt Folgendes zurück:
String

getFileEntry

public IFileEntry getFileEntry (String path)

Eine Referenz auf eine Remotedatei auf dem Gerät abrufen

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

Gibt Folgendes zurück:
IFileEntry die IFileEntry oder null, wenn die Datei unter der angegebenen path nicht gefunden werden kann

Löst aus
DeviceNotAvailableException

getFileEntry

public IFileEntry getFileEntry (FileListingService.FileEntry entry)

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

Parameter
entry FileListingService.FileEntry: Ein FileEntry, das nicht unbedingt das Root-Verzeichnis sein muss, wie es für Ddmlib erforderlich ist.

Gibt Folgendes zurück:
IFileEntry Ein FileEntryWrapper, der den FileEntry darstellt.

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public Set<DeviceFoldableState> getFoldableStates ()

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

Gibt Folgendes zurück:
Set<DeviceFoldableState>

Löst aus
DeviceNotAvailableException

getIDevice

public IDevice getIDevice ()

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

Jedes Mal, wenn die Verbindung des Geräts zu ADB getrennt und wiederhergestellt wird, kann von DDMS ein neuer IDevice zugewiesen werden. Aufrufer sollten daher keinen Verweis auf IDevice beibehalten, da dieser Verweis möglicherweise veraltet ist.

Gibt Folgendes zurück:
IDevice die IDevice

getInstalledPackageNames

public Set<String> getInstalledPackageNames ()

Die Paketnamen der auf dem Gerät vorhandenen Anwendungen abrufen.

Gibt Folgendes zurück:
Set<String> Set von String Paketnamen, die derzeit auf dem Gerät installiert sind.

Löst aus
DeviceNotAvailableException

getIntProperty

public long getIntProperty (String name, 
                long defaultValue)

Gibt den Ganzzahlwert der angegebenen Eigenschaft des Geräts zurück.

Parameter
name String: der Property-Name

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

Gibt Folgendes zurück:
long den Eigenschaftswert oder defaultValue, wenn die Eigenschaft leer ist, nicht vorhanden ist oder keinen Ganzzahlwert hat.

Löst aus
DeviceNotAvailableException

getIpAddress

public String getIpAddress ()

Ruft die IP-Adresse des Geräts ab.

Gibt Folgendes zurück:
String Die IP-Adresse des Geräts oder null, wenn das Gerät keine IP-Adresse hat

Löst aus
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

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

Gibt Folgendes zurück:
KeyguardControllerState ein KeyguardControllerState mit einem Snapshot des Status des Keyguard zurückgibt und Null zurückgibt, wenn die Keyguard-Abfrage nicht unterstützt wird.

Löst aus
DeviceNotAvailableException

getLastExpectedRebootTimeMillis

public long getLastExpectedRebootTimeMillis ()

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

Gibt Folgendes zurück:
long

getLaunchApiLevel

public int getLaunchApiLevel ()

Ruft das API-Level des Geräts bei der ersten Markteinführung ab. Die Standardeinstellung ist UNKNOWN_API_LEVEL.

Gibt Folgendes zurück:
int Eine Ganzzahl, die das erste gestartete API-Level des Geräts angibt

Löst aus
DeviceNotAvailableException

getLogcat

public InputStreamSource getLogcat ()

Erstellt einen Snapshot-Stream der logcat-Daten.

Funktioniert in zwei Modi:

  • Wenn der Logcat-Vorgang gerade im Hintergrund ausgeführt wird, werden bis zu TestDeviceOptions.getMaxLogcatDataSize() Byte des aktuellen Inhalts des im Hintergrund ausgeführten Logcat-Vorgangs zurückgegeben.
  • Andernfalls wird ein statischer Dump der Logcat-Daten zurückgegeben, wenn das Gerät gerade reagiert.

    Gibt Folgendes zurück:
    InputStreamSource

  • getLogcat

    public InputStreamSource getLogcat (int maxBytes)

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

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

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

    Gibt Folgendes zurück:
    InputStreamSource

    getLogcatDump

    public InputStreamSource getLogcatDump ()

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

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

    Gibt Folgendes zurück:
    InputStreamSource InputStreamSource der Logcat-Daten. Wenn Logcat-Daten nicht erfasst werden können, wird ein leerer Stream zurückgegeben.

    getLogcatSince

    public InputStreamSource getLogcatSince (long date)

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

    Parameter
    date long: Im Format „Millisekunden seit Epoche“ für den Zeitraum, für den der Snapshot erstellt werden soll. (kann mit „date +%s“ abgerufen werden)

    Gibt Folgendes zurück:
    InputStreamSource

    getMacAddress

    public String getMacAddress ()

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

    Gibt Folgendes zurück:
    String

    getMainUserId

    public Integer getMainUserId ()

    Gibt die Hauptnutzer-ID zurück.

    Gibt Folgendes zurück:
    Integer Die userId des Hauptnutzers, falls vorhanden, andernfalls null.

    Löst aus
    DeviceNotAvailableException

    getMainlineModuleInfo

    public Set<String> getMainlineModuleInfo ()

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

    Gibt Folgendes zurück:
    Set<String> Set der String-Mainline-Module, die derzeit auf dem Gerät installiert sind.

    Löst aus
    DeviceNotAvailableException

    getMaxNumberOfRunningUsersSupported

    public int getMaxNumberOfRunningUsersSupported ()

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

    Gibt Folgendes zurück:
    int Eine Ganzzahl, die die Anzahl der gleichzeitig ausgeführten Nutzer angibt.

    Löst aus
    DeviceNotAvailableException

    getMaxNumberOfUsersSupported

    public int getMaxNumberOfUsersSupported (String userType)

    Ruft die maximale Anzahl der unterstützten Nutzer des angegebenen Nutzertyps ab. Die Standardeinstellung ist 0.

    Parameter
    userType String: Der Nutzertyp, wie in UserManager definiert, z. B. „android.os.usertype.full.SECONDARY“.

    Gibt Folgendes zurück:
    int Eine Ganzzahl, die die Anzahl der unterstützten Nutzer des angegebenen Nutzertyps angibt.

    Löst aus
    DeviceNotAvailableException

    getMaxNumberOfUsersSupported

    public int getMaxNumberOfUsersSupported ()

    Ruft die maximale Anzahl der unterstützten wechselbaren Nutzer ab, ohne Gäste. Ab API-Version 36 sind nicht wechselbare Nutzer (z. B. Profile) nicht mehr enthalten. Die Standardeinstellung ist 0.

    Gibt Folgendes zurück:
    int Eine Ganzzahl, die die Anzahl der unterstützten umschaltbaren Nutzer angibt

    Löst aus
    DeviceNotAvailableException

    getMicrodroidProcess

    public Process getMicrodroidProcess ()

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

    getMonitor

    public IDeviceStateMonitor getMonitor ()

    Gibt die mit dem Gerät verknüpfte IDeviceStateMonitor zurück.

    Gibt Folgendes zurück:
    IDeviceStateMonitor

    getMountPoint

    public String getMountPoint (String mountName)

    Gibt einen Bereitstellungspunkt zurück.

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

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

    Parameter
    mountName String: der Name des Bereitstellungspunkts

    Gibt Folgendes zurück:
    String den Bereitstellungspunkt oder null

    getMountPointInfo

    public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)

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

    Parameter
    mountpoint String

    Gibt Folgendes zurück:
    ITestDevice.MountPointInfo Ein List von MountPointInfo mit den Informationen in „/proc/mounts“

    Löst aus
    DeviceNotAvailableException

    getMountPointInfo

    public List<ITestDevice.MountPointInfo> getMountPointInfo ()

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

    Gibt Folgendes zurück:
    List<ITestDevice.MountPointInfo> Ein List von MountPointInfo mit den Informationen in „/proc/mounts“

    Löst aus
    DeviceNotAvailableException

    getOptions

    public TestDeviceOptions getOptions ()

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

    Gibt Folgendes zurück:
    TestDeviceOptions TestDeviceOptions im Zusammenhang mit dem zu testenden Gerät.

    getPartitionFreeSpace

    public long getPartitionFreeSpace (String partition)

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

    Parameter
    partition String

    Gibt Folgendes zurück:
    long die Menge an freiem Speicherplatz in KB

    Löst aus
    DeviceNotAvailableException

    getPrimaryUserId

    public Integer getPrimaryUserId ()

    Gibt die Hauptnutzer-ID zurück.

    Gibt Folgendes zurück:
    Integer Die userId des Hauptnutzers, falls vorhanden, andernfalls „null“.

    Löst aus
    DeviceNotAvailableException

    getProcessByName

    public ProcessInfo getProcessByName (String processName)

    Die Hilfsmethode führt die Befehle „pidof“ und „stat“ aus und gibt das ProcessInfo-Objekt mit der PID und der Startzeit des angegebenen Prozesses zurück.

    Parameter
    processName String: Der Prozessname als String.

    Gibt Folgendes zurück:
    ProcessInfo ProcessInfo des angegebenen processName

    Löst aus
    DeviceNotAvailableException

    getProcessPid

    public String getProcessPid (String process)

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

    Parameter
    process String: Der Prozessname als String.

    Gibt Folgendes zurück:
    String

    Löst aus
    DeviceNotAvailableException

    getProductType

    public String getProductType ()

    Bequeme Methode zum Abrufen des Produkttyps dieses Geräts.

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

    Gibt Folgendes zurück:
    String Der Name des String-Produkttyps. Darf nicht null sein

    Löst aus
    DeviceNotAvailableException

    getProductVariant

    public String getProductVariant ()

    Bequeme Methode zum Abrufen der Produktvariante dieses Geräts.

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

    Gibt Folgendes zurück:
    String den Namen der Produktvariante String oder null, wenn er nicht ermittelt werden kann

    Löst aus
    DeviceNotAvailableException

    getProperty

    public String getProperty (String name)

    Ruft den angegebenen Attributwert vom Gerät ab.

    Parameter
    name String: der Property-Name

    Gibt Folgendes zurück:
    String Der Attributwert oder null, falls er nicht vorhanden ist.

    Löst aus
    DeviceNotAvailableException

    getRecoveryMode

    public ITestDevice.RecoveryMode getRecoveryMode ()

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

    Gibt Folgendes zurück:
    ITestDevice.RecoveryMode Der aktuelle Wiederherstellungsmodus, der für das Gerät verwendet wird.

    getRemainingCreatableUserCount

    public int getRemainingCreatableUserCount (String userType)

    Gibt zurück, wie viele Nutzer des angegebenen Nutzertyps auf diesem Gerät erstellt werden können.

    Parameter
    userType String: Der Nutzertyp, wie in UserManager definiert, z. B. „android.os.usertype.full.SECONDARY“.

    Gibt Folgendes zurück:
    int wie viele Nutzer des angegebenen Nutzertyps hinzugefügt werden können

    Löst aus
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (Long displayId, 
                    String format, 
                    boolean rescale)

    Erstellt einen Screenshot des Displays mit der angegebenen ID im unterstützten Format. Reskalierung zulassen, um kleinere Größen zu unterstützen

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

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

    rescale boolean: Gibt an, ob der Screenshot skaliert werden soll, um die Größe des resultierenden Bildes zu verringern.

    Gibt Folgendes zurück:
    InputStreamSource InputStreamSource des Screenshots im Format oder null, wenn der Screenshot nicht erfolgreich war.

    Löst aus
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format)

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

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

    Gibt Folgendes zurück:
    InputStreamSource InputStreamSource des Screenshots im Format oder null, wenn der Screenshot nicht erfolgreich war.

    Löst aus
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (long displayId)

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

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

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

    Gibt Folgendes zurück:
    InputStreamSource InputStreamSource des Screenshots im Format oder null, wenn der Screenshot nicht erfolgreich war.

    Löst aus
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot (String format, 
                    boolean rescale)

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

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

    rescale boolean: Gibt an, ob der Screenshot skaliert werden soll, um die Größe des resultierenden Bildes zu verringern.

    Gibt Folgendes zurück:
    InputStreamSource InputStreamSource des Screenshots im Format oder null, wenn der Screenshot nicht erfolgreich war.

    Löst aus
    DeviceNotAvailableException

    getScreenshot

    public InputStreamSource getScreenshot ()

    Erstellt einen Screenshot vom Gerät.

    Gibt Folgendes zurück:
    InputStreamSource InputStreamSource des Screenshots im PNG-Format oder null, wenn der Screenshot nicht erfolgreich war.

    Löst aus
    DeviceNotAvailableException

    getSerialNumber

    public String getSerialNumber ()

    Bequeme Methode zum Abrufen der Seriennummer dieses Geräts.

    Gibt Folgendes zurück:
    String die Seriennummer String

    getSetting

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

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

    Parameter
    userId int

    namespace String

    key String

    Gibt Folgendes zurück:
    String Der Wert, der mit dem Namespace:Schlüssel eines Nutzers verknüpft ist. Null, wenn nicht gefunden.

    Löst aus
    DeviceNotAvailableException

    getSetting

    public String getSetting (String namespace, 
                    String key)

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

    Parameter
    namespace String

    key String

    Gibt Folgendes zurück:
    String

    Löst aus
    DeviceNotAvailableException

    getSimOperator

    public String getSimOperator ()

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

    Gibt Folgendes zurück:
    String

    getSimState

    public String getSimState ()

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

    Gibt Folgendes zurück:
    String

    getTombstones

    public List<File> getTombstones ()

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

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

    Gibt Folgendes zurück:
    List<File> Eine Liste von Tombstone-Dateien, leer, wenn kein Tombstone vorhanden ist.

    Löst aus
    DeviceNotAvailableException

    getTotalMemory

    public long getTotalMemory ()

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

    Gibt Folgendes zurück:
    long

    getTrackingSerial

    public String getTrackingSerial ()

    Rufen Sie die Seriennummer ab, die zum Verfolgen des Geräts verwendet wird.

    Gibt Folgendes zurück:
    String

    getUninstallablePackageNames

    public Set<String> getUninstallablePackageNames ()

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

    Gibt Folgendes zurück:
    Set<String> Set der nicht deinstallierbaren String-Paketnamen, die derzeit auf dem Gerät installiert sind.

    Löst aus
    DeviceNotAvailableException

    getUseFastbootErase

    public boolean getUseFastbootErase ()

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

    Gibt Folgendes zurück:
    boolean true, wenn „fastboot erase“ verwendet wird, oder false, wenn „fastboot format“ verwendet wird.

    getUserFlags

    public int getUserFlags (int userId)

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

    Parameter
    userId int

    Gibt Folgendes zurück:
    int Die mit der angegebenen userId verknüpften Flags, falls vorhanden, andernfalls -10000.

    Löst aus
    DeviceNotAvailableException

    getUserInfos

    public Map<Integer, UserInfo> getUserInfos ()

    Ruft die Zuordnung von useId zu UserInfo auf dem Gerät ab. Löst DeviceRuntimeException aus, wenn die Ausgabe des Geräts nicht wie erwartet ist.

    Gibt Folgendes zurück:
    Map<Integer, UserInfo> Die Liste der UserInfo-Objekte.

    Löst aus
    DeviceNotAvailableException

    getUserSerialNumber

    public int getUserSerialNumber (int userId)

    Gibt die dem userId zugeordnete Seriennummer zurück, falls gefunden, andernfalls -10000.

    Parameter
    userId int

    Gibt Folgendes zurück:
    int

    Löst aus
    DeviceNotAvailableException

    getUserVisibleOnDisplay

    public int getUserVisibleOnDisplay (int displayId)

    Ruft die Nutzer-ID des sichtbaren Nutzers auf dem angegebenen Display ab.

    Parameter
    displayId int: Die ID des Displays.

    Gibt Folgendes zurück:
    int Die Nutzer-ID des sichtbaren Nutzers auf dem angegebenen Display. Es wird nicht zwischen einem sichtbaren Hintergrundnutzer und dem aktuellen Vordergrundnutzer unterschieden, da beide Arten sichtbar sind. Um die beiden Ergebnisse zu unterscheiden, vergleichen Sie sie mit dem Ergebnis von getCurrentUser().

    Löst aus
    DeviceNotAvailableException

    handleAllocationEvent

    public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)

    Verarbeite das angegebene DeviceEvent. Gerät kann in einen neuen Status übergehen. Informiert die IDeviceMonitor über alle Zustandsübergänge.

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

    Parameter
    event DeviceEvent

    Gibt Folgendes zurück:
    IManagedTestDevice.DeviceEventResponse

    hasFeature

    public boolean hasFeature (String feature)

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

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

    Gibt Folgendes zurück:
    boolean „True“, wenn das Feature gefunden wird, andernfalls „false“.

    Löst aus
    DeviceNotAvailableException

    initializeConnection

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

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

    Parameter
    info IBuildInfo

    attributes MultiMap

    Löst aus
    DeviceNotAvailableException
    TargetSetupError

    installPackage

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

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

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

    Parameter
    packageFile File: die zu installierende APK-Datei

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

    grantPermissions boolean: Gibt an, ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen.

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

    Gibt Folgendes zurück:
    String String mit einem Fehlercode oder null bei Erfolg.

    Löst aus
    DeviceNotAvailableException

    installPackage

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

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

    Parameter
    packageFile File: die zu installierende APK-Datei

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

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

    Gibt Folgendes zurück:
    String String mit einem Fehlercode oder null bei Erfolg.

    Löst aus
    DeviceNotAvailableException

    installPackageForUser

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

    Installiert ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.

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

    Parameter
    packageFile File: die zu installierende APK-Datei

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

    grantPermissions boolean: Gibt an, ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen.

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

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

    Gibt Folgendes zurück:
    String String mit einem Fehlercode oder null bei Erfolg.

    Löst aus
    DeviceNotAvailableException

    installPackageForUser

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

    Installiert ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.

    Parameter
    packageFile File: die zu installierende APK-Datei

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

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

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

    Gibt Folgendes zurück:
    String String mit einem Fehlercode oder null bei Erfolg.

    Löst aus
    DeviceNotAvailableException

    installPackageWithIncrementalMode

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

    Installiert APKs im inkrementellen Modus.

    Parameter
    apkFiles File: die zu installierenden APK-Dateien.

    extraArgs String

    userId String

    Gibt Folgendes zurück:
    boolean

    Löst aus
    DeviceNotAvailableException

    invalidatePropertyCache

    public void invalidatePropertyCache ()

    isAdbRoot

    public boolean isAdbRoot ()

    Gibt Folgendes zurück:
    boolean

    Löst aus
    DeviceNotAvailableException

    isAdbTcp

    public boolean isAdbTcp ()

    Gibt Folgendes zurück:
    boolean

    isAppEnumerationSupported

    public boolean isAppEnumerationSupported ()

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

    Gibt Folgendes zurück:
    boolean „True“, wenn die App-Aufzählung unterstützt wird, andernfalls „false“

    Löst aus
    DeviceNotAvailableException

    isBypassLowTargetSdkBlockSupported

    public boolean isBypassLowTargetSdkBlockSupported ()

    Prüfen, ob die Plattform auf dem Gerät das Umgehen der Blockierung aufgrund des niedrigen Ziel-SDK bei der App-Installation unterstützt

    Gibt Folgendes zurück:
    boolean „True“, wenn das Umgehen des Blocks für niedrige Ziel-SDKs unterstützt wird, andernfalls „False“.

    Löst aus
    DeviceNotAvailableException

    isDebugfsMounted

    public boolean isDebugfsMounted ()

    Prüfen Sie, ob „debugfs“ gemountet ist.

    Gibt Folgendes zurück:
    boolean true, wenn debugfs bereitgestellt ist

    Löst aus
    DeviceNotAvailableException

    isDeviceEncrypted

    public boolean isDeviceEncrypted ()

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

    Gibt Folgendes zurück:
    boolean true, wenn das Gerät verschlüsselt ist.

    Löst aus
    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

    Gibt Folgendes zurück:
    boolean

    Löst aus
    DeviceNotAvailableException

    isEnableAdbRoot

    public boolean isEnableAdbRoot ()

    Gibt Folgendes zurück:
    boolean true, wenn „adb root“ auf dem Gerät aktiviert werden soll

    isEncryptionSupported

    public boolean isEncryptionSupported ()

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

    Gibt Folgendes zurück:
    boolean true, wenn das Gerät die Verschlüsselung unterstützt.

    Löst aus
    DeviceNotAvailableException

    isExecutable

    public boolean isExecutable (String fullPath)

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

    Parameter
    fullPath String

    Gibt Folgendes zurück:
    boolean

    Löst aus
    DeviceNotAvailableException

    isFastbootEnabled

    public boolean isFastbootEnabled ()

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

    Gibt Folgendes zurück:
    boolean

    isHeadless

    public boolean isHeadless ()

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

    Gibt Folgendes zurück:
    boolean

    Löst aus
    DeviceNotAvailableException

    isHeadlessSystemUserMode

    public boolean isHeadlessSystemUserMode ()

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

    Gibt Folgendes zurück:
    boolean

    Löst aus
    DeviceNotAvailableException

    isMainUserPermanentAdmin

    public boolean isMainUserPermanentAdmin ()

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

    Gibt Folgendes zurück:
    boolean

    Löst aus
    DeviceNotAvailableException

    isMultiUserSupported

    public boolean isMultiUserSupported ()

    Gibt zurück, ob dieses Gerät mehrere umschaltbare Nutzer mit eigenem Login und anpassbarem Bereich unterstützt.

    Auch wenn die Antwort „Falsch“ lautet, können mehrere Nutzer möglicherweise trotzdem möglich sein, sofern keine Anmelde-UI erforderlich ist. Profile werden beispielsweise möglicherweise weiterhin unterstützt, da sie keine Anmelde-UI erfordern.

    Außerdem wird „config_enableMultiUserUI“ geprüft. Auf Anfrage dürfen wir davon ausgehen, dass Geräte, für die dies zutrifft, so konfiguriert sind, dass sekundäre Nutzer über ADB hinzugefügt werden können.

    Gibt Folgendes zurück:
    boolean Gibt an, ob das Gerät mehrere umschaltbare Nutzer unterstützt.

    Löst aus
    DeviceNotAvailableException

    isPackageInstalled

    public boolean isPackageInstalled (String packageName, 
                    String userId)

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

    Parameter
    packageName String: Das Paket, für das wir prüfen, ob es installiert ist.

    userId String: Die Nutzer-ID, für die wir prüfen, ob das Paket installiert ist. Wenn „null“, wird der Hauptnutzer 0 verwendet.

    Gibt Folgendes zurück:
    boolean „True“, wenn das Paket als installiert gemeldet wird. Andernfalls „Falsch”.

    Löst aus
    DeviceNotAvailableException

    isPackageInstalled

    public boolean isPackageInstalled (String packageName)

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

    Parameter
    packageName String

    Gibt Folgendes zurück:
    boolean „True“, wenn das Paket als installiert gemeldet wird. Andernfalls „Falsch”.

    Löst aus
    DeviceNotAvailableException

    isRuntimePermissionSupported

    public boolean isRuntimePermissionSupported ()

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

    Gibt Folgendes zurück:
    boolean „True“, wenn Laufzeitberechtigungen unterstützt werden, andernfalls „false“.

    Löst aus
    DeviceNotAvailableException

    isShellV2Support

    public boolean isShellV2Support ()

    Gibt Folgendes zurück:
    boolean

    Löst aus
    DeviceNotAvailableException

    isStateBootloaderOrFastbootd

    public boolean isStateBootloaderOrFastbootd ()

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

    Gibt Folgendes zurück:
    boolean

    isUserRunning

    public boolean isUserRunning (int userId)

    Prüfen, ob ein bestimmter Nutzer aktiv ist.

    Parameter
    userId int

    Gibt Folgendes zurück:
    boolean „True“, wenn der Nutzer läuft, andernfalls „False“.

    Löst aus
    DeviceNotAvailableException

    isUserSecondary

    public boolean isUserSecondary (int userId)

    Gibt zurück, ob der angegebene Nutzer anhand seiner Flags ein sekundärer Nutzer ist.

    Parameter
    userId int

    Gibt Folgendes zurück:
    boolean „true“, wenn der Nutzer sekundär ist, andernfalls „false“.

    Löst aus
    DeviceNotAvailableException

    isUserVisible

    public boolean isUserVisible (int userId)

    Prüft, ob der angegebene Nutzer sichtbar ist.

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

    Parameter
    userId int

    Gibt Folgendes zurück:
    boolean

    Löst aus
    DeviceNotAvailableException

    isUserVisibleOnDisplay

    public boolean isUserVisibleOnDisplay (int userId, 
                    int displayId)

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

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

    Parameter
    userId int

    displayId int

    Gibt Folgendes zurück:
    boolean

    Löst aus
    DeviceNotAvailableException

    isVisibleBackgroundUsersOnDefaultDisplaySupported

    public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

    Gibt zurück, ob Nutzer im Hintergrund in ERROR(/java.android.view.Display#DEFAULT_DISPLAY) sichtbar sein dürfen.

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

    Gibt Folgendes zurück:
    boolean

    Löst aus
    DeviceNotAvailableException

    isVisibleBackgroundUsersSupported

    public boolean isVisibleBackgroundUsersSupported ()

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

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

    Gibt Folgendes zurück:
    boolean

    Löst aus
    DeviceNotAvailableException

    isWifiEnabled

    public boolean isWifiEnabled ()

    Prüfen, ob WLAN aktiviert ist.

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

    Gibt Folgendes zurück:
    boolean true, wenn WLAN aktiviert ist. false, falls deaktiviert

    Löst aus
    DeviceNotAvailableException

    listDisplayIds

    public Set<Long> listDisplayIds ()

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

    Gibt Folgendes zurück:
    Set<Long> Die Liste der Displays. „Default“ gibt immer die Standardanzeige 0 zurück.

    Löst aus
    DeviceNotAvailableException

    listDisplayIdsForStartingVisibleBackgroundUsers

    public Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

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

    Gibt Folgendes zurück:
    Set<Integer>

    Löst aus
    DeviceNotAvailableException

    listUsers

    public ArrayList<Integer> listUsers ()

    Ruft die Liste der Nutzer auf dem Gerät ab. Löst DeviceRuntimeException aus, wenn die Ausgabe des Geräts nicht wie erwartet ist.

    Gibt Folgendes zurück:
    ArrayList<Integer> Die Liste der Nutzer-IDs.

    Löst aus
    DeviceNotAvailableException

    logAnrs

    public boolean logAnrs (ITestLogger logger)

    Erfasst und protokolliert ANR-Fehler vom Gerät.

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

    Gibt Folgendes zurück:
    boolean „True“, wenn die Protokollierung erfolgreich war, andernfalls „false“.

    Löst aus
    DeviceNotAvailableException

    logBugreport

    public boolean logBugreport (String dataName, 
                    ITestLogger listener)

    Helper-Methode zum Erstellen eines Fehlerberichts und zum Protokollieren des Berichts für die Reporter.

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

    listener ITestLogger: eine ITestLogger zum Protokollieren des Fehlerberichts.

    Gibt Folgendes zurück:
    boolean „True“, wenn die Protokollierung erfolgreich war, andernfalls „false“.

    logOnDevice

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

    Eine Nachricht im Logcat des Geräts protokollieren. Dies ist ein sicherer Aufruf, der auch dann keine Ausnahme auslöst, wenn die Protokollierung fehlschlägt.

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

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

    format String: Das Nachrichtenformat.

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

    mountDebugfs

    public void mountDebugfs ()

    debugfs bereitstellen.

    Löst aus
    DeviceNotAvailableException

    nonBlockingReboot

    public void nonBlockingReboot ()

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

    Löst aus
    DeviceNotAvailableException

    postAdbRootAction

    public void postAdbRootAction ()

    Überschreiben, wenn auf dem Gerät nach dem Ausführen von „adb root“ und bevor das Gerät wieder online ist, bestimmte Aktionen ausgeführt werden müssen. Die Standardimplementierung umfasst keine zusätzlichen Aktionen. Es ist nicht garantiert, dass „adb root“ in dieser Phase aktiviert ist.

    Löst aus
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postAdbUnrootAction

    public void postAdbUnrootAction ()

    Überschreiben, wenn auf dem Gerät nach dem Aufheben des Rootings über ADB und vor dem erneuten Onlinegehen des Geräts bestimmte Aktionen ausgeführt werden müssen. Die Standardimplementierung umfasst keine zusätzlichen Aktionen. Es ist nicht garantiert, dass „adb root“ in dieser Phase deaktiviert wird.

    Löst aus
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    postBootSetup

    public void postBootSetup ()

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

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

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

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

    Löst aus
    DeviceNotAvailableException

    postInvocationTearDown

    public void postInvocationTearDown (Throwable exception)

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

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

    preInvocationSetup

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

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

    Parameter
    info IBuildInfo: Die IBuildInfo des Geräts.

    attributes MultiMap: Die im Aufrufkontext gespeicherten Attribute

    Löst aus
    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 kopiert werden sollen

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

    Gibt Folgendes zurück:
    boolean true, wenn die Datei erfolgreich abgerufen wurde. Andernfalls false.

    Löst aus
    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 kopiert werden sollen

    Gibt Folgendes zurück:
    boolean true, wenn die Datei erfolgreich abgerufen wurde. Andernfalls false.

    Löst aus
    DeviceNotAvailableException

    pullDir

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

    Verzeichnisinhalte rekursiv vom Gerät abrufen.

    Parameter
    deviceFilePath String: der absolute Dateipfad der Remote-Quelle

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

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

    timeout long: das Zeitlimit für das Abrufen des Befehls

    Gibt Folgendes zurück:
    boolean true, wenn die Datei erfolgreich abgerufen wurde. Andernfalls false.

    Löst aus
    DeviceNotAvailableException

    pullFile

    public boolean pullFile (String remoteFilePath, 
                    File localFile, 
                    int userId, 
                    long timeout)

    Ruft eine Datei vom Gerät ab.

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

    localFile File: die lokale Datei, in der Inhalte gespeichert werden sollen. Wenn sie nicht leer ist, wird der Inhalt ersetzt.

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

    timeout long: Zeitüberschreitung beim Befehl zum Abrufen von Dateien

    Gibt Folgendes zurück:
    boolean true, wenn die Datei abgerufen wurde. Andernfalls false.

    Löst aus
    DeviceNotAvailableException

    pullFile

    public boolean pullFile (String remoteFilePath, 
                    File localFile)

    Ruft eine Datei vom Gerät ab.

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

    localFile File: die lokale Datei, in der Inhalte gespeichert werden sollen. Wenn nicht leer, wird der Inhalt ersetzt.

    Gibt Folgendes zurück:
    boolean true, wenn die Datei abgerufen wurde. Andernfalls false.

    Löst aus
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath, 
                    int userId)

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

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

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

    Gibt Folgendes zurück:
    File Eine File mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem)

    Löst aus
    DeviceNotAvailableException

    pullFile

    public File pullFile (String remoteFilePath)

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

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

    Gibt Folgendes zurück:
    File Eine File mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem)

    Löst aus
    DeviceNotAvailableException

    pullFile

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

    Ruft eine Datei vom Gerät ab.

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

    localFile File: die lokale Datei, in der Inhalte gespeichert werden sollen. Wenn sie nicht leer ist, wird der Inhalt ersetzt.

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

    Gibt Folgendes zurück:
    boolean true, wenn die Datei abgerufen wurde. Andernfalls false.

    Löst aus
    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.

    Gibt Folgendes zurück:
    String Eine String mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem)

    Löst aus
    DeviceNotAvailableException

    pullFileFromExternal

    public File pullFileFromExternal (String remoteFilePath)

    Eine Hilfsmethode zum Abrufen einer Datei aus dem externen Speicher des Geräts, die sie in einem lokalen temporären File speichert und eine Referenz auf dieses File zurückgibt.

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

    Gibt Folgendes zurück:
    File Eine File mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem)

    Löst aus
    DeviceNotAvailableException

    pushDir

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

    Verzeichnisinhalte rekursiv auf das Gerät übertragen.

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

    deviceFilePath String: der absolute Dateipfad des Remote-Ziels

    userId int: Die Nutzer-ID, an die die Push-Benachrichtigung gesendet werden soll

    Gibt Folgendes zurück:
    boolean true, wenn die Datei erfolgreich übertragen wurde. Andernfalls false.

    Löst aus
    DeviceNotAvailableException

    pushDir

    public boolean pushDir (File localFileDir, 
                    String deviceFilePath, 
                    Set<String> excludedDirectories)

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

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

    deviceFilePath String: der absolute Dateipfad des Remote-Ziels

    excludedDirectories Set: Eine Reihe von ausgeschlossenen Verzeichnisnamen, die nicht übertragen werden sollen.

    Gibt Folgendes zurück:
    boolean true, wenn die Datei erfolgreich übertragen wurde. Andernfalls false.

    Löst aus
    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

    Gibt Folgendes zurück:
    boolean true, wenn die Datei erfolgreich übertragen wurde. Andernfalls false.

    Löst aus
    DeviceNotAvailableException

    pushFile

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

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

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

    remoteFilePath String: der absolute Dateipfad des Remote-Ziels

    evaluateContentProviderNeeded boolean: Gibt an, ob geprüft werden soll, ob der Content-Anbieter benötigt wird.

    Gibt Folgendes zurück:
    boolean true, wenn die Datei erfolgreich übertragen wurde. Andernfalls false.

    Löst aus
    DeviceNotAvailableException

    pushFile

    public boolean pushFile (File localFile, 
                    String remoteFilePath)

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

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

    remoteFilePath String: der absolute Dateipfad des Remote-Ziels

    Gibt Folgendes zurück:
    boolean true, wenn die Datei erfolgreich übertragen wurde. Andernfalls false.

    Löst aus
    DeviceNotAvailableException

    pushFile

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

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

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

    remoteFilePath String: der absolute Dateipfad des Remote-Ziels

    userId int: die Nutzer-ID, an die die Push-Benachrichtigung gesendet werden soll

    Gibt Folgendes zurück:
    boolean true, wenn die Datei erfolgreich übertragen wurde. Andernfalls false.

    Löst aus
    DeviceNotAvailableException

    pushString

    public boolean pushString (String contents, 
                    String remoteFilePath)

    Aus einem String erstellte Datei an ein Gerät senden

    Parameter
    contents String: der Inhalt der zu übertragenden Datei

    remoteFilePath String: der absolute Dateipfad des Remote-Ziels

    Gibt Folgendes zurück:
    boolean true, wenn der String erfolgreich übertragen wurde. Andernfalls false.

    Löst aus
    DeviceNotAvailableException

    neu starten

    public void reboot (String reason)

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

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

    Der Grund für den letzten Neustart kann durch Abfragen des Attributs sys.boot.reason abgerufen werden.

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

    Löst aus
    DeviceNotAvailableException

    neu starten

    public String reboot (String command, 
                    String reason)

    Startet das Gerät mit dem angegebenen command neu.

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

    Der Grund für den letzten Neustart kann durch Abfragen des Attributs sys.boot.reason abgerufen werden.

    Parameter
    command String: Befehl, der an „adb“ übergeben wird. Er wird unverändert übergeben. Der Aufrufer muss also bei Bedarf die richtigen Anführungszeichen angeben, insbesondere wenn er mehrere durch Leerzeichen getrennte Teile enthält.

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

    Gibt Folgendes zurück:
    String

    Löst aus
    DeviceNotAvailableException

    neu starten

    public void reboot ()

    Startet das Gerät im ADB-Modus neu.

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

    Löst aus
    DeviceNotAvailableException

    rebootIntoBootloader

    public void rebootIntoBootloader ()

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

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

    Löst aus
    DeviceNotAvailableException
    UnsupportedOperationException

    rebootIntoFastbootd

    public void rebootIntoFastbootd ()

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

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

    Löst aus
    DeviceNotAvailableException
    UnsupportedOperationException

    rebootIntoRecovery

    public void rebootIntoRecovery ()

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

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

    Löst aus
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload ()

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

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

    Löst aus
    DeviceNotAvailableException

    rebootIntoSideload

    public void rebootIntoSideload (boolean autoReboot)

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

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

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

    Löst aus
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline ()

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

    Löst aus
    DeviceNotAvailableException

    rebootUntilOnline

    public void rebootUntilOnline (String reason)

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

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

    Löst aus
    DeviceNotAvailableException

    rebootUserspace

    public void rebootUserspace ()

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

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

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

    Löst aus
    DeviceNotAvailableException

    rebootUserspaceUntilOnline

    public void rebootUserspaceUntilOnline ()

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

    Löst aus
    DeviceNotAvailableException

    recoverDevice

    public boolean recoverDevice ()

    Es wird versucht, die Gerätekommunikation wiederherzustellen.

    Gibt Folgendes zurück:
    boolean „True“, wenn die Wiederherstellung versucht und erfolgreich war. „False“, wenn die Wiederherstellung übersprungen wurde.

    Löst aus
    DeviceNotAvailableException Wenn das Gerät nicht mehr verfügbar ist

    registerDeviceActionReceiver

    public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

    Registriert ein IDeviceActionReceiver für dieses Gerät.

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

    Parameter
    deviceActionReceiver IDeviceActionReceiver: Eine IDeviceActionReceiver, die registriert wird.

    remountSystemReadOnly

    public void remountSystemReadOnly ()

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

    Löst aus
    DeviceNotAvailableException

    remountSystemWritable

    public void remountSystemWritable ()

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

    Löst aus
    DeviceNotAvailableException

    remountVendorReadOnly

    public void remountVendorReadOnly ()

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

    Löst aus
    DeviceNotAvailableException

    remountVendorWritable

    public void remountVendorWritable ()

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

    Löst aus
    DeviceNotAvailableException

    removeAdmin

    public boolean removeAdmin (String componentName, 
                    int userId)

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

    Parameter
    componentName String: des zu entfernenden Geräteadministrators.

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

    Gibt Folgendes zurück:
    boolean „True“, wenn erfolgreich, andernfalls „false“.

    Löst aus
    DeviceNotAvailableException

    removeOwners

    public void removeOwners ()

    Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen.

    Löst aus
    DeviceNotAvailableException

    removeUser

    public boolean removeUser (int userId)

    Einen bestimmten Nutzer vom Gerät entfernen.

    Parameter
    userId int: des zu entfernenden Nutzers

    Gibt Folgendes zurück:
    boolean „true“, wenn der Nutzer erfolgreich entfernt wurde, andernfalls „false“.

    Löst aus
    DeviceNotAvailableException

    resetContentProviderSetup

    public void resetContentProviderSetup ()

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

    runInstrumentationTests

    public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, 
                    Collection<ITestLifeCycleReceiver> listeners)

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

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

    Wenn die Verbindung zum Gerät verloren geht, bevor der Testlauf abgeschlossen ist, 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 Collection: die Listener für Testergebnisse

    Gibt Folgendes zurück:
    boolean true, wenn der Testbefehl abgeschlossen ist. false, wenn der Vorgang aufgrund einer Ausnahme bei der Gerätekommunikation nicht abgeschlossen werden konnte, die Wiederherstellung aber erfolgreich war

    Löst aus
    DeviceNotAvailableException

    runInstrumentationTests

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

    Bequeme Methode zum Ausführen von runInstrumentationTests(IRemoteAndroidTestRunner,Collection) mit einem oder mehreren Listenern, die als Parameter übergeben werden.

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

    listeners ITestLifeCycleReceiver: die Listener für Testergebnisse

    Gibt Folgendes zurück:
    boolean true, wenn der Testbefehl abgeschlossen ist. false, wenn der Vorgang nicht abgeschlossen werden konnte, aber die Wiederherstellung erfolgreich war

    Löst aus
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

    public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, 
                    int userId, 
                    Collection<ITestLifeCycleReceiver> listeners)

    Wie ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,Collection), führt den Test jedoch für den angegebenen Nutzer aus.

    Parameter
    runner IRemoteAndroidTestRunner

    userId int

    listeners Collection

    Gibt Folgendes zurück:
    boolean

    Löst aus
    DeviceNotAvailableException

    runInstrumentationTestsAsUser

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

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

    Parameter
    runner IRemoteAndroidTestRunner

    userId int

    listeners ITestLifeCycleReceiver

    Gibt Folgendes zurück:
    boolean

    Löst aus
    DeviceNotAvailableException

    setAdbPath

    public void setAdbPath (String adbPath)

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

    Parameter
    adbPath String

    setConfiguration

    public void setConfiguration (IConfiguration configuration)

    Fügt die verwendete IConfiguration ein.

    Parameter
    configuration IConfiguration

    setConnectionAvdInfo

    public final void setConnectionAvdInfo (GceAvdInfo avdInfo)

    Parameter
    avdInfo GceAvdInfo

    setDate

    public void setDate (Date date)

    Legt das Datum auf dem Gerät fest

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

    Parameter
    date Date: gibt ein bestimmtes Datum an; verwendet das Hostdatum, wenn null

    Löst aus
    DeviceNotAvailableException

    setDeviceOwner

    public boolean setDeviceOwner (String componentName, 
                    int userId)

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

    Parameter
    componentName String: des Geräteadministrators zum Geräteinhaber.

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

    Gibt Folgendes zurück:
    boolean „True“, wenn erfolgreich, andernfalls „false“.

    Löst aus
    DeviceNotAvailableException

    setDeviceState

    public void setDeviceState (TestDeviceState deviceState)

    Aktualisieren Sie den Gerätestatus.

    Parameter
    deviceState TestDeviceState: Der TestDeviceState

    setEmulatorOutputStream

    public void setEmulatorOutputStream (SizeLimitedOutputStream output)

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

    Parameter
    output SizeLimitedOutputStream: zum Protokollieren der Ausgabe

    setEmulatorProcess

    public void setEmulatorProcess (Process p)

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

    Parameter
    p Process

    setFastbootEnabled

    public void setFastbootEnabled (boolean fastbootEnabled)

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

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

    setFastbootPath

    public void setFastbootPath (String fastbootPath)

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

    Parameter
    fastbootPath String

    setIDevice

    public void setIDevice (IDevice newDevice)

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

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

    Parameter
    newDevice IDevice: Der IDevice

    setLogStartDelay

    public void setLogStartDelay (int delay)

    Legt die Zeit in Millisekunden fest, die gewartet werden soll, bevor die Logcat-Erfassung für ein Onlinegerät gestartet wird.

    Parameter
    delay int: die Verzögerung in Millisekunden

    setOptions

    public void setOptions (TestDeviceOptions options)

    TestDeviceOptions für das Gerät festlegen

    Parameter
    options TestDeviceOptions

    setProperty

    public boolean setProperty (String propKey, 
                    String propValue)

    Legt den angegebenen Eigenschaftswert auf dem Gerät fest. Erfordert, dass „adb root“ auf „true“ gesetzt ist.

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

    propValue String: Der festzulegende Property-Wert.

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

    Löst aus
    DeviceNotAvailableException

    setRecovery

    public void setRecovery (IDeviceRecovery recovery)

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

    Parameter
    recovery IDeviceRecovery: Der IDeviceRecovery

    setRecoveryMode

    public void setRecoveryMode (ITestDevice.RecoveryMode mode)

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

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

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

    setSetting

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

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

    Parameter
    namespace String

    key String

    value String

    Löst aus
    DeviceNotAvailableException

    setSetting

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

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

    Parameter
    userId int

    namespace String

    key String

    value String

    Löst aus
    DeviceNotAvailableException

    setTestLogger

    public void setTestLogger (ITestLogger testLogger)

    Fügt die ITestLogger-Instanz ein.

    Parameter
    testLogger ITestLogger

    setTrackingSerial

    public void setTrackingSerial (String trackingSerial)

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

    Parameter
    trackingSerial String

    setUseFastbootErase

    public void setUseFastbootErase (boolean useFastbootErase)

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

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

    startLogcat

    public void startLogcat ()

    Logcat-Ausgabe vom Gerät im Hintergrund erfassen.

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

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

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

    startTradeInModeTesting

    public boolean startTradeInModeTesting (int timeoutMs)

    Aktivieren Sie den Testmodus für die Inzahlungnahme. Das Gerät wird zurückgesetzt und neu gestartet.

    Parameter
    timeoutMs int

    Gibt Folgendes zurück:
    boolean „True“, wenn erfolgreich, andernfalls „false“

    Löst aus
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId)

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

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

    Gibt Folgendes zurück:
    boolean „true“, wenn der Nutzer erfolgreich im Hintergrund gestartet wurde.

    Löst aus
    DeviceNotAvailableException

    startUser

    public boolean startUser (int userId, 
                    boolean waitFlag)

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

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

    waitFlag boolean: Der Befehl wird erst ausgeführt, wenn der Nutzer gestartet und entsperrt wurde.

    Gibt Folgendes zurück:
    boolean „true“, wenn der Nutzer erfolgreich im Hintergrund gestartet wurde.

    Löst aus
    DeviceNotAvailableException

    startVisibleBackgroundUser

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

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

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

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

    displayId int: Display, auf dem der Nutzer die Anzeige sehen soll

    waitFlag boolean: Der Befehl wird erst ausgeführt, wenn der Nutzer gestartet und entsperrt wurde.

    Gibt Folgendes zurück:
    boolean true, wenn der Nutzer sichtbar im Hintergrund gestartet wurde.

    Löst aus
    DeviceNotAvailableException

    stopEmulatorOutput

    public void stopEmulatorOutput ()

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

    stopLogcat

    public void stopLogcat ()

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

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

    stopTradeInModeTesting

    public void stopTradeInModeTesting ()

    Test des Trade-In-Modus beenden

    Löst aus
    DeviceNotAvailableException

    stopUser

    public boolean stopUser (int userId)

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

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

    Gibt Folgendes zurück:
    boolean „true“, wenn der Nutzer erfolgreich gestoppt wurde.

    Löst aus
    DeviceNotAvailableException

    stopUser

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

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

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

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

    forceFlag boolean: Der Nutzer wird zum Beenden gezwungen.

    Gibt Folgendes zurück:
    boolean „true“, wenn der Nutzer erfolgreich gestoppt wurde.

    Löst aus
    DeviceNotAvailableException

    switchToAdbTcp

    public String switchToAdbTcp ()

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

    Gibt Folgendes zurück:
    String Die TCP-Seriennummer oder null, wenn das Gerät nicht umgeschaltet werden konnte

    Löst aus
    DeviceNotAvailableException

    switchToAdbUsb

    public boolean switchToAdbUsb ()

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

    Gibt Folgendes zurück:
    boolean true, wenn der Wechsel erfolgreich war, andernfalls false.

    Löst aus
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId)

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

    Parameter
    userId int

    Gibt Folgendes zurück:
    boolean „True“, wenn die neue User-ID mit dem User-ID-Anbieter übereinstimmt. Andernfalls „Falsch”.

    Löst aus
    DeviceNotAvailableException

    switchUser

    public boolean switchUser (int userId, 
                    long timeout)

    Wechseln Sie mit dem angegebenen Zeitlimit zu einer anderen userId. Versuche, die Keyguard-Sperre zu deaktivieren, nachdem der Nutzerwechsel erfolgreich war.

    Parameter
    userId int

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

    Gibt Folgendes zurück:
    boolean „True“, wenn die neue User-ID mit dem User-ID-Anbieter übereinstimmt. Andernfalls „Falsch”.

    Löst aus
    DeviceNotAvailableException

    syncFiles

    public boolean syncFiles (File localFileDir, 
                    String deviceFilePath)

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

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

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

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

    Parameter
    localFileDir File: Das lokale Dateiverzeichnis, das rekursiv zu übertragende Dateien enthält.

    deviceFilePath String: der absolute Dateipfad-Root des Remote-Ziels. Alle Verzeichnisse in diesem Dateipfad müssen lesbar sein. Das Pushen nach /data/local/tmp schlägt fehl, wenn ADB nicht als Root ausgeführt wird.

    Gibt Folgendes zurück:
    boolean true, wenn Dateien erfolgreich synchronisiert wurden. Andernfalls false.

    Löst aus
    DeviceNotAvailableException

    takeBugreport

    public Bugreport takeBugreport ()

    Nimmt einen Fehlerbericht entgegen und gibt ihn in einem Bugreport-Objekt zurück, um ihn zu verarbeiten. Gibt bei Problemen „null“ zurück. Auf Dateien, auf die im Bugreport-Objekt verwiesen wird, muss über Bugreport.close() zugegriffen werden.

    Gibt Folgendes zurück:
    Bugreport

    uninstallPackage

    public String uninstallPackage (String packageName)

    Ein Android-Paket vom Gerät deinstallieren.

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

    Gibt Folgendes zurück:
    String String mit einem Fehlercode oder null bei Erfolg.

    Löst aus
    DeviceNotAvailableException

    uninstallPackageForUser

    public String uninstallPackageForUser (String packageName, 
                    int userId)

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

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

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

    Gibt Folgendes zurück:
    String String mit einem Fehlercode oder null bei Erfolg.

    Löst aus
    DeviceNotAvailableException

    unlockDevice

    public boolean unlockDevice ()

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

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

    Gibt Folgendes zurück:
    boolean true, wenn der Vorgang erfolgreich war oder das Gerät nicht verschlüsselt ist.

    Löst aus
    DeviceNotAvailableException
    UnsupportedOperationException

    unmountDebugfs

    public void unmountDebugfs ()

    debugfs trennen.

    Löst aus
    DeviceNotAvailableException

    waitForBootComplete

    public boolean waitForBootComplete (long timeOut)

    Blockiert, bis das Boot-Complete-Flag des Geräts gesetzt ist.

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

    Gibt Folgendes zurück:
    boolean „true“, wenn das Flag „boot_complete“ des Geräts innerhalb des Zeitlimits gesetzt ist

    Löst aus
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable ()

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

    Gibt Folgendes zurück:
    boolean „True“, wenn das Gerät verfügbar ist, „False“, wenn die Wiederherstellung deaktiviert und nicht verfügbar ist.

    Löst aus
    DeviceNotAvailableException

    waitForDeviceAvailable

    public boolean waitForDeviceAvailable (long waitTime)

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

    Parameter
    waitTime long: die Wartezeit in Millisekunden

    Gibt Folgendes zurück:
    boolean „True“, wenn das Gerät verfügbar ist, „False“, wenn die Wiederherstellung deaktiviert und nicht verfügbar ist.

    Löst aus
    DeviceNotAvailableException

    waitForDeviceAvailableInRecoverPath

    public boolean waitForDeviceAvailableInRecoverPath (long waitTime)

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

    Parameter
    waitTime long

    Gibt Folgendes zurück:
    boolean „True“, wenn das Gerät verfügbar ist, „False“, wenn es nicht verfügbar ist.

    Löst aus
    DeviceNotAvailableException

    waitForDeviceBootloader

    public void waitForDeviceBootloader ()

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

    Löst aus
    DeviceNotAvailableException

    waitForDeviceFastbootD

    public void waitForDeviceFastbootD ()

    Löst aus
    DeviceNotAvailableException

    waitForDeviceInRecovery

    public boolean waitForDeviceInRecovery (long waitTime)

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

    Parameter
    waitTime long: die Wartezeit in Millisekunden

    Gibt Folgendes zurück:
    boolean true, wenn das Gerät vor Ablauf der Zeit in den Wiederherstellungsmodus bootet. Andernfalls false

    waitForDeviceInSideload

    public boolean waitForDeviceInSideload (long waitTime)

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

    Parameter
    waitTime long: die Wartezeit in Millisekunden

    Gibt Folgendes zurück:
    boolean true, wenn das Gerät vor Ablauf der Zeit im Sideload-Modus startet. Andernfalls false

    waitForDeviceNotAvailable

    public boolean waitForDeviceNotAvailable (long waitTime)

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

    Parameter
    waitTime long: die Wartezeit in Millisekunden

    Gibt Folgendes zurück:
    boolean true, wenn das Gerät vor Ablauf der Zeit nicht mehr verfügbar ist. Andernfalls false

    waitForDeviceOnline

    public void waitForDeviceOnline ()

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

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

    Löst aus
    DeviceNotAvailableException

    waitForDeviceOnline

    public void waitForDeviceOnline (long waitTime)

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

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

    Parameter
    waitTime long: die Wartezeit in Millisekunden

    Löst aus
    DeviceNotAvailableException

    waitForDeviceShell

    public boolean waitForDeviceShell (long waitTime)

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

    Parameter
    waitTime long: die Wartezeit in Millisekunden

    Gibt Folgendes zurück:
    boolean true, wenn das Gerät reagiert, bevor waitTime abgelaufen ist.

    Geschützte Methoden

    addExtraConnectionBuilderArgs

    protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)

    Parameter
    builder DefaultConnection.ConnectionBuilder

    buildAdbShellCommand

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

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

    Parameter
    command String

    forceExitStatusDetection boolean

    oldShellCommand boolean

    Gibt Folgendes zurück:
    String[]

    checkApiLevelAgainst

    protected void checkApiLevelAgainst (String feature, 
                    int strictMinLevel)

    Parameter
    feature String

    strictMinLevel int

    createRebootDeviceAction

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

    Erstellt ein RebootDeviceAction, das beim Ausführen einer Neustartaktion verwendet werden soll.

    Parameter
    rebootMode NativeDevice.RebootMode: Ein Modus dieses Neustarts.

    reason String: für diesen Neustart.

    Gibt Folgendes zurück:
    NativeDevice.RebootDeviceAction den erstellten RebootDeviceAction.

    createRunUtil

    protected IRunUtil createRunUtil ()

    Gibt Folgendes zurück:
    IRunUtil

    doAdbReboot

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

    Führen Sie einen ADB-Neustart durch.

    Parameter
    rebootMode NativeDevice.RebootMode: Ein Modus dieses Neustarts.

    reason String: für diesen Neustart.

    Löst aus
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    ensureRuntimePermissionSupported

    protected void ensureRuntimePermissionSupported ()

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

    Löst aus
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    getApiLevelSafe

    protected int getApiLevelSafe ()

    Gibt Folgendes zurück:
    int

    getLogger

    protected ITestLogger getLogger ()

    Gibt Folgendes zurück:
    ITestLogger

    getRunUtil

    protected IRunUtil getRunUtil ()

    Rufen Sie die zu verwendende RunUtil-Instanz ab.

    Gibt Folgendes zurück:
    IRunUtil

    internalGetProperty

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

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

    Parameter
    propName String: Der Name der Geräte-Property, wie von „adb shell getprop“ zurückgegeben.

    fastbootVar String: Der Name der entsprechenden Fastboot-Variablen, die abgefragt werden soll. Wenn null, wird kein Fastboot-Befehl ausgeführt.

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

    Gibt Folgendes zurück:
    String Ein String, der möglicherweise null oder leer ist und den Wert der angegebenen Property enthält.

    Löst aus
    DeviceNotAvailableException
    UnsupportedOperationException

    isInRebootCallback

    protected boolean isInRebootCallback ()

    Gibt zurück, ob Rückrufe für Neustarts gerade ausgeführt werden. Alle öffentlichen APIs für den Neustart sollten deaktiviert werden, wenn „true“ festgelegt ist.

    Gibt Folgendes zurück:
    boolean

    isNewer

    protected boolean isNewer (File localFile, 
                    IFileEntry entry)

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

    Parameter
    localFile File

    entry IFileEntry

    Gibt Folgendes zurück:
    boolean

    notifyRebootEnded

    protected void notifyRebootEnded ()

    Benachrichtigt alle IDeviceActionReceiver über das Ende des Neustarts.

    Löst aus
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    notifyRebootStarted

    protected void notifyRebootStarted ()

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

    Löst aus
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    performDeviceAction

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

    Führt eine Aktion auf diesem Gerät aus. Es wird versucht, das Gerät wiederherzustellen und den Befehl optional noch einmal auszuführen, wenn die Aktion fehlschlägt.

    Parameter
    actionDescription String: Eine kurze Beschreibung der auszuführenden Aktion. Wird nur zu Protokollierungszwecken verwendet.

    action NativeDevice.DeviceAction: die auszuführende Aktion

    retryAttempts int: Die Anzahl der Wiederholungsversuche für die Aktion, wenn sie fehlschlägt, aber die Wiederherstellung erfolgreich ist.

    Gibt Folgendes zurück:
    boolean true, wenn die Aktion erfolgreich ausgeführt wurde

    Löst aus
    DeviceNotAvailableException wenn der Wiederherstellungsversuch fehlschlägt oder die maximale Anzahl von Versuchen ohne Erfolg erreicht wurde

    postAdbReboot

    protected void postAdbReboot (NativeDevice.RebootMode rebootMode)

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

    Parameter
    rebootMode NativeDevice.RebootMode

    Löst aus
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    prePostBootSetup

    protected void prePostBootSetup ()

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

    Löst aus
    com.android.tradefed.device.DeviceNotAvailableException
    DeviceNotAvailableException

    pullFileWithAdbCommand

    protected boolean pullFileWithAdbCommand (String remoteFilePath, 
                    File localFile, 
                    long timeout)

    Parameter
    remoteFilePath String

    localFile File

    timeout long

    Gibt Folgendes zurück:
    boolean

    Löst aus
    DeviceNotAvailableException

    setClock

    protected void setClock (Clock clock)

    Legen Sie die zu verwendende Clock-Instanz fest.

    Parameter
    clock Clock

    setMicrodroidProcess

    protected void setMicrodroidProcess (Process process)

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

    Parameter
    process Process: Prozess der Microdroid-VM.

    setTestDeviceOptions

    protected void setTestDeviceOptions (Map<String, String> deviceOptions)

    Parameter
    deviceOptions Map

    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

    Gibt Folgendes zurück:
    CommandResult

    Löst aus
    UnsupportedOperationException

    simpleFastbootCommand

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

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

    Parameter
    timeout long

    envVarMap Map

    fullCmd String

    Gibt Folgendes zurück:
    CommandResult

    Löst aus
    UnsupportedOperationException

    waitForDeviceNotAvailable

    protected boolean waitForDeviceNotAvailable (String operationDesc, 
                    long time)

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

    Parameter
    operationDesc String: Der Name des Vorgangs, der auf „Nicht verfügbar“ wartet.

    time long: Die Zeit, die gewartet wird, bis „Nicht verfügbar“ eintritt.

    Gibt Folgendes zurück:
    boolean „True“, wenn das Gerät nicht mehr verfügbar ist.