NativeDevice
public
class
NativeDevice
extends Object
implements
IConfigurationReceiver,
IManagedTestDevice,
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 |
Felder | |
---|---|
public
static
final
String |
DEBUGFS_PATH
|
protected
static
final
String |
SD_CARD
|
protected
static
final
String |
STORAGE_EMULATED
|
protected
TestDeviceOptions |
mOptions
|
protected
final
IDeviceStateMonitor |
mStateMonitor
|
Öffentliche Konstruktoren | |
---|---|
NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Erstellt ein |
Öffentliche Methoden | |
---|---|
void
|
batchPrefetchStartupBuildProps()
Mikrooptimierung (ca. 400 Millis), indem alle benötigten Eigenschaften vorab abgerufen werden, anstatt „adb“ zu nennen getprop für jedes Element. |
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, indem der aktuelle Systemserver mit dem des aktuellen Systems verglichen wird
Vorheriger system_server |
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
Hilfsmethode zum Prüfen, ob das Gerät seit der UTC-Zeit seit Epoche weicher neu gestartet wurde
und das |
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 dem Standardzeitlimit von 2 Minuten. |
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 System ausführt Umgebungsvariablen. |
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 Boot-Verlaufszuordnung mit Startzeit und Startgrund, da die angegebene Zeit seit Epoche vom 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 sind in der Regel mit Testschlüsseln (wie in AOSP) oder Releaseschlüsseln signiert. (von den einzelnen Geräteherstellern kontrolliert) |
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 eine |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Gib eine |
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 den Zeitpunkt zurück, zu dem die Tradefed APIs zuletzt einen Neustart ausgelöst haben (in Millisekunden seit EPOCH als)
zurückgegeben 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 das Element "pidof" aus und „stat“ und gibt das |
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. |
String
|
getTrackingSerial()
Für die Geräteverwaltung rufen Sie die Seriennummer ab, die zur Verfolgung des Geräts verwendet wird. |
|
getUninstallablePackageNames()
Rufen Sie die App-Paketnamen ab, die deinstalliert werden können. |
boolean
|
getUseFastbootErase()
Legen Sie fest, ob eine Partition auf dem Gerät mithilfe des Schnellstart-Löschens oder des Fastboot-Formats 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 auf eine neue Zuweisung umgestellt wird Bundesstaat. |
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 nicht gelöscht oder herabgestuft werden kann auf Nicht-Administrator-Status. |
boolean
|
isMultiUserSupported()
Legt fest, ob mehrere Nutzer unterstützt werden. |
boolean
|
isPackageInstalled(String packageName, String userId)
Fragen Sie das Gerät nach einem bestimmten Paketnamen und Nutzer-ID ab, um zu prüfen, ob es sich derzeit installiert haben 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()
Sammeln Sie die Liste der verfügbaren Anzeige-IDs auf dem Gerät, wie von „dumpsys“ gemeldet. SurfaceFlinger“. |
|
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 wenn das Gerät nicht mehr aktiv ist. für ADB nicht mehr sichtbar sind. |
void
|
postAdbRootAction()
Überschreibt, wenn für das Gerät bestimmte Aktionen nach dem ADB-Root und vor dem Ihr Gerät wieder online ist. |
void
|
postAdbUnrootAction()
Überschreibt, wenn für das Gerät nach dem Aufheben des Root-Status von ADB und vor dem das Gerät wieder online ist. |
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 fertig ist. |
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
Zusätzliche Schritte für die gerätespezifische erforderliche Einrichtung, die vor dem Aufrufablauf. |
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 bequeme Methode, um eine Datei aus dem externen Speicher des Geräts abzurufen, sie in einem
lokale temporäre |
boolean
|
pushDir(File localFileDir, String deviceFilePath,
Verzeichnisinhalte werden rekursiv auf das Gerät übertragen und einige Verzeichnisse ausgeschlossen, die gefiltert. |
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,
Wie bei |
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
|
setTrackingSerial(String trackingSerial)
Für die Geräteverwaltung kannst du die Seriennummer verfolgen, die wir für den Verweis auf das Gerät verwenden. |
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 Display sichtbar ist (d.h. der Nutzer kann um Aktivitäten in dieser Anzeige zu 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)
Blockierungen für das Gerät in der ADB-Wiederherstellung (Hinweis:
|
boolean
|
waitForDeviceInSideload(long waitTime)
Blöcke für das Gerät, das sich in „ADB-Sideload“ befindet Bundesland |
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)
Ruft standardmäßig eine Geräteeigenschaft aus dem ddmlib-Cache ab und greift dabei entweder auf "adb" zu Shell getprop" oder "fastboot getvar", je nachdem, ob sich das Gerät in Fastboot 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()
Ermöglicht jedem Gerätetyp (AndroidNativeDevice, TestDevice), diese Methode für nach der Boot-Einrichtung. |
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 . |
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
Konstantenwert: -10.000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_offSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
Konstantenwert: 5.000 (0x0000000000001388)
MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
die Standardanzahl der Wiederholungsversuche für den Befehl
Konstantenwert: 2. (0x00000002)
Felder
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 Eigenschaften vorab abgerufen werden, anstatt „adb“ zu nennen getprop für jedes Element. Das heißt, alle Eigenschaften werden genauso schnell abgerufen wie eine Property. Beispiele: device.getApiLevel(), checkApiLevelAgainstNextRelease und getBuildAlias „adb getprop“. 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 bei zukünftigen Anrufen. Wir machen das nur etwas früher. Wenn das Gerät wiederhergestellt wird oder andere Fehler beim Abrufen der Requisiten, werden diese 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. Dieses berücksichtigt noch nicht veröffentlichte Funktionen, bevor das API-Level angehoben 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. Sollte beim Start eines neuen Aufrufs aufgerufen werden um nach einem 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.
Dies ist nützlich, wenn Sie sicherstellen möchten, dass ITestDevice#getLogcat()
nur Ergebnisse zurückgibt
Protokolldaten, 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.
Das WLAN wird aktiviert und blockiert, bis eine Verbindung zu einem WLAN hergestellt wurde.
Netzwerken aus der wifiSsidToPsk-Karte. Sobald eine Verbindung hergestellt ist, versucht die Instanz,
Stellen Sie die Verbindung nach jedem Neustart bis ITestDevice#disconnectFromWifi()
wieder her oder
ITestDevice#clearLastConnectedWifiNetwork()
wird aufgerufen.
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. false
sonst |
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()
wird aufgerufen.
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. false
sonst |
Ausgabe | |
---|---|
DeviceNotAvailableException |
mit Wifi-Netzwerk verbinden
public boolean connectToWifiNetwork (wifiSsidToPsk)
Stellt eine WLAN-Verbindung her.
Das WLAN wird aktiviert und blockiert, bis eine Verbindung zu einem WLAN hergestellt wurde.
Netzwerken aus der wifiSsidToPsk-Karte. Sobald eine Verbindung hergestellt ist, versucht die Instanz,
Stellen Sie die Verbindung nach jedem Neustart bis ITestDevice#disconnectFromWifi()
wieder her oder
ITestDevice#clearLastConnectedWifiNetwork()
heißt aufgerufen.f
Parameter | |
---|---|
wifiSsidToPsk |
: Eine Zuordnung der WLAN-SSIDs zu Passwörtern. |
Returns | |
---|---|
boolean |
true , wenn eine Verbindung mit dem WLAN hergestellt wurde. false
sonst |
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()
wird aufgerufen.
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. false
sonst |
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 verbunden wird, wenn Gerät
verfügt derzeit über keine Netzwerkverbindung.
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. false
sonst |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Verbindung mit WLAN-Netzwerk herstellen (falls erforderlich)
public boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)
Eine Variante von connectToWifiNetwork(String, String)
, die nur verbunden wird, wenn Gerät
verfügt derzeit über keine Netzwerkverbindung.
Returns | |
---|---|
boolean |
true , wenn eine Verbindung mit dem WLAN hergestellt wurde. false
sonst |
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, indem der aktuelle Systemserver mit dem des aktuellen Systems verglichen wird
Vorheriger system_server ProcessInfo
. 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 zum Prüfen, ob das Gerät seit der UTC-Zeit seit Epoche weicher neu gestartet wurde
und das ERROR(/TimeUnit)
des Geräts. Ein vorläufiger Neustart bezieht sich auf den
Systemserver, der außerhalb eines
Harter Neustart des Geräts (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 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 Eingabe-Weiterleitung bereit ist. Dies geschieht ungefähr zur gleichen Zeit, Gerät meldet BOOT_COMPLETE, offenbar asynchron, da das aktuelle Framework -Implementierung eine gelegentliche Race-Bedingung aufweist. Anschließend wird der Befehl zum Schließen von Keyguard gesendet (funktioniert nur für nicht sichere)
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
falls 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. Es liegt in der Verantwortung des Anrufers, aus der dumpdatei.
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 Dabei muss es sich um einen Ort handeln, an dem
erlauben. |
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 der Befehl „enable-root“ auf „false“ gesetzt ist, wird eine Meldung protokolliert und ohne Root zu aktivieren.
Wenn du den ADB-Root aktivierst, wird möglicherweise die Verbindung zwischen dem Gerät und ADB getrennt. Diese Methode wird blockiert, bis 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
falls 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.
Stattdessen sollte nach Möglichkeit executeShellCommand(String)
verwendet werden, da dies
ermöglicht eine bessere Fehlererkennung und Leistung.
Parameter | |
---|---|
timeout |
long : die Zeit in Millisekunden, nach der das Gerät als nicht reagiert gilt, 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.
Stattdessen sollte nach Möglichkeit executeShellCommand(String)
verwendet werden, da dies
ermöglicht eine bessere Fehlererkennung und Leistung.
Parameter | |
---|---|
timeout |
long : die Zeit in Millisekunden, nach der das Gerät als nicht reagiert gilt, 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.
Stattdessen sollte nach Möglichkeit executeShellCommand(String)
verwendet werden, da dies
ermöglicht eine bessere Fehlererkennung und Leistung.
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 dem Standardzeitlimit von 2 Minuten.
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 System ausführt Umgebungsvariablen.
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 ausgeführt wird
keine Antwort ausgeben dürfen; Einheit gemäß timeUnit |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int : die maximale Anzahl der Wiederholungen des Befehls, wenn er aufgrund eines
Ausnahme. DeviceNotResponsiveException wird geworfen, wenn retryAttempts
erfolglos ausgeführt werden. |
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. Einheit als
angegeben in timeUnit |
maxTimeToOutputShellResponse |
long : die maximale Zeitspanne, während der der Befehl ausgeführt wird
keine Antwort ausgeben dürfen; Einheit gemäß timeUnit |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int : die maximale Anzahl der Wiederholungen des Befehls, wenn er aufgrund eines
Ausnahme. DeviceNotResponsiveException wird geworfen, wenn retryAttempts sind
ohne Erfolg ausgeführt zu werden. |
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 Befehlsausgabeausgabe, 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 ordnungsgemäß mit der Befehlsausgabe und stderr ausgefüllt ist. Stdout ist
die an den angegebenen Stream geleitet 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. Einheit als
angegeben in timeUnit |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int : die maximale Anzahl der Wiederholungen des Befehls, wenn er aufgrund eines
Ausnahme. DeviceNotResponsiveException wird geworfen, wenn retryAttempts sind
ohne Erfolg ausgeführt zu werden. |
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. Einheit als
angegeben in 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. Einheit als
angegeben in timeUnit |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int : die maximale Anzahl der Wiederholungen des Befehls, wenn er aufgrund eines
Ausnahme. DeviceNotResponsiveException wird geworfen, wenn retryAttempts sind
ohne Erfolg ausgeführt zu werden. |
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. Einheit als
angegeben in timeUnit |
timeUnit |
TimeUnit : Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int : die maximale Anzahl der Wiederholungen des Befehls, wenn er aufgrund eines
Ausnahme. DeviceNotResponsiveException wird geworfen, wenn retryAttempts sind
ohne Erfolg ausgeführt zu werden. |
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, werden die Daten mithilfe von Fastboot-Löschungen gelöscht
die Partition. 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 jeder Nutzer id sucht eine Android-ID, die mit dieser Funktion verknüpft ist, sodass einige Nutzer-IDs mit null übereinstimmen können.
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 (App-Paketinformationen abrufen)
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. Radioversion herunterladen
ist gerätespezifisch, sodass möglicherweise nicht für alle Geräte die richtigen Informationen zurückgegeben werden. Dieses
benötigt die Eigenschaft "gsm.version.baseband", um die korrekten Versionsinformationen zurückzugeben.
Dies ist für einige CDMA-Geräte nicht korrekt und die hier zurückgegebene Version stimmt möglicherweise nicht überein
die von Fastboot gemeldete Version und gibt möglicherweise nicht die Version für das CDMA-Radio zurück.
Zusammenfassung: Diese Methode gibt die genaue Version nur dann aus, wenn das Attribut „gsm.version.baseband“ die
Sie entspricht der Version, die von fastboot getvar version-baseband
zurückgegeben wird.
Returns | |
---|---|
String |
die String -Baseband-Version oder null , wenn sie nicht ermittelt werden kann
(Gerät hat kein Optionsfeld oder 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" , false , wenn die Eigenschaft den Wert "0" hat,
"n" , "no" , "off" , "false" oder defaultValue
sonst. |
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 Boot-Verlaufszuordnung mit Startzeit und Startgrund, da die angegebene
Zeit seit Epoche vom Gerät und der angegebenen Zeiteinheit. Die aktuelle utcEpochTime des Geräts in
Eine Millisekunde 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 das Gerät sich im Fastboot-Modus befindet, wird versucht, 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 auf Geräten ohne SD-Karte garantiert weiterhin (oder wo die SD-Karte noch nicht bereitgestellt ist).
Returns | |
---|---|
InputStreamSource |
Ein InputStreamSource , das bei Bedarf den Inhalt des Fehlerberichts generiert. In
Fehler auftreten, 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 anderen Protokolldateien, die für die Fehlerbehebung nützlich sind.
Nur unterstützt für „adb version“ > 1.0.36
Returns | |
---|---|
InputStreamSource |
ein InputStreamSource der ZIP-Datei mit den Fehlerbericht, gibt null zurück in
Fehler. |
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 (normalerweise eine Zahl für Nexus-Builds). Die letzte Version von Android 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 sind in der Regel mit Testschlüsseln (wie in AOSP) oder Releaseschlüsseln signiert. (von den einzelnen Geräteherstellern kontrolliert)
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 wurde. Andernfalls wird der Wert
Aktuell: DeviceDescriptor
.
Returns | |
---|---|
DeviceDescriptor |
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Gibt ein im Cache gespeichertes DeviceDescriptor
zurück, wenn das Gerät zugewiesen wurde. Andernfalls wird der Wert
Aktuell: DeviceDescriptor
.
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. Geben Sie im Fall eines Fehlers -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 eine DeviceDescriptor
aus den Geräteinformationen zurück, um Informationen zu erhalten, ohne
das eigentliche Geräteobjekt übergeben.
Returns | |
---|---|
DeviceDescriptor |
getDeviceDescriptor,
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Gib eine DeviceDescriptor
aus den Geräteinformationen zurück, um Informationen zu erhalten, ohne
das eigentliche Geräteobjekt ü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. Epochenzeit verwenden
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. Das ist eine etwas sicherere Variante
als bei der generischen getProductType()
-Methode, weil „ITestDevice“
weiß, dass das Gerät im Schnellstartmodus wiederhergestellt werden kann, wenn sich das Gerät im falschen Zustand befindet oder
reagiert nicht.
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. Das ist eine etwas sicherere Variante
als bei der generischen getProductType()
-Methode, weil „ITestDevice“
weiß, dass das Gerät im Schnellstartmodus wiederhergestellt werden kann, wenn sich das Gerät im falschen Zustand befindet oder
reagiert nicht.
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 etwas falsch.
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. Dies kann ein absoluter Pfad oder Pfad relativ zu „/“ sein. (d. h.
sowohl „/system“ und „system“ Syntax) |
Returns | |
---|---|
IFileEntry |
Das IFileEntry oder null , wenn die Datei unter der angegebenen path nicht
gefunden werden |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Inoffizielles Hilfsprogramm zum Abrufen eines FileEntry
aus einem Nicht-Root-Pfad. PROBLEM: Refaktorieren
FileEntry-Systems, damit sie aus jedem Pfad verfügbar sind. (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“ abgerufen werden print-states".
Returns | |
---|---|
|
Ausgabe | |
---|---|
DeviceNotAvailableException |
getIDevice
public IDevice getIDevice ()
Gibt einen Verweis auf die verknüpfte ddmlib-IDevice
zurück.
Ein neues IDevice
kann von DDMS jedes Mal zugewiesen werden, wenn die Verbindung des Geräts getrennt wird und
verbindet sich wieder mit ADB. Aufrufer sollten daher keinen Verweis auf IDevice
,
da dieser Bezug veraltet sein kann.
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 |
Attributwert oder defaultValue , wenn das Attribut leer oder 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 |
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 den Zeitpunkt zurück, zu dem die Tradefed APIs zuletzt einen Neustart ausgelöst haben (in Millisekunden seit EPOCH als)
zurückgegeben von System.currentTimeMillis()
.
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 Hintergrundinhalts zurückgegeben.
Logcat-Aufnahme
Returns | |
---|---|
InputStreamSource |
getLogcat
public InputStreamSource getLogcat (int maxBytes)
Erfasst einen Snapshot-Stream der letzten maxBytes
der erfassten Logcat-Daten.
Nützlich, wenn Sie häufige Snapshots der erfassten Logcat-Daten erstellen möchten
ohne dass durch das Abrufen des gesamten getLogcat()
-Snapshots die potenziell große Speicherplatzstrafe fällig wird.
Parameter | |
---|---|
maxBytes |
int : Die maximale Datenmenge, die zurückgegeben werden soll. Dies sollte ein Betrag sein,
bequem ins Gedächtnis einfügen |
Returns | |
---|---|
InputStreamSource |
getLogcatDump
public InputStreamSource getLogcatDump ()
Dump des aktuellen Logcats für das Gerät abrufen Im Gegensatz zu getLogcat()
wird mit dieser Methode
immer einen statischen Dump des Logcats zurückgeben.
Hat den Nachteil, dass nichts zurückgegeben wird, wenn das Gerät nicht erreichbar ist.
Returns | |
---|---|
InputStreamSource |
Eine InputStreamSource der Logcat-Daten. Bei Fehlern wird ein leerer Stream zurückgegeben.
um Logcat-Daten zu erfassen. |
getLogcatDa
public InputStreamSource getLogcatSince (long date)
Erfasst einen Snapshot-Stream erfasster Logcat-Daten ab dem angegebenen Datum. Die Uhrzeit im
sollte 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 Folgendes zurückgegeben: null. |
getMonitor
public IDeviceStateMonitor getMonitor ()
Gib die IDeviceStateMonitor
zurück, die dem Gerät zugeordnet ist.
Returns | |
---|---|
IDeviceStateMonitor |
GetMountPoint
public String getMountPoint (String mountName)
Gibt einen Bereitstellungspunkt zurück.
Fragt das Gerät direkt ab, wenn die im Cache gespeicherten Informationen in IDevice
nicht verfügbar sind.
AUFGABE: Dieses Verhalten 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 Pfad für Bereitstellungspunkte entspricht, oder
null
, wenn in diesem Pfad nichts bereitgestellt ist oder anderweitig nicht in
/proc/mounts als Bereitstellungspunkt festlegen.
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 das Element "pidof" aus und „stat“ und gibt das ProcessInfo
-Objekt mit
PID und Prozessstartzeit des angegebenen Prozesses.
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 dies nicht möglich ist
Entschlossen |
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 war nicht erfolgreich. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Erstellt einen Screenshot von der angegebenen Anzeige-ID des Geräts. Das Format ist PNG.
TODO: Implementierungen oben so erweitern, dass "format" unterstützt wird und „Neu skalieren“
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 konnte nicht erstellt werden. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getScreenshot
public InputStreamSource getScreenshot (String format, boolean rescale)
Erstellt einen Screenshot vom Gerät. Es wird empfohlen, stattdessen getScreenshot(String)
zu verwenden
mit JPEG-Codierung für eine kleinere Größe.
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 konnte nicht erstellt werden. |
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 war nicht erfolgreich. |
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,
die in der Liste fehlen. Nur DeviceNotAvailableException
beendet die Methode
frühzeitig ändern.
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 |
getTrackingSerial
public String getTrackingSerial ()
Für die Geräteverwaltung rufen Sie die Seriennummer ab, die zur Verfolgung des Geräts verwendet wird.
Returns | |
---|---|
String |
getUninstallablePackageNames
publicgetUninstallablePackageNames ()
Rufen Sie die App-Paketnamen ab, die deinstalliert werden können. Dies ist derzeit definiert als nicht systemunabhängige Pakete und aktualisierte Systempakete.
Returns | |
---|---|
|
ERROR(/Set) der deinstallierten String -Paketnamen sind derzeit auf dem
. |
Ausgabe | |
---|---|
DeviceNotAvailableException |
getUseFastbootDELETE
public boolean getUseFastbootErase ()
Legen Sie fest, ob eine Partition auf dem Gerät mithilfe des Fastboot-Lösch- oder Fastboot-Formats gelöscht werden soll.
Returns | |
---|---|
boolean |
true , wenn die Daten über Schnellstart-Daten gelöscht werden, oder false , wenn das Schnellstartformat aktiviert wird
verwendet werden können. |
getUserFlags
public int getUserFlags (int userId)
Findet die Flags eines bestimmten Nutzers und gibt sie zurück. Flags sind in „android.content.pm.UserInfo“ definiert im Android Open Source Project.
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. Gerät kann umgestellt werden
in einen neuen Zustand versetzt. Informiert IDeviceMonitor
über etwaige Statusübergänge.
DeviceEvent verarbeiten, wodurch dieses Gerät möglicherweise auf eine neue Zuweisung umgestellt wird Bundesstaat.
Parameter | |
---|---|
event |
DeviceEvent |
Returns | |
---|---|
IManagedTestDevice.DeviceEventResponse |
hasFeature
public boolean hasFeature (String feature)
Prüfen, ob eine Funktion auf einem Gerät verfügbar ist
Parameter | |
---|---|
feature |
String : das Format, das „feature: |
Returns | |
---|---|
boolean |
"True", wenn das Feature gefunden wird, andernfalls "False". |
Ausgabe | |
---|---|
DeviceNotAvailableException |
installPackage
public String installPackage (File packageFile, boolean reinstall, String... extraArgs)
Installieren Sie ein Android-Paket auf dem Gerät.
Parameter | |
---|---|
packageFile |
File : die zu installierende APK-Datei |
reinstall |
boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Siehe "adb shell pm -h" für verfügbare
Optionen. |
Returns | |
---|---|
String |
einen 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: Nur Anwendungsfälle, die eine ausdrückliche Kontrolle über die Gewährung von Laufzeitberechtigungen erfordern sollte diese Funktion aufgerufen werden.
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. Siehe "adb shell pm -h" für verfügbare
Optionen. |
Returns | |
---|---|
String |
einen 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. Siehe "adb shell pm -h" für verfügbare
Optionen. |
Returns | |
---|---|
String |
einen 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: Nur Anwendungsfälle, die eine ausdrückliche Kontrolle über die Gewährung von Laufzeitberechtigungen erfordern sollte diese Funktion aufgerufen werden.
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. Siehe "adb shell pm -h" für verfügbare
Optionen. |
Returns | |
---|---|
String |
einen 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 nicht gelöscht oder herabgestuft werden kann auf Nicht-Administrator-Status.
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)
Fragen Sie das Gerät nach einem bestimmten Paketnamen und Nutzer-ID ab, um zu prüfen, ob es sich derzeit installiert haben 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 null, ist der primäre Nutzer
0 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 „sichtbares“ Nutzende sind Nutzende, die mit dem „Menschen“ interagieren, Nutzende und ist daher in der Lage, Startaktivitäten starten (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 „sichtbares“ Nutzende sind Nutzende, die mit dem „Menschen“ interagieren, Nutzende und ist daher in der Lage, Markteinführungsaktivitäten in dieser Anzeige.
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.
Ist dies der Fall, können Sie startVisibleBackgroundUser(int, int, boolean)
aufrufen und dabei Folgendes übergeben:
eine von listDisplayIdsForStartingVisibleBackgroundUsers()
zurückgegebene Anzeige (die
sollte ERROR(/java.android.view.Display#DEFAULT_DISPLAY)
enthalten.
Returns | |
---|---|
boolean |
Ausgabe | |
---|---|
DeviceNotAvailableException |
IsVisibleBackgroundUsersSupported
public boolean isVisibleBackgroundUsersSupported ()
Gibt an, ob auf dem Gerät Nutzer im Hintergrund sichtbar gemacht werden können.
Ist dies der Fall, können Sie startVisibleBackgroundUser(int, int, boolean)
aufrufen und dabei Folgendes übergeben:
Eine von listDisplayIdsForStartingVisibleBackgroundUsers()
zurückgegebene Anzeige.
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, um den WLAN-Status vor Tests zu bestätigen, sollte nicht über WLAN laufen, z.B. Tests für mobile Daten.
Returns | |
---|---|
boolean |
true , wenn WLAN aktiviert ist. false , wenn deaktiviert |
Ausgabe | |
---|---|
DeviceNotAvailableException |
listDisplayIds
publiclistDisplayIds ()
Sammeln Sie die Liste der verfügbaren Anzeige-IDs auf dem Gerät, wie von „dumpsys“ gemeldet. SurfaceFlinger“.
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 bei Ausgabe DeviceRuntimeException
aus
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 nicht ausgelöst wird, selbst wenn schlägt das Logging fehl.
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 wenn das Gerät nicht mehr aktiv ist. für ADB nicht mehr sichtbar sind.
Ausgabe | |
---|---|
DeviceNotAvailableException |
postAdbRootAction (Post-AdbRootAction)
public void postAdbRootAction ()
Überschreibt, wenn für das Gerät bestimmte Aktionen nach dem ADB-Root und vor dem Ihr 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 ()
Überschreibt, wenn für das Gerät nach dem Aufheben des Root-Status von ADB und vor dem das Gerät wieder online ist. 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 sollten diese Schritte beim Neustart automatisch ausführen.
Dieser muss möglicherweise aufgerufen werden, wenn das Gerät aufgrund anderer Ereignisse neu startet (z. B. wenn ein fastboot update-Befehl abgeschlossen ist)
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 fertig ist.
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 Aufrufablauf.
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 die 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 Folgendes zurück:
File
.
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 der
Kopieren aus irgendeinem Grund fehlgeschlagen (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 Folgendes zurück:
File
.
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 der
Kopieren aus irgendeinem Grund fehlgeschlagen (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 die 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 der
Kopieren aus irgendeinem Grund fehlgeschlagen (einschließlich Problemen mit dem Hostdateisystem) |
Ausgabe | |
---|---|
DeviceNotAvailableException |
PullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
Eine bequeme Methode, um eine Datei aus dem externen Speicher des Geräts abzurufen, sie in einem
lokale temporäre ERROR(/File)
und geben einen Verweis auf diese File
zurück.
Parameter | |
---|---|
remoteFilePath |
String : Pfad zur Datei auf dem Gerät, relativ zum externen Speicher
Mountpoint |
Returns | |
---|---|
File |
Ein ERROR(/File) mit dem Inhalt der Gerätedatei oder null , wenn der
Kopieren aus irgendeinem Grund fehlgeschlagen (einschließlich Problemen mit dem Hostdateisystem) |
Ausgabe | |
---|---|
DeviceNotAvailableException |
PushDir
public boolean pushDir (File localFileDir, String deviceFilePath,excludedDirectories)
Verzeichnisinhalte rekursiv an das Gerät senden und dabei einige Verzeichnisse ausschließen, die gefiltert.
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 bewerten kann
für den Contentanbieter.
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 wird, bis das Gerät online ist, d. h.
für ADB sichtbar ist.
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 vor einer Geräteaktion benachrichtigt
und nachdem die Geräteaktion beendet wurde.
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 fehlgeschlagen ist
abgeschlossen, aber Wiederherstellung erfolgreich |
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, gilt Folgendes: Listener werden über testRunFailed und "false" informiert. zurückgegeben. Testbefehl werden nicht erneut ausgeführt. Anrufer müssen es bei Bedarf noch einmal versuchen.
Wenn die Verbindung zum Gerät vor Abschluss des Tests unterbrochen wird und die Wiederherstellung fehlschlägt, geschieht Folgendes: Listener werden ü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 fehlgeschlagen ist
Aufgrund einer Ausnahme bei der Gerätekommunikation abgeschlossen, aber die Wiederherstellung war erfolgreich |
Ausgabe | |
---|---|
DeviceNotAvailableException |
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId,listeners)
Wie bei ERROR(ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection)/com.android.tradefed.device.ITestDevice#runInstrumentationTests(com.android.ddmlib.testrunner.IRemoteAndroidTestRunner,Collection) ITestDevice#runInstrumentationTests(IRemoteAndroidTestRunner, Collection))
, aber
führt den Test für den angegebenen Nutzer durch.
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 : Geben Sie ein bestimmtes Datum an. 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 Schnellstartoption für das Gerät fest. Sollte beim ersten Gerät festgelegt werden zugewiesen sind.
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.
Erfordert weiterhin den Wert "true" für isFastbootEnabled()
, um die Schnellstart-Funktionen zu aktivieren.
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 IDevice
Parameter | |
---|---|
newDevice |
IDevice : die IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
Legt die Wartezeit in ms fest, bevor die Logcat-Erfassung für ein Onlinegerät gestartet wird.
Parameter | |
---|---|
delay |
int : die Verzögerung in ms |
setOptions
public void setOptions (TestDeviceOptions options)
TestDeviceOptions
für das Gerät festlegen
Parameter | |
---|---|
options |
TestDeviceOptions |
setProperty
public boolean setProperty (String propKey, String propValue)
Legt den angegebenen Property-Wert auf dem Gerät fest. Erfordert, dass 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 beim ersten Gerät festgelegt werden
zugewiesen sind.
Parameter | |
---|---|
recovery |
IDeviceRecovery : die IDeviceRecovery |
Wiederherstellungsmodus festlegen
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
Legen Sie den aktuellen Wiederherstellungsmodus für das Gerät fest.
Wird verwendet, um festzulegen, welche Wiederherstellungsmethode bei Problemen mit der Gerätekommunikation verwendet werden soll gefunden wurden. Wir empfehlen, diese Methode nur sparsam zu verwenden, wenn es erforderlich ist (z. B. wenn das Framework ausgefallen ist usw.
Parameter | |
---|---|
mode |
ITestDevice.RecoveryMode : Angabe, ob die Wiederherstellung nur online erfolgen soll ob der Modus aktiviert sein sollte 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 nur verfügbar nach einem Neustart wieder. 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 |
setTrackingSerial
public void setTrackingSerial (String trackingSerial)
Für die Geräteverwaltung kannst du die Seriennummer verfolgen, die wir für den Verweis auf das Gerät verwenden.
Parameter | |
---|---|
trackingSerial |
String |
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 Funktion zum Löschen von Daten über Schnellstart verwendet werden soll, oder false , wenn
fastboot-Format verwendet werden. |
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,
in einem TF-Aufrufkontext, da das TF-Framework Logcat startet und stoppt.
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 zur Verfügung gestellt werden, auf das gewartet werden soll. damit der Vorgang wirksam wird.
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 Display sichtbar ist (d.h. der Nutzer kann um Aktivitäten in dieser Anzeige zu 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 : 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, die warten, bis der Vorgang wirksam wird. 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 der Fernbedienung verglichen werden Äquivalente. Nur 'neuere' oder nicht vorhandene Dateien werden auf das Gerät übertragen. Dementsprechender Aufwand sollte relativ klein sein, wenn die Datei auf dem Gerät bereits auf dem neuesten Stand ist.
Ausgeblendete Dateien, deren Namen mit „.“ beginnen, werden ignoriert.
Beispielanwendung: Mit syncFiles("/tmp/files", "/sdcard") wird ein Verzeichnis "/sdcard/files" erstellt, wenn /tmp/files muss rekursiv in das Verzeichnis "/sdcard/files" verschoben werden.
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 thos
Dateipfad muss lesbar sein. d. h. Übertragung 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. Null zurückgeben
wenn es ein Problem gibt. 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 |
einen 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 |
einen 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. Dementsprechend wird
Das Gerät ist 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 |
WaitForDeviceAvailable
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 |
WaitForDeviceAvailable
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)
Blockierungen für das Gerät in der ADB-Wiederherstellung (Hinweis:
IDeviceRecovery
.
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 in „ADB-Sideload“ Bundesland
Parameter | |
---|---|
waitTime |
long : die Wartezeit in ms |
Returns | |
---|---|
boolean |
true , wenn das Gerät vor Ablauf der Zeit im 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. Verwenden Sie
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. Verwenden Sie
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)
Ruft standardmäßig eine Geräteeigenschaft aus dem ddmlib-Cache ab und greift dabei entweder auf "adb" zu Shell getprop" oder "fastboot getvar", je nachdem, ob sich das Gerät in Fastboot 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 ,
Fastboot-Abfrage wird nicht versucht, |
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 Neustart sollte deaktiviert sein, wenn dies 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
=
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 |
Benachrichtigunkneustarted
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 Maßnahme schlägt fehl.
Parameter | |
---|---|
actionDescription |
String : eine kurze Beschreibung der auszuführenden Aktion. Für Logging 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 |
wenn der Wiederherstellungsversuch fehlschlägt oder die maximale Anzahl von Versuchen ohne Erfolg |
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 ()
Ermöglicht jedem Gerätetyp (AndroidNativeDevice, TestDevice), diese Methode für nach der Boot-Einrichtung.
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 .
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. |