Wiederholt Gerätebefehle für eine konfigurierbare Anzahl und stellt eine Gerätewiederherstellungsschnittstelle für Geräte bereit, die nicht reagieren.
Verschachtelte Klassen |
---|
class | ITestDevice.ApexInfo Eine einfache Strukturklasse zum Speichern von Informationen zu einem einzelnen APEX |
class | ITestDevice.MountPointInfo Eine einfache Strukturklasse zum Speichern von Informationen über einen einzelnen Mountpoint |
Öffentliche Methoden |
---|
abstract boolean | canSwitchToHeadlessSystemUser () Gibt zurück, ob der Wechsel zum kopflosen SYSTEM-Benutzer zulässig ist. |
abstract boolean | checkConnectivity () Überprüfen Sie, ob das Gerät über eine Netzwerkverbindung verfügt. |
abstract boolean | clearErrorDialogs () Versuchen Sie, alle Fehlerdialoge zu schließen, die derzeit auf der Benutzeroberfläche des Geräts angezeigt werden. |
abstract void | clearLastConnectedWifiNetwork () Löscht das zuletzt verbundene WLAN-Netzwerk. |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) Verbindet sich mit einem WLAN-Netzwerk. |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) Verbindet sich mit einem WLAN-Netzwerk. |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk) Verbindet sich mit einem WLAN-Netzwerk. |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid) Verbindet sich mit einem WLAN-Netzwerk. |
abstract boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid) Eine Variante von connectToWifiNetwork(String, String) , die nur dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkkonnektivität hat. |
abstract boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk) Eine Variante von connectToWifiNetwork(String, String) , die nur dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkkonnektivität hat. |
abstract int | createUser (String name) Erstellen Sie einen Benutzer mit einem bestimmten Namen und den Standardflags 0. |
abstract int | createUser (String name, boolean guest, boolean ephemeral) Erstellen Sie einen Benutzer mit einem bestimmten Namen und den bereitgestellten Flags |
abstract int | createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) Erstellen Sie einen Benutzer mit einem bestimmten Namen und den bereitgestellten Flags |
abstract int | createUserNoThrow (String name) Erstellen Sie einen Benutzer mit einem bestimmten Namen und den Standardflags 0. |
abstract void | deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) Entfernt den registrierten IDeviceActionReceiver . |
abstract void | disableKeyguard () Versucht, den Tastenschutz zu deaktivieren. |
abstract boolean | disableNetworkMonitor () Deaktiviert die Netzwerküberwachung auf dem Gerät. |
abstract boolean | disconnectFromWifi () Trennt die Verbindung zu einem WLAN-Netzwerk. |
abstract boolean | doesFileExist (String deviceFilePath, int userId) Hilfsmethode, um festzustellen, ob für einen bestimmten Benutzer eine Datei auf dem Gerät vorhanden ist. |
abstract File | dumpHeap (String process, String devicePath) Versuchen Sie, den Heap vom Systemserver zu sichern. |
abstract boolean | enableNetworkMonitor () Aktiviert die Netzwerküberwachung auf dem Gerät. |
abstract | getActiveApexes () Rufen Sie die Informationen zu APEXes ab, die auf dem Gerät aktiviert sind. |
abstract | getAllSettings (String namespace) Gibt Schlüssel-Wert-Paare des angeforderten Namespace zurück. |
abstract String | getAndroidId (int userId) Suchen Sie die einer Benutzer-ID zugeordnete Android-ID und geben Sie sie zurück. Null, wenn sie nicht gefunden wird. |
abstract | getAndroidIds () Erstellen Sie eine Karte mit gefundenen Android-IDs, die mit Benutzer-IDs übereinstimmen. |
abstract PackageInfo | getAppPackageInfo (String packageName) Rufen Sie Informationen zu einem auf dem Gerät installierten Paket ab. |
abstract | getAppPackageInfos () Rufen Sie Informationen zu den auf dem Gerät installierten Paketen ab. |
abstract InputStreamSource | getBugreport () Ruft einen Fehlerbericht vom Gerät ab. |
abstract InputStreamSource | getBugreportz () Ruft einen Fehlerbericht vom Gerät ab. |
abstract DeviceFoldableState | getCurrentFoldableState () Gibt den aktuellen faltbaren Zustand des Geräts zurück oder null, wenn Probleme aufgetreten sind. |
abstract int | getCurrentUser () Gibt die ID des aktuell aktiven Benutzers zurück. |
abstract | getFoldableStates () Gibt die Liste der faltbaren Zustände auf dem Gerät zurück. |
abstract | getInstalledPackageNames () Rufen Sie die auf dem Gerät vorhandenen Anwendungspaketnamen ab. |
abstract String | getIpAddress () Ruft die IP-Adresse des Geräts ab. |
abstract KeyguardControllerState | getKeyguardState () Gibt ein Objekt zurück, um den aktuellen Status des Keyguards abzurufen, oder null, wenn dies nicht unterstützt wird. |
abstract Integer | getMainUserId () Gibt die Hauptbenutzer-ID zurück. |
abstract | getMainlineModuleInfo () Rufen Sie Informationen zu den auf dem Gerät installierten Hauptmodulen ab. |
abstract int | getMaxNumberOfRunningUsersSupported () Erhalten Sie die maximale Anzahl unterstützter gleichzeitig laufender Benutzer. |
abstract int | getMaxNumberOfUsersSupported () Erhalten Sie die maximale Anzahl unterstützter Benutzer. |
abstract TestDeviceOptions | getOptions () Rufen Sie die Testoptionen für das Gerät ab. |
abstract Integer | getPrimaryUserId () Gibt die primäre Benutzer-ID zurück. |
abstract InputStreamSource | getScreenshot (String format, boolean rescale) Erfasst einen Screenshot vom Gerät. |
abstract InputStreamSource | getScreenshot (String format) Erfasst einen Screenshot vom Gerät. |
abstract InputStreamSource | getScreenshot (long displayId) Erfasst einen Screenshot des Geräts mit der angegebenen Anzeige-ID. |
abstract InputStreamSource | getScreenshot () Erfasst einen Screenshot vom Gerät. |
abstract String | getSetting (int userId, String namespace, String key) Gibt den Wert der angeforderten Einstellung zurück. |
abstract String | getSetting (String namespace, String key) Siehe getSetting(int, String, String) und wird für den Systembenutzer ausgeführt. |
abstract | getUninstallablePackageNames () Rufen Sie die Namen der Anwendungspakete ab, die deinstalliert werden können. |
abstract int | getUserFlags (int userId) Suchen Sie die Flags eines bestimmten Benutzers und geben Sie sie zurück. |
abstract | getUserInfos () Ruft die Zuordnung von useId zu UserInfo auf dem Gerät ab. |
abstract int | getUserSerialNumber (int userId) Gibt die mit der Benutzer-ID verknüpfte Seriennummer zurück, falls gefunden, -10000 in allen anderen Fällen. |
abstract boolean | hasFeature (String feature) Überprüfen Sie, ob eine Funktion auf einem Gerät verfügbar ist. |
abstract String | installPackage (File packageFile, boolean reinstall, String... extraArgs) Installieren Sie ein Android-Paket auf dem Gerät. |
abstract String | installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Installieren Sie ein Android-Paket auf dem Gerät. |
abstract String | installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) Installieren Sie ein Android-Paket auf dem Gerät für einen bestimmten Benutzer. |
abstract String | installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Installieren Sie ein Android-Paket auf dem Gerät für einen bestimmten Benutzer. |
default String | installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs) Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien besteht (ein Haupt- und zusätzliche Split-Pakete). |
default String | installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht, die sich auf dem Android-Gerät befinden. |
default String | installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) Installieren Sie für einen bestimmten Benutzer eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht. |
default String | installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Installieren Sie für einen bestimmten Benutzer eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht. |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht, die sich auf dem Android-Gerät befinden. |
default String | installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht, die sich auf dem Android-Gerät befinden. |
abstract boolean | isHeadlessSystemUserMode () Gibt zurück, ob das Gerät den Headless-System-Benutzermodus verwendet. |
abstract boolean | isMainUserPermanentAdmin () Gibt zurück, ob der Hauptbenutzer ein permanenter Administrator ist und nicht gelöscht oder auf den Nicht-Administratorstatus herabgestuft werden kann. |
abstract boolean | isMultiUserSupported () Legt fest, ob Mehrbenutzer unterstützt werden. |
abstract boolean | isPackageInstalled (String packageName, String userId) Fragen Sie das Gerät nach einem bestimmten Paketnamen und einer bestimmten Benutzer-ID ab, um zu prüfen, ob es derzeit für diesen Benutzer installiert ist oder nicht. |
abstract boolean | isPackageInstalled (String packageName) Fragen Sie das Gerät nach einem bestimmten Paketnamen ab, um zu prüfen, ob es derzeit installiert ist oder nicht. |
abstract boolean | isUserRunning (int userId) Überprüfen Sie, ob ein bestimmter Benutzer ausgeführt wird. |
abstract boolean | isUserSecondary (int userId) Gibt zurück, ob der angegebene Benutzer gemäß seinen Flags ein sekundärer Benutzer ist. |
abstract boolean | isUserVisible (int userId) Überprüft, ob der angegebene Benutzer sichtbar ist. |
abstract boolean | isUserVisibleOnDisplay (int userId, int displayId) Überprüft, ob der angegebene Benutzer in der angegebenen Anzeige sichtbar ist. |
abstract boolean | isVisibleBackgroundUsersOnDefaultDisplaySupported () Gibt zurück, ob das Gerät das Starten von Benutzern im Hintergrund im ERROR(/java.android.view.Display#DEFAULT_DISPLAY) zulässt. |
abstract boolean | isVisibleBackgroundUsersSupported () Gibt zurück, ob das Gerät das Starten von Benutzern im Hintergrund sichtbar zulässt. |
abstract boolean | isWifiEnabled () Testen Sie, ob WLAN aktiviert ist. |
abstract | listDisplayIds () Sammeln Sie die Liste der verfügbaren Display-IDs auf dem Gerät, wie von „dumpsys SurfaceFlinger“ gemeldet. |
abstract | listDisplayIdsForStartingVisibleBackgroundUsers () Ruft die Liste der Anzeigen ab, die zum start a user visible in the background verwendet werden können. |
abstract | listUsers () Ruft die Liste der Benutzer auf dem Gerät ab. |
abstract boolean | logBugreport (String dataName, ITestLogger listener) Hilfsmethode, um einen Fehlerbericht aufzunehmen und ihn für die Reporter zu protokollieren. |
default void | notifySnapuserd ( SnapuserdWaitPhase waitPhase) Weisen Sie das Gerät an, auf den Abschluss von snapuserd zu warten. |
abstract void | registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) Registriert einen IDeviceActionReceiver für dieses Gerät. |
abstract boolean | removeAdmin (String componentName, int userId) Entfernen Sie den angegebenen Geräteadministrator im angegebenen Benutzer und geben Sie true zurück, wenn es erfolgreich ist, andernfalls false . |
abstract void | removeOwners () Entfernen Sie mit größtmöglicher Mühe alle vorhandenen Geräteprofilbesitzer. |
abstract boolean | removeUser (int userId) Entfernen Sie einen bestimmten Benutzer vom Gerät. |
abstract boolean | setDeviceOwner (String componentName, int userId) Legen Sie eine Geräteadministratorkomponente als Geräteeigentümer für einen bestimmten Benutzer fest. |
abstract void | setSetting (String namespace, String key, String value) Siehe setSetting(int, String, String, String) und wird für den Systembenutzer ausgeführt. |
abstract void | setSetting (int userId, String namespace, String key, String value) Fügen Sie dem Namespace eines bestimmten Benutzers einen Einstellungswert hinzu. |
abstract boolean | startUser (int userId) Startet einen bestimmten Benutzer im Hintergrund, wenn er gerade gestoppt ist. |
abstract boolean | startUser (int userId, boolean waitFlag) Startet einen bestimmten Benutzer im Hintergrund, wenn er gerade gestoppt ist. |
abstract boolean | startVisibleBackgroundUser (int userId, int displayId, boolean waitFlag) Startet einen bestimmten Benutzer im Hintergrund, sichtbar in der angegebenen Anzeige (d. h. ermöglicht dem Benutzer, Aktivitäten in dieser Anzeige zu starten). |
abstract boolean | stopUser (int userId) Stoppt einen bestimmten Benutzer. |
abstract boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) Stoppen Sie einen bestimmten Benutzer. |
abstract boolean | switchUser (int userId) Wechseln Sie zu einer anderen Benutzer-ID mit einem Standard-Timeout. |
abstract boolean | switchUser (int userId, long timeout) Wechseln Sie zu einer anderen Benutzer-ID mit dem angegebenen Timeout als Frist. |
abstract Bugreport | takeBugreport () Nehmen Sie einen Bugreport und geben Sie ihn in ein Bugreport Objekt zurück, um ihn zu verarbeiten. |
abstract String | uninstallPackage (String packageName) Deinstallieren Sie ein Android-Paket vom Gerät. |
abstract String | uninstallPackageForUser (String packageName, int userId) Deinstallieren Sie ein Android-Paket vom Gerät für einen bestimmten Benutzer. |
default void | waitForSnapuserd ( SnapuserdWaitPhase currentPhase) Warten Sie ggf., bis snapuserd abgeschlossen ist. |
Öffentliche Methoden
canSwitchToHeadlessSystemUser
public abstract boolean canSwitchToHeadlessSystemUser ()
Gibt zurück, ob der Wechsel zum kopflosen SYSTEM-Benutzer zulässig ist.
checkConnectivity
public abstract boolean checkConnectivity ()
Überprüfen Sie, ob das Gerät über eine Netzwerkverbindung verfügt.
Kehrt zurück |
---|
boolean | true , wenn das Gerät über eine funktionierende Netzwerkverbindung verfügt, andernfalls false . |
clearErrorDialogs
public abstract boolean clearErrorDialogs ()
Versuchen Sie, alle Fehlerdialoge zu schließen, die derzeit auf der Benutzeroberfläche des Geräts angezeigt werden.
Kehrt zurück |
---|
boolean | true , wenn keine Dialoge vorhanden waren oder Dialoge erfolgreich gelöscht wurden. sonst false . |
clearLastConnectedWifiNetwork
public abstract void clearLastConnectedWifiNetwork ()
Löscht das zuletzt verbundene WLAN-Netzwerk. Dies sollte beim Starten eines neuen Aufrufs aufgerufen werden, um zu vermeiden, dass nach dem Neustart des Geräts eine Verbindung zum WLAN-Netzwerk hergestellt wird, das im vorherigen Test verwendet wurde.
connectToWifiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)
Verbindet sich mit einem WLAN-Netzwerk.
Schaltet WLAN ein und blockiert es, bis eine erfolgreiche Verbindung mit einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke hergestellt wird. Sobald eine Verbindung hergestellt ist, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice#disconnectFromWifi()
oder ITestDevice#clearLastConnectedWifiNetwork()
aufgerufen wird.
Parameter |
---|
wifiSsidToPsk | : Eine Zuordnung von WLAN-SSIDs zu Passwörtern. |
Kehrt zurück |
---|
boolean | true , wenn die Verbindung zum WLAN-Netzwerk erfolgreich war. sonst false |
connectToWifiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk,
boolean scanSsid)
Verbindet sich mit einem WLAN-Netzwerk.
Schaltet WLAN ein und blockiert es, bis eine erfolgreiche Verbindung mit einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke hergestellt wird. Sobald eine Verbindung hergestellt ist, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice#disconnectFromWifi()
oder ITestDevice#clearLastConnectedWifiNetwork()
aufgerufen wird.
Parameter |
---|
wifiSsidToPsk | : Eine Zuordnung von WLAN-SSIDs zu Passwörtern. |
scanSsid | boolean : ob nach versteckten SSIDs für dieses Netzwerk gesucht werden soll. |
Kehrt zurück |
---|
boolean | true , wenn die Verbindung zum WLAN-Netzwerk erfolgreich war. sonst false |
connectToWifiNetwork
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk)
Verbindet sich mit einem WLAN-Netzwerk.
Schaltet WLAN ein und blockiert es, bis eine erfolgreiche Verbindung zum angegebenen WLAN-Netzwerk hergestellt wurde. Sobald eine Verbindung hergestellt ist, versucht die Instanz nach jedem Neustart, die Verbindung 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 unverschlüsselt |
Kehrt zurück |
---|
boolean | true , wenn die Verbindung zum WLAN-Netzwerk erfolgreich war. sonst false |
connectToWifiNetwork
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk,
boolean scanSsid)
Verbindet sich mit einem WLAN-Netzwerk.
Schaltet WLAN ein und blockiert es, bis eine erfolgreiche Verbindung zum angegebenen WLAN-Netzwerk hergestellt wurde. Sobald eine Verbindung hergestellt ist, versucht die Instanz nach jedem Neustart, die Verbindung 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 unverschlüsselt |
scanSsid | boolean : ob nach versteckter SSID für dieses Netzwerk gesucht werden soll. |
Kehrt zurück |
---|
boolean | true , wenn die Verbindung zum WLAN-Netzwerk erfolgreich war. sonst false |
connectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk,
boolean scanSsid)
Eine Variante von connectToWifiNetwork(String, String)
, die nur dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkkonnektivität hat.
Parameter |
---|
scanSsid | boolean : ob nach versteckter SSID für dieses Netzwerk gesucht werden soll |
Kehrt zurück |
---|
boolean | true , wenn die Verbindung zum WLAN-Netzwerk erfolgreich war. sonst false |
connectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk)
Eine Variante von connectToWifiNetwork(String, String)
, die nur dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkkonnektivität hat.
Kehrt zurück |
---|
boolean | true , wenn die Verbindung zum WLAN-Netzwerk erfolgreich war. sonst false |
createUser
public abstract int createUser (String name)
Erstellen Sie einen Benutzer mit einem bestimmten Namen und den Standardflags 0.
Parameter |
---|
name | String : des Benutzers, der auf dem Gerät erstellt werden soll |
Kehrt zurück |
---|
int | die Ganzzahl für die erstellte Benutzer-ID |
createUser
public abstract int createUser (String name,
boolean guest,
boolean ephemeral)
Erstellen Sie einen Benutzer mit einem bestimmten Namen und den bereitgestellten Flags
Parameter |
---|
name | String : des Benutzers, der auf dem Gerät erstellt werden soll |
guest | boolean : Aktiviert das Benutzerflag --guest während der Erstellung |
ephemeral | boolean : Aktiviert das Benutzerflag --ephemeral während der Erstellung |
Kehrt zurück |
---|
int | ID des erstellten Benutzers |
createUser
public abstract int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Erstellen Sie einen Benutzer mit einem bestimmten Namen und den bereitgestellten Flags
Parameter |
---|
name | String : des Benutzers, der auf dem Gerät erstellt werden soll |
guest | boolean : Aktiviert das Benutzerflag --guest während der Erstellung |
ephemeral | boolean : Aktiviert das Benutzerflag --ephemeral während der Erstellung |
forTesting | boolean : Aktivieren Sie das Testflag --for-testing während der Erstellung |
Kehrt zurück |
---|
int | ID des erstellten Benutzers |
createUserNoThrow
public abstract int createUserNoThrow (String name)
Erstellen Sie einen Benutzer mit einem bestimmten Namen und den Standardflags 0.
Parameter |
---|
name | String : des Benutzers, der auf dem Gerät erstellt werden soll |
Kehrt zurück |
---|
int | die Ganzzahl für die erstellte Benutzer-ID oder -1 für Fehler. |
deaktivierenKeyguard
public abstract void disableKeyguard ()
Versucht, den Tastenschutz zu deaktivieren.
Warten Sie zunächst, bis der Eingabeversand bereit ist. Dies geschieht ungefähr zur gleichen Zeit, wenn das Gerät BOOT_COMPLETE meldet, offenbar asynchron, da bei der aktuellen Framework-Implementierung gelegentlich eine Race-Bedingung auftritt. Anschließend wird der Befehl zum Aufheben der Tastensperre gesendet (funktioniert nur bei nicht sicheren Tastensperren).
deaktivieren Sie NetworkMonitor
public abstract boolean disableNetworkMonitor ()
Deaktiviert die Netzwerküberwachung auf dem Gerät.
Kehrt zurück |
---|
boolean | true , wenn die Überwachung erfolgreich deaktiviert wurde. false , wenn es fehlgeschlagen ist. |
Vom WLAN trennen
public abstract boolean disconnectFromWifi ()
Trennt die Verbindung zu einem WLAN-Netzwerk.
Entfernt alle Netzwerke aus der Liste bekannter Netzwerke und deaktiviert WLAN.
Kehrt zurück |
---|
boolean | true , wenn die Verbindung zum WLAN-Netzwerk erfolgreich getrennt wurde. false , wenn die Trennung fehlgeschlagen ist. |
DoesFileExist
public abstract boolean doesFileExist (String deviceFilePath,
int userId)
Hilfsmethode, um festzustellen, ob für einen bestimmten Benutzer eine Datei auf dem Gerät vorhanden ist.
Parameter |
---|
deviceFilePath | String : der absolute Pfad der zu überprüfenden Datei auf dem Gerät |
userId | int : Die Benutzer-ID, anhand derer die Dateiexistenz überprüft werden soll |
Kehrt zurück |
---|
boolean | true , wenn die Datei vorhanden ist, andernfalls false . |
dumpHeap
public abstract File dumpHeap (String process,
String devicePath)
Versuchen Sie, den Heap vom Systemserver zu sichern. Es liegt in der Verantwortung des Aufrufers, die gespeicherte Datei zu bereinigen.
Parameter |
---|
process | String : Der Name des Geräteprozesses, auf dem der Dumpheap durchgeführt werden soll. |
devicePath | String : der Pfad auf dem Gerät, wo der Dump abgelegt werden soll. Dies muss ein Ort sein, an dem die Berechtigungen dies zulassen. |
Kehrt zurück |
---|
File | die ERROR(/File) die den Bericht enthält. Null, wenn etwas fehlgeschlagen ist. |
enableNetworkMonitor
public abstract boolean enableNetworkMonitor ()
Aktiviert die Netzwerküberwachung auf dem Gerät.
Kehrt zurück |
---|
boolean | true , wenn die Überwachung erfolgreich aktiviert wurde. false , wenn es fehlgeschlagen ist. |
getActiveApexes
public abstract getActiveApexes ()
Rufen Sie die Informationen zu APEXes ab, die auf dem Gerät aktiviert sind.
getAllSettings
public abstract getAllSettings (String namespace)
Gibt Schlüssel-Wert-Paare des angeforderten Namespace zurück.
Parameter |
---|
namespace | String : muss einer von {"system", "secure", "global"} sein |
Kehrt zurück |
---|
| die Karte der Schlüssel-Wert-Paare. Null, wenn der Namespace nicht unterstützt wird. |
getAndroidId
public abstract String getAndroidId (int userId)
Suchen Sie die einer Benutzer-ID zugeordnete Android-ID und geben Sie sie zurück. Null, wenn sie nicht gefunden wird.
getAndroidIds
public abstract getAndroidIds ()
Erstellen Sie eine Karte mit gefundenen Android-IDs, die mit Benutzer-IDs übereinstimmen. Es gibt keine Garantie dafür, dass jede Benutzer-ID eine in dieser Funktion zugeordnete Android-ID findet, sodass einige Benutzer-IDs möglicherweise mit Null übereinstimmen.
Kehrt zurück |
---|
| Karte der Android-IDs, die mit den Benutzer-IDs übereinstimmen. |
getAppPackageInfo
public abstract PackageInfo getAppPackageInfo (String packageName)
Rufen Sie Informationen zu einem auf dem Gerät installierten Paket ab.
Parameter |
---|
packageName | String |
getAppPackageInfos
public abstract getAppPackageInfos ()
Rufen Sie Informationen zu den auf dem Gerät installierten Paketen ab.
getBugreport
public abstract InputStreamSource getBugreport ()
Ruft einen Fehlerbericht vom Gerät ab.
Die Implementierung funktioniert garantiert weiterhin auf einem Gerät ohne SD-Karte (oder bei dem die SD-Karte noch nicht gemountet ist).
getBugreportz
public abstract InputStreamSource getBugreportz ()
Ruft einen Fehlerbericht vom Gerät ab. Der Bugreport im Zip-Format enthält den Haupt-Bugreport und andere Protokolldateien, die zum Debuggen nützlich sind.
Wird nur für „ADB-Version“ > 1.0.36 unterstützt
getCurrentFoldableState
public abstract DeviceFoldableState getCurrentFoldableState ()
Gibt den aktuellen faltbaren Zustand des Geräts zurück oder null, wenn Probleme aufgetreten sind.
getCurrentUser
public abstract int getCurrentUser ()
Gibt die ID des aktuell aktiven Benutzers zurück. Im Fehlerfall -10000 zurückgeben.
getFoldableStates
public abstract getFoldableStates ()
Gibt die Liste der faltbaren Zustände auf dem Gerät zurück. Kann mit „cmd device_state print-states“ abgerufen werden.
getInstalledPackageNames
public abstract getInstalledPackageNames ()
Rufen Sie die auf dem Gerät vorhandenen Anwendungspaketnamen ab.
Kehrt zurück |
---|
| ERROR(/Set) der String Paketnamen, die derzeit auf dem Gerät installiert sind. |
getIpAddress
public abstract String getIpAddress ()
Ruft die IP-Adresse des Geräts ab.
Kehrt zurück |
---|
String | die IP-Adresse des Geräts oder null , wenn das Gerät keine IP-Adresse hat |
getKeyguardState
public abstract KeyguardControllerState getKeyguardState ()
Gibt ein Objekt zurück, um den aktuellen Status des Keyguards abzurufen, oder null, wenn dies nicht unterstützt wird.
getMainUserId
public abstract Integer getMainUserId ()
Gibt die Hauptbenutzer-ID zurück.
Kehrt zurück |
---|
Integer | die Benutzer-ID des Hauptbenutzers, falls vorhanden, und null, wenn es keinen Hauptbenutzer gibt. |
getMainlineModuleInfo
public abstract getMainlineModuleInfo ()
Rufen Sie Informationen zu den auf dem Gerät installierten Hauptmodulen ab.
Kehrt zurück |
---|
| ERROR(/Set) der derzeit auf dem Gerät installierten String Hauptleitungsmodule. |
public abstract int getMaxNumberOfRunningUsersSupported ()
Erhalten Sie die maximale Anzahl unterstützter gleichzeitig laufender Benutzer. Der Standardwert ist 0.
Kehrt zurück |
---|
int | eine Ganzzahl, die die Anzahl gleichzeitig laufender Benutzer angibt |
public abstract int getMaxNumberOfUsersSupported ()
Erhalten Sie die maximale Anzahl unterstützter Benutzer. Der Standardwert ist 0.
Kehrt zurück |
---|
int | eine ganze Zahl, die die Anzahl der unterstützten Benutzer angibt |
getOptions
public abstract TestDeviceOptions getOptions ()
Rufen Sie die Testoptionen für das Gerät ab.
getPrimaryUserId
public abstract Integer getPrimaryUserId ()
Gibt die primäre Benutzer-ID zurück.
Kehrt zurück |
---|
Integer | die Benutzer-ID des primären Benutzers, falls vorhanden, und null, wenn es keinen primären Benutzer gibt. |
getScreenshot
public abstract InputStreamSource getScreenshot (String format,
boolean rescale)
Erstellt einen Screenshot vom Gerät. Es wird empfohlen, stattdessen getScreenshot(String)
mit JPEG-Kodierung für eine kleinere Größe zu verwenden.
Parameter |
---|
format | String : Unterstütztes PNG, JPEG |
rescale | boolean : Wenn der Screenshot neu skaliert werden soll, um die Größe des resultierenden Bildes zu reduzieren |
getScreenshot
public abstract InputStreamSource getScreenshot (String format)
Erstellt einen Screenshot vom Gerät. Es wird empfohlen, stattdessen getScreenshot(format) mit JPEG-Kodierung für eine kleinere Größe zu verwenden
Parameter |
---|
format | String : Unterstütztes PNG, JPEG |
getScreenshot
public abstract InputStreamSource getScreenshot (long displayId)
Erfasst einen Screenshot des Geräts mit der angegebenen Anzeige-ID. Das Format ist PNG.
TODO: Erweitern Sie die oben genannten Implementierungen, um „Format“ und „Neuskalierung“ zu unterstützen.
Parameter |
---|
displayId | long : Die Anzeige-ID des Bildschirms, von dem der Screenshot abgerufen werden soll. |
getScreenshot
public abstract InputStreamSource getScreenshot ()
Erstellt einen Screenshot vom Gerät.
getSetting
public abstract String getSetting (int userId,
String namespace,
String key)
Gibt den Wert der angeforderten Einstellung zurück. Namespace muss einer von sein: {"system", "secure", "global"}
Parameter |
---|
userId | int |
namespace | String |
key | String |
Kehrt zurück |
---|
String | der Wert, der dem Namespace:Schlüssel eines Benutzers zugeordnet ist. Null, wenn nicht gefunden. |
getSetting
public abstract String getSetting (String namespace,
String key)
Siehe getSetting(int, String, String)
und wird für den Systembenutzer ausgeführt.
Parameter |
---|
namespace | String |
key | String |
getUninstallablePackageNames
public abstract getUninstallablePackageNames ()
Rufen Sie die Namen der Anwendungspakete ab, die deinstalliert werden können. Dies wird derzeit als Nicht-Systempakete und aktualisierte Systempakete definiert.
Kehrt zurück |
---|
| ERROR(/Set) der deinstallierbaren String Paketnamen, die derzeit auf dem Gerät installiert sind. |
getUserFlags
public abstract int getUserFlags (int userId)
Suchen Sie die Flags eines bestimmten Benutzers und geben Sie sie zurück. Flags werden in der Klasse „android.content.pm.UserInfo“ im Android Open Source Project definiert.
Kehrt zurück |
---|
int | die mit der bereitgestellten Benutzer-ID verknüpften Flags, falls gefunden, -10000 in allen anderen Fällen. |
getUserInfos
public abstract getUserInfos ()
Ruft die Zuordnung von useId zu UserInfo
auf dem Gerät ab. Löst DeviceRuntimeException
aus, wenn die Ausgabe vom Gerät nicht wie erwartet ist.
Kehrt zurück |
---|
| die Liste der UserInfo-Objekte. |
Würfe |
---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException | |
getUserSerialNumber
public abstract int getUserSerialNumber (int userId)
Gibt die mit der Benutzer-ID verknüpfte Seriennummer zurück, falls gefunden, -10000 in allen anderen Fällen.
hasFeature
public abstract boolean hasFeature (String feature)
Überprüfen Sie, ob eine Funktion auf einem Gerät verfügbar ist.
Parameter |
---|
feature | String : Welches Format sollte „feature:“ sein? " oder " " direkt. |
Kehrt zurück |
---|
boolean | True, wenn das Feature gefunden wird, andernfalls false. |
Installationspaket
public abstract 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 zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Kehrt zurück |
---|
String | ein String mit einem Fehlercode oder null bei Erfolg. |
Installationspaket
public abstract String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Installieren Sie ein Android-Paket auf dem Gerät.
Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Erteilung von Laufzeitberechtigungen zur Installationszeit erfordern.
Parameter |
---|
packageFile | File : Die zu installierende APK-Datei |
reinstall | boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions | boolean : wenn alle Laufzeitberechtigungen zum Zeitpunkt der Installation gewährt werden sollen |
extraArgs | String : optionale zusätzliche Argumente zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Kehrt zurück |
---|
String | ein String mit einem Fehlercode oder null bei Erfolg. |
Würfe |
---|
DeviceNotAvailableException | wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann. |
UnsupportedOperationException | wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird. |
installPackageForUser
public abstract String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
Installieren Sie ein Android-Paket auf dem Gerät für einen bestimmten Benutzer.
Parameter |
---|
packageFile | File : Die zu installierende APK-Datei |
reinstall | boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
userId | int : die ganzzahlige Benutzer-ID, für die installiert werden soll. |
extraArgs | String : optionale zusätzliche Argumente zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Kehrt zurück |
---|
String | ein String mit einem Fehlercode oder null bei Erfolg. |
installPackageForUser
public abstract String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Installieren Sie ein Android-Paket auf dem Gerät für einen bestimmten Benutzer.
Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Gewährung von Laufzeitberechtigungen zur Installationszeit erfordern.
Parameter |
---|
packageFile | File : Die zu installierende APK-Datei |
reinstall | boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions | boolean : wenn alle Laufzeitberechtigungen zum Zeitpunkt der Installation gewährt werden sollen |
userId | int : die ganzzahlige Benutzer-ID, für die installiert werden soll. |
extraArgs | String : optionale zusätzliche Argumente zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Kehrt zurück |
---|
String | ein String mit einem Fehlercode oder null bei Erfolg. |
Würfe |
---|
DeviceNotAvailableException | wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann. |
UnsupportedOperationException | wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird. |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien besteht (ein Haupt- und zusätzliche Split-Pakete). Unter „https://developer.android.com/studio/build/configure-apk-splits“ erfahren Sie, wie Sie eine APK in mehrere Dateien aufteilen.
Parameter |
---|
packageFiles | : die lokalen APK-Dateien |
reinstall | boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
extraArgs | String : optionale zusätzliche Argumente zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Kehrt zurück |
---|
String | ein String mit einem Fehlercode oder null bei Erfolg. |
Würfe |
---|
DeviceNotAvailableException | wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann. |
UnsupportedOperationException | wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird. |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht, die sich auf dem Android-Gerät befinden. Unter „https://developer.android.com/studio/build/configure-apk-splits“ erfahren Sie, wie Sie APK in mehrere Dateien aufteilen.
Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Erteilung von Laufzeitberechtigungen zur Installationszeit erfordern.
Parameter |
---|
packageFiles | : die zu installierenden Remote-Apk-Dateipfade |
reinstall | boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions | boolean : wenn alle Laufzeitberechtigungen zum Zeitpunkt der Installation gewährt werden sollen |
extraArgs | String : optionale zusätzliche Argumente zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Kehrt zurück |
---|
String | ein String mit einem Fehlercode oder null bei Erfolg. |
Würfe |
---|
DeviceNotAvailableException | wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann. |
UnsupportedOperationException | wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird. |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Installieren Sie für einen bestimmten Benutzer eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht. Unter „https://developer.android.com/studio/build/configure-apk-splits“ erfahren Sie, wie Sie eine APK in mehrere Dateien aufteilen.
Parameter |
---|
packageFiles | : die lokalen APK-Dateien |
reinstall | boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
userId | int : die ganzzahlige Benutzer-ID, für die installiert werden soll. |
extraArgs | String : optionale zusätzliche Argumente zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Kehrt zurück |
---|
String | ein String mit einem Fehlercode oder null bei Erfolg. |
Würfe |
---|
DeviceNotAvailableException | wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann. |
UnsupportedOperationException | wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird. |
installPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Installieren Sie für einen bestimmten Benutzer eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht. Unter „https://developer.android.com/studio/build/configure-apk-splits“ erfahren Sie, wie Sie eine APK in mehrere Dateien aufteilen.
Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Gewährung von Laufzeitberechtigungen zur Installationszeit erfordern.
Parameter |
---|
packageFiles | : die lokalen APK-Dateien |
reinstall | boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions | boolean : wenn alle Laufzeitberechtigungen zum Zeitpunkt der Installation gewährt werden sollen |
userId | int : die ganzzahlige Benutzer-ID, für die installiert werden soll. |
extraArgs | String : optionale zusätzliche Argumente zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Kehrt zurück |
---|
String | ein String mit einem Fehlercode oder null bei Erfolg. |
Würfe |
---|
DeviceNotAvailableException | wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann. |
UnsupportedOperationException | wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird. |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht, die sich auf dem Android-Gerät befinden. Unter „https://developer.android.com/studio/build/configure-apk-splits“ erfahren Sie, wie Sie APK in mehrere Dateien aufteilen.
Parameter |
---|
remoteApkPaths | : die Remote-Apk-Dateipfade |
reinstall | boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
extraArgs | String : optionale zusätzliche Argumente zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Kehrt zurück |
---|
String | ein String mit einem Fehlercode oder null bei Erfolg. |
Würfe |
---|
DeviceNotAvailableException | wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann. |
UnsupportedOperationException | wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird. |
installRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht, die sich auf dem Android-Gerät befinden. Unter „https://developer.android.com/studio/build/configure-apk-splits“ erfahren Sie, wie Sie eine APK in mehrere Dateien aufteilen.
Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Gewährung von Laufzeitberechtigungen zur Installationszeit erfordern.
Parameter |
---|
remoteApkPaths | : die Remote-Apk-Dateipfade |
reinstall | boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions | boolean : wenn alle Laufzeitberechtigungen zum Zeitpunkt der Installation gewährt werden sollen |
extraArgs | String : optionale zusätzliche Argumente zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Kehrt zurück |
---|
String | ein String mit einem Fehlercode oder null bei Erfolg. |
Würfe |
---|
DeviceNotAvailableException | wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann. |
UnsupportedOperationException | wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird. |
isHeadlessSystemUserMode
public abstract boolean isHeadlessSystemUserMode ()
Gibt zurück, ob das Gerät den Headless-System-Benutzermodus verwendet.
isMainUserPermanentAdmin
public abstract boolean isMainUserPermanentAdmin ()
Gibt zurück, ob der Hauptbenutzer ein permanenter Administrator ist und nicht gelöscht oder auf den Nicht-Administratorstatus herabgestuft werden kann.
isMultiUserSupported
public abstract boolean isMultiUserSupported ()
Legt fest, ob Mehrbenutzer unterstützt werden.
Kehrt zurück |
---|
boolean | true, wenn Mehrbenutzer unterstützt werden, andernfalls false |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName,
String userId)
Fragen Sie das Gerät nach einem bestimmten Paketnamen und einer bestimmten Benutzer-ID ab, um zu prüfen, ob es derzeit für diesen Benutzer installiert ist oder nicht.
Parameter |
---|
packageName | String : Das Paket, das wir überprüfen, ob es installiert ist. |
userId | String : Die Benutzer-ID, für die wir überprüfen, ob das Paket installiert ist. Wenn null, wird der primäre Benutzer Null verwendet. |
Kehrt zurück |
---|
boolean | True, wenn das Paket als installiert gemeldet wird. Sonst falsch. |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName)
Fragen Sie das Gerät nach einem bestimmten Paketnamen ab, um zu prüfen, ob es derzeit installiert ist oder nicht.
Parameter |
---|
packageName | String |
Kehrt zurück |
---|
boolean | True, wenn das Paket als installiert gemeldet wird. Sonst falsch. |
isUserRunning
public abstract boolean isUserRunning (int userId)
Überprüfen Sie, ob ein bestimmter Benutzer ausgeführt wird.
Kehrt zurück |
---|
boolean | True, wenn der Benutzer aktiv ist, false in allen anderen Fällen. |
isUserSecondary
public abstract boolean isUserSecondary (int userId)
Gibt zurück, ob der angegebene Benutzer gemäß seinen Flags ein sekundärer Benutzer ist.
Kehrt zurück |
---|
boolean | true, wenn der Benutzer zweitrangig ist, andernfalls false. |
isUserVisible
public abstract boolean isUserVisible (int userId)
Überprüft, ob der angegebene Benutzer sichtbar ist.
Ein „sichtbarer“ Benutzer ist ein Benutzer, der mit dem „menschlichen“ Benutzer interagiert und daher in der Lage ist, Startaktivitäten zu starten (normalerweise in der Standardanzeige).
isUserVisibleOnDisplay
public abstract boolean isUserVisibleOnDisplay (int userId,
int displayId)
Überprüft, ob der angegebene Benutzer in der angegebenen Anzeige sichtbar ist.
Ein „sichtbarer“ Benutzer ist ein Benutzer, der mit dem „menschlichen“ Benutzer interagiert und daher in der Lage ist, Startaktivitäten in dieser Anzeige zu starten.
Parameter |
---|
userId | int |
displayId | int |
isWifiEnabled
public abstract boolean isWifiEnabled ()
Testen Sie, ob WLAN aktiviert ist.
Überprü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. mobile Datentests.
Kehrt zurück |
---|
boolean | true , wenn WLAN aktiviert ist. false , wenn deaktiviert |
listDisplayIds
public abstract listDisplayIds ()
Sammeln Sie die Liste der verfügbaren Display-IDs auf dem Gerät, wie von „dumpsys SurfaceFlinger“ gemeldet.
Kehrt zurück |
---|
| Die Liste der Anzeigen. Default gibt immer die Standardanzeige 0 zurück. |
listDisplayIdsForStartingVisibleBackgroundUsers
public abstract listDisplayIdsForStartingVisibleBackgroundUsers ()
Ruft die Liste der Anzeigen ab, die zum start a user visible in the background
verwendet werden können.
listUsers
public abstract listUsers ()
Ruft die Liste der Benutzer auf dem Gerät ab. Löst DeviceRuntimeException
aus, wenn die Ausgabe vom Gerät nicht wie erwartet ist.
Kehrt zurück |
---|
| die Liste der Benutzer-IDs. |
Würfe |
---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException | |
logBugreport
public abstract boolean logBugreport (String dataName,
ITestLogger listener)
Helfer -Methode, um einen Bugreport aufzunehmen und an die Reporter zu protokollieren.
Parameter |
---|
dataName | String : Name, unter dem der Bugreport gemeldet wird. |
listener | ITestLogger : Ein ITestLogger , um den Bugreport zu protokollieren. |
Kehrt zurück |
---|
boolean | Wahr, wenn die Protokollierung erfolgreich war, sonst falsch. |
notifysnapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
Benachrichtigen Sie das Gerät, um auf Snapuserd -Fertigstellung zu warten.
Parameter |
---|
waitPhase | SnapuserdWaitPhase |
removeadmin
public abstract boolean removeAdmin (String componentName,
int userId)
Entfernen Sie den angegebenen Geräteadministrator im gegebenen Benutzer und geben Sie true
zurück, wenn es erfolgreich ist, ansonsten false
.
Parameter |
---|
componentName | String : von Geräteadministrator zu entfernen. |
userId | int : des Benutzer, in dem der Geräteadministrator lebt. |
Kehrt zurück |
---|
boolean | Wahr, wenn es erfolgreich ist, sonst falsch. |
Begräbnissen
public abstract void removeOwners ()
Entfernen Sie alle vorhandenen Besitzer des Geräteprofils mit den besten Anstrengungen.
REMEUSUSER
public abstract boolean removeUser (int userId)
Entfernen Sie einen bestimmten Benutzer vom Gerät.
Parameter |
---|
userId | int : des Benutzer zu entfernen |
Kehrt zurück |
---|
boolean | Richtig, wenn es uns gelungen wäre, den Benutzer zu entfernen, falsch falsch. |
SetDeviceowner
public abstract boolean setDeviceOwner (String componentName,
int userId)
Stellen Sie eine Geräteadministratorkomponente als Gerätebesitzer im gegebenen Benutzer fest.
Parameter |
---|
componentName | String : von Geräteadministrator als Gerätebesitzer. |
userId | int : des Benutzer, in dem der Gerätebesitzer lebt. |
Kehrt zurück |
---|
boolean | Wahr, wenn es erfolgreich ist, sonst falsch. |
Setseting
public abstract void setSetting (String namespace,
String key,
String value)
Siehe setSetting(int, String, String, String)
und durchgeführt auf dem Systembenutzer.
Parameter |
---|
namespace | String |
key | String |
value | String |
Setseting
public abstract void setSetting (int userId,
String namespace,
String key,
String value)
Fügen Sie dem Namespace eines bestimmten Benutzers einen Einstellwert hinzu. Einige Einstellungen sind erst nach einem Neustart verfügbar. Der Namespace muss einer von: {"System", "sicher", "global"} sein
Parameter |
---|
userId | int |
namespace | String |
key | String |
value | String |
Startuser
public abstract boolean startUser (int userId)
Startet einen bestimmten Benutzer im Hintergrund, wenn er derzeit gestoppt wird. Wenn der Benutzer bereits im Hintergrund ausgeführt wird, ist diese Methode eine Noop.
Parameter |
---|
userId | int : des Benutzers, um im Hintergrund zu beginnen |
Kehrt zurück |
---|
boolean | Richtig, wenn der Benutzer erfolgreich im Hintergrund gestartet wurde. |
Startuser
public abstract boolean startUser (int userId,
boolean waitFlag)
Startet einen bestimmten Benutzer im Hintergrund, wenn er derzeit gestoppt wird. Wenn der Benutzer bereits im Hintergrund ausgeführt wird, ist diese Methode eine Noop. Möglich, zusätzliche Flagge bereitzustellen, um auf den Betrieb zu warten.
Parameter |
---|
userId | int : des Benutzers, um im Hintergrund zu beginnen |
waitFlag | boolean : Lassen Sie den Befehl warten, bis der Benutzer gestartet und freigeschaltet wird. |
Kehrt zurück |
---|
boolean | Richtig, wenn der Benutzer erfolgreich im Hintergrund gestartet wurde. |
startvisibleBackgrounduser
public abstract boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Startet einen bestimmten Benutzer im Hintergrund, der in der angegebenen Anzeige sichtbar ist (dh dem Benutzer, Aktivitäten in dieser Anzeige zu starten).
HINWEIS: Dieser Befehl überprüft nicht, ob der Benutzer existiert, die Anzeige verfügbar ist, device supports such feature
usw.
Parameter |
---|
userId | int : des Benutzers, um im Hintergrund zu beginnen |
displayId | int : Anzeige, um den Benutzer sichtbar auf dem Starten des Benutzers zu starten |
waitFlag | boolean : Lassen Sie den Befehl warten, bis der Benutzer gestartet und freigeschaltet wird. |
Kehrt zurück |
---|
boolean | true , wenn der Benutzer im Hintergrund erfolgreich sichtbar wurde. |
Stoppuser
public abstract boolean stopUser (int userId)
Stoppt einen bestimmten Benutzer. Wenn der Benutzer bereits gestoppt ist, ist diese Methode eine Noop. Der Strom- und Systembenutzer kann nicht gestoppt werden.
Parameter |
---|
userId | int : vom Benutzer zum Anhalten. |
Kehrt zurück |
---|
boolean | Richtig, wenn der Benutzer erfolgreich gestoppt wurde. |
Stoppuser
public abstract boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Stoppen Sie einen bestimmten Benutzer. Es ist möglich, zusätzliche Flags bereitzustellen, um auf die Wirkung des Betriebs zu warten und den Benutzer zu beenden. Der Strom- und Systembenutzer kann nicht gestoppt werden.
Parameter |
---|
userId | int : vom Benutzer zum Anhalten. |
waitFlag | boolean : Lassen Sie den Befehl warten, bis der Benutzer gestoppt wird. |
forceFlag | boolean : Wird zwingen, den Benutzer zu stoppen. |
Kehrt zurück |
---|
boolean | Richtig, wenn der Benutzer erfolgreich gestoppt wurde. |
Benutzer wechseln
public abstract boolean switchUser (int userId)
Wechseln Sie mit einem Standard -Timeout zu einer anderen Benutzer -ID. switchUser(int, long)
.
Kehrt zurück |
---|
boolean | Richtig, wenn der neue BenutzerID mit dem Benutzer -ID -Anbieter übereinstimmt. Ansonsten falsch. |
Benutzer wechseln
public abstract boolean switchUser (int userId,
long timeout)
Wechseln Sie zu einer anderen Benutzer -ID mit der bereitgestellten Zeitlimit als Frist. Versuch, KeyGuard zu deaktivieren, nachdem die Änderung der Benutzer erfolgreich ist.
Parameter |
---|
userId | int |
timeout | long : Warten Sie, bevor Sie für den Switch-Benutzer falsch zurückkehren, fehlgeschlagen. |
Kehrt zurück |
---|
boolean | Richtig, wenn der neue BenutzerID mit dem Benutzer -ID -Anbieter übereinstimmt. Ansonsten falsch. |
takeBugreteport
public abstract Bugreport takeBugreport ()
Nehmen Sie einen Bugreport und geben Sie es in ein Bugreport
-Objekt zurück, um es zu handhaben. Rückgabe null im Falle eines Problems. Die im Bugreport -Objekt verwiesene Datei muss über Bugreport.close()
gereinigt werden.
Deinstallpackage
public abstract String uninstallPackage (String packageName)
Deinstallieren Sie ein Android -Paket vom Gerät.
Parameter |
---|
packageName | String : Das Android -Paket zu deinstallieren |
Kehrt zurück |
---|
String | eine String mit einem Fehlercode oder null , wenn Erfolg. |
DeinstallpackageForuser
public abstract String uninstallPackageForUser (String packageName,
int userId)
Deinstallieren Sie ein Android -Paket vom Gerät für einen bestimmten Benutzer.
Parameter |
---|
packageName | String : Das Android -Paket zu deinstallieren |
userId | int : Die Ganzzahl -Benutzer -ID für deinstallieren. |
Kehrt zurück |
---|
String | eine String mit einem Fehlercode oder null , wenn Erfolg. |
WaitForsnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
Wenn erwartet, warten Sie, bis Snapuserd abgeschlossen ist.
Parameter |
---|
currentPhase | SnapuserdWaitPhase |
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2024-04-02 (UTC).
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"Benötigte Informationen nicht gefunden"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"Zu umständlich/zu viele Schritte"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"Nicht mehr aktuell"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"Problem mit der Übersetzung"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"Problem mit Beispielen/Code"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Sonstiges"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Leicht verständlich"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Mein Problem wurde gelöst"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Sonstiges"
}]
{
"last_modified": "Zuletzt aktualisiert: 2024-04-02 (UTC).",
"state": ""
}