NativeDevice
public
class
NativeDevice
extends Object
implements
IConfigurationReceiver,
IManagedTestDevice,
ITestLoggerReceiver
| java.lang.Object | |
| ↳ | com.android.tradefed.device.NativeDevice |
Standardimplementierung von ITestDevice Nicht-Full-Stack-Android-Geräte
Zusammenfassung
Verschachtelte Klassen | |
|---|---|
class |
NativeDevice.AdbAction
Ein |
class |
NativeDevice.AdbShellAction
|
class |
NativeDevice.RebootDeviceAction
|
Konstanten | |
|---|---|
String |
DEBUGFS_PATH
|
int |
INVALID_USER_ID
Wert, der für eine ungültige/nicht gefundene Nutzer-ID zurückgegeben wird: UserHandle hat den Wert -10000 definiert. |
long |
MAX_HOST_DEVICE_TIME_OFFSET
|
int |
MAX_RETRY_ATTEMPTS
die Standardanzahl der Wiederholungsversuche für Befehle |
String |
SD_CARD
|
String |
STORAGE_EMULATED
|
Felder | |
|---|---|
protected
TestDeviceOptions |
mOptions
|
protected
final
IDeviceStateMonitor |
mStateMonitor
|
Öffentliche Konstruktoren | |
|---|---|
NativeDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Erstellt ein |
|
Öffentliche Methoden | |
|---|---|
String
|
adbInstallPackage(File packageFile, boolean reinstall, String... extraArgs)
Installieren Sie ein Android-Paket mit dem adb-Befehl auf einem Gerät. |
String
|
adbInstallPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Installieren Sie ein Android-Paket mit dem adb-Befehl auf einem Gerät. |
void
|
batchPrefetchStartupBuildProps()
Mikrooptimierung (ca. 400 Millisekunden) durch Vorabrufen aller benötigten Attribute anstatt „adb getprop“ für jedes Attribut aufzurufen. |
boolean
|
canSwitchToHeadlessSystemUser()
Gibt zurück, ob der Wechsel zum monitorlosen SYSTEM-Nutzer zulässig ist. |
boolean
|
checkApiLevelAgainstNextRelease(int strictMinLevel)
Prüfen, ob eine Funktion bei einem minimal unterstützten Level derzeit unterstützt wird. |
boolean
|
checkConnectivity()
Prüfen Sie, ob das Gerät eine Netzwerkverbindung hat. |
boolean
|
clearErrorDialogs()
Schließen Sie alle Fehlerdialogfelder, die derzeit auf der Geräte-UI angezeigt werden. |
void
|
clearLastConnectedWifiNetwork()
Löscht das zuletzt verbundene WLAN. |
void
|
clearLogcat()
Löscht alle angesammelten Logcat-Daten. |
IWifiHelper.WifiConnectionResult
|
connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)
Eine Variante von |
IWifiHelper.WifiConnectionResult
|
connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk)
Eine Variante von |
IWifiHelper.WifiConnectionResult
|
connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)
Verbindung zu einem WLAN herstellen |
IWifiHelper.WifiConnectionResult
|
connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk)
Verbindung zu einem WLAN herstellen |
IWifiHelper.WifiConnectionResult
|
connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk, boolean scanSsid)
Verbindung zu einem WLAN herstellen |
IWifiHelper.WifiConnectionResult
|
connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk)
Verbindung zu einem WLAN herstellen |
int
|
createUser(String name, boolean guest, boolean ephemeral)
Einen Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen |
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Einen Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen |
int
|
createUser(String name)
Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0. |
int
|
createUserNoThrow(String name)
Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0. |
DeviceInspectionResult
|
debugDeviceNotAvailable()
Ein Gerät prüfen und detaillierte Informationen zurückgeben, wenn ein Gerät nicht mehr verfügbar ist. |
void
|
deleteFile(String deviceFilePath, int userId)
Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät. |
void
|
deleteFile(String deviceFilePath)
Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät. |
void
|
deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Entfernt die registrierte |
boolean
|
deviceSoftRestarted(ProcessInfo prevSystemServerProcess)
Hilfsmethode zum Prüfen, ob das Gerät durch Vergleich des aktuellen system_server mit dem vorherigen system_server |
boolean
|
deviceSoftRestartedSince(long utcEpochTime, TimeUnit timeUnit)
Hilfsmethode, um zu prüfen, ob das Gerät seit der UTC-Zeit seit der Epoche vom Gerät und seinem |
boolean
|
disableAdbRoot()
Deaktiviert den ADB-Root-Zugriff. |
void
|
disableKeyguard()
Es wird versucht, die Keyguard-Funktion zu deaktivieren. |
boolean
|
disableNetworkMonitor()
Deaktiviert die Netzwerküberwachung auf dem Gerät. |
boolean
|
disconnectFromWifi()
Die Verbindung zu einem WLAN wird getrennt. |
boolean
|
doesFileExist(String deviceFilePath, int userId)
Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät für einen bestimmten Nutzer vorhanden ist. |
boolean
|
doesFileExist(String deviceFilePath)
Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät vorhanden ist. |
File
|
dumpHeap(String process, String devicePath)
Versuchen Sie, den Heap aus dem system_server zu sichern. |
boolean
|
enableAdbRoot()
Aktiviert den ADB-Root-Zugriff. |
boolean
|
enableNetworkMonitor()
Aktiviert die Netzwerküberwachung auf dem Gerät. |
String
|
executeAdbCommand(long timeout, String... cmdArgs)
Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt. |
String
|
executeAdbCommand(String... cmdArgs)
Hilfsmethode, die einen ADB-Befehl als Systembefehl ausführt. |
String
|
executeAdbCommand(long timeout, Map<String, String> envMap, String... cmdArgs)
Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt. |
CommandResult
|
executeAdbV2Command(String... cmdArgs)
Hilfsmethode, die einen ADB-Befehl als Systembefehl ausführt. |
CommandResult
|
executeAdbV2Command(long timeout, String... cmdArgs)
Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt. |
CommandResult
|
executeAdbV2Command(long timeout, Map<String, String> envMap, String... cmdArgs)
Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt. |
CommandResult
|
executeAdbV2Command(long timeout, Map<String, String> envMap, int retryAttempts, String... cmdArgs)
Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt. |
CommandResult
|
executeFastbootCommand(String... cmdArgs)
Hilfsmethode, die einen Fastboot-Befehl als Systembefehl mit einem Standard-Timeout von 2 Minuten ausführt. |
CommandResult
|
executeFastbootCommand(long timeout, String... cmdArgs)
Hilfsmethode, die einen Fastboot-Befehl als Systembefehl ausführt. |
CommandResult
|
executeLongFastbootCommand(String... cmdArgs)
Hilfsmethode, die einen zeitaufwendigen Fastboot-Befehl als Systembefehl ausführt. |
CommandResult
|
executeLongFastbootCommand(Map<String, String> envVarMap, String... cmdArgs)
Hilfsmethode, die einen zeitaufwendigen Fastboot-Befehl als Systembefehl mit Systemumgebungsvariablen ausführt. |
String
|
executeShellCommand(String command)
Hilfsmethode, die einen ADB-Shellbefehl ausführt und die Ausgabe als |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus. |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver)
Führt den angegebenen ADB-Shell-Befehl aus und versucht es mehrmals, wenn der Befehl fehlschlägt. |
CommandResult
|
executeShellV2Command(String cmd)
Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus. |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus. |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput)
Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als |
CommandResult
|
executeShellV2Command(String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus. |
CommandResult
|
executeShellV2Command(String cmd, OutputStream pipeToOutput)
Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus. |
CommandResult
|
executeShellV2Command(String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus. |
CommandResult
|
executeShellV2Command(String cmd, IShellOutputReceiver receiver)
Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als |
CommandResult
|
fastbootOemRamdumpNow()
Hilfsmethode, die einen RAM-Dump über den Fastboot-Modus auslöst. |
CommandResult
|
fastbootWipePartition(String partition)
Helper-Methode, mit der eine Partition für das Gerät gelöscht wird. |
Set<ITestDevice.ApexInfo>
|
getActiveApexes()
Ruft die Informationen zu den auf dem Gerät aktivierten APEX-Modulen ab. |
String
|
getAdbPath()
Gibt den Pfad der verwendeten ADB-Binärdatei zurück. |
Map<String, String>
|
getAllSettings(String namespace)
Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück. |
DeviceAllocationState
|
getAllocationState()
Gibt den aktuellen Zuweisungsstatus des Geräts zurück |
String
|
getAndroidId(int userId)
Sucht die Android-ID, die einem Nutzer zugeordnet ist, und gibt sie zurück. Wenn sie nicht gefunden wird, wird „null“ zurückgegeben. |
Map<Integer, String>
|
getAndroidIds()
Erstellen Sie eine Zuordnung von Android-IDs, die mit Nutzer-IDs übereinstimmen. |
int
|
getApiLevel()
Das API-Level des Geräts abrufen. |
int
|
getApiLevelFull()
Ähnlich wie |
PackageInfo
|
getAppPackageInfo(String packageName)
Informationen zu einem auf dem Gerät installierten Paket abrufen. |
List<PackageInfo>
|
getAppPackageInfos()
Informationen zu auf dem Gerät installierten Paketen abrufen. |
String
|
getBasebandVersion()
Einfache Methode zum Abrufen der Baseband-Version (Funkmodul) dieses Geräts. |
Integer
|
getBattery()
Gibt den aktuellen Akkustand eines Geräts zurück oder „Null“, wenn der Akkustand nicht verfügbar ist. |
boolean
|
getBooleanProperty(String name, boolean defaultValue)
Gibt den booleschen Wert der angegebenen Property zurück. |
Map<Long, String>
|
getBootHistory()
Die Hilfsmethode erfasst die Bootverlaufskarte mit Bootzeit und Bootgrund. |
Map<Long, String>
|
getBootHistorySince(long utcEpochTime, TimeUnit timeUnit)
Die Hilfsmethode ruft die Karte mit dem Bootverlauf mit Bootzeit und Bootgrund seit der angegebenen Zeit seit der Epoche vom Gerät und der angegebenen Zeiteinheit ab. |
String
|
getBootloaderVersion()
Bequeme Methode zum Abrufen der Bootloader-Version dieses Geräts. |
InputStreamSource
|
getBugreport()
Ruft einen Fehlerbericht vom Gerät ab. |
InputStreamSource
|
getBugreportz()
Ruft einen Fehlerbericht vom Gerät ab. |
String
|
getBuildAlias()
Rufen Sie den Alias des Builds ab, der auf dem Gerät gerade ausgeführt wird. |
String
|
getBuildFlavor()
Ruft die Build-Variante für das Gerät ab. |
String
|
getBuildId()
Ruft den Build ab, der derzeit auf dem Gerät ausgeführt wird. |
String
|
getBuildSigningKeys()
Gibt den Schlüsseltyp zurück, der zum Signieren des Geräte-Images verwendet wurde. Android-Geräte werden in der Regel mit Testschlüsseln (wie in AOSP) oder Releaseschlüsseln (die von den einzelnen Geräteherstellern verwaltet werden) signiert. |
DeviceDescriptor
|
getCachedDeviceDescriptor()
Gibt ein im Cache gespeichertes |
DeviceDescriptor
|
getCachedDeviceDescriptor(boolean shortDescriptor)
Gibt ein im Cache gespeichertes |
String[]
|
getChildren(String path)
Alternative zur Verwendung von |
AbstractConnection
|
getConnection()
Die aktuelle Verbindung des Geräts. |
ContentProviderHandler
|
getContentProvider(int userId)
Gibt |
DeviceFoldableState
|
getCurrentFoldableState()
Gibt den aktuellen Status des faltbaren Geräts zurück oder „null“, wenn Probleme aufgetreten sind. |
int
|
getCurrentUser()
Gibt die ID des aktuell ausgeführten Nutzers zurück. |
String
|
getDeviceClass()
Geräteklasse abrufen |
long
|
getDeviceDate()
Gibt das Datum des Geräts in Millisekunden seit der Epoche zurück. |
DeviceDescriptor
|
getDeviceDescriptor()
Gibt ein |
DeviceDescriptor
|
getDeviceDescriptor(boolean shortDescriptor)
Gibt ein |
TestDeviceState
|
getDeviceState()
Gerätestatus abrufen |
long
|
getDeviceTimeOffset(Date date)
Helper zum Abrufen der Zeitdifferenz zwischen dem Gerät und einem bestimmten |
InputStreamSource
|
getEmulatorOutput()
Stream von Emulator-stdout und -stderr abrufen |
Process
|
getEmulatorProcess()
Gibt die |
final
File
|
getExecuteShellCommandLog()
Das Log, das alle |
long
|
getExternalStoreFreeSpace()
Hilfsmethode zum Ermitteln des freien Speicherplatzes auf dem externen Speicher des Geräts. |
String
|
getFastbootPath()
Gibt den Pfad der verwendeten Fastboot-Binärdatei zurück. |
String
|
getFastbootProductType()
Bequeme Methode zum Abrufen des Produkttyps dieses Geräts im Fastboot-Modus. |
String
|
getFastbootProductVariant()
Bequeme Methode zum Abrufen des Produkttyps dieses Geräts im Fastboot-Modus. |
String
|
getFastbootSerialNumber()
Gibt die Seriennummer im Fastboot-Modus zurück. |
String
|
getFastbootVariable(String variableName)
Ruft den angegebenen Fastboot-Variablenwert vom Gerät ab. |
String
|
getFastbootVersion()
Gibt den Versionsstring der verwendeten Fastboot-Binärdatei zurück. |
IFileEntry
|
getFileEntry(String path)
Eine Referenz auf eine Remotedatei auf dem Gerät abrufen |
IFileEntry
|
getFileEntry(FileListingService.FileEntry entry)
Inoffizieller Helfer zum Abrufen eines |
Set<DeviceFoldableState>
|
getFoldableStates()
Gibt die Liste der faltbaren Status auf dem Gerät zurück. |
IDevice
|
getIDevice()
Gibt einen Verweis auf die zugehörige ddmlib- |
Set<String>
|
getInstalledPackageNames()
Die Paketnamen der auf dem Gerät vorhandenen Anwendungen abrufen. |
long
|
getIntProperty(String name, long defaultValue)
Gibt den Ganzzahlwert der angegebenen Eigenschaft des Geräts zurück. |
String
|
getIpAddress()
Ruft die IP-Adresse des Geräts ab. |
KeyguardControllerState
|
getKeyguardState()
Gibt ein Objekt zurück, um den aktuellen Status des Keyguard zu erhalten, oder „null“, wenn dies nicht unterstützt wird. |
long
|
getLastExpectedRebootTimeMillis()
Gibt die letzte Zeit zurück, zu der Tradefed-APIs einen Neustart ausgelöst haben, in Millisekunden seit EPOCH, wie von |
int
|
getLaunchApiLevel()
Ruft das API-Level des Geräts bei der ersten Markteinführung ab. |
InputStreamSource
|
getLogcat()
Erstellt einen Snapshot-Stream der logcat-Daten. |
InputStreamSource
|
getLogcat(int maxBytes)
Erstellt einen Snapshot-Stream der letzten |
InputStreamSource
|
getLogcatDump()
Rufen Sie einen Dump des aktuellen Logcat für das Gerät ab. |
InputStreamSource
|
getLogcatSince(long date)
Ruft einen Snapshot-Stream der erfassten logcat-Daten ab, beginnend mit dem angegebenen Datum. |
String
|
getMacAddress()
Gibt die MAC-Adresse des Geräts zurück. Wenn die Abfrage des Geräts fehlschlägt, wird „null“ zurückgegeben. |
Integer
|
getMainUserId()
Gibt die Hauptnutzer-ID zurück. |
Set<String>
|
getMainlineModuleInfo()
Ruft Informationen zu den auf dem Gerät installierten Mainline-Modulen ab. |
int
|
getMaxNumberOfRunningUsersSupported()
Die maximale Anzahl der unterstützten gleichzeitig aktiven Nutzer abrufen. |
int
|
getMaxNumberOfUsersSupported(String userType)
Ruft die maximale Anzahl der unterstützten Nutzer des angegebenen Nutzertyps ab. |
int
|
getMaxNumberOfUsersSupported()
Ruft die maximale Anzahl der unterstützten wechselbaren Nutzer ab, ohne Gäste. |
Process
|
getMicrodroidProcess()
|
IDeviceStateMonitor
|
getMonitor()
Gibt die mit dem Gerät verknüpfte |
String
|
getMountPoint(String mountName)
Gibt einen Bereitstellungspunkt zurück. |
ITestDevice.MountPointInfo
|
getMountPointInfo(String mountpoint)
Gibt ein |
List<ITestDevice.MountPointInfo>
|
getMountPointInfo()
Gibt eine geparste Version der Informationen in /proc/mounts auf dem Gerät zurück. |
TestDeviceOptions
|
getOptions()
Ruft die Testoptionen für das Gerät ab. |
long
|
getPartitionFreeSpace(String partition)
Hilfsmethode zum Ermitteln des freien Speicherplatzes auf der Gerätepartition. |
Integer
|
getPrimaryUserId()
Gibt die Hauptnutzer-ID zurück. |
ProcessInfo
|
getProcessByName(String processName)
Die Hilfsmethode führt die Befehle „pidof“ und „stat“ aus und gibt das |
String
|
getProcessPid(String process)
Gibt die PID des Dienstes zurück oder „null“, wenn ein Fehler aufgetreten ist. |
String
|
getProductType()
Bequeme Methode zum Abrufen des Produkttyps dieses Geräts. |
String
|
getProductVariant()
Bequeme Methode zum Abrufen der Produktvariante dieses Geräts. |
String
|
getProperty(String name)
Ruft den angegebenen Attributwert vom Gerät ab. |
ITestDevice.RecoveryMode
|
getRecoveryMode()
Ruft den aktuellen Wiederherstellungsmodus ab, der für das Gerät verwendet wird. |
int
|
getRemainingCreatableUserCount(String userType)
Gibt zurück, wie viele Nutzer des angegebenen Nutzertyps auf diesem Gerät erstellt werden können. |
InputStreamSource
|
getScreenshot(Long displayId, String format, boolean rescale)
Erstellt einen Screenshot des Displays mit der angegebenen ID im unterstützten Format. |
InputStreamSource
|
getScreenshot(String format)
Erstellt einen Screenshot vom Gerät. |
InputStreamSource
|
getScreenshot(long displayId)
Erstellt einen Screenshot des Geräts mit der angegebenen Anzeige-ID. |
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Erstellt einen Screenshot vom Gerät. |
InputStreamSource
|
getScreenshot()
Erstellt einen Screenshot vom Gerät. |
String
|
getSerialNumber()
Bequeme Methode zum Abrufen der Seriennummer dieses Geräts. |
String
|
getSetting(int userId, String namespace, String key)
Gibt den Wert der angeforderten Einstellung zurück. |
String
|
getSetting(String namespace, String key)
Weitere Informationen finden Sie unter |
String
|
getSimOperator()
Gibt den SIM-Kartenbetreiber zurück oder „null“, wenn er nicht verfügbar ist oder das Gerät nicht verfügbar ist. |
String
|
getSimState()
Gibt den SIM-Kartenstatus zurück oder „null“, wenn er nicht verfügbar ist oder das Gerät nicht verfügbar ist. |
List<File>
|
getTombstones()
Die Liste der Tombstones von den Geräten abrufen und zurückgeben. |
long
|
getTotalMemory()
Gibt die Gesamtgröße des physischen Speichers in Byte zurück oder -1 im Falle eines internen Fehlers. |
String
|
getTrackingSerial()
Rufen Sie die Seriennummer ab, die zum Verfolgen des Geräts verwendet wird. |
Set<String>
|
getUninstallablePackageNames()
Ruft die Paketnamen der Anwendungen ab, die deinstalliert werden können. |
boolean
|
getUseFastbootErase()
Gibt an, ob zum Löschen einer Partition auf dem Gerät „fastboot erase“ oder „fastboot format“ verwendet werden soll. |
int
|
getUserFlags(int userId)
Sucht nach den Markierungen eines bestimmten Nutzers und gibt sie zurück. |
Map<Integer, UserInfo>
|
getUserInfos()
Ruft die Zuordnung von useId zu |
int
|
getUserSerialNumber(int userId)
Gibt die dem userId zugeordnete Seriennummer zurück, falls gefunden, andernfalls -10000. |
int
|
getUserVisibleOnDisplay(int displayId)
Ruft die Nutzer-ID des sichtbaren Nutzers auf dem angegebenen Display ab. |
IManagedTestDevice.DeviceEventResponse
|
handleAllocationEvent(DeviceEvent event)
Verarbeite das angegebene DeviceEvent. Verarbeite das DeviceEvent, wodurch dieses Gerät möglicherweise in einen neuen Zuweisungsstatus übergeht. |
boolean
|
hasFeature(String feature)
Prüfen, ob eine Funktion auf einem Gerät verfügbar ist |
void
|
initializeConnection(IBuildInfo info, MultiMap<String, String> attributes)
Stellen Sie die Verbindung zum Gerät her. |
String
|
installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)
Installieren Sie ein Android-Paket auf dem Gerät. |
String
|
installPackage(File packageFile, boolean reinstall, String... extraArgs)
Installieren Sie ein Android-Paket auf dem Gerät. |
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Installiert ein Android-Paket auf einem Gerät für einen bestimmten Nutzer. |
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Installiert ein Android-Paket auf einem Gerät für einen bestimmten Nutzer. |
boolean
|
installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)
Installiert APKs im inkrementellen Modus. |
void
|
invalidatePropertyCache()
|
boolean
|
isAdbRoot()
|
boolean
|
isAdbTcp()
|
boolean
|
isAppEnumerationSupported()
Prüfen, ob die Plattform auf dem Gerät die App-Aufzählung unterstützt |
boolean
|
isBypassLowTargetSdkBlockSupported()
Prüfen, ob die Plattform auf dem Gerät das Umgehen der Blockierung aufgrund des niedrigen Ziel-SDK bei der App-Installation unterstützt |
boolean
|
isDebugfsMounted()
Prüfen Sie, ob „debugfs“ gemountet ist. |
boolean
|
isDeviceEncrypted()
Gibt zurück, ob das Gerät verschlüsselt ist. |
boolean
|
isDirectory(String path)
Gibt „True“ zurück, wenn der Pfad auf dem Gerät ein Verzeichnis ist, andernfalls „False“. |
boolean
|
isEnableAdbRoot()
|
boolean
|
isEncryptionSupported()
Gibt zurück, ob die Verschlüsselung auf dem Gerät unterstützt wird. |
boolean
|
isExecutable(String fullPath)
Gibt „True“ zurück, wenn der Dateipfad auf dem Gerät eine ausführbare Datei ist, andernfalls „False“. |
boolean
|
isFastbootEnabled()
Gibt zurück, ob Fastboot für das Gerät verfügbar ist. |
boolean
|
isHeadless()
Gibt „true“ zurück, wenn das Gerät headless ist (kein Bildschirm), andernfalls „false“. |
boolean
|
isHeadlessSystemUserMode()
Gibt zurück, ob auf dem Gerät der monitorlose Systemnutzermodus verwendet wird. |
boolean
|
isMainUserPermanentAdmin()
Gibt zurück, ob der Hauptnutzer ein permanenter Administrator ist und nicht gelöscht oder auf den Status „Nicht-Administrator“ herabgestuft werden kann. |
boolean
|
isMultiUserSupported()
Gibt zurück, ob dieses Gerät mehrere umschaltbare Nutzer mit eigenem Login und anpassbarem Bereich unterstützt. |
boolean
|
isPackageInstalled(String packageName, String userId)
Fragen Sie das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID ab, um zu prüfen, ob die App für diesen Nutzer derzeit installiert ist. |
boolean
|
isPackageInstalled(String packageName)
Fragen Sie das Gerät nach einem bestimmten Paketnamen, um zu prüfen, ob das Paket derzeit installiert ist. |
boolean
|
isRuntimePermissionSupported()
Prüfen, ob die Plattform auf dem Gerät die Erteilung von Laufzeitberechtigungen unterstützt |
boolean
|
isShellV2Support()
|
boolean
|
isStateBootloaderOrFastbootd()
Gibt „true“ zurück, wenn sich das Gerät in |
boolean
|
isUserRunning(int userId)
Prüfen, ob ein bestimmter Nutzer aktiv ist. |
boolean
|
isUserSecondary(int userId)
Gibt zurück, ob der angegebene Nutzer anhand seiner Flags ein sekundärer Nutzer ist. |
boolean
|
isUserVisible(int userId)
Prüft, ob der angegebene Nutzer sichtbar ist. |
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Prüft, ob der angegebene Nutzer auf dem angegebenen Display sichtbar ist. |
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Gibt zurück, ob Nutzer im Hintergrund in |
boolean
|
isVisibleBackgroundUsersSupported()
Gibt zurück, ob Nutzer im Hintergrund sichtbar sein dürfen. |
boolean
|
isWifiEnabled()
Prüfen, ob WLAN aktiviert ist. |
Set<Long>
|
listDisplayIds()
Erfassen Sie die Liste der verfügbaren Display-IDs auf dem Gerät, wie von „dumpsys SurfaceFlinger“ gemeldet. |
Set<Integer>
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Ruft die Liste der Displays ab, die für |
ArrayList<Integer>
|
listUsers()
Ruft die Liste der Nutzer auf dem Gerät ab. |
boolean
|
logAnrs(ITestLogger logger)
Erfasst und protokolliert ANR-Fehler vom Gerät. |
boolean
|
logBugreport(String dataName, ITestLogger listener)
Helper-Methode zum Erstellen eines Fehlerberichts und zum Protokollieren des Berichts für die Reporter. |
void
|
logOnDevice(String tag, Log.LogLevel level, String format, Object... args)
Eine Nachricht im Logcat des Geräts protokollieren. |
void
|
mountDebugfs()
debugfs bereitstellen. |
void
|
nonBlockingReboot()
Gibt einen Befehl zum Neustarten des Geräts aus und kehrt zurück, wenn der Befehl abgeschlossen ist und das Gerät für ADB nicht mehr sichtbar ist. |
void
|
postAdbRootAction()
Überschreiben, wenn auf dem Gerät nach dem Ausführen von „adb root“ und bevor das Gerät wieder online ist, bestimmte Aktionen ausgeführt werden müssen. |
void
|
postAdbUnrootAction()
Überschreiben, wenn auf dem Gerät nach dem Aufheben des Rootings über ADB und vor dem erneuten Onlinegehen des Geräts bestimmte Aktionen ausgeführt werden müssen. |
void
|
postBootSetup()
Führen Sie die Anleitung aus, um das Gerät nach jedem Booten für Tests zu konfigurieren. |
void
|
postInvocationTearDown(Throwable exception)
Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach dem Aufruf ausgeführt werden. |
void
|
preInvocationSetup(IBuildInfo info, MultiMap<String, String> attributes)
Zusätzliche Schritte für die gerätespezifische Einrichtung, die auf dem Gerät vor dem Aufruf ausgeführt werden. |
boolean
|
pullDir(String deviceFilePath, File localDir, int userId)
Verzeichnisinhalte rekursiv vom Gerät abrufen. |
boolean
|
pullDir(String deviceFilePath, File localDir)
Verzeichnisinhalte rekursiv vom Gerät abrufen. |
boolean
|
pullDir(String deviceFilePath, File localDir, int userId, long timeout)
Verzeichnisinhalte rekursiv vom Gerät abrufen. |
boolean
|
pullFile(String remoteFilePath, File localFile, int userId, long timeout)
Ruft eine Datei vom Gerät ab. |
boolean
|
pullFile(String remoteFilePath, File localFile)
Ruft eine Datei vom Gerät ab. |
File
|
pullFile(String remoteFilePath, int userId)
Ruft eine Datei vom Gerät ab, speichert sie in einem lokalen temporären |
File
|
pullFile(String remoteFilePath)
Ruft eine Datei vom Gerät ab, speichert sie in einem lokalen temporären |
boolean
|
pullFile(String remoteFilePath, File localFile, int userId)
Ruft eine Datei vom Gerät ab. |
String
|
pullFileContents(String remoteFilePath)
Ruft eine Datei vom Gerät ab und gibt den Inhalt zurück. |
File
|
pullFileFromExternal(String remoteFilePath)
Eine Hilfsmethode zum Abrufen einer Datei aus dem externen Speicher des Geräts, die sie in einem lokalen temporären |
boolean
|
pushDir(File localFileDir, String deviceFilePath, int userId)
Verzeichnisinhalte rekursiv auf das Gerät übertragen. |
boolean
|
pushDir(File localFileDir, String deviceFilePath, Set<String> excludedDirectories)
Verzeichnisinhalte rekursiv auf das Gerät übertragen, wobei einige gefilterte Verzeichnisse ausgeschlossen werden. |
boolean
|
pushDir(File localFileDir, String deviceFilePath)
Verzeichnisinhalte rekursiv auf das Gerät übertragen. |
boolean
|
pushFile(File localFile, String remoteFilePath, boolean evaluateContentProviderNeeded)
Variante von |
boolean
|
pushFile(File localFile, String remoteFilePath)
Eine Datei auf ein Gerät übertragen |
boolean
|
pushFile(File localFile, String remoteFilePath, int userId)
Eine Datei auf ein Gerät übertragen |
boolean
|
pushString(String contents, String remoteFilePath)
Aus einem String erstellte Datei an ein Gerät senden |
void
|
reboot(String reason)
Startet das Gerät im ADB-Modus neu. Der angegebene |
String
|
reboot(String command, String reason)
Startet das Gerät mit dem angegebenen |
void
|
reboot()
Startet das Gerät im ADB-Modus neu. |
void
|
rebootIntoBootloader()
Das Gerät wird im Bootloader-Modus neu gestartet. |
void
|
rebootIntoFastbootd()
Das Gerät wird im fastbootd-Modus neu gestartet. |
void
|
rebootIntoRecovery()
Das Gerät wird im ADB-Wiederherstellungsmodus neu gestartet. |
void
|
rebootIntoSideload()
Das Gerät wird im ADB-Sideload-Modus neu gestartet. Das ist ein spezieller Modus unter „Recovery“. Wird blockiert, bis das Gerät in den Sideload-Modus wechselt |
void
|
rebootIntoSideload(boolean autoReboot)
Das Gerät wird im ADB-Sideload-Modus neu gestartet. Das ist ein spezieller Modus unter „Recovery“. Wird blockiert, bis das Gerät in den Sideload-Modus wechselt |
void
|
rebootUntilOnline()
Eine Alternative zu |
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()
Es wird versucht, die Gerätekommunikation wiederherzustellen. |
void
|
registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)
Registriert ein |
void
|
remountSystemReadOnly()
Die Systempartition auf dem Gerät schreibgeschützt machen. |
void
|
remountSystemWritable()
Machen Sie die Systempartition auf dem Gerät beschreibbar. |
void
|
remountVendorReadOnly()
Machen Sie die Anbieterpartition auf dem Gerät schreibgeschützt. |
void
|
remountVendorWritable()
Machen Sie die Anbieterpartition auf dem Gerät beschreibbar. |
boolean
|
removeAdmin(String componentName, int userId)
Entfernt den angegebenen Geräteadministrator für den angegebenen Nutzer und gibt |
void
|
removeOwners()
Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen. |
boolean
|
removeUser(int userId)
Einen bestimmten Nutzer vom Gerät entfernen. |
void
|
resetContentProviderSetup()
Setzen Sie das Flag für die Einrichtung des Content-Anbieters zurück, um es noch einmal auszulösen. |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, Collection<ITestLifeCycleReceiver> listeners)
Führt Instrumentierungstests aus und bietet die Möglichkeit zur Geräte-Wiederherstellung. |
boolean
|
runInstrumentationTests(IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Bequeme Methode zum Ausführen von |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, Collection<ITestLifeCycleReceiver> listeners)
Wie |
boolean
|
runInstrumentationTestsAsUser(IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Wie |
void
|
setAdbPath(String adbPath)
Legt den Pfad zum zu verwendenden ADB-Binärprogramm fest. |
void
|
setConfiguration(IConfiguration configuration)
Fügt die verwendete |
final
void
|
setConnectionAvdInfo(GceAvdInfo avdInfo)
|
void
|
setDate(Date date)
Legt das Datum auf dem Gerät fest Hinweis: Das Festlegen des Datums auf dem Gerät erfordert Root-Zugriff. |
boolean
|
setDeviceOwner(String componentName, int userId)
Legt eine Geräteadministrator-Komponente als Geräteinhaber für einen bestimmten Nutzer fest. |
void
|
setDeviceState(TestDeviceState deviceState)
Aktualisieren Sie den Gerätestatus. |
void
|
setEmulatorOutputStream(SizeLimitedOutputStream output)
Für den Emulator legen Sie |
void
|
setEmulatorProcess(Process p)
Legt |
void
|
setFastbootEnabled(boolean fastbootEnabled)
Legen Sie die Fastboot-Option für das Gerät fest. |
void
|
setFastbootPath(String fastbootPath)
Legt den Pfad zum zu verwendenden Fastboot-Binärprogramm fest. |
void
|
setIDevice(IDevice newDevice)
Aktualisieren Sie das IDevice, das mit diesem ITestDevice verknüpft ist. |
void
|
setLogStartDelay(int delay)
Legt die Zeit in Millisekunden fest, die gewartet werden soll, bevor die Logcat-Erfassung für ein Onlinegerät gestartet wird. |
void
|
setOptions(TestDeviceOptions options)
|
boolean
|
setProperty(String propKey, String propValue)
Legt den angegebenen Eigenschaftswert auf dem Gerät fest. |
void
|
setRecovery(IDeviceRecovery recovery)
Legen Sie die |
void
|
setRecoveryMode(ITestDevice.RecoveryMode mode)
Legt den aktuellen Wiederherstellungsmodus fest, der für das Gerät verwendet werden soll. |
void
|
setSetting(String namespace, String key, String value)
Weitere Informationen finden Sie unter |
void
|
setSetting(int userId, String namespace, String key, String value)
Fügen Sie dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzu. |
void
|
setTestLogger(ITestLogger testLogger)
Fügt die |
void
|
setTrackingSerial(String trackingSerial)
Zur Geräteverwaltung wird die Seriennummer erfasst, die wir zur Referenzierung des Geräts verwenden. |
void
|
setUseFastbootErase(boolean useFastbootErase)
Legen Sie fest, ob zum Löschen einer Partition auf dem Gerät „fastboot erase“ oder „fastboot format“ verwendet werden soll. |
void
|
startLogcat()
Logcat-Ausgabe vom Gerät im Hintergrund erfassen. |
boolean
|
startTradeInModeTesting(int timeoutMs)
Aktivieren Sie den Testmodus für die Inzahlungnahme. |
boolean
|
startUser(int userId)
Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist. |
boolean
|
startUser(int userId, boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist. |
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, der auf dem angegebenen Display sichtbar ist (d.h. der Nutzer kann Aktivitäten auf diesem Display starten). |
void
|
stopEmulatorOutput()
Schließen Sie die Emulatorausgabe und löschen Sie sie. |
void
|
stopLogcat()
Die Erfassung der Logcat-Ausgabe vom Gerät wird beendet und die aktuell gespeicherten Logcat-Daten werden verworfen. |
void
|
stopTradeInModeTesting()
Test des Trade-In-Modus beenden |
boolean
|
stopUser(int userId)
Stoppt einen bestimmten Nutzer. |
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Einen bestimmten Nutzer stoppen. |
String
|
switchToAdbTcp()
Gerät in den ADB-over-TCP-Modus versetzen. |
boolean
|
switchToAdbUsb()
Schalten Sie das Gerät in den ADB-over-USB-Modus. |
boolean
|
switchUser(int userId)
Wechseln Sie mit einem Standard-Timeout zu einer anderen userId. |
boolean
|
switchUser(int userId, long timeout)
Wechseln Sie mit dem angegebenen Zeitlimit zu einer anderen userId. |
boolean
|
syncFiles(File localFileDir, String deviceFilePath)
Synchronisiert den Inhalt eines lokalen Dateiverzeichnisses inkrementell mit dem Gerät. |
Bugreport
|
takeBugreport()
Nimmt einen Fehlerbericht entgegen und gibt ihn in einem |
String
|
uninstallPackage(String packageName)
Ein Android-Paket vom Gerät deinstallieren. |
String
|
uninstallPackageForUser(String packageName, int userId)
Deinstalliert ein Android-Paket für einen bestimmten Nutzer von einem Gerät. |
boolean
|
unlockDevice()
Entsperrt das Gerät, wenn es verschlüsselt ist. |
void
|
unmountDebugfs()
debugfs trennen. |
boolean
|
waitForBootComplete(long timeOut)
Blockiert, bis das Boot-Complete-Flag des Geräts gesetzt ist. |
boolean
|
waitForDeviceAvailable()
Wartet, bis das Gerät reagiert und für Tests verfügbar ist. |
boolean
|
waitForDeviceAvailable(long waitTime)
Wartet, bis das Gerät reagiert und für Tests verfügbar ist. |
boolean
|
waitForDeviceAvailableInRecoverPath(long waitTime)
Wartet, bis das Gerät reagiert und verfügbar ist, ohne den Wiederherstellungspfad zu berücksichtigen. |
void
|
waitForDeviceBootloader()
Wird blockiert, bis das Gerät über Fastboot sichtbar ist. |
void
|
waitForDeviceFastbootD()
|
boolean
|
waitForDeviceInRecovery(long waitTime)
Sperrt das Gerät, wenn es sich im Status „adb recovery“ befindet. Dieser Status unterscheidet sich von |
boolean
|
waitForDeviceInSideload(long waitTime)
Blockiert, dass sich das Gerät im Status „adb sideload“ befindet |
boolean
|
waitForDeviceNotAvailable(long waitTime)
Blockiert, dass das Gerät nicht verfügbar ist, d. h. in ADB fehlt. |
void
|
waitForDeviceOnline()
Wird blockiert, bis das Gerät über ADB sichtbar ist. |
void
|
waitForDeviceOnline(long waitTime)
Wird blockiert, bis das Gerät über ADB sichtbar ist. |
boolean
|
waitForDeviceShell(long waitTime)
Wartet, bis das Gerät auf einen einfachen ADB-Shell-Befehl reagiert. |
Geschützte Methoden | |
|---|---|
void
|
addExtraConnectionBuilderArgs(DefaultConnection.ConnectionBuilder builder)
|
String[]
|
buildAdbShellCommand(String command, boolean forceExitStatusDetection, boolean oldShellCommand)
Erstellt den Betriebssystembefehl für die angegebene adb-Shell-Befehlssitzung und die Argumente. |
void
|
checkApiLevelAgainst(String feature, int strictMinLevel)
|
NativeDevice.RebootDeviceAction
|
createRebootDeviceAction(NativeDevice.RebootMode rebootMode, String reason)
Erstellt ein |
IRunUtil
|
createRunUtil()
|
void
|
doAdbReboot(NativeDevice.RebootMode rebootMode, String reason)
Führen Sie einen ADB-Neustart durch. |
void
|
ensureRuntimePermissionSupported()
Hilfsmethode zum Auslösen einer Ausnahme, wenn die Laufzeitberechtigung nicht unterstützt wird |
int
|
getApiLevelSafe()
|
ITestLogger
|
getLogger()
|
IRunUtil
|
getRunUtil()
Rufen Sie die zu verwendende |
String
|
internalGetProperty(String propName, String fastbootVar, String description)
Ruft eine Geräte-Property ab, standardmäßig aus dem ddmlib-Cache, und greift entweder auf „adb shell getprop“ oder „fastboot getvar“ zurück, je nachdem, ob sich das Gerät im Fastboot-Modus befindet oder nicht. |
boolean
|
isInRebootCallback()
Gibt zurück, ob Rückrufe für Neustarts gerade ausgeführt werden. |
boolean
|
isNewer(File localFile, IFileEntry entry)
Gibt |
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(NativeDevice.RebootMode rebootMode)
Mögliche zusätzliche Aktionen, die nach einem Neustart ausgeführt werden können. |
void
|
prePostBootSetup()
Ermöglicht es jedem Gerätetyp (AndroidNativeDevice, TestDevice), diese Methode für die spezifische Einrichtung nach dem Booten zu überschreiben. |
boolean
|
pullFileWithAdbCommand(String remoteFilePath, File localFile, long timeout)
|
void
|
setClock(Clock clock)
Legen Sie die zu verwendende Clock-Instanz fest. |
void
|
setMicrodroidProcess(Process process)
Kennzeichnet das Testgerät als Microdroid und legt seine CID fest. |
void
|
setTestDeviceOptions(Map<String, String> deviceOptions)
|
CommandResult
|
simpleFastbootCommand(long timeout, String[] fullCmd)
Führt einen einfachen Fastboot-Befehl aus und meldet den Status des Befehls. |
CommandResult
|
simpleFastbootCommand(long timeout, Map<String, String> envVarMap, String[] fullCmd)
Führt einen einfachen Fastboot-Befehl mit Umgebungsvariablen aus und meldet den Status des Befehls. |
boolean
|
waitForDeviceNotAvailable(String operationDesc, long time)
Warten Sie, bis das Gerät nicht mehr verfügbar ist (keine Berichte mehr an adb gesendet werden). |
Konstanten
DEBUGFS_PATH
public static final String DEBUGFS_PATH
Konstanter Wert: "/sys/kernel/debug"
INVALID_USER_ID
public static final int INVALID_USER_ID
Wert, der für eine ungültige/nicht gefundene Nutzer-ID zurückgegeben wird: UserHandle hat den Wert -10000 definiert.
Konstanter Wert: -10000 (0xffffd8f0)
MAX_HOST_DEVICE_TIME_OFFSET
protected static final long MAX_HOST_DEVICE_TIME_OFFSET
Konstanter Wert: 5000 (0x0000000000001388)
MAX_RETRY_ATTEMPTS
protected static final int MAX_RETRY_ATTEMPTS
die Standardanzahl der Wiederholungsversuche für Befehle
Konstanter Wert: 2 (0x00000002)
SD_CARD
protected static final String SD_CARD
Konstanter Wert: "/sdcard/"
STORAGE_EMULATED
protected static final String STORAGE_EMULATED
Konstanter Wert: "/storage/emulated/"
Felder
Öffentliche Konstruktoren
NativeDevice
public NativeDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)
Erstellt ein TestDevice.
| Parameter | |
|---|---|
device |
IDevice: die zugehörige IDevice |
stateMonitor |
IDeviceStateMonitor: der zu verwendende IDeviceStateMonitor-Mechanismus |
allocationMonitor |
IDeviceMonitor: Die IDeviceMonitor, die über Änderungen des Zuweisungsstatus informiert werden soll.
Kann null sein. |
Öffentliche Methoden
adbInstallPackage
public String adbInstallPackage (File packageFile,
boolean reinstall,
String... extraArgs)Installieren Sie ein Android-Paket mit dem adb-Befehl auf einem Gerät.
| Parameter | |
|---|---|
packageFile |
File: die zu installierende APK-Datei |
reinstall |
boolean: true, wenn eine Neuinstallation durchgeführt werden soll |
extraArgs |
String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“. |
| Gibt Folgendes zurück: | |
|---|---|
String |
String mit einem Fehlercode oder null bei Erfolg. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
adbInstallPackage
public String adbInstallPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)Installieren Sie ein Android-Paket mit dem adb-Befehl auf einem Gerät.
Hinweis: Diese Funktion sollte nur für Anwendungsfälle aufgerufen werden, die eine explizite Steuerung der Erteilung der Laufzeitberechtigung bei der Installation erfordern.
| Parameter | |
|---|---|
packageFile |
File: die zu installierende APK-Datei |
reinstall |
boolean: true, wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions |
boolean: Gibt an, ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen. |
extraArgs |
String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“. |
| Gibt Folgendes zurück: | |
|---|---|
String |
String mit einem Fehlercode oder null bei Erfolg. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
batchPrefetchStartupBuildProps
public void batchPrefetchStartupBuildProps ()
Mikrooptimierung (ca. 400 Millisekunden) durch Vorabrufen aller benötigten Attribute anstatt „adb getprop“ für jedes Attribut aufzurufen. Das heißt, es ist genauso schnell, alle Attribute abzurufen wie nur eines. Funktionen wie device.getApiLevel(), checkApiLevelAgainstNextRelease und getBuildAlias rufen im Hintergrund alle `adb getprop` auf. Wir rufen sie in einem Aufruf ab und rufen NativeDevice.setProperty auf. Auch wenn wir das nicht tun, ruft NativeDevice selbst „setProperty“ auf und speichert das Ergebnis für zukünftige Aufrufe im Cache. Wir machen es nur etwas früher. Wenn sich das Gerät im Wiederherstellungsmodus befindet oder beim Abrufen der Attribute andere Fehler auftreten, werden diese einfach ignoriert.
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Gibt zurück, ob der Wechsel zum monitorlosen SYSTEM-Nutzer zulässig ist.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
checkApiLevelAgainstNextRelease
public boolean checkApiLevelAgainstNextRelease (int strictMinLevel)
Prüfen, ob eine Funktion bei einem minimal unterstützten Level derzeit unterstützt wird. Bei dieser Methode werden noch nicht veröffentlichte Funktionen berücksichtigt, bevor das API-Level erhöht wird.
| Parameter | |
|---|---|
strictMinLevel |
int: Die niedrigste mögliche Stufe, die das Feature unterstützt. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn die Stufe unterstützt wird. Andernfalls „Falsch”. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
checkConnectivity
public boolean checkConnectivity ()
Prüfen Sie, ob das Gerät eine Netzwerkverbindung hat.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn das Gerät über eine funktionierende Netzwerkverbindung verfügt,
false andernfalls. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
clearErrorDialogs
public boolean clearErrorDialogs ()
Schließen Sie alle Fehlerdialogfelder, die derzeit auf der Geräte-UI angezeigt werden.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn keine Dialogfelder vorhanden waren oder Dialogfelder erfolgreich gelöscht wurden.
Andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
clearLastConnectedWifiNetwork
public void clearLastConnectedWifiNetwork ()
Löscht das zuletzt verbundene WLAN. Diese Methode sollte beim Starten eines neuen Aufrufs aufgerufen werden, um zu vermeiden, dass nach dem Neustart des Geräts eine Verbindung zum WLAN hergestellt wird, das im vorherigen Test verwendet wurde.
clearLogcat
public void clearLogcat ()
Löscht alle angesammelten Logcat-Daten.
Das ist nützlich, wenn Sie sicherstellen möchten, dass ITestDevice.getLogcat() nur Logdaten zurückgibt, die nach einem bestimmten Zeitpunkt erzeugt wurden, z. B. nach dem Flashen eines neuen Geräte-Builds.
connectToWifiNetworkIfNeededWithResult
public IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, String wifiPsk, boolean scanSsid)
Eine Variante von connectToWifiNetwork(String,String), die nur eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.
| Parameter | |
|---|---|
scanSsid |
boolean: Gibt an, ob für dieses Netzwerk nach einer verborgenen SSID gesucht werden soll. |
| Gibt Folgendes zurück: | |
|---|---|
IWifiHelper.WifiConnectionResult |
WifiConnectionResult gibt den Status der Verbindung an. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
connectToWifiNetworkIfNeededWithResult
public IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, String wifiPsk)
Eine Variante von connectToWifiNetwork(String,String), die nur eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.
| Gibt Folgendes zurück: | |
|---|---|
IWifiHelper.WifiConnectionResult |
WifiConnectionResult gibt den Status der Verbindung an. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
connectToWifiNetworkWithResult
public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, String wifiPsk, boolean scanSsid)
Verbindung zu einem WLAN herstellen
Aktiviert WLAN und blockiert, bis eine Verbindung zum angegebenen WLAN hergestellt wurde. Sobald eine Verbindung hergestellt wurde, versucht die Instanz, die Verbindung nach jedem Neustart wiederherzustellen, bis ITestDevice.disconnectFromWifi() oder ITestDevice.clearLastConnectedWifiNetwork() aufgerufen wird.
| Parameter | |
|---|---|
wifiSsid |
String: Die WLAN-SSID, mit der eine Verbindung hergestellt werden soll |
wifiPsk |
String: PSK-Passphrase oder „null“, wenn nicht verschlüsselt |
scanSsid |
boolean: Gibt an, ob für dieses Netzwerk nach verborgenen SSIDs gesucht werden soll. |
| Gibt Folgendes zurück: | |
|---|---|
IWifiHelper.WifiConnectionResult |
WifiConnectionResult gibt den Status der Verbindung an. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
connectToWifiNetworkWithResult
public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk)
Verbindung zu einem WLAN herstellen
Aktiviert WLAN und blockiert, bis eine Verbindung zu einem der WLANs in der Karte „wifiSsidToPsk“ hergestellt wird. Sobald eine Verbindung hergestellt wurde, versucht die Instanz, die Verbindung nach jedem Neustart wiederherzustellen, bis ITestDevice.disconnectFromWifi() oder ITestDevice.clearLastConnectedWifiNetwork() aufgerufen wird.
| Parameter | |
|---|---|
wifiSsidToPsk |
Map: Eine Zuordnung von WLAN-SSIDs zu Passwörtern. |
| Gibt Folgendes zurück: | |
|---|---|
IWifiHelper.WifiConnectionResult |
WifiConnectionResult gibt den Status der Verbindung an. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
connectToWifiNetworkWithResult
public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk, boolean scanSsid)
Verbindung zu einem WLAN herstellen
Aktiviert WLAN und blockiert, bis eine Verbindung zu einem der WLANs in der Karte „wifiSsidToPsk“ hergestellt wird. Sobald eine Verbindung hergestellt wurde, versucht die Instanz, die Verbindung nach jedem Neustart wiederherzustellen, bis ITestDevice.disconnectFromWifi() oder ITestDevice.clearLastConnectedWifiNetwork() aufgerufen wird.
| Parameter | |
|---|---|
wifiSsidToPsk |
Map: Eine Zuordnung von WLAN-SSIDs zu Passwörtern. |
scanSsid |
boolean: Gibt an, ob für dieses Netzwerk nach verborgenen SSIDs gesucht werden soll. |
| Gibt Folgendes zurück: | |
|---|---|
IWifiHelper.WifiConnectionResult |
WifiConnectionResult gibt den Status der Verbindung an. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
connectToWifiNetworkWithResult
public IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, String wifiPsk)
Verbindung zu einem WLAN herstellen
Aktiviert WLAN und blockiert, bis eine Verbindung zum angegebenen WLAN hergestellt wurde. Sobald eine Verbindung hergestellt wurde, versucht die Instanz, die Verbindung nach jedem Neustart wiederherzustellen, bis ITestDevice.disconnectFromWifi() oder ITestDevice.clearLastConnectedWifiNetwork() aufgerufen wird.
| Parameter | |
|---|---|
wifiSsid |
String: Die WLAN-SSID, mit der eine Verbindung hergestellt werden soll |
wifiPsk |
String: PSK-Passphrase oder „null“, wenn nicht verschlüsselt |
| Gibt Folgendes zurück: | |
|---|---|
IWifiHelper.WifiConnectionResult |
WifiConnectionResult gibt den Status der Verbindung an. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral)Einen Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen
| Parameter | |
|---|---|
name |
String: des Nutzers, der auf dem Gerät erstellt werden soll |
guest |
boolean: Aktivieren Sie das Nutzer-Flag „--guest“ während der Erstellung. |
ephemeral |
boolean: Aktivieren Sie das Nutzer-Flag „--ephemeral“ bei der Erstellung. |
| Gibt Folgendes zurück: | |
|---|---|
int |
ID des erstellten Nutzers |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
IllegalStateException |
|
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)Einen Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen
| Parameter | |
|---|---|
name |
String: des Nutzers, der auf dem Gerät erstellt werden soll |
guest |
boolean: Aktivieren Sie das Nutzer-Flag „--guest“ während der Erstellung. |
ephemeral |
boolean: Aktivieren Sie das Nutzer-Flag „--ephemeral“ bei der Erstellung. |
forTesting |
boolean: Aktivieren Sie beim Erstellen das Testflag „--for-testing“. |
| Gibt Folgendes zurück: | |
|---|---|
int |
ID des erstellten Nutzers |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
IllegalStateException |
|
createUser
public int createUser (String name)
Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
| Parameter | |
|---|---|
name |
String: des Nutzers, der auf dem Gerät erstellt werden soll |
| Gibt Folgendes zurück: | |
|---|---|
int |
Die Ganzzahl für die erstellte Nutzer-ID. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
IllegalStateException |
|
createUserNoThrow
public int createUserNoThrow (String name)
Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
| Parameter | |
|---|---|
name |
String: des Nutzers, der auf dem Gerät erstellt werden soll |
| Gibt Folgendes zurück: | |
|---|---|
int |
Die Ganzzahl für die erstellte Nutzer-ID oder -1 bei einem Fehler. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
debugDeviceNotAvailable
public DeviceInspectionResult debugDeviceNotAvailable ()
Ein Gerät prüfen und detaillierte Informationen zurückgeben, wenn ein Gerät nicht mehr verfügbar ist.
| Gibt Folgendes zurück: | |
|---|---|
DeviceInspectionResult |
|
deleteFile
public void deleteFile (String deviceFilePath,
int userId)Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät.
| Parameter | |
|---|---|
deviceFilePath |
String: Der absolute Pfad der Datei auf dem Gerät. |
userId |
int: Die Nutzer-ID, die gelöscht werden soll |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
deleteFile
public void deleteFile (String deviceFilePath)
Hilfsmethode zum Löschen einer Datei oder eines Verzeichnisses auf dem Gerät.
| Parameter | |
|---|---|
deviceFilePath |
String: Der absolute Pfad der Datei auf dem Gerät. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
deregisterDeviceActionReceiver
public void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Entfernt die registrierte IDeviceActionReceiver.
| Parameter | |
|---|---|
deviceActionReceiver |
IDeviceActionReceiver: Ein IDeviceActionReceiver, das entfernt wird. |
deviceSoftRestarted
public boolean deviceSoftRestarted (ProcessInfo prevSystemServerProcess)
Hilfsmethode zum Prüfen, ob das Gerät durch Vergleich des aktuellen system_server mit dem vorherigen system_server ProcessInfo neu gestartet wurde. Verwende getProcessByName(String) als Zahlungsmethode, um ProcessInfo zu erhalten.
| Parameter | |
|---|---|
prevSystemServerProcess |
ProcessInfo: Der vorherige system_server-Prozess ProcessInfo. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn das Gerät per Software neu gestartet wurde |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
deviceSoftRestartedSince
public boolean deviceSoftRestartedSince (long utcEpochTime,
TimeUnit timeUnit)Hilfsmethode, um zu prüfen, ob das Gerät seit der UTC-Zeit seit der Epoche vom Gerät und seinem TimeUnit neu gestartet wurde. Ein Soft-Restart bezieht sich auf einen Neustart von system_server außerhalb eines Hard-Reboot des Geräts (z. B. ein angeforderter Neustart). Die aktuelle utcEpochTime des Geräts in Millisekunden kann mit der Methode getDeviceDate() abgerufen werden.
| Parameter | |
|---|---|
utcEpochTime |
long: Die Gerätezeit in Sekunden seit der Epoche. |
timeUnit |
TimeUnit: die Zeiteinheit TimeUnit für die angegebene utcEpochTime. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn das Gerät per Software neu gestartet wurde |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
disableAdbRoot
public boolean disableAdbRoot ()
Deaktiviert den ADB-Root-Zugriff.
Wenn Sie „adb root“ deaktivieren, kann es sein, dass die Verbindung des Geräts zu ADB getrennt wird. Diese Methode wird blockiert, bis das Gerät verfügbar ist.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, falls erfolgreich. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
disableKeyguard
public void disableKeyguard ()
Es wird versucht, die Keyguard-Funktion zu deaktivieren.
Warten Sie zuerst, bis die Eingabe bereit ist. Das passiert ungefähr zur selben Zeit, zu der das Gerät BOOT_COMPLETE meldet. Das geschieht anscheinend asynchron, da die aktuelle Framework-Implementierung gelegentlich Race Conditions aufweist. Anschließend wird der Befehl zum Schließen des Keyguards gesendet (funktioniert nur bei nicht sicheren Keyguards).
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
disableNetworkMonitor
public boolean disableNetworkMonitor ()
Deaktiviert die Netzwerküberwachung auf dem Gerät.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn das Monitoring erfolgreich deaktiviert wurde. false, wenn der Vorgang fehlgeschlagen ist. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
disconnectFromWifi
public boolean disconnectFromWifi ()
Die Verbindung zu einem WLAN wird getrennt.
Entfernt alle Netzwerke aus der Liste der bekannten Netzwerke und deaktiviert WLAN.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Verbindung zum WLAN getrennt wurde. false
wenn das Trennen der Verbindung fehlgeschlagen ist. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
doesFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät für einen bestimmten Nutzer vorhanden ist.
| Parameter | |
|---|---|
deviceFilePath |
String: Der absolute Pfad der Datei auf dem Gerät, die geprüft werden soll. |
userId |
int: Die Nutzer-ID, anhand der die Existenz der Datei geprüft werden soll. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Datei vorhanden ist, andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
doesFileExist
public boolean doesFileExist (String deviceFilePath)
Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät vorhanden ist.
| Parameter | |
|---|---|
deviceFilePath |
String: Der absolute Pfad der Datei auf dem Gerät, die geprüft werden soll. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Datei vorhanden ist, andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
dumpHeap
public File dumpHeap (String process,
String devicePath)Versuchen Sie, den Heap aus dem system_server zu sichern. Der Aufrufer ist für das Bereinigen der gesicherten Datei verantwortlich.
| Parameter | |
|---|---|
process |
String: Der Name des Geräteprozesses, für den „dumpheap“ ausgeführt werden soll. |
devicePath |
String: Der Pfad auf dem Gerät, unter dem der Dump abgelegt werden soll. Das muss ein Ort sein, an dem dies aufgrund der Berechtigungen zulässig ist. |
| Gibt Folgendes zurück: | |
|---|---|
File |
File, der den Bericht enthält. „Null“, wenn ein Fehler aufgetreten ist. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
enableAdbRoot
public boolean enableAdbRoot ()
Aktiviert „adb root“. Wenn die Einstellung „enable-root“ auf „false“ gesetzt ist, wird eine Meldung protokolliert und die Funktion wird beendet, ohne Root zu aktivieren.
Wenn Sie „adb root“ aktivieren, kann es passieren, dass die Verbindung des Geräts zu ADB getrennt wird. Diese Methode wird blockiert, bis das Gerät verfügbar ist.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, falls erfolgreich. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
enableNetworkMonitor
public boolean enableNetworkMonitor ()
Aktiviert die Netzwerküberwachung auf dem Gerät.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn das Monitoring erfolgreich aktiviert wurde. false, wenn der Vorgang fehlgeschlagen ist. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeAdbCommand
public String executeAdbCommand (long timeout,
String... cmdArgs)Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.
executeShellCommand(String) sollte nach Möglichkeit immer verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.
| Parameter | |
|---|---|
timeout |
long: Die Zeit in Millisekunden, nach der das Gerät als nicht reagierend gilt. 0L für kein Zeitlimit. |
cmdArgs |
String: der auszuführende ADB-Befehl und die Argumente |
| Gibt Folgendes zurück: | |
|---|---|
String |
die Standardausgabe des Befehls. null, wenn der Befehl nicht ausgeführt werden konnte. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeAdbCommand
public String executeAdbCommand (String... cmdArgs)
Hilfsmethode, die einen ADB-Befehl als Systembefehl ausführt.
executeShellCommand(String) sollte nach Möglichkeit immer verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.
| Parameter | |
|---|---|
cmdArgs |
String: der auszuführende ADB-Befehl und die Argumente |
| Gibt Folgendes zurück: | |
|---|---|
String |
die Standardausgabe des Befehls. null, wenn der Befehl nicht ausgeführt werden konnte. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeAdbCommand
public String executeAdbCommand (long timeout,
Map<String, String> envMap,
String... cmdArgs)Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.
executeShellCommand(String) sollte nach Möglichkeit immer verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.
| Parameter | |
|---|---|
timeout |
long: Die Zeit in Millisekunden, nach der das Gerät als nicht reagierend gilt. 0L für kein Zeitlimit. |
envMap |
Map: Umgebung, die für den Befehl festgelegt werden soll |
cmdArgs |
String: der auszuführende ADB-Befehl und die Argumente |
| Gibt Folgendes zurück: | |
|---|---|
String |
die Standardausgabe des Befehls. null, wenn der Befehl nicht ausgeführt werden konnte. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeAdbV2Command
public CommandResult executeAdbV2Command (String... cmdArgs)
Hilfsmethode, die einen ADB-Befehl als Systembefehl ausführt.
executeShellCommand(String) sollte nach Möglichkeit immer verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.
| Parameter | |
|---|---|
cmdArgs |
String: der auszuführende ADB-Befehl und die Argumente |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
Das CommandResult mit der Ausgabe des Befehls. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeAdbV2Command
public CommandResult executeAdbV2Command (long timeout, String... cmdArgs)
Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.
executeShellCommand(String) sollte nach Möglichkeit immer verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.
| Parameter | |
|---|---|
timeout |
long: Die Zeit in Millisekunden, nach der das Gerät als nicht reagierend gilt. 0L für kein Zeitlimit. |
cmdArgs |
String: der auszuführende ADB-Befehl und die Argumente |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
Das CommandResult mit der Ausgabe des Befehls. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeAdbV2Command
public CommandResult executeAdbV2Command (long timeout, Map<String, String> envMap, String... cmdArgs)
Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.
executeShellCommand(String) sollte nach Möglichkeit immer verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.
| Parameter | |
|---|---|
timeout |
long: Die Zeit in Millisekunden, nach der das Gerät als nicht reagierend gilt. 0L für kein Zeitlimit. |
envMap |
Map: Umgebung, die für den Befehl festgelegt werden soll |
cmdArgs |
String: der auszuführende ADB-Befehl und die Argumente |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
Das CommandResult mit der Ausgabe des Befehls. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeAdbV2Command
public CommandResult executeAdbV2Command (long timeout, Map<String, String> envMap, int retryAttempts, String... cmdArgs)
Hilfsmethode, die einen ADB-Befehl als Systembefehl mit einem angegebenen Zeitlimit ausführt.
executeShellCommand(String) sollte nach Möglichkeit immer verwendet werden, da diese Methode eine bessere Fehlererkennung und Leistung bietet.
| Parameter | |
|---|---|
timeout |
long: Die Zeit in Millisekunden, nach der das Gerät als nicht reagierend gilt. 0L für kein Zeitlimit. |
envMap |
Map: Umgebung, die für den Befehl festgelegt werden soll |
retryAttempts |
int: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn retryAttempts nicht erfolgreich ausgeführt werden. |
cmdArgs |
String: der auszuführende ADB-Befehl und die Argumente |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
Das CommandResult mit der Ausgabe des Befehls. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeFastbootCommand
public CommandResult executeFastbootCommand (String... cmdArgs)
Hilfsmethode, die einen Fastboot-Befehl als Systembefehl mit einem Standard-Timeout von 2 Minuten ausführt.
Sollte verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus befindet.
| Parameter | |
|---|---|
cmdArgs |
String: der Fastboot-Befehl und die Argumente, die ausgeführt werden sollen |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
das CommandResult mit der Ausgabe des Befehls |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
UnsupportedOperationException |
|
executeFastbootCommand
public CommandResult executeFastbootCommand (long timeout, String... cmdArgs)
Hilfsmethode, die einen Fastboot-Befehl als Systembefehl ausführt.
Sollte verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus befindet.
| Parameter | |
|---|---|
timeout |
long: die Zeit in Millisekunden, bevor der Befehl abläuft |
cmdArgs |
String: der Fastboot-Befehl und die Argumente, die ausgeführt werden sollen |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
das CommandResult mit der Ausgabe des Befehls |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
UnsupportedOperationException |
|
executeLongFastbootCommand
public CommandResult executeLongFastbootCommand (String... cmdArgs)
Hilfsmethode, die einen zeitaufwendigen Fastboot-Befehl als Systembefehl ausführt.
Identisch mit executeFastbootCommand(String...), verwendet jedoch ein längeres Zeitlimit.
| Parameter | |
|---|---|
cmdArgs |
String: der Fastboot-Befehl und die Argumente, die ausgeführt werden sollen |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
das CommandResult mit der Ausgabe des Befehls |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
UnsupportedOperationException |
|
executeLongFastbootCommand
public CommandResult executeLongFastbootCommand (Map<String, String> envVarMap, String... cmdArgs)
Hilfsmethode, die einen zeitaufwendigen Fastboot-Befehl als Systembefehl mit Systemumgebungsvariablen ausführt.
Identisch mit executeFastbootCommand(String...), verwendet jedoch ein längeres Zeitlimit.
| Parameter | |
|---|---|
envVarMap |
Map: Die Systemumgebungsvariablen, mit denen der Fastboot-Befehl ausgeführt wird. |
cmdArgs |
String: der Fastboot-Befehl und die Argumente, die ausgeführt werden sollen |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
das CommandResult mit der Ausgabe des Befehls |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
UnsupportedOperationException |
|
executeShellCommand
public String executeShellCommand (String command)
Hilfsmethode, die einen ADB-Shellbefehl ausführt und die Ausgabe als String zurückgibt.
| Parameter | |
|---|---|
command |
String: Der auszuführende ADB-Shell-Befehl. |
| Gibt Folgendes zurück: | |
|---|---|
String |
die Shell-Ausgabe |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeShellCommand
public void executeShellCommand (String command,
IShellOutputReceiver receiver,
long maxTimeToOutputShellResponse,
TimeUnit timeUnit,
int retryAttempts)Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
| Parameter | |
|---|---|
command |
String: Der auszuführende ADB-Shell-Befehl. |
receiver |
IShellOutputReceiver: der IShellOutputReceiver, an den die Shell-Ausgabe weitergeleitet werden soll. |
maxTimeToOutputShellResponse |
long: Die maximale Zeit, in der der Befehl keine Antwort ausgeben darf. Die Einheit wird in timeUnit angegeben. |
timeUnit |
TimeUnit: Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn retryAttempts nicht erfolgreich ausgeführt werden. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeShellCommand
public void executeShellCommand (String command,
IShellOutputReceiver receiver,
long maxTimeoutForCommand,
long maxTimeToOutputShellResponse,
TimeUnit timeUnit,
int retryAttempts)Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
| Parameter | |
|---|---|
command |
String: Der auszuführende ADB-Shell-Befehl. |
receiver |
IShellOutputReceiver: der IShellOutputReceiver, an den die Shell-Ausgabe weitergeleitet werden soll. |
maxTimeoutForCommand |
long: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in timeUnit angegeben. |
maxTimeToOutputShellResponse |
long: Die maximale Zeit, in der der Befehl keine Antwort ausgeben darf. Die Einheit wird in timeUnit angegeben. |
timeUnit |
TimeUnit: Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn retryAttempts nicht erfolgreich ausgeführt werden. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeShellCommand
public void executeShellCommand (String command,
IShellOutputReceiver receiver)Führt den angegebenen ADB-Shell-Befehl aus und versucht es mehrmals, wenn der Befehl fehlschlägt.
Eine einfachere Form von executeShellCommand(String,IShellOutputReceiver,long,TimeUnit,int) mit Standardwerten.
| Parameter | |
|---|---|
command |
String: Der auszuführende ADB-Shell-Befehl. |
receiver |
IShellOutputReceiver: der IShellOutputReceiver, an den die Shell-Ausgabe weitergeleitet werden soll. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd)
Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die mit der Befehlsstatusausgabe, stdout und stderr gefüllt ist.
| Parameter | |
|---|---|
cmd |
String: Der Befehl, der ausgeführt werden soll. |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
Das Ergebnis in CommandResult. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
| Parameter | |
|---|---|
cmd |
String: Der auszuführende ADB-Shell-Befehl. |
pipeAsInput |
File: Eine File, die als Eingabe an den Befehl weitergeleitet wird, oder „null“. |
pipeToOutput |
OutputStream: OutputStream, in die die Standardausgabe umgeleitet wird, oder „null“. |
maxTimeoutForCommand |
long: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in timeUnit angegeben. |
timeUnit |
TimeUnit: Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn retryAttempts nicht erfolgreich ausgeführt werden. |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit)
Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
| Parameter | |
|---|---|
cmd |
String: Der auszuführende ADB-Shell-Befehl. |
maxTimeoutForCommand |
long: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in timeUnit angegeben. |
timeUnit |
TimeUnit: Einheit für maxTimeToOutputShellResponse |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput)
Hilfsmethode, die einen adb-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die mit der Befehlsstatusausgabe, stdout und stderr gefüllt ist.
| Parameter | |
|---|---|
cmd |
String: Der Befehl, der ausgeführt werden soll. |
pipeAsInput |
File: Ein File, das als Eingabe an den Befehl weitergeleitet wird, oder „null“. |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
Das Ergebnis in CommandResult. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
| Parameter | |
|---|---|
cmd |
String: Der auszuführende ADB-Shell-Befehl. |
maxTimeoutForCommand |
long: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in timeUnit angegeben. |
timeUnit |
TimeUnit: Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn retryAttempts nicht erfolgreich ausgeführt werden. |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, OutputStream pipeToOutput)
Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die mit der Befehlsstatusausgabe und stderr gefüllt ist. stdout wird an den angegebenen Stream weitergeleitet.
| Parameter | |
|---|---|
cmd |
String: Der Befehl, der ausgeführt werden soll. |
pipeToOutput |
OutputStream: OutputStream, in die die Standardausgabe umgeleitet wird, oder „null“. |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
Das Ergebnis in CommandResult. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, TimeUnit timeUnit, int retryAttempts)
Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
| Parameter | |
|---|---|
cmd |
String: Der auszuführende ADB-Shell-Befehl. |
pipeAsInput |
File: Ein File, das als Eingabe an den Befehl weitergeleitet wird, oder „null“. |
pipeToOutput |
OutputStream: OutputStream, in die die Standardausgabe umgeleitet wird, oder „null“. |
pipeToError |
OutputStream: OutputStream, wohin der Standardfehler weitergeleitet wird, oder „null“. |
maxTimeoutForCommand |
long: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in timeUnit angegeben. |
timeUnit |
TimeUnit: Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn retryAttempts nicht erfolgreich ausgeführt werden. |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, File pipeAsInput, OutputStream pipeToOutput, OutputStream pipeToError, long maxTimeoutForCommand, long maxTimeToOutputShellResponse, TimeUnit timeUnit, int retryAttempts)
Führt einen ADB-Shell-Befehl mit weiteren Parametern zur Steuerung des Befehlsverhaltens aus.
| Parameter | |
|---|---|
cmd |
String: Der auszuführende ADB-Shell-Befehl. |
pipeAsInput |
File: Ein File, das als Eingabe an den Befehl weitergeleitet wird, oder „null“. |
pipeToOutput |
OutputStream: OutputStream, in die die Standardausgabe umgeleitet wird, oder „null“. |
pipeToError |
OutputStream: OutputStream, wohin der Standardfehler weitergeleitet wird, oder „null“. |
maxTimeoutForCommand |
long: Das maximale Zeitlimit für den Abschluss des Befehls. Die Einheit wird in timeUnit angegeben. |
maxTimeToOutputShellResponse |
long: Die maximale Zeit, in der der Befehl keine Antwort ausgeben darf. Die Einheit wird in timeUnit angegeben. |
timeUnit |
TimeUnit: Einheit für maxTimeToOutputShellResponse |
retryAttempts |
int: Die maximale Anzahl von Wiederholungsversuchen für den Befehl, wenn er aufgrund einer Ausnahme fehlschlägt. „DeviceNotResponsiveException“ wird ausgelöst, wenn retryAttempts nicht erfolgreich ausgeführt werden. |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
executeShellV2Command
public CommandResult executeShellV2Command (String cmd, IShellOutputReceiver receiver)
Hilfsmethode, die einen ADB-Shell-Befehl ausführt und die Ergebnisse als CommandResult zurückgibt, die mit der Befehlsstatusausgabe, stdout und stderr gefüllt ist.
| Parameter | |
|---|---|
cmd |
String: Der Befehl, der ausgeführt werden soll. |
receiver |
IShellOutputReceiver: der IShellOutputReceiver, an den die Shell-Ausgabe weitergeleitet werden soll. |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
Das Ergebnis in CommandResult. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
fastbootOemRamdumpNow
public CommandResult fastbootOemRamdumpNow ()
Hilfsmethode, die einen RAM-Dump über den Fastboot-Modus auslöst.
Bei dieser Methode wird der Befehl „oem ramdump now“ ausgeführt. Im Gegensatz zu ERROR(/#executeFastbootCommand()) werden keine Wiederholungen oder Geräte-Recovery-Versuche unternommen, wenn der Befehl fehlschlägt oder der Status ungültig ist, da ein Geräteabsturz das beabsichtigte Ergebnis ist.
Sollte verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus befindet.
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
das CommandResult mit der Ausgabe des Befehls |
fastbootWipePartition
public CommandResult fastbootWipePartition (String partition)
Helper-Methode, mit der eine Partition für das Gerät gelöscht wird.
Wenn getUseFastbootErase() true ist, wird die Partition mit „fastboot erase“ gelöscht. Das Gerät muss dann beim nächsten Booten ein Dateisystem erstellen.
Andernfalls wird „fastboot format“ verwendet, wodurch ein neues Dateisystem auf dem Gerät erstellt wird.
Sollte verwendet werden, wenn sich das Gerät bereits im Schnellstartmodus befindet.
| Parameter | |
|---|---|
partition |
String: die zu löschende Partition |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
das CommandResult mit der Ausgabe des Befehls |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getActiveApexes
public Set<ITestDevice.ApexInfo> getActiveApexes ()
Ruft die Informationen zu den auf dem Gerät aktivierten APEX-Modulen ab.
| Gibt Folgendes zurück: | |
|---|---|
Set<ITestDevice.ApexInfo> |
Set von ApexInfo ist derzeit auf dem Gerät aktiviert |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getAdbPath
public String getAdbPath ()
Gibt den Pfad der verwendeten ADB-Binärdatei zurück.
| Gibt Folgendes zurück: | |
|---|---|
String |
|
getAllSettings
public Map<String, String> getAllSettings (String namespace)
Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück.
| Parameter | |
|---|---|
namespace |
String: muss einer der folgenden Werte sein: {"system", "secure", "global"} |
| Gibt Folgendes zurück: | |
|---|---|
Map<String, String> |
Die Zuordnung von Schlüssel/Wert-Paaren. „Null“, wenn der Namespace nicht unterstützt wird. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getAllocationState
public DeviceAllocationState getAllocationState ()
Gibt den aktuellen Zuweisungsstatus des Geräts zurück
| Gibt Folgendes zurück: | |
|---|---|
DeviceAllocationState |
|
getAndroidId
public String getAndroidId (int userId)
Sucht die Android-ID, die einem Nutzer zugeordnet ist, und gibt sie zurück. Wenn sie nicht gefunden wird, wird „null“ zurückgegeben.
| Parameter | |
|---|---|
userId |
int |
| Gibt Folgendes zurück: | |
|---|---|
String |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getAndroidIds
public Map<Integer, String> getAndroidIds ()
Erstellen Sie eine Zuordnung von Android-IDs, die mit Nutzer-IDs übereinstimmen. Es gibt keine Garantie, dass für jede User-ID eine zugehörige Android-ID gefunden wird. Daher kann es vorkommen, dass einige User-IDs mit „null“ übereinstimmen.
| Gibt Folgendes zurück: | |
|---|---|
Map<Integer, String> |
Zuordnung von Android-IDs, die mit Nutzer-IDs übereinstimmen. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getApiLevel
public int getApiLevel ()
Das API-Level des Geräts abrufen. Die Standardeinstellung ist UNKNOWN_API_LEVEL.
| Gibt Folgendes zurück: | |
|---|---|
int |
Eine Ganzzahl, die das API-Level des Geräts angibt |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getApiLevelFull
public int getApiLevelFull ()
Ähnlich wie getApiLevel(), gibt aber die vollständige Version zurück.
| Gibt Folgendes zurück: | |
|---|---|
int |
Eine Ganzzahl, die das vollständige API-Level des Geräts angibt. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Informationen zu einem auf dem Gerät installierten Paket abrufen.
| Parameter | |
|---|---|
packageName |
String |
| Gibt Folgendes zurück: | |
|---|---|
PackageInfo |
PackageInfo oder null, wenn Informationen nicht abgerufen werden konnten |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getAppPackageInfos
public List<PackageInfo> getAppPackageInfos ()
Informationen zu auf dem Gerät installierten Paketen abrufen.
| Gibt Folgendes zurück: | |
|---|---|
List<PackageInfo> |
List von PackageInfo, die auf dem Gerät installiert sind. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getBasebandVersion
public String getBasebandVersion ()
Einfache Methode zum Abrufen der Baseband-Version (Funkmodul) dieses Geräts. Das Abrufen der Funkversion ist gerätespezifisch. Daher werden möglicherweise nicht für alle Geräte die richtigen Informationen zurückgegeben. Diese Methode basiert auf der Eigenschaft „gsm.version.baseband“, um die korrekten Versionsinformationen zurückzugeben.
Diese Angabe ist für einige CDMA-Geräte nicht korrekt und die hier zurückgegebene Version stimmt möglicherweise nicht mit der Version überein, die von Fastboot gemeldet wird. Außerdem wird möglicherweise nicht die Version für die CDMA-Funkschnittstelle zurückgegeben.
Kurz gesagt: Mit dieser Methode wird nur dann eine genaue Version zurückgegeben, wenn die Eigenschaft „gsm.version.baseband“ mit der von fastboot getvar version-baseband zurückgegebenen Version übereinstimmt.
| Gibt Folgendes zurück: | |
|---|---|
String |
die String-Baseband-Version oder null, wenn sie nicht ermittelt werden kann (Gerät hat kein Funkmodul oder der Versionsstring kann nicht gelesen werden) |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getBattery
public Integer getBattery ()
Gibt den aktuellen Akkustand eines Geräts zurück oder „Null“, wenn der Akkustand nicht verfügbar ist.
| Gibt Folgendes zurück: | |
|---|---|
Integer |
|
getBooleanProperty
public boolean getBooleanProperty (String name,
boolean defaultValue)Gibt den booleschen Wert der angegebenen Property zurück.
| Parameter | |
|---|---|
name |
String: der Property-Name |
defaultValue |
boolean: Standardwert, der zurückgegeben wird, wenn die Property leer ist oder nicht vorhanden ist. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Property den Wert "1", "y", "yes", "on" oder "true" hat, false, wenn die Property den Wert "0", "n", "no", "off", "false" oder defaultValue hat, andernfalls. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getBootHistory
public Map<Long, String> getBootHistory ()
Die Hilfsmethode erfasst die Bootverlaufskarte mit Bootzeit und Bootgrund.
| Gibt Folgendes zurück: | |
|---|---|
Map<Long, String> |
Zuordnung von Startzeit (UTC-Zeit in Sekunden seit der Epoche) und Startgrund |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getBootHistorySince
public Map<Long, String> getBootHistorySince (long utcEpochTime,
TimeUnit timeUnit)Die Hilfsmethode ruft die Karte mit dem Bootverlauf mit Bootzeit und Bootgrund seit der angegebenen Zeit seit der Epoche vom Gerät und der angegebenen Zeiteinheit ab. Die aktuelle utcEpochTime des Geräts in Millisekunden kann mit der Methode getDeviceDate() abgerufen werden.
| Parameter | |
|---|---|
utcEpochTime |
long: Die Gerätezeit seit der Epoche. |
timeUnit |
TimeUnit: die Zeiteinheit TimeUnit. |
| Gibt Folgendes zurück: | |
|---|---|
Map<Long, String> |
Zuordnung von Startzeit (UTC-Zeit in Sekunden seit der Epoche) und Startgrund |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getBootloaderVersion
public String getBootloaderVersion ()
Bequeme Methode zum Abrufen der Bootloader-Version dieses Geräts.
Es wird versucht, die Bootloader-Version aus dem aktuellen Status des Geräts abzurufen. Wenn sich das Gerät beispielsweise im Fastboot-Modus befindet, wird versucht, die Version über Fastboot abzurufen.
| Gibt Folgendes zurück: | |
|---|---|
String |
die String-Bootloader-Version oder null, wenn sie nicht gefunden werden kann |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
UnsupportedOperationException |
|
getBugreport
public InputStreamSource getBugreport ()
Ruft einen Fehlerbericht vom Gerät ab.
Die Implementierung dieser Funktion funktioniert garantiert auch auf Geräten ohne SD-Karte (oder wenn die SD-Karte noch nicht eingebunden ist).
| Gibt Folgendes zurück: | |
|---|---|
InputStreamSource |
Ein InputStreamSource, das die Inhalte des Fehlerberichts auf Anfrage generiert. Im Fehlerfall gibt InputStreamSource eine leere InputStream zurück. |
getBugreportz
public InputStreamSource getBugreportz ()
Ruft einen Fehlerbericht vom Gerät ab. Der Fehlerbericht im ZIP-Format enthält den Hauptfehlerbericht und andere Protokolldateien, die für die Fehlerbehebung nützlich sind.
Wird nur für „adb version“ > 1.0.36 unterstützt.
| Gibt Folgendes zurück: | |
|---|---|
InputStreamSource |
InputStreamSource der ZIP-Datei mit den Bugreportz. Bei einem Fehler wird „null“ zurückgegeben. |
getBuildAlias
public String getBuildAlias ()
Rufen Sie den Alias des Builds ab, der auf dem Gerät gerade ausgeführt wird.
Der Build-Alias ist in der Regel ein besser lesbarer String als die Build-ID (in der Regel eine Nummer für Nexus-Builds). Beispiel: Der finale Release von Android 4.2 hat den Build-Alias JDQ39 und die Build-ID 573038.
| Gibt Folgendes zurück: | |
|---|---|
String |
Der Build-Alias oder die Build-ID, falls der Alias nicht abgerufen werden konnte |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getBuildFlavor
public String getBuildFlavor ()
Ruft die Build-Variante für das Gerät ab.
| Gibt Folgendes zurück: | |
|---|---|
String |
die Build-Variante oder „null“, wenn sie nicht abgerufen werden konnte |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getBuildId
public String getBuildId ()
Ruft den Build ab, der derzeit auf dem Gerät ausgeführt wird.
| Gibt Folgendes zurück: | |
|---|---|
String |
Die Build-ID oder IBuildInfo.UNKNOWN_BUILD_ID, wenn sie nicht abgerufen werden konnte |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getBuildSigningKeys
public String getBuildSigningKeys ()
Gibt den Schlüsseltyp zurück, der zum Signieren des Geräte-Images verwendet wurde.
Android-Geräte werden in der Regel mit Testschlüsseln (wie in AOSP) oder Releaseschlüsseln (die von den einzelnen Geräteherstellern verwaltet werden) signiert.
| Gibt Folgendes zurück: | |
|---|---|
String |
Der Signaturschlüssel, falls gefunden, andernfalls „null“. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor ()
Gibt ein im Cache gespeichertes DeviceDescriptor zurück, wenn das Gerät zugewiesen ist. Andernfalls wird das aktuelle DeviceDescriptor zurückgegeben.
| Gibt Folgendes zurück: | |
|---|---|
DeviceDescriptor |
|
getCachedDeviceDescriptor
public DeviceDescriptor getCachedDeviceDescriptor (boolean shortDescriptor)
Gibt ein im Cache gespeichertes DeviceDescriptor zurück, wenn das Gerät zugewiesen ist. Andernfalls wird das aktuelle DeviceDescriptor zurückgegeben.
| Parameter | |
|---|---|
shortDescriptor |
boolean: Gibt an, ob der Deskriptor auf die Mindestinformationen beschränkt werden soll. |
| Gibt Folgendes zurück: | |
|---|---|
DeviceDescriptor |
|
getChildren
public String[] getChildren (String path)
Alternative zur Verwendung von IFileEntry, die manchmal aufgrund von Berechtigungen nicht funktioniert.
| Parameter | |
|---|---|
path |
String: der Pfad auf dem Gerät, in dem die Suche durchgeführt werden soll |
| Gibt Folgendes zurück: | |
|---|---|
String[] |
Array mit Strings, das alle Dateien in einem Pfad auf dem Gerät enthält. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getConnection
public AbstractConnection getConnection ()
Die aktuelle Verbindung des Geräts.
| Gibt Folgendes zurück: | |
|---|---|
AbstractConnection |
|
getContentProvider
public ContentProviderHandler getContentProvider (int userId)
Gibt ContentProviderHandler zurück oder „null“, falls nicht verfügbar.
Der Content-Anbieter kann wiederverwendet werden, wenn er zuvor mit demselben userId erstellt wurde.
| Parameter | |
|---|---|
userId |
int: Die Nutzer-ID, mit der der Inhaltsanbieter initialisiert werden soll. |
| Gibt Folgendes zurück: | |
|---|---|
ContentProviderHandler |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Gibt den aktuellen Status des faltbaren Geräts zurück oder „null“, wenn Probleme aufgetreten sind.
| Gibt Folgendes zurück: | |
|---|---|
DeviceFoldableState |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getCurrentUser
public int getCurrentUser ()
Gibt die ID des aktuell ausgeführten Nutzers zurück. Im Fehlerfall wird -10000 zurückgegeben.
| Gibt Folgendes zurück: | |
|---|---|
int |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getDeviceClass
public String getDeviceClass ()
Geräteklasse abrufen
| Gibt Folgendes zurück: | |
|---|---|
String |
die Geräteklasse String. |
getDeviceDate
public long getDeviceDate ()
Gibt das Datum des Geräts in Millisekunden seit der Epoche zurück.
| Gibt Folgendes zurück: | |
|---|---|
long |
Das Datum des Geräts im Epoch-Format. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor ()
Gibt ein DeviceDescriptor aus den Geräteinformationen zurück, um Informationen dazu abzurufen, ohne das tatsächliche Geräteobjekt zu übergeben.
| Gibt Folgendes zurück: | |
|---|---|
DeviceDescriptor |
|
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (boolean shortDescriptor)
Gibt ein DeviceDescriptor aus den Geräteinformationen zurück, um Informationen dazu abzurufen, ohne das tatsächliche Geräteobjekt zu übergeben.
| Parameter | |
|---|---|
shortDescriptor |
boolean: Gibt an, ob der Deskriptor auf die Mindestinformationen beschränkt werden soll. |
| Gibt Folgendes zurück: | |
|---|---|
DeviceDescriptor |
|
getDeviceState
public TestDeviceState getDeviceState ()
Gerätestatus abrufen
| Gibt Folgendes zurück: | |
|---|---|
TestDeviceState |
|
getDeviceTimeOffset
public long getDeviceTimeOffset (Date date)
Helper zum Abrufen der Zeitdifferenz zwischen dem Gerät und einem bestimmten Date. Verwenden Sie intern die Epoch-Zeit.
| Parameter | |
|---|---|
date |
Date |
| Gibt Folgendes zurück: | |
|---|---|
long |
die Differenz in Millisekunden |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getEmulatorOutput
public InputStreamSource getEmulatorOutput ()
Stream von Emulator-stdout und -stderr abrufen
| Gibt Folgendes zurück: | |
|---|---|
InputStreamSource |
Emulatorausgabe |
getEmulatorProcess
public Process getEmulatorProcess ()
Gibt die Process zurück, die diesem Emulator entspricht.
| Gibt Folgendes zurück: | |
|---|---|
Process |
Process oder null |
getExecuteShellCommandLog
public final File getExecuteShellCommandLog ()
Das Log, das alle executeShellCommand(String)-Logs enthält.
| Gibt Folgendes zurück: | |
|---|---|
File |
|
getExternalStoreFreeSpace
public long getExternalStoreFreeSpace ()
Hilfsmethode zum Ermitteln des freien Speicherplatzes auf dem externen Speicher des Geräts.
| Gibt Folgendes zurück: | |
|---|---|
long |
die Menge an freiem Speicherplatz in KB |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getFastbootPath
public String getFastbootPath ()
Gibt den Pfad der verwendeten Fastboot-Binärdatei zurück.
isFastbootEnabled() muss weiterhin „true“ sein, damit Fastboot-Funktionen aktiviert werden.
| Gibt Folgendes zurück: | |
|---|---|
String |
|
getFastbootProductType
public String getFastbootProductType ()
Bequeme Methode zum Abrufen des Produkttyps dieses Geräts im Fastboot-Modus.
Diese Methode sollte nur verwendet werden, wenn sich das Gerät im Fastboot-Modus befinden soll. Sie ist in diesem Fall etwas sicherer als die generische getProductType()-Methode, da ITestDevice weiß, wie das Gerät in den Fastboot-Modus versetzt wird, wenn es sich im falschen Status befindet oder nicht reagiert.
| Gibt Folgendes zurück: | |
|---|---|
String |
den Namen des Produkttyps String oder null, wenn er nicht ermittelt werden kann |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
UnsupportedOperationException |
|
getFastbootProductVariant
public String getFastbootProductVariant ()
Bequeme Methode zum Abrufen des Produkttyps dieses Geräts im Fastboot-Modus.
Diese Methode sollte nur verwendet werden, wenn sich das Gerät im Fastboot-Modus befinden soll. Sie ist in diesem Fall etwas sicherer als die generische getProductType()-Methode, da ITestDevice weiß, wie das Gerät in den Fastboot-Modus versetzt wird, wenn es sich im falschen Status befindet oder nicht reagiert.
| Gibt Folgendes zurück: | |
|---|---|
String |
den Namen des Produkttyps String oder null, wenn er nicht ermittelt werden kann |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
UnsupportedOperationException |
|
getFastbootSerialNumber
public String getFastbootSerialNumber ()
Gibt die Seriennummer im Fastboot-Modus zurück.
| Gibt Folgendes zurück: | |
|---|---|
String |
|
getFastbootVariable
public String getFastbootVariable (String variableName)
Ruft den angegebenen Fastboot-Variablenwert vom Gerät ab.
| Parameter | |
|---|---|
variableName |
String: der Variablenname |
| Gibt Folgendes zurück: | |
|---|---|
String |
Der Attributwert oder null, falls er nicht vorhanden ist. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
UnsupportedOperationException |
|
getFastbootVersion
public String getFastbootVersion ()
Gibt den Versionsstring der verwendeten Fastboot-Binärdatei zurück. Oder „null“, wenn etwas schiefgeht.
| Gibt Folgendes zurück: | |
|---|---|
String |
|
getFileEntry
public IFileEntry getFileEntry (String path)
Eine Referenz auf eine Remotedatei auf dem Gerät abrufen
| Parameter | |
|---|---|
path |
String: Der abzurufende Dateipfad. Kann ein absoluter Pfad oder ein Pfad relativ zu „/“ sein (d. h., sowohl „/system“ als auch „system“ werden unterstützt). |
| Gibt Folgendes zurück: | |
|---|---|
IFileEntry |
die IFileEntry oder null, wenn die Datei unter der angegebenen path nicht gefunden werden kann |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getFileEntry
public IFileEntry getFileEntry (FileListingService.FileEntry entry)
Inoffizieller Helfer zum Abrufen eines FileEntry aus einem nicht gerooteten Pfad. FIXME: Das FileEntry-System muss so umgestaltet werden, dass es von jedem Pfad aus verfügbar ist. (auch ohne Root-Zugriff).
| Parameter | |
|---|---|
entry |
FileListingService.FileEntry: Ein FileEntry, das nicht unbedingt das Root-Verzeichnis sein muss, wie es für Ddmlib erforderlich ist. |
| Gibt Folgendes zurück: | |
|---|---|
IFileEntry |
Ein FileEntryWrapper, der den FileEntry darstellt. |
| Löst aus | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
getFoldableStates
public Set<DeviceFoldableState> getFoldableStates ()
Gibt die Liste der faltbaren Status auf dem Gerät zurück. Kann mit „cmd device_state print-states“ abgerufen werden.
| Gibt Folgendes zurück: | |
|---|---|
Set<DeviceFoldableState> |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getIDevice
public IDevice getIDevice ()
Gibt einen Verweis auf die zugehörige ddmlib-IDevice zurück.
Jedes Mal, wenn die Verbindung des Geräts zu ADB getrennt und wiederhergestellt wird, kann von DDMS ein neuer IDevice zugewiesen werden. Aufrufer sollten daher keinen Verweis auf IDevice beibehalten, da dieser Verweis möglicherweise veraltet ist.
| Gibt Folgendes zurück: | |
|---|---|
IDevice |
die IDevice |
getInstalledPackageNames
public Set<String> getInstalledPackageNames ()
Die Paketnamen der auf dem Gerät vorhandenen Anwendungen abrufen.
| Gibt Folgendes zurück: | |
|---|---|
Set<String> |
Set von String Paketnamen, die derzeit auf dem Gerät installiert sind. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getIntProperty
public long getIntProperty (String name,
long defaultValue)Gibt den Ganzzahlwert der angegebenen Eigenschaft des Geräts zurück.
| Parameter | |
|---|---|
name |
String: der Property-Name |
defaultValue |
long: Standardwert, der zurückgegeben wird, wenn die Property leer ist oder nicht vorhanden ist. |
| Gibt Folgendes zurück: | |
|---|---|
long |
den Eigenschaftswert oder defaultValue, wenn die Eigenschaft leer ist, nicht vorhanden ist oder keinen Ganzzahlwert hat. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getIpAddress
public String getIpAddress ()
Ruft die IP-Adresse des Geräts ab.
| Gibt Folgendes zurück: | |
|---|---|
String |
Die IP-Adresse des Geräts oder null, wenn das Gerät keine IP-Adresse hat |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Gibt ein Objekt zurück, um den aktuellen Status des Keyguard zu erhalten, oder „null“, wenn dies nicht unterstützt wird.
| Gibt Folgendes zurück: | |
|---|---|
KeyguardControllerState |
ein KeyguardControllerState mit einem Snapshot des Status des Keyguard zurückgibt und Null zurückgibt, wenn die Keyguard-Abfrage nicht unterstützt wird. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getLastExpectedRebootTimeMillis
public long getLastExpectedRebootTimeMillis ()
Gibt die letzte Zeit zurück, zu der Tradefed-APIs einen Neustart ausgelöst haben, in Millisekunden seit EPOCH, wie von System.currentTimeMillis() zurückgegeben.
| Gibt Folgendes zurück: | |
|---|---|
long |
|
getLaunchApiLevel
public int getLaunchApiLevel ()
Ruft das API-Level des Geräts bei der ersten Markteinführung ab. Die Standardeinstellung ist UNKNOWN_API_LEVEL.
| Gibt Folgendes zurück: | |
|---|---|
int |
Eine Ganzzahl, die das erste gestartete API-Level des Geräts angibt |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getLogcat
public InputStreamSource getLogcat ()
Erstellt einen Snapshot-Stream der logcat-Daten.
Funktioniert in zwei Modi:
TestDeviceOptions.getMaxLogcatDataSize() Byte des aktuellen Inhalts des im Hintergrund ausgeführten Logcat-Vorgangs zurückgegeben.
| Gibt Folgendes zurück: | |
|---|---|
InputStreamSource |
|
getLogcat
public InputStreamSource getLogcat (int maxBytes)
Erstellt einen Snapshot-Stream der letzten maxBytes erfassten Logcat-Daten.
Nützlich, wenn Sie häufig Snapshots der erfassten logcat-Daten erstellen möchten, ohne den potenziell großen Speicherplatzbedarf des gesamten getLogcat()-Snapshots in Kauf zu nehmen.
| Parameter | |
|---|---|
maxBytes |
int: Die maximale Menge an zurückzugebenden Daten. Sollte eine Menge sein, die problemlos in den Speicher passt. |
| Gibt Folgendes zurück: | |
|---|---|
InputStreamSource |
|
getLogcatDump
public InputStreamSource getLogcatDump ()
Rufen Sie einen Dump des aktuellen Logcat für das Gerät ab. Im Gegensatz zu getLogcat() gibt diese Methode immer einen statischen Dump des Logcat zurück.
Hat den Nachteil, dass nichts zurückgegeben wird, wenn das Gerät nicht erreichbar ist.
| Gibt Folgendes zurück: | |
|---|---|
InputStreamSource |
InputStreamSource der Logcat-Daten. Wenn Logcat-Daten nicht erfasst werden können, wird ein leerer Stream zurückgegeben. |
getLogcatSince
public InputStreamSource getLogcatSince (long date)
Ruft einen Snapshot-Stream der erfassten logcat-Daten ab, beginnend mit dem angegebenen Datum. Die Zeit auf dem Gerät sollte getDeviceDate() verwendet werden.
| Parameter | |
|---|---|
date |
long: Im Format „Millisekunden seit Epoche“ für den Zeitraum, für den der Snapshot erstellt werden soll.
(kann mit „date +%s“ abgerufen werden) |
| Gibt Folgendes zurück: | |
|---|---|
InputStreamSource |
|
getMacAddress
public String getMacAddress ()
Gibt die MAC-Adresse des Geräts zurück. Wenn die Abfrage des Geräts fehlschlägt, wird „null“ zurückgegeben.
| Gibt Folgendes zurück: | |
|---|---|
String |
|
getMainUserId
public Integer getMainUserId ()
Gibt die Hauptnutzer-ID zurück.
| Gibt Folgendes zurück: | |
|---|---|
Integer |
Die userId des Hauptnutzers, falls vorhanden, andernfalls null. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getMainlineModuleInfo
public Set<String> getMainlineModuleInfo ()
Ruft Informationen zu den auf dem Gerät installierten Mainline-Modulen ab.
| Gibt Folgendes zurück: | |
|---|---|
Set<String> |
Set der String-Mainline-Module, die derzeit auf dem Gerät installiert sind. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getMaxNumberOfRunningUsersSupported
public int getMaxNumberOfRunningUsersSupported ()
Die maximale Anzahl der unterstützten gleichzeitig aktiven Nutzer abrufen. Die Standardeinstellung ist 0.
| Gibt Folgendes zurück: | |
|---|---|
int |
Eine Ganzzahl, die die Anzahl der gleichzeitig ausgeführten Nutzer angibt. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getMaxNumberOfUsersSupported
public int getMaxNumberOfUsersSupported (String userType)
Ruft die maximale Anzahl der unterstützten Nutzer des angegebenen Nutzertyps ab. Die Standardeinstellung ist 0.
| Parameter | |
|---|---|
userType |
String: Der Nutzertyp, wie in UserManager definiert, z. B. „android.os.usertype.full.SECONDARY“. |
| Gibt Folgendes zurück: | |
|---|---|
int |
Eine Ganzzahl, die die Anzahl der unterstützten Nutzer des angegebenen Nutzertyps angibt. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getMaxNumberOfUsersSupported
public int getMaxNumberOfUsersSupported ()
Ruft die maximale Anzahl der unterstützten wechselbaren Nutzer ab, ohne Gäste. Ab API-Version 36 sind nicht wechselbare Nutzer (z. B. Profile) nicht mehr enthalten. Die Standardeinstellung ist 0.
| Gibt Folgendes zurück: | |
|---|---|
int |
Eine Ganzzahl, die die Anzahl der unterstützten umschaltbaren Nutzer angibt |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getMicrodroidProcess
public Process getMicrodroidProcess ()
| Gibt Folgendes zurück: | |
|---|---|
Process |
Gibt den Prozess der Microdroid-VM zurück. Wenn TestDevice kein Microdroid ist, wird „null“ zurückgegeben. |
getMonitor
public IDeviceStateMonitor getMonitor ()
Gibt die mit dem Gerät verknüpfte IDeviceStateMonitor zurück.
| Gibt Folgendes zurück: | |
|---|---|
IDeviceStateMonitor |
|
getMountPoint
public String getMountPoint (String mountName)
Gibt einen Bereitstellungspunkt zurück.
Fragt das Gerät direkt ab, wenn die im Cache gespeicherten Informationen in IDevice nicht verfügbar sind.
AUFGABE: Dieses Verhalten zu IDevice.getMountPoint(String) verschieben
| Parameter | |
|---|---|
mountName |
String: der Name des Bereitstellungspunkts |
| Gibt Folgendes zurück: | |
|---|---|
String |
den Bereitstellungspunkt oder null |
getMountPointInfo
public ITestDevice.MountPointInfo getMountPointInfo (String mountpoint)
Gibt ein MountPointInfo zurück, das dem angegebenen Mountpoint-Pfad entspricht, oder null, wenn für diesen Pfad nichts gemountet ist oder er anderweitig nicht als Mountpoint in /proc/mounts angezeigt wird.
| Parameter | |
|---|---|
mountpoint |
String |
| Gibt Folgendes zurück: | |
|---|---|
ITestDevice.MountPointInfo |
Ein List von MountPointInfo mit den Informationen in „/proc/mounts“ |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getMountPointInfo
public List<ITestDevice.MountPointInfo> getMountPointInfo ()
Gibt eine geparste Version der Informationen in /proc/mounts auf dem Gerät zurück.
| Gibt Folgendes zurück: | |
|---|---|
List<ITestDevice.MountPointInfo> |
Ein List von MountPointInfo mit den Informationen in „/proc/mounts“ |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getOptions
public TestDeviceOptions getOptions ()
Ruft die Testoptionen für das Gerät ab.
| Gibt Folgendes zurück: | |
|---|---|
TestDeviceOptions |
TestDeviceOptions im Zusammenhang mit dem zu testenden Gerät. |
getPartitionFreeSpace
public long getPartitionFreeSpace (String partition)
Hilfsmethode zum Ermitteln des freien Speicherplatzes auf der Gerätepartition.
| Parameter | |
|---|---|
partition |
String |
| Gibt Folgendes zurück: | |
|---|---|
long |
die Menge an freiem Speicherplatz in KB |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getPrimaryUserId
public Integer getPrimaryUserId ()
Gibt die Hauptnutzer-ID zurück.
| Gibt Folgendes zurück: | |
|---|---|
Integer |
Die userId des Hauptnutzers, falls vorhanden, andernfalls „null“. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getProcessByName
public ProcessInfo getProcessByName (String processName)
Die Hilfsmethode führt die Befehle „pidof“ und „stat“ aus und gibt das ProcessInfo-Objekt mit der PID und der Startzeit des angegebenen Prozesses zurück.
| Parameter | |
|---|---|
processName |
String: Der Prozessname als String. |
| Gibt Folgendes zurück: | |
|---|---|
ProcessInfo |
ProcessInfo des angegebenen processName |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getProcessPid
public String getProcessPid (String process)
Gibt die PID des Dienstes zurück oder „null“, wenn ein Fehler aufgetreten ist.
| Parameter | |
|---|---|
process |
String: Der Prozessname als String. |
| Gibt Folgendes zurück: | |
|---|---|
String |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getProductType
public String getProductType ()
Bequeme Methode zum Abrufen des Produkttyps dieses Geräts.
Diese Methode funktioniert, wenn sich das Gerät im ADB- oder Fastboot-Modus befindet.
| Gibt Folgendes zurück: | |
|---|---|
String |
Der Name des String-Produkttyps. Darf nicht null sein |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getProductVariant
public String getProductVariant ()
Bequeme Methode zum Abrufen der Produktvariante dieses Geräts.
Diese Methode funktioniert, wenn sich das Gerät im ADB- oder Fastboot-Modus befindet.
| Gibt Folgendes zurück: | |
|---|---|
String |
den Namen der Produktvariante String oder null, wenn er nicht ermittelt werden kann |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getProperty
public String getProperty (String name)
Ruft den angegebenen Attributwert vom Gerät ab.
| Parameter | |
|---|---|
name |
String: der Property-Name |
| Gibt Folgendes zurück: | |
|---|---|
String |
Der Attributwert oder null, falls er nicht vorhanden ist. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getRecoveryMode
public ITestDevice.RecoveryMode getRecoveryMode ()
Ruft den aktuellen Wiederherstellungsmodus ab, der für das Gerät verwendet wird.
| Gibt Folgendes zurück: | |
|---|---|
ITestDevice.RecoveryMode |
Der aktuelle Wiederherstellungsmodus, der für das Gerät verwendet wird. |
getRemainingCreatableUserCount
public int getRemainingCreatableUserCount (String userType)
Gibt zurück, wie viele Nutzer des angegebenen Nutzertyps auf diesem Gerät erstellt werden können.
| Parameter | |
|---|---|
userType |
String: Der Nutzertyp, wie in UserManager definiert, z. B. „android.os.usertype.full.SECONDARY“. |
| Gibt Folgendes zurück: | |
|---|---|
int |
wie viele Nutzer des angegebenen Nutzertyps hinzugefügt werden können |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getScreenshot
public InputStreamSource getScreenshot (Long displayId, String format, boolean rescale)
Erstellt einen Screenshot des Displays mit der angegebenen ID im unterstützten Format. Reskalierung zulassen, um kleinere Größen zu unterstützen
| Parameter | |
|---|---|
displayId |
Long: Die Anzeige-ID des Bildschirms, von dem ein Screenshot erstellt werden soll. |
format |
String: Unterstützte PNG- und JPEG-Dateien |
rescale |
boolean: Gibt an, ob der Screenshot skaliert werden soll, um die Größe des resultierenden Bildes zu verringern. |
| Gibt Folgendes zurück: | |
|---|---|
InputStreamSource |
InputStreamSource des Screenshots im Format oder null, wenn der Screenshot nicht erfolgreich war. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getScreenshot
public InputStreamSource getScreenshot (String format)
Erstellt einen Screenshot vom Gerät. Es wird empfohlen, stattdessen „getScreenshot(format)“ mit JPEG-Codierung zu verwenden, um die Größe zu verringern.
| Parameter | |
|---|---|
format |
String: Unterstützte PNG- und JPEG-Dateien |
| Gibt Folgendes zurück: | |
|---|---|
InputStreamSource |
InputStreamSource des Screenshots im Format oder null, wenn der Screenshot nicht erfolgreich war. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Erstellt einen Screenshot des Geräts mit der angegebenen Anzeige-ID. Das Format ist PNG.
AUFGABE: Die Implementierungen oben müssen erweitert werden, um „format“ und „rescale“ zu unterstützen.
| Parameter | |
|---|---|
displayId |
long: Die Anzeige-ID des Bildschirms, von dem ein Screenshot erstellt werden soll. |
| Gibt Folgendes zurück: | |
|---|---|
InputStreamSource |
InputStreamSource des Screenshots im Format oder null, wenn der Screenshot nicht erfolgreich war. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getScreenshot
public InputStreamSource getScreenshot (String format, boolean rescale)
Erstellt einen Screenshot vom Gerät. Wir empfehlen, stattdessen getScreenshot(String) mit JPEG-Codierung zu verwenden, um die Größe zu verringern.
| Parameter | |
|---|---|
format |
String: Unterstützte PNG- und JPEG-Dateien |
rescale |
boolean: Gibt an, ob der Screenshot skaliert werden soll, um die Größe des resultierenden Bildes zu verringern. |
| Gibt Folgendes zurück: | |
|---|---|
InputStreamSource |
InputStreamSource des Screenshots im Format oder null, wenn der Screenshot nicht erfolgreich war. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getScreenshot
public InputStreamSource getScreenshot ()
Erstellt einen Screenshot vom Gerät.
| Gibt Folgendes zurück: | |
|---|---|
InputStreamSource |
InputStreamSource des Screenshots im PNG-Format oder null, wenn der Screenshot nicht erfolgreich war. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getSerialNumber
public String getSerialNumber ()
Bequeme Methode zum Abrufen der Seriennummer dieses Geräts.
| Gibt Folgendes zurück: | |
|---|---|
String |
die Seriennummer String |
getSetting
public String getSetting (int userId,
String namespace,
String key)Gibt den Wert der angeforderten Einstellung zurück. Der Namespace muss einer der folgenden Werte sein: {"system", "secure", "global"}
| Parameter | |
|---|---|
userId |
int |
namespace |
String |
key |
String |
| Gibt Folgendes zurück: | |
|---|---|
String |
Der Wert, der mit dem Namespace:Schlüssel eines Nutzers verknüpft ist. Null, wenn nicht gefunden. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getSetting
public String getSetting (String namespace,
String key)Weitere Informationen finden Sie unter getSetting(int,String,String).
| Parameter | |
|---|---|
namespace |
String |
key |
String |
| Gibt Folgendes zurück: | |
|---|---|
String |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getSimOperator
public String getSimOperator ()
Gibt den SIM-Kartenbetreiber zurück oder „null“, wenn er nicht verfügbar ist oder das Gerät nicht verfügbar ist.
| Gibt Folgendes zurück: | |
|---|---|
String |
|
getSimState
public String getSimState ()
Gibt den SIM-Kartenstatus zurück oder „null“, wenn er nicht verfügbar ist oder das Gerät nicht verfügbar ist.
| Gibt Folgendes zurück: | |
|---|---|
String |
|
getTombstones
public List<File> getTombstones ()
Die Liste der Tombstones von den Geräten abrufen und zurückgeben. Erfordert Root-Zugriff.
Die Methode ist „Best Effort“. Wenn also ein Tombstone aus irgendeinem Grund nicht abgerufen werden kann, fehlt er in der Liste. Nur ein DeviceNotAvailableException beendet die Methode vorzeitig.
| Gibt Folgendes zurück: | |
|---|---|
List<File> |
Eine Liste von Tombstone-Dateien, leer, wenn kein Tombstone vorhanden ist. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getTotalMemory
public long getTotalMemory ()
Gibt die Gesamtgröße des physischen Speichers in Byte zurück oder -1 im Falle eines internen Fehlers.
| Gibt Folgendes zurück: | |
|---|---|
long |
|
getTrackingSerial
public String getTrackingSerial ()
Rufen Sie die Seriennummer ab, die zum Verfolgen des Geräts verwendet wird.
| Gibt Folgendes zurück: | |
|---|---|
String |
|
getUninstallablePackageNames
public Set<String> getUninstallablePackageNames ()
Ruft die Paketnamen der Anwendungen ab, die deinstalliert werden können. Derzeit sind das Nicht-Systempakete und aktualisierte Systempakete.
| Gibt Folgendes zurück: | |
|---|---|
Set<String> |
Set der nicht deinstallierbaren String-Paketnamen, die derzeit auf dem Gerät installiert sind. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getUseFastbootErase
public boolean getUseFastbootErase ()
Gibt an, ob zum Löschen einer Partition auf dem Gerät „fastboot erase“ oder „fastboot format“ verwendet werden soll.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn „fastboot erase“ verwendet wird, oder false, wenn „fastboot format“ verwendet wird. |
getUserFlags
public int getUserFlags (int userId)
Sucht nach den Markierungen eines bestimmten Nutzers und gibt sie zurück. Flags werden in der Klasse „android.content.pm.UserInfo“ im Open-Source-Projekt für Android definiert.
| Parameter | |
|---|---|
userId |
int |
| Gibt Folgendes zurück: | |
|---|---|
int |
Die mit der angegebenen userId verknüpften Flags, falls vorhanden, andernfalls -10000. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getUserInfos
public Map<Integer, UserInfo> getUserInfos ()
Ruft die Zuordnung von useId zu UserInfo auf dem Gerät ab. Löst DeviceRuntimeException aus, wenn die Ausgabe des Geräts nicht wie erwartet ist.
| Gibt Folgendes zurück: | |
|---|---|
Map<Integer, UserInfo> |
Die Liste der UserInfo-Objekte. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getUserSerialNumber
public int getUserSerialNumber (int userId)
Gibt die dem userId zugeordnete Seriennummer zurück, falls gefunden, andernfalls -10000.
| Parameter | |
|---|---|
userId |
int |
| Gibt Folgendes zurück: | |
|---|---|
int |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
getUserVisibleOnDisplay
public int getUserVisibleOnDisplay (int displayId)
Ruft die Nutzer-ID des sichtbaren Nutzers auf dem angegebenen Display ab.
| Parameter | |
|---|---|
displayId |
int: Die ID des Displays. |
| Gibt Folgendes zurück: | |
|---|---|
int |
Die Nutzer-ID des sichtbaren Nutzers auf dem angegebenen Display. Es wird nicht zwischen einem sichtbaren Hintergrundnutzer und dem aktuellen Vordergrundnutzer unterschieden, da beide Arten sichtbar sind. Um die beiden Ergebnisse zu unterscheiden, vergleichen Sie sie mit dem Ergebnis von getCurrentUser(). |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
handleAllocationEvent
public IManagedTestDevice.DeviceEventResponse handleAllocationEvent (DeviceEvent event)
Verarbeite das angegebene DeviceEvent. Gerät kann in einen neuen Status übergehen. Informiert die IDeviceMonitor über alle Zustandsübergänge.
Verarbeite das DeviceEvent, wodurch dieses Gerät möglicherweise in einen neuen Zuweisungsstatus übergeht.
| Parameter | |
|---|---|
event |
DeviceEvent |
| Gibt Folgendes zurück: | |
|---|---|
IManagedTestDevice.DeviceEventResponse |
|
hasFeature
public boolean hasFeature (String feature)
Prüfen, ob eine Funktion auf einem Gerät verfügbar ist
| Parameter | |
|---|---|
feature |
String: Das Format sollte „feature: |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn das Feature gefunden wird, andernfalls „false“. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
initializeConnection
public void initializeConnection (IBuildInfo info, MultiMap<String, String> attributes)
Stellen Sie die Verbindung zum Gerät her. Diese Methode wird von „preInvocationSetup“ aufgerufen, muss aber in seltenen Fällen möglicherweise separat aufgerufen werden, wenn die Verbindung während der Geräteeinrichtung erstellt wird.
| Parameter | |
|---|---|
info |
IBuildInfo |
attributes |
MultiMap |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|
installPackage
public String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)Installieren Sie ein Android-Paket auf dem Gerät.
Hinweis: Diese Funktion sollte nur für Anwendungsfälle aufgerufen werden, die eine explizite Steuerung der Erteilung der Laufzeitberechtigung bei der Installation erfordern.
| Parameter | |
|---|---|
packageFile |
File: die zu installierende APK-Datei |
reinstall |
boolean: true, wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions |
boolean: Gibt an, ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen. |
extraArgs |
String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“. |
| Gibt Folgendes zurück: | |
|---|---|
String |
String mit einem Fehlercode oder null bei Erfolg. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
installPackage
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)Installieren Sie ein Android-Paket auf dem Gerät.
| Parameter | |
|---|---|
packageFile |
File: die zu installierende APK-Datei |
reinstall |
boolean: true, wenn eine Neuinstallation durchgeführt werden soll |
extraArgs |
String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“. |
| Gibt Folgendes zurück: | |
|---|---|
String |
String mit einem Fehlercode oder null bei Erfolg. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)Installiert ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.
Hinweis: Diese Funktion sollte nur für Anwendungsfälle aufgerufen werden, die eine explizite Steuerung der Erteilung der Laufzeitberechtigung bei der Installation erfordern.
| Parameter | |
|---|---|
packageFile |
File: die zu installierende APK-Datei |
reinstall |
boolean: true, wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions |
boolean: Gibt an, ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen. |
userId |
int: Die Nutzer-ID als Ganzzahl, für die die Installation erfolgen soll. |
extraArgs |
String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“. |
| Gibt Folgendes zurück: | |
|---|---|
String |
String mit einem Fehlercode oder null bei Erfolg. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)Installiert ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.
| Parameter | |
|---|---|
packageFile |
File: die zu installierende APK-Datei |
reinstall |
boolean: true, wenn eine Neuinstallation durchgeführt werden soll |
userId |
int: Die Nutzer-ID als Ganzzahl, für die die Installation erfolgen soll. |
extraArgs |
String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“. |
| Gibt Folgendes zurück: | |
|---|---|
String |
String mit einem Fehlercode oder null bei Erfolg. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
installPackageWithIncrementalMode
public boolean installPackageWithIncrementalMode (File[] apkFiles,
String[] extraArgs,
String userId)Installiert APKs im inkrementellen Modus.
| Parameter | |
|---|---|
apkFiles |
File: die zu installierenden APK-Dateien. |
extraArgs |
String |
userId |
String |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
invalidatePropertyCache
public void invalidatePropertyCache ()
isAdbRoot
public boolean isAdbRoot ()
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isAdbTcp
public boolean isAdbTcp ()
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Prüfen, ob die Plattform auf dem Gerät die App-Aufzählung unterstützt
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn die App-Aufzählung unterstützt wird, andernfalls „false“ |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isBypassLowTargetSdkBlockSupported
public boolean isBypassLowTargetSdkBlockSupported ()
Prüfen, ob die Plattform auf dem Gerät das Umgehen der Blockierung aufgrund des niedrigen Ziel-SDK bei der App-Installation unterstützt
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn das Umgehen des Blocks für niedrige Ziel-SDKs unterstützt wird, andernfalls „False“. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isDebugfsMounted
public boolean isDebugfsMounted ()
Prüfen Sie, ob „debugfs“ gemountet ist.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn debugfs bereitgestellt ist |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isDeviceEncrypted
public boolean isDeviceEncrypted ()
Gibt zurück, ob das Gerät verschlüsselt ist.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn das Gerät verschlüsselt ist. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isDirectory
public boolean isDirectory (String path)
Gibt „True“ zurück, wenn der Pfad auf dem Gerät ein Verzeichnis ist, andernfalls „False“.
| Parameter | |
|---|---|
path |
String |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isEnableAdbRoot
public boolean isEnableAdbRoot ()
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn „adb root“ auf dem Gerät aktiviert werden soll |
isEncryptionSupported
public boolean isEncryptionSupported ()
Gibt zurück, ob die Verschlüsselung auf dem Gerät unterstützt wird.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn das Gerät die Verschlüsselung unterstützt. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isExecutable
public boolean isExecutable (String fullPath)
Gibt „True“ zurück, wenn der Dateipfad auf dem Gerät eine ausführbare Datei ist, andernfalls „False“.
| Parameter | |
|---|---|
fullPath |
String |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isFastbootEnabled
public boolean isFastbootEnabled ()
Gibt zurück, ob Fastboot für das Gerät verfügbar ist.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
isHeadless
public boolean isHeadless ()
Gibt „true“ zurück, wenn das Gerät headless ist (kein Bildschirm), andernfalls „false“.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Gibt zurück, ob auf dem Gerät der monitorlose Systemnutzermodus verwendet wird.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Gibt zurück, ob der Hauptnutzer ein permanenter Administrator ist und nicht gelöscht oder auf den Status „Nicht-Administrator“ herabgestuft werden kann.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isMultiUserSupported
public boolean isMultiUserSupported ()
Gibt zurück, ob dieses Gerät mehrere umschaltbare Nutzer mit eigenem Login und anpassbarem Bereich unterstützt.
Auch wenn die Antwort „Falsch“ lautet, können mehrere Nutzer möglicherweise trotzdem möglich sein, sofern keine Anmelde-UI erforderlich ist. Profile werden beispielsweise möglicherweise weiterhin unterstützt, da sie keine Anmelde-UI erfordern.
Außerdem wird „config_enableMultiUserUI“ geprüft. Auf Anfrage dürfen wir davon ausgehen, dass Geräte, für die dies zutrifft, so konfiguriert sind, dass sekundäre Nutzer über ADB hinzugefügt werden können.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
Gibt an, ob das Gerät mehrere umschaltbare Nutzer unterstützt. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isPackageInstalled
public boolean isPackageInstalled (String packageName,
String userId)Fragen Sie das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID ab, um zu prüfen, ob die App für diesen Nutzer derzeit installiert ist.
| Parameter | |
|---|---|
packageName |
String: Das Paket, für das wir prüfen, ob es installiert ist. |
userId |
String: Die Nutzer-ID, für die wir prüfen, ob das Paket installiert ist. Wenn „null“, wird der Hauptnutzer 0 verwendet. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn das Paket als installiert gemeldet wird. Andernfalls „Falsch”. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isPackageInstalled
public boolean isPackageInstalled (String packageName)
Fragen Sie das Gerät nach einem bestimmten Paketnamen, um zu prüfen, ob das Paket derzeit installiert ist.
| Parameter | |
|---|---|
packageName |
String |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn das Paket als installiert gemeldet wird. Andernfalls „Falsch”. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isRuntimePermissionSupported
public boolean isRuntimePermissionSupported ()
Prüfen, ob die Plattform auf dem Gerät die Erteilung von Laufzeitberechtigungen unterstützt
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn Laufzeitberechtigungen unterstützt werden, andernfalls „false“. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isShellV2Support
public boolean isShellV2Support ()
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isStateBootloaderOrFastbootd
public boolean isStateBootloaderOrFastbootd ()
Gibt „true“ zurück, wenn sich das Gerät in TestDeviceState.FASTBOOT oder TestDeviceState.FASTBOOTD befindet.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
isUserRunning
public boolean isUserRunning (int userId)
Prüfen, ob ein bestimmter Nutzer aktiv ist.
| Parameter | |
|---|---|
userId |
int |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn der Nutzer läuft, andernfalls „False“. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isUserSecondary
public boolean isUserSecondary (int userId)
Gibt zurück, ob der angegebene Nutzer anhand seiner Flags ein sekundärer Nutzer ist.
| Parameter | |
|---|---|
userId |
int |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„true“, wenn der Nutzer sekundär ist, andernfalls „false“. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isUserVisible
public boolean isUserVisible (int userId)
Prüft, ob der angegebene Nutzer sichtbar ist.
Ein „sichtbarer“ Nutzer ist ein Nutzer, der mit dem „menschlichen“ Nutzer interagiert und daher Launch-Aktivitäten (in der Regel auf dem Standarddisplay) starten kann.
| Parameter | |
|---|---|
userId |
int |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)Prüft, ob der angegebene Nutzer auf dem angegebenen Display sichtbar ist.
Ein „sichtbarer“ Nutzer ist ein Nutzer, der mit dem „menschlichen“ Nutzer interagiert und daher Aktivitäten auf diesem Display starten kann.
| Parameter | |
|---|---|
userId |
int |
displayId |
int |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isVisibleBackgroundUsersOnDefaultDisplaySupported
public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()
Gibt zurück, ob Nutzer im Hintergrund in ERROR(/java.android.view.Display#DEFAULT_DISPLAY) sichtbar sein dürfen.
Wenn das der Fall ist, können Sie startVisibleBackgroundUser(int, int, boolean) aufrufen und ein von listDisplayIdsForStartingVisibleBackgroundUsers() zurückgegebenes Display übergeben, das ERROR(/java.android.view.Display#DEFAULT_DISPLAY) enthalten sollte.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isVisibleBackgroundUsersSupported
public boolean isVisibleBackgroundUsersSupported ()
Gibt zurück, ob Nutzer im Hintergrund sichtbar sein dürfen.
Wenn dies der Fall ist, können Sie startVisibleBackgroundUser(int, int, boolean) aufrufen und ein von listDisplayIdsForStartingVisibleBackgroundUsers() zurückgegebenes Display übergeben.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
isWifiEnabled
public boolean isWifiEnabled ()
Prüfen, ob WLAN aktiviert ist.
Prüft, ob WLAN auf dem Gerät aktiviert ist. Nützlich, um den WLAN-Status vor Tests zu bestätigen, die nicht mit WLAN ausgeführt werden sollten, z.B. Tests für mobile Daten.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn WLAN aktiviert ist. false, falls deaktiviert |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
listDisplayIds
public Set<Long> listDisplayIds ()
Erfassen Sie die Liste der verfügbaren Display-IDs auf dem Gerät, wie von „dumpsys SurfaceFlinger“ gemeldet.
| Gibt Folgendes zurück: | |
|---|---|
Set<Long> |
Die Liste der Displays. „Default“ gibt immer die Standardanzeige 0 zurück. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
listDisplayIdsForStartingVisibleBackgroundUsers
public Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()
Ruft die Liste der Displays ab, die für start a user visible in the background verwendet werden können.
| Gibt Folgendes zurück: | |
|---|---|
Set<Integer> |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
listUsers
public ArrayList<Integer> listUsers ()
Ruft die Liste der Nutzer auf dem Gerät ab. Löst DeviceRuntimeException aus, wenn die Ausgabe des Geräts nicht wie erwartet ist.
| Gibt Folgendes zurück: | |
|---|---|
ArrayList<Integer> |
Die Liste der Nutzer-IDs. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
logAnrs
public boolean logAnrs (ITestLogger logger)
Erfasst und protokolliert ANR-Fehler vom Gerät.
| Parameter | |
|---|---|
logger |
ITestLogger: ein ITestLogger zum Protokollieren der ANR-Fehler. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn die Protokollierung erfolgreich war, andernfalls „false“. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
logBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)Helper-Methode zum Erstellen eines Fehlerberichts und zum Protokollieren des Berichts für die Reporter.
| Parameter | |
|---|---|
dataName |
String: Der Name, unter dem der Fehlerbericht gemeldet wird. |
listener |
ITestLogger: eine ITestLogger zum Protokollieren des Fehlerberichts. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn die Protokollierung erfolgreich war, andernfalls „false“. |
logOnDevice
public void logOnDevice (String tag,
Log.LogLevel level,
String format,
Object... args)Eine Nachricht im Logcat des Geräts protokollieren. Dies ist ein sicherer Aufruf, der auch dann keine Ausnahme auslöst, wenn die Protokollierung fehlschlägt.
| Parameter | |
|---|---|
tag |
String: Das Tag, unter dem wir unsere Nachricht im Logcat protokollieren. |
level |
Log.LogLevel: Die Debugging-Ebene der Nachricht im Logcat. |
format |
String: Das Nachrichtenformat. |
args |
Object: Die Argumente, die über String.format() ersetzt werden sollen. |
mountDebugfs
public void mountDebugfs ()
debugfs bereitstellen.
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
nonBlockingReboot
public void nonBlockingReboot ()
Gibt einen Befehl zum Neustarten des Geräts aus und kehrt zurück, wenn der Befehl abgeschlossen ist und das Gerät für ADB nicht mehr sichtbar ist.
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
postAdbRootAction
public void postAdbRootAction ()
Überschreiben, wenn auf dem Gerät nach dem Ausführen von „adb root“ und bevor das Gerät wieder online ist, bestimmte Aktionen ausgeführt werden müssen. Die Standardimplementierung umfasst keine zusätzlichen Aktionen. Es ist nicht garantiert, dass „adb root“ in dieser Phase aktiviert ist.
| Löst aus | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
postAdbUnrootAction
public void postAdbUnrootAction ()
Überschreiben, wenn auf dem Gerät nach dem Aufheben des Rootings über ADB und vor dem erneuten Onlinegehen des Geräts bestimmte Aktionen ausgeführt werden müssen. Die Standardimplementierung umfasst keine zusätzlichen Aktionen. Es ist nicht garantiert, dass „adb root“ in dieser Phase deaktiviert wird.
| Löst aus | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
postBootSetup
public void postBootSetup ()
Führen Sie die Anleitung aus, um das Gerät nach jedem Booten für Tests zu konfigurieren.
Sollte aufgerufen werden, nachdem das Gerät vollständig hochgefahren wurde
Unter normalen Umständen muss diese Methode nicht explizit aufgerufen werden, da Implementierungen diese Schritte beim Neustart automatisch ausführen sollten.
Der Aufruf ist möglicherweise erforderlich, wenn das Gerät aufgrund anderer Ereignisse neu gestartet wird, z. B. wenn ein Fastboot-Updatebefehl abgeschlossen wurde.
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach dem Aufruf ausgeführt werden.
| Parameter | |
|---|---|
exception |
Throwable: Falls vorhanden, die endgültige Ausnahme, die durch den Aufruffehler ausgelöst wurde. |
preInvocationSetup
public void preInvocationSetup (IBuildInfo info, MultiMap<String, String> attributes)
Zusätzliche Schritte für die gerätespezifische Einrichtung, die auf dem Gerät vor dem Aufruf ausgeführt werden.
| Parameter | |
|---|---|
info |
IBuildInfo: Die IBuildInfo des Geräts. |
attributes |
MultiMap: Die im Aufrufkontext gespeicherten Attribute |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
TargetSetupError |
|
pullDir
public boolean pullDir (String deviceFilePath,
File localDir,
int userId)Verzeichnisinhalte rekursiv vom Gerät abrufen.
| Parameter | |
|---|---|
deviceFilePath |
String: der absolute Dateipfad der Remote-Quelle |
localDir |
File: das lokale Verzeichnis, in das Dateien kopiert werden sollen |
userId |
int: die Nutzer-ID, aus der die Daten abgerufen werden sollen |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Datei erfolgreich abgerufen wurde. Andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
pullDir
public boolean pullDir (String deviceFilePath,
File localDir)Verzeichnisinhalte rekursiv vom Gerät abrufen.
| Parameter | |
|---|---|
deviceFilePath |
String: der absolute Dateipfad der Remote-Quelle |
localDir |
File: das lokale Verzeichnis, in das Dateien kopiert werden sollen |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Datei erfolgreich abgerufen wurde. Andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
pullDir
public boolean pullDir (String deviceFilePath,
File localDir,
int userId,
long timeout)Verzeichnisinhalte rekursiv vom Gerät abrufen.
| Parameter | |
|---|---|
deviceFilePath |
String: der absolute Dateipfad der Remote-Quelle |
localDir |
File: das lokale Verzeichnis, in das Dateien kopiert werden sollen |
userId |
int: die Nutzer-ID, aus der die Daten abgerufen werden sollen |
timeout |
long: das Zeitlimit für das Abrufen des Befehls |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Datei erfolgreich abgerufen wurde. Andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
pullFile
public boolean pullFile (String remoteFilePath,
File localFile,
int userId,
long timeout)Ruft eine Datei vom Gerät ab.
| Parameter | |
|---|---|
remoteFilePath |
String: Der absolute Pfad zur Datei auf dem Gerät. |
localFile |
File: die lokale Datei, in der Inhalte gespeichert werden sollen. Wenn sie nicht leer ist, wird der Inhalt ersetzt. |
userId |
int: Die Nutzer-ID, aus der Daten abgerufen werden sollen |
timeout |
long: Zeitüberschreitung beim Befehl zum Abrufen von Dateien |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Datei abgerufen wurde. Andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
pullFile
public boolean pullFile (String remoteFilePath,
File localFile)Ruft eine Datei vom Gerät ab.
| Parameter | |
|---|---|
remoteFilePath |
String: Der absolute Pfad zur Datei auf dem Gerät. |
localFile |
File: die lokale Datei, in der Inhalte gespeichert werden sollen. Wenn nicht leer, wird der Inhalt ersetzt. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Datei abgerufen wurde. Andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
pullFile
public File pullFile (String remoteFilePath,
int userId)Ruft eine Datei vom Gerät ab, speichert sie in einem lokalen temporären File und gibt diesen File zurück.
| Parameter | |
|---|---|
remoteFilePath |
String: Der absolute Pfad zur Datei auf dem Gerät. |
userId |
int: Die Nutzer-ID, aus der Daten abgerufen werden sollen |
| Gibt Folgendes zurück: | |
|---|---|
File |
Eine File mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem) |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
pullFile
public File pullFile (String remoteFilePath)
Ruft eine Datei vom Gerät ab, speichert sie in einem lokalen temporären File und gibt diesen File zurück.
| Parameter | |
|---|---|
remoteFilePath |
String: Der absolute Pfad zur Datei auf dem Gerät. |
| Gibt Folgendes zurück: | |
|---|---|
File |
Eine File mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem) |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
pullFile
public boolean pullFile (String remoteFilePath,
File localFile,
int userId)Ruft eine Datei vom Gerät ab.
| Parameter | |
|---|---|
remoteFilePath |
String: Der absolute Pfad zur Datei auf dem Gerät. |
localFile |
File: die lokale Datei, in der Inhalte gespeichert werden sollen. Wenn sie nicht leer ist, wird der Inhalt ersetzt. |
userId |
int: Die Nutzer-ID, aus der Daten abgerufen werden sollen |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Datei abgerufen wurde. Andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
pullFileContents
public String pullFileContents (String remoteFilePath)
Ruft eine Datei vom Gerät ab und gibt den Inhalt zurück.
| Parameter | |
|---|---|
remoteFilePath |
String: Der absolute Pfad zur Datei auf dem Gerät. |
| Gibt Folgendes zurück: | |
|---|---|
String |
Eine String mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem) |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
pullFileFromExternal
public File pullFileFromExternal (String remoteFilePath)
Eine Hilfsmethode zum Abrufen einer Datei aus dem externen Speicher des Geräts, die sie in einem lokalen temporären File speichert und eine Referenz auf dieses File zurückgibt.
| Parameter | |
|---|---|
remoteFilePath |
String: der Pfad zur Datei auf dem Gerät, relativ zum Mountpoint des externen Speichers des Geräts |
| Gibt Folgendes zurück: | |
|---|---|
File |
Eine File mit dem Inhalt der Gerätedatei oder null, wenn das Kopieren aus irgendeinem Grund fehlgeschlagen ist (einschließlich Problemen mit dem Hostdateisystem) |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
pushDir
public boolean pushDir (File localFileDir,
String deviceFilePath,
int userId)Verzeichnisinhalte rekursiv auf das Gerät übertragen.
| Parameter | |
|---|---|
localFileDir |
File: das lokale Verzeichnis, das übertragen werden soll |
deviceFilePath |
String: der absolute Dateipfad des Remote-Ziels |
userId |
int: Die Nutzer-ID, an die die Push-Benachrichtigung gesendet werden soll |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Datei erfolgreich übertragen wurde. Andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
pushDir
public boolean pushDir (File localFileDir,
String deviceFilePath,
Set<String> excludedDirectories)Verzeichnisinhalte rekursiv auf das Gerät übertragen, wobei einige gefilterte Verzeichnisse ausgeschlossen werden.
| Parameter | |
|---|---|
localFileDir |
File: das lokale Verzeichnis, das übertragen werden soll |
deviceFilePath |
String: der absolute Dateipfad des Remote-Ziels |
excludedDirectories |
Set: Eine Reihe von ausgeschlossenen Verzeichnisnamen, die nicht übertragen werden sollen. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Datei erfolgreich übertragen wurde. Andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
pushDir
public boolean pushDir (File localFileDir,
String deviceFilePath)Verzeichnisinhalte rekursiv auf das Gerät übertragen.
| Parameter | |
|---|---|
localFileDir |
File: das lokale Verzeichnis, das übertragen werden soll |
deviceFilePath |
String: der absolute Dateipfad des Remote-Ziels |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Datei erfolgreich übertragen wurde. Andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
pushFile
public boolean pushFile (File localFile,
String remoteFilePath,
boolean evaluateContentProviderNeeded)Variante von pushFile(File,String), bei der optional die Notwendigkeit für den Content-Anbieter berücksichtigt werden kann.
| Parameter | |
|---|---|
localFile |
File: die lokale Datei, die übertragen werden soll |
remoteFilePath |
String: der absolute Dateipfad des Remote-Ziels |
evaluateContentProviderNeeded |
boolean: Gibt an, ob geprüft werden soll, ob der Content-Anbieter benötigt wird. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Datei erfolgreich übertragen wurde. Andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
pushFile
public boolean pushFile (File localFile,
String remoteFilePath)Eine Datei auf ein Gerät übertragen Standardmäßig wird ein Contentanbieter verwendet.
| Parameter | |
|---|---|
localFile |
File: die lokale Datei, die übertragen werden soll |
remoteFilePath |
String: der absolute Dateipfad des Remote-Ziels |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Datei erfolgreich übertragen wurde. Andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
pushFile
public boolean pushFile (File localFile,
String remoteFilePath,
int userId)Eine Datei auf ein Gerät übertragen Standardmäßig wird ein Contentanbieter verwendet.
| Parameter | |
|---|---|
localFile |
File: die lokale Datei, die übertragen werden soll |
remoteFilePath |
String: der absolute Dateipfad des Remote-Ziels |
userId |
int: die Nutzer-ID, an die die Push-Benachrichtigung gesendet werden soll |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Datei erfolgreich übertragen wurde. Andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
pushString
public boolean pushString (String contents,
String remoteFilePath)Aus einem String erstellte Datei an ein Gerät senden
| Parameter | |
|---|---|
contents |
String: der Inhalt der zu übertragenden Datei |
remoteFilePath |
String: der absolute Dateipfad des Remote-Ziels |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn der String erfolgreich übertragen wurde. Andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
neu starten
public void reboot (String reason)
Startet das Gerät im ADB-Modus neu. Der angegebene reason wird beim Neustart beibehalten.
Blockiert, bis das Gerät verfügbar ist.
Der Grund für den letzten Neustart kann durch Abfragen des Attributs sys.boot.reason abgerufen werden.
| Parameter | |
|---|---|
reason |
String: Ein Grund für diesen Neustart oder null, wenn kein Grund angegeben ist. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
neu starten
public String reboot (String command,
String reason)Startet das Gerät mit dem angegebenen command neu.
Blockiert, bis das Gerät verfügbar ist.
Der Grund für den letzten Neustart kann durch Abfragen des Attributs sys.boot.reason abgerufen werden.
| Parameter | |
|---|---|
command |
String: Befehl, der an „adb“ übergeben wird. Er wird unverändert übergeben. Der Aufrufer muss also bei Bedarf die richtigen Anführungszeichen angeben, insbesondere wenn er mehrere durch Leerzeichen getrennte Teile enthält. |
reason |
String: Ein Grund für diesen Neustart oder null, wenn kein Grund angegeben ist. |
| Gibt Folgendes zurück: | |
|---|---|
String |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
neu starten
public void reboot ()
Startet das Gerät im ADB-Modus neu.
Blockiert, bis das Gerät verfügbar ist.
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
rebootIntoBootloader
public void rebootIntoBootloader ()
Das Gerät wird im Bootloader-Modus neu gestartet.
Blockiert, bis sich das Gerät im Bootloader-Modus befindet.
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
UnsupportedOperationException |
|
rebootIntoFastbootd
public void rebootIntoFastbootd ()
Das Gerät wird im fastbootd-Modus neu gestartet.
Wird blockiert, bis sich das Gerät im fastbootd-Modus befindet.
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
UnsupportedOperationException |
|
rebootIntoRecovery
public void rebootIntoRecovery ()
Das Gerät wird im ADB-Wiederherstellungsmodus neu gestartet.
Blöcke, bis das Gerät in den Wiederherstellungsmodus wechselt
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
rebootIntoSideload
public void rebootIntoSideload ()
Das Gerät wird im ADB-Sideload-Modus neu gestartet. Das ist ein spezieller Modus unter „Recovery“.
Wird blockiert, bis das Gerät in den Sideload-Modus wechselt
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
rebootIntoSideload
public void rebootIntoSideload (boolean autoReboot)
Das Gerät wird im ADB-Sideload-Modus neu gestartet. Das ist ein spezieller Modus unter „Recovery“.
Wird blockiert, bis das Gerät in den Sideload-Modus wechselt
| Parameter | |
|---|---|
autoReboot |
boolean: Gibt an, ob das Gerät nach dem Sideload automatisch neu gestartet werden soll. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
rebootUntilOnline
public void rebootUntilOnline ()
Eine Alternative zu reboot(), die nur blockiert, bis das Gerät online ist, d. h. für adb sichtbar ist.
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
rebootUntilOnline
public void rebootUntilOnline (String reason)
Eine Alternative zu reboot(), die nur blockiert, bis das Gerät online ist, d. h. für adb sichtbar ist.
| Parameter | |
|---|---|
reason |
String: Ein Grund für diesen Neustart oder null, wenn kein Grund angegeben ist. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
rebootUserspace
public void rebootUserspace ()
Startet nur den Userspace-Teil des Geräts neu.
Blockiert, bis das Gerät verfügbar ist.
ACHTUNG: Der Neustart im Userspace befindet sich derzeit in der aktiven Entwicklung. Die Nutzung erfolgt auf eigenes Risiko.
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
rebootUserspaceUntilOnline
public void rebootUserspaceUntilOnline ()
Eine Alternative zu rebootUserspace() ()}, die nur blockiert, bis das Gerät online ist, d. h. für adb sichtbar ist.
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
recoverDevice
public boolean recoverDevice ()
Es wird versucht, die Gerätekommunikation wiederherzustellen.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn die Wiederherstellung versucht und erfolgreich war. „False“, wenn die Wiederherstellung übersprungen wurde. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
Wenn das Gerät nicht mehr verfügbar ist |
registerDeviceActionReceiver
public void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Registriert ein IDeviceActionReceiver für dieses Gerät.
Alle registrierten IDeviceActionReceiver werden vor Beginn und nach Ende einer Geräteaktion benachrichtigt.
| Parameter | |
|---|---|
deviceActionReceiver |
IDeviceActionReceiver: Eine IDeviceActionReceiver, die registriert wird. |
remountSystemReadOnly
public void remountSystemReadOnly ()
Die Systempartition auf dem Gerät schreibgeschützt machen. Möglicherweise muss das Gerät neu gestartet werden.
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
remountSystemWritable
public void remountSystemWritable ()
Machen Sie die Systempartition auf dem Gerät beschreibbar. Möglicherweise muss das Gerät neu gestartet werden.
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
remountVendorReadOnly
public void remountVendorReadOnly ()
Machen Sie die Anbieterpartition auf dem Gerät schreibgeschützt. Möglicherweise muss das Gerät neu gestartet werden.
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
remountVendorWritable
public void remountVendorWritable ()
Machen Sie die Anbieterpartition auf dem Gerät beschreibbar. Möglicherweise muss das Gerät neu gestartet werden.
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
removeAdmin
public boolean removeAdmin (String componentName,
int userId)Entfernt den angegebenen Geräteadministrator für den angegebenen Nutzer und gibt true zurück, wenn der Vorgang erfolgreich war, andernfalls false.
| Parameter | |
|---|---|
componentName |
String: des zu entfernenden Geräteadministrators. |
userId |
int: des Nutzers, in dem sich der Geräteadministrator befindet. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn erfolgreich, andernfalls „false“. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
removeOwners
public void removeOwners ()
Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen.
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
removeUser
public boolean removeUser (int userId)
Einen bestimmten Nutzer vom Gerät entfernen.
| Parameter | |
|---|---|
userId |
int: des zu entfernenden Nutzers |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„true“, wenn der Nutzer erfolgreich entfernt wurde, andernfalls „false“. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
resetContentProviderSetup
public void resetContentProviderSetup ()
Setzen Sie das Flag für die Einrichtung des Content-Anbieters zurück, um es noch einmal auszulösen.
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, Collection<ITestLifeCycleReceiver> listeners)
Führt Instrumentierungstests aus und bietet die Möglichkeit zur Geräte-Wiederherstellung.
Wenn die Verbindung zum Gerät vor Abschluss des Testlaufs unterbrochen wird und die Wiederherstellung erfolgreich ist, werden alle Listener über „testRunFailed“ informiert und „false“ wird zurückgegeben. Der Testbefehl wird nicht noch einmal ausgeführt. Es liegt an den Anrufern, es bei Bedarf noch einmal zu versuchen.
Wenn die Verbindung zum Gerät verloren geht, bevor der Testlauf abgeschlossen ist, und die Wiederherstellung fehlschlägt, werden alle Listener über „testRunFailed“ informiert und „DeviceNotAvailableException“ wird ausgelöst.
| Parameter | |
|---|---|
runner |
IRemoteAndroidTestRunner: die IRemoteAndroidTestRunner, die die Tests ausführt |
listeners |
Collection: die Listener für Testergebnisse |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn der Testbefehl abgeschlossen ist. false, wenn der Vorgang aufgrund einer Ausnahme bei der Gerätekommunikation nicht abgeschlossen werden konnte, die Wiederherstellung aber erfolgreich war |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
runInstrumentationTests
public boolean runInstrumentationTests (IRemoteAndroidTestRunner runner, ITestLifeCycleReceiver... listeners)
Bequeme Methode zum Ausführen von runInstrumentationTests(IRemoteAndroidTestRunner,Collection) mit einem oder mehreren Listenern, die als Parameter übergeben werden.
| Parameter | |
|---|---|
runner |
IRemoteAndroidTestRunner: die IRemoteAndroidTestRunner, die die Tests ausführt |
listeners |
ITestLifeCycleReceiver: die Listener für Testergebnisse |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn der Testbefehl abgeschlossen ist. false, wenn der Vorgang nicht abgeschlossen werden konnte, aber die Wiederherstellung erfolgreich war |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, Collection<ITestLifeCycleReceiver> listeners)
Wie ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,Collection), führt den Test jedoch für den angegebenen Nutzer aus.
| Parameter | |
|---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
Collection |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
runInstrumentationTestsAsUser
public boolean runInstrumentationTestsAsUser (IRemoteAndroidTestRunner runner, int userId, ITestLifeCycleReceiver... listeners)
Wie ITestDevice.runInstrumentationTests(IRemoteAndroidTestRunner,ITestLifeCycleReceiver...), führt den Test jedoch für einen bestimmten Nutzer aus.
| Parameter | |
|---|---|
runner |
IRemoteAndroidTestRunner |
userId |
int |
listeners |
ITestLifeCycleReceiver |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
setAdbPath
public void setAdbPath (String adbPath)
Legt den Pfad zum zu verwendenden ADB-Binärprogramm fest.
| Parameter | |
|---|---|
adbPath |
String |
setConfiguration
public void setConfiguration (IConfiguration configuration)
Fügt die verwendete IConfiguration ein.
| Parameter | |
|---|---|
configuration |
IConfiguration |
setConnectionAvdInfo
public final void setConnectionAvdInfo (GceAvdInfo avdInfo)
| Parameter | |
|---|---|
avdInfo |
GceAvdInfo |
setDate
public void setDate (Date date)
Legt das Datum auf dem Gerät fest
Hinweis: Das Festlegen des Datums auf dem Gerät erfordert Root-Zugriff.
| Parameter | |
|---|---|
date |
Date: gibt ein bestimmtes Datum an; verwendet das Hostdatum, wenn null |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)Legt eine Geräteadministrator-Komponente als Geräteinhaber für einen bestimmten Nutzer fest.
| Parameter | |
|---|---|
componentName |
String: des Geräteadministrators zum Geräteinhaber. |
userId |
int: des Nutzers, in dem der Geräteinhaber lebt. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn erfolgreich, andernfalls „false“. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
setDeviceState
public void setDeviceState (TestDeviceState deviceState)
Aktualisieren Sie den Gerätestatus.
| Parameter | |
|---|---|
deviceState |
TestDeviceState: Der TestDeviceState |
setEmulatorOutputStream
public void setEmulatorOutputStream (SizeLimitedOutputStream output)
Für den Emulator legen Sie SizeLimitedOutputStream auf die Logausgabe fest.
| Parameter | |
|---|---|
output |
SizeLimitedOutputStream: zum Protokollieren der Ausgabe |
setEmulatorProcess
public void setEmulatorProcess (Process p)
Legt Process fest, wenn dieses Gerät ein Emulator ist.
| Parameter | |
|---|---|
p |
Process |
setFastbootEnabled
public void setFastbootEnabled (boolean fastbootEnabled)
Legen Sie die Fastboot-Option für das Gerät fest. Sollte festgelegt werden, wenn das Gerät zum ersten Mal zugewiesen wird.
| Parameter | |
|---|---|
fastbootEnabled |
boolean: Gibt an, ob Fastboot für das Gerät verfügbar ist oder nicht. |
setFastbootPath
public void setFastbootPath (String fastbootPath)
Legt den Pfad zum zu verwendenden Fastboot-Binärprogramm fest.
isFastbootEnabled() muss weiterhin „true“ sein, damit Fastboot-Funktionen aktiviert werden.
| Parameter | |
|---|---|
fastbootPath |
String |
setIDevice
public void setIDevice (IDevice newDevice)
Aktualisieren Sie das IDevice, das mit diesem ITestDevice verknüpft ist.
Das neue IDevice muss sich auf dasselbe physische Gerät wie die aktuelle Referenz beziehen. Diese Methode wird aufgerufen, wenn DDMS ein neues IDevice zugewiesen hat.
| Parameter | |
|---|---|
newDevice |
IDevice: Der IDevice |
setLogStartDelay
public void setLogStartDelay (int delay)
Legt die Zeit in Millisekunden fest, die gewartet werden soll, bevor die Logcat-Erfassung für ein Onlinegerät gestartet wird.
| Parameter | |
|---|---|
delay |
int: die Verzögerung in Millisekunden |
setOptions
public void setOptions (TestDeviceOptions options)
TestDeviceOptions für das Gerät festlegen
| Parameter | |
|---|---|
options |
TestDeviceOptions |
setProperty
public boolean setProperty (String propKey,
String propValue)Legt den angegebenen Eigenschaftswert auf dem Gerät fest. Erfordert, dass „adb root“ auf „true“ gesetzt ist.
| Parameter | |
|---|---|
propKey |
String: Der Schlüssel, der festgelegt werden soll. |
propValue |
String: Der festzulegende Property-Wert. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
Gibt True zurück, wenn der Befehl „setprop“ erfolgreich war, andernfalls „False“. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
setRecovery
public void setRecovery (IDeviceRecovery recovery)
Legen Sie die IDeviceRecovery fest, die für dieses Gerät verwendet werden soll. Sollte festgelegt werden, wenn das Gerät zum ersten Mal zugewiesen wird.
| Parameter | |
|---|---|
recovery |
IDeviceRecovery: Der IDeviceRecovery |
setRecoveryMode
public void setRecoveryMode (ITestDevice.RecoveryMode mode)
Legt den aktuellen Wiederherstellungsmodus fest, der für das Gerät verwendet werden soll.
Wird verwendet, um zu steuern, welche Wiederherstellungsmethode verwendet werden soll, wenn ein Problem bei der Gerätekommunikation auftritt. Wir empfehlen, diese Methode nur sparsam zu verwenden, wenn sie erforderlich ist (z. B. wenn das Framework nicht funktioniert).
| Parameter | |
|---|---|
mode |
ITestDevice.RecoveryMode: Gibt an, ob der Modus „Nur bis zur Onlineverfügbarkeit wiederherstellen“ aktiviert sein soll. |
setSetting
public void setSetting (String namespace,
String key,
String value)Weitere Informationen finden Sie unter setSetting(int,String,String,String).
| Parameter | |
|---|---|
namespace |
String |
key |
String |
value |
String |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
setSetting
public void setSetting (int userId,
String namespace,
String key,
String value)Fügen Sie dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzu. Einige Einstellungen sind erst nach einem Neustart verfügbar. Der Namespace muss einer der folgenden Werte sein: {"system", "secure", "global"}
| Parameter | |
|---|---|
userId |
int |
namespace |
String |
key |
String |
value |
String |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
setTestLogger
public void setTestLogger (ITestLogger testLogger)
Fügt die ITestLogger-Instanz ein.
| Parameter | |
|---|---|
testLogger |
ITestLogger |
setTrackingSerial
public void setTrackingSerial (String trackingSerial)
Zur Geräteverwaltung wird die Seriennummer erfasst, die wir zur Referenzierung des Geräts verwenden.
| Parameter | |
|---|---|
trackingSerial |
String |
setUseFastbootErase
public void setUseFastbootErase (boolean useFastbootErase)
Legen Sie fest, ob zum Löschen einer Partition auf dem Gerät „fastboot erase“ oder „fastboot format“ verwendet werden soll.
| Parameter | |
|---|---|
useFastbootErase |
boolean: true, wenn „fastboot erase“ verwendet werden soll, oder false, wenn „fastboot format“ verwendet werden soll. |
startLogcat
public void startLogcat ()
Logcat-Ausgabe vom Gerät im Hintergrund erfassen.
Hat keine Auswirkungen, wenn die logcat-Ausgabe bereits erfasst wird. Daten können später über „getLogcat“ abgerufen werden.
Wenn das Gerät nicht mehr verwendet wird, muss stopLogcat() aufgerufen werden.
startLogcat() und stopLogcat() müssen normalerweise nicht aufgerufen werden, wenn sie sich in einem TF-Aufrufkontext befinden, da das TF-Framework logcat startet und beendet.
startTradeInModeTesting
public boolean startTradeInModeTesting (int timeoutMs)
Aktivieren Sie den Testmodus für die Inzahlungnahme. Das Gerät wird zurückgesetzt und neu gestartet.
| Parameter | |
|---|---|
timeoutMs |
int |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn erfolgreich, andernfalls „false“ |
| Löst aus | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
startUser
public boolean startUser (int userId)
Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist. Wenn der Nutzer bereits im Hintergrund ausgeführt wird, ist diese Methode ein NOOP.
| Parameter | |
|---|---|
userId |
int: des Nutzers, der im Hintergrund gestartet werden soll |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„true“, wenn der Nutzer erfolgreich im Hintergrund gestartet wurde. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
startUser
public boolean startUser (int userId,
boolean waitFlag)Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist. Wenn der Nutzer bereits im Hintergrund ausgeführt wird, ist diese Methode ein NOOP. Es ist möglich, ein zusätzliches Flag anzugeben, um zu warten, bis der Vorgang wirksam wird.
| Parameter | |
|---|---|
userId |
int: des Nutzers, der im Hintergrund gestartet werden soll |
waitFlag |
boolean: Der Befehl wird erst ausgeführt, wenn der Nutzer gestartet und entsperrt wurde. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„true“, wenn der Nutzer erfolgreich im Hintergrund gestartet wurde. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)Startet einen bestimmten Nutzer im Hintergrund, der auf dem angegebenen Display sichtbar ist (d.h. der Nutzer kann Aktivitäten auf diesem Display starten).
HINWEIS : Mit diesem Befehl wird nicht geprüft, ob der Nutzer vorhanden ist, ob die Anzeige verfügbar ist, ob device supports such feature usw.
| Parameter | |
|---|---|
userId |
int: des Nutzers, der im Hintergrund gestartet werden soll |
displayId |
int: Display, auf dem der Nutzer die Anzeige sehen soll |
waitFlag |
boolean: Der Befehl wird erst ausgeführt, wenn der Nutzer gestartet und entsperrt wurde. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn der Nutzer sichtbar im Hintergrund gestartet wurde. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
stopEmulatorOutput
public void stopEmulatorOutput ()
Schließen Sie die Emulatorausgabe und löschen Sie sie.
stopLogcat
public void stopLogcat ()
Die Erfassung der Logcat-Ausgabe vom Gerät wird beendet und die aktuell gespeicherten Logcat-Daten werden verworfen.
Hat keine Auswirkungen, wenn keine logcat-Ausgabe erfasst wird.
stopTradeInModeTesting
public void stopTradeInModeTesting ()
Test des Trade-In-Modus beenden
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
stopUser
public boolean stopUser (int userId)
Stoppt einen bestimmten Nutzer. Wenn der Nutzer bereits angehalten wurde, ist diese Methode ein NOOP. Der aktuelle Nutzer und der Systemnutzer können nicht beendet werden.
| Parameter | |
|---|---|
userId |
int: des Nutzers, der gestoppt werden soll. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„true“, wenn der Nutzer erfolgreich gestoppt wurde. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
stopUser
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)Einen bestimmten Nutzer stoppen. Es ist möglich, zusätzliche Flags anzugeben, um zu warten, bis der Vorgang wirksam wird, und den Nutzer zu beenden. Der aktuelle Nutzer und der Systemnutzer können nicht beendet werden.
| Parameter | |
|---|---|
userId |
int: des Nutzers, der gestoppt werden soll. |
waitFlag |
boolean: Der Befehl wartet, bis der Nutzer gestoppt wird. |
forceFlag |
boolean: Der Nutzer wird zum Beenden gezwungen. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„true“, wenn der Nutzer erfolgreich gestoppt wurde. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
switchToAdbTcp
public String switchToAdbTcp ()
Gerät in den ADB-over-TCP-Modus versetzen.
| Gibt Folgendes zurück: | |
|---|---|
String |
Die TCP-Seriennummer oder null, wenn das Gerät nicht umgeschaltet werden konnte |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
switchToAdbUsb
public boolean switchToAdbUsb ()
Schalten Sie das Gerät in den ADB-over-USB-Modus.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn der Wechsel erfolgreich war, andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
switchUser
public boolean switchUser (int userId)
Wechseln Sie mit einem Standard-Timeout zu einer anderen userId. switchUser(int, long).
| Parameter | |
|---|---|
userId |
int |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn die neue User-ID mit dem User-ID-Anbieter übereinstimmt. Andernfalls „Falsch”. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
switchUser
public boolean switchUser (int userId,
long timeout)Wechseln Sie mit dem angegebenen Zeitlimit zu einer anderen userId. Versuche, die Keyguard-Sperre zu deaktivieren, nachdem der Nutzerwechsel erfolgreich war.
| Parameter | |
|---|---|
userId |
int |
timeout |
long: Die Wartezeit, bevor „false“ für „switch-user failed“ zurückgegeben wird. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn die neue User-ID mit dem User-ID-Anbieter übereinstimmt. Andernfalls „Falsch”. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
syncFiles
public boolean syncFiles (File localFileDir,
String deviceFilePath)Synchronisiert den Inhalt eines lokalen Dateiverzeichnisses inkrementell mit dem Gerät.
Entscheidet, welche Dateien übertragen werden sollen, indem Zeitstempel lokaler Dateien mit ihren Remote-Entsprechungen verglichen werden. Nur „neuere“ oder nicht vorhandene Dateien werden auf das Gerät übertragen. Der Aufwand sollte also relativ gering sein, wenn der Dateisatz auf dem Gerät bereits auf dem neuesten Stand ist.
Ausgeblendete Dateien (deren Namen mit „.“ beginnen) werden ignoriert.
Beispiel für die Verwendung: Mit syncFiles("/tmp/files", "/sdcard") wird das Verzeichnis „/sdcard/files“ erstellt, falls es noch nicht vorhanden ist, und der Inhalt von „/tmp/files“ wird rekursiv in „/sdcard/files“ übertragen.
| Parameter | |
|---|---|
localFileDir |
File: Das lokale Dateiverzeichnis, das rekursiv zu übertragende Dateien enthält. |
deviceFilePath |
String: der absolute Dateipfad-Root des Remote-Ziels. Alle Verzeichnisse in diesem Dateipfad müssen lesbar sein. Das Pushen nach /data/local/tmp schlägt fehl, wenn ADB nicht als Root ausgeführt wird. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn Dateien erfolgreich synchronisiert wurden. Andernfalls false. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
takeBugreport
public Bugreport takeBugreport ()
Nimmt einen Fehlerbericht entgegen und gibt ihn in einem Bugreport-Objekt zurück, um ihn zu verarbeiten. Gibt bei Problemen „null“ zurück. Auf Dateien, auf die im Bugreport-Objekt verwiesen wird, muss über Bugreport.close() zugegriffen werden.
| Gibt Folgendes zurück: | |
|---|---|
Bugreport |
|
uninstallPackage
public String uninstallPackage (String packageName)
Ein Android-Paket vom Gerät deinstallieren.
| Parameter | |
|---|---|
packageName |
String: das Android-Paket, das deinstalliert werden soll |
| Gibt Folgendes zurück: | |
|---|---|
String |
String mit einem Fehlercode oder null bei Erfolg. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
uninstallPackageForUser
public String uninstallPackageForUser (String packageName,
int userId)Deinstalliert ein Android-Paket für einen bestimmten Nutzer von einem Gerät.
| Parameter | |
|---|---|
packageName |
String: das Android-Paket, das deinstalliert werden soll |
userId |
int: Die Nutzer-ID als Ganzzahl, für die die Deinstallation erfolgen soll. |
| Gibt Folgendes zurück: | |
|---|---|
String |
String mit einem Fehlercode oder null bei Erfolg. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
unlockDevice
public boolean unlockDevice ()
Entsperrt das Gerät, wenn es verschlüsselt ist.
Diese Methode kann das Framework neu starten, ruft jedoch nichtpostBootSetup() auf. Daher ist das Gerät möglicherweise noch nicht vollständig für Tests bereit, wenn diese Methode zurückgegeben wird.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn der Vorgang erfolgreich war oder das Gerät nicht verschlüsselt ist. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
UnsupportedOperationException |
|
waitForBootComplete
public boolean waitForBootComplete (long timeOut)
Blockiert, bis das Boot-Complete-Flag des Geräts gesetzt ist.
| Parameter | |
|---|---|
timeOut |
long: Zeit in Millisekunden, die gewartet wird, bis das Flag gesetzt wird |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„true“, wenn das Flag „boot_complete“ des Geräts innerhalb des Zeitlimits gesetzt ist |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceAvailable
public boolean waitForDeviceAvailable ()
Wartet, bis das Gerät reagiert und für Tests verfügbar ist. Standard-Zeitlimit wird verwendet.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn das Gerät verfügbar ist, „False“, wenn die Wiederherstellung deaktiviert und nicht verfügbar ist. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceAvailable
public boolean waitForDeviceAvailable (long waitTime)
Wartet, bis das Gerät reagiert und für Tests verfügbar ist.
| Parameter | |
|---|---|
waitTime |
long: die Wartezeit in Millisekunden |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn das Gerät verfügbar ist, „False“, wenn die Wiederherstellung deaktiviert und nicht verfügbar ist. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceAvailableInRecoverPath
public boolean waitForDeviceAvailableInRecoverPath (long waitTime)
Wartet, bis das Gerät reagiert und verfügbar ist, ohne den Wiederherstellungspfad zu berücksichtigen.
| Parameter | |
|---|---|
waitTime |
long |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn das Gerät verfügbar ist, „False“, wenn es nicht verfügbar ist. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceBootloader
public void waitForDeviceBootloader ()
Wird blockiert, bis das Gerät über Fastboot sichtbar ist. Standard-Zeitlimit verwenden
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceInRecovery
public boolean waitForDeviceInRecovery (long waitTime)
Sperrt das Gerät, wenn es sich im Status „adb recovery“ befindet. Dieser Status unterscheidet sich von IDeviceRecovery.
| Parameter | |
|---|---|
waitTime |
long: die Wartezeit in Millisekunden |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn das Gerät vor Ablauf der Zeit in den Wiederherstellungsmodus bootet.
Andernfalls false |
waitForDeviceInSideload
public boolean waitForDeviceInSideload (long waitTime)
Blockiert, dass sich das Gerät im Status „adb sideload“ befindet
| Parameter | |
|---|---|
waitTime |
long: die Wartezeit in Millisekunden |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn das Gerät vor Ablauf der Zeit im Sideload-Modus startet. Andernfalls false
|
waitForDeviceNotAvailable
public boolean waitForDeviceNotAvailable (long waitTime)
Blockiert, dass das Gerät nicht verfügbar ist, d. h. in ADB fehlt.
| Parameter | |
|---|---|
waitTime |
long: die Wartezeit in Millisekunden |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn das Gerät vor Ablauf der Zeit nicht mehr verfügbar ist.
Andernfalls false |
waitForDeviceOnline
public void waitForDeviceOnline ()
Wird blockiert, bis das Gerät über ADB sichtbar ist. Standard-Zeitlimit wird verwendet
Das Gerät reagiert nach Abschluss möglicherweise nicht auf Befehle. Verwenden Sie stattdessen waitForDeviceAvailable().
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceOnline
public void waitForDeviceOnline (long waitTime)
Wird blockiert, bis das Gerät über ADB sichtbar ist.
Das Gerät reagiert nach Abschluss möglicherweise nicht auf Befehle. Verwenden Sie stattdessen waitForDeviceAvailable().
| Parameter | |
|---|---|
waitTime |
long: die Wartezeit in Millisekunden |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
waitForDeviceShell
public boolean waitForDeviceShell (long waitTime)
Wartet, bis das Gerät auf einen einfachen ADB-Shell-Befehl reagiert.
| Parameter | |
|---|---|
waitTime |
long: die Wartezeit in Millisekunden |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn das Gerät reagiert, bevor waitTime abgelaufen ist. |
Geschützte Methoden
addExtraConnectionBuilderArgs
protected void addExtraConnectionBuilderArgs (DefaultConnection.ConnectionBuilder builder)
| Parameter | |
|---|---|
builder |
DefaultConnection.ConnectionBuilder |
buildAdbShellCommand
protected String[] buildAdbShellCommand (String command,
boolean forceExitStatusDetection,
boolean oldShellCommand)Erstellt den Betriebssystembefehl für die angegebene adb-Shell-Befehlssitzung und die Argumente.
| Parameter | |
|---|---|
command |
String |
forceExitStatusDetection |
boolean |
oldShellCommand |
boolean |
| Gibt Folgendes zurück: | |
|---|---|
String[] |
|
checkApiLevelAgainst
protected void checkApiLevelAgainst (String feature,
int strictMinLevel)| Parameter | |
|---|---|
feature |
String |
strictMinLevel |
int |
createRebootDeviceAction
protected NativeDevice.RebootDeviceAction createRebootDeviceAction (NativeDevice.RebootMode rebootMode, String reason)
Erstellt ein RebootDeviceAction, das beim Ausführen einer Neustartaktion verwendet werden soll.
| Parameter | |
|---|---|
rebootMode |
NativeDevice.RebootMode: Ein Modus dieses Neustarts. |
reason |
String: für diesen Neustart. |
| Gibt Folgendes zurück: | |
|---|---|
NativeDevice.RebootDeviceAction |
den erstellten RebootDeviceAction. |
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode, String reason)
Führen Sie einen ADB-Neustart durch.
| Parameter | |
|---|---|
rebootMode |
NativeDevice.RebootMode: Ein Modus dieses Neustarts. |
reason |
String: für diesen Neustart. |
| Löst aus | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
ensureRuntimePermissionSupported
protected void ensureRuntimePermissionSupported ()
Hilfsmethode zum Auslösen einer Ausnahme, wenn die Laufzeitberechtigung nicht unterstützt wird
| Löst aus | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
getApiLevelSafe
protected int getApiLevelSafe ()
| Gibt Folgendes zurück: | |
|---|---|
int |
|
getRunUtil
protected IRunUtil getRunUtil ()
Rufen Sie die zu verwendende RunUtil-Instanz ab.
| Gibt Folgendes zurück: | |
|---|---|
IRunUtil |
|
internalGetProperty
protected String internalGetProperty (String propName,
String fastbootVar,
String description)Ruft eine Geräte-Property ab, standardmäßig aus dem ddmlib-Cache, und greift entweder auf „adb shell getprop“ oder „fastboot getvar“ zurück, je nachdem, ob sich das Gerät im Fastboot-Modus befindet oder nicht.
| Parameter | |
|---|---|
propName |
String: Der Name der Geräte-Property, wie von „adb shell getprop“ zurückgegeben. |
fastbootVar |
String: Der Name der entsprechenden Fastboot-Variablen, die abgefragt werden soll. Wenn null, wird kein Fastboot-Befehl ausgeführt. |
description |
String: Eine einfache Beschreibung der Variablen. Der erste Buchstabe sollte großgeschrieben werden. |
| Gibt Folgendes zurück: | |
|---|---|
String |
Ein String, der möglicherweise null oder leer ist und den Wert der angegebenen Property enthält. |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
UnsupportedOperationException |
|
isInRebootCallback
protected boolean isInRebootCallback ()
Gibt zurück, ob Rückrufe für Neustarts gerade ausgeführt werden. Alle öffentlichen APIs für den Neustart sollten deaktiviert werden, wenn „true“ festgelegt ist.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
isNewer
protected boolean isNewer (File localFile,
IFileEntry entry)Gibt true zurück, wenn die lokale Datei neuer als die Remotedatei ist. IFileEntry ist auf die Minute genau. Bei gleichen Zeiten wird die Datei als neuer betrachtet.
| Parameter | |
|---|---|
localFile |
File |
entry |
IFileEntry |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
notifyRebootEnded
protected void notifyRebootEnded ()
Benachrichtigt alle IDeviceActionReceiver über das Ende des Neustarts.
| Löst aus | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
notifyRebootStarted
protected void notifyRebootStarted ()
Benachrichtigt alle IDeviceActionReceiver über das Ereignis zum Start des Neustarts.
| Löst aus | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
performDeviceAction
protected boolean performDeviceAction (String actionDescription,
NativeDevice.DeviceAction action,
int retryAttempts)Führt eine Aktion auf diesem Gerät aus. Es wird versucht, das Gerät wiederherzustellen und den Befehl optional noch einmal auszuführen, wenn die Aktion fehlschlägt.
| Parameter | |
|---|---|
actionDescription |
String: Eine kurze Beschreibung der auszuführenden Aktion. Wird nur zu Protokollierungszwecken verwendet. |
action |
NativeDevice.DeviceAction: die auszuführende Aktion |
retryAttempts |
int: Die Anzahl der Wiederholungsversuche für die Aktion, wenn sie fehlschlägt, aber die Wiederherstellung erfolgreich ist. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn die Aktion erfolgreich ausgeführt wurde |
| Löst aus | |
|---|---|
DeviceNotAvailableException |
wenn der Wiederherstellungsversuch fehlschlägt oder die maximale Anzahl von Versuchen ohne Erfolg erreicht wurde |
postAdbReboot
protected void postAdbReboot (NativeDevice.RebootMode rebootMode)
Mögliche zusätzliche Aktionen, die nach einem Neustart ausgeführt werden können.
| Parameter | |
|---|---|
rebootMode |
NativeDevice.RebootMode |
| Löst aus | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
prePostBootSetup
protected void prePostBootSetup ()
Ermöglicht es jedem Gerätetyp (AndroidNativeDevice, TestDevice), diese Methode für die spezifische Einrichtung nach dem Booten zu überschreiben.
| Löst aus | |
|---|---|
|
com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException |
|
pullFileWithAdbCommand
protected boolean pullFileWithAdbCommand (String remoteFilePath,
File localFile,
long timeout)| Parameter | |
|---|---|
remoteFilePath |
String |
localFile |
File |
timeout |
long |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
| Löst aus | |
|---|---|
DeviceNotAvailableException |
|
setClock
protected void setClock (Clock clock)
Legen Sie die zu verwendende Clock-Instanz fest.
| Parameter | |
|---|---|
clock |
Clock |
setMicrodroidProcess
protected void setMicrodroidProcess (Process process)
Kennzeichnet das Testgerät als Microdroid und legt seine CID fest.
| Parameter | |
|---|---|
process |
Process: Prozess der Microdroid-VM. |
setTestDeviceOptions
protected void setTestDeviceOptions (Map<String, String> deviceOptions)
| Parameter | |
|---|---|
deviceOptions |
Map |
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, String[] fullCmd)
Führt einen einfachen Fastboot-Befehl aus und meldet den Status des Befehls.
| Parameter | |
|---|---|
timeout |
long |
fullCmd |
String |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
|
| Löst aus | |
|---|---|
UnsupportedOperationException |
|
simpleFastbootCommand
protected CommandResult simpleFastbootCommand (long timeout, Map<String, String> envVarMap, String[] fullCmd)
Führt einen einfachen Fastboot-Befehl mit Umgebungsvariablen aus und meldet den Status des Befehls.
| Parameter | |
|---|---|
timeout |
long |
envVarMap |
Map |
fullCmd |
String |
| Gibt Folgendes zurück: | |
|---|---|
CommandResult |
|
| Löst aus | |
|---|---|
UnsupportedOperationException |
|
waitForDeviceNotAvailable
protected boolean waitForDeviceNotAvailable (String operationDesc,
long time)Warten Sie, bis das Gerät nicht mehr verfügbar ist (keine Berichte mehr an adb gesendet werden).
| Parameter | |
|---|---|
operationDesc |
String: Der Name des Vorgangs, der auf „Nicht verfügbar“ wartet. |
time |
long: Die Zeit, die gewartet wird, bis „Nicht verfügbar“ eintritt. |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„True“, wenn das Gerät nicht mehr verfügbar ist. |