NativeDevice
public
class
NativeDevice
extends Object
implements
IConfigurationReceiver,
IManagedTestDevice,
ITestLoggerReceiver
java.lang.Object | |
➔ | com.android.tradefed.device.NativeDevice. |
Standardimplementierung eines ITestDevice
nicht vollständigen Stacks für Android-Geräte.
Zusammenfassung
Verschachtelte Klassen | |
---|---|
class |
NativeDevice.AdbAction
Eine |
class |
NativeDevice.AdbShellAction
|
class |
NativeDevice.RebootDeviceAction
|
Konstanten | |
---|---|
int |
INVALID_USER_ID
Wert, der für eine ungültige/nicht gefundene Nutzer-ID zurückgegeben wird: UserHandle hat den Wert -10000 definiert |
long |
MAX_HOST_DEVICE_TIME_OFFSET
|
int |
MAX_RETRY_ATTEMPTS
die Standardanzahl der Wiederholungsversuche für Befehle |
Felder | |
---|---|
public
static
final
String |
DEBUGFS_PATH
|
protected
static
final
String |
SD_CARD
|
protected
static
final
String |
STORAGE_EMULATED
|
protected
TestDeviceOptions |
mOptions
|
protected
final
IDeviceStateMonitor |
mStateMonitor
|
Öffentliche Konstruktoren | |
---|---|
NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Erstellt einen |
Öffentliche Methoden | |
---|---|
void
|
batchPrefetchStartupBuildProps()
Mikrooptimierung (ca. 400 Millis), indem alle benötigten Attribute vorab abgerufen werden, anstatt für jede „adb getprop“ aufzurufen. |
boolean
|
canSwitchToHeadlessSystemUser()
Gibt an, ob der Wechsel zum headless SYSTEM-Nutzer zulässig ist. |
boolean
|
checkApiLevelAgainstNextRelease(int strictMinLevel)
Prüfen, ob eine Funktion derzeit unterstützt wird, wenn ein Mindestsupportlevel vorhanden ist |
boolean
|
checkConnectivity()
Prüfen Sie, ob das Gerät eine Netzwerkverbindung hat. |
boolean
|
clearErrorDialogs()
Schließen Sie alle Fehlerdialogfelder, die derzeit auf der Geräteoberfläche angezeigt werden. |
void
|
clearLastConnectedWifiNetwork()
Das zuletzt verbundene WLAN wird gelöscht. |
void
|
clearLogcat()
Löscht alle angesammelten Logcat-Daten. |
boolean
|
connectToWifiNetwork(
Verbindet sich mit einem WLAN. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
Verbindet sich mit einem WLAN. |
boolean
|
connectToWifiNetwork(
Verbindet sich mit einem WLAN. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
Verbindet sich mit einem WLAN. |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)
Eine Variante von |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)
Eine Variante von |
int
|
createUser(String name, boolean guest, boolean ephemeral)
Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen |
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen |
int
|
createUser(String name)
Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0. |
int
|
createUserNoThrow(String name)
Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0. |
void
|
deleteFile(String deviceFilePath, int userId)
Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät. |
void
|
deleteFile(String deviceFilePath)
Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät. |
void
|
deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Entfernt die registrierte |
boolean
|
deviceSoftRestarted(ProcessInfo prevSystemServerProcess)
Hilfsmethode, um zu prüfen, ob das Gerät neu gestartet wurde, indem der aktuelle system_server mit dem vorherigen system_server |
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
Hilfsmethode, um zu prüfen, ob das Gerät seit der UTC-Zeit seit der Epoche vom Gerät und seiner |
boolean
|
disableAdbRoot()
Deaktiviert adb root. |
void
|
disableKeyguard()
Es wird versucht, den Keyguard zu deaktivieren. |
boolean
|
disableNetworkMonitor()
Deaktiviert die Netzwerküberwachung auf dem Gerät. |
boolean
|
disconnectFromWifi()
Trennen Sie die Verbindung zu einem WLAN. |
boolean
|
doesFileExist(String deviceFilePath, int userId)
Hilfsmethode, um zu ermitteln, ob eine Datei auf dem Gerät für einen bestimmten Nutzer vorhanden ist. |
boolean
|
doesFileExist(String deviceFilePath)
Hilfsmethode zum Ermitteln, ob eine Datei auf dem Gerät vorhanden ist. |
File
|
dumpHeap(String process, String devicePath)
Versuchen Sie, den Heap aus dem system_server zu dumpen. |
boolean
|
enableAdbRoot()
Aktiviert adb root. |
boolean
|
enableNetworkMonitor()
Aktiviert die Netzwerküberwachung auf dem Gerät. |
String
|
executeAdbCommand(long timeout, String... cmdArgs)
Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt. |
String
|
executeAdbCommand(long timeout,
Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt. |
String
|
executeAdbCommand(String... cmdArgs)
Hilfsmethode, die einen adb-Befehl als Systembefehl ausführt. |
CommandResult
|
executeFastbootCommand(String... cmdArgs)
Hilfsmethode, die einen Fastboot-Befehl als Systembefehl mit einer Standardzeitüberschreitung von 2 Minuten ausführt. |
CommandResult
|
executeFastbootCommand(long timeout, String... cmdArgs)
Hilfsmethode, die einen Fastboot-Befehl als Systembefehl ausführt. |
CommandResult
|
executeLongFastbootCommand(String... cmdArgs)
Hilfsmethode, die einen lang laufenden Fastboot-Befehl als Systembefehl ausführt. |
CommandResult
|
executeLongFastbootCommand(
Hilfsmethode, die einen lang laufenden Fastboot-Befehl als Systembefehl mit Systemumgebungsvariablen ausführt. |
String
|
executeShellCommand(String command)
Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ausgabe als |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
Führt den angegebenen adb-Shell-Befehl aus und versucht bei einem Fehler mehrmals, ihn auszuführen. |
CommandResult
|
executeShellV2Command(String cmd)
Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als |
CommandResult
|
executeShellV2Command(String cmd, OutputStream pipeToOutput)
Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput)
Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus. |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus. |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus. |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern. |
CommandResult
|
fastbootWipePartition(String partition)
Hilfsmethode zum Löschen einer Partition für das Gerät. |
|
getActiveApexes()
Ruft die Informationen zu den auf dem Gerät aktivierten APEX-Objekten ab. |
|
getAllSettings(String namespace)
Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück. |
DeviceAllocationState
|
getAllocationState()
Aktuellen Zuweisungsstatus des Geräts zurückgeben |
String
|
getAndroidId(int userId)
Die mit einer Nutzer-ID verknüpfte Android-ID suchen und zurückgeben. Wenn sie nicht gefunden wird, wird „null“ zurückgegeben. |
|
getAndroidIds()
Erstellen Sie eine Zuordnungstabelle mit den gefundenen Android-IDs und den zugehörigen User-IDs. |
int
|
getApiLevel()
Rufe die API-Ebene des Geräts ab. |
PackageInfo
|
getAppPackageInfo(String packageName)
Informationen zu einem auf dem Gerät installierten Paket abrufen |
|
getAppPackageInfos()
Ruft Informationen zu auf dem Gerät installierten Paketen ab. |
String
|
getBasebandVersion()
Diese Methode ist praktisch, um die Baseband-Version (Funkschnittstelle) dieses Geräts abzurufen. |
Integer
|
getBattery()
Gibt den aktuellen Akkustand eines Geräts zurück oder „Null“, wenn der Akkustand nicht verfügbar ist. |
boolean
|
getBooleanProperty(String name, boolean defaultValue)
Gibt einen booleschen Wert der angegebenen Eigenschaft zurück. |
|
getBootHistory()
Die Hilfsmethode erfasst die Boot-Verlaufskarte mit Bootzeit und Bootgrund. |
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
Mit dieser Hilfsmethode wird die Boot-Verlaufskarte mit Bootzeit und Bootgrund seit dem angegebenen Zeitpunkt seit der Epoche vom Gerät und der angegebenen Zeiteinheit erfasst. |
String
|
getBootloaderVersion()
Diese Methode ist eine praktische Möglichkeit, die Bootloader-Version dieses Geräts abzurufen. |
InputStreamSource
|
getBugreport()
Ruft einen Fehlerbericht vom Gerät ab. |
InputStreamSource
|
getBugreportz()
Ruft einen Fehlerbericht vom Gerät ab |
String
|
getBuildAlias()
Ruft den Alias des Builds ab, der auf dem Gerät gerade ausgeführt wird. |
String
|
getBuildFlavor()
Ruft die Build-Variante für das Gerät ab. |
String
|
getBuildId()
Rufen Sie den Build ab, den das Gerät derzeit ausführt. |
String
|
getBuildSigningKeys()
Gibt den Schlüsseltyp zurück, der zum Signieren des Geräte-Images verwendet wurde. Normalerweise werden Android-Geräte mit Testschlüsseln (z. B. in AOSP) oder Release-Schlüsseln (von einzelnen Geräteherstellern gesteuert) signiert. |
DeviceDescriptor
|
getCachedDeviceDescriptor()
Gibt einen im Cache gespeicherten |
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Gibt einen im Cache gespeicherten |
String[]
|
getChildren(String path)
Eine Alternative zur Verwendung von |
AbstractConnection
|
getConnection()
Die aktuelle Verbindung, die dem Gerät zugeordnet ist. |
ContentProviderHandler
|
getContentProvider(int userId)
Gibt |
DeviceFoldableState
|
getCurrentFoldableState()
Gibt den aktuellen Faltstatus des Geräts zurück oder „null“, wenn Probleme aufgetreten sind. |
int
|
getCurrentUser()
Gibt die ID des aktuell laufenden Nutzers zurück. |
String
|
getDeviceClass()
Rufen Sie die Geräteklasse ab. |
long
|
getDeviceDate()
Datum des Geräts in Millisekunden seit der Epoche zurückgeben. |
DeviceDescriptor
|
getDeviceDescriptor()
Gib ein |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Gib ein |
TestDeviceState
|
getDeviceState()
Rufe den Status des Geräts ab. |
long
|
getDeviceTimeOffset(Date date)
Hilft, die Zeitdifferenz zwischen dem Gerät und einer bestimmten |
InputStreamSource
|
getEmulatorOutput()
Stream von stdout und stderr des Emulators abrufen |
Process
|
getEmulatorProcess()
Geben Sie die |
final
File
|
getExecuteShellCommandLog()
Das Log, das alle |
long
|
getExternalStoreFreeSpace()
Hilfsmethode zum Ermitteln der Menge an freiem Speicherplatz im externen Gerätespeicher. |
String
|
getFastbootPath()
Gibt den Pfad der verwendeten Fastboot-Binärdatei zurück. |
String
|
getFastbootProductType()
Praktische Methode zum Abrufen des Produkttyps dieses Geräts, wenn es sich im Schnellstartmodus (Fastboot mode) befindet. |
String
|
getFastbootProductVariant()
Praktische Methode zum Abrufen des Produkttyps dieses Geräts, wenn es sich im Schnellstartmodus (Fastboot mode) befindet. |
String
|
getFastbootSerialNumber()
Gibt die Seriennummer des Fastboot-Modus zurück. |
String
|
getFastbootVariable(String variableName)
Ruft den angegebenen Wert der Fastboot-Variablen vom Gerät ab. |
String
|
getFastbootVersion()
Gibt den Versionsstring der verwendeten Fastboot-Binärdatei zurück. |
IFileEntry
|
getFileEntry(String path)
Eine Referenz auf eine Remotedatei auf dem Gerät abrufen |
IFileEntry
|
getFileEntry(FileListingService.FileEntry entry)
Inoffizieller Helfer zum Abrufen einer |
|
getFoldableStates()
Liste der Zustände des faltbaren Geräts zurückgeben |
IDevice
|
getIDevice()
Gibt einen Verweis auf die zugehörige ddmlib- |
|
getInstalledPackageNames()
Ruft die Namen der Anwendungspakete auf dem Gerät ab. |
long
|
getIntProperty(String name, long defaultValue)
Gibt einen ganzzahligen Wert der angegebenen Eigenschaft vom Gerät zurück. |
String
|
getIpAddress()
Ruft die IP-Adresse des Geräts ab. |
KeyguardControllerState
|
getKeyguardState()
Gibt ein Objekt zurück, um den aktuellen Status des Keyguard oder null abzurufen, wenn dies nicht unterstützt wird. |
long
|
getLastExpectedRebootTimeMillis()
Gibt an, wann Tradefed APIs zuletzt einen Neustart in Millisekunden seit der Epoche ausgelöst haben, wie von |
int
|
getLaunchApiLevel()
Das API-Level, mit dem das Gerät zum ersten Mal gestartet wurde. |
InputStreamSource
|
getLogcat()
Erfasst einen Snapshot-Stream der Logcat-Daten. |
InputStreamSource
|
getLogcat(int maxBytes)
Erfasst einen Snapshot-Stream der letzten |
InputStreamSource
|
getLogcatDump()
Dump des aktuellen Logcats für das Gerät abrufen |
InputStreamSource
|
getLogcatSince(long date)
Erfasst einen Snapshot-Stream der erfassten Logcat-Daten ab dem angegebenen Datum. |
String
|
getMacAddress()
Gibt die MAC-Adresse des Geräts zurück. Wenn die Abfrage fehlschlägt, wird „null“ zurückgegeben. |
Integer
|
getMainUserId()
Gibt die Hauptnutzer-ID zurück. |
|
getMainlineModuleInfo()
Informationen zu den auf dem Gerät installierten Mainline-Modulen abrufen |
int
|
getMaxNumberOfRunningUsersSupported()
Die maximale Anzahl der gleichzeitig unterstützten Nutzer abrufen |
int
|
getMaxNumberOfUsersSupported()
Maximal unterstützte Nutzerzahl abrufen |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
Gibt den mit dem Gerät verknüpften |
String
|
getMountPoint(String mountName)
Gibt einen Bereitstellungspunkt zurück. |
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
Gibt ein |
|
getMountPointInfo()
Gibt eine geparste Version der Informationen in /proc/mounts auf dem Gerät zurück |
TestDeviceOptions
|
getOptions()
Rufe die Testoptionen für das Gerät ab. |
long
|
getPartitionFreeSpace(String partition)
Hilfsmethode zum Bestimmen des freien Speicherplatzes auf der Gerätepartition. |
Integer
|
getPrimaryUserId()
Gibt die primäre Nutzer-ID zurück. |
ProcessInfo
|
getProcessByName(String processName)
Die Hilfsmethode führt die Befehle "pidof" und "stat" aus und gibt das Objekt |
String
|
getProcessPid(String process)
Gibt die PID des Dienstes oder null zurück, wenn ein Fehler aufgetreten ist. |
String
|
getProductType()
Eine praktische Methode, um den Produkttyp dieses Geräts zu ermitteln. |
String
|
getProductVariant()
Eine praktische Methode, um die Produktvariante dieses Geräts abzurufen. |
String
|
getProperty(String name)
Ruft den angegebenen Attributwert vom Gerät ab. |
ITestDevice.RecoveryMode
|
getRecoveryMode()
Ruft den aktuellen Wiederherstellungsmodus ab, der für das Gerät verwendet wird. |
InputStreamSource
|
getScreenshot(long displayId)
Erstellt einen Screenshot von der angegebenen Anzeige-ID des Geräts. |
InputStreamSource
|
getScreenshot(String format)
Erstellt einen Screenshot auf dem Gerät. |
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Erstellt einen Screenshot auf dem Gerät. |
InputStreamSource
|
getScreenshot()
Erstellt einen Screenshot auf dem Gerät. |
String
|
getSerialNumber()
Eine praktische Methode, um die Seriennummer dieses Geräts zu erhalten. |
String
|
getSetting(int userId, String namespace, String key)
Gibt den Wert der angeforderten Einstellung zurück. |
String
|
getSetting(String namespace, String key)
Siehe |
String
|
getSimOperator()
Geben Sie den SIM-Kartenanbieter zurück oder „null“, wenn dieser nicht verfügbar ist oder das Gerät nicht verfügbar ist. |
String
|
getSimState()
Gib den Status der SIM-Karte zurück oder „null“, wenn sie nicht verfügbar ist oder das Gerät nicht verfügbar ist. |
|
getTombstones()
Liste der Tombstones von den Geräten abrufen und zurückgeben. |
long
|
getTotalMemory()
Gibt die Gesamtgröße des physischen Arbeitsspeichers in Byte oder -1 bei einem internen Fehler zurück. |
String
|
getTrackingSerial()
Rufen Sie für die Geräteverwaltung die Seriennummer ab, die zum Nachverfolgen des Geräts verwendet wird. |
|
getUninstallablePackageNames()
Rufen Sie die App-Paketnamen ab, die deinstalliert werden können. |
boolean
|
getUseFastbootErase()
Ermitteln Sie, ob Sie „fastboot erase“ oder „fastboot format“ verwenden müssen, um eine Partition auf dem Gerät zu löschen. |
int
|
getUserFlags(int userId)
Die Markierungen eines bestimmten Nutzers finden und zurückgeben. |
|
getUserInfos()
Ruft die Zuordnung von „useId“ zu „ |
int
|
getUserSerialNumber(int userId)
Gibt die Seriennummer zurück, die mit der userId verknüpft ist, falls gefunden, andernfalls -10000. |
IManagedTestDevice.DeviceEventResponse
|
handleAllocationEvent(DeviceEvent event)
Verarbeite das angegebene DeviceEvent. Verarbeite das DeviceEvent, wodurch dieses Gerät möglicherweise in einen neuen Zuweisungsstatus übergeht. |
boolean
|
hasFeature(String feature)
Prüfen, ob eine Funktion auf einem Gerät verfügbar ist |
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Installieren Sie ein Android-Paket auf dem Gerät. |
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Installieren Sie ein Android-Paket auf dem Gerät. |
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer |
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer |
void
|
invalidatePropertyCache()
|
boolean
|
isAdbRoot()
|
boolean
|
isAdbTcp()
|
boolean
|
isAppEnumerationSupported()
Prüfen, ob die Plattform auf dem Gerät die App-Aufzählung unterstützt |
boolean
|
isBypassLowTargetSdkBlockSupported()
Prüfen, ob die Plattform auf dem Gerät das Umgehen eines niedrigen SDK-Zielblocks bei App-Installationen unterstützt |
boolean
|
isDebugfsMounted()
Prüfen Sie, ob debugfs bereitgestellt ist. |
boolean
|
isDeviceEncrypted()
Gibt an, ob das Gerät verschlüsselt ist. |
boolean
|
isDirectory(String path)
Gibt „True“ zurück, wenn der Pfad auf dem Gerät ein Verzeichnis ist, andernfalls „False“. |
boolean
|
isEnableAdbRoot()
|
boolean
|
isEncryptionSupported()
Gibt zurück, wenn die Verschlüsselung auf dem Gerät unterstützt wird. |
boolean
|
isExecutable(String fullPath)
Gibt „True“ zurück, wenn der Dateipfad auf dem Gerät eine ausführbare Datei ist, andernfalls „False“. |
boolean
|
isFastbootEnabled()
Gehen Sie zurück, wenn Fastboot für das Gerät verfügbar ist. |
boolean
|
isHeadless()
Gibt „true“ zurück, wenn das Gerät monitorlos ist (kein Bildschirm), andernfalls „false“. |
boolean
|
isHeadlessSystemUserMode()
Gibt an, ob auf dem Gerät der headless Systemnutzermodus verwendet wird. |
boolean
|
isMainUserPermanentAdmin()
Gibt an, ob der Hauptnutzer ein dauerhafter Administrator ist und nicht gelöscht oder auf den Status „Kein Administrator“ herabgestuft werden kann. |
boolean
|
isMultiUserSupported()
Bestimmt, ob die Nutzung durch mehrere Nutzer unterstützt wird. |
boolean
|
isPackageInstalled(String packageName, String userId)
Das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID abfragen, um zu prüfen, ob es für diesen Nutzer derzeit installiert ist oder nicht. |
boolean
|
isPackageInstalled(String packageName)
Fragen Sie das Gerät nach einem bestimmten Paketnamen ab, um zu prüfen, ob es derzeit installiert ist. |
boolean
|
isRuntimePermissionSupported()
Prüfen, ob die Plattform auf dem Gerät die Gewährung von Laufzeitberechtigungen unterstützt |
boolean
|
isStateBootloaderOrFastbootd()
Gibt „wahr“ zurück, wenn sich das Gerät in |
boolean
|
isUserRunning(int userId)
Prüfen, ob ein bestimmter Nutzer ausgeführt wird |
boolean
|
isUserSecondary(int userId)
Gibt zurück, ob der angegebene Nutzer gemäß seinen Flags ein sekundärer Nutzer ist. |
boolean
|
isUserVisible(int userId)
Prüft, ob der angegebene Nutzer sichtbar ist. |
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Prüft, ob der angegebene Nutzer im angegebenen Display sichtbar ist. |
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Gibt an, ob Nutzer auf dem Gerät im |
boolean
|
isVisibleBackgroundUsersSupported()
Gibt an, ob Nutzer auf dem Gerät im Hintergrund gestartet werden können. |
boolean
|
isWifiEnabled()
Teste, ob WLAN aktiviert ist. |
|
listDisplayIds()
Liste der verfügbaren Display-IDs auf dem Gerät erfassen, wie von „dumpsys SurfaceFlinger“ gemeldet |
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Ruft die Liste der Bildschirme ab, die zum |
|
listUsers()
Ruft die Liste der Nutzer auf dem Gerät ab. |
boolean
|
logAnrs(ITestLogger logger)
Erfasst und protokolliert ANRs auf dem Gerät. |
boolean
|
logBugreport(String dataName, ITestLogger listener)
Hilfsmethode, um einen Fehlerbericht zu erstellen und an die Meldenden zu senden. |
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
Eine Nachricht im Logcat des Geräts protokollieren |
void
|
mountDebugfs()
debugfs bereitstellen |
void
|
nonBlockingReboot()
Gibt einen Befehl zum Neustarten des Geräts aus und gibt nach Abschluss des Befehls und wenn das Gerät für adb nicht mehr sichtbar ist, zurück. |
void
|
postAdbRootAction()
Überschreibt, wenn für das Gerät bestimmte Aktionen nach dem ADB-Root und bevor das Gerät wieder online ist. |
void
|
postAdbUnrootAction()
Überschreiben Sie diese Option, wenn nach dem Entfernen des Root-Zugriffs mit adb bestimmte Aktionen auf dem Gerät ausgeführt werden müssen, bevor es wieder online ist. |
void
|
postBootSetup()
Folgen Sie der Anleitung, um das Gerät für das Testen nach jedem Start zu konfigurieren. |
void
|
postInvocationTearDown(Throwable exception)
Zusätzliche Schritte für die erforderliche gerätespezifische Bereinigung, die nach dem Aufruf ausgeführt wird. |
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
Zusätzliche Schritte für die erforderliche gerätespezifische Einrichtung, die vor dem Aufrufvorgang auf dem Gerät ausgeführt werden. |
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
Verzeichnisinhalte rekursiv vom Gerät abrufen. |
boolean
|
pullDir(String deviceFilePath, File localDir)
Verzeichnisinhalte rekursiv vom Gerät abrufen |
boolean
|
pullFile(String remoteFilePath, File localFile)
Ruft eine Datei vom Gerät ab. |
File
|
pullFile(String remoteFilePath, int userId)
Ruft eine Datei vom Gerät ab, speichert sie in einem lokalen temporären |
File
|
pullFile(String remoteFilePath)
Ruft eine Datei vom Gerät ab, speichert sie in einem lokalen temporären |
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
Ruft eine Datei vom Gerät ab. |
String
|
pullFileContents(String remoteFilePath)
Ruft eine Datei vom Gerät ab und gibt den Inhalt zurück. |
File
|
pullFileFromExternal(String remoteFilePath)
Eine praktische Methode, um eine Datei aus dem externen Speicher des Geräts abzurufen, in einem lokalen temporären |
boolean
|
pushDir(File localFileDir, String deviceFilePath,
Verzeichnisinhalte werden rekursiv auf das Gerät übertragen und gleichzeitig einige gefilterte Verzeichnisse ausgeschlossen. |
boolean
|
pushDir(File localFileDir, String deviceFilePath)
Verzeichnisinhalte rekursiv auf das Gerät übertragen. |
boolean
|
pushDir(File localFileDir, String deviceFilePath, int userId)
Verzeichnisinhalte rekursiv auf das Gerät übertragen. |
boolean
|
pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Variante von |
boolean
|
pushFile(File localFile, String remoteFilePath)
Übertragen Sie eine Datei per Push auf das Gerät. |
boolean
|
pushFile(File localFile, String remoteFilePath, int userId)
Dateien an das Gerät senden |
boolean
|
pushString(String contents, String remoteFilePath)
Aus einem String erstellte Datei an das Gerät senden |
void
|
reboot(String reason)
Startet das Gerät im ADB-Modus neu, wobei die angegebenen |
void
|
reboot()
Startet das Gerät im ADB-Modus neu. |
void
|
rebootIntoBootloader()
Das Gerät wird im Bootloader-Modus neu gestartet. |
void
|
rebootIntoFastbootd()
Startet das Gerät im Fastbootd-Modus neu. |
void
|
rebootIntoRecovery()
Das Gerät wird im ADB-Wiederherstellungsmodus neu gestartet. |
void
|
rebootIntoSideload()
Startet das Gerät im adb-Sideload-Modus neu. Hinweis: Dies ist ein spezieller Modus unter Wiederherstellung. Blockiert, bis das Gerät in den Sideload-Modus wechselt |
void
|
rebootIntoSideload(boolean autoReboot)
Startet das Gerät im adb-Sideload-Modus neu. Hinweis: Dies ist ein spezieller Modus unter Wiederherstellung. Blockiert, bis das Gerät in den Sideload-Modus wechselt |
void
|
rebootUntilOnline()
Eine Alternative zu |
void
|
rebootUntilOnline(String reason)
Eine Alternative zu |
void
|
rebootUserspace()
Startet nur den Nutzerbereich des Geräts neu. |
void
|
rebootUserspaceUntilOnline()
Eine Alternative zu |
boolean
|
recoverDevice()
Es wird versucht, die Gerätekommunikation wiederherzustellen. |
void
|
registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Registriert eine |
void
|
remountSystemReadOnly()
Machen Sie die Systempartition auf dem Gerät schreibgeschützt. |
void
|
remountSystemWritable()
Machen Sie die Systempartition auf dem Gerät beschreibbar. |
void
|
remountVendorReadOnly()
Die Anbieterpartition auf dem Gerät schreibgeschützt machen. |
void
|
remountVendorWritable()
Machen Sie die Anbieterpartition auf dem Gerät beschreibbar. |
boolean
|
removeAdmin(String componentName, int userId)
Entfernt den angegebenen Geräteadministrator beim angegebenen Nutzer und gibt |
void
|
removeOwners()
Entfernen Sie nach Möglichkeit alle vorhandenen Geräteprofileigentümer. |
boolean
|
removeUser(int userId)
Einen bestimmten Nutzer vom Gerät entfernen. |
void
|
resetContentProviderSetup()
Setzen Sie die Markierung für die Einrichtung des Contentanbieters zurück, um ihn noch einmal auszulösen. |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Diese praktische Methode führt |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
Führt Instrumentierungstests aus und bietet die Gerätewiederherstellung. |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
Entspricht |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Entspricht |
void
|
setConfiguration(IConfiguration configuration)
Fügt den verwendeten |
final
void
|
setConnectionAvdInfo(GceAvdInfo avdInfo)
|
void
|
setDate(Date date)
Datum auf dem Gerät festlegen Hinweis: Zum Festlegen des Datums auf dem Gerät ist Root-Zugriff erforderlich. |
boolean
|
setDeviceOwner(String componentName, int userId)
Eine Geräteadministratorkomponente als Geräteinhaber für den angegebenen Nutzer festlegen |
void
|
setDeviceState(TestDeviceState deviceState)
Aktualisieren Sie den Status des Geräts. |
void
|
setEmulatorOutputStream(SizeLimitedOutputStream output)
Für den Emulator |
void
|
setEmulatorProcess(Process p)
Legt den Wert für |
void
|
setFastbootEnabled(boolean fastbootEnabled)
Legen Sie die Fastboot-Option für das Gerät fest. |
void
|
setFastbootPath(String fastbootPath)
Legt den Pfad zum zu verwendenden Fastboot-Binärprogramm fest. |
void
|
setIDevice(IDevice newDevice)
Aktualisieren Sie das mit diesem ITestDevice verknüpfte IDevice. |
void
|
setLogStartDelay(int delay)
Legt die Zeit in Millisekunden fest, die gewartet werden soll, bevor die Logcat-Aufzeichnung für ein online verfügbares Gerät gestartet wird. |
void
|
setOptions(TestDeviceOptions options)
|
boolean
|
setProperty(String propKey, String propValue)
Legt den angegebenen Property-Wert auf dem Gerät fest. |
void
|
setRecovery(IDeviceRecovery recovery)
Legen Sie die |
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
Legen Sie den aktuellen Wiederherstellungsmodus für das Gerät fest. |
void
|
setSetting(String namespace, String key, String value)
Siehe |
void
|
setSetting(int userId, String namespace, String key, String value)
Dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzufügen. |
void
|
setTestLogger(ITestLogger testLogger)
|
void
|
setTrackingSerial(String trackingSerial)
Für die Geräteverwaltung die Seriennummer erfassen, die wir für die Referenzierung des Geräts verwenden. |
void
|
setUseFastbootErase(boolean useFastbootErase)
Legen Sie fest, ob Sie „fastboot erase“ oder „fastboot format“ verwenden möchten, um eine Partition auf dem Gerät zu löschen. |
void
|
startLogcat()
Starten Sie die Erfassung der Logcat-Ausgabe vom Gerät im Hintergrund. |
boolean
|
startUser(int userId)
Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist. |
boolean
|
startUser(int userId, boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, wenn er aktuell beendet ist. |
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, der auf dem entsprechenden Display sichtbar ist (d.h., der Nutzer kann Aktivitäten auf diesem Display starten). |
void
|
stopEmulatorOutput()
Schließen und löschen Sie die Emulatorausgabe. |
void
|
stopLogcat()
Die Erfassung der Logcat-Ausgabe vom Gerät wird beendet und die derzeit gespeicherten Logcat-Daten werden verworfen. |
boolean
|
stopUser(int userId)
Stoppt einen bestimmten Nutzer. |
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Stoppen Sie einen bestimmten Nutzer. |
String
|
switchToAdbTcp()
Stellen Sie das Gerät auf den adb-over-tcp-Modus um. |
boolean
|
switchToAdbUsb()
Stellen Sie das Gerät auf den Modus „adb over USB“ um. |
boolean
|
switchUser(int userId)
Wechseln Sie zu einer anderen userId mit einer Standardzeitüberschreitung. |
boolean
|
switchUser(int userId, long timeout)
Wechseln Sie zu einer anderen Nutzer-ID mit dem angegebenen Zeitlimit als Frist. |
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
Der Inhalt eines lokalen Dateiverzeichnisses wird inkrementell mit dem Gerät synchronisiert. |
Bugreport
|
takeBugreport()
Erstellen Sie einen Fehlerbericht und geben Sie ihn in einem |
String
|
uninstallPackage(String packageName)
Deinstallation eines Android-Pakets vom Gerät |
String
|
uninstallPackageForUser(String packageName, int userId)
Deinstallation eines Android-Pakets von einem Gerät für einen bestimmten Nutzer |
boolean
|
unlockDevice()
Entsperret das Gerät, wenn es verschlüsselt ist. |
void
|
unmountDebugfs()
Entfernen Sie die Bereitstellung von debugfs. |
boolean
|
waitForBootComplete(long timeOut)
Blockiert, bis das Flag „Boot complete“ des Geräts gesetzt ist. |
boolean
|
waitForDeviceAvailable()
Wartet, bis das Gerät reagiert und für den Test verfügbar ist. |
boolean
|
waitForDeviceAvailable(long waitTime)
Wartet, bis das Gerät reagiert und für den Test verfügbar ist. |
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
Wartet, bis das Gerät reagiert und verfügbar ist, ohne den Wiederherstellungspfad zu berücksichtigen. |
void
|
waitForDeviceBootloader()
Blockiert, bis das Gerät über Fastboot sichtbar ist. |
boolean
|
waitForDeviceInRecovery(long waitTime)
Blöcke für das Gerät, die sich im Status „ADB-Wiederherstellung“ befinden. Beachten Sie, dass dies nicht mit |
boolean
|
waitForDeviceInSideload(long waitTime)
Verhindert, dass sich das Gerät im Status „adb sideload“ befindet |
boolean
|
waitForDeviceNotAvailable(long waitTime)
Blockiert, dass das Gerät nicht verfügbar ist, d. h. nicht in adb vorhanden ist |
void
|
waitForDeviceOnline()
Blockiert, bis das Gerät über adb sichtbar ist. |
void
|
waitForDeviceOnline(long waitTime)
Blockiert, bis das Gerät über adb sichtbar ist. |
boolean
|
waitForDeviceShell(long waitTime)
Wartet, bis das Gerät auf einen einfachen adb-Shell-Befehl reagiert. |
Geschützte Methoden | |
---|---|
void
|
addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
|
String[]
|
buildAdbShellCommand(String command, boolean forceExitStatusDetection)
Erstellt den Betriebssystembefehl für die angegebene ADB-Shell-Befehlssitzung und -Argumente |
void
|
checkApiLevelAgainst(String feature, int strictMinLevel)
|
NativeDevice.RebootDeviceAction
|
createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)
Erstellen Sie eine |
IRunUtil
|
createRunUtil()
|
void
|
doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)
Führen Sie einen ADB-Neustart durch. |
void
|
ensureRuntimePermissionSupported()
Hilfsmethode, um eine Ausnahme zu werfen, wenn die Laufzeitberechtigung nicht unterstützt wird |
int
|
getApiLevelSafe()
|
ITestLogger
|
getLogger()
|
IRunUtil
|
getRunUtil()
Rufen Sie die zu verwendende |
void
|
initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
|
String
|
internalGetProperty(String propName, String fastbootVar, String description)
Eine Geräteeigenschaft wird standardmäßig aus dem ddmlib-Cache abgerufen. Je nachdem, ob sich das Gerät im Fastboot-Modus befindet, wird entweder „adb shell getprop“ oder „fastboot getvar“ verwendet. |
boolean
|
isInRebootCallback()
Gibt an, ob Reboot-Callbacks derzeit ausgeführt werden. |
boolean
|
isNewer(File localFile, IFileEntry entry)
Gibt |
void
|
notifyRebootEnded()
Alle |
void
|
notifyRebootStarted()
Alle |
boolean
|
performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Dadurch wird eine Aktion auf diesem Gerät ausgeführt. |
void
|
postAdbReboot()
Mögliche zusätzliche Aktionen, die nach einem Neustart ausgeführt werden können. |
void
|
prePostBootSetup()
Damit kann jeder Gerätetyp (AndroidNativeDevice, TestDevice) diese Methode für eine bestimmte Einrichtung nach dem Booten überschreiben. |
boolean
|
pullFileInternal(String remoteFilePath, File localFile)
|
void
|
setClock(Clock clock)
Legen Sie die zu verwendende Uhren-Instanz fest. |
void
|
setMicrodroidProcess(Process process)
Kennzeichnet das Testgerät als Microdroid und legt seine CID fest. |
void
|
setTestDeviceOptions(
|
CommandResult
|
simpleFastbootCommand(long timeout,
Führt einen einfachen Fastboot-Befehl mit Umgebungsvariablen aus und meldet den Status des Befehls. |
CommandResult
|
simpleFastbootCommand(long timeout, String[] fullCmd)
Führt einen einfachen Fastboot-Befehl aus und meldet den Status des Befehls. |
boolean
|
waitForDeviceNotAvailable(String operationDesc, long time)
Warten Sie, bis das Gerät nicht mehr verfügbar ist (keine Berichte mehr an adb). |
Konstanten
INVALID_USER_ID
public static final int INVALID_USER_ID
Wert, der für eine ungültige/nicht gefundene Nutzer-ID zurückgegeben wird: UserHandle hat den Wert -10000 definiert
Konstanter Wert: −10.000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
Konstanter Wert: 5.000 (0x0000000000001388)
MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
die Standardanzahl der Wiederholungsversuche für Befehle
Konstanter Wert: 2 (0x00000002)
Felder
DEBUGFS_PATH
public static final String DEBUGFS_PATH
SD_CARD
protected static final String SD_CARD
STORAGE_EMULATED
protected static final String STORAGE_EMULATED
Öffentliche Konstruktoren
NativeDevice
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Erstellt einen TestDevice
.
Parameter | |
---|---|
device |
IDevice : die zugehörige IDevice |
stateMonitor |
IDeviceStateMonitor : der zu verwendende IDeviceStateMonitor -Mechanismus |
allocationMonitor |
IDeviceMonitor : die IDeviceMonitor , um über Änderungen des Zuweisungsstatus zu informieren.
Kann null sein |
Öffentliche Methoden
BatchPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
Mikrooptimierung (ca. 400 Millisekunden) durch Vorab-Abrufen aller benötigten Props, anstatt für jede einzelne „adb getprop“ aufzurufen. Das Abrufen aller Properties ist also genauso schnell wie das Abrufen einer einzelnen. Dinge wie device.getApiLevel(), checkApiLevelAgainstNextRelease und getBuildAlias rufen alle im Hintergrund „adb getprop“ auf. Wir holen sie in einem Aufruf ab und rufen NativeDevice.setProperty auf. Auch wenn wir dies nicht tun, ruft NativeDevice selbst setProperty auf und speichert das Ergebnis für zukünftige Aufrufe im Cache. Wir führen sie nur etwas früher durch. Wenn sich das Gerät im Wiederherstellungsmodus befindet oder es andere Fehler beim Abrufen der Props gibt, werden sie einfach ignoriert.
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Gibt an, ob der Wechsel zum headless SYSTEM-Nutzer zulässig ist.
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
checkApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Prüfen, ob eine Funktion derzeit unterstützt wird, wenn ein Mindestsupportlevel vorhanden ist Bei dieser Methode werden noch nicht veröffentlichte Funktionen berücksichtigt, bevor die API-Ebene erhöht wird.
Parameter | |
---|---|
strictMinLevel |
int : Die strikte Mindeststufe, die die Funktion unterstützt. |
Returns | |
---|---|
boolean |
„True“, wenn das Level unterstützt wird. Andernfalls „false“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Verbindung prüfen
public boolean checkConnectivity ()
Prüfe, ob das Gerät eine Netzwerkverbindung hat.
Returns | |
---|---|
boolean |
true , wenn das Gerät eine funktionierende Netzwerkverbindung hat, false andernfalls. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
ClearErrorDialogs
public boolean clearErrorDialogs ()
Schließen Sie alle Fehlerdialogfelder, die derzeit auf der Geräteoberfläche angezeigt werden.
Returns | |
---|---|
boolean |
true , wenn keine Dialogfelder vorhanden waren oder die Dialogfelder erfolgreich gelöscht wurden.
Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
clearLastConnectedWifiNetwork
public void clearLastConnectedWifiNetwork ()
Das zuletzt verbundene WLAN wird gelöscht. Diese Funktion sollte beim Starten einer neuen Aufrufinstanz aufgerufen werden, um zu verhindern, dass nach dem Neustart des Geräts eine Verbindung zum WLAN hergestellt wird, das im vorherigen Test verwendet wurde.
clearLogcat
public void clearLogcat ()
Löscht alle angesammelten Logcat-Daten.
Dies ist nützlich, wenn Sie sicherstellen möchten, dass ITestDevice#getLogcat()
nur Protokolldaten zurückgibt, die nach einem bestimmten Zeitpunkt erstellt wurden (z. B. nach dem Flashen eines neuen Gerätebuilds).
connectToWifiNetwork
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
Verbindet sich mit einem WLAN.
Das WLAN wird aktiviert und blockiert, bis eine Verbindung zu einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke hergestellt wurde. Sobald eine Verbindung hergestellt wurde, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice#disconnectFromWifi()
oder ITestDevice#clearLastConnectedWifiNetwork()
aufgerufen wird.
Parameter | |
---|---|
wifiSsidToPsk |
: Eine Zuordnung der WLAN-SSIDs zu Passwörtern. |
scanSsid |
boolean : Gibt an, ob nach ausgeblendeten SSIDs für dieses Netzwerk gesucht werden soll. |
Returns | |
---|---|
boolean |
true , wenn eine Verbindung zum WLAN hergestellt wurde. false
otherwise |
Ausgabe | |
---|---|
DeviceNotAvailableException |
connectToWifiNetwork
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
Verbindet sich mit einem WLAN.
Aktiviert das WLAN und blockiert es, bis eine Verbindung zum angegebenen WLAN hergestellt wurde.
Nachdem eine Verbindung hergestellt wurde, versucht die Instanz, die Verbindung nach jedem Neustart wiederherzustellen, bis ITestDevice#disconnectFromWifi()
oder ITestDevice#clearLastConnectedWifiNetwork()
aufgerufen wird.
Parameter | |
---|---|
wifiSsid |
String : das WLAN-Signal, mit dem eine Verbindung hergestellt werden soll |
wifiPsk |
String : PSK-Passphrase oder null, falls unverschlüsselt |
Returns | |
---|---|
boolean |
true , wenn eine Verbindung zum WLAN hergestellt wurde. false
andernfalls |
Ausgabe | |
---|---|
DeviceNotAvailableException |
connectToWifiNetwork
public boolean connectToWifiNetwork (wifiSsidToPsk)
Verbindet sich mit einem WLAN.
Das WLAN wird aktiviert und blockiert, bis eine Verbindung zu einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke hergestellt wurde. Sobald eine Verbindung hergestellt wurde, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice#disconnectFromWifi()
oder ITestDevice#clearLastConnectedWifiNetwork()
aufgerufen wird.
Parameter | |
---|---|
wifiSsidToPsk |
: Eine Zuordnung von WLAN-SSIDs zu Passwörtern. |
Returns | |
---|---|
boolean |
true , wenn eine Verbindung zum WLAN hergestellt wurde. false
otherwise |
Ausgabe | |
---|---|
DeviceNotAvailableException |
connectToWifiNetwork
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
Verbindet sich mit einem WLAN.
Aktiviert das WLAN und blockiert es, bis eine Verbindung zum angegebenen WLAN hergestellt wurde.
Sobald eine Verbindung hergestellt wurde, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice#disconnectFromWifi()
oder ITestDevice#clearLastConnectedWifiNetwork()
aufgerufen wird.
Parameter | |
---|---|
wifiSsid |
String : das WLAN-Signal, mit dem eine Verbindung hergestellt werden soll |
wifiPsk |
String : PSK-Passphrase oder „null“, wenn nicht verschlüsselt |
scanSsid |
boolean : Gibt an, ob nach ausgeblendeten SSIDs für dieses Netzwerk gesucht werden soll. |
Returns | |
---|---|
boolean |
true , wenn eine Verbindung zum WLAN hergestellt wurde. false
andernfalls |
Ausgabe | |
---|---|
DeviceNotAvailableException |
connectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
Eine Variante von connectToWifiNetwork(String, String)
, die nur dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.
Parameter | |
---|---|
scanSsid |
boolean : Ob nach ausgeblendeten SSIDs für dieses Netzwerk gesucht werden soll |
Returns | |
---|---|
boolean |
true , wenn eine Verbindung zum WLAN hergestellt wurde. false
andernfalls |
Ausgabe | |
---|---|
DeviceNotAvailableException |
connectToWifiNetworkIfNeeded
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
Eine Variante von connectToWifiNetwork(String, String)
, die nur dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.
Returns | |
---|---|
boolean |
true , wenn eine Verbindung zum WLAN hergestellt wurde. false
andernfalls |
Ausgabe | |
---|---|
DeviceNotAvailableException |
createUser
public int createUser (String name, boolean guest, boolean ephemeral)
Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen
Parameter | |
---|---|
name |
String : des Nutzers, der auf dem Gerät erstellt werden soll |
guest |
boolean : aktiviert das Nutzer-Flag --guest während der Erstellung. |
ephemeral |
boolean : Aktivieren Sie beim Erstellen das Nutzerflag „--ephemeral“. |
Returns | |
---|---|
int |
ID des erstellten Nutzers |
Ausgabe | |
---|---|
DeviceNotAvailableException |
createUser
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen
Parameter | |
---|---|
name |
String : des Nutzers, der auf dem Gerät erstellt werden soll |
guest |
boolean : aktiviert das Nutzer-Flag --guest während der Erstellung. |
ephemeral |
boolean : aktiviert das Nutzer-Flag „--sitzungsspezifisch“ beim Erstellen |
forTesting |
boolean : aktiviert das Test-Flag „--for-testing“ beim Erstellen |
Returns | |
---|---|
int |
ID des erstellten Nutzers |
Ausgabe | |
---|---|
DeviceNotAvailableException |
createUser
public int createUser (String name)
Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
Parameter | |
---|---|
name |
String : des Nutzers, der auf dem Gerät erstellt werden soll |
Returns | |
---|---|
int |
Die Ganzzahl für die erstellte Nutzer-ID |
Ausgabe | |
---|---|
DeviceNotAvailableException |
createUserNoThrow
public int createUserNoThrow (String name)
Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
Parameter | |
---|---|
name |
String : des Nutzers, der auf dem Gerät erstellt werden soll |
Returns | |
---|---|
int |
Die Ganzzahl für die erstellte Nutzer-ID oder -1 für einen Fehler. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
deleteFile
public void deleteFile (String deviceFilePath, int userId)
Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät.
Parameter | |
---|---|
deviceFilePath |
String : Der absolute Pfad der Datei auf dem Gerät. |
userId |
int : Die Nutzer-ID, von der aus gelöscht werden soll |
Ausgabe | |
---|---|
DeviceNotAvailableException |
deleteFile
public void deleteFile (String deviceFilePath)
Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät.
Parameter | |
---|---|
deviceFilePath |
String : Der absolute Pfad der Datei auf dem Gerät. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
deregisterDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Entfernt die registrierte IDeviceActionReceiver
.
Parameter | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : Eine IDeviceActionReceiver , die entfernt wird. |
deviceSoftRestarted
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Hilfsmethode, um zu prüfen, ob das Gerät weich gestartet wurde. Dazu wird der aktuelle Systemserver mit dem vorherigen „system_server“ ProcessInfo
verglichen. Verwende getProcessByName(String)
als Zahlungsmethode, um ProcessInfo
zu erhalten.
Parameter | |
---|---|
prevSystemServerProcess |
ProcessInfo : dem vorherigen system_server-Prozess ProcessInfo . |
Returns | |
---|---|
boolean |
true , wenn das Gerät neu gestartet wurde |
Ausgabe | |
---|---|
DeviceNotAvailableException |
deviceSoftRestartedSince
public boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Hilfsmethode, um zu prüfen, ob das Gerät seit der UTC-Zeit seit der Epoche vom Gerät und seiner ERROR(/TimeUnit)
neu gestartet wurde. Ein richtlinienbasierter Neustart bezieht sich auf einen Neustart von system_server, der nicht durch einen erzwungenen Neustart des Geräts ausgelöst wurde (z. B. angeforderter Neustart). Die aktuelle utcEpochTime des Geräts in Millisekunden kann mit der Methode getDeviceDate()
abgerufen werden.
Parameter | |
---|---|
utcEpochTime |
long : Die Gerätezeit in Sekunden seit der Epoche. |
timeUnit |
TimeUnit : die Zeiteinheit TimeUnit für die angegebene utcEpochTime. |
Returns | |
---|---|
boolean |
true , wenn das Gerät neu gestartet wurde |
Ausgabe | |
---|---|
DeviceNotAvailableException |
disableAdbRoot
public boolean disableAdbRoot ()
Deaktiviert adb root.
Wenn Sie adb root deaktivieren, wird die Verbindung des Geräts zu adb möglicherweise getrennt. Bei dieser Methode wird die Blockierung aufrechterhalten, bis das Gerät verfügbar ist.
Returns | |
---|---|
boolean |
true , wenn der Vorgang erfolgreich war. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
disableKeyguard
public void disableKeyguard ()
Es wird versucht, den Keyguard zu deaktivieren.
Warten Sie zuerst, bis die Eingabeweiterleitung bereit ist. Das geschieht ungefähr zur selben Zeit, wenn das Gerät BOOT_COMPLETE meldet, anscheinend asynchron, da die aktuelle Framework-Implementierung gelegentlich zu einer Race-Condition führt. Anschließend wird der Befehl zum Schließen von Keyguard gesendet (funktioniert nur bei nicht sicheren).
Ausgabe | |
---|---|
DeviceNotAvailableException |
disableNetworkMonitor
public boolean disableNetworkMonitor ()
Deaktiviert die Netzwerküberwachung auf dem Gerät.
Returns | |
---|---|
boolean |
true , wenn das Monitoring erfolgreich deaktiviert wurde. false
, wenn der Vorgang fehlgeschlagen ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
VonWLAN trennen
public boolean disconnectFromWifi ()
Trennen Sie die Verbindung zu einem WLAN.
Entfernt alle Netzwerke aus der Liste der bekannten Netzwerke und deaktiviert das WLAN.
Returns | |
---|---|
boolean |
true , wenn die Verbindung zum WLAN getrennt wurde. false
if disconnect failed. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
doesFileExist
public boolean doesFileExist (String deviceFilePath, int userId)
Hilfsmethode, um zu ermitteln, ob eine Datei auf dem Gerät für einen bestimmten Nutzer vorhanden ist.
Parameter | |
---|---|
deviceFilePath |
String : Der absolute Pfad der Datei auf dem Gerät, die geprüft werden soll. |
userId |
int : Die Nutzer-ID, anhand derer die Existenz der Datei geprüft werden soll. |
Returns | |
---|---|
boolean |
true , wenn die Datei vorhanden ist, andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
tutFileExist
public boolean doesFileExist (String deviceFilePath)
Hilfsmethode, um zu ermitteln, ob eine Datei auf dem Gerät vorhanden ist.
Parameter | |
---|---|
deviceFilePath |
String : der absolute Pfad der zu prüfenden Datei auf dem Gerät |
Returns | |
---|---|
boolean |
true , wenn die Datei vorhanden ist, andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
dumpHeap
public File dumpHeap (String process, String devicePath)
Versuchen Sie, den Heap aus dem system_server zu dumpen. Der Aufrufer ist für die Bereinigung der Dumpdatei verantwortlich.
Parameter | |
---|---|
process |
String : Der Name des Geräteprozesses, auf dem der Dumpheap ausgeführt werden soll. |
devicePath |
String : Der Pfad auf dem Gerät, unter dem der Dump abgelegt werden soll. Dies muss ein Ort sein, an dem dies gemäß den Berechtigungen zulässig ist. |
Returns | |
---|---|
File |
den ERROR(/File) , der den Bericht enthält. Null, wenn ein Fehler aufgetreten ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
enableAdbRoot
public boolean enableAdbRoot ()
Aktiviert adb root. Wenn die Einstellung „enable-root“ auf „false“ festgelegt ist, wird eine Meldung protokolliert und die Funktion wird nicht aktiviert.
Wenn Sie „adb root“ aktivieren, wird die Verbindung des Geräts zu ADB möglicherweise getrennt. Bei dieser Methode wird die Blockierung aufrechterhalten, bis das Gerät verfügbar ist.
Returns | |
---|---|
boolean |
true , wenn der Vorgang erfolgreich war. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
enableNetworkMonitor
public boolean enableNetworkMonitor ()
Aktiviert die Netzwerküberwachung auf dem Gerät.
Returns | |
---|---|
boolean |
true , wenn das Monitoring erfolgreich aktiviert wurde. false
, wenn der Vorgang fehlgeschlagen ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
executeAdbCommand
public String executeAdbCommand (long timeout, String... cmdArgs)
Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.
Nach Möglichkeit sollte executeShellCommand(String)
verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.
Parameter | |
---|---|
timeout |
long : die Zeit in Millisekunden, nach der das Gerät als nicht antwortend eingestuft wird, 0L für keinen Zeitüberschreitung |
cmdArgs |
String : der adb-Befehl und die Argumente, die ausgeführt werden sollen |
Returns | |
---|---|
String |
den stdout aus dem Befehl. null , wenn die Ausführung des Befehls fehlgeschlagen ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
executeAdbCommand
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.
Verwenden Sie stattdessen nach Möglichkeit executeShellCommand(String)
, da diese Methode eine bessere Fehlererkennung und Leistung bietet.
Parameter | |
---|---|
timeout |
long : die Zeit in Millisekunden, nach der das Gerät als nicht antwortend eingestuft wird, 0L für keinen Zeitüberschreitung |
envMap |
: Umgebung, die für den Befehl festgelegt werden soll |
cmdArgs |
String : der adb-Befehl und die Argumente, die ausgeführt werden sollen |
Returns | |
---|---|
String |
den stdout aus dem Befehl. null , wenn die Ausführung des Befehls fehlgeschlagen ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
executeAdbCommand
public String executeAdbCommand (String... cmdArgs)
Hilfsmethode, die einen adb-Befehl als Systembefehl ausführt.
Verwenden Sie stattdessen nach Möglichkeit executeShellCommand(String)
, da diese Methode eine bessere Fehlererkennung und Leistung bietet.
Parameter | |
---|---|
cmdArgs |
String : der adb-Befehl und die Argumente, die ausgeführt werden sollen |
Returns | |
---|---|
String |
den stdout aus dem Befehl. null , wenn die Ausführung des Befehls fehlgeschlagen ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
executeFastbootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
Hilfsmethode, die einen Fastboot-Befehl als Systembefehl mit einem Standardzeitlimit von 2 Minuten ausführt.
Kann verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus (Fastboot mode) befindet.
Parameter | |
---|---|
cmdArgs |
String : der Fastboot-Befehl und die zugehörigen Argumente |
Returns | |
---|---|
CommandResult |
das CommandResult-Element mit der Ausgabe des Befehls |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Schnellstart-Befehl ausführen
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
Hilfsmethode, die einen Fastboot-Befehl als Systembefehl ausführt.
Wird verwendet, wenn sich das Gerät bereits im Fastboot-Modus befindet.
Parameter | |
---|---|
timeout |
long : die Zeit in Millisekunden, nach der der Befehl abläuft |
cmdArgs |
String : der Fastboot-Befehl und die auszuführenden Argumente |
Returns | |
---|---|
CommandResult |
das CommandResult-Element mit der Ausgabe des Befehls |
Ausgabe | |
---|---|
DeviceNotAvailableException |
LongFastbootCommand ausführen
public CommandResult executeLongFastbootCommand (String... cmdArgs)
Hilfsmethode, die einen lang laufenden Fastboot-Befehl als Systembefehl ausführt.
Identisch mit executeFastbootCommand(String)
, mit Ausnahme einer längeren Zeitüberschreitung.
Parameter | |
---|---|
cmdArgs |
String : der Fastboot-Befehl und die zugehörigen Argumente |
Returns | |
---|---|
CommandResult |
das CommandResult-Element mit der Ausgabe des Befehls |
Ausgabe | |
---|---|
DeviceNotAvailableException |
executeLongFastbootCommand
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
Hilfsmethode, die einen lang laufenden Fastboot-Befehl als Systembefehl mit Systemumgebungsvariablen ausführt.
Identisch mit executeFastbootCommand(String)
, mit Ausnahme einer längeren Zeitüberschreitung.
Parameter | |
---|---|
envVarMap |
: die Systemumgebungsvariablen, mit denen der Fastboot-Befehl ausgeführt wird |
cmdArgs |
String : der Fastboot-Befehl und die zugehörigen Argumente |
Returns | |
---|---|
CommandResult |
das CommandResult-Element mit der Ausgabe des Befehls |
Ausgabe | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public String executeShellCommand (String command)
Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ausgabe als String
zurückgibt.
Parameter | |
---|---|
command |
String : der auszuführende adb-Shell-Befehl |
Returns | |
---|---|
String |
die Shell-Ausgabe |
Ausgabe | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.
Parameter | |
---|---|
command |
String : der auszuführende adb-Shell-Befehl |
receiver |
IShellOutputReceiver : IShellOutputReceiver , an das die Shell-Ausgabe weitergeleitet werden soll. |
maxTimeToOutputShellResponse |
long : Die maximale Zeitspanne, während der der Befehl keine Antwort ausgeben darf. Einheit wie in timeUnit angegeben. |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int : Die maximale Anzahl der Wiederholungen, die ein Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn retryAttempts ohne Erfolg ausgeführt wird. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.
Parameter | |
---|---|
command |
String : der auszuführende adb-Shell-Befehl |
receiver |
IShellOutputReceiver : IShellOutputReceiver , an den die Shell-Ausgabe weitergeleitet werden soll. |
maxTimeoutForCommand |
long : Die maximale Zeitüberschreitung für den Befehl, Einheit wie in timeUnit angegeben. |
maxTimeToOutputShellResponse |
long : Die maximale Zeitspanne, während der der Befehl keine Antwort ausgeben darf. Einheit wie in timeUnit angegeben. |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int : Die maximale Anzahl der Wiederholungen, die ein Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn retryAttempts ohne Erfolg ausgeführt wird. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
executeShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver)
Führt den angegebenen adb-Shell-Befehl aus und versucht bei einem Fehler mehrmals, ihn auszuführen.
Eine einfachere Form von executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
mit Standardwerten.
Parameter | |
---|---|
command |
String : der auszuführende adb-Shell-Befehl |
receiver |
IShellOutputReceiver : IShellOutputReceiver , an das die Shell-Ausgabe weitergeleitet werden soll. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd)
Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als CommandResult
zurückgibt, die korrekt mit dem Befehlsstatus, stdout und stderr ausgefüllt ist.
Parameter | |
---|---|
cmd |
String : Der Befehl, der ausgeführt werden soll. |
Returns | |
---|---|
CommandResult |
Das Ergebnis in CommandResult . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als CommandResult
zurückgibt, die korrekt mit der Befehlsstatusausgabe und stderr ausgefüllt ist. stdout wird an den angegebenen Stream weitergeleitet.
Parameter | |
---|---|
cmd |
String : Der Befehl, der ausgeführt werden soll. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , an das die Standardausgabe weitergeleitet wird, oder null. |
Returns | |
---|---|
CommandResult |
Das Ergebnis in CommandResult . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als CommandResult
zurückgibt, die korrekt mit dem Befehlsstatus, stdout und stderr ausgefüllt ist.
Parameter | |
---|---|
cmd |
String : Der Befehl, der ausgeführt werden soll. |
pipeAsInput |
File : Ein ERROR(/File) , das als Eingabe an den Befehl übergeben wird, oder „null“. |
Returns | |
---|---|
CommandResult |
Das Ergebnis in CommandResult . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.
Parameter | |
---|---|
cmd |
String : der auszuführende ADB-Shell-Befehl |
maxTimeoutForCommand |
long : Die maximale Zeitüberschreitung für den Befehl, Einheit wie in timeUnit angegeben. |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int : Die maximale Anzahl der Wiederholungen, die ein Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn retryAttempts ohne Erfolg ausgeführt wird. |
Returns | |
---|---|
CommandResult |
Ausgabe | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.
Parameter | |
---|---|
cmd |
String : der auszuführende ADB-Shell-Befehl |
maxTimeoutForCommand |
long : Die maximale Zeitüberschreitung für den Befehl, Einheit wie in timeUnit angegeben. |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
Returns | |
---|---|
CommandResult |
Ausgabe | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.
Parameter | |
---|---|
cmd |
String : der auszuführende ADB-Shell-Befehl |
pipeAsInput |
File : Ein ERROR(/File) , das als Eingabe an den Befehl übergeben wird, oder „null“. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , an die die Standardausgabe weitergeleitet wird, oder null. |
maxTimeoutForCommand |
long : das maximale Zeitlimit für die Ausführung des Befehls; die Einheit gemäß timeUnit . |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int : Die maximale Anzahl der Wiederholungen, die ein Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn retryAttempts ohne Erfolg ausgeführt wird. |
Returns | |
---|---|
CommandResult |
Ausgabe | |
---|---|
DeviceNotAvailableException |
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit weiteren Parametern aus, um das Befehlsverhalten zu steuern.
Parameter | |
---|---|
cmd |
String : der auszuführende adb-Shell-Befehl |
pipeAsInput |
File : Ein ERROR(/File) , das als Eingabe an den Befehl übergeben wird, oder „null“. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , an das die Standardausgabe weitergeleitet wird, oder null. |
pipeToError |
OutputStream : ERROR(/OutputStream) , an das der Standardfehler weitergeleitet wird, oder null. |
maxTimeoutForCommand |
long : Die maximale Zeitüberschreitung für den Befehl, Einheit wie in timeUnit angegeben. |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int : Die maximale Anzahl der Wiederholungen, die ein Befehl ausführen soll, wenn er aufgrund einer Ausnahme fehlschlägt. Die Ausnahme „DeviceNotResponsiveException“ wird geworfen, wenn retryAttempts ohne Erfolg ausgeführt wird. |
Returns | |
---|---|
CommandResult |
Ausgabe | |
---|---|
DeviceNotAvailableException |
fastbootWipePartition
public CommandResult fastbootWipePartition (String partition)
Hilfsmethode zum Löschen einer Partition für das Gerät.
Wenn getUseFastbootErase()
true
ist, wird die Partition mit „fastboot erase“ gelöscht. Das Gerät muss dann beim nächsten Start ein Dateisystem erstellen.
Andernfalls wird „fastboot format“ verwendet, wodurch ein neues Dateisystem auf dem Gerät erstellt wird.
Wird verwendet, wenn sich das Gerät bereits im Fastboot-Modus befindet.
Parameter | |
---|---|
partition |
String : die zu löschende Partition |
Returns | |
---|---|
CommandResult |
das CommandResult-Element mit der Ausgabe des Befehls |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getActiveApexes
publicgetActiveApexes ()
Ruft die Informationen zu den auf dem Gerät aktivierten APEX-Objekten ab.
Returns | |
---|---|
|
Derzeit sind ERROR(/Set) von ApexInfo auf dem Gerät aktiviert |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getAllSettings
publicgetAllSettings (String namespace)
Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück.
Parameter | |
---|---|
namespace |
String : Muss eine der folgenden Optionen sein: {"system", "secure", "global"} |
Returns | |
---|---|
|
die Zuordnung von Schlüssel/Wert-Paaren. Null, wenn der Namespace nicht unterstützt wird. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getAllocationState
public DeviceAllocationState getAllocationState ()
Gibt den aktuellen Zuweisungsstatus des Geräts zurück
Returns | |
---|---|
DeviceAllocationState |
getAndroidId (GetAndroid-ID)
public String getAndroidId (int userId)
Sucht nach der mit einer userId verknüpften Android-ID und gibt sie zurück. Wenn sie nicht gefunden wird, null.
Parameter | |
---|---|
userId |
int |
Returns | |
---|---|
String |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getAndroidIds
publicgetAndroidIds ()
Erstellen Sie eine Karte mit Android-IDs, die mit Nutzer-IDs übereinstimmen. Es kann nicht garantiert werden, dass für jede User-ID eine Android-ID gefunden wird, die mit dieser Funktion verknüpft ist. Daher kann es sein, dass einige User-IDs mit „null“ übereinstimmen.
Returns | |
---|---|
|
Zuordnung von Android-IDs zu Nutzer-IDs. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getApiLevel
public int getApiLevel ()
Rufe die API-Ebene des Geräts ab. Die Standardeinstellung ist UNKNOWN_API_LEVEL
.
Returns | |
---|---|
int |
eine Ganzzahl, die das API-Level des Geräts angibt |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Informationen zu einem auf dem Gerät installierten Paket abrufen
Parameter | |
---|---|
packageName |
String |
Returns | |
---|---|
PackageInfo |
PackageInfo oder null , wenn keine Informationen abgerufen werden konnten |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getAppPackageInfos (App-Paketinformationen abrufen)
publicgetAppPackageInfos ()
Ruft Informationen zu auf dem Gerät installierten Paketen ab.
Returns | |
---|---|
|
ERROR(/List) von PackageInfo auf dem Gerät installiert. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getBasebandVersion
public String getBasebandVersion ()
Diese Methode ist praktisch, um die Baseband-Version (Funkschnittstelle) dieses Geräts abzurufen. Das Abrufen der Radioversion ist gerätespezifisch, sodass möglicherweise nicht für alle Geräte die richtigen Informationen zurückgegeben werden. Diese Methode benötigt die Eigenschaft „gsm.version.baseband“, um die richtigen Versionsinformationen zurückzugeben.
Bei einigen CDMA-Geräten ist das nicht korrekt. Die hier zurückgegebene Version stimmt möglicherweise nicht mit der von Fastboot gemeldeten Version überein und ist möglicherweise nicht die Version für das CDMA-Funkmodul.
Zusammenfassung: Mit dieser Methode wird nur dann die korrekte Version erfasst, wenn die Property „gsm.version.baseband“ mit der von fastboot getvar version-baseband
zurückgegebenen Version übereinstimmt.
Returns | |
---|---|
String |
die String -Baseband-Version oder null , wenn diese nicht ermittelt werden kann (Gerät hat keine Funkschnittstelle oder der Versionsstring kann nicht gelesen werden) |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getBattery
public Integer getBattery ()
Gibt den aktuellen Akkustand eines Geräts oder Null zurück, wenn der Akkustand nicht verfügbar ist.
Returns | |
---|---|
Integer |
getBooleanProperty
public boolean getBooleanProperty (String name, boolean defaultValue)
Gibt den booleschen Wert der angegebenen Property zurück.
Parameter | |
---|---|
name |
String : der Name der Property |
defaultValue |
boolean : Standardwert, der zurückgegeben wird, wenn das Attribut leer oder nicht vorhanden ist. |
Returns | |
---|---|
boolean |
true , wenn die Property den Wert "1" , "y" , "yes" , "on" oder "true" hat, false , wenn die Property den Wert "0" , "n" , "no" , "off" , "false" oder defaultValue hat. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getBootHistory
publicgetBootHistory ()
Die Hilfsmethode erfasst die Boot-Verlaufskarte mit Bootzeit und Bootgrund.
Returns | |
---|---|
|
Zuordnung von Bootzeit (UTC-Zeit in Sekunden seit der Epoche) und Bootgrund |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getBootVerlaufSeit
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
Mit dieser Hilfsmethode wird die Boot-Verlaufskarte mit Bootzeit und Bootgrund seit dem angegebenen Zeitpunkt seit der Epoche vom Gerät und der angegebenen Zeiteinheit erfasst. Die aktuelle utcEpochTime des Geräts in Millisekunden kann mit der Methode getDeviceDate()
abgerufen werden.
Parameter | |
---|---|
utcEpochTime |
long : Die Gerätezeit seit der Epoche. |
timeUnit |
TimeUnit : die Zeiteinheit TimeUnit . |
Returns | |
---|---|
|
Zuordnung von Bootzeit (UTC-Zeit in Sekunden seit der Epoche) und Bootgrund |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public String getBootloaderVersion ()
Diese Methode ist eine praktische Möglichkeit, die Bootloader-Version dieses Geräts abzurufen.
Es wird versucht, die Bootloaderversion aus dem aktuellen Status des Geräts abzurufen. Wenn sich das Gerät im Fastboot-Modus befindet, wird versucht, die Version aus Fastboot abzurufen.
Returns | |
---|---|
String |
die String -Bootloaderversion oder null , falls diese nicht gefunden werden kann |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getBugreport
public InputStreamSource getBugreport ()
Ruft einen Fehlerbericht vom Gerät ab.
Die Implementierung funktioniert garantiert auch auf einem Gerät ohne SD-Karte oder wenn die SD-Karte noch nicht bereitgestellt wurde.
Returns | |
---|---|
InputStreamSource |
Ein InputStreamSource , das bei Bedarf den Inhalt des Fehlerberichts generiert. Im Falle eines Fehlers erzeugt InputStreamSource ein leeres ERROR(/InputStream) . |
getBugreportz
public InputStreamSource getBugreportz ()
Ruft einen Fehlerbericht vom Gerät ab. Der Fehlerbericht im ZIP-Format enthält den Hauptfehlerbericht und andere Protokolldateien, die für die Fehlerbehebung nützlich sind.
Nur für „adb version“ > 1.0.36 unterstützt
Returns | |
---|---|
InputStreamSource |
eine InputStreamSource der ZIP-Datei mit dem Fehlerbericht zurückgeben, andernfalls „null“. |
getBuildAlias
public String getBuildAlias ()
Rufen Sie den Alias des Builds ab, den das Gerät derzeit ausführt.
Der Build-Alias ist in der Regel ein besser lesbarer String als die Build-ID (in der Regel eine Zahl für Nexus-Builds). Die endgültige Android-Version 4.2 hat beispielsweise den Build-Alias JDQ39 und die Build-ID 573038.
Returns | |
---|---|
String |
Den Build-Alias oder Fallback auf die Build-ID, wenn diese nicht abgerufen werden konnte |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getBuildFlavor
public String getBuildFlavor ()
Ruft die Build-Variante für das Gerät ab.
Returns | |
---|---|
String |
die Build-Variante oder „null“, wenn sie nicht abgerufen werden konnte |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getBuildId
public String getBuildId ()
Ruft den Build ab, der auf dem Gerät gerade ausgeführt wird.
Returns | |
---|---|
String |
Die Build-ID oder IBuildInfo#UNKNOWN_BUILD_ID , falls sie nicht abgerufen werden konnte |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getBuildSigningKeys
public String getBuildSigningKeys ()
Gibt den Schlüsseltyp zurück, der zum Signieren des Geräte-Images verwendet wurde.
Normalerweise werden Android-Geräte mit Testschlüsseln (z. B. in AOSP) oder Release-Schlüsseln (von einzelnen Geräteherstellern gesteuert) signiert.
Returns | |
---|---|
String |
Der Signaturschlüssel, falls gefunden, andernfalls „null“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
Gibt einen im Cache gespeicherten DeviceDescriptor
zurück, wenn das Gerät zugewiesen ist. Andernfalls wird der aktuelle DeviceDescriptor
zurückgegeben.
Returns | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Gibt einen im Cache gespeicherten DeviceDescriptor
zurück, wenn das Gerät zugewiesen ist. Andernfalls wird der aktuelle DeviceDescriptor
zurückgegeben.
Parameter | |
---|---|
shortDescriptor |
boolean : Ob der Deskriptor auf die minimalen Informationen beschränkt werden soll |
Returns | |
---|---|
DeviceDescriptor |
getChildren
public String[] getChildren (String path)
Eine Alternative zur Verwendung von IFileEntry
, die aufgrund von Berechtigungen manchmal nicht funktioniert.
Parameter | |
---|---|
path |
String : Pfad auf dem Gerät, in dem die Suche ausgeführt werden soll |
Returns | |
---|---|
String[] |
String-Array, das alle Dateien in einem Pfad auf dem Gerät enthält. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getConnection
public AbstractConnection getConnection ()
Die aktuelle Verbindung, die mit dem Gerät verknüpft ist.
Returns | |
---|---|
AbstractConnection |
getContentProvider
public ContentProviderHandler getContentProvider (int userId)
Gibt ContentProviderHandler
zurück oder NULL, wenn nicht verfügbar.
Der Contentanbieter kann wiederverwendet werden, wenn er zuvor mit derselben userId
erstellt wurde.
Parameter | |
---|---|
userId |
int : die Nutzer-ID, mit der der Inhaltsanbieter initialisiert werden soll. |
Returns | |
---|---|
ContentProviderHandler |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Gibt den aktuellen Faltstatus des Geräts zurück oder „null“, wenn Probleme aufgetreten sind.
Returns | |
---|---|
DeviceFoldableState |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getCurrentUser
public int getCurrentUser ()
Gibt die ID des aktuell laufenden Nutzers zurück. Bei einem Fehler -10.000 zurückgeben.
Returns | |
---|---|
int |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getDeviceClass
public String getDeviceClass ()
Geräteklasse abrufen
Returns | |
---|---|
String |
der Geräteklasse String . |
getDeviceDate
public long getDeviceDate ()
Gibt das Datum des Geräts in Millisekunden seit der Epoche zurück.
Returns | |
---|---|
long |
Das Datum des Geräts im Epochenformat. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor,
public DeviceDescriptor getDeviceDescriptor ()
Gib ein DeviceDescriptor
aus den Geräteinformationen zurück, um Informationen dazu zu erhalten, ohne das tatsächliche Geräteobjekt zu übergeben.
Returns | |
---|---|
DeviceDescriptor |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Gib ein DeviceDescriptor
aus den Geräteinformationen zurück, um Informationen dazu zu erhalten, ohne das tatsächliche Geräteobjekt zu übergeben.
Parameter | |
---|---|
shortDescriptor |
boolean : Ob der Deskriptor auf die minimalen Informationen beschränkt werden soll |
Returns | |
---|---|
DeviceDescriptor |
getDeviceState
public TestDeviceState getDeviceState ()
Rufe den Status des Geräts ab.
Returns | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public long getDeviceTimeOffset (Date date)
Hilfsfunktion, um den Zeitunterschied zwischen dem Gerät und einem bestimmten ERROR(/Date)
zu ermitteln. Verwenden Sie die Epochenzeit intern.
Parameter | |
---|---|
date |
Date |
Returns | |
---|---|
long |
Differenz in Millisekunden |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public InputStreamSource getEmulatorOutput ()
Stream von stdout und stderr des Emulators abrufen
Returns | |
---|---|
InputStreamSource |
Emulatorausgabe |
getEmulatorProcess
public Process getEmulatorProcess ()
Geben Sie die Process
zurück, die diesem Emulator entspricht.
Returns | |
---|---|
Process |
die Process oder null |
getExecuteShellCommandLog
public final File getExecuteShellCommandLog ()
Das Protokoll, das alle executeShellCommand(String)
-Protokolle enthält.
Returns | |
---|---|
File |
getExternalStoreFreeSpace
public long getExternalStoreFreeSpace ()
Hilfsmethode zum Ermitteln des freien Speicherplatzes auf dem externen Speicher des Geräts.
Returns | |
---|---|
long |
den freien Speicherplatz in KB |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getFastbootPath
public String getFastbootPath ()
Gibt den Pfad der verwendeten Fastboot-Binärdatei zurück.
Damit Fastboot-Funktionen aktiviert werden können, muss isFastbootEnabled()
weiterhin „wahr“ sein.
Returns | |
---|---|
String |
getFastbootProductType (GetFastbootProductType)
public String getFastbootProductType ()
Diese Methode ist praktisch, um den Produkttyp dieses Geräts im Fastboot-Modus abzurufen.
Diese Methode sollte nur verwendet werden, wenn sich das Gerät im Fastboot-Modus befindet. Dies ist in diesem Fall eine etwas sicherere Variante als die generische getProductType()
-Methode, da ITestDevice weiß, dass das Gerät in den Fastboot-Modus wiederhergestellt werden kann, wenn sich das Gerät im falschen Zustand befindet oder nicht reagiert.
Returns | |
---|---|
String |
den Namen des String -Produkttyps oder null , falls er nicht ermittelt werden kann |
Ausgabe | |
---|---|
DeviceNotAvailableException |
GetFastbootProductVariant
public String getFastbootProductVariant ()
Diese Methode ist praktisch, um den Produkttyp dieses Geräts im Fastboot-Modus abzurufen.
Diese Methode sollte nur verwendet werden, wenn das Gerät im Schnellstartmodus (Fastboot mode) aktiviert sein soll. Dies ist in diesem Fall eine etwas sicherere Variante als die generische getProductType()
-Methode, da ITestDevice weiß, dass das Gerät in den Fastboot-Modus wiederhergestellt werden kann, wenn sich das Gerät im falschen Zustand befindet oder nicht reagiert.
Returns | |
---|---|
String |
den Namen des Produkttyps „String “ oder „null “, wenn er nicht ermittelt werden kann |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getFastbootSerialNumber
public String getFastbootSerialNumber ()
Gibt die Seriennummer des Fastboot-Modus zurück.
Returns | |
---|---|
String |
getFastbootVariable
public String getFastbootVariable (String variableName)
Rufen Sie den angegebenen Wert der Fastboot-Variable vom Gerät ab.
Parameter | |
---|---|
variableName |
String : den Variablennamen |
Returns | |
---|---|
String |
den Property-Wert oder null , falls er nicht vorhanden ist |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getFastbootVersion
public String getFastbootVersion ()
Gibt den Versionsstring der verwendeten Fastboot-Binärdatei zurück. Andernfalls wird „null“ zurückgegeben.
Returns | |
---|---|
String |
getFileEntry
public IFileEntry getFileEntry (String path)
Eine Referenz auf eine Remotedatei auf dem Gerät abrufen
Parameter | |
---|---|
path |
String : Der Pfad zur abzurufenden Datei. Dies kann ein absoluter Pfad oder ein Pfad relativ zu „/“ sein. Das heißt, sowohl die Syntax „/system“ als auch „system“ wird unterstützt. |
Returns | |
---|---|
IFileEntry |
IFileEntry oder null , wenn die Datei unter der angegebenen path nicht gefunden werden kann |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Inoffizieller Helfer zum Abrufen einer FileEntry
von einem nicht übergeordneten Pfad. FIXME: FileEntry-System so umstrukturieren, dass es von jedem Pfad aus verfügbar ist. (auch nicht als Root-Nutzer).
Parameter | |
---|---|
entry |
FileListingService.FileEntry : Ein FileEntry , das nicht unbedingt der Root sein muss, wie von Ddmlib gefordert. |
Returns | |
---|---|
IFileEntry |
einen FileEntryWrapper, der den FileEntry darstellt. |
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getFoldableStates
publicgetFoldableStates ()
Gibt die Liste der Status des faltbaren Geräts zurück. Kann mit „cmd device_state print-states“ abgerufen werden.
Returns | |
---|---|
|
Ausgabe | |
---|---|
DeviceNotAvailableException |
getIDevice
public IDevice getIDevice ()
Gibt einen Verweis auf die zugehörige ddmlib-IDevice
zurück.
Jedes Mal, wenn die Verbindung des Geräts zu adb getrennt und wiederhergestellt wird, kann von DDMS eine neue IDevice
zugewiesen werden. Daher sollten Aufrufer keinen Verweis auf die IDevice
speichern, da dieser Verweis möglicherweise veraltet.
Returns | |
---|---|
IDevice |
die IDevice |
getInstalledPackageNames
publicgetInstalledPackageNames ()
Ruft die Namen der Anwendungspakete auf dem Gerät ab.
Returns | |
---|---|
|
ERROR(/Set) von String Paketnamen, die momentan auf dem Gerät installiert sind. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getIntProperty
public long getIntProperty (String name, long defaultValue)
Gibt den Ganzzahlwert der angegebenen Eigenschaft vom Gerät zurück.
Parameter | |
---|---|
name |
String : der Property-Name |
defaultValue |
long : Standardwert, der zurückgegeben wird, wenn das Attribut leer ist oder nicht vorhanden ist. |
Returns | |
---|---|
long |
den Eigenschaftswert oder defaultValue , wenn die Eigenschaft leer, nicht vorhanden oder kein Ganzzahlwert ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getIpAddress
public String getIpAddress ()
Ruft die IP-Adresse des Geräts ab.
Returns | |
---|---|
String |
die IP-Adresse des Geräts oder null , wenn das Gerät keine IP-Adresse hat |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Gibt ein Objekt zurück, um den aktuellen Status des Keyguard oder null abzurufen, wenn dies nicht unterstützt wird.
Returns | |
---|---|
KeyguardControllerState |
eine KeyguardControllerState mit einem Snapshot des Status des Sperrbildschirms und gibt „Null“ zurück, wenn die Sperrbildschirmabfrage nicht unterstützt wird. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getLastExpectedRebootTimeMillis
public long getLastExpectedRebootTimeMillis ()
Gibt in Millisekunden zurück, wann die Tradefed APIs zuletzt einen Neustart ausgelöst haben, seit EPOCH von System.currentTimeMillis()
zurückgegeben wurde.
Returns | |
---|---|
long |
getLaunchApiLevel
public int getLaunchApiLevel ()
Das erste API-Level des Geräts abrufen. Die Standardeinstellung ist UNKNOWN_API_LEVEL
.
Returns | |
---|---|
int |
Eine Ganzzahl, die das erste gestartete API-Level des Geräts angibt |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getLogcat
public InputStreamSource getLogcat ()
Erfasst einen Snapshot-Stream der Logcat-Daten.
Es gibt zwei Modi:
TestDeviceOptions.getMaxLogcatDataSize()
Byte des aktuellen Inhalts der Logcat-Aufzeichnung im Hintergrund zurückgegeben.
Returns | |
---|---|
InputStreamSource |
getLogcat
public InputStreamSource getLogcat (int maxBytes)
Erfasst einen Snapshot-Stream der letzten maxBytes
gespeicherten Logcat-Daten.
Nützlich, wenn Sie häufige Snapshots der erfassten Logcat-Daten erstellen möchten, ohne den potenziellen hohen Speicherplatzbedarf für den gesamten getLogcat()
-Snapshot in Kauf nehmen zu müssen.
Parameter | |
---|---|
maxBytes |
int : Die maximale Anzahl der zurückzugebenden Daten. Sollte ein Betrag sein, der bequem in den Arbeitsspeicher passt |
Returns | |
---|---|
InputStreamSource |
getLogcatDump
public InputStreamSource getLogcatDump ()
Dump des aktuellen Logcats für das Gerät abrufen Im Gegensatz zu getLogcat()
gibt diese Methode immer einen statischen Dump des Logcat zurück.
Hat den Nachteil, dass nichts zurückgegeben wird, wenn das Gerät nicht erreichbar ist.
Returns | |
---|---|
InputStreamSource |
eine InputStreamSource der Logcat-Daten. Wenn die Erfassung von Logcat-Daten fehlschlägt, wird ein leerer Stream zurückgegeben. |
getLogcatSince
public InputStreamSource getLogcatSince (long date)
Erfasst einen Snapshot-Stream erfasster Logcat-Daten ab dem angegebenen Datum. Die Uhrzeit auf dem Gerät sollte getDeviceDate()
sein.
Parameter | |
---|---|
date |
long : Startzeit des Snapshots bis zum aktuellen Zeitpunkt in Millisekunden seit der Epoche.
(kann über 'Datum +%s' abgerufen werden) |
Returns | |
---|---|
InputStreamSource |
getMacAddress
public String getMacAddress ()
Gibt die MAC-Adresse des Geräts zurück. Wenn die Abfrage fehlschlägt, wird „null“ zurückgegeben.
Returns | |
---|---|
String |
getMainUserId
public Integer getMainUserId ()
Gibt die Hauptnutzer-ID zurück.
Returns | |
---|---|
Integer |
die userId des Hauptnutzers, falls vorhanden, andernfalls „null“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getMainlineModuleInfo
publicgetMainlineModuleInfo ()
Informationen zu den auf dem Gerät installierten Mainline-Modulen abrufen
Returns | |
---|---|
|
ERROR(/Set) von String Mainline-Modulen, die derzeit auf dem Gerät installiert sind. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfRunningUsersSupported
public int getMaxNumberOfRunningUsersSupported ()
Die maximale Anzahl der gleichzeitig unterstützten Nutzer abrufen Die Standardeinstellung ist 0.
Returns | |
---|---|
int |
eine Ganzzahl, die die Anzahl der gleichzeitig ausgeführten Nutzer angibt |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfUsersSupported
public int getMaxNumberOfUsersSupported ()
Maximal unterstützte Nutzerzahl abrufen Die Standardeinstellung ist 0.
Returns | |
---|---|
int |
eine Ganzzahl, die die Anzahl der unterstützten Nutzer angibt |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getMicrodroidProcess
public Process getMicrodroidProcess ()
Returns | |
---|---|
Process |
Gibt den Prozess der Microdroid-VM zurück. Wenn TestDevice kein Microdroid ist, wird null zurückgegeben. |
getMonitor
public IDeviceStateMonitor getMonitor ()
Gibt den mit dem Gerät verknüpften IDeviceStateMonitor
zurück.
Returns | |
---|---|
IDeviceStateMonitor |
getMountPoint
public String getMountPoint (String mountName)
Gibt einen Bereitstellungspunkt zurück.
Das Gerät wird direkt abgefragt, wenn die im Cache in IDevice
gespeicherten Informationen nicht verfügbar sind.
TODO: dieses Verhalten zu IDevice#getMountPoint(String)
verschieben
Parameter | |
---|---|
mountName |
String : der Name des Bereitstellungspunkts |
Returns | |
---|---|
String |
den Bereitstellungspunkt oder null |
getMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Gibt ein MountPointInfo
zurück, das dem angegebenen Bereitstellungspunktpfad entspricht, oder null
, wenn an diesem Pfad nichts bereitgestellt ist oder er anderweitig nicht in /proc/mounts als Bereitstellungspunkt aufgeführt ist.
Parameter | |
---|---|
mountpoint |
String |
Returns | |
---|---|
ITestDevice.MountPointInfo |
Ein ERROR(/List) von MountPointInfo mit den Informationen in „/proc/mounts“ |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getMountPointInfo
publicgetMountPointInfo ()
Gibt eine geparste Version der Informationen in /proc/mounts auf dem Gerät zurück.
Returns | |
---|---|
|
Ein ERROR(/List) von MountPointInfo mit den Informationen in „/proc/mounts“ |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getOptions
public TestDeviceOptions getOptions ()
Rufen Sie die Testoptionen für das Gerät ab.
Returns | |
---|---|
TestDeviceOptions |
TestDeviceOptions zum Testgerät. |
getPartitionFreeSpace
public long getPartitionFreeSpace (String partition)
Hilfsmethode zum Bestimmen des freien Speicherplatzes auf der Gerätepartition.
Parameter | |
---|---|
partition |
String |
Returns | |
---|---|
long |
den freien Speicherplatz in KB |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getPrimaryUserId
public Integer getPrimaryUserId ()
Gibt die primäre Nutzer-ID zurück.
Returns | |
---|---|
Integer |
die userId des Hauptnutzers, falls vorhanden, andernfalls „null“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getProcessByName
public ProcessInfo getProcessByName (String processName)
Die Hilfsmethode führt die Befehle "pidof" und "stat" aus und gibt das Objekt ProcessInfo
mit PID und Prozessstartzeit des angegebenen Prozesses zurück.
Parameter | |
---|---|
processName |
String : der String des Vorgangsnamens. |
Returns | |
---|---|
ProcessInfo |
ProcessInfo des angegebenen processName |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getProcessPid
public String getProcessPid (String process)
Gibt die Prozess-ID des Dienstes zurück oder „null“, wenn ein Fehler aufgetreten ist.
Parameter | |
---|---|
process |
String : Der String für den Prozessnamen. |
Returns | |
---|---|
String |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getProductType
public String getProductType ()
Eine praktische Methode, um den Produkttyp dieses Geräts zu ermitteln.
Diese Methode funktioniert, wenn sich das Gerät entweder im ADB- oder im Schnellstartmodus (Fastboot mode) befindet.
Returns | |
---|---|
String |
den Namen des String -Produkttyps. darf nicht null sein |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getProductVariant
public String getProductVariant ()
Eine praktische Methode, um die Produktvariante dieses Geräts abzurufen.
Diese Methode funktioniert, wenn sich das Gerät im ADB- oder Fastboot-Modus befindet.
Returns | |
---|---|
String |
den Namen der String -Produktvariante oder null , falls dieser nicht ermittelt werden kann |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getProperty
public String getProperty (String name)
Ruft den angegebenen Attributwert vom Gerät ab.
Parameter | |
---|---|
name |
String : der Name der Property |
Returns | |
---|---|
String |
den Property-Wert oder null , falls er nicht vorhanden ist |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getRecoveryMode
public ITestDevice.RecoveryMode getRecoveryMode ()
Ruft den aktuellen Wiederherstellungsmodus ab, der für das Gerät verwendet wird.
Returns | |
---|---|
ITestDevice.RecoveryMode |
den aktuellen Wiederherstellungsmodus, der für das Gerät verwendet wird. |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Erfasst einen Screenshot vom Gerät mit der angegebenen Anzeige-ID. Das Format ist PNG.
TODO: Extend the implementations above to support 'format' and 'rescale'
Parameter | |
---|---|
displayId |
long : die Anzeige-ID des Bildschirms, von dem ein Screenshot erstellt werden soll. |
Returns | |
---|---|
InputStreamSource |
einen InputStreamSource des Screenshots im Format oder null , wenn der Screenshot nicht erfolgreich war. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot (String format)
Erstellt einen Screenshot vom Gerät. Es wird empfohlen, stattdessen getScreenshot(format) mit der JPEG-Codierung für eine kleinere Größe zu verwenden.
Parameter | |
---|---|
format |
String : unterstützte PNG- und JPEG-Dateien |
Returns | |
---|---|
InputStreamSource |
InputStreamSource des Screenshots im Format oder null , wenn der Screenshot nicht erfolgreich war. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot (String format, boolean rescale)
Erstellt einen Screenshot auf dem Gerät. Wir empfehlen, stattdessen getScreenshot(String)
mit JPEG-Codierung zu verwenden, um die Größe zu verringern.
Parameter | |
---|---|
format |
String : unterstützt PNG, JPEG |
rescale |
boolean : ob der Screenshot neu skaliert werden soll, um die Größe des resultierenden Bildes zu verringern |
Returns | |
---|---|
InputStreamSource |
InputStreamSource des Screenshots im Format oder null , wenn der Screenshot nicht erfolgreich war. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot ()
Erstellt einen Screenshot vom Gerät.
Returns | |
---|---|
InputStreamSource |
einen InputStreamSource des Screenshots im PNG-Format oder null , wenn der Screenshot nicht erfolgreich war. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getSerialNumber
public String getSerialNumber ()
Eine praktische Methode, um die Seriennummer dieses Geräts zu erhalten.
Returns | |
---|---|
String |
die Seriennummer String |
getSetting
public String getSetting (int userId, String namespace, String key)
Gibt den Wert der angeforderten Einstellung zurück. namespace muss eine der folgenden Optionen sein: {"system", "secure", "global"}
Parameter | |
---|---|
userId |
int |
namespace |
String |
key |
String |
Returns | |
---|---|
String |
Der Wert, der mit dem namespace:key eines Nutzers verknüpft ist. Null, wenn nicht gefunden. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getSetting
public String getSetting (String namespace, String key)
Siehe getSetting(int, String, String)
und wird auf den Systemnutzer angewendet.
Parameter | |
---|---|
namespace |
String |
key |
String |
Returns | |
---|---|
String |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getSimOperator
public String getSimOperator ()
Geben Sie den SIM-Kartenanbieter zurück oder „null“, wenn dieser nicht verfügbar ist oder das Gerät nicht verfügbar ist.
Returns | |
---|---|
String |
getSimState
public String getSimState ()
Gib den Status der SIM-Karte zurück oder „null“, wenn sie nicht verfügbar ist oder das Gerät nicht verfügbar ist.
Returns | |
---|---|
String |
getTombstones
publicgetTombstones ()
Liste der Tombstones von den Geräten abrufen und zurückgeben. Erfordert Root-Zugriff.
Methode ist ein Best-Effort-Verfahren. Wenn ein Tombstone aus irgendeinem Grund nicht abgerufen werden kann, fehlt er in der Liste. Nur ein DeviceNotAvailableException
beendet die Methode vorzeitig.
Returns | |
---|---|
|
Eine Liste von Tombstone-Dateien, leer, wenn keine Tombstone-Datei vorhanden ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getTotalMemory
public long getTotalMemory ()
Gibt die Gesamtgröße des physischen Arbeitsspeichers in Byte zurück oder -1 bei einem internen Fehler.
Returns | |
---|---|
long |
getTrackingSerial
public String getTrackingSerial ()
Rufen Sie für die Geräteverwaltung die Seriennummer ab, die zum Nachverfolgen des Geräts verwendet wird.
Returns | |
---|---|
String |
getUninstallablePackageNames
publicgetUninstallablePackageNames ()
Rufen Sie die App-Paketnamen ab, die deinstalliert werden können. Dies wird derzeit als Nicht-Systempakete und aktualisierte Systempakete definiert.
Returns | |
---|---|
|
ERROR(/Set) der Namen von nicht deinstallierbaren String -Paketen, die derzeit auf dem Gerät installiert sind. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getUseFastbootErase
public boolean getUseFastbootErase ()
Legen Sie fest, ob eine Partition auf dem Gerät mithilfe des Fastboot-Lösch- oder Fastboot-Formats gelöscht werden soll.
Returns | |
---|---|
boolean |
true , wenn „fastboot erase“ verwendet werden soll, oder false , wenn „fastboot format“ verwendet werden soll. |
getUserFlags
public int getUserFlags (int userId)
Findet die Flags eines bestimmten Nutzers und gibt sie zurück. Flags werden im Android Open Source Project in der Klasse „android.content.pm.UserInfo“ definiert.
Parameter | |
---|---|
userId |
int |
Returns | |
---|---|
int |
die mit der angegebenen Nutzer-ID verknüpften Flags, falls gefunden, andernfalls -10000. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getUserInfos
publicgetUserInfos ()
Ruft die Zuordnung von „useId“ zu „UserInfo
“ auf dem Gerät ab. Wird DeviceRuntimeException
ausgegeben, wenn die Ausgabe des Geräts nicht wie erwartet ist.
Returns | |
---|---|
|
Die Liste der UserInfo-Objekte. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Gibt die Seriennummer zurück, die mit der userId verknüpft ist, falls gefunden, andernfalls -10000.
Parameter | |
---|---|
userId |
int |
Returns | |
---|---|
int |
Ausgabe | |
---|---|
DeviceNotAvailableException |
HandleAllocationEvent (HandleAllocationEvent)
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
Verarbeitet das angegebene DeviceEvent. Das Gerät wird möglicherweise in einen neuen Status versetzt. Informiert IDeviceMonitor
über etwaige Statusübergänge.
DeviceEvent verarbeiten, wodurch dieses Gerät möglicherweise in einen neuen Zuweisungsstatus geändert wird.
Parameter | |
---|---|
event |
DeviceEvent |
Returns | |
---|---|
IManagedTestDevice.DeviceEventResponse |
hasFeature
public boolean hasFeature (String feature)
Prüfen, ob eine Funktion auf einem Gerät verfügbar ist
Parameter | |
---|---|
feature |
String : Das Format sollte „feature: |
Returns | |
---|---|
boolean |
„True“, wenn die Funktion gefunden wird, andernfalls „false“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
Installieren Sie ein Android-Paket auf dem Gerät.
Parameter | |
---|---|
packageFile |
File : die zu installierende APK-Datei |
reinstall |
boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Returns | |
---|---|
String |
String mit einem Fehlercode oder null bei Erfolg. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Installieren Sie ein Android-Paket auf dem Gerät.
Hinweis: Diese Funktion sollte nur bei Anwendungsfällen aufgerufen werden, bei denen die Laufzeitberechtigung bei der Installation explizit gesteuert werden muss.
Parameter | |
---|---|
packageFile |
File : die zu installierende APK-Datei |
reinstall |
boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions |
boolean : ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Returns | |
---|---|
String |
String mit einem Fehlercode oder null bei Erfolg. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
installPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer
Parameter | |
---|---|
packageFile |
File : die zu installierende APK-Datei |
reinstall |
boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
userId |
int : Die Ganzzahl-Nutzer-ID, für die die Installation erfolgen soll. |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Returns | |
---|---|
String |
String mit einem Fehlercode oder null bei Erfolg. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
installPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Sie installieren ein Android-Paket für einen bestimmten Nutzer auf dem Gerät.
Hinweis: Diese Funktion sollte nur bei Anwendungsfällen aufgerufen werden, bei denen die Laufzeitberechtigung bei der Installation explizit gesteuert werden muss.
Parameter | |
---|---|
packageFile |
File : die zu installierende APK-Datei |
reinstall |
boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions |
boolean : ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen |
userId |
int : Die Ganzzahl-Nutzer-ID, für die die Installation erfolgen soll. |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Returns | |
---|---|
String |
String mit einem Fehlercode oder null bei Erfolg. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
invalidatePropertyCache
public void invalidatePropertyCache ()
isAdbTcp
public boolean isAdbTcp ()
Returns | |
---|---|
boolean |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Prüfen, ob die Plattform auf dem Gerät die App-Aufzählung unterstützt
Returns | |
---|---|
boolean |
„True“, wenn die App-Enumeration unterstützt wird, andernfalls „False“ |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isBypassLowTargetSdkBlockSupported
public boolean isBypassLowTargetSdkBlockSupported ()
Prüfen, ob die Plattform auf dem Gerät das Umgehen eines niedrigen SDK-Zielblocks bei App-Installationen unterstützt
Returns | |
---|---|
boolean |
„True“, wenn das Umgehen des Blocks für niedrige Ziel-SDKs unterstützt wird, andernfalls „False“ |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isDebugfsMounted
public boolean isDebugfsMounted ()
Prüfen Sie, ob debugfs bereitgestellt ist.
Returns | |
---|---|
boolean |
true , wenn debugfs bereitgestellt ist |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isDeviceEncrypted
public boolean isDeviceEncrypted ()
Gibt an, ob das Gerät verschlüsselt ist.
Returns | |
---|---|
boolean |
true , wenn das Gerät verschlüsselt ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isDirectory
public boolean isDirectory (String path)
Gibt „True“ zurück, wenn der Pfad auf dem Gerät ein Verzeichnis ist, andernfalls „False“.
Parameter | |
---|---|
path |
String |
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isEnableAdbRoot
public boolean isEnableAdbRoot ()
Returns | |
---|---|
boolean |
true , ob adb root auf dem Gerät aktiviert werden soll |
isEncryptionSupported
public boolean isEncryptionSupported ()
Gibt zurück, ob die Verschlüsselung auf dem Gerät unterstützt wird.
Returns | |
---|---|
boolean |
true , wenn das Gerät Verschlüsselung unterstützt. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isExecutable
public boolean isExecutable (String fullPath)
Gibt "True" zurück, wenn der Dateipfad auf dem Gerät eine ausführbare Datei ist, andernfalls "False".
Parameter | |
---|---|
fullPath |
String |
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isFastbootEnabled
public boolean isFastbootEnabled ()
Gehen Sie zurück, wenn Fastboot für das Gerät verfügbar ist.
Returns | |
---|---|
boolean |
isHeadless
public boolean isHeadless ()
Gibt „wahr“ zurück, wenn das Gerät headless (ohne Bildschirm) ist, andernfalls „falsch“.
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Gibt an, ob auf dem Gerät der headless Systemnutzermodus verwendet wird.
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Gibt zurück, ob der Hauptnutzer ein dauerhafter Administrator ist und weder gelöscht noch auf einen Nicht-Administratorstatus herabgestuft werden kann.
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isMultiUserSupported
public boolean isMultiUserSupported ()
Bestimmt, ob die Nutzung durch mehrere Nutzer unterstützt wird.
Returns | |
---|---|
boolean |
„true“, wenn mehrere Nutzer unterstützt werden, andernfalls „false“ |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isPackageInstalled
public boolean isPackageInstalled (String packageName, String userId)
Das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID abfragen, um zu prüfen, ob es für diesen Nutzer derzeit installiert ist oder nicht.
Parameter | |
---|---|
packageName |
String : Das Paket, das geprüft wird, ob es installiert ist. |
userId |
String : Die Nutzer-ID, für die geprüft wird, ob das Paket installiert ist. Wenn dieser Wert null ist, wird für den primären Nutzer null verwendet. |
Returns | |
---|---|
boolean |
„Wahr“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isPackageInstalliert
public boolean isPackageInstalled (String packageName)
Das Gerät wird nach einem bestimmten Paketnamen abgefragt, um zu prüfen, ob es derzeit installiert ist.
Parameter | |
---|---|
packageName |
String |
Returns | |
---|---|
boolean |
„Wahr“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionSupported
public boolean isRuntimePermissionSupported ()
Prüfen, ob die Plattform auf dem Gerät die Gewährung von Laufzeitberechtigungen unterstützt
Returns | |
---|---|
boolean |
„True“, wenn Laufzeitberechtigungen unterstützt werden, andernfalls „False“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public boolean isStateBootloaderOrFastbootd ()
Gibt „wahr“ zurück, wenn sich das Gerät in TestDeviceState#FASTBOOT
oder TestDeviceState.FASTBOOTD
befindet.
Returns | |
---|---|
boolean |
isUserRunning
public boolean isUserRunning (int userId)
Prüfen, ob ein bestimmter Nutzer aktiv ist
Parameter | |
---|---|
userId |
int |
Returns | |
---|---|
boolean |
„True“, wenn der Nutzer läuft, andernfalls „False“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isUserSecondary
public boolean isUserSecondary (int userId)
Gibt an, ob der angegebene Nutzer gemäß seinen Flags ein sekundärer Nutzer ist.
Parameter | |
---|---|
userId |
int |
Returns | |
---|---|
boolean |
„true“, wenn der Nutzer sekundär ist, andernfalls „false“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isUserVisible
public boolean isUserVisible (int userId)
Prüft, ob der angegebene Nutzer sichtbar ist.
Ein „sichtbarer“ Nutzer ist ein Nutzer, der mit dem „menschlichen“ Nutzer interagiert und daher Startaktivitäten starten kann (normalerweise in der Standardanzeige).
Parameter | |
---|---|
userId |
int |
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId, int displayId)
Prüft, ob der angegebene Nutzer im angegebenen Display sichtbar ist.
Ein „sichtbarer“ Nutzer ist ein Nutzer, der mit dem „menschlichen“ Nutzer interagiert und daher Aktivitäten auf diesem Display starten kann.
Parameter | |
---|---|
userId |
int |
displayId |
int |
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersOnDefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
Gibt an, ob Nutzer auf dem Gerät im ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
im Hintergrund gestartet werden können.
In diesem Fall kannst du startVisibleBackgroundUser(int, int, boolean)
aufrufen und ein Display übergeben, das von listDisplayIdsForStartingVisibleBackgroundUsers()
zurückgegeben wurde (und ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
enthalten sollte).
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersSupported
public boolean isVisibleBackgroundUsersSupported ()
Gibt an, ob Nutzer auf dem Gerät im Hintergrund gestartet werden können.
In diesem Fall könnten Sie startVisibleBackgroundUser(int, int, boolean)
aufrufen und eine von listDisplayIdsForStartingVisibleBackgroundUsers()
zurückgegebene Anzeige übergeben.
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isWifiEnabled
public boolean isWifiEnabled ()
Prüfen, ob WLAN aktiviert ist
Prüft, ob WLAN auf dem Gerät aktiviert ist. Nützlich zur Bestätigung des WLAN-Status vor Tests, die nicht mit dem WLAN durchgeführt werden sollten, z.B. Tests für mobile Daten.
Returns | |
---|---|
boolean |
true , wenn WLAN aktiviert ist. false , wenn deaktiviert |
Ausgabe | |
---|---|
DeviceNotAvailableException |
listDisplayIds
publiclistDisplayIds ()
Liste der verfügbaren Display-IDs auf dem Gerät erfassen, wie von „dumpsys SurfaceFlinger“ gemeldet
Returns | |
---|---|
|
Die Liste der Displays. Standardmäßig wird immer der Standardwert „0“ zurückgegeben. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
listDisplayIdsForStartingVisibleBackgroundUsers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
Liste der Displays abrufen, die für start a user visible in the background
verwendet werden können
Returns | |
---|---|
|
Ausgabe | |
---|---|
DeviceNotAvailableException |
Nutzer auflisten
publiclistUsers ()
Ruft die Liste der Nutzer auf dem Gerät ab. Wird DeviceRuntimeException
ausgegeben, wenn die Ausgabe vom Gerät nicht wie erwartet ist.
Returns | |
---|---|
|
die Liste der Nutzer-IDs. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
logAnrs
public boolean logAnrs (ITestLogger logger)
Erfasst und protokolliert ANRs auf dem Gerät.
Parameter | |
---|---|
logger |
ITestLogger : Ein ITestLogger zum Protokollieren der ANR-Fehler. |
Returns | |
---|---|
boolean |
„True“, wenn die Protokollierung erfolgreich war, andernfalls „false“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
logBugreport
public boolean logBugreport (String dataName, ITestLogger listener)
Hilfsmethode, um einen Fehlerbericht zu erstellen und bei den Reportern zu protokollieren.
Parameter | |
---|---|
dataName |
String ist der Name, unter dem der Fehlerbericht gemeldet wird. |
listener |
ITestLogger : Ein ITestLogger zum Protokollieren des Fehlerberichts. |
Returns | |
---|---|
boolean |
„True“, wenn die Protokollierung erfolgreich war, andernfalls „false“. |
logOnDevice
public void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Eine Nachricht im Logcat des Geräts protokollieren Dies ist ein sicherer Aufruf, der auch dann nicht fehlschlägt, wenn die Protokollierung fehlschlägt.
Parameter | |
---|---|
tag |
String : Das Tag, unter dem wir unsere Nachricht im Logcat protokollieren. |
level |
Log.LogLevel : Die Debugebene der Nachricht im Logcat. |
format |
String : Das Nachrichtenformat. |
args |
Object : Die Argumente, die über String.format() ersetzt werden sollen. |
nonBlockingReboot
public void nonBlockingReboot ()
Gibt einen Befehl zum Neustart des Geräts aus und wird zurückgegeben, wenn der Befehl abgeschlossen ist und das Gerät für ADB nicht mehr sichtbar ist.
Ausgabe | |
---|---|
DeviceNotAvailableException |
postAdbRootAction
public void postAdbRootAction ()
Überschreibt, wenn für das Gerät bestimmte Aktionen nach dem ADB-Root und bevor das Gerät wieder online ist. Die Standardimplementierung enthält keine zusätzlichen Aktionen. Es ist nicht garantiert, dass der ADB-Stamm zu diesem Zeitpunkt aktiviert ist.
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postAdbUnrootAction
public void postAdbUnrootAction ()
Überschreiben Sie diese Option, wenn nach dem Entfernen des Root-Zugriffs mit adb bestimmte Aktionen auf dem Gerät ausgeführt werden müssen, bevor es wieder online ist. Die Standardimplementierung umfasst keine zusätzlichen Aktionen. Es kann nicht garantiert werden, dass adb root in dieser Phase deaktiviert ist.
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postBootSetup
public void postBootSetup ()
Folgen Sie der Anleitung, um das Gerät für das Testen nach jedem Start zu konfigurieren.
Sollte aufgerufen werden, nachdem das Gerät vollständig gestartet/verfügbar ist
Normalerweise muss diese Methode nicht explizit aufgerufen werden, da diese Schritte bei einem Neustart automatisch ausgeführt werden sollten.
Dies kann erforderlich sein, wenn das Gerät aufgrund anderer Ereignisse neu gestartet wird, z. B. wenn ein Fastboot-Update-Befehl abgeschlossen wurde.
Ausgabe | |
---|---|
DeviceNotAvailableException |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Zusätzliche Schritte für die erforderliche gerätespezifische Bereinigung, die nach dem Aufruf ausgeführt wird.
Parameter | |
---|---|
exception |
Throwable : falls vorhanden, die letzte durch den Aufruffehler ausgelöste Ausnahme. |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Zusätzliche Schritte für die erforderliche gerätespezifische Einrichtung, die vor dem Aufrufvorgang auf dem Gerät ausgeführt werden.
Parameter | |
---|---|
info |
IBuildInfo : Die IBuildInfo des Geräts. |
attributes |
MultiMap : Die im Aufrufkontext gespeicherten Attribute |
Ausgabe | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
pullDir
public boolean pullDir (String deviceFilePath, File localDir, int userId)
Verzeichnisinhalte rekursiv vom Gerät abrufen.
Parameter | |
---|---|
deviceFilePath |
String : der absolute Dateipfad der Remote-Quelle |
localDir |
File : das lokale Verzeichnis, in das Dateien abgerufen werden sollen |
userId |
int : die Nutzer-ID, aus der Daten abgerufen werden sollen |
Returns | |
---|---|
boolean |
true , wenn die Datei erfolgreich abgerufen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
pullDir
public boolean pullDir (String deviceFilePath, File localDir)
Verzeichnisinhalte rekursiv vom Gerät abrufen.
Parameter | |
---|---|
deviceFilePath |
String : der absolute Dateipfad der Remote-Quelle |
localDir |
File : das lokale Verzeichnis, in das Dateien gezogen werden sollen |
Returns | |
---|---|
boolean |
true , wenn die Datei erfolgreich abgerufen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Pull-Datei
public boolean pullFile (String remoteFilePath, File localFile)
Ruft eine Datei vom Gerät ab.
Parameter | |
---|---|
remoteFilePath |
String : Der absolute Pfad zur Datei auf dem Gerät. |
localFile |
File : die lokale Datei, in der der Inhalt gespeichert werden soll. Wenn das Feld nicht leer ist, wird der Inhalt ersetzt. |
Returns | |
---|---|
boolean |
true , wenn die Datei erfolgreich abgerufen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath, int userId)
Ruft eine Datei vom Gerät ab, speichert sie in einer lokalen temporären ERROR(/File)
und gibt diese File
zurück.
Parameter | |
---|---|
remoteFilePath |
String : der absolute Pfad zur Datei auf dem Gerät. |
userId |
int : Die Nutzer-ID, aus der Daten abgerufen werden sollen |
Returns | |
---|---|
File |
Ein ERROR(/File) mit dem Inhalt der Gerätedatei oder null , wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem) |
Ausgabe | |
---|---|
DeviceNotAvailableException |
pullFile
public File pullFile (String remoteFilePath)
Ruft eine Datei vom Gerät ab, speichert sie in einem lokalen temporären ERROR(/File)
und gibt diesen File
zurück.
Parameter | |
---|---|
remoteFilePath |
String : Der absolute Pfad zur Datei auf dem Gerät. |
Returns | |
---|---|
File |
Ein ERROR(/File) mit dem Inhalt der Gerätedatei oder null , wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem) |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Pull-Datei
public boolean pullFile (String remoteFilePath, File localFile, int userId)
Ruft eine Datei vom Gerät ab.
Parameter | |
---|---|
remoteFilePath |
String : Der absolute Pfad zur Datei auf dem Gerät. |
localFile |
File : die lokale Datei, in der der Inhalt gespeichert werden soll. Wenn das Feld nicht leer ist, wird der Inhalt ersetzt. |
userId |
int : Die Nutzer-ID, aus der Daten abgerufen werden sollen |
Returns | |
---|---|
boolean |
true , wenn die Datei erfolgreich abgerufen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
pullFileContents
public String pullFileContents (String remoteFilePath)
Ruft eine Datei vom Gerät ab und gibt den Inhalt zurück.
Parameter | |
---|---|
remoteFilePath |
String : Der absolute Pfad zur Datei auf dem Gerät. |
Returns | |
---|---|
String |
Eine String mit dem Inhalt der Gerätedatei oder null , wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (z. B. aufgrund von Problemen mit dem Hostdateisystem) |
Ausgabe | |
---|---|
DeviceNotAvailableException |
pullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
Eine praktische Methode, um eine Datei aus dem externen Speicher des Geräts abzurufen, in einem lokalen temporären ERROR(/File)
zu speichern und einen Verweis auf diesen File
zurückzugeben.
Parameter | |
---|---|
remoteFilePath |
String : Pfad zur Datei auf dem Gerät, relativ zum Bereitstellungspunkt des externen Speichers des Geräts |
Returns | |
---|---|
File |
Eine ERROR(/File) mit dem Inhalt der Gerätedatei oder null , wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (z. B. aufgrund von Problemen mit dem Hostdateisystem) |
Ausgabe | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
Verzeichnisinhalte rekursiv auf das Gerät übertragen und dabei einige Verzeichnisse ausschließen, die gefiltert werden.
Parameter | |
---|---|
localFileDir |
File : das lokale Verzeichnis, das übertragen werden soll |
deviceFilePath |
String : der absolute Dateipfad des Remote-Ziels |
excludedDirectories |
: Liste der auszuschließenden Verzeichnisnamen, die nicht gepusht werden sollen. |
Returns | |
---|---|
boolean |
true , wenn die Datei übertragen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath)
Verzeichnisinhalte rekursiv auf das Gerät übertragen.
Parameter | |
---|---|
localFileDir |
File : das lokale Verzeichnis, das übertragen werden soll |
deviceFilePath |
String : der absolute Dateipfad des Remote-Ziels |
Returns | |
---|---|
boolean |
true , wenn die Datei übertragen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
pushDir
public boolean pushDir (File localFileDir, String deviceFilePath, int userId)
Verzeichnisinhalte rekursiv auf das Gerät übertragen.
Parameter | |
---|---|
localFileDir |
File : das lokale Verzeichnis, das übertragen werden soll |
deviceFilePath |
String : der absolute Dateipfad des Remote-Ziels |
userId |
int : die Nutzer-ID, an die gesendet werden soll |
Returns | |
---|---|
boolean |
true , wenn die Datei übertragen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Variante von pushFile(File, String)
, bei der optional die Notwendigkeit für den Inhaltsanbieter berücksichtigt werden kann.
Parameter | |
---|---|
localFile |
File : die lokale Datei, die gepusht werden soll |
remoteFilePath |
String : der absolute Dateipfad des Remote-Ziels |
evaluateContentProviderNeeded |
boolean : ob geprüft werden soll, ob wir den Contentanbieter benötigen |
Returns | |
---|---|
boolean |
true , wenn die Datei übertragen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath)
Dateien an das Gerät senden Standardmäßig wird ein Contentanbieter verwendet.
Parameter | |
---|---|
localFile |
File : die lokale Datei, die gepusht werden soll |
remoteFilePath |
String : der absolute Dateipfad des Remote-Ziels |
Returns | |
---|---|
boolean |
true , wenn die Datei übertragen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
pushFile
public boolean pushFile (File localFile, String remoteFilePath, int userId)
Dateien an das Gerät senden Standardmäßig wird ein Contentanbieter verwendet.
Parameter | |
---|---|
localFile |
File : die lokale Datei, die gepusht werden soll |
remoteFilePath |
String : der absolute Dateipfad des Remote-Ziels |
userId |
int : die userId, an die gepusht werden soll |
Returns | |
---|---|
boolean |
true , wenn die Datei übertragen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Push-String
public boolean pushString (String contents, String remoteFilePath)
Aus einem String erstellte Datei per Push an Gerät übertragen
Parameter | |
---|---|
contents |
String : der Inhalt der zu übertragenden Datei |
remoteFilePath |
String : der absolute Dateipfad des Remote-Ziels |
Returns | |
---|---|
boolean |
true , wenn der String erfolgreich gepusht wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
neu starten
public void reboot (String reason)
Startet das Gerät im ADB-Modus mit der angegebenen reason
neu, die nach dem Neustart beibehalten werden soll.
Blockiert, bis das Gerät verfügbar ist.
Der Grund für den letzten Neustart kann durch Abfrage der Property sys.boot.reason
abgerufen werden.
Parameter | |
---|---|
reason |
String : Ein Grund für diesen Neustart oder null , wenn kein Grund angegeben ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
neu starten
public void reboot ()
Startet das Gerät im ADB-Modus neu.
Blockiert, bis das Gerät verfügbar ist.
Ausgabe | |
---|---|
DeviceNotAvailableException |
NeustartIntoBootloader
public void rebootIntoBootloader ()
Das Gerät wird im Bootloader-Modus neu gestartet.
Blockiert, bis sich das Gerät im Bootloader-Modus befindet.
Ausgabe | |
---|---|
DeviceNotAvailableException |
NeustartIntoFastbootd
public void rebootIntoFastbootd ()
Startet das Gerät im Fastbootd-Modus neu.
Blockiert, bis sich das Gerät im Fastbootd-Modus befindet.
Ausgabe | |
---|---|
DeviceNotAvailableException |
rebootIntoRecovery
public void rebootIntoRecovery ()
Das Gerät wird im ADB-Wiederherstellungsmodus neu gestartet.
Blockiert, bis das Gerät in den Wiederherstellungsmodus wechselt
Ausgabe | |
---|---|
DeviceNotAvailableException |
NeustartIntoSideload
public void rebootIntoSideload ()
Startet das Gerät im adb-Sideload-Modus neu. Hinweis: Dies ist ein spezieller Modus unter Wiederherstellung.
Blockiert, bis das Gerät in den Sideload-Modus wechselt
Ausgabe | |
---|---|
DeviceNotAvailableException |
NeustartIntoSideload
public void rebootIntoSideload (boolean autoReboot)
Startet das Gerät im adb-Sideload-Modus neu. Hinweis: Dies ist ein spezieller Modus unter Wiederherstellung.
Blockiert, bis das Gerät in den Sideload-Modus wechselt
Parameter | |
---|---|
autoReboot |
boolean : ob das Gerät nach dem Sideload automatisch neu gestartet werden soll |
Ausgabe | |
---|---|
DeviceNotAvailableException |
rebootUntilOnline
public void rebootUntilOnline ()
Eine Alternative zu reboot()
, die nur blockiert, bis das Gerät online ist, d. h. für adb sichtbar ist.
Ausgabe | |
---|---|
DeviceNotAvailableException |
rebootUntilOnline
public void rebootUntilOnline (String reason)
Eine Alternative zu reboot()
, die nur blockiert, bis das Gerät online ist, d. h. für ADB.
Parameter | |
---|---|
reason |
String : Ein Grund für diesen Neustart oder null , wenn kein Grund angegeben ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Nutzerbereich neu starten
public void rebootUserspace ()
Startet nur den Nutzerbereich des Geräts neu.
Blockiert, bis das Gerät verfügbar ist.
ACHTUNG: Der Neustart im Userspace befindet sich derzeit in aktiver Entwicklung. Die Nutzung erfolgt auf eigenes Risiko.
Ausgabe | |
---|---|
DeviceNotAvailableException |
rebootUserspaceUntilOnline
public void rebootUserspaceUntilOnline ()
Eine Alternative zu rebootUserspace()
()}, die nur blockiert, bis das Gerät online ist, d. h. für adb sichtbar ist.
Ausgabe | |
---|---|
DeviceNotAvailableException |
recoverDevice
public boolean recoverDevice ()
Es wird versucht, die Gerätekommunikation wiederherzustellen.
Returns | |
---|---|
boolean |
„True“, wenn die Wiederherstellung versucht und erfolgreich war, „False“, wenn die Wiederherstellung übersprungen wurde |
Ausgabe | |
---|---|
DeviceNotAvailableException |
wenn das Gerät nicht mehr verfügbar ist |
registerDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Registriert eine IDeviceActionReceiver
für dieses Gerät.
Alle registrierten IDeviceActionReceiver
s werden vor Beginn und nach Ende einer Geräteaktion benachrichtigt.
Parameter | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : Ein IDeviceActionReceiver , das registriert wird. |
remountSystemReadOnly
public void remountSystemReadOnly ()
Die Systempartition auf dem Gerät schreibgeschützt machen. Das Gerät wird möglicherweise neu gestartet.
Ausgabe | |
---|---|
DeviceNotAvailableException |
remountSystemWritable
public void remountSystemWritable ()
Machen Sie die Systempartition auf dem Gerät beschreibbar. Das Gerät wird möglicherweise neu gestartet.
Ausgabe | |
---|---|
DeviceNotAvailableException |
remountVendorReadOnly
public void remountVendorReadOnly ()
Die Anbieterpartition auf dem Gerät schreibgeschützt machen. Das Gerät wird möglicherweise neu gestartet.
Ausgabe | |
---|---|
DeviceNotAvailableException |
remountVendorWritable (remountVendorWritable)
public void remountVendorWritable ()
Machen Sie die Anbieterpartition auf dem Gerät beschreibbar. Das Gerät wird möglicherweise neu gestartet.
Ausgabe | |
---|---|
DeviceNotAvailableException |
removeAdmin
public boolean removeAdmin (String componentName, int userId)
Entfernt den angegebenen Geräteadministrator beim angegebenen Nutzer und gibt true
zurück, wenn der Vorgang erfolgreich war, andernfalls false
.
Parameter | |
---|---|
componentName |
String : des zu entfernenden Geräteadministrators. |
userId |
int : des Nutzers, in dessen Land sich der Geräteadministrator befindet. |
Returns | |
---|---|
boolean |
„True“, wenn erfolgreich, andernfalls „false“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
removeOwners
public void removeOwners ()
Entfernen Sie nach Möglichkeit alle vorhandenen Geräteprofileigentümer.
Ausgabe | |
---|---|
DeviceNotAvailableException |
Nutzer entfernen
public boolean removeUser (int userId)
Einen bestimmten Nutzer vom Gerät entfernen
Parameter | |
---|---|
userId |
int : des zu entfernenden Nutzers |
Returns | |
---|---|
boolean |
true , wenn der Nutzer erfolgreich entfernt wurde, andernfalls false. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
resetContentProviderSetup
public void resetContentProviderSetup ()
Setzen Sie die Markierung für die Einrichtung des Contentanbieters zurück, um ihn noch einmal auszulösen.
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Diese praktische Methode führt ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
mit einem oder mehreren Listenern aus, die als Parameter übergeben werden.
Parameter | |
---|---|
runner |
IRemoteAndroidTestRunner : die IRemoteAndroidTestRunner , die die Tests ausführt |
listeners |
ITestLifeCycleReceiver : die Testergebnis-Listener |
Returns | |
---|---|
boolean |
true , wenn der Testbefehl abgeschlossen ist. false , wenn der Vorgang nicht abgeschlossen werden konnte, die Wiederherstellung aber erfolgreich war |
Ausgabe | |
---|---|
DeviceNotAvailableException |
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Führt Instrumentierungstests aus und bietet die Gerätewiederherstellung.
Wenn die Verbindung zum Gerät vor Abschluss des Tests unterbrochen wird und die Wiederherstellung erfolgreich ist, werden alle Listener über „testRunFailed“ informiert und „false“ wird zurückgegeben. Der Testbefehl wird nicht noch einmal ausgeführt. Anrufer müssen bei Bedarf noch einmal versuchen, eine Verbindung herzustellen.
Wenn die Verbindung zum Gerät vor Abschluss des Tests unterbrochen wird und die Wiederherstellung fehlschlägt, werden alle Listener über „testRunFailed“ informiert und „DeviceNotAvailableException“ wird ausgelöst.
Parameter | |
---|---|
runner |
IRemoteAndroidTestRunner : die IRemoteAndroidTestRunner , auf der die Tests ausgeführt werden |
listeners |
: die Testergebnis-Listener |
Returns | |
---|---|
boolean |
true , wenn der Testbefehl abgeschlossen ist. false , wenn die Ausführung aufgrund einer Ausnahme bei der Gerätekommunikation fehlgeschlagen ist, die Wiederherstellung aber erfolgreich war |
Ausgabe | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Entspricht ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
, führt den Test jedoch für den angegebenen Nutzer aus.
Parameter | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Entspricht ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...)
, führt den Test jedoch für einen bestimmten Nutzer aus.
Parameter | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
setConfiguration
public void setConfiguration (IConfiguration configuration)
Fügt den verwendeten IConfiguration
ein.
Parameter | |
---|---|
configuration |
IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
Parameter | |
---|---|
avdInfo |
GceAvdInfo |
setDate
public void setDate (Date date)
Das Datum auf dem Gerät wird festgelegt.
Hinweis: Zum Festlegen des Datums auf dem Gerät ist Root-Zugriff erforderlich.
Parameter | |
---|---|
date |
Date : ein bestimmtes Datum angeben; es wird das Datum des Hosts verwendet, wenn null |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Geräteinhaber festlegen
public boolean setDeviceOwner (String componentName, int userId)
Komponente zur Geräteverwaltung für einen bestimmten Nutzer als Geräteinhaber festlegen
Parameter | |
---|---|
componentName |
String : des Geräteadministrators als Geräteinhaber |
userId |
int : des Nutzers, in dessen Land sich der Geräteinhaber befindet. |
Returns | |
---|---|
boolean |
„True“, wenn erfolgreich, andernfalls „false“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
Aktualisieren Sie den Status des Geräts.
Parameter | |
---|---|
deviceState |
TestDeviceState : die TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
Für den Emulator SizeLimitedOutputStream
auf „Logausgabe“ festlegen
Parameter | |
---|---|
output |
SizeLimitedOutputStream : Ausgabe protokollieren |
setEmulatorProcess
public void setEmulatorProcess (Process p)
Legt den Process
fest, wenn dieses Gerät ein Emulator ist.
Parameter | |
---|---|
p |
Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
Legen Sie die Fastboot-Option für das Gerät fest. Sollte festgelegt werden, wenn das Gerät zum ersten Mal zugewiesen wird.
Parameter | |
---|---|
fastbootEnabled |
boolean : ob Fastboot für das Gerät verfügbar ist |
setFastbootPath
public void setFastbootPath (String fastbootPath)
Legt den Pfad zum zu verwendenden Fastboot-Binärprogramm fest.
Damit Fastboot-Funktionen aktiviert werden können, muss isFastbootEnabled()
weiterhin „wahr“ sein.
Parameter | |
---|---|
fastbootPath |
String |
setIDevice
public void setIDevice (IDevice newDevice)
Aktualisieren Sie das mit diesem ITestDevice verknüpfte IDevice.
Das neue IDevice muss sich auf dasselbe physische Gerät beziehen wie die aktuelle Referenz. Diese Methode wird aufgerufen, wenn DDMS ein neues IDevice zugewiesen hat.
Parameter | |
---|---|
newDevice |
IDevice : die IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
Legt die Wartezeit in ms fest, bevor die Logcat-Erfassung für ein Onlinegerät gestartet wird.
Parameter | |
---|---|
delay |
int : die Verzögerung in ms |
setOptions
public void setOptions (TestDeviceOptions options)
TestDeviceOptions
für das Gerät festlegen
Parameter | |
---|---|
options |
TestDeviceOptions |
setProperty
public boolean setProperty (String propKey, String propValue)
Legt den angegebenen Property-Wert auf dem Gerät fest. Erfordert, dass „adb root“ auf „wahr“ gesetzt ist.
Parameter | |
---|---|
propKey |
String : Der Schlüssel, der festgelegt werden soll. |
propValue |
String : Der festzulegende Attributwert. |
Returns | |
---|---|
boolean |
gibt True zurück, wenn der Befehl „setprop“ erfolgreich war, andernfalls „False“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Wiederherstellung festlegen
public void setRecovery (IDeviceRecovery recovery)
Lege die IDeviceRecovery
fest, die für dieses Gerät verwendet werden soll. Sollte festgelegt werden, wenn das Gerät zum ersten Mal zugewiesen wird.
Parameter | |
---|---|
recovery |
IDeviceRecovery : die IDeviceRecovery |
setRecoveryMode
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
Legen Sie den aktuellen Wiederherstellungsmodus für das Gerät fest.
Hiermit wird festgelegt, welche Wiederherstellungsmethode verwendet werden soll, wenn ein Problem mit der Gerätekommunikation auftritt. Es wird empfohlen, diese Methode nur sparsam zu verwenden, wenn sie benötigt wird (z. B. wenn das Framework ausgefallen ist usw.)
Parameter | |
---|---|
mode |
ITestDevice.RecoveryMode : ob der Modus „Nur bis zur Onlinewiederherstellung“ aktiviert sein soll |
setSetting
public void setSetting (String namespace, String key, String value)
Siehe setSetting(int, String, String, String)
und wird auf den Systemnutzer angewendet.
Parameter | |
---|---|
namespace |
String |
key |
String |
value |
String |
Ausgabe | |
---|---|
DeviceNotAvailableException |
setSetting
public void setSetting (int userId, String namespace, String key, String value)
Dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzufügen. Einige Einstellungen sind erst nach einem Neustart verfügbar. Namespace muss einen der folgenden Werte haben: {"system", "secure", "global"}
Parameter | |
---|---|
userId |
int |
namespace |
String |
key |
String |
value |
String |
Ausgabe | |
---|---|
DeviceNotAvailableException |
setTestLogger
public void setTestLogger (ITestLogger testLogger)
ITestLogger
-Instanz einschleust
Parameter | |
---|---|
testLogger |
ITestLogger |
setTrackingSerial
public void setTrackingSerial (String trackingSerial)
Für die Geräteverwaltung die Seriennummer erfassen, die wir für die Referenzierung des Geräts verwenden.
Parameter | |
---|---|
trackingSerial |
String |
setUseFastbootErase
public void setUseFastbootErase (boolean useFastbootErase)
Legen Sie fest, ob Sie „fastboot erase“ oder „fastboot format“ verwenden möchten, um eine Partition auf dem Gerät zu löschen.
Parameter | |
---|---|
useFastbootErase |
boolean : true , wenn Daten mit Fastboot-Löschung gelöscht werden sollen, oder false , wenn das Fastboot-Format verwendet werden soll. |
startLogcat
public void startLogcat ()
Starten Sie die Erfassung der Logcat-Ausgabe vom Gerät im Hintergrund.
Dies hat keine Auswirkungen, wenn die Logcat-Ausgabe bereits erfasst wird. Die Daten können später über getLogcat abgerufen werden.
Wenn das Gerät nicht mehr verwendet wird, muss stopLogcat()
aufgerufen werden.
startLogcat()
und stopLogcat()
müssen normalerweise nicht aufgerufen werden, wenn sie sich im Kontext eines TF-Aufrufs befinden, da das TF-Framework Logcat startet und beendet.
startUser (Startnutzer)
public boolean startUser (int userId)
Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist. Wenn der Nutzer bereits im Hintergrund ausgeführt wird, ist diese Methode eine NOOP-Methode.
Parameter | |
---|---|
userId |
int : des Nutzers, der im Hintergrund gestartet werden soll |
Returns | |
---|---|
boolean |
„wahr“, wenn der Nutzer im Hintergrund gestartet wurde. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
startUser
public boolean startUser (int userId, boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist. Wenn der Nutzer bereits im Hintergrund ausgeführt wird, ist diese Methode ein NOOP. Es ist möglich, ein zusätzliches Flag anzugeben, um zu warten, bis der Vorgang wirksam wird.
Parameter | |
---|---|
userId |
int : des Nutzers, der im Hintergrund gestartet werden soll |
waitFlag |
boolean : Der Befehl wartet, bis der Nutzer gestartet und entsperrt wird. |
Returns | |
---|---|
boolean |
„wahr“, wenn der Nutzer im Hintergrund gestartet wurde. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, der auf dem entsprechenden Display sichtbar ist (d.h., der Nutzer kann Aktivitäten auf diesem Display starten).
HINWEIS : Mit diesem Befehl wird nicht geprüft, ob der Nutzer vorhanden ist, das Display verfügbar ist usw.device supports such feature
Parameter | |
---|---|
userId |
int : des Nutzers, der im Hintergrund gestartet werden soll |
displayId |
int : Display, auf dem die Benachrichtigung für Nutzer sichtbar sein soll |
waitFlag |
boolean : Der Befehl wartet, bis der Nutzer gestartet und entsperrt ist. |
Returns | |
---|---|
boolean |
true , wenn der Nutzer erfolgreich gestartet wurde und im Hintergrund sichtbar ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
stopEmulatorOutput
public void stopEmulatorOutput ()
Schließen und löschen Sie die Emulatorausgabe.
stopLogcat
public void stopLogcat ()
Die Erfassung der Logcat-Ausgabe vom Gerät wird beendet und die derzeit gespeicherten Logcat-Daten werden verworfen.
Dies hat keine Auswirkungen, wenn die Logcat-Ausgabe nicht erfasst wird.
stopUser
public boolean stopUser (int userId)
Stoppt einen bestimmten Nutzer. Wenn der Nutzer bereits angehalten hat, ist diese Methode ein NOOP. Aktuellen Nutzer und Systemnutzer können nicht beendet werden.
Parameter | |
---|---|
userId |
int : des Nutzers, der beendet werden soll. |
Returns | |
---|---|
boolean |
„wahr“, wenn der Nutzer erfolgreich gestoppt wurde. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
stopUser
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
Einen bestimmten Nutzer anhalten. Es ist möglich, zusätzliche Flags anzugeben, um zu warten, bis der Vorgang wirksam wird, und den Nutzer zu beenden. Der aktuelle Nutzer und der Systemnutzer können nicht angehalten werden.
Parameter | |
---|---|
userId |
int : des Nutzers, der beendet werden soll. |
waitFlag |
boolean : Der Befehl wartet, bis der Nutzer gestoppt wird. |
forceFlag |
boolean : wird der Nutzer zwangsweise beendet. |
Returns | |
---|---|
boolean |
„wahr“, wenn der Nutzer erfolgreich gestoppt wurde. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
switchToAdbTcp
public String switchToAdbTcp ()
Wechseln Sie auf dem Gerät in den ADB-over-tcp-Modus.
Returns | |
---|---|
String |
die TCP-Seriennummer oder null , wenn das Gerät nicht umgestellt werden konnte |
Ausgabe | |
---|---|
DeviceNotAvailableException |
switchToAdbUsb
public boolean switchToAdbUsb ()
Stellen Sie das Gerät auf den Modus „adb over USB“ um.
Returns | |
---|---|
boolean |
true , wenn der Wechsel erfolgreich war, andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
SwitchUser
public boolean switchUser (int userId)
Wechseln Sie zu einer anderen userId mit einer Standardzeitüberschreitung. switchUser(int, long)
.
Parameter | |
---|---|
userId |
int |
Returns | |
---|---|
boolean |
"True", wenn die neue userId mit dem userId-Anbieter übereinstimmt. Andernfalls „false“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
switchUser
public boolean switchUser (int userId, long timeout)
Wechseln Sie zu einer anderen Nutzer-ID mit dem angegebenen Zeitlimit als Frist. Es wurde versucht, den Keyguard zu deaktivieren, nachdem die Benutzeränderung erfolgreich war.
Parameter | |
---|---|
userId |
int |
timeout |
long : Wartezeit, bevor „false“ zurückgegeben wird, wenn der Wechsel des Nutzers fehlgeschlagen ist. |
Returns | |
---|---|
boolean |
"True", wenn die neue userId mit dem userId-Anbieter übereinstimmt. Andernfalls „false“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
syncFiles
public boolean syncFiles (File localFileDir, String deviceFilePath)
Synchronisiert den Inhalt eines lokalen Dateiverzeichnisses mit dem Gerät.
Entscheidet, welche Dateien gepusht werden sollen, indem Zeitstempel lokaler Dateien mit den entsprechenden Remote-Dateien verglichen werden. Es werden nur neuere oder nicht vorhandene Dateien auf das Gerät gepusht. Daher sollte der Aufwand relativ gering sein, wenn der Dateisatz auf dem Gerät bereits auf dem neuesten Stand ist.
Ausgeblendete Dateien, deren Namen mit „.“ beginnen, werden ignoriert.
Beispiel: Mit syncFiles("/tmp/files", "/sdcard") wird das Verzeichnis „/sdcard/files“ erstellt, falls es noch nicht vorhanden ist, und der Inhalt von „/tmp/files“ wird rekursiv in „/sdcard/files“ kopiert.
Parameter | |
---|---|
localFileDir |
File : das lokale Dateiverzeichnis mit Dateien, die rekursiv gepusht werden sollen. |
deviceFilePath |
String : der absolute Pfad des Remote-Zielorders. Alle Verzeichnisse in diesem Dateipfad müssen lesbar sein. Wenn also adb nicht root ist, schlägt das Übertragen in /data/local/tmp fehl. |
Returns | |
---|---|
boolean |
true , wenn die Dateien erfolgreich synchronisiert wurden. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
takeBugreport
public Bugreport takeBugreport ()
Erstellen Sie einen Fehlerbericht und geben Sie ihn in einem Bugreport
-Objekt zurück, um ihn zu verarbeiten. Gib bei Problemen „null“ zurück. Die im Bugberichtsobjekt referenzierte Datei muss über Bugreport.close()
bereinigt werden.
Returns | |
---|---|
Bugreport |
uninstallPackage
public String uninstallPackage (String packageName)
Android-Paket vom Gerät deinstallieren
Parameter | |
---|---|
packageName |
String : das zu deinstallierende Android-Paket |
Returns | |
---|---|
String |
String mit einem Fehlercode oder null bei Erfolg. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
deinstallierenPackageForUser
public String uninstallPackageForUser (String packageName, int userId)
Deinstallation eines Android-Pakets von einem Gerät für einen bestimmten Nutzer
Parameter | |
---|---|
packageName |
String : das zu deinstallierende Android-Paket |
userId |
int : Die Ganzzahl-Nutzer-ID, für die die Deinstallation erfolgen soll. |
Returns | |
---|---|
String |
String mit einem Fehlercode oder null bei Erfolg. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Gerät entsperren
public boolean unlockDevice ()
Entsperret das Gerät, wenn es verschlüsselt ist.
Diese Methode kann das Framework neu starten, ruft aberpostBootSetup()
nicht auf. Daher ist das Gerät möglicherweise noch nicht vollständig für den Test bereit, wenn diese Methode zurückgegeben wird.
Returns | |
---|---|
boolean |
true , wenn der Vorgang erfolgreich war oder das Gerät nicht verschlüsselt ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
unmountDebugfs
public void unmountDebugfs ()
Entfernen Sie die Bereitstellung von debugfs.
Ausgabe | |
---|---|
DeviceNotAvailableException |
waitForBootComplete
public boolean waitForBootComplete (long timeOut)
Blockiert, bis das Flag „Boot complete“ des Geräts gesetzt ist.
Parameter | |
---|---|
timeOut |
long : Zeit in Millisekunden, die gewartet werden soll, bis das Flag gesetzt wird |
Returns | |
---|---|
boolean |
„true“, wenn das Flag „Boot complete“ des Geräts innerhalb des Zeitlimits gesetzt wird |
Ausgabe | |
---|---|
DeviceNotAvailableException |
WaitForDeviceVerfügbar
public boolean waitForDeviceAvailable ()
Wartet, bis das Gerät reagiert und zum Testen verfügbar ist. Es wird das Standardzeitlimit verwendet.
Returns | |
---|---|
boolean |
„True“, wenn das Gerät verfügbar ist, „False“, wenn die Wiederherstellung deaktiviert und nicht verfügbar ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
WaitForDeviceVerfügbar
public boolean waitForDeviceAvailable (long waitTime)
Wartet, bis das Gerät reagiert und für den Test verfügbar ist.
Parameter | |
---|---|
waitTime |
long : die Wartezeit in ms |
Returns | |
---|---|
boolean |
„True“, wenn das Gerät verfügbar ist, „False“, wenn die Wiederherstellung deaktiviert und nicht verfügbar ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
waitForDeviceAvailableInRecoverPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Wartet, bis das Gerät responsiv und verfügbar ist, ohne den Wiederherstellungspfad zu berücksichtigen.
Parameter | |
---|---|
waitTime |
long |
Returns | |
---|---|
boolean |
„True“, wenn das Gerät verfügbar ist, „False“, wenn nicht. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
waitForDeviceBootloader
public void waitForDeviceBootloader ()
Blockiert, bis das Gerät über Fastboot sichtbar ist. Standardzeitlimit verwenden.
Ausgabe | |
---|---|
DeviceNotAvailableException |
waitForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
Verhindert, dass sich das Gerät im Status „adb recovery“ befindet (dies ist nicht dasselbe wie IDeviceRecovery
).
Parameter | |
---|---|
waitTime |
long : die Wartezeit in ms |
Returns | |
---|---|
boolean |
true , wenn das Gerät vor Ablauf des Zeitlimits in die Wiederherstellung startet.
false andernfalls |
waitForDeviceInSideload
public boolean waitForDeviceInSideload (long waitTime)
Blöcke für das Gerät, die sich im Status „ADB-Sideload“ befinden
Parameter | |
---|---|
waitTime |
long : die Wartezeit in ms |
Returns | |
---|---|
boolean |
true , wenn das Gerät vor Ablauf der Zeit in den Sideload-Modus startet. false
andernfalls |
WaitForDeviceNotAvailable
public boolean waitForDeviceNotAvailable (long waitTime)
Blockiert, dass das Gerät nicht verfügbar ist, d. h. nicht in adb vorhanden ist
Parameter | |
---|---|
waitTime |
long : die Wartezeit in ms |
Returns | |
---|---|
boolean |
true , wenn das Gerät vor Ablauf der Zeit nicht mehr verfügbar ist.
false andernfalls |
waitForDeviceOnline
public void waitForDeviceOnline ()
Blockiert, bis das Gerät über adb sichtbar ist. Verwendet Standardzeitüberschreitung
Das Gerät reagiert nach Abschluss möglicherweise nicht auf Befehle. Verwende stattdessen waitForDeviceAvailable()
.
Ausgabe | |
---|---|
DeviceNotAvailableException |
waitForDeviceOnline
public void waitForDeviceOnline (long waitTime)
Blockiert, bis das Gerät über ADB sichtbar ist.
Das Gerät reagiert nach Abschluss möglicherweise nicht auf Befehle. Verwende stattdessen waitForDeviceAvailable()
.
Parameter | |
---|---|
waitTime |
long : die Wartezeit in ms |
Ausgabe | |
---|---|
DeviceNotAvailableException |
waitForDeviceShell
public boolean waitForDeviceShell (long waitTime)
Wartet, bis das Gerät auf einen einfachen adb-Shell-Befehl reagiert.
Parameter | |
---|---|
waitTime |
long : die Wartezeit in ms |
Returns | |
---|---|
boolean |
true , wenn das Gerät reagiert, bevor waitTime abgelaufen ist. |
Geschützte Methoden
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
Parameter | |
---|---|
builder |
DefaultConnection.ConnectionBuilder |
buildAdbShellCommand
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
Erstellt den Betriebssystembefehl für die angegebene ADB-Shell-Befehlssitzung und -Argumente
Parameter | |
---|---|
command |
String |
forceExitStatusDetection |
boolean |
Returns | |
---|---|
String[] |
checkApiLevelAgainst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
Parameter | |
---|---|
feature |
String |
strictMinLevel |
int |
createRebootDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Erstellen Sie eine RebootDeviceAction
, die beim Ausführen einer Neustartaktion verwendet werden soll.
Parameter | |
---|---|
rebootMode |
NativeDevice.RebootMode : ein Modus dieses Neustarts. |
reason |
String : für diesen Neustart. |
Returns | |
---|---|
NativeDevice.RebootDeviceAction |
den erstellten RebootDeviceAction . |
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Führen Sie einen ADB-Neustart durch.
Parameter | |
---|---|
rebootMode |
NativeDevice.RebootMode : ein Modus dieses Neustarts. |
reason |
String : für diesen Neustart. |
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
ensureRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
Hilfsmethode, um eine Ausnahme zu werfen, wenn die Laufzeitberechtigung nicht unterstützt wird
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
Returns | |
---|---|
int |
getRunUtil
protected IRunUtil getRunUtil ()
Rufen Sie die zu verwendende RunUtil
-Instanz ab.
Returns | |
---|---|
IRunUtil |
initializeConnection
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Parameter | |
---|---|
info |
IBuildInfo |
attributes |
MultiMap |
Ausgabe | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
InterneGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
Eine Geräteeigenschaft wird standardmäßig aus dem ddmlib-Cache abgerufen. Je nachdem, ob sich das Gerät im Fastboot-Modus befindet, wird entweder „adb shell getprop“ oder „fastboot getvar“ verwendet.
Parameter | |
---|---|
propName |
String : Der Name der Geräteeigenschaft, wie von „adb shell getprop“ zurückgegeben |
fastbootVar |
String : Der Name der zu abfragenden entsprechenden Fastboot-Variablen. Bei null wird keine Fastboot-Abfrage versucht. |
description |
String : Eine einfache Beschreibung der Variable. Der erste Buchstabe sollte großgeschrieben werden. |
Returns | |
---|---|
String |
Ein String, möglicherweise null oder leer, der den Wert der angegebenen Property enthält |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isInRebootCallback
protected boolean isInRebootCallback ()
Gibt an, ob Reboot-Callbacks derzeit ausgeführt werden. Alle öffentlichen APIs für den Neustart sollten deaktiviert werden, wenn diese Option aktiviert ist.
Returns | |
---|---|
boolean |
istNeuer
protected boolean isNewer (File localFile, IFileEntry entry)
Gibt true
zurück, wenn die lokale Datei neuer ist als die Remotedatei. IFileEntry
muss auf die Minute genau sein. Bei gleicher Uhrzeit gilt die Datei als neuer.
Parameter | |
---|---|
localFile |
File |
entry |
IFileEntry |
Returns | |
---|---|
boolean |
notifyRebootEnded
protected void notifyRebootEnded ()
Benachrichtigt alle IDeviceActionReceiver
über das Ereignis zum Beenden des Neustarts.
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
notifyRebootStarted
protected void notifyRebootStarted ()
Alle IDeviceActionReceiver
werden über das Ereignis „Neustart gestartet“ benachrichtigt.
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Geräteaktion ausführen
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Dadurch wird eine Aktion auf diesem Gerät ausgeführt. Versucht, das Gerät wiederherzustellen, und führt den Befehl optional noch einmal aus, falls die Aktion fehlschlägt.
Parameter | |
---|---|
actionDescription |
String : Eine kurze Beschreibung der auszuführenden Aktion. Wird nur zu Logging-Zwecken verwendet. |
action |
NativeDevice.DeviceAction : die auszuführende Aktion |
retryAttempts |
int : Die Wiederholungsversuche für die Aktion, wenn sie fehlschlägt, die Wiederherstellung aber erfolgreich ist |
Returns | |
---|---|
boolean |
true , wenn die Aktion erfolgreich war |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Wiederherstellungsversuch fehlgeschlagen oder maximale Anzahl erfolgloser Versuche |
postAdbReboot
protected void postAdbReboot ()
Mögliche zusätzliche Aktionen, die nach einem Neustart ausgeführt werden können.
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
PrePostBootSetup
protected void prePostBootSetup ()
Damit kann jeder Gerätetyp (AndroidNativeDevice, TestDevice) diese Methode für eine bestimmte Einrichtung nach dem Booten überschreiben.
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
PullFileInternal
protected boolean pullFileInternal (String remoteFilePath, File localFile)
Parameter | |
---|---|
remoteFilePath |
String |
localFile |
File |
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
setClock
protected void setClock (Clock clock)
Legen Sie die zu verwendende Uhren-Instanz fest.
Parameter | |
---|---|
clock |
Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
Kennzeichnet das Testgerät als Microdroid und legt seine CID fest.
Parameter | |
---|---|
process |
Process : Prozess der Microdroid-VM. |
SetTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
Parameter | |
---|---|
deviceOptions |
|
SimpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
Führt einen einfachen Fastboot-Befehl mit Umgebungsvariablen aus und meldet den Status des Befehls.
Parameter | |
---|---|
timeout |
long |
envVarMap |
|
fullCmd |
String |
Returns | |
---|---|
CommandResult |
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Führt einen einfachen Fastboot-Befehl aus und meldet den Status des Befehls.
Parameter | |
---|---|
timeout |
long |
fullCmd |
String |
Returns | |
---|---|
CommandResult |
WaitForDeviceNotAvailable
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
Warten Sie, bis das Gerät nicht mehr verfügbar ist (keine Berichte mehr an adb).
Parameter | |
---|---|
operationDesc |
String : Der Name des Vorgangs, der auf „nicht verfügbar“ wartet. |
time |
long : Die Zeit, die gewartet werden soll, bis der Status „Nicht verfügbar“ auftritt. |
Returns | |
---|---|
boolean |
„True“, wenn das Gerät nicht mehr verfügbar ist. |