NativeDevice
public
class
NativeDevice
extends Object
implements
IManagedTestDevice,
IConfigurationReceiver,
ITestLoggerReceiver
java.lang.Object | |
➔ | com.android.tradefed.device.NativeDevice. |
Standardimplementierung eines ITestDevice
Nicht-Full-Stack-Android-Geräts.
Zusammenfassung
Verschachtelte Klassen | |
---|---|
class |
NativeDevice.AdbAction
Ein |
class |
NativeDevice.AdbShellAction
|
class |
NativeDevice.RebootDeviceAction
|
Konstanten | |
---|---|
int |
INVALID_USER_ID
Zurückgegebener Wert für ungültige oder nicht gefundene Nutzer-IDs: UserHandle hat -10000 definiert |
long |
MAX_HOST_DEVICE_TIME_OFFSET
|
int |
MAX_RETRY_ATTEMPTS
die Standardanzahl der Wiederholungsversuche für den Befehl |
Fields | |
---|---|
public
static
final
String |
DEBUGFS_PATH
|
protected
static
final
String |
SD_CARD
|
protected
static
final
String |
STORAGE_EMULATED
|
protected
TestDeviceOptions |
mOptions
|
protected
final
IDeviceStateMonitor |
mStateMonitor
|
Öffentliche Konstruktoren | |
---|---|
NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Erstellt ein |
Öffentliche Methoden | |
---|---|
void
|
batchPrefetchStartupBuildProps()
Mikrooptimierung (ca. 400 Millis), indem alle benötigten Attribute vorab abgerufen werden, anstatt für jede „adb getprop“ aufzurufen. |
boolean
|
canSwitchToHeadlessSystemUser()
Gibt zurück, ob ein Wechsel zum monitorlosen SYSTEM-Nutzer zulässig ist. |
boolean
|
checkApiLevelAgainstNextRelease(int strictMinLevel)
Prüfen Sie, ob eine Funktion derzeit mit einer minimal unterstützten Stufe unterstützt wird. |
boolean
|
checkConnectivity()
Prüfe, ob das Gerät eine Netzwerkverbindung hat. |
boolean
|
clearErrorDialogs()
Versuchen Sie, alle Fehlerdialogfelder zu schließen, die derzeit auf der Geräte-UI angezeigt werden. |
void
|
clearLastConnectedWifiNetwork()
Löscht das zuletzt verbundene WLAN. |
void
|
clearLogcat()
Löscht alle akkumulierten Logcat-Daten. |
boolean
|
connectToWifiNetwork(
Stellt eine WLAN-Verbindung her. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk)
Stellt eine WLAN-Verbindung her. |
boolean
|
connectToWifiNetwork(
Stellt eine Verbindung zu einem WLAN her. |
boolean
|
connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid)
Stellt eine WLAN-Verbindung her. |
boolean
|
connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid)
Eine Variante von |
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 weich gestartet wurde. Dazu wird der aktuelle Systemserver 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 seinem |
boolean
|
disableAdbRoot()
Deaktiviert den ADB-Root. |
void
|
disableKeyguard()
Versucht, den Keyguard zu deaktivieren. |
boolean
|
disableNetworkMonitor()
Deaktiviert die Netzwerküberwachung auf dem Gerät. |
boolean
|
disconnectFromWifi()
Trennt die Verbindung zum WLAN. |
boolean
|
doesFileExist(String deviceFilePath, int userId)
Hilfsmethode, um festzustellen, ob für einen bestimmten Nutzer eine Datei auf dem Gerät vorhanden ist. |
boolean
|
doesFileExist(String deviceFilePath)
Hilfsmethode zum Ermitteln, ob eine Datei auf dem Gerät vorhanden ist. |
File
|
dumpHeap(String process, String devicePath)
Dump des Heaps vom system_server. |
boolean
|
enableAdbRoot()
Aktiviert den ADB-Stamm. |
boolean
|
enableNetworkMonitor()
Aktiviert die Netzwerküberwachung auf dem Gerät. |
String
|
executeAdbCommand(long timeout, String... cmdArgs)
Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem bestimmten Zeitlimit ausführt. |
String
|
executeAdbCommand(long timeout,
Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem bestimmten Zeitlimit ausführt. |
String
|
executeAdbCommand(String... cmdArgs)
Hilfsmethode, die einen adb-Befehl als Systembefehl ausführt. |
CommandResult
|
executeFastbootCommand(String... cmdArgs)
Hilfsmethode, die einen Fastboot-Befehl als Systembefehl mit einem Standardzeitlimit von 2 Minuten ausführt. |
CommandResult
|
executeFastbootCommand(long timeout, String... cmdArgs)
Hilfsmethode, die einen Fastboot-Befehl als Systembefehl ausführt. |
CommandResult
|
executeLongFastbootCommand(String... cmdArgs)
Hilfsmethode, die einen lange laufenden Fastboot-Befehl als Systembefehl ausführt. |
CommandResult
|
executeLongFastbootCommand(
Hilfsmethode, die einen lange laufenden Fastboot-Befehl als Systembefehl mit Systemumgebungsvariablen ausführt. |
String
|
executeShellCommand(String command)
Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ausgabe als |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
Führt den angegebenen adb-Shell-Befehl aus und wiederholt einen mehrfachen Versuch, wenn der Befehl fehlschlägt. |
CommandResult
|
executeShellV2Command(String cmd)
Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als |
CommandResult
|
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 mehr Parametern zur Steuerung des Befehlsverhaltens aus. |
CommandResult
|
fastbootWipePartition(String partition)
Hilfsmethode zum Löschen einer Partition auf dem Gerät. |
|
getActiveApexes()
Rufen Sie die Informationen zu den auf dem Gerät aktivierten APEXes ab. |
|
getAllSettings(String namespace)
Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück. |
DeviceAllocationState
|
getAllocationState()
Aktuellen Zuweisungsstatus des Geräts zurückgeben |
String
|
getAndroidId(int userId)
Sucht nach der mit einer userId verknüpften Android-ID und gibt sie zurück. Wenn sie nicht gefunden wird, null. |
|
getAndroidIds()
Erstellen Sie eine Karte mit Android-IDs, die mit Nutzer-IDs übereinstimmen. |
int
|
getApiLevel()
API-Level des Geräts abrufen |
PackageInfo
|
getAppPackageInfo(String packageName)
Informationen zu einem auf dem Gerät installierten Paket abrufen |
|
getAppPackageInfos()
Informationen zu Paketen abrufen, die auf dem Gerät installiert sind |
String
|
getBasebandVersion()
Praktische Methode zum Abrufen der Baseband- bzw. Funkversion dieses Geräts. |
Integer
|
getBattery()
Gibt den aktuellen Akkustand eines Geräts oder Null zurück, wenn der Akkustand nicht verfügbar ist. |
boolean
|
getBooleanProperty(String name, boolean defaultValue)
Gibt einen booleschen Wert der angegebenen Eigenschaft zurück. |
|
getBootHistory()
Die Hilfsmethode erfasst die Boot-Verlaufszuordnung mit Startzeit und Startgrund. |
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
Die Hilfsmethode erfasst die Bootverlaufszuordnung mit Bootzeit und Bootgrund seit der angegebenen Zeit seit der Epoche ab dem Gerät und der angegebenen Zeiteinheit. |
String
|
getBootloaderVersion()
Praktische Methode zum Abrufen der Bootloader-Version dieses Geräts. |
InputStreamSource
|
getBugreport()
Ruft einen Fehlerbericht vom Gerät ab. |
InputStreamSource
|
getBugreportz()
Ruft einen Fehlerbericht vom Gerät ab |
String
|
getBuildAlias()
Rufen Sie den Alias des Builds ab, den das Gerät derzeit ausführt. |
String
|
getBuildFlavor()
Rufen Sie den Build-Flavor für das Gerät ab. |
String
|
getBuildId()
Rufen Sie den Build ab, den das Gerät derzeit ausführt. |
String
|
getBuildSigningKeys()
Gibt den Schlüsseltyp zurück, der zum Signieren des Geräte-Images verwendet wurde Android-Geräte können in der Regel mit Testschlüsseln (wie in AOSP) oder Release-Schlüsseln (von den einzelnen Geräteherstellern kontrolliert) signiert sein. |
DeviceDescriptor
|
getCachedDeviceDescriptor()
Gibt ein im Cache gespeichertes |
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Gibt ein im Cache gespeichertes |
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 faltbaren Status des Geräts oder null zurück, wenn Probleme aufgetreten sind. |
int
|
getCurrentUser()
Gibt die ID des aktuell ausgeführten Nutzers zurück. |
String
|
getDeviceClass()
Rufen Sie die Geräteklasse ab. |
long
|
getDeviceDate()
Gibt das Datum des Geräts in Millisekunden seit der Epoche zurück. |
DeviceDescriptor
|
getDeviceDescriptor()
Gib ein |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Gib ein |
TestDeviceState
|
getDeviceState()
Rufen Sie den Status des Geräts ab. |
long
|
getDeviceTimeOffset(Date date)
Hilfsfunktion, um den Zeitunterschied zwischen dem Gerät und einem bestimmten |
InputStreamSource
|
getEmulatorOutput()
Stream für Emulatoren stdout und stderr 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)
Rufen Sie den angegebenen Wert der Fastboot-Variable vom Gerät ab. |
String
|
getFastbootVersion()
Gibt den Versionsstring der verwendeten Fastboot-Binärdatei zurück. |
IFileEntry
|
getFileEntry(String path)
Rufen Sie einen Verweis auf eine Remote-Datei auf dem Gerät ab. |
IFileEntry
|
getFileEntry(FileListingService.FileEntry entry)
Inoffizielles Hilfsprogramm zum Abrufen eines |
|
getFoldableStates()
Gibt die Liste der Status des faltbaren Geräts zurück. |
IDevice
|
getIDevice()
Gibt einen Verweis auf die verknüpfte ddmlib- |
|
getInstalledPackageNames()
Rufen Sie die auf dem Gerät vorhandenen App-Paketnamen ab. |
long
|
getIntProperty(String name, long defaultValue)
Gibt einen ganzzahligen Wert der angegebenen Eigenschaft vom Gerät zurück. |
String
|
getIpAddress()
Ruft die IP-Adresse des Geräts ab. |
KeyguardControllerState
|
getKeyguardState()
Gibt ein Objekt zurück, um den aktuellen Status des Keyguard oder null abzurufen, wenn dies nicht unterstützt wird. |
long
|
getLastExpectedRebootTimeMillis()
Gibt in Millisekunden zurück, wann die Tradefed APIs zuletzt einen Neustart ausgelöst haben, seit EPOCH von |
int
|
getLaunchApiLevel()
Das erste API-Level des Geräts abrufen. |
InputStreamSource
|
getLogcat()
Erfasst einen Snapshot-Stream der Logcat-Daten. |
InputStreamSource
|
getLogcat(int maxBytes)
Erfasst einen Snapshot-Stream der letzten |
InputStreamSource
|
getLogcatDump()
Dump des aktuellen Logcats für das Gerät abrufen |
InputStreamSource
|
getLogcatSince(long date)
Erfasst einen Snapshot-Stream erfasster Logcat-Daten ab dem angegebenen Datum. |
String
|
getMacAddress()
Gibt die MAC-Adresse des Geräts zurück. Wenn keine Abfrage vom Gerät durchgeführt werden kann, wird null zurückgegeben. |
Integer
|
getMainUserId()
Gibt die Hauptnutzer-ID zurück. |
|
getMainlineModuleInfo()
Rufen Sie die Informationen zu den auf dem Gerät installierten Mainline-Modulen ab. |
int
|
getMaxNumberOfRunningUsersSupported()
Holen Sie sich die maximale Anzahl von Nutzern, die gleichzeitig ausgeführt werden. |
int
|
getMaxNumberOfUsersSupported()
Rufen Sie die maximale Anzahl der unterstützten Nutzer ab. |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
Gib die |
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 Ermitteln der Menge an freiem Speicherplatz auf der Gerätepartition. |
Integer
|
getPrimaryUserId()
Gibt die primäre Nutzer-ID zurück. |
ProcessInfo
|
getProcessByName(String processName)
Die Hilfsmethode führt die Befehle "pidof" und "stat" aus und gibt das Objekt |
String
|
getProcessPid(String process)
Gibt die PID des Dienstes oder null zurück, wenn ein Fehler aufgetreten ist. |
String
|
getProductType()
Praktische Methode zum Abrufen des Produkttyps dieses Geräts. |
String
|
getProductVariant()
Praktische Methode zum Abrufen der Produktvariante dieses Geräts. |
String
|
getProperty(String name)
Ruft den angegebenen Attributwert vom Gerät ab. |
ITestDevice.RecoveryMode
|
getRecoveryMode()
Rufen Sie den aktuellen Wiederherstellungsmodus des Geräts ab. |
InputStreamSource
|
getScreenshot(String format)
Erstellt einen Screenshot vom Gerät. |
InputStreamSource
|
getScreenshot(long displayId)
Erstellt einen Screenshot von der angegebenen Anzeige-ID des Geräts. |
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Erstellt einen Screenshot vom Gerät. |
InputStreamSource
|
getScreenshot()
Erstellt einen Screenshot vom Gerät. |
String
|
getSerialNumber()
Eine praktische Methode zum Abrufen der Seriennummer dieses Geräts. |
String
|
getSetting(int userId, String namespace, String key)
Gibt den Wert der angeforderten Einstellung zurück. |
String
|
getSetting(String namespace, String key)
Siehe |
String
|
getSimOperator()
Geben Sie den Anbieter der SIM-Karte zurück oder null, wenn dieser nicht verfügbar ist oder das Gerät nicht verfügbar ist. |
String
|
getSimState()
Gib den Status der SIM-Karte oder den Wert "null" zurück, falls nicht verfügbar oder das Gerät nicht verfügbar ist. |
|
getTombstones()
Die Liste der Tombstones von den Geräten abrufen und zurückgeben. |
long
|
getTotalMemory()
Gibt die Gesamtgröße des physischen Arbeitsspeichers in Byte oder -1 bei einem internen Fehler zurück. |
|
getUninstallablePackageNames()
Rufen Sie die App-Paketnamen ab, die deinstalliert werden können. |
boolean
|
getUseFastbootErase()
Legen Sie fest, ob eine Partition auf dem Gerät mit der Funktion „Fastboot Deletion“ oder „Fastboot“ gelöscht werden soll. |
int
|
getUserFlags(int userId)
Findet die Flags eines bestimmten Nutzers und gibt sie zurück. |
|
getUserInfos()
Ruft die Map of useId zu |
int
|
getUserSerialNumber(int userId)
Gibt die Seriennummer zurück, die der userId zugeordnet ist, falls sie gefunden wird; in allen anderen Fällen -10000. |
IManagedTestDevice.DeviceEventResponse
|
handleAllocationEvent(DeviceEvent event)
Verarbeitet das angegebene DeviceEvent. DeviceEvent verarbeiten, wodurch dieses Gerät möglicherweise in einen neuen Zuweisungsstatus geändert wird. |
boolean
|
hasFeature(String feature)
Prüfen, ob eine Funktion auf einem Gerät verfügbar ist |
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Ein Android-Paket auf dem Gerät installieren |
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Ein Android-Paket auf dem Gerät installieren |
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Ein Android-Paket für einen bestimmten Nutzer auf dem Gerät installieren |
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Ein Android-Paket für einen bestimmten Nutzer auf dem Gerät installieren |
void
|
invalidatePropertyCache()
|
boolean
|
isAdbRoot()
|
boolean
|
isAdbTcp()
|
boolean
|
isAppEnumerationSupported()
Prüfen, ob die Plattform auf dem Gerät die Auflistung von Apps unterstützt |
boolean
|
isBypassLowTargetSdkBlockSupported()
Prüfen, ob die Plattform auf dem Gerät das Umgehen eines niedrigen SDK-Zielblocks bei App-Installationen unterstützt |
boolean
|
isDebugfsMounted()
Prüfen Sie, ob debugfs bereitgestellt ist. |
boolean
|
isDeviceEncrypted()
Gibt an, ob das Gerät verschlüsselt ist. |
boolean
|
isDirectory(String path)
Gibt „True“ zurück, wenn der Pfad auf dem Gerät ein Verzeichnis ist, andernfalls „false“. |
boolean
|
isEnableAdbRoot()
|
boolean
|
isEncryptionSupported()
Gibt zurück, wenn die Verschlüsselung auf dem Gerät unterstützt wird. |
boolean
|
isExecutable(String fullPath)
Gibt "True" zurück, wenn der Dateipfad auf dem Gerät eine ausführbare Datei ist, andernfalls "False". |
boolean
|
isFastbootEnabled()
Rückgabe, wenn Fastboot für das Gerät verfügbar ist. |
boolean
|
isHeadless()
Gibt „true“ zurück, wenn das Gerät monitorlos ist (kein Bildschirm), andernfalls „false“. |
boolean
|
isHeadlessSystemUserMode()
Gibt an, ob das Gerät den monitorlosen Systemnutzermodus verwendet. |
boolean
|
isMainUserPermanentAdmin()
Gibt zurück, ob der Hauptnutzer ein dauerhafter Administrator ist und weder gelöscht noch auf einen Nicht-Administratorstatus herabgestuft werden kann. |
boolean
|
isMultiUserSupported()
Legt fest, ob mehrere Nutzer unterstützt werden. |
boolean
|
isPackageInstalled(String packageName, String userId)
Frag das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID ab, um zu prüfen, ob es bei diesem Nutzer derzeit installiert ist oder nicht. |
boolean
|
isPackageInstalled(String packageName)
Fragen Sie das Gerät nach einem bestimmten Paketnamen ab, um zu prüfen, ob es derzeit installiert ist. |
boolean
|
isRuntimePermissionSupported()
Prüfen, ob die Plattform auf dem Gerät die Gewährung von Laufzeitberechtigungen unterstützt |
boolean
|
isStateBootloaderOrFastbootd()
Gibt „true“ zurück, wenn sich das Gerät in |
boolean
|
isUserRunning(int userId)
Prüfen Sie, ob ein bestimmter Nutzer ausgeführt wird. |
boolean
|
isUserSecondary(int userId)
Gibt zurück, ob der angegebene Nutzer gemäß seinen Flags ein sekundärer Nutzer ist. |
boolean
|
isUserVisible(int userId)
Prüft, ob der angegebene Nutzer sichtbar ist. |
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Prüft, ob der angegebene Nutzer auf dem Display sichtbar ist. |
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Gibt an, ob auf dem Gerät Nutzer gestartet werden können, die im Hintergrund im |
boolean
|
isVisibleBackgroundUsersSupported()
Gibt an, ob auf dem Gerät Nutzer im Hintergrund sichtbar gemacht werden können. |
boolean
|
isWifiEnabled()
Teste, ob WLAN aktiviert ist. |
|
listDisplayIds()
Erfassen Sie die Liste der verfügbaren Anzeige-IDs auf dem Gerät, wie von „dumpsys SurfaceFlinger“ gemeldet. |
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Ruft die Liste der Bildschirme ab, die zum |
|
listUsers()
Ruft die Liste der Nutzer auf dem Gerät ab. |
boolean
|
logAnrs(ITestLogger logger)
Erfasst und protokolliert ANR-Fehler vom Gerät. |
boolean
|
logBugreport(String dataName, ITestLogger listener)
Hilfsmethode, um einen Fehlerbericht zu erstellen und bei den Reportern zu protokollieren. |
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
Protokolliert eine Nachricht im Logcat des Geräts. |
void
|
mountDebugfs()
Stellen Sie debugfs bereit. |
void
|
nonBlockingReboot()
Gibt einen Befehl zum Neustart des Geräts aus und wird zurückgegeben, wenn der Befehl abgeschlossen ist und das Gerät für ADB nicht mehr sichtbar ist. |
void
|
postAdbRootAction()
Überschreibt, wenn das Gerät bestimmte Aktionen nach dem ADB-Root ausführen und bevor das Gerät wieder online ist. |
void
|
postAdbUnrootAction()
Diese Einstellung kann überschrieben werden, wenn nach dem Aufheben des Root-Vorgangs von ADB und bevor das Gerät wieder online ist, bestimmte Aktionen ausgeführt werden müssen. |
void
|
postBootSetup()
Führen Sie die Anweisungen aus, um das Gerät nach jedem Start so zu konfigurieren, dass es getestet wird. |
void
|
postInvocationTearDown(Throwable exception)
Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach dem Aufruf ausgeführt wird. |
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
Zusätzliche Schritte für die gerätespezifische erforderliche Einrichtung, die vor dem Aufruffluss auf dem Gerät ausgeführt werden. |
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
Verzeichnisinhalte rekursiv vom Gerät abrufen. |
boolean
|
pullDir(String deviceFilePath, File localDir)
Verzeichnisinhalte rekursiv vom Gerät abrufen. |
boolean
|
pullFile(String remoteFilePath, File localFile)
Ruft eine Datei vom Gerät ab. |
File
|
pullFile(String remoteFilePath, int userId)
Ruft eine Datei vom Gerät ab, speichert sie in einer lokalen temporären |
File
|
pullFile(String remoteFilePath)
Ruft eine Datei vom Gerät ab, speichert sie in einer 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, sie in einer 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)
Übertragen Sie eine Datei per Push auf das Gerät. |
boolean
|
pushString(String contents, String remoteFilePath)
Aus einem String erstellte Datei per Push an Gerät übertragen |
void
|
reboot(String reason)
Startet das Gerät im ADB-Modus neu, wobei die angegebenen |
void
|
reboot()
Startet das Gerät im ADB-Modus neu. |
void
|
rebootIntoBootloader()
Startet das Gerät im Bootloader-Modus neu. |
void
|
rebootIntoFastbootd()
Startet das Gerät im Fastbootd-Modus neu. |
void
|
rebootIntoRecovery()
Das Gerät wird im ADB-Wiederherstellungsmodus neu gestartet. |
void
|
rebootIntoSideload()
Startet das Gerät im ADB-Sideload-Modus neu. Beachten Sie, dass dies ein spezieller Modus für die Wiederherstellung ist. Wird blockiert, bis das Gerät in den Sideload-Modus wechselt |
void
|
rebootIntoSideload(boolean autoReboot)
Startet das Gerät im ADB-Sideload-Modus neu. Beachten Sie, dass dies ein spezieller Modus für die Wiederherstellung ist. Wird blockiert, bis das Gerät in den Sideload-Modus wechselt |
void
|
rebootUntilOnline()
Eine Alternative zu |
void
|
rebootUntilOnline(String reason)
Eine Alternative zu |
void
|
rebootUserspace()
Startet nur den Userspace-Teil des Geräts neu. |
void
|
rebootUserspaceUntilOnline()
Eine Alternative zu |
boolean
|
recoverDevice()
Versuche, 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()
Machen Sie die Anbieterpartition auf dem Gerät schreibgeschützt. |
void
|
remountVendorWritable()
Machen Sie die Anbieterpartition auf dem Gerät beschreibbar. |
boolean
|
removeAdmin(String componentName, int userId)
Den angegebenen Geräteadministrator für den Nutzer entfernen und |
void
|
removeOwners()
Entfernen Sie nach Möglichkeit alle vorhandenen Geräteprofileigentümer. |
boolean
|
removeUser(int userId)
Einen bestimmten Nutzer vom Gerät entfernen |
void
|
resetContentProviderSetup()
Setzen Sie die Markierung für die Einrichtung des Contentanbieters zurück, um ihn noch einmal auszulösen. |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Praktische Methode zur Ausführung von |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner,
Führt Instrumentierungstests durch und bietet Gerätewiederherstellung. |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId,
Hat dieselbe Funktion wie |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Hat dieselbe Funktion wie |
void
|
setConfiguration(IConfiguration configuration)
Injiziertes |
final
void
|
setConnectionAvdInfo(GceAvdInfo avdInfo)
|
void
|
setDate(Date date)
Legt das Datum auf dem Gerät fest Hinweis: Zum Festlegen des Datums auf dem Gerät ist ein Root erforderlich |
boolean
|
setDeviceOwner(String componentName, int userId)
Komponente zur Geräteverwaltung für einen bestimmten Nutzer als Geräteinhaber festlegen |
void
|
setDeviceState(TestDeviceState deviceState)
Aktualisieren Sie den Status des Geräts. |
void
|
setEmulatorOutputStream(SizeLimitedOutputStream output)
Legen Sie für den Emulator |
void
|
setEmulatorProcess(Process p)
Legt die |
void
|
setFastbootEnabled(boolean fastbootEnabled)
Legen Sie die Fastboot-Option für das Gerät fest. |
void
|
setFastbootPath(String fastbootPath)
Legt den Pfad zum zu verwendenden Fastboot-Binärprogramm fest. |
void
|
setIDevice(IDevice newDevice)
Aktualisiere das mit diesem ITestDevice verknüpfte IDevice. |
void
|
setLogStartDelay(int delay)
Legt die Wartezeit in ms fest, bevor die Logcat-Erfassung für ein Onlinegerät gestartet wird. |
void
|
setOptions(TestDeviceOptions options)
|
boolean
|
setProperty(String propKey, String propValue)
Legt den angegebenen Property-Wert auf dem Gerät fest. |
void
|
setRecovery(IDeviceRecovery recovery)
Lege 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)
Fügt dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzu. |
void
|
setTestLogger(ITestLogger testLogger)
|
void
|
setUseFastbootErase(boolean useFastbootErase)
Legen Sie fest, ob eine Partition auf dem Gerät mithilfe des Schnellstart-Löschens oder des Fastboot-Formats gelöscht werden soll. |
void
|
startLogcat()
Starte die Aufzeichnung der Logcat-Ausgabe vom Gerät im Hintergrund. |
boolean
|
startUser(int userId)
Startet einen bestimmten Nutzer im Hintergrund, wenn er aktuell beendet ist. |
boolean
|
startUser(int userId, boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, wenn er aktuell beendet ist. |
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, der auf dem jeweiligen Bildschirm sichtbar ist (d.h., der Nutzer kann Aktivitäten auf dieser Anzeige starten). |
void
|
stopEmulatorOutput()
Schließen und löschen Sie die Emulatorausgabe. |
void
|
stopLogcat()
Erfassen der Logcat-Ausgabe vom Gerät beenden und aktuell gespeicherte Logcat-Daten verwerfen. |
boolean
|
stopUser(int userId)
Stoppt einen bestimmten Nutzer. |
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Stoppen Sie einen bestimmten Nutzer. |
String
|
switchToAdbTcp()
Wechseln Sie auf dem Gerät in den ADB-over-tcp-Modus. |
boolean
|
switchToAdbUsb()
Schalte das Gerät in den ADB-over-USB-Modus um. |
boolean
|
switchUser(int userId)
Zu einer anderen Nutzer-ID mit Standardzeitlimit wechseln. |
boolean
|
switchUser(int userId, long timeout)
Wechseln Sie zu einer anderen Nutzer-ID mit dem angegebenen Zeitlimit als Frist. |
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
Der Inhalt eines lokalen Dateiverzeichnisses wird inkrementell mit dem Gerät synchronisiert. |
Bugreport
|
takeBugreport()
Erstellen Sie einen Fehlerbericht und geben Sie ihn in einem |
String
|
uninstallPackage(String packageName)
Android-Paket vom Gerät deinstallieren |
String
|
uninstallPackageForUser(String packageName, int userId)
Android-Paket für einen bestimmten Nutzer vom Gerät deinstallieren |
boolean
|
unlockDevice()
Entsperrt das Gerät, wenn es verschlüsselt ist |
void
|
unmountDebugfs()
Trennen Sie „debugfs“. |
boolean
|
waitForBootComplete(long timeOut)
Blockiert, bis das Flag „Boot abgeschlossen“ des Geräts gesetzt wird. |
boolean
|
waitForDeviceAvailable()
Wartet, bis das Gerät reagiert und zum Testen verfügbar ist. |
boolean
|
waitForDeviceAvailable(long waitTime)
Wartet, bis das Gerät reagiert und zum Testen verfügbar ist. |
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
Wartet, bis das Gerät responsiv und verfügbar ist, ohne den Wiederherstellungspfad zu berücksichtigen. |
void
|
waitForDeviceBootloader()
Blockiert, bis das Gerät über Fastboot sichtbar ist. |
boolean
|
waitForDeviceInRecovery(long waitTime)
Blöcke für das Gerät, die sich im Status „ADB-Wiederherstellung“ befinden. Beachten Sie, dass dies nicht mit |
boolean
|
waitForDeviceInSideload(long waitTime)
Blöcke für das Gerät, die sich im Status „ADB-Sideload“ befinden |
boolean
|
waitForDeviceNotAvailable(long waitTime)
Blockierungen für das Gerät, die nicht verfügbar sind, d. h. in ADB fehlen |
void
|
waitForDeviceOnline()
Blockiert, bis das Gerät über ADB sichtbar ist. |
void
|
waitForDeviceOnline(long waitTime)
Blockiert, bis das Gerät über ADB sichtbar ist. |
boolean
|
waitForDeviceShell(long waitTime)
Wartet, bis das Gerät auf einen einfachen ADB-Shell-Befehl reagiert. |
Geschützte Methoden | |
---|---|
void
|
addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
|
String[]
|
buildAdbShellCommand(String command, boolean forceExitStatusDetection)
Erstellt den Betriebssystembefehl für die angegebene ADB-Shell-Befehlssitzung und -Argumente |
void
|
checkApiLevelAgainst(String feature, int strictMinLevel)
|
NativeDevice.RebootDeviceAction
|
createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)
Erstellen Sie eine |
IRunUtil
|
createRunUtil()
|
void
|
doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)
Starten Sie ADB-Neustart. |
void
|
ensureRuntimePermissionSupported()
Hilfsmethode zum Auslösen einer Ausnahme, wenn die Laufzeitberechtigung nicht unterstützt wird |
int
|
getApiLevelSafe()
|
ITestLogger
|
getLogger()
|
IRunUtil
|
getRunUtil()
Rufen Sie die zu verwendende |
void
|
initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
|
String
|
internalGetProperty(String propName, String fastbootVar, String description)
Rufen Sie standardmäßig eine Geräteeigenschaft aus dem ddmlib-Cache ab und greifen Sie entweder auf "adb shell getprop" oder "fastboot getvar" zurück, je nachdem, ob sich das Gerät im Fastboot-Modus befindet oder nicht. |
boolean
|
isInRebootCallback()
Gibt zurück, ob gerade Neustart-Callbacks ausgeführt werden oder nicht. |
boolean
|
isNewer(File localFile, IFileEntry entry)
Gibt |
void
|
notifyRebootEnded()
Benachrichtigt alle |
void
|
notifyRebootStarted()
Benachrichtigt alle |
boolean
|
performDeviceAction(String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Führt eine Aktion auf diesem Gerät aus. |
void
|
postAdbReboot()
Mögliche zusätzliche Aktionen, die nach einem Neustart ausgeführt werden können. |
void
|
prePostBootSetup()
Damit kann jeder Gerätetyp (AndroidNativeDevice, TestDevice) diese Methode für eine bestimmte Einrichtung nach dem Booten überschreiben. |
boolean
|
pullFileInternal(String remoteFilePath, File localFile)
|
void
|
setClock(Clock clock)
Legen Sie die zu verwendende Uhrinstanz fest. |
void
|
setMicrodroidProcess(Process process)
Kennzeichnet das Testgerät als Mikrodroid und legt seine Kundennummer fest. |
void
|
setTestDeviceOptions(
|
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 (beenden Sie die Berichterstellung an ADB). |
Konstanten
UNGÜLTIGE_NUTZER-ID
public static final int INVALID_USER_ID
Zurückgegebener Wert für ungültige oder nicht gefundene Nutzer-IDs: UserHandle hat -10000 definiert
Konstante Wert: -10000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_offSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
Konstanter Wert: 5.000 (0x0000000000001388)
MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
die Standardanzahl der Wiederholungsversuche für den Befehl
Konstantenwert: 2 (0x00000002)
Fields
DEBUGFS_PATH (FEHLERBEHEBUNG)
public static final String DEBUGFS_PATH
SD-KARTE
protected static final String SD_CARD
SPEICHER_EMPULIERT
protected static final String STORAGE_EMULATED
Öffentliche Konstruktoren
NativeDevice
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Erstellt ein TestDevice
.
Parameter | |
---|---|
device |
IDevice : die zugehörige IDevice |
stateMonitor |
IDeviceStateMonitor : der zu verwendende IDeviceStateMonitor -Mechanismus |
allocationMonitor |
IDeviceMonitor : IDeviceMonitor zur Information über Änderungen des Zuweisungsstatus.
Kann null sein |
Öffentliche Methoden
BatchPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
Mikrooptimierung (ca. 400 Millis), indem alle benötigten Attribute vorab abgerufen werden, anstatt für jedes Attribut „adb getprop“ aufzurufen, d.h. das Abrufen aller Eigenschaften ist genauso schnell wie das Abrufen einer Property. Dinge wie device.getApiLevel(), checkApiLevelAgainstNextRelease und getBuildAlias rufen alle im Hintergrund „adb getprop“ auf. Sie werden in einem Aufruf abgerufen und „NativeDevice.setProperty“ aufgerufen. Auch wenn das nicht der Fall ist, ruft NativeDevice selbst „setProperty“ auf und speichert das Ergebnis für zukünftige Aufrufe im Cache. Wir machen das nur etwas früher. Wenn das Gerät gerade wiederhergestellt wird oder andere Fehler beim Abrufen der Eigenschaften auftreten, werden sie einfach ignoriert.
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Gibt zurück, ob ein Wechsel zum monitorlosen SYSTEM-Nutzer zulässig ist.
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
checkApiLevelAgainstNextRelease (API-LevelAgainstNextRelease)
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Prüfen Sie, ob eine Funktion derzeit mit einer minimal unterstützten Stufe unterstützt wird. Bei dieser Methode werden noch nicht veröffentlichte Funktionen berücksichtigt, bevor das API-Level erhöht wird.
Parameter | |
---|---|
strictMinLevel |
int : Die strikte Mindeststufe, die die Funktion unterstützt. |
Returns | |
---|---|
boolean |
„True“, wenn das Level unterstützt wird. Andernfalls „false“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Verbindung prüfen
public boolean checkConnectivity ()
Prüfe, ob das Gerät eine Netzwerkverbindung hat.
Returns | |
---|---|
boolean |
true , wenn das Gerät eine funktionierende Netzwerkverbindung hat, false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
ClearErrorDialogs
public boolean clearErrorDialogs ()
Versuchen Sie, alle Fehlerdialogfelder zu schließen, die derzeit auf der Geräte-UI angezeigt werden.
Returns | |
---|---|
boolean |
true , wenn keine Dialogfelder vorhanden waren oder Dialogfelder erfolgreich gelöscht wurden.
Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
ClearLastConnectedWifiNetwork
public void clearLastConnectedWifiNetwork ()
Löscht das zuletzt verbundene WLAN. Diese sollte beim Starten eines neuen Aufrufs aufgerufen werden, um nach dem Neustart des Geräts keine Verbindung zum WLAN herzustellen, das im vorherigen Test verwendet wurde.
ClearLogcat
public void clearLogcat ()
Löscht alle akkumulierten Logcat-Daten.
Das ist in Fällen nützlich, in denen ITestDevice#getLogcat()
nur Logdaten zurückgibt, die nach einem bestimmten Zeitpunkt erstellt wurden (z. B. nach dem Flashen eines neuen Geräte-Builds).
mit Wifi-Netzwerk verbinden
public boolean connectToWifiNetwork (wifiSsidToPsk, boolean scanSsid)
Stellt eine WLAN-Verbindung her.
Aktiviert das WLAN und blockiert, bis eine Verbindung zu einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke hergestellt wurde. Nachdem eine Verbindung hergestellt wurde, versucht die Instanz, die Verbindung nach jedem Neustart wiederherzustellen, bis ITestDevice#disconnectFromWifi()
oder ITestDevice#clearLastConnectedWifiNetwork()
aufgerufen wird.
Parameter | |
---|---|
wifiSsidToPsk |
: Eine Zuordnung der WLAN-SSIDs zu Passwörtern. |
scanSsid |
boolean : Gibt an, ob für dieses Netzwerk nach verborgenen SSIDs gesucht werden soll. |
Returns | |
---|---|
boolean |
true , wenn eine Verbindung mit dem WLAN hergestellt wurde. Andernfalls false |
Ausgabe | |
---|---|
DeviceNotAvailableException |
mit Wifi-Netzwerk verbinden
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)
Stellt eine WLAN-Verbindung her.
Aktiviert das WLAN und blockiert, bis eine Verbindung zum angegebenen WLAN hergestellt wurde.
Nachdem eine Verbindung hergestellt wurde, versucht die Instanz, die Verbindung nach jedem Neustart wiederherzustellen, bis ITestDevice#disconnectFromWifi()
oder ITestDevice#clearLastConnectedWifiNetwork()
aufgerufen wird.
Parameter | |
---|---|
wifiSsid |
String : das WLAN-Signal, mit dem eine Verbindung hergestellt werden soll |
wifiPsk |
String : PSK-Passphrase oder null, falls unverschlüsselt |
Returns | |
---|---|
boolean |
true , wenn eine Verbindung mit dem WLAN hergestellt wurde. Andernfalls false |
Ausgabe | |
---|---|
DeviceNotAvailableException |
mit Wifi-Netzwerk verbinden
public boolean connectToWifiNetwork (wifiSsidToPsk)
Stellt eine WLAN-Verbindung her.
Aktiviert das WLAN und blockiert, bis eine Verbindung zu einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke hergestellt wurde. Nachdem eine Verbindung hergestellt wurde, versucht die Instanz, die Verbindung nach jedem Neustart wiederherzustellen, bis ITestDevice#disconnectFromWifi()
oder ITestDevice#clearLastConnectedWifiNetwork()
aufgerufen wird.
Parameter | |
---|---|
wifiSsidToPsk |
: Eine Zuordnung der WLAN-SSIDs zu Passwörtern. |
Returns | |
---|---|
boolean |
true , wenn eine Verbindung mit dem WLAN hergestellt wurde. Andernfalls false |
Ausgabe | |
---|---|
DeviceNotAvailableException |
mit Wifi-Netzwerk verbinden
public boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)
Stellt eine WLAN-Verbindung her.
Aktiviert das WLAN und blockiert, bis eine Verbindung zum angegebenen WLAN hergestellt wurde.
Nachdem eine Verbindung hergestellt wurde, versucht die Instanz, die Verbindung nach jedem Neustart wiederherzustellen, bis ITestDevice#disconnectFromWifi()
oder ITestDevice#clearLastConnectedWifiNetwork()
aufgerufen wird.
Parameter | |
---|---|
wifiSsid |
String : das WLAN-Signal, mit dem eine Verbindung hergestellt werden soll |
wifiPsk |
String : PSK-Passphrase oder null, falls unverschlüsselt |
scanSsid |
boolean : Gibt an, ob für dieses Netzwerk nach versteckter SSID gesucht werden soll. |
Returns | |
---|---|
boolean |
true , wenn eine Verbindung mit dem WLAN hergestellt wurde. Andernfalls false |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Verbindung mit WLAN-Netzwerk herstellen (falls erforderlich)
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)
Eine Variante von connectToWifiNetwork(String, String)
, die nur eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.
Parameter | |
---|---|
scanSsid |
boolean : ob für dieses Netzwerk nach versteckter SSID gesucht werden soll |
Returns | |
---|---|
boolean |
true , wenn eine Verbindung mit dem WLAN hergestellt wurde. Andernfalls false |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Verbindung mit WLAN-Netzwerk herstellen (falls erforderlich)
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
Eine Variante von connectToWifiNetwork(String, String)
, die nur eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.
Returns | |
---|---|
boolean |
true , wenn eine Verbindung mit dem WLAN hergestellt wurde. Andernfalls false |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Nutzer erstellen
public int createUser (String name, boolean guest, boolean ephemeral)
Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen
Parameter | |
---|---|
name |
String : des Nutzers, der auf dem Gerät erstellt werden soll |
guest |
boolean : aktiviert das Nutzer-Flag --guest während der Erstellung. |
ephemeral |
boolean : aktiviert das Nutzer-Flag „--sitzungsspezifisch“ beim Erstellen |
Returns | |
---|---|
int |
ID des erstellten Nutzers |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Nutzer erstellen
public int createUser (String name, boolean guest, boolean ephemeral, boolean forTesting)
Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen
Parameter | |
---|---|
name |
String : des Nutzers, der auf dem Gerät erstellt werden soll |
guest |
boolean : aktiviert das Nutzer-Flag --guest während der Erstellung. |
ephemeral |
boolean : aktiviert das Nutzer-Flag „--sitzungsspezifisch“ beim Erstellen |
forTesting |
boolean : aktiviert das Test-Flag „--for-testing“ beim Erstellen |
Returns | |
---|---|
int |
ID des erstellten Nutzers |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Nutzer erstellen
public int createUser (String name)
Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
Parameter | |
---|---|
name |
String : des Nutzers, der auf dem Gerät erstellt werden soll |
Returns | |
---|---|
int |
Ganzzahl für die erstellte User-ID |
Ausgabe | |
---|---|
DeviceNotAvailableException |
createUserNoThrow
public int createUserNoThrow (String name)
Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
Parameter | |
---|---|
name |
String : des Nutzers, der auf dem Gerät erstellt werden soll |
Returns | |
---|---|
int |
Ganzzahl für die erstellte User-ID oder -1 für Fehler. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Datei löschen
public void deleteFile (String deviceFilePath, int userId)
Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät.
Parameter | |
---|---|
deviceFilePath |
String : Der absolute Pfad der Datei auf dem Gerät. |
userId |
int : Die Nutzer-ID, aus der gelöscht werden soll |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Datei löschen
public void deleteFile (String deviceFilePath)
Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät.
Parameter | |
---|---|
deviceFilePath |
String : Der absolute Pfad der Datei auf dem Gerät. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
RegistrierungDeviceActionReceiver abmelden
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Entfernt die registrierte IDeviceActionReceiver
.
Parameter | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : Eine IDeviceActionReceiver , die entfernt wird. |
deviceSoftNeustart
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Hilfsmethode, um zu prüfen, ob das Gerät weich gestartet wurde. Dazu wird der aktuelle Systemserver mit dem vorherigen „system_server“ ProcessInfo
verglichen. getProcessByName(String)
verwenden, um ProcessInfo
zu erhalten.
Parameter | |
---|---|
prevSystemServerProcess |
ProcessInfo : der vorherige Systemserver-Prozess ProcessInfo |
Returns | |
---|---|
boolean |
true , wenn das Gerät vorläufig neu gestartet wurde |
Ausgabe | |
---|---|
DeviceNotAvailableException |
deviceSoftneustart seit
public boolean deviceSoftRestartedSince (long utcEpochTime, TimeUnit timeUnit)
Hilfsmethode, um zu prüfen, ob das Gerät seit der UTC-Zeit seit der Epoche vom Gerät und seinem ERROR(/TimeUnit)
vorläufig neu gestartet wurde. Ein vorläufiger Neustart bezieht sich auf den Neustart des Systemservers, der außerhalb eines harten Neustarts des Geräts neu gestartet wurde (z. B. angeforderter Neustart). Die aktuelle utcEpochTime des Geräts in Milliseccond kann mit der Methode getDeviceDate()
abgerufen werden.
Parameter | |
---|---|
utcEpochTime |
long : die Gerätezeit in Sekunden seit der Epoche. |
timeUnit |
TimeUnit : die Zeiteinheit TimeUnit für die angegebene utcEpochTime. |
Returns | |
---|---|
boolean |
true , wenn das Gerät vorläufig neu gestartet wurde |
Ausgabe | |
---|---|
DeviceNotAvailableException |
deaktiviereAdbRoot
public boolean disableAdbRoot ()
Deaktiviert den ADB-Root.
Das Deaktivieren der ADB-Root-Instanz kann dazu führen, dass das Gerät von ADB getrennt wird. Diese Methode wird blockiert, bis das Gerät verfügbar ist.
Returns | |
---|---|
boolean |
true , wenn der Vorgang erfolgreich war. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Keyguard deaktivieren
public void disableKeyguard ()
Versucht, den Keyguard zu deaktivieren.
Warten Sie zuerst, bis die Eingabeweiterleitung bereit ist. Dies geschieht ungefähr zur gleichen Zeit, zu der das Gerät BOOT_COMPLETE scheinbar asynchron meldet, da die aktuelle Framework-Implementierung gelegentlich eine Race-Bedingung aufweist. Anschließend wird der Befehl zum Schließen von Keyguard gesendet (funktioniert nur bei nicht sicheren).
Ausgabe | |
---|---|
DeviceNotAvailableException |
Netzwerkmonitor deaktivieren
public boolean disableNetworkMonitor ()
Deaktiviert die Netzwerküberwachung auf dem Gerät.
Returns | |
---|---|
boolean |
true , wenn das Monitoring erfolgreich deaktiviert wurde. false
wenn er fehlgeschlagen ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
VonWLAN trennen
public boolean disconnectFromWifi ()
Trennt die Verbindung zum WLAN.
Entfernt alle Netzwerke aus der Liste der bekannten Netzwerke und deaktiviert das WLAN.
Returns | |
---|---|
boolean |
true , wenn die Verbindung zum WLAN erfolgreich getrennt wurde. false , wenn die Verbindung nicht getrennt werden konnte. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
tutFileExist
public boolean doesFileExist (String deviceFilePath, int userId)
Hilfsmethode, um festzustellen, ob für einen bestimmten Nutzer eine Datei auf dem Gerät vorhanden ist.
Parameter | |
---|---|
deviceFilePath |
String : der absolute Pfad der zu prüfenden Datei auf dem Gerät |
userId |
int : Die Nutzer-ID, anhand derer die Existenz der Datei geprüft werden soll. |
Returns | |
---|---|
boolean |
true , wenn die Datei vorhanden ist, andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
tutFileExist
public boolean doesFileExist (String deviceFilePath)
Hilfsmethode zum Ermitteln, ob eine Datei auf dem Gerät vorhanden ist.
Parameter | |
---|---|
deviceFilePath |
String : der absolute Pfad der zu prüfenden Datei auf dem Gerät |
Returns | |
---|---|
boolean |
true , wenn die Datei vorhanden ist, andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
DumpHeap
public File dumpHeap (String process, String devicePath)
Dump des Heaps vom system_server. Der Aufrufer ist dafür verantwortlich, die Dumpdatei zu bereinigen.
Parameter | |
---|---|
process |
String : der Name des Geräteprozesses, für den Dumpheap durchgeführt werden soll. |
devicePath |
String : Pfad auf dem Gerät, in dem der Dump gespeichert wird Dies muss ein Standort sein, für den die Berechtigungen dies zulassen. |
Returns | |
---|---|
File |
Die ERROR(/File) , die den Bericht enthält. Null, wenn ein Fehler aufgetreten ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
EnableAdbRoot
public boolean enableAdbRoot ()
Aktiviert den ADB-Stamm. Wenn die Einstellung „enable-root“ auf „false“ gesetzt ist, wird eine Meldung protokolliert und ohne Root-Aktivierung zurückgegeben.
Wenn du den ADB-Root aktivierst, wird möglicherweise die Verbindung zwischen dem Gerät und ADB getrennt. Diese Methode wird blockiert, bis das Gerät verfügbar ist.
Returns | |
---|---|
boolean |
true , wenn der Vorgang erfolgreich war. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
EnableNetworkMonitor
public boolean enableNetworkMonitor ()
Aktiviert die Netzwerküberwachung auf dem Gerät.
Returns | |
---|---|
boolean |
true , wenn das Monitoring erfolgreich aktiviert wurde. false
wenn er fehlgeschlagen ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Befehl ausführen
public String executeAdbCommand (long timeout, String... cmdArgs)
Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem bestimmten Zeitlimit ausführt.
Nach Möglichkeit sollte executeShellCommand(String)
verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.
Parameter | |
---|---|
timeout |
long : die Zeit in Millisekunden, nach der das Gerät als nicht mehr reagiert; 0 L für kein Zeitlimit |
cmdArgs |
String : der ADB-Befehl und die auszuführenden Argumente |
Returns | |
---|---|
String |
den Befehl „stdout“. null , wenn der Befehl nicht ausgeführt werden konnte. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Befehl ausführen
public String executeAdbCommand (long timeout,envMap, String... cmdArgs)
Hilfsmethode, die einen adb-Befehl als Systembefehl mit einem bestimmten Zeitlimit ausführt.
Nach Möglichkeit sollte executeShellCommand(String)
verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.
Parameter | |
---|---|
timeout |
long : die Zeit in Millisekunden, nach der das Gerät als nicht mehr reagiert; 0 L für kein Zeitlimit |
envMap |
ist die für den Befehl festzulegende Umgebung. |
cmdArgs |
String : der ADB-Befehl und die auszuführenden Argumente |
Returns | |
---|---|
String |
den Befehl „stdout“. null , wenn der Befehl nicht ausgeführt werden konnte. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Befehl ausführen
public String executeAdbCommand (String... cmdArgs)
Hilfsmethode, die einen adb-Befehl als Systembefehl ausführt.
Nach Möglichkeit sollte executeShellCommand(String)
verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.
Parameter | |
---|---|
cmdArgs |
String : der ADB-Befehl und die auszuführenden Argumente |
Returns | |
---|---|
String |
den Befehl „stdout“. null , wenn der Befehl nicht ausgeführt werden konnte. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Schnellstart-Befehl ausführen
public CommandResult executeFastbootCommand (String... cmdArgs)
Hilfsmethode, die einen Fastboot-Befehl als Systembefehl mit einem Standardzeitlimit von 2 Minuten ausführt.
Kann verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus (Fastboot mode) befindet.
Parameter | |
---|---|
cmdArgs |
String : der Fastboot-Befehl und die auszuführenden Argumente |
Returns | |
---|---|
CommandResult |
das CommandResult-Element mit der Ausgabe des Befehls |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Schnellstart-Befehl ausführen
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
Hilfsmethode, die einen Fastboot-Befehl als Systembefehl ausführt.
Kann verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus (Fastboot mode) befindet.
Parameter | |
---|---|
timeout |
long : die Zeit in Millisekunden, bevor der Befehl abläuft |
cmdArgs |
String : der Fastboot-Befehl und die auszuführenden Argumente |
Returns | |
---|---|
CommandResult |
das CommandResult-Element mit der Ausgabe des Befehls |
Ausgabe | |
---|---|
DeviceNotAvailableException |
LongFastbootCommand ausführen
public CommandResult executeLongFastbootCommand (String... cmdArgs)
Hilfsmethode, die einen lange laufenden Fastboot-Befehl als Systembefehl ausführt.
Identisch mit executeFastbootCommand(String)
, mit dem Unterschied, dass ein längeres Zeitlimit verwendet wird.
Parameter | |
---|---|
cmdArgs |
String : der Fastboot-Befehl und die auszuführenden Argumente |
Returns | |
---|---|
CommandResult |
das CommandResult-Element mit der Ausgabe des Befehls |
Ausgabe | |
---|---|
DeviceNotAvailableException |
LongFastbootCommand ausführen
public CommandResult executeLongFastbootCommand (envVarMap, String... cmdArgs)
Hilfsmethode, die einen lange laufenden Fastboot-Befehl als Systembefehl mit Systemumgebungsvariablen ausführt.
Identisch mit executeFastbootCommand(String)
, mit dem Unterschied, dass ein längeres Zeitlimit verwendet wird.
Parameter | |
---|---|
envVarMap |
: die Systemumgebungsvariablen, mit denen der fastboot-Befehl ausgeführt wird |
cmdArgs |
String : der Fastboot-Befehl und die auszuführenden Argumente |
Returns | |
---|---|
CommandResult |
das CommandResult-Element mit der Ausgabe des Befehls |
Ausgabe | |
---|---|
DeviceNotAvailableException |
AusführenShellCommand
public String executeShellCommand (String command)
Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ausgabe als String
zurückgibt.
Parameter | |
---|---|
command |
String : der auszuführende ADB-Shell-Befehl |
Returns | |
---|---|
String |
die Shell-Ausgabe |
Ausgabe | |
---|---|
DeviceNotAvailableException |
AusführenShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.
Parameter | |
---|---|
command |
String : der auszuführende ADB-Shell-Befehl |
receiver |
IShellOutputReceiver : IShellOutputReceiver , an den die Shell-Ausgabe weitergeleitet werden soll. |
maxTimeToOutputShellResponse |
long : die maximale Zeitspanne, während der der Befehl keine Antwort ausgeben darf; Einheit gemäß timeUnit |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int : die maximale Anzahl der Wiederholungen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. DeviceNotResponsiveException wird geworfen, wenn retryAttempts erfolglos ausgeführt wird. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
AusführenShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.
Parameter | |
---|---|
command |
String : der auszuführende ADB-Shell-Befehl |
receiver |
IShellOutputReceiver : IShellOutputReceiver , an den die Shell-Ausgabe weitergeleitet werden soll. |
maxTimeoutForCommand |
long : das maximale Zeitlimit für die Ausführung des Befehls; die Einheit gemäß timeUnit . |
maxTimeToOutputShellResponse |
long : die maximale Zeitspanne, während der der Befehl keine Antwort ausgeben darf; Einheit gemäß timeUnit |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int : die maximale Anzahl der Wiederholungen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. DeviceNotResponsiveException wird geworfen, wenn retryAttempts erfolglos ausgeführt wird. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
AusführenShellCommand
public void executeShellCommand (String command, IShellOutputReceiver receiver)
Führt den angegebenen adb-Shell-Befehl aus und wiederholt einen mehrfachen Versuch, wenn der Befehl fehlschlägt.
Eine einfachere Form von executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit, int)
mit Standardwerten.
Parameter | |
---|---|
command |
String : der auszuführende ADB-Shell-Befehl |
receiver |
IShellOutputReceiver : IShellOutputReceiver , an den die Shell-Ausgabe weitergeleitet werden soll. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
AusführenShellV2Command
public CommandResult executeShellV2Command (String cmd)
Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als CommandResult
zurückgibt, die ordnungsgemäß mit der Ausgabe des Befehlsstatus (stdout und stderr) ausgefüllt ist.
Parameter | |
---|---|
cmd |
String : Der Befehl, der ausgeführt werden soll. |
Returns | |
---|---|
CommandResult |
Das Ergebnis in CommandResult . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
AusführenShellV2Command
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als CommandResult
zurückgibt, die korrekt mit der Befehlsausgabe und stderr. stdout ausgefüllt sind und an den angegebenen Stream weitergeleitet werden.
Parameter | |
---|---|
cmd |
String : Der Befehl, der ausgeführt werden soll. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , an die die Standardausgabe weitergeleitet wird, oder null. |
Returns | |
---|---|
CommandResult |
Das Ergebnis in CommandResult . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
AusführenShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als CommandResult
zurückgibt, die ordnungsgemäß mit der Befehlsausgabeausgabe, stdout und stderr ausgefüllt ist.
Parameter | |
---|---|
cmd |
String : Der Befehl, der ausgeführt werden soll. |
pipeAsInput |
File : Ein ERROR(/File) -Wert, der als Eingabe für den Befehl verwendet wird, oder null. |
Returns | |
---|---|
CommandResult |
Das Ergebnis in CommandResult . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
AusführenShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.
Parameter | |
---|---|
cmd |
String : der auszuführende ADB-Shell-Befehl |
maxTimeoutForCommand |
long : das maximale Zeitlimit für die Ausführung des Befehls; die Einheit gemäß timeUnit . |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int : die maximale Anzahl der Wiederholungen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. DeviceNotResponsiveException wird geworfen, wenn retryAttempts erfolglos ausgeführt wird. |
Returns | |
---|---|
CommandResult |
Ausgabe | |
---|---|
DeviceNotAvailableException |
AusführenShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.
Parameter | |
---|---|
cmd |
String : der auszuführende ADB-Shell-Befehl |
maxTimeoutForCommand |
long : das maximale Zeitlimit für die Ausführung des Befehls; die Einheit gemäß timeUnit . |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
Returns | |
---|---|
CommandResult |
Ausgabe | |
---|---|
DeviceNotAvailableException |
AusführenShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.
Parameter | |
---|---|
cmd |
String : der auszuführende ADB-Shell-Befehl |
pipeAsInput |
File : Ein ERROR(/File) -Wert, der als Eingabe für den Befehl verwendet wird, oder null. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , an die die Standardausgabe weitergeleitet wird, oder null. |
maxTimeoutForCommand |
long : das maximale Zeitlimit für die Ausführung des Befehls; die Einheit gemäß timeUnit . |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int : die maximale Anzahl der Wiederholungen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. DeviceNotResponsiveException wird geworfen, wenn retryAttempts erfolglos ausgeführt wird. |
Returns | |
---|---|
CommandResult |
Ausgabe | |
---|---|
DeviceNotAvailableException |
AusführenShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Führt einen adb-Shell-Befehl mit mehr Parametern zur Steuerung des Befehlsverhaltens aus.
Parameter | |
---|---|
cmd |
String : der auszuführende ADB-Shell-Befehl |
pipeAsInput |
File : Ein ERROR(/File) -Wert, der als Eingabe für den Befehl verwendet wird, oder null. |
pipeToOutput |
OutputStream : ERROR(/OutputStream) , an die die Standardausgabe weitergeleitet wird, oder null. |
pipeToError |
OutputStream : ERROR(/OutputStream) , an die der Standardfehler weitergeleitet wird, oder null. |
maxTimeoutForCommand |
long : das maximale Zeitlimit für die Ausführung des Befehls; die Einheit gemäß timeUnit . |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int : die maximale Anzahl der Wiederholungen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. DeviceNotResponsiveException wird geworfen, wenn retryAttempts erfolglos ausgeführt wird. |
Returns | |
---|---|
CommandResult |
Ausgabe | |
---|---|
DeviceNotAvailableException |
FastbootWipePartition
public CommandResult fastbootWipePartition (String partition)
Hilfsmethode zum Löschen einer Partition auf dem Gerät.
Wenn getUseFastbootErase()
den Wert true
hat, wird die Partition mit Fastboot-Löschungen gelöscht. Das Gerät muss beim nächsten Start ein Dateisystem erstellen.
Andernfalls wird das Fastboot-Format verwendet, wodurch ein neues Dateisystem auf dem Gerät erstellt wird.
Kann verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus (Fastboot mode) befindet.
Parameter | |
---|---|
partition |
String : die zu löschende Partition |
Returns | |
---|---|
CommandResult |
das CommandResult-Element mit der Ausgabe des Befehls |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getActiveApexes
publicgetActiveApexes ()
Rufen Sie die Informationen zu den auf dem Gerät aktivierten APEXes ab.
Returns | |
---|---|
|
Derzeit sind ERROR(/Set) von ApexInfo auf dem Gerät aktiviert |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Einstellungen abrufen
publicgetAllSettings (String namespace)
Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück.
Parameter | |
---|---|
namespace |
String : muss einer dieser Werte sein: {"system", "secure", "global"} |
Returns | |
---|---|
|
der Schlüssel/Wert-Paare. Null, wenn der Namespace nicht unterstützt wird. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getAllocationState
public DeviceAllocationState getAllocationState ()
Aktuellen Zuweisungsstatus des Geräts zurückgeben
Returns | |
---|---|
DeviceAllocationState |
getAndroidId (GetAndroid-ID)
public String getAndroidId (int userId)
Sucht nach der mit einer userId verknüpften Android-ID und gibt sie zurück. Wenn sie nicht gefunden wird, null.
Parameter | |
---|---|
userId |
int |
Returns | |
---|---|
String |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getAndroidIds (Abrufen von Android-IDs)
publicgetAndroidIds ()
Erstellen Sie eine Karte mit Android-IDs, die mit Nutzer-IDs übereinstimmen. Es gibt keine Versicherung, dass jede Nutzer-ID eine Android-ID findet, die mit dieser Funktion verknüpft ist. Daher können einige Nutzer-IDs mit null übereinstimmen.
Returns | |
---|---|
|
Karte mit Android-IDs, die mit Nutzer-IDs übereinstimmen. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getApiLevel
public int getApiLevel ()
API-Level des Geräts abrufen Die Standardeinstellung ist UNKNOWN_API_LEVEL
.
Returns | |
---|---|
int |
eine Ganzzahl, die das API-Level des Geräts angibt |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Informationen zu einem auf dem Gerät installierten Paket abrufen
Parameter | |
---|---|
packageName |
String |
Returns | |
---|---|
PackageInfo |
PackageInfo oder null , wenn Informationen nicht abgerufen werden konnten |
Ausgabe | |
---|---|
DeviceNotAvailableException |
GetAppPackageInfos
publicgetAppPackageInfos ()
Informationen zu Paketen abrufen, die auf dem Gerät installiert sind
Returns | |
---|---|
|
ERROR(/List) von PackageInfo s auf dem Gerät installiert. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getBasebandVersion
public String getBasebandVersion ()
Praktische Methode zum Abrufen der Baseband- bzw. Funkversion dieses Geräts. Das Abrufen der Radioversion ist gerätespezifisch, sodass möglicherweise nicht für alle Geräte die richtigen Informationen zurückgegeben werden. Diese Methode benötigt die Eigenschaft „gsm.version.baseband“, um die richtigen Versionsinformationen zurückzugeben.
Bei einigen CDMA-Geräten ist dies nicht korrekt und die hier zurückgegebene Version stimmt möglicherweise nicht mit der von Fastboot gemeldeten Version überein und gibt nicht die Version für das CDMA-Radio zurück.
Zusammenfassung: Diese Methode gibt nur dann eine korrekte Version zurück, wenn das Attribut „gsm.version.baseband“ mit der von fastboot getvar version-baseband
zurückgegebenen Version übereinstimmt.
Returns | |
---|---|
String |
die String -Baseband-Version oder null , wenn diese nicht ermittelt werden kann (Gerät hat keine Funkschnittstelle oder der Versionsstring kann nicht gelesen werden) |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getAkku
public Integer getBattery ()
Gibt den aktuellen Akkustand eines Geräts oder Null zurück, wenn der Akkustand nicht verfügbar ist.
Returns | |
---|---|
Integer |
getBoolescheProperty
public boolean getBooleanProperty (String name, boolean defaultValue)
Gibt einen booleschen Wert der angegebenen Eigenschaft zurück.
Parameter | |
---|---|
name |
String : der Name der Property |
defaultValue |
boolean : Standardwert, der zurückgegeben wird, wenn das Attribut leer oder nicht vorhanden ist. |
Returns | |
---|---|
boolean |
true , wenn das Attribut den Wert "1" , "y" , "yes" , "on" oder "true" hat, false , wenn das Attribut den Wert "0" , "n" , "no" , "off" , "false" oder defaultValue hat. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getBootVerlauf
publicgetBootHistory ()
Die Hilfsmethode erfasst die Boot-Verlaufszuordnung mit Startzeit und Startgrund.
Returns | |
---|---|
|
Karte der Bootzeit (UTC-Zeit in Sekunden seit Epoche) und des Bootgrunds |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getBootVerlaufSeit
publicgetBootHistorySince (long utcEpochTime, TimeUnit timeUnit)
Die Hilfsmethode erfasst die Bootverlaufszuordnung mit Bootzeit und Bootgrund seit der angegebenen Zeit seit der Epoche ab dem Gerät und der angegebenen Zeiteinheit. Die aktuelle utcEpochTime des Geräts in Millisekunden kann mit der Methode getDeviceDate()
abgerufen werden.
Parameter | |
---|---|
utcEpochTime |
long : die Gerätezeit seit Epoche. |
timeUnit |
TimeUnit : die Zeiteinheit TimeUnit . |
Returns | |
---|---|
|
Karte der Bootzeit (UTC-Zeit in Sekunden seit Epoche) und des Bootgrunds |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getBootloaderVersion
public String getBootloaderVersion ()
Praktische Methode zum Abrufen der Bootloader-Version dieses Geräts.
Es wird versucht, die Bootloader-Version aus dem aktuellen Gerätezustand abzurufen. (d. h., wenn sich das Gerät im Fastboot-Modus befindet, versucht es, die Version über Fastboot abzurufen)
Returns | |
---|---|
String |
die Bootloader-Version String oder null , wenn sie nicht gefunden werden kann |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getBugreport
public InputStreamSource getBugreport ()
Ruft einen Fehlerbericht vom Gerät ab.
Die Implementierung funktioniert garantiert auch auf Geräten ohne SD-Karte (oder auf denen die SD-Karte noch nicht bereitgestellt wurde).
Returns | |
---|---|
InputStreamSource |
Ein InputStreamSource , das bei Bedarf den Inhalt des Fehlerberichts generiert. Im Falle eines Fehlers erzeugt InputStreamSource ein leeres ERROR(/InputStream) . |
getBugreportz
public InputStreamSource getBugreportz ()
Ruft einen Fehlerbericht vom Gerät ab Der Fehlerbericht im ZIP-Format enthält den Hauptfehlerbericht und andere Protokolldateien, die für die Fehlerbehebung hilfreich sind.
Nur unterstützt für "adb version" > 1.0.36
Returns | |
---|---|
InputStreamSource |
Ein InputStreamSource der ZIP-Datei mit den Fehlerbericht. Bei Fehlern wird null zurückgegeben. |
getBuildAlias
public String getBuildAlias ()
Rufen Sie den Alias des Builds ab, den das Gerät derzeit ausführt.
Der Build-Alias ist in der Regel eine lesbarere Zeichenfolge als die Build-ID (in der Regel eine Nummer für Nexus-Builds). Die endgültige Android-Version 4.2 hat beispielsweise den Build-Alias JDQ39 und die Build-ID 573038.
Returns | |
---|---|
String |
Den Build-Alias oder Fallback auf die Build-ID, wenn diese nicht abgerufen werden konnte |
Ausgabe | |
---|---|
DeviceNotAvailableException |
GetBuildFlavor
public String getBuildFlavor ()
Rufen Sie den Build-Flavor für das Gerät ab.
Returns | |
---|---|
String |
Den Build-Flavor oder null, wenn er nicht abgerufen werden konnte. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getBuildId
public String getBuildId ()
Rufen Sie den Build ab, den das Gerät derzeit ausführt.
Returns | |
---|---|
String |
Die Build-ID oder IBuildInfo#UNKNOWN_BUILD_ID , falls sie nicht abgerufen werden konnte |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getBuildSigningKeys
public String getBuildSigningKeys ()
Gibt den Schlüsseltyp zurück, der zum Signieren des Geräte-Images verwendet wurde
Android-Geräte können in der Regel mit Testschlüsseln (wie in AOSP) oder Release-Schlüsseln (von den einzelnen Geräteherstellern kontrolliert) signiert sein.
Returns | |
---|---|
String |
Signaturschlüssel, falls gefunden, andernfalls null. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
Gibt ein im Cache gespeichertes DeviceDescriptor
zurück, wenn das Gerät zugewiesen ist. Andernfalls wird der aktuelle DeviceDescriptor
zurückgegeben.
Returns | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Gibt ein im Cache gespeichertes DeviceDescriptor
zurück, wenn das Gerät zugewiesen ist. Andernfalls wird der aktuelle DeviceDescriptor
zurückgegeben.
Parameter | |
---|---|
shortDescriptor |
boolean : Gibt an, ob der Deskriptor auf das Minimum der Informationen beschränkt werden soll |
Returns | |
---|---|
DeviceDescriptor |
getChildren
public String[] getChildren (String path)
Eine Alternative zur Verwendung von IFileEntry
, die aufgrund von Berechtigungen manchmal nicht funktioniert.
Parameter | |
---|---|
path |
String : Pfad auf dem Gerät, in dem die Suche ausgeführt werden soll |
Returns | |
---|---|
String[] |
String-Array, das die gesamte Datei in einem Pfad auf dem Gerät enthält |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getConnection
public AbstractConnection getConnection ()
Die aktuelle Verbindung, die dem Gerät zugeordnet ist.
Returns | |
---|---|
AbstractConnection |
getContentProvider
public ContentProviderHandler getContentProvider (int userId)
Gibt ContentProviderHandler
oder null zurück, wenn nicht verfügbar.
Der Contentanbieter kann wiederverwendet werden, wenn er zuvor mit derselben userId
erstellt wurde.
Parameter | |
---|---|
userId |
int : Die Nutzer-ID, mit der der Contentanbieter initialisiert werden soll. |
Returns | |
---|---|
ContentProviderHandler |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Gibt den aktuellen faltbaren Status des Geräts oder null zurück, wenn Probleme aufgetreten sind.
Returns | |
---|---|
DeviceFoldableState |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getCurrentUser
public int getCurrentUser ()
Gibt die ID des aktuell ausgeführten Nutzers zurück. Falls ein Fehler auftritt, geben Sie -10000 zurück.
Returns | |
---|---|
int |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getDeviceClass
public String getDeviceClass ()
Rufen Sie die Geräteklasse ab.
Returns | |
---|---|
String |
Geräteklasse String . |
getDeviceDate
public long getDeviceDate ()
Gibt das Datum des Geräts in Millisekunden seit der Epoche zurück.
Returns | |
---|---|
long |
Das Datum des Geräts im Epochenformat. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getDeviceDescriptor,
public DeviceDescriptor getDeviceDescriptor ()
Gib ein DeviceDescriptor
aus den Geräteinformationen zurück, um Informationen zu erhalten, ohne das tatsächliche Geräteobjekt zu übergeben.
Returns | |
---|---|
DeviceDescriptor |
getDeviceDescriptor,
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Gib ein DeviceDescriptor
aus den Geräteinformationen zurück, um Informationen zu erhalten, ohne das tatsächliche Geräteobjekt zu übergeben.
Parameter | |
---|---|
shortDescriptor |
boolean : Gibt an, ob der Deskriptor auf das Minimum der Informationen beschränkt werden soll |
Returns | |
---|---|
DeviceDescriptor |
getDeviceState
public TestDeviceState getDeviceState ()
Rufen Sie den Status des Geräts ab.
Returns | |
---|---|
TestDeviceState |
getDeviceTimeOffset
public long getDeviceTimeOffset (Date date)
Hilfsfunktion, um den Zeitunterschied zwischen dem Gerät und einem bestimmten ERROR(/Date)
zu ermitteln. Verwenden Sie die Epochenzeit intern.
Parameter | |
---|---|
date |
Date |
Returns | |
---|---|
long |
Differenz in Millisekunden |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getEmulatorOutput
public InputStreamSource getEmulatorOutput ()
Stream für Emulatoren stdout und stderr abrufen
Returns | |
---|---|
InputStreamSource |
Emulatorausgabe |
getEmulatorProcess
public Process getEmulatorProcess ()
Geben Sie die Process
zurück, die diesem Emulator entspricht.
Returns | |
---|---|
Process |
Process oder null |
getExecuteShellCommandLog
public final File getExecuteShellCommandLog ()
Das Log, das alle executeShellCommand(String)
-Logs enthält.
Returns | |
---|---|
File |
GetExternalStoreFreeSpace
public long getExternalStoreFreeSpace ()
Hilfsmethode zum Ermitteln der Menge an freiem Speicherplatz im externen Gerätespeicher.
Returns | |
---|---|
long |
die Menge an freiem Speicherplatz in KB |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getFastbootPath
public String getFastbootPath ()
Gibt den Pfad der verwendeten Fastboot-Binärdatei zurück.
Damit die Schnellstart-Funktionen aktiviert sind, muss isFastbootEnabled()
weiterhin "true" sein.
Returns | |
---|---|
String |
getFastbootProductType (GetFastbootProductType)
public String getFastbootProductType ()
Praktische Methode zum Abrufen des Produkttyps dieses Geräts, wenn es sich im Schnellstartmodus (Fastboot mode) befindet.
Diese Methode sollte nur verwendet werden, wenn das Gerät im Schnellstartmodus (Fastboot mode) aktiviert sein soll. Dies ist eine etwas sicherere Variante als die generische getProductType()
-Methode in diesem Fall, da ITestDevice weiß, dass das Gerät in den Fastboot-Modus wiederhergestellt werden kann, wenn sich das Gerät im falschen Zustand befindet oder nicht reagiert.
Returns | |
---|---|
String |
den Namen des Produkttyps „String “ oder „null “, wenn er nicht ermittelt werden kann |
Ausgabe | |
---|---|
DeviceNotAvailableException |
GetFastbootProductVariant
public String getFastbootProductVariant ()
Praktische Methode zum Abrufen des Produkttyps dieses Geräts, wenn es sich im Schnellstartmodus (Fastboot mode) befindet.
Diese Methode sollte nur verwendet werden, wenn das Gerät im Schnellstartmodus (Fastboot mode) aktiviert sein soll. Dies ist eine etwas sicherere Variante als die generische getProductType()
-Methode in diesem Fall, da ITestDevice weiß, dass das Gerät in den Fastboot-Modus wiederhergestellt werden kann, wenn sich das Gerät im falschen Zustand befindet oder nicht reagiert.
Returns | |
---|---|
String |
den Namen des Produkttyps „String “ oder „null “, wenn er nicht ermittelt werden kann |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getFastbootSerialNumber (GetFastbootSerialNumber)
public String getFastbootSerialNumber ()
Gibt die Seriennummer des Fastboot-Modus zurück.
Returns | |
---|---|
String |
GetFastbootVariable
public String getFastbootVariable (String variableName)
Rufen Sie den angegebenen Wert der Fastboot-Variable vom Gerät ab.
Parameter | |
---|---|
variableName |
String : der Variablenname |
Returns | |
---|---|
String |
den Attributwert oder null , falls nicht vorhanden |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getFastbootVersion
public String getFastbootVersion ()
Gibt den Versionsstring der verwendeten Fastboot-Binärdatei zurück. Oder null, wenn ein Fehler auftritt.
Returns | |
---|---|
String |
getFileEntry
public IFileEntry getFileEntry (String path)
Rufen Sie einen Verweis auf eine Remote-Datei auf dem Gerät ab.
Parameter | |
---|---|
path |
String : der abzurufende Dateipfad. Kann ein absoluter Pfad oder Pfad relativ zu „/“ sein (d. h., sowohl die Syntax „/system“ als auch „system“ wird unterstützt) |
Returns | |
---|---|
IFileEntry |
IFileEntry oder null , wenn die Datei unter der angegebenen path nicht gefunden werden kann |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Inoffizielles Hilfsprogramm zum Abrufen eines FileEntry
aus einem Nicht-Root-Pfad. PROBLEM: Refaktorieren Sie das FileEntry-System, damit es über jeden Pfad verfügbar ist. (auch Nicht-Root-Zertifikate).
Parameter | |
---|---|
entry |
FileListingService.FileEntry : Ein FileEntry , das nicht unbedingt Root ist, wie von Ddmlib gefordert. |
Returns | |
---|---|
IFileEntry |
Ein FileEntryWrapper, der das FileEntry-Element darstellt. |
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getFoldableStates
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 verknüpfte ddmlib-IDevice
zurück.
Jedes Mal, wenn das Gerät die Verbindung zu ADB trennt und wieder eine Verbindung herstellt, kann von DDMS eine neue IDevice
zugewiesen werden. Aufrufer sollten daher keinen Verweis auf IDevice
beibehalten, da dieser Verweis möglicherweise veraltet ist.
Returns | |
---|---|
IDevice |
IDevice |
GetInstalldPackageNames
publicgetInstalledPackageNames ()
Rufen Sie die auf dem Gerät vorhandenen App-Paketnamen ab.
Returns | |
---|---|
|
ERROR(/Set) von String Paketnamen, die momentan auf dem Gerät installiert sind. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getIntProperty
public long getIntProperty (String name, long defaultValue)
Gibt einen ganzzahligen Wert der angegebenen Eigenschaft vom Gerät zurück.
Parameter | |
---|---|
name |
String : der Name der Property |
defaultValue |
long : Standardwert, der zurückgegeben wird, wenn das Attribut leer oder nicht vorhanden ist. |
Returns | |
---|---|
long |
Den Attributwert oder defaultValue , wenn das Attribut leer ist, nicht vorhanden ist oder keinen ganzzahligen Wert hat |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getIpAddress
public String getIpAddress ()
Ruft die IP-Adresse des Geräts ab.
Returns | |
---|---|
String |
Die IP-Adresse des Geräts oder null , wenn das Gerät keine IP-Adresse hat |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Gibt ein Objekt zurück, um den aktuellen Status des Keyguard oder null abzurufen, wenn dies nicht unterstützt wird.
Returns | |
---|---|
KeyguardControllerState |
Eine KeyguardControllerState mit einem Snapshot des Status des Keyguard und gibt Null zurück, wenn die Keyguard-Abfrage nicht unterstützt wird. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getLastErwarteteNeustartzeitMillis
public long getLastExpectedRebootTimeMillis ()
Gibt in Millisekunden zurück, wann die Tradefed APIs zuletzt einen Neustart ausgelöst haben, seit EPOCH von System.currentTimeMillis()
zurückgegeben wurde.
Returns | |
---|---|
long |
getLaunchApiLevel
public int getLaunchApiLevel ()
Das erste API-Level des Geräts abrufen. Die Standardeinstellung ist UNKNOWN_API_LEVEL
.
Returns | |
---|---|
int |
Eine Ganzzahl, die das erste gestartete API-Level des Geräts angibt |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getLogcat
public InputStreamSource getLogcat ()
Erfasst einen Snapshot-Stream der Logcat-Daten.
Funktioniert in zwei Modi:
TestDeviceOptions.getMaxLogcatDataSize()
Byte des aktuellen Inhalts der Hintergrund-Logcat-Erfassung zurückgegeben.
Returns | |
---|---|
InputStreamSource |
getLogcat
public InputStreamSource getLogcat (int maxBytes)
Erfasst einen Snapshot-Stream der letzten maxBytes
der erfassten Logcat-Daten.
Dies ist nützlich, wenn Sie häufige Snapshots der erfassten Logcat-Daten erfassen möchten, ohne dass durch das Abrufen des gesamten getLogcat()
-Snapshots die Speicherplatzstrafe erhöht wird.
Parameter | |
---|---|
maxBytes |
int : Die maximale Datenmenge, die zurückgegeben werden soll. Sollte ein Betrag sein, der bequem in den Arbeitsspeicher passt |
Returns | |
---|---|
InputStreamSource |
getLogcatDump
public InputStreamSource getLogcatDump ()
Dump des aktuellen Logcats für das Gerät abrufen Im Gegensatz zu getLogcat()
gibt diese Methode immer einen statischen Dump des Logcats zurück.
Hat den Nachteil, dass nichts zurückgegeben wird, wenn das Gerät nicht erreichbar ist.
Returns | |
---|---|
InputStreamSource |
Eine InputStreamSource der Logcat-Daten. Wenn die Logcat-Daten nicht erfasst werden können, wird ein leerer Stream zurückgegeben. |
getLogcatDa
public InputStreamSource getLogcatSince (long date)
Erfasst einen Snapshot-Stream erfasster Logcat-Daten ab dem angegebenen Datum. Die Uhrzeit auf dem Gerät sollte in getDeviceDate()
verwendet werden.
Parameter | |
---|---|
date |
long : in Millisekunden seit dem Epochenformat für den Start des Snapshots bis zum aktuellen Zeitpunkt.
(kann über 'Datum +%s' abgerufen werden) |
Returns | |
---|---|
InputStreamSource |
getMacAddress
public String getMacAddress ()
Gibt die MAC-Adresse des Geräts zurück. Wenn keine Abfrage vom Gerät durchgeführt werden kann, wird null zurückgegeben.
Returns | |
---|---|
String |
getMainUserId
public Integer getMainUserId ()
Gibt die Hauptnutzer-ID zurück.
Returns | |
---|---|
Integer |
Die userId des Hauptnutzers, falls vorhanden, und null, wenn es keinen Hauptnutzer gibt |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getMainlineModuleInfo
publicgetMainlineModuleInfo ()
Rufen Sie die Informationen zu den auf dem Gerät installierten Mainline-Modulen ab.
Returns | |
---|---|
|
Derzeit sind ERROR(/Set) von String Mainline-Modulen auf dem Gerät installiert. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfRunningUsersSupported
public int getMaxNumberOfRunningUsersSupported ()
Holen Sie sich die maximale Anzahl von Nutzern, die gleichzeitig ausgeführt werden. Die Standardeinstellung ist 0.
Returns | |
---|---|
int |
Eine Ganzzahl, die die Anzahl der gleichzeitig aktiven Nutzer angibt |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getMaxNumberOfUsersUnterstützt
public int getMaxNumberOfUsersSupported ()
Rufen Sie die maximale Anzahl der unterstützten Nutzer ab. Die Standardeinstellung ist 0.
Returns | |
---|---|
int |
Eine Ganzzahl, die die Anzahl der unterstützten Nutzer angibt |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getMicrodroidProcess
public Process getMicrodroidProcess ()
Returns | |
---|---|
Process |
Gibt den Prozess der Microdroid-VM zurück. Wenn TestDevice kein Microdroid ist, wird null zurückgegeben. |
getMonitor
public IDeviceStateMonitor getMonitor ()
Gib die IDeviceStateMonitor
zurück, die dem Gerät zugeordnet ist.
Returns | |
---|---|
IDeviceStateMonitor |
MountPoint abrufen
public String getMountPoint (String mountName)
Gibt einen Bereitstellungspunkt zurück.
Fragt das Gerät direkt ab, wenn die im Cache gespeicherten Informationen in IDevice
nicht verfügbar sind.
AUFGABE: Dieses Verhalten auf IDevice#getMountPoint(String)
verschieben
Parameter | |
---|---|
mountName |
String : der Name des Bereitstellungspunkts |
Returns | |
---|---|
String |
den Bereitstellungspunkt oder null |
MountPointInfo abrufen
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Gibt ein MountPointInfo
zurück, das dem angegebenen Bereitstellungspunktpfad entspricht, oder null
, wenn in diesem Pfad nichts bereitgestellt ist oder anderweitig nicht in /proc/mounts als Bereitstellungspunkt angezeigt wird.
Parameter | |
---|---|
mountpoint |
String |
Returns | |
---|---|
ITestDevice.MountPointInfo |
Ein ERROR(/List) von MountPointInfo mit den Informationen in „/proc/mounts“ |
Ausgabe | |
---|---|
DeviceNotAvailableException |
MountPointInfo abrufen
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 ()
Rufe die Testoptionen für das Gerät ab.
Returns | |
---|---|
TestDeviceOptions |
TestDeviceOptions bezieht sich auf das zu testende Gerät. |
getPartitionFreeSpace
public long getPartitionFreeSpace (String partition)
Hilfsmethode zum Ermitteln der Menge an freiem Speicherplatz auf der Gerätepartition.
Parameter | |
---|---|
partition |
String |
Returns | |
---|---|
long |
die Menge an freiem Speicherplatz in KB |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getPrimaryUserId (Primäre Nutzer-ID)
public Integer getPrimaryUserId ()
Gibt die primäre Nutzer-ID zurück.
Returns | |
---|---|
Integer |
Die userId des primären Nutzers (falls vorhanden) und null, wenn kein Primärnutzer vorhanden ist |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getProcessByName
public ProcessInfo getProcessByName (String processName)
Die Hilfsmethode führt die Befehle "pidof" und "stat" aus und gibt das Objekt ProcessInfo
mit PID und Prozessstartzeit des angegebenen Prozesses zurück.
Parameter | |
---|---|
processName |
String : der String des Vorgangsnamens. |
Returns | |
---|---|
ProcessInfo |
ProcessInfo zu angegebenem processName |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getProcessPid
public String getProcessPid (String process)
Gibt die PID des Dienstes oder null zurück, wenn ein Fehler aufgetreten ist.
Parameter | |
---|---|
process |
String : Der String des Vorgangsnamens. |
Returns | |
---|---|
String |
Ausgabe | |
---|---|
DeviceNotAvailableException |
GetProductType
public String getProductType ()
Praktische Methode zum Abrufen des Produkttyps dieses Geräts.
Diese Methode funktioniert, wenn sich das Gerät entweder im ADB- oder im Schnellstartmodus (Fastboot mode) befindet.
Returns | |
---|---|
String |
den Namen des Produkttyps String . Ist nicht null |
Ausgabe | |
---|---|
DeviceNotAvailableException |
GetProductVariant
public String getProductVariant ()
Praktische Methode zum Abrufen der Produktvariante dieses Geräts.
Diese Methode funktioniert, wenn sich das Gerät entweder im ADB- oder im Schnellstartmodus (Fastboot mode) befindet.
Returns | |
---|---|
String |
den String -Namen der Produktvariante oder null , wenn er nicht ermittelt werden kann |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getProperty
public String getProperty (String name)
Ruft den angegebenen Attributwert vom Gerät ab.
Parameter | |
---|---|
name |
String : der Name der Property |
Returns | |
---|---|
String |
den Attributwert oder null , falls nicht vorhanden |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getRecoveryMode
public ITestDevice.RecoveryMode getRecoveryMode ()
Rufen Sie den aktuellen Wiederherstellungsmodus des Geräts ab.
Returns | |
---|---|
ITestDevice.RecoveryMode |
den aktuellen Wiederherstellungsmodus des Geräts. |
getScreenshot
public InputStreamSource getScreenshot (String format)
Erstellt einen Screenshot vom Gerät. Es wird empfohlen, stattdessen getScreenshot(format) mit der JPEG-Codierung für eine kleinere Größe zu verwenden.
Parameter | |
---|---|
format |
String : unterstützte PNG- und JPEG-Dateien |
Returns | |
---|---|
InputStreamSource |
InputStreamSource des Screenshots im Format oder null , wenn der Screenshot nicht erfolgreich war. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Erstellt einen Screenshot von der angegebenen Anzeige-ID des Geräts. Das Format ist PNG.
AUFGABE: Erweitern Sie die oben genannten Implementierungen, um "format" und "rescale" zu unterstützen
Parameter | |
---|---|
displayId |
long : die Anzeige-ID des Bildschirms, von dem ein Screenshot erstellt werden soll. |
Returns | |
---|---|
InputStreamSource |
InputStreamSource des Screenshots im Format oder null , wenn der Screenshot nicht erfolgreich war. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot (String format, boolean rescale)
Erstellt einen Screenshot vom Gerät. Wir empfehlen, stattdessen getScreenshot(String)
mit JPEG-Codierung für eine kleinere Größe zu verwenden.
Parameter | |
---|---|
format |
String : unterstützte PNG- und JPEG-Dateien |
rescale |
boolean : ob der Screenshot neu skaliert werden soll, um die Größe des resultierenden Bildes zu verringern |
Returns | |
---|---|
InputStreamSource |
InputStreamSource des Screenshots im Format oder null , wenn der Screenshot nicht erfolgreich war. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot ()
Erstellt einen Screenshot vom Gerät.
Returns | |
---|---|
InputStreamSource |
InputStreamSource des Screenshots im PNG-Format oder null , wenn der Screenshot nicht erfolgreich erstellt werden konnte. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getSerialNumber
public String getSerialNumber ()
Eine praktische Methode zum Abrufen der Seriennummer dieses Geräts.
Returns | |
---|---|
String |
die String -Seriennummer |
getSetting
public String getSetting (int userId, String namespace, String key)
Gibt den Wert der angeforderten Einstellung zurück. Namespace muss einen der folgenden Werte haben: {"system", "secure", "global"}
Parameter | |
---|---|
userId |
int |
namespace |
String |
key |
String |
Returns | |
---|---|
String |
Wert, der mit „namespace:key“ eines Nutzers verknüpft ist. Null, wenn nicht gefunden. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getSetting
public String getSetting (String namespace, String key)
Siehe getSetting(int, String, String)
und wird für einen Systemnutzer ausgeführt.
Parameter | |
---|---|
namespace |
String |
key |
String |
Returns | |
---|---|
String |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getSimOperator
public String getSimOperator ()
Geben Sie den Anbieter der SIM-Karte zurück oder null, wenn dieser nicht verfügbar ist oder das Gerät nicht verfügbar ist.
Returns | |
---|---|
String |
getSimState
public String getSimState ()
Gib den Status der SIM-Karte oder den Wert "null" zurück, falls nicht verfügbar oder das Gerät nicht verfügbar ist.
Returns | |
---|---|
String |
Tombstones abrufen
publicgetTombstones ()
Die Liste der Tombstones von den Geräten abrufen und zurückgeben. Erfordert Root.
ist Best-Effort-Methode. Wenn ein Tombstone aus irgendeinem Grund nicht abgerufen werden kann, fehlt er in der Liste. Nur DeviceNotAvailableException
beendet die Methode vorzeitig.
Returns | |
---|---|
|
Eine Liste von Tombstone-Dateien, leer, wenn keine Tombstone-Dateien vorhanden sind. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getTotalMemory
public long getTotalMemory ()
Gibt die Gesamtgröße des physischen Arbeitsspeichers in Byte oder -1 bei einem internen Fehler zurück.
Returns | |
---|---|
long |
getUninstallablePackageNames
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 derzeit auf dem Gerät installierten String -Paketnamen, die deinstalliert werden können. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getUseFastbootDELETE
public boolean getUseFastbootErase ()
Legen Sie fest, ob eine Partition auf dem Gerät mit der Funktion „Fastboot Deletion“ oder „Fastboot“ gelöscht werden soll.
Returns | |
---|---|
boolean |
true , wenn die Daten über Fastboot gelöscht werden, oder false , wenn das Schnellstart-Format verwendet wird. |
getUserFlags
public int getUserFlags (int userId)
Findet die Flags eines bestimmten Nutzers und gibt sie zurück. Flags werden im Android Open Source Project in der Klasse „android.content.pm.UserInfo“ definiert.
Parameter | |
---|---|
userId |
int |
Returns | |
---|---|
int |
Die Flags, die mit der angegebenen Nutzer-ID verknüpft sind, falls gefunden, andernfalls „-10000“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getUserInfos (Nutzerinformationen abrufen)
publicgetUserInfos ()
Ruft die Map of useId zu UserInfo
auf dem Gerät ab. DeviceRuntimeException
wird ausgegeben, wenn die Ausgabe vom Gerät nicht wie erwartet ist.
Returns | |
---|---|
|
Die Liste der UserInfo-Objekte. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Gibt die Seriennummer zurück, die der userId zugeordnet ist, falls sie gefunden wird; in allen anderen Fällen -10000.
Parameter | |
---|---|
userId |
int |
Returns | |
---|---|
int |
Ausgabe | |
---|---|
DeviceNotAvailableException |
HandleAllocationEvent (HandleAllocationEvent)
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
Verarbeitet das angegebene DeviceEvent. Kann das Gerät auf einen neuen Zustand zurücksetzen. Informiert IDeviceMonitor
über etwaige Statusübergänge.
DeviceEvent verarbeiten, wodurch dieses Gerät möglicherweise in einen neuen Zuweisungsstatus geändert wird.
Parameter | |
---|---|
event |
DeviceEvent |
Returns | |
---|---|
IManagedTestDevice.DeviceEventResponse |
hasFeature
public boolean hasFeature (String feature)
Prüfen, ob eine Funktion auf einem Gerät verfügbar ist
Parameter | |
---|---|
feature |
String : Gibt an, welches Format direkt „feature: |
Returns | |
---|---|
boolean |
"True", wenn das Feature gefunden wird, andernfalls "False". |
Ausgabe | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
Ein Android-Paket auf dem Gerät installieren
Parameter | |
---|---|
packageFile |
File : die zu installierende APK-Datei |
reinstall |
boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“. |
Returns | |
---|---|
String |
ein String mit einem Fehlercode oder null , wenn der Vorgang erfolgreich ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Ein Android-Paket auf dem Gerät installieren
Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, in denen das Erteilen von Laufzeitberechtigungen zum Zeitpunkt der Installation explizit gesteuert werden muss.
Parameter | |
---|---|
packageFile |
File : die zu installierende APK-Datei |
reinstall |
boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions |
boolean : wenn bei der Installation alle Laufzeitberechtigungen gewährt werden sollen |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“. |
Returns | |
---|---|
String |
ein String mit einem Fehlercode oder null , wenn der Vorgang erfolgreich ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
installPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)
Ein Android-Paket für einen bestimmten Nutzer auf dem Gerät installieren
Parameter | |
---|---|
packageFile |
File : die zu installierende APK-Datei |
reinstall |
boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
userId |
int : die ganzzahlige Nutzer-ID, für die die Installation durchgeführt werden soll. |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“. |
Returns | |
---|---|
String |
ein String mit einem Fehlercode oder null , wenn der Vorgang erfolgreich ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
installPackageForUser
public String installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Ein Android-Paket für einen bestimmten Nutzer auf dem Gerät installieren
Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, in denen das Erteilen von Laufzeitberechtigungen zum Zeitpunkt der Installation explizit gesteuert werden muss.
Parameter | |
---|---|
packageFile |
File : die zu installierende APK-Datei |
reinstall |
boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions |
boolean : wenn bei der Installation alle Laufzeitberechtigungen gewährt werden sollen |
userId |
int : die ganzzahlige Nutzer-ID, für die die Installation durchgeführt werden soll. |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“. |
Returns | |
---|---|
String |
ein String mit einem Fehlercode oder null , wenn der Vorgang erfolgreich ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
invalidPropertyCache
public void invalidatePropertyCache ()
isAdbTcp
public boolean isAdbTcp ()
Returns | |
---|---|
boolean |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Prüfen, ob die Plattform auf dem Gerät die Auflistung von Apps unterstützt
Returns | |
---|---|
boolean |
„True“, wenn die App-Enumeration unterstützt wird, andernfalls „False“ |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isBypassLowTargetSdkBlockSupported (IsBypassLowTargetSdkBlockSupported)
public boolean isBypassLowTargetSdkBlockSupported ()
Prüfen, ob die Plattform auf dem Gerät das Umgehen eines niedrigen SDK-Zielblocks bei App-Installationen unterstützt
Returns | |
---|---|
boolean |
„True“, wenn das Umgehen einer niedrigen SDK-Blockierung unterstützt wird, andernfalls „False“ |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isDebugfsMounted
public boolean isDebugfsMounted ()
Prüfen Sie, ob debugfs bereitgestellt ist.
Returns | |
---|---|
boolean |
true , wenn debugfs bereitgestellt ist |
Ausgabe | |
---|---|
DeviceNotAvailableException |
IsDeviceEncrypted
public boolean isDeviceEncrypted ()
Gibt an, ob das Gerät verschlüsselt ist.
Returns | |
---|---|
boolean |
true , wenn das Gerät verschlüsselt ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isDirectory
public boolean isDirectory (String path)
Gibt „True“ zurück, wenn der Pfad auf dem Gerät ein Verzeichnis ist, andernfalls „false“.
Parameter | |
---|---|
path |
String |
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isEnableAdbRoot
public boolean isEnableAdbRoot ()
Returns | |
---|---|
boolean |
true , wenn der ADB-Root auf dem Gerät aktiviert werden soll |
isEncryptionSupported
public boolean isEncryptionSupported ()
Gibt zurück, wenn die Verschlüsselung auf dem Gerät unterstützt wird.
Returns | |
---|---|
boolean |
true , wenn das Gerät Verschlüsselung unterstützt. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isExecutable (Kann ausgeführt werden)
public boolean isExecutable (String fullPath)
Gibt "True" zurück, wenn der Dateipfad auf dem Gerät eine ausführbare Datei ist, andernfalls "False".
Parameter | |
---|---|
fullPath |
String |
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isFastbootEnabled
public boolean isFastbootEnabled ()
Rückgabe, wenn Fastboot für das Gerät verfügbar ist.
Returns | |
---|---|
boolean |
ist monitorlos
public boolean isHeadless ()
Gibt „true“ zurück, wenn das Gerät monitorlos ist (kein Bildschirm), andernfalls „false“.
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Gibt an, ob das Gerät den monitorlosen Systemnutzermodus verwendet.
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Gibt zurück, ob der Hauptnutzer ein dauerhafter Administrator ist und weder gelöscht noch auf einen Nicht-Administratorstatus herabgestuft werden kann.
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isMultiUserSupported
public boolean isMultiUserSupported ()
Legt fest, ob mehrere Nutzer unterstützt werden.
Returns | |
---|---|
boolean |
„true“, wenn mehrere Nutzer unterstützt werden, andernfalls „false“ |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isPackageInstalliert
public boolean isPackageInstalled (String packageName, String userId)
Frag das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID ab, um zu prüfen, ob es bei diesem Nutzer derzeit installiert ist oder nicht.
Parameter | |
---|---|
packageName |
String : Das Paket, das geprüft wird, ob es installiert ist. |
userId |
String : Die Nutzer-ID, auf die geprüft wird, ob das Paket installiert ist. Wenn dieser Wert null ist, wird für den primären Nutzer null verwendet. |
Returns | |
---|---|
boolean |
„True“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isPackageInstalliert
public boolean isPackageInstalled (String packageName)
Fragen Sie das Gerät nach einem bestimmten Paketnamen ab, um zu prüfen, ob es derzeit installiert ist.
Parameter | |
---|---|
packageName |
String |
Returns | |
---|---|
boolean |
„True“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isRuntimePermissionSupported
public boolean isRuntimePermissionSupported ()
Prüfen, ob die Plattform auf dem Gerät die Gewährung von Laufzeitberechtigungen unterstützt
Returns | |
---|---|
boolean |
„True“, wenn Laufzeitberechtigungen unterstützt werden, andernfalls „False“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isStateBootloaderOrFastbootd
public boolean isStateBootloaderOrFastbootd ()
Gibt „true“ zurück, wenn sich das Gerät in TestDeviceState#FASTBOOT
oder TestDeviceState.FASTBOOTD
befindet.
Returns | |
---|---|
boolean |
isUserRunning
public boolean isUserRunning (int userId)
Prüfen Sie, ob ein bestimmter Nutzer ausgeführt wird.
Parameter | |
---|---|
userId |
int |
Returns | |
---|---|
boolean |
"True", wenn der Nutzer ausgeführt wird, "False" in allen anderen Fällen. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
istUserSekundär
public boolean isUserSecondary (int userId)
Gibt zurück, ob der angegebene Nutzer gemäß seinen Flags ein sekundärer Nutzer ist.
Parameter | |
---|---|
userId |
int |
Returns | |
---|---|
boolean |
„true“, wenn der Nutzer ein sekundärer Nutzer ist, andernfalls „false“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isUserVisible
public boolean isUserVisible (int userId)
Prüft, ob der angegebene Nutzer sichtbar ist.
Ein „sichtbarer“ Nutzer ist ein Nutzer, der mit dem „menschlichen“ Nutzer interagiert und daher Startaktivitäten starten kann (normalerweise in der Standardanzeige).
Parameter | |
---|---|
userId |
int |
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId, int displayId)
Prüft, ob der angegebene Nutzer auf dem Display sichtbar ist.
Ein „sichtbarer“ Nutzer ist ein Nutzer, der mit dem „menschlichen“ Nutzer interagiert und daher in dieser Anzeige Aktivitäten starten kann.
Parameter | |
---|---|
userId |
int |
displayId |
int |
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isVisibleBackgroundUsersOnDefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
Gibt an, ob auf dem Gerät Nutzer gestartet werden können, die im Hintergrund im ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
sichtbar sind.
In diesem Fall könnten Sie startVisibleBackgroundUser(int, int, boolean)
aufrufen und eine von listDisplayIdsForStartingVisibleBackgroundUsers()
zurückgegebene Anzeige übergeben, die ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
enthalten sollte.
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
IsVisibleBackgroundUsersSupported
public boolean isVisibleBackgroundUsersSupported ()
Gibt an, ob auf dem Gerät Nutzer im Hintergrund sichtbar gemacht werden können.
In diesem Fall könnten Sie startVisibleBackgroundUser(int, int, boolean)
aufrufen und eine von listDisplayIdsForStartingVisibleBackgroundUsers()
zurückgegebene Anzeige übergeben.
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isWifiEnabled
public boolean isWifiEnabled ()
Teste, ob WLAN aktiviert ist.
Prüft, ob auf dem Gerät WLAN aktiviert ist. Nützlich zur Bestätigung des WLAN-Status vor Tests, die nicht mit dem WLAN durchgeführt werden sollten, z.B. Tests für mobile Daten.
Returns | |
---|---|
boolean |
true , wenn WLAN aktiviert ist. false , wenn deaktiviert |
Ausgabe | |
---|---|
DeviceNotAvailableException |
listDisplayIds
publiclistDisplayIds ()
Erfassen Sie die Liste der verfügbaren Anzeige-IDs auf dem Gerät, wie von „dumpsys SurfaceFlinger“ gemeldet.
Returns | |
---|---|
|
Die Liste der Bildschirme. Die Standardeinstellung gibt immer die Standardanzeige 0 zurück. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
listDisplayIdsForStartingVisibleBackgroundUsers
publiclistDisplayIdsForStartingVisibleBackgroundUsers ()
Ruft die Liste der Bildschirme ab, die zum 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. Gibt DeviceRuntimeException
aus, wenn die Ausgabe vom Gerät nicht wie erwartet ist.
Returns | |
---|---|
|
der Liste der Nutzer-IDs. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Loganr
public boolean logAnrs (ITestLogger logger)
Erfasst und protokolliert ANR-Fehler vom Gerät.
Parameter | |
---|---|
logger |
ITestLogger : Ein ITestLogger zum Protokollieren der ANR-Fehler. |
Returns | |
---|---|
boolean |
Der Wert ist "True", wenn das Logging erfolgreich war, andernfalls "False". |
Ausgabe | |
---|---|
DeviceNotAvailableException |
logBugreport
public boolean logBugreport (String dataName, ITestLogger listener)
Hilfsmethode, um einen Fehlerbericht zu erstellen und bei den Reportern zu protokollieren.
Parameter | |
---|---|
dataName |
String ist der Name, unter dem der Fehlerbericht gemeldet wird. |
listener |
ITestLogger : Ein ITestLogger zum Protokollieren des Fehlerberichts. |
Returns | |
---|---|
boolean |
Der Wert ist "True", wenn das Logging erfolgreich war, andernfalls "False". |
LogOnDevice
public void logOnDevice (String tag, Log.LogLevel level, String format, Object... args)
Protokolliert eine Nachricht im Logcat des Geräts. Dies ist ein sicherer Aufruf, der auch dann nicht ausgelöst wird, wenn das Logging fehlschlägt.
Parameter | |
---|---|
tag |
String : Das Tag, unter dem wir die Nachricht im Logcat protokollieren. |
level |
Log.LogLevel : Die Debug-Ebene der Nachricht im Logcat. |
format |
String : Das Nachrichtenformat. |
args |
Object : die Argumente, die durch String.format() ersetzt werden sollen. |
mountDebugfs
public void mountDebugfs ()
Stellen Sie debugfs bereit.
Ausgabe | |
---|---|
DeviceNotAvailableException |
Neustart ohne Blockierung
public void nonBlockingReboot ()
Gibt einen Befehl zum Neustart des Geräts aus und wird zurückgegeben, wenn der Befehl abgeschlossen ist und das Gerät für ADB nicht mehr sichtbar ist.
Ausgabe | |
---|---|
DeviceNotAvailableException |
postAdbRootAction (Post-AdbRootAction)
public void postAdbRootAction ()
Überschreibt, wenn das Gerät bestimmte Aktionen nach dem ADB-Root ausführen und bevor das Gerät wieder online ist. Die Standardimplementierung enthält keine Hinzufügungsaktionen. Es kann nicht garantiert werden, dass der adb-Stamm zu diesem Zeitpunkt aktiviert ist.
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
postAdbUnrootAction
public void postAdbUnrootAction ()
Diese Einstellung kann überschrieben werden, wenn nach dem Aufheben des Root-Vorgangs von ADB und bevor das Gerät wieder online ist, bestimmte Aktionen ausgeführt werden müssen. Die Standardimplementierung enthält keine zusätzlichen Aktionen. Es kann nicht garantiert werden, dass der adb-Root zu diesem Zeitpunkt deaktiviert ist.
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
PostBoot-Einrichtung
public void postBootSetup ()
Führen Sie die Anweisungen aus, um das Gerät nach jedem Start so zu konfigurieren, dass es getestet wird.
Sollte aufgerufen werden, nachdem das Gerät vollständig gestartet/verfügbar ist
Unter normalen Umständen muss diese Methode nicht explizit aufgerufen werden, da Implementierungen diese Schritte beim Neustart automatisch ausführen sollten.
Er muss möglicherweise aufgerufen werden, wenn das Gerät aufgrund anderer Ereignisse neu startet (z. B. wenn ein fastboot-Updatebefehl abgeschlossen wurde).
Ausgabe | |
---|---|
DeviceNotAvailableException |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach dem Aufruf ausgeführt wird.
Parameter | |
---|---|
exception |
Throwable : falls vorhanden, die letzte durch den Aufruffehler ausgelöste Ausnahme. |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Zusätzliche Schritte für die gerätespezifische erforderliche Einrichtung, die vor dem Aufruffluss auf dem Gerät ausgeführt werden.
Parameter | |
---|---|
info |
IBuildInfo : Die IBuildInfo des Geräts. |
attributes |
MultiMap : die im Aufrufkontext gespeicherten Attribute |
Ausgabe | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
PullDir
public boolean pullDir (String deviceFilePath, File localDir, int userId)
Verzeichnisinhalte rekursiv vom Gerät abrufen.
Parameter | |
---|---|
deviceFilePath |
String : der absolute Dateipfad der Remote-Quelle |
localDir |
File : das lokale Verzeichnis, in das Dateien abgerufen werden sollen |
userId |
int : die Nutzer-ID, aus der abgerufen werden soll |
Returns | |
---|---|
boolean |
true , wenn die Datei abgerufen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
PullDir
public boolean pullDir (String deviceFilePath, File localDir)
Verzeichnisinhalte rekursiv vom Gerät abrufen.
Parameter | |
---|---|
deviceFilePath |
String : der absolute Dateipfad der Remote-Quelle |
localDir |
File : das lokale Verzeichnis, in das Dateien abgerufen werden sollen |
Returns | |
---|---|
boolean |
true , wenn die Datei abgerufen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Pull-Datei
public boolean pullFile (String remoteFilePath, File localFile)
Ruft eine Datei vom Gerät ab.
Parameter | |
---|---|
remoteFilePath |
String : der absolute Pfad zur Datei auf dem Gerät. |
localFile |
File : Die lokale Datei, in der Inhalte gespeichert werden sollen. Wenn das Feld nicht leer ist, werden Inhalte ersetzt. |
Returns | |
---|---|
boolean |
true , wenn die Datei abgerufen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Pull-Datei
public File pullFile (String remoteFilePath, int userId)
Ruft eine Datei vom Gerät ab, speichert sie in einer lokalen temporären ERROR(/File)
und gibt diese File
zurück.
Parameter | |
---|---|
remoteFilePath |
String : der absolute Pfad zur Datei auf dem Gerät. |
userId |
int : Die Nutzer-ID, aus der abgerufen werden soll |
Returns | |
---|---|
File |
Ein ERROR(/File) mit dem Inhalt der Gerätedatei oder null , wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem) |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Pull-Datei
public File pullFile (String remoteFilePath)
Ruft eine Datei vom Gerät ab, speichert sie in einer lokalen temporären ERROR(/File)
und gibt diese File
zurück.
Parameter | |
---|---|
remoteFilePath |
String : der absolute Pfad zur Datei auf dem Gerät. |
Returns | |
---|---|
File |
Ein ERROR(/File) mit dem Inhalt der Gerätedatei oder null , wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem) |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Pull-Datei
public boolean pullFile (String remoteFilePath, File localFile, int userId)
Ruft eine Datei vom Gerät ab.
Parameter | |
---|---|
remoteFilePath |
String : der absolute Pfad zur Datei auf dem Gerät. |
localFile |
File : Die lokale Datei, in der Inhalte gespeichert werden sollen. Wenn das Feld nicht leer ist, werden Inhalte ersetzt. |
userId |
int : Die Nutzer-ID, aus der abgerufen werden soll |
Returns | |
---|---|
boolean |
true , wenn die Datei abgerufen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
PullFileContents
public String pullFileContents (String remoteFilePath)
Ruft eine Datei vom Gerät ab und gibt den Inhalt zurück.
Parameter | |
---|---|
remoteFilePath |
String : der absolute Pfad zur Datei auf dem Gerät. |
Returns | |
---|---|
String |
Ein String mit dem Inhalt der Gerätedatei oder null , wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem) |
Ausgabe | |
---|---|
DeviceNotAvailableException |
PullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
Eine praktische Methode, um eine Datei aus dem externen Speicher des Geräts abzurufen, sie in einer lokalen temporären ERROR(/File)
zu speichern und einen Verweis auf diese File
zurückzugeben.
Parameter | |
---|---|
remoteFilePath |
String : Pfad zur Datei auf dem Gerät, relativ zum Bereitstellungspunkt des externen Speichers |
Returns | |
---|---|
File |
Ein ERROR(/File) mit dem Inhalt der Gerätedatei oder null , wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem) |
Ausgabe | |
---|---|
DeviceNotAvailableException |
PushDir
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
Verzeichnisinhalte werden rekursiv auf das Gerät übertragen und gleichzeitig einige gefilterte Verzeichnisse ausgeschlossen.
Parameter | |
---|---|
localFileDir |
File : das lokale Verzeichnis, das übertragen werden soll |
deviceFilePath |
String : der absolute Dateipfad des Remote-Ziels |
excludedDirectories |
: Satz ausgeschlossener Verzeichnisnamen, die nicht übertragen werden sollen. |
Returns | |
---|---|
boolean |
true , wenn die Datei übertragen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
PushDir
public boolean pushDir (File localFileDir, String deviceFilePath)
Verzeichnisinhalte rekursiv auf das Gerät übertragen.
Parameter | |
---|---|
localFileDir |
File : das lokale Verzeichnis, das übertragen werden soll |
deviceFilePath |
String : der absolute Dateipfad des Remote-Ziels |
Returns | |
---|---|
boolean |
true , wenn die Datei übertragen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
PushDir
public boolean pushDir (File localFileDir, String deviceFilePath, int userId)
Verzeichnisinhalte rekursiv auf das Gerät übertragen.
Parameter | |
---|---|
localFileDir |
File : das lokale Verzeichnis, das übertragen werden soll |
deviceFilePath |
String : der absolute Dateipfad des Remote-Ziels |
userId |
int : die Nutzer-ID, an die übertragen werden soll |
Returns | |
---|---|
boolean |
true , wenn die Datei übertragen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Push-Datei
public boolean pushFile (File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Variante von pushFile(File, String)
, die optional den Bedarf an den Contentanbieter prüfen kann
Parameter | |
---|---|
localFile |
File : die lokale Datei, die übertragen werden soll |
remoteFilePath |
String : der absolute Dateipfad des Remote-Ziels |
evaluateContentProviderNeeded |
boolean : ob geprüft werden soll, ob der Contentanbieter benötigt wird |
Returns | |
---|---|
boolean |
true , wenn die Datei übertragen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Push-Datei
public boolean pushFile (File localFile, String remoteFilePath)
Übertragen Sie eine Datei per Push auf das Gerät. Standardmäßig wird ein Contentanbieter verwendet.
Parameter | |
---|---|
localFile |
File : die lokale Datei, die übertragen werden soll |
remoteFilePath |
String : der absolute Dateipfad des Remote-Ziels |
Returns | |
---|---|
boolean |
true , wenn die Datei übertragen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Push-Datei
public boolean pushFile (File localFile, String remoteFilePath, int userId)
Übertragen Sie eine Datei per Push auf das Gerät. Standardmäßig wird ein Contentanbieter verwendet.
Parameter | |
---|---|
localFile |
File : die lokale Datei, die übertragen werden soll |
remoteFilePath |
String : der absolute Dateipfad des Remote-Ziels |
userId |
int : die Nutzer-ID, an die übertragen werden soll |
Returns | |
---|---|
boolean |
true , wenn die Datei übertragen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Push-String
public boolean pushString (String contents, String remoteFilePath)
Aus einem String erstellte Datei per Push an Gerät übertragen
Parameter | |
---|---|
contents |
String : der Inhalt der zu übertragenden Datei |
remoteFilePath |
String : der absolute Dateipfad des Remote-Ziels |
Returns | |
---|---|
boolean |
true , wenn der String erfolgreich übertragen wurde. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
neu starten
public void reboot (String reason)
Startet das Gerät im ADB-Modus neu, wobei die angegebenen reason
bei jedem Neustart beibehalten werden.
Wird blockiert, bis das Gerät verfügbar ist.
Der Grund für den letzten Neustart kann durch Abfrage der sys.boot.reason
-Eigenschaft abgerufen werden.
Parameter | |
---|---|
reason |
String : ein Grund für diesen Neustart oder null , wenn kein Grund angegeben ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
neu starten
public void reboot ()
Startet das Gerät im ADB-Modus neu.
Wird blockiert, bis das Gerät verfügbar ist.
Ausgabe | |
---|---|
DeviceNotAvailableException |
NeustartIntoBootloader
public void rebootIntoBootloader ()
Startet das Gerät im Bootloader-Modus neu.
Wird blockiert, bis sich das Gerät im Bootloader-Modus befindet.
Ausgabe | |
---|---|
DeviceNotAvailableException |
NeustartIntoFastbootd
public void rebootIntoFastbootd ()
Startet das Gerät im Fastbootd-Modus neu.
Blockiert, bis sich das Gerät im Fastbootd-Modus befindet.
Ausgabe | |
---|---|
DeviceNotAvailableException |
NeustartIntoRecovery
public void rebootIntoRecovery ()
Das Gerät wird im ADB-Wiederherstellungsmodus neu gestartet.
Blockiert, bis das Gerät mit der Wiederherstellung beginnt
Ausgabe | |
---|---|
DeviceNotAvailableException |
NeustartIntoSideload
public void rebootIntoSideload ()
Startet das Gerät im ADB-Sideload-Modus neu. Beachten Sie, dass dies ein spezieller Modus für die Wiederherstellung ist.
Wird blockiert, bis das Gerät in den Sideload-Modus wechselt
Ausgabe | |
---|---|
DeviceNotAvailableException |
NeustartIntoSideload
public void rebootIntoSideload (boolean autoReboot)
Startet das Gerät im ADB-Sideload-Modus neu. Beachten Sie, dass dies ein spezieller Modus für die Wiederherstellung ist.
Wird blockiert, bis das Gerät in den Sideload-Modus wechselt
Parameter | |
---|---|
autoReboot |
boolean : ob das Gerät nach dem Sideload automatisch neu gestartet werden soll |
Ausgabe | |
---|---|
DeviceNotAvailableException |
NeustartUntilOnline
public void rebootUntilOnline ()
Eine Alternative zu reboot()
, die nur blockiert, bis das Gerät online ist, d. h. für ADB.
Ausgabe | |
---|---|
DeviceNotAvailableException |
NeustartUntilOnline
public void rebootUntilOnline (String reason)
Eine Alternative zu reboot()
, die nur blockiert, bis das Gerät online ist, d. h. für ADB.
Parameter | |
---|---|
reason |
String : ein Grund für diesen Neustart oder null , wenn kein Grund angegeben ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Nutzerbereich neu starten
public void rebootUserspace ()
Startet nur den Userspace-Teil des Geräts neu.
Wird blockiert, bis das Gerät verfügbar ist.
WARNUNG. Der Neustart des Userspaces wird derzeit aktiv entwickelt. Sie können ihn auf eigenes Risiko verwenden.
Ausgabe | |
---|---|
DeviceNotAvailableException |
NeustartUserspaceUntilOnline
public void rebootUserspaceUntilOnline ()
Eine Alternative zu rebootUserspace()
()}, die nur blockiert, bis das Gerät online ist, d. h. für ADB.
Ausgabe | |
---|---|
DeviceNotAvailableException |
Gerät wiederherstellen
public boolean recoverDevice ()
Versuche, die Gerätekommunikation wiederherzustellen.
Returns | |
---|---|
boolean |
„True“, wenn die Wiederherstellung erfolgreich war, und „False“, wenn die Wiederherstellung übersprungen wurde |
Ausgabe | |
---|---|
DeviceNotAvailableException |
wenn das Gerät nicht mehr verfügbar ist |
RegisterDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Registriert eine IDeviceActionReceiver
für dieses Gerät.
Alle registrierten IDeviceActionReceiver
s werden benachrichtigt, bevor eine Geräteaktion beginnt und nachdem die Geräteaktion endet.
Parameter | |
---|---|
deviceActionReceiver |
IDeviceActionReceiver : Eine IDeviceActionReceiver , die registriert wird. |
remountSystemReadOnly
public void remountSystemReadOnly ()
Machen Sie die Systempartition auf dem Gerät schreibgeschützt. Gerät kann neu gestartet werden.
Ausgabe | |
---|---|
DeviceNotAvailableException |
remountSystemWritable
public void remountSystemWritable ()
Machen Sie die Systempartition auf dem Gerät beschreibbar. Gerät kann neu gestartet werden.
Ausgabe | |
---|---|
DeviceNotAvailableException |
remountVendorReadOnly
public void remountVendorReadOnly ()
Machen Sie die Anbieterpartition auf dem Gerät schreibgeschützt. Gerät kann neu gestartet werden.
Ausgabe | |
---|---|
DeviceNotAvailableException |
remountVendorWritable (remountVendorWritable)
public void remountVendorWritable ()
Machen Sie die Anbieterpartition auf dem Gerät beschreibbar. Gerät kann neu gestartet werden.
Ausgabe | |
---|---|
DeviceNotAvailableException |
Admin entfernen
public boolean removeAdmin (String componentName, int userId)
Den angegebenen Geräteadministrator für den Nutzer entfernen und true
zurückgeben, wenn der Vorgang erfolgreich war, andernfalls false
.
Parameter | |
---|---|
componentName |
String : des Geräteadministrators, der entfernt werden soll |
userId |
int : des Nutzers, in dem der Geräteadministrator lebt. |
Returns | |
---|---|
boolean |
„True“, wenn der Vorgang erfolgreich ist, andernfalls „False“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Inhaber entfernen
public void removeOwners ()
Entfernen Sie nach Möglichkeit alle vorhandenen Geräteprofileigentümer.
Ausgabe | |
---|---|
DeviceNotAvailableException |
Nutzer entfernen
public boolean removeUser (int userId)
Einen bestimmten Nutzer vom Gerät entfernen
Parameter | |
---|---|
userId |
int : des zu entfernenden Nutzers |
Returns | |
---|---|
boolean |
true , wenn der Nutzer erfolgreich entfernt wurde, andernfalls false. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
resetContentProvider-Einrichtung
public void resetContentProviderSetup ()
Setzen Sie die Markierung für die Einrichtung des Contentanbieters zurück, um ihn noch einmal auszulösen.
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Praktische Methode zur Ausführung von ERROR(/#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection))
mit einem oder mehreren Listenern, die als Parameter übergeben werden.
Parameter | |
---|---|
runner |
IRemoteAndroidTestRunner : die IRemoteAndroidTestRunner , die die Tests ausführt |
listeners |
ITestLifeCycleReceiver : die Testergebnis-Listener |
Returns | |
---|---|
boolean |
true , wenn der Testbefehl abgeschlossen ist. false , wenn der Vorgang nicht abgeschlossen werden konnte, die Wiederherstellung aber erfolgreich war |
Ausgabe | |
---|---|
DeviceNotAvailableException |
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner,listeners)
Führt Instrumentierungstests durch und bietet Gerätewiederherstellung.
Wenn die Verbindung zum Gerät vor Abschluss des Testlaufs unterbrochen wird und die Wiederherstellung erfolgreich ist, werden alle Listener über testRunFailed informiert und „false“ zurückgegeben. Der Testbefehl wird nicht noch einmal ausgeführt. Anrufer müssen es bei Bedarf noch einmal versuchen.
Wenn die Verbindung zum Gerät vor Abschluss des Testlaufs unterbrochen wird und die Wiederherstellung fehlschlägt, werden alle Listener über „testRunFailed“ informiert und „DeviceNotAvailableException“ wird ausgelöst.
Parameter | |
---|---|
runner |
IRemoteAndroidTestRunner : die IRemoteAndroidTestRunner , die die Tests ausführt |
listeners |
: die Testergebnis-Listener |
Returns | |
---|---|
boolean |
true , wenn der Testbefehl abgeschlossen ist. false , wenn der Vorgang aufgrund einer Ausnahme bei der Gerätekommunikation nicht abgeschlossen, die Wiederherstellung aber erfolgreich war |
Ausgabe | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Hat dieselbe Funktion wie ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
, führt aber den Test für den angegebenen Nutzer aus.
Parameter | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
|
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Hat dieselbe Funktion wie ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner,
ITestLifeCycleReceiver...)
, führt aber den Test für einen bestimmten Nutzer aus.
Parameter | |
---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
setConfiguration
public void setConfiguration (IConfiguration configuration)
Injiziertes IConfiguration
in Gebrauch.
Parameter | |
---|---|
configuration |
IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
Parameter | |
---|---|
avdInfo |
GceAvdInfo |
Datum festlegen
public void setDate (Date date)
Legt das Datum auf dem Gerät fest
Hinweis: Zum Festlegen des Datums auf dem Gerät ist ein Root erforderlich
Parameter | |
---|---|
date |
Date : gibt ein bestimmtes Datum an. Es wird das Hostdatum verwendet, wenn null |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Geräteinhaber festlegen
public boolean setDeviceOwner (String componentName, int userId)
Komponente zur Geräteverwaltung für einen bestimmten Nutzer als Geräteinhaber festlegen
Parameter | |
---|---|
componentName |
String : des Geräteadministrators wird der Geräteeigentümer sein. |
userId |
int : des Nutzers, in dem der Geräteeigentümer wohnt. |
Returns | |
---|---|
boolean |
„True“, wenn der Vorgang erfolgreich ist, andernfalls „False“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
Aktualisieren Sie den Status des Geräts.
Parameter | |
---|---|
deviceState |
TestDeviceState : die TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
Legen Sie für den Emulator SizeLimitedOutputStream
fest, um die Ausgabe zu protokollieren
Parameter | |
---|---|
output |
SizeLimitedOutputStream : zum Protokollieren der Ausgabe |
setEmulatorProcess
public void setEmulatorProcess (Process p)
Legt die Process
fest, wenn dieses Gerät ein Emulator ist.
Parameter | |
---|---|
p |
Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
Legen Sie die Fastboot-Option für das Gerät fest. Sollte bei der ersten Zuweisung des Geräts festgelegt werden.
Parameter | |
---|---|
fastbootEnabled |
boolean : gibt an, ob Fastboot für das Gerät verfügbar ist oder nicht |
setFastbootPath
public void setFastbootPath (String fastbootPath)
Legt den Pfad zum zu verwendenden Fastboot-Binärprogramm fest.
Damit die Schnellstart-Funktionen aktiviert sind, muss isFastbootEnabled()
weiterhin "true" sein.
Parameter | |
---|---|
fastbootPath |
String |
SetIDevice
public void setIDevice (IDevice newDevice)
Aktualisiere das mit diesem ITestDevice verknüpfte IDevice.
Das neue IDevice muss auf dasselbe physische Gerät wie die aktuelle Referenz verweisen. Diese Methode wird aufgerufen, wenn DDMS ein neues
Parameter | |
---|---|
newDevice |
IDevice : die IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
Legt die Wartezeit in ms fest, bevor die Logcat-Erfassung für ein Onlinegerät gestartet wird.
Parameter | |
---|---|
delay |
int : die Verzögerung in ms |
Optionen
public void setOptions (TestDeviceOptions options)
TestDeviceOptions
für das Gerät festlegen
Parameter | |
---|---|
options |
TestDeviceOptions |
setProperty
public boolean setProperty (String propKey, String propValue)
Legt den angegebenen Property-Wert auf dem Gerät fest. Erfordert, dass der ADB-Stamm „true“ ist.
Parameter | |
---|---|
propKey |
String : Der festzulegende Schlüssel. |
propValue |
String : Der festzulegende Attributwert. |
Returns | |
---|---|
boolean |
Gibt True zurück, wenn der Befehl „setprop“ erfolgreich war, andernfalls „False“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Wiederherstellung festlegen
public void setRecovery (IDeviceRecovery recovery)
Lege die IDeviceRecovery
fest, die für dieses Gerät verwendet werden soll. Sollte bei der ersten Zuweisung des Geräts festgelegt werden.
Parameter | |
---|---|
recovery |
IDeviceRecovery : die IDeviceRecovery |
Wiederherstellungsmodus festlegen
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
Legen Sie den aktuellen Wiederherstellungsmodus für das Gerät fest.
Damit wird gesteuert, welche Wiederherstellungsmethode bei Problemen mit der Gerätekommunikation verwendet werden soll. Es wird empfohlen, diese Methode nur sparsam zu verwenden, wenn sie benötigt wird (z. B. wenn das Framework ausgefallen ist usw.)
Parameter | |
---|---|
mode |
ITestDevice.RecoveryMode : Gibt an, ob der Modus „Nur bis online wiederherstellen“ aktiviert sein soll oder nicht. |
Einstellung festlegen
public void setSetting (String namespace, String key, String value)
Siehe setSetting(int, String, String, String)
und wird für einen Systemnutzer ausgeführt.
Parameter | |
---|---|
namespace |
String |
key |
String |
value |
String |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Einstellung festlegen
public void setSetting (int userId, String namespace, String key, String value)
Fügt dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzu. Einige Einstellungen sind erst nach einem Neustart verfügbar. Namespace muss einen der folgenden Werte haben: {"system", "secure", "global"}
Parameter | |
---|---|
userId |
int |
namespace |
String |
key |
String |
value |
String |
Ausgabe | |
---|---|
DeviceNotAvailableException |
setTestProtokollierung
public void setTestLogger (ITestLogger testLogger)
ITestLogger
-Instanz einschleusen
Parameter | |
---|---|
testLogger |
ITestLogger |
Schnellstart-Funktion verwenden
public void setUseFastbootErase (boolean useFastbootErase)
Legen Sie fest, ob eine Partition auf dem Gerät mithilfe des Schnellstart-Löschens oder des Fastboot-Formats gelöscht werden soll.
Parameter | |
---|---|
useFastbootErase |
boolean : true , wenn die Daten mit Fastboot-Löschung gelöscht werden sollen, oder false , wenn das Fastboot-Format verwendet werden soll. |
startLogcat
public void startLogcat ()
Starte die Aufzeichnung der Logcat-Ausgabe vom Gerät im Hintergrund.
Dies hat keine Auswirkungen, wenn die Logcat-Ausgabe bereits erfasst wird. Die Daten können später über getLogcat abgerufen werden.
Wenn das Gerät nicht mehr verwendet wird, muss stopLogcat()
aufgerufen werden.
startLogcat()
und stopLogcat()
müssen normalerweise nicht aufgerufen werden, wenn sie sich im Kontext eines TF-Aufrufs befinden, da das TF-Framework Logcat startet und beendet.
startUser (Startnutzer)
public boolean startUser (int userId)
Startet einen bestimmten Nutzer im Hintergrund, wenn er aktuell beendet ist. Wenn der Nutzer bereits im Hintergrund ausgeführt wird, ist diese Methode eine NOOP-Methode.
Parameter | |
---|---|
userId |
int : des Nutzers, der im Hintergrund gestartet werden soll |
Returns | |
---|---|
boolean |
true, wenn der Nutzer im Hintergrund gestartet wurde. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
startUser (Startnutzer)
public boolean startUser (int userId, boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, wenn er aktuell beendet ist. Wenn der Nutzer bereits im Hintergrund ausgeführt wird, ist diese Methode eine NOOP-Methode. Es kann ein zusätzliches Flag angegeben werden, um auf die Wirkung des Vorgangs zu warten.
Parameter | |
---|---|
userId |
int : des Nutzers, der im Hintergrund gestartet werden soll |
waitFlag |
boolean : sorgt dafür, dass der Befehl wartet, bis der Nutzer gestartet und entsperrt wird. |
Returns | |
---|---|
boolean |
true, wenn der Nutzer im Hintergrund gestartet wurde. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, der auf dem jeweiligen Bildschirm sichtbar ist (d.h., der Nutzer kann Aktivitäten auf dieser Anzeige starten).
HINWEIS : Mit diesem Befehl wird nicht geprüft, ob der Nutzer existiert, die Anzeige verfügbar ist, device supports such feature
usw.
Parameter | |
---|---|
userId |
int : des Nutzers, der im Hintergrund gestartet werden soll |
displayId |
int : Anzeige zum Starten des Nutzers sichtbar auf |
waitFlag |
boolean : sorgt dafür, dass der Befehl wartet, bis der Nutzer gestartet und entsperrt wird. |
Returns | |
---|---|
boolean |
true , wenn der Nutzer erfolgreich gestartet wurde und im Hintergrund sichtbar ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
stopEmulatorOutput
public void stopEmulatorOutput ()
Schließen und löschen Sie die Emulatorausgabe.
stopLogcat
public void stopLogcat ()
Erfassen der Logcat-Ausgabe vom Gerät beenden und aktuell gespeicherte Logcat-Daten verwerfen.
Dies hat keine Auswirkungen, wenn die Logcat-Ausgabe nicht erfasst wird.
stopUser
public boolean stopUser (int userId)
Stoppt einen bestimmten Nutzer. Wenn der Nutzer bereits gestoppt wurde, ist diese Methode eine NOOP-Methode. Aktuellen Nutzer und Systemnutzer können nicht beendet werden.
Parameter | |
---|---|
userId |
int : des Nutzers, der beendet werden soll. |
Returns | |
---|---|
boolean |
true, wenn der Nutzer erfolgreich beendet wurde. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
stopUser
public boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)
Stoppen Sie einen bestimmten Nutzer. Es können zusätzliche Flags bereitgestellt werden, um auf den Vorgang zu warten und die Beendigung des Nutzers zu erzwingen. Aktuellen Nutzer und Systemnutzer können nicht beendet werden.
Parameter | |
---|---|
userId |
int : des Nutzers, der beendet werden soll. |
waitFlag |
boolean : Der Befehl wartet, bis der Nutzer gestoppt wird. |
forceFlag |
boolean : erzwingt das Beenden des Nutzers. |
Returns | |
---|---|
boolean |
true, wenn der Nutzer erfolgreich beendet wurde. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
SwitchToAdbTcp
public String switchToAdbTcp ()
Wechseln Sie auf dem Gerät in den ADB-over-tcp-Modus.
Returns | |
---|---|
String |
Die TCP-Seriennummer oder null , wenn das Gerät nicht gewechselt werden konnte |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Wechsel zu AdBUsb
public boolean switchToAdbUsb ()
Schalte das Gerät in den ADB-over-USB-Modus um.
Returns | |
---|---|
boolean |
true , wenn der Wechsel erfolgreich war, andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
SwitchUser
public boolean switchUser (int userId)
Zu einer anderen Nutzer-ID mit Standardzeitlimit wechseln. switchUser(int, long)
.
Parameter | |
---|---|
userId |
int |
Returns | |
---|---|
boolean |
"True", wenn die neue userID mit dem userId-Anbieter übereinstimmt. Andernfalls „false“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
SwitchUser
public boolean switchUser (int userId, long timeout)
Wechseln Sie zu einer anderen Nutzer-ID mit dem angegebenen Zeitlimit als Frist. Es wurde versucht, den Keyguard zu deaktivieren, nachdem die Benutzeränderung erfolgreich war.
Parameter | |
---|---|
userId |
int |
timeout |
long : Warten, bis „false“ für Switch-User zurückgegeben wird. |
Returns | |
---|---|
boolean |
"True", wenn die neue userID mit dem userId-Anbieter übereinstimmt. Andernfalls „false“. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Dateien synchronisieren
public boolean syncFiles (File localFileDir, String deviceFilePath)
Der Inhalt eines lokalen Dateiverzeichnisses wird inkrementell mit dem Gerät synchronisiert.
Entscheidet, welche Dateien übertragen werden sollen, indem die Zeitstempel lokaler Dateien mit ihren Remote-Entsprechungen verglichen werden. Es werden nur neuere oder nicht vorhandene Dateien auf das Gerät übertragen. Daher sollte der Aufwand relativ gering sein, wenn der Dateisatz auf dem Gerät bereits auf dem neuesten Stand ist.
Verborgene Dateien, deren Namen mit „.“ beginnen, werden ignoriert.
Beispielanwendung: syncFiles("/tmp/files", "/sdcard") erstellt ein /sdcard/files-Verzeichnis, falls es noch nicht vorhanden ist, und überträgt die /tmp/files-Inhalte rekursiv in das Verzeichnis /sdcard/files.
Parameter | |
---|---|
localFileDir |
File : das lokale Dateiverzeichnis, das die Dateien enthält, die rekursiv übertragen werden sollen. |
deviceFilePath |
String : Stamm des absoluten Dateipfads des Remote-Ziels Alle Verzeichnisse in diesem Dateipfad müssen lesbar sein, d. h., das Senden von Push-Nachrichten an „/data/local/tmp“, wenn ADB kein Root ist, schlägt fehl. |
Returns | |
---|---|
boolean |
true , wenn die Dateien synchronisiert wurden. Andernfalls false . |
Ausgabe | |
---|---|
DeviceNotAvailableException |
TakeBugreport
public Bugreport takeBugreport ()
Erstellen Sie einen Fehlerbericht und geben Sie ihn in einem Bugreport
-Objekt zurück, um ihn zu verarbeiten. Geben Sie im Falle eines Problems null zurück. Die Datei, auf die im Fehlerbericht-Objekt verwiesen wird, muss mit Bugreport.close()
bereinigt werden.
Returns | |
---|---|
Bugreport |
Deinstallationspaket
public String uninstallPackage (String packageName)
Android-Paket vom Gerät deinstallieren
Parameter | |
---|---|
packageName |
String : das zu deinstallierende Android-Paket |
Returns | |
---|---|
String |
ein String mit einem Fehlercode oder null , wenn der Vorgang erfolgreich ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
deinstallierenPackageForUser
public String uninstallPackageForUser (String packageName, int userId)
Android-Paket für einen bestimmten Nutzer vom Gerät deinstallieren
Parameter | |
---|---|
packageName |
String : das zu deinstallierende Android-Paket |
userId |
int : die ganzzahlige Nutzer-ID, für die deinstalliert werden soll. |
Returns | |
---|---|
String |
ein String mit einem Fehlercode oder null , wenn der Vorgang erfolgreich ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Gerät entsperren
public boolean unlockDevice ()
Entsperrt das Gerät, wenn es verschlüsselt ist
Diese Methode kann das Framework neu starten, ruft jedoch nichtpostBootSetup()
auf. Daher ist das Gerät möglicherweise nicht vollständig zum Testen bereit, wenn diese Methode zurückgegeben wird.
Returns | |
---|---|
boolean |
true , wenn der Vorgang erfolgreich war oder das Gerät unverschlüsselt ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
unmountDebugfs
public void unmountDebugfs ()
Trennen Sie „debugfs“.
Ausgabe | |
---|---|
DeviceNotAvailableException |
WartefürBootAbgeschlossen
public boolean waitForBootComplete (long timeOut)
Blockiert, bis das Flag „Boot abgeschlossen“ des Geräts gesetzt wird.
Parameter | |
---|---|
timeOut |
long : Zeit in Millisekunden, die gewartet wird, bis das Flag gesetzt wird |
Returns | |
---|---|
boolean |
"true", wenn das Flag "Boot abgeschlossen" des Geräts innerhalb des Zeitlimits gesetzt ist |
Ausgabe | |
---|---|
DeviceNotAvailableException |
WaitForDeviceVerfügbar
public boolean waitForDeviceAvailable ()
Wartet, bis das Gerät reagiert und zum Testen verfügbar ist. Verwendet das Standardzeitlimit.
Returns | |
---|---|
boolean |
„True“, wenn das Gerät verfügbar ist, „False“, wenn die Wiederherstellung deaktiviert und nicht verfügbar ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
WaitForDeviceVerfügbar
public boolean waitForDeviceAvailable (long waitTime)
Wartet, bis das Gerät reagiert und zum Testen verfügbar ist.
Parameter | |
---|---|
waitTime |
long : die Wartezeit in ms |
Returns | |
---|---|
boolean |
„True“, wenn das Gerät verfügbar ist, „False“, wenn die Wiederherstellung deaktiviert und nicht verfügbar ist. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
WaitForDeviceAvailableInRecoveryPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Wartet, bis das Gerät responsiv und verfügbar ist, ohne den Wiederherstellungspfad zu berücksichtigen.
Parameter | |
---|---|
waitTime |
long |
Returns | |
---|---|
boolean |
„True“, wenn das Gerät verfügbar ist, „False“, wenn nicht verfügbar. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
WaitForDeviceBootloader
public void waitForDeviceBootloader ()
Blockiert, bis das Gerät über Fastboot sichtbar ist. Standardzeitlimit verwenden.
Ausgabe | |
---|---|
DeviceNotAvailableException |
WaitForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
Blöcke für das Gerät, die sich im Status „ADB-Wiederherstellung“ befinden. Beachten Sie, dass dies nicht mit IDeviceRecovery
zu tun ist.
Parameter | |
---|---|
waitTime |
long : die Wartezeit in ms |
Returns | |
---|---|
boolean |
true , wenn das Gerät vor Ablauf des Zeitlimits in die Wiederherstellung startet.
Andernfalls false |
WartefürGerätInSideload
public boolean waitForDeviceInSideload (long waitTime)
Blöcke für das Gerät, die sich im Status „ADB-Sideload“ befinden
Parameter | |
---|---|
waitTime |
long : die Wartezeit in ms |
Returns | |
---|---|
boolean |
true , wenn das Gerät vor Ablauf der Zeit in Sideload startet. Andernfalls false
|
WaitForDeviceNotAvailable
public boolean waitForDeviceNotAvailable (long waitTime)
Blockierungen für das Gerät, die nicht verfügbar sind, d. h. in ADB fehlen
Parameter | |
---|---|
waitTime |
long : die Wartezeit in ms |
Returns | |
---|---|
boolean |
true , wenn das Gerät vor Ablauf der Zeit nicht verfügbar wird.
Andernfalls false |
WarteFürGerätOnline
public void waitForDeviceOnline ()
Blockiert, bis das Gerät über ADB sichtbar ist. Verwendet Standardzeitüberschreitung
Beachten Sie, dass das Gerät nach Abschluss der Ausführung nicht unbedingt auf Befehle reagiert. Verwende stattdessen waitForDeviceAvailable()
.
Ausgabe | |
---|---|
DeviceNotAvailableException |
WarteFürGerätOnline
public void waitForDeviceOnline (long waitTime)
Blockiert, bis das Gerät über ADB sichtbar ist.
Beachten Sie, dass das Gerät nach Abschluss der Ausführung nicht unbedingt auf Befehle reagiert. Verwende stattdessen waitForDeviceAvailable()
.
Parameter | |
---|---|
waitTime |
long : die Wartezeit in ms |
Ausgabe | |
---|---|
DeviceNotAvailableException |
WaitForDeviceShell
public boolean waitForDeviceShell (long waitTime)
Wartet, bis das Gerät auf einen einfachen ADB-Shell-Befehl reagiert.
Parameter | |
---|---|
waitTime |
long : die Wartezeit in ms |
Returns | |
---|---|
boolean |
true , wenn das Gerät vor Ablauf des waitTime responsiv wird. |
Geschützte Methoden
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
Parameter | |
---|---|
builder |
DefaultConnection.ConnectionBuilder |
buildAdbShellCommand
protected String[] buildAdbShellCommand (String command, boolean forceExitStatusDetection)
Erstellt den Betriebssystembefehl für die angegebene ADB-Shell-Befehlssitzung und -Argumente
Parameter | |
---|---|
command |
String |
forceExitStatusDetection |
boolean |
Returns | |
---|---|
String[] |
checkApiLevelAgainst
protected void checkApiLevelAgainst (String feature, int strictMinLevel)
Parameter | |
---|---|
feature |
String |
strictMinLevel |
int |
neustartgerätaktion erstellen
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Erstellen Sie eine RebootDeviceAction
, die beim Ausführen eines Neustarts verwendet werden soll.
Parameter | |
---|---|
rebootMode |
NativeDevice.RebootMode : ein Modus dieses Neustarts. |
reason |
String : für diesen Neustart. |
Returns | |
---|---|
NativeDevice.RebootDeviceAction |
die erstellte RebootDeviceAction . |
doAdbNeustart
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Starten Sie ADB-Neustart.
Parameter | |
---|---|
rebootMode |
NativeDevice.RebootMode : ein Modus dieses Neustarts. |
reason |
String : für diesen Neustart. |
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
KeepRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
Hilfsmethode zum Auslösen einer Ausnahme, wenn die Laufzeitberechtigung nicht unterstützt wird
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
getApiLevelSafe
protected int getApiLevelSafe ()
Returns | |
---|---|
int |
getRunUtil (GetRunUtil)
protected IRunUtil getRunUtil ()
Rufen Sie die zu verwendende RunUtil
-Instanz ab.
Returns | |
---|---|
IRunUtil |
InitialConnection (Initialisieren)
protected void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Parameter | |
---|---|
info |
IBuildInfo |
attributes |
MultiMap |
Ausgabe | |
---|---|
DeviceNotAvailableException |
|
TargetSetupError |
InterneGetProperty
protected String internalGetProperty (String propName, String fastbootVar, String description)
Rufen Sie standardmäßig eine Geräteeigenschaft aus dem ddmlib-Cache ab und greifen Sie entweder auf "adb shell getprop" oder "fastboot getvar" zurück, je nachdem, ob sich das Gerät im Fastboot-Modus befindet oder nicht.
Parameter | |
---|---|
propName |
String : Name des Geräteattributs, wie von „adb shell getprop“ zurückgegeben |
fastbootVar |
String : der Name der entsprechenden Fastboot-Variable, die abgefragt werden soll. Wenn null , wird keine Fastboot-Abfrage ausgeführt. |
description |
String : Eine einfache Beschreibung der Variable. Der erste Buchstabe sollte großgeschrieben werden. |
Returns | |
---|---|
String |
Ein String, der den Wert des angegebenen Attributs enthält und möglicherweise null oder leer ist |
Ausgabe | |
---|---|
DeviceNotAvailableException |
isInNeustartCallback
protected boolean isInRebootCallback ()
Gibt zurück, ob gerade Neustart-Callbacks ausgeführt werden oder nicht. Alle öffentlichen APIs für den Neustart sollten deaktiviert werden, wenn sie auf „true“ gesetzt ist.
Returns | |
---|---|
boolean |
istNeuer
protected boolean isNewer (File localFile, IFileEntry entry)
Gibt true
zurück, wenn die lokale Datei neuer als die Remote-Datei ist. IFileEntry
ist minutengenau. Bei identischen Zeiten gilt die Datei als neuer.
Parameter | |
---|---|
localFile |
File |
entry |
IFileEntry |
Returns | |
---|---|
boolean |
Benachrichtigt das Ende des Neustarts
protected void notifyRebootEnded ()
Benachrichtigt alle IDeviceActionReceiver
über das Ereignis zum Beenden des Neustarts.
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Benachrichtigunneustarted
protected void notifyRebootStarted ()
Benachrichtigt alle IDeviceActionReceiver
über das Ereignis „Neustart“.
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
Geräteaktion ausführen
protected boolean performDeviceAction (String actionDescription, NativeDevice.DeviceAction action, int retryAttempts)
Führt eine Aktion auf diesem Gerät aus. Versucht, das Gerät wiederherzustellen und den Befehl optional zu wiederholen, wenn die Aktion fehlschlägt.
Parameter | |
---|---|
actionDescription |
String : eine kurze Beschreibung der auszuführenden Aktion. Wird nur zu Logging-Zwecken verwendet. |
action |
NativeDevice.DeviceAction : die auszuführende Aktion |
retryAttempts |
int : Wiederholungsversuche, wenn die Wiederherstellung fehlschlägt, die Wiederherstellung aber erfolgreich ist |
Returns | |
---|---|
boolean |
true , wenn die Aktion erfolgreich ausgeführt wurde |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Wiederherstellungsversuch fehlgeschlagen oder maximale Anzahl erfolgloser Versuche |
postAdbNeustart
protected void postAdbReboot ()
Mögliche zusätzliche Aktionen, die nach einem Neustart ausgeführt werden können.
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
PrePostBootSetup
protected void prePostBootSetup ()
Damit kann jeder Gerätetyp (AndroidNativeDevice, TestDevice) diese Methode für eine bestimmte Einrichtung nach dem Booten überschreiben.
Ausgabe | |
---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
PullFileInternal
protected boolean pullFileInternal (String remoteFilePath, File localFile)
Parameter | |
---|---|
remoteFilePath |
String |
localFile |
File |
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Uhr einstellen
protected void setClock (Clock clock)
Legen Sie die zu verwendende Uhrinstanz fest.
Parameter | |
---|---|
clock |
Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
Kennzeichnet das Testgerät als Mikrodroid und legt seine Kundennummer fest.
Parameter | |
---|---|
process |
Process : Prozess der Microdroid-VM. |
SetTestDeviceOptions
protected void setTestDeviceOptions (deviceOptions)
Parameter | |
---|---|
deviceOptions |
|
SimpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout,envVarMap, String[] fullCmd)
Führt einen einfachen Fastboot-Befehl mit Umgebungsvariablen aus und meldet den Status des Befehls.
Parameter | |
---|---|
timeout |
long |
envVarMap |
|
fullCmd |
String |
Returns | |
---|---|
CommandResult |
SimpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Führt einen einfachen fastboot-Befehl aus und meldet den Status des Befehls.
Parameter | |
---|---|
timeout |
long |
fullCmd |
String |
Returns | |
---|---|
CommandResult |
WaitForDeviceNotAvailable
protected boolean waitForDeviceNotAvailable (String operationDesc, long time)
Warten Sie, bis das Gerät nicht mehr verfügbar ist (beenden Sie die Berichterstellung an ADB).
Parameter | |
---|---|
operationDesc |
String : Der Name des Vorgangs, der auf Nichtverfügbarkeit wartet. |
time |
long : Die Zeit, die gewartet wird, bis nichts verfügbar ist. |
Returns | |
---|---|
boolean |
„True“, wenn das Gerät nicht mehr verfügbar ist. |