Wiederholt Gerätebefehle für eine konfigurierbare Menge 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 Einhängepunkt |
Öffentliche Methoden |
---|
abstract boolean | canSwitchToHeadlessSystemUser () Gibt zurück, ob es erlaubt ist, zum kopflosen SYSTEM-Benutzer zu wechseln. |
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 Geräte-UI angezeigt werden. |
abstract void | clearLastConnectedWifiNetwork () Löscht das zuletzt verbundene WLAN-Netzwerk. |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) Stellt eine Verbindung zu einem WLAN-Netzwerk her. |
abstract boolean | connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk) Stellt eine Verbindung zu einem WLAN-Netzwerk her. |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk) Stellt eine Verbindung zu einem WLAN-Netzwerk her. |
abstract boolean | connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid) Stellt eine Verbindung zu einem WLAN-Netzwerk her. |
abstract boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid) Eine Variante von connectToWifiNetwork(String, String) , die nur eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat. |
abstract boolean | connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk) Eine Variante von connectToWifiNetwork(String, String) , die nur eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat. |
abstract int | createUser (String name) Erstellen Sie einen Benutzer mit einem bestimmten Namen und Standard-Flags 0. |
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 | createUser (String name, boolean guest, boolean ephemeral) 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 Standard-Flags 0. |
abstract void | deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver) Entfernt den registrierten IDeviceActionReceiver . |
abstract void | disableKeyguard () Versucht, die Tastensperre 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 eine Datei auf dem Gerät für einen bestimmten Benutzer vorhanden ist. |
abstract File | dumpHeap (String process, String devicePath) Versuchen Sie, den Heap vom system_server auszugeben. |
abstract boolean | enableNetworkMonitor () Aktiviert die Netzwerküberwachung auf dem Gerät. |
abstract | getActiveApexes () Rufen Sie die Informationen zu APEXs ab, die auf dem Gerät aktiviert sind. |
abstract | getAllSettings (String namespace) Geben Sie Schlüsselwertpaare des angeforderten Namespace zurück. |
abstract String | getAndroidId (int userId) Suchen Sie die Android-ID, die einer Benutzer-ID zugeordnet ist, und geben Sie sie zurück, null, wenn sie nicht gefunden wird. |
abstract | getAndroidIds () Erstellen Sie eine Karte mit Android-IDs, die übereinstimmende Benutzer-IDs gefunden haben. |
abstract PackageInfo | getAppPackageInfo (String packageName) Abrufen von Informationen zu einem auf dem Gerät installierten Paket. |
abstract | getAppPackageInfos () Abrufen von Informationen zu Paketen, die auf dem Gerät installiert sind. |
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 oder null zurück, wenn einige Probleme aufgetreten sind. |
abstract int | getCurrentUser () Gibt die ID des aktuell ausgeführten 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 () Geben Sie ein Objekt zurück, um den aktuellen Zustand des Keyguards abzurufen, oder null, wenn es nicht unterstützt wird. |
abstract Integer | getMainUserId () Gibt die Hauptbenutzer-ID zurück. |
abstract | getMainlineModuleInfo () Informieren Sie sich über die auf dem Gerät installierten Mainline-Module. |
abstract int | getMaxNumberOfRunningUsersSupported () Holen Sie sich die maximale Anzahl unterstützter gleichzeitig laufender Benutzer. |
abstract int | getMaxNumberOfUsersSupported () Holen Sie sich 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 () Schnappt sich einen Screenshot vom Gerät. |
abstract InputStreamSource | getScreenshot (String format, boolean rescale) Schnappt sich einen Screenshot vom Gerät. |
abstract InputStreamSource | getScreenshot (String format) Schnappt sich einen Screenshot vom Gerät. |
abstract InputStreamSource | getScreenshot (long displayId) Erfasst einen Screenshot von dem Gerät mit der angegebenen Anzeige-ID. |
abstract String | getSetting (String namespace, String key) Siehe getSetting(int, String, String) und ausgeführt am Systembenutzer. |
abstract String | getSetting (int userId, String namespace, String key) Gibt den Wert der angeforderten Einstellung zurück. |
abstract | getUninstallablePackageNames () Rufen Sie die Anwendungspaketnamen 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 Seriennummer zurück, die der Benutzer-ID zugeordnet ist, 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, boolean grantPermissions, 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, 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 ein zusätzliches Split-Paket). |
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 (ein Haupt- und ein zusätzliches Split-Paket) besteht, die sich auf dem Android-Gerät befinden. |
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 (ein Haupt- und ein zusätzliches Split-Paket) besteht. |
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 (ein Haupt- und ein zusätzliches 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 (ein Haupt- und ein zusätzliches 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 (ein Haupt- und ein zusätzliches Split-Paket) besteht, die sich auf dem Android-Gerät befinden. |
abstract boolean | isHeadlessSystemUserMode () Gibt zurück, ob das Gerät den kopflosen Systembenutzermodus verwendet. |
abstract boolean | isMainUserPermanentAdmin () Gibt zurück, ob der Hauptbenutzer ein permanenter Administrator ist und nicht gelöscht oder auf den Nicht-Administratorstatus heruntergestuft werden kann. |
abstract boolean | isMultiUserSupported () Legt fest, ob mehrere Benutzer unterstützt werden. |
abstract boolean | isPackageInstalled (String packageName) Fragen Sie das Gerät nach einem bestimmten Paketnamen ab, um zu überprüfen, ob es derzeit installiert ist oder nicht. |
abstract boolean | isPackageInstalled (String packageName, String userId) Fragen Sie das Gerät nach einem bestimmten Paketnamen und einer bestimmten Benutzer-ID ab, um zu überprüfen, ob es derzeit für diesen Benutzer 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 erlaubt, dass Benutzer im Hintergrund im ERROR(/java.android.view.Display#DEFAULT_DISPLAY) sichtbar gestartet werden. |
abstract boolean | isVisibleBackgroundUsersSupported () Gibt zurück, ob das Gerät erlaubt, dass Benutzer im Hintergrund sichtbar gestartet werden. |
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 verwendet werden können, um start a user visible in the background . |
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 den Meldern zu melden. |
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 dies erfolgreich war, andernfalls false . |
abstract void | removeOwners () Entfernen Sie alle vorhandenen Besitzer von Geräteprofilen nach besten Kräften. |
abstract boolean | removeUser (int userId) Entfernen Sie einen bestimmten Benutzer vom Gerät. |
abstract boolean | setDeviceOwner (String componentName, int userId) Legen Sie eine Geräteverwaltungskomponente als Geräteeigentümer in einem bestimmten Benutzer fest. |
abstract void | setSetting (String namespace, String key, String value) Siehe setSetting(int, String, String, String) und wird vom 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 gegebenen Benutzer im Hintergrund, sichtbar in der gegebenen Anzeige (dh erlaubt dem Benutzer, Aktivitäten in dieser Anzeige zu starten). |
abstract boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) Stoppen Sie einen bestimmten Benutzer. |
abstract boolean | stopUser (int userId) Stoppt einen bestimmten Benutzer. |
abstract boolean | switchUser (int userId) Wechseln Sie zu einer anderen Benutzer-ID mit einem Standardzeitlimit. |
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 innerhalb eines Bugreport Objekts zurück, um ihn zu behandeln. |
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. |
Öffentliche Methoden
canSwitchToHeadlessSystemUser
public abstract boolean canSwitchToHeadlessSystemUser ()
Gibt zurück, ob es erlaubt ist, zum kopflosen SYSTEM-Benutzer zu wechseln.
Konnektivität prüfen
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 eine funktionierende Netzwerkverbindung hat, ansonsten false . |
clearErrorDialogs
public abstract boolean clearErrorDialogs ()
Versuchen Sie, alle Fehlerdialoge zu schließen, die derzeit auf der Geräte-UI angezeigt werden.
Kehrt zurück |
---|
boolean | true , wenn keine Dialoge vorhanden waren oder Dialoge erfolgreich gelöscht wurden. false sonst. |
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 mit dem im vorherigen Test verwendeten WLAN-Netzwerk hergestellt wird.
ConnectToWifiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk,
boolean scanSsid)
Stellt eine Verbindung zu einem WLAN-Netzwerk her.
Schaltet WLAN ein und blockiert, bis eine erfolgreiche Verbindung mit einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke hergestellt wurde. Sobald eine Verbindung hergestellt ist, versucht die Instanz, die Verbindung nach jedem Neustart 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 erfolgreich mit dem WLAN-Netzwerk verbunden. false sonst |
ConnectToWifiNetwork
public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)
Stellt eine Verbindung zu einem WLAN-Netzwerk her.
Schaltet WLAN ein und blockiert, bis eine erfolgreiche Verbindung mit einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke hergestellt wurde. Sobald eine Verbindung hergestellt ist, versucht die Instanz, die Verbindung nach jedem Neustart 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 erfolgreich mit dem WLAN-Netzwerk verbunden. false sonst |
ConnectToWifiNetwork
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk)
Stellt eine Verbindung zu einem WLAN-Netzwerk her.
Schaltet WLAN ein und blockiert, bis eine erfolgreiche Verbindung zum angegebenen WLAN-Netzwerk hergestellt wurde. Sobald eine Verbindung hergestellt ist, 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 unverschlüsselt |
Kehrt zurück |
---|
boolean | true , wenn erfolgreich mit dem WLAN-Netzwerk verbunden. false sonst |
ConnectToWifiNetwork
public abstract boolean connectToWifiNetwork (String wifiSsid,
String wifiPsk,
boolean scanSsid)
Stellt eine Verbindung zu einem WLAN-Netzwerk her.
Schaltet WLAN ein und blockiert, bis eine erfolgreiche Verbindung zum angegebenen WLAN-Netzwerk hergestellt wurde. Sobald eine Verbindung hergestellt ist, 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 unverschlüsselt |
scanSsid | boolean : ob nach versteckten SSIDs für dieses Netzwerk gesucht werden soll. |
Kehrt zurück |
---|
boolean | true , wenn erfolgreich mit dem WLAN-Netzwerk verbunden. false sonst |
ConnectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk,
boolean scanSsid)
Eine Variante von connectToWifiNetwork(String, String)
, die nur eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.
Parameter |
---|
scanSsid | boolean : ob nach versteckten SSIDs für dieses Netzwerk gesucht werden soll |
Kehrt zurück |
---|
boolean | true , wenn erfolgreich mit dem WLAN-Netzwerk verbunden. false sonst |
ConnectToWifiNetworkIfNeeded
public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid,
String wifiPsk)
Eine Variante von connectToWifiNetwork(String, String)
, die nur eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.
Kehrt zurück |
---|
boolean | true , wenn erfolgreich mit dem WLAN-Netzwerk verbunden. false sonst |
Benutzer erstellen
public abstract int createUser (String name)
Erstellen Sie einen Benutzer mit einem bestimmten Namen und Standard-Flags 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 |
Benutzer erstellen
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 : Aktivieren Sie das Benutzer-Flag --guest während der Erstellung |
ephemeral | boolean : Aktivieren Sie das Benutzer-Flag --ephemeral während der Erstellung |
forTesting | boolean : Aktivieren Sie das Test-Flag --for-testing während der Erstellung |
Kehrt zurück |
---|
int | ID des erstellten Benutzers |
Benutzer erstellen
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 : Aktivieren Sie das Benutzer-Flag --guest während der Erstellung |
ephemeral | boolean : Aktivieren Sie das Benutzer-Flag --ephemeral 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 Standard-Flags 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. |
disableKeyguard
public abstract void disableKeyguard ()
Versucht, die Tastensperre zu deaktivieren.
Warten Sie zunächst, bis der Input-Dispatch bereit ist. Dies geschieht ungefähr zur gleichen Zeit, wenn das Gerät BOOT_COMPLETE meldet, anscheinend asynchron, da die aktuelle Framework-Implementierung gelegentlich eine Race-Bedingung aufweist. Dann wird der Befehl gesendet, die Tastensperre zu schließen (funktioniert nur bei nicht sicheren).
Netzwerkmonitor deaktivieren
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. |
trennenVonWifi
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 eine Datei auf dem Gerät für einen bestimmten Benutzer vorhanden ist.
Parameter |
---|
deviceFilePath | String : Der absolute Pfad der Datei auf dem zu prüfenden Gerät |
userId | int : Die Benutzer-ID, anhand derer das Vorhandensein der Datei überprüft werden soll |
Kehrt zurück |
---|
boolean | true , wenn die Datei existiert, andernfalls false . |
dumpHeap
public abstract File dumpHeap (String process,
String devicePath)
Versuchen Sie, den Heap vom system_server auszugeben. Es liegt in der Verantwortung des Aufrufers, die ausgegebene Datei zu bereinigen.
Parameter |
---|
process | String : Der Name des Geräteprozesses für den Dumpheap. |
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 APEXs ab, die auf dem Gerät aktiviert sind.
getAllSettings
public abstract getAllSettings (String namespace)
Geben Sie Schlüsselwertpaare des angeforderten Namespace zurück.
Parameter |
---|
namespace | String : muss einer der folgenden sein: {"system", "secure", "global"} |
Kehrt zurück |
---|
| die Karte der Schlüssel-Wert-Paare. Null, wenn Namespace nicht unterstützt wird. |
getAndroidId
public abstract String getAndroidId (int userId)
Suchen Sie die Android-ID, die einer Benutzer-ID zugeordnet ist, und geben Sie sie zurück, null, wenn sie nicht gefunden wird.
getAndroidIds
public abstract getAndroidIds ()
Erstellen Sie eine Karte mit Android-IDs, die übereinstimmende Benutzer-IDs gefunden haben. Es gibt keine Garantie dafür, dass jede Benutzer-ID eine mit dieser Funktion verknüpfte Android-ID findet, daher können einige Benutzer-IDs mit null übereinstimmen.
Kehrt zurück |
---|
| Karte von Android-IDs, die übereinstimmende Benutzer-IDs gefunden haben. |
getAppPackageInfo
public abstract PackageInfo getAppPackageInfo (String packageName)
Abrufen von Informationen zu einem auf dem Gerät installierten Paket.
Parameter |
---|
packageName | String |
getAppPackageInfos
public abstract getAppPackageInfos ()
Abrufen von Informationen zu Paketen, die auf dem Gerät installiert sind.
Fehlerbericht abrufen
public abstract InputStreamSource getBugreport ()
Ruft einen Fehlerbericht vom Gerät ab.
Die Implementierung funktioniert garantiert auch auf einem Gerät ohne SD-Karte (oder wo die SD-Karte noch nicht gemountet ist).
getBugreportz
public abstract InputStreamSource getBugreportz ()
Ruft einen Fehlerbericht vom Gerät ab. Fehlerbericht im Zip-Format enthält den Hauptfehlerbericht und andere Protokolldateien, die für die Fehlersuche nützlich sind.
Nur unterstützt für „adb-Version“ > 1.0.36
getCurrentFoldableState
public abstract DeviceFoldableState getCurrentFoldableState ()
Gibt den aktuellen faltbaren Zustand des Geräts oder null zurück, wenn einige Probleme aufgetreten sind.
getCurrentUser
public abstract int getCurrentUser ()
Gibt die ID des aktuell ausgeführten 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.
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 ()
Geben Sie ein Objekt zurück, um den aktuellen Zustand des Keyguards abzurufen, oder null, wenn es nicht unterstützt wird.
getMainUserId
public abstract Integer getMainUserId ()
Gibt die Hauptbenutzer-ID zurück.
Kehrt zurück |
---|
Integer | die userId des Hauptbenutzers, falls vorhanden, und null, wenn es keinen Hauptbenutzer gibt. |
getMainlineModuleInfo
public abstract getMainlineModuleInfo ()
Informieren Sie sich über die auf dem Gerät installierten Mainline-Module.
public abstract int getMaxNumberOfRunningUsersSupported ()
Holen Sie sich die maximale Anzahl unterstützter gleichzeitig laufender Benutzer. Standardmäßig 0.
Kehrt zurück |
---|
int | eine Ganzzahl, die die Anzahl der gleichzeitig laufenden Benutzer angibt |
public abstract int getMaxNumberOfUsersSupported ()
Holen Sie sich die maximale Anzahl unterstützter Benutzer. Standardmäßig 0.
Kehrt zurück |
---|
int | eine Ganzzahl, die die Anzahl der unterstützten Benutzer angibt |
getOptionen
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 userId des primären Benutzers, falls vorhanden, und null, wenn es keinen primären Benutzer gibt. |
Screenshot abrufen
public abstract InputStreamSource getScreenshot ()
Schnappt sich einen Screenshot vom Gerät.
Screenshot abrufen
public abstract InputStreamSource getScreenshot (String format,
boolean rescale)
Schnappt sich einen Screenshot vom Gerät. Es wird empfohlen, stattdessen getScreenshot(String)
mit JPEG-Codierung 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 verringern |
Screenshot abrufen
public abstract InputStreamSource getScreenshot (String format)
Schnappt sich einen Screenshot vom Gerät. Es wird empfohlen, stattdessen getScreenshot(format) mit JPEG-Codierung für eine kleinere Größe zu verwenden
Parameter |
---|
format | String : unterstütztes PNG, JPEG |
Screenshot abrufen
public abstract InputStreamSource getScreenshot (long displayId)
Erfasst einen Screenshot von dem Gerät mit der angegebenen Anzeige-ID. Format ist PNG.
TODO: Erweitern Sie die obigen Implementierungen, um „formatieren“ und „neu skalieren“ zu unterstützen.
Parameter |
---|
displayId | long : die Anzeige-ID des Bildschirms, von dem ein Screenshot abgerufen werden soll. |
getSetting
public abstract String getSetting (String namespace,
String key)
Siehe getSetting(int, String, String)
und ausgeführt am Systembenutzer.
Parameter |
---|
namespace | String |
key | String |
getSetting
public abstract String getSetting (int userId,
String namespace,
String key)
Gibt den Wert der angeforderten Einstellung zurück. Namespace muss einer der folgenden sein: {"system", "secure", "global"}
Parameter |
---|
userId | int |
namespace | String |
key | String |
Kehrt zurück |
---|
String | der Wert, der dem namespace:key eines Benutzers zugeordnet ist. Null, wenn nicht gefunden. |
getUninstallablePackageNames
public abstract getUninstallablePackageNames ()
Rufen Sie die Anwendungspaketnamen ab, die deinstalliert werden können. Dies wird derzeit als Nicht-Systempakete und aktualisierte Systempakete definiert.
getUserFlags
public abstract int getUserFlags (int userId)
Suchen Sie die Flags eines bestimmten Benutzers und geben Sie sie zurück. Flags sind in der Klasse „android.content.pm.UserInfo“ im Android Open Source Project definiert.
Kehrt zurück |
---|
int | die Flags, die der bereitgestellten Benutzer-ID zugeordnet sind, falls gefunden, -10000 in allen anderen Fällen. |
Benutzerinfos abrufen
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. |
Wirft |
---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException | |
getUserSerialNumber
public abstract int getUserSerialNumber (int userId)
Gibt die Seriennummer zurück, die der Benutzer-ID zugeordnet ist, falls gefunden, -10000 in allen anderen Fällen.
hatFeature
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: " oder " " direkt. |
Kehrt zurück |
---|
boolean | True, wenn 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, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen. |
Kehrt zurück |
---|
String | ein ERROR(/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 zum Zeitpunkt der Installation 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, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen. |
Kehrt zurück |
---|
String | ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg. |
Wirft |
---|
DeviceNotAvailableException | wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann. |
| wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird. |
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 Erteilung von Laufzeitberechtigungen zum Zeitpunkt der Installation 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, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen. |
Kehrt zurück |
---|
String | ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg. |
Wirft |
---|
DeviceNotAvailableException | wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann. |
| 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, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen. |
Kehrt zurück |
---|
String | ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg. |
Pakete installieren
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien besteht (ein Haupt- und ein zusätzliches Split-Paket). Siehe "https://developer.android.com/studio/build/configure-apk-splits", um zu erfahren, wie man apk in mehrere Dateien aufteilt.
Parameter |
---|
packageFiles | : die lokalen APK-Dateien |
reinstall | boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
extraArgs | String : optionale zusätzliche Argumente, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen. |
Kehrt zurück |
---|
String | ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg. |
Wirft |
---|
DeviceNotAvailableException | wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann. |
| wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird. |
Pakete installieren
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien (ein Haupt- und ein zusätzliches Split-Paket) besteht, die sich auf dem Android-Gerät befinden. Siehe "https://developer.android.com/studio/build/configure-apk-splits", um zu erfahren, wie man apk in mehrere Dateien aufteilt.
Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Erteilung von Laufzeitberechtigungen zum Zeitpunkt der Installation 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, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen. |
Kehrt zurück |
---|
String | ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg. |
Wirft |
---|
DeviceNotAvailableException | wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann. |
| 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 (ein Haupt- und ein zusätzliches Split-Paket) besteht. Siehe "https://developer.android.com/studio/build/configure-apk-splits", um zu erfahren, wie man apk in mehrere Dateien aufteilt.
Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Erteilung von Laufzeitberechtigungen zum Zeitpunkt der Installation 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, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen. |
Kehrt zurück |
---|
String | ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg. |
Wirft |
---|
DeviceNotAvailableException | wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann. |
| 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 (ein Haupt- und ein zusätzliches Split-Paket) besteht. Siehe "https://developer.android.com/studio/build/configure-apk-splits", um zu erfahren, wie man apk in mehrere Dateien aufteilt.
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, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen. |
Kehrt zurück |
---|
String | ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg. |
Wirft |
---|
DeviceNotAvailableException | wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann. |
| 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 (ein Haupt- und ein zusätzliches Split-Paket) besteht, die sich auf dem Android-Gerät befinden. Siehe "https://developer.android.com/studio/build/configure-apk-splits", um zu erfahren, wie man apk in mehrere Dateien aufteilt.
Parameter |
---|
remoteApkPaths | : die Remote-APK-Dateipfade |
reinstall | boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
extraArgs | String : optionale zusätzliche Argumente, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen. |
Kehrt zurück |
---|
String | ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg. |
Wirft |
---|
DeviceNotAvailableException | wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann. |
| 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 (ein Haupt- und ein zusätzliches Split-Paket) besteht, die sich auf dem Android-Gerät befinden. Siehe "https://developer.android.com/studio/build/configure-apk-splits", um zu erfahren, wie man apk in mehrere Dateien aufteilt.
Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Erteilung von Laufzeitberechtigungen zum Zeitpunkt der Installation 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, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen. |
Kehrt zurück |
---|
String | ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg. |
Wirft |
---|
DeviceNotAvailableException | wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann. |
| wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird. |
istHeadlessSystemUserMode
public abstract boolean isHeadlessSystemUserMode ()
Gibt zurück, ob das Gerät den kopflosen Systembenutzermodus verwendet.
istMainUserPermanentAdmin
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.
wird von mehreren Benutzern unterstützt
public abstract boolean isMultiUserSupported ()
Legt fest, ob mehrere Benutzer unterstützt werden.
Kehrt zurück |
---|
boolean | true, wenn mehrere Benutzer unterstützt werden, andernfalls false |
isPackageInstalled
public abstract boolean isPackageInstalled (String packageName)
Fragen Sie das Gerät nach einem bestimmten Paketnamen ab, um zu überprü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. |
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 überprü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 das Paket überprüfen, ist installiert. Wenn null, wird der primäre Benutzer null verwendet. |
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 ausgeführt wird, 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 sekundär 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 (typischerweise 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 |
istWifiEnabled
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 sollen, 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 verwendet werden können, um start a user visible in the background
.
listBenutzer
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. |
Wirft |
---|
| com.android.tradefed.device.DeviceNotAvailableException |
| com.android.tradefed.device.DeviceRuntimeException |
DeviceNotAvailableException | |
logFehlerbericht
public abstract boolean logBugreport (String dataName,
ITestLogger listener)
Hilfsmethode, um einen Fehlerbericht aufzunehmen und ihn den Meldern zu melden.
Parameter |
---|
dataName | String : Name, unter dem der Fehlerbericht gemeldet wird. |
listener | ITestLogger : ein ITestLogger zum Protokollieren des Fehlerberichts. |
Kehrt zurück |
---|
boolean | True, wenn die Protokollierung erfolgreich war, andernfalls false. |
registerDeviceActionReceiver
public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)
Registriert einen IDeviceActionReceiver
für dieses Gerät.
Alle registrierten IDeviceActionReceiver
s werden benachrichtigt, bevor eine Geräteaktion beginnt und nachdem die Geräteaktion endet.
entfernenAdmin
public abstract boolean removeAdmin (String componentName,
int userId)
Entfernen Sie den angegebenen Geräteadministrator im angegebenen Benutzer und geben Sie true
zurück, wenn dies erfolgreich war, andernfalls false
.
Parameter |
---|
componentName | String : des zu entfernenden Geräteadministrators. |
userId | int : des Benutzers, in dem der Geräteadministrator lebt. |
Kehrt zurück |
---|
boolean | True, wenn es erfolgreich ist, andernfalls false. |
Eigentümer entfernen
public abstract void removeOwners ()
Entfernen Sie alle vorhandenen Besitzer von Geräteprofilen nach besten Kräften.
Benutzer entfernen
public abstract boolean removeUser (int userId)
Entfernen Sie einen bestimmten Benutzer vom Gerät.
Parameter |
---|
userId | int : des zu entfernenden Benutzers |
Kehrt zurück |
---|
boolean | true, wenn wir den Benutzer erfolgreich entfernen konnten, andernfalls false. |
setDeviceOwner
public abstract boolean setDeviceOwner (String componentName,
int userId)
Legen Sie eine Geräteverwaltungskomponente als Geräteeigentümer in einem bestimmten Benutzer fest.
Parameter |
---|
componentName | String : des Geräteadministrators, der Gerätebesitzer sein soll. |
userId | int : des Benutzers, in dem der Gerätebesitzer lebt. |
Kehrt zurück |
---|
boolean | True, wenn es erfolgreich ist, andernfalls false. |
setSetting
public abstract void setSetting (String namespace,
String key,
String value)
Siehe setSetting(int, String, String, String)
und wird vom Systembenutzer ausgeführt.
Parameter |
---|
namespace | String |
key | String |
value | String |
setSetting
public abstract void setSetting (int userId,
String namespace,
String key,
String value)
Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}
Parameter |
---|
userId | int |
namespace | String |
key | String |
value | String |
startUser
public abstract boolean startUser (int userId)
Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.
Parameter |
---|
userId | int : of the user to start in the background |
Kehrt zurück |
---|
boolean | true if the user was successfully started in the background. |
startUser
public abstract boolean startUser (int userId,
boolean waitFlag)
Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.
Parameter |
---|
userId | int : of the user to start in the background |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
Kehrt zurück |
---|
boolean | true if the user was successfully started in the background. |
startVisibleBackgroundUser
public abstract boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).
NOTE: this command doesn't check if the user exists, display is available, device supports such feature
, etc.
Parameter |
---|
userId | int : of the user to start in the background |
displayId | int : display to start user visible on |
waitFlag | boolean : will make the command wait until user is started and unlocked. |
Kehrt zurück |
---|
boolean | true if the user was successfully started visible in the background. |
stopUser
public abstract boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.
Parameter |
---|
userId | int : of the user to stop. |
waitFlag | boolean : will make the command wait until user is stopped. |
forceFlag | boolean : will force stop the user. |
Kehrt zurück |
---|
boolean | true if the user was successfully stopped. |
stopUser
public abstract boolean stopUser (int userId)
Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.
Parameter |
---|
userId | int : of the user to stop. |
Kehrt zurück |
---|
boolean | true if the user was successfully stopped. |
switchUser
public abstract boolean switchUser (int userId)
Switch to another userId with a default timeout. switchUser(int, long)
.
Kehrt zurück |
---|
boolean | True if the new userId matches the userId provider. False otherwise. |
switchUser
public abstract boolean switchUser (int userId,
long timeout)
Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.
Parameter |
---|
userId | int |
timeout | long : to wait before returning false for switch-user failed. |
Kehrt zurück |
---|
boolean | True if the new userId matches the userId provider. False otherwise. |
takeBugreport
public abstract Bugreport takeBugreport ()
Take a bugreport and returns it inside a Bugreport
object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close()
.
uninstallPackage
public abstract String uninstallPackage (String packageName)
Uninstall an Android package from device.
Parameter |
---|
packageName | String : the Android package to uninstall |
Kehrt zurück |
---|
String | a ERROR(/String) with an error code, or null if success. |
uninstallPackageForUser
public abstract String uninstallPackageForUser (String packageName,
int userId)
Uninstall an Android package from device for a given user.
Parameter |
---|
packageName | String : the Android package to uninstall |
userId | int : the integer user id to uninstall for. |
Kehrt zurück |
---|
String | a ERROR(/String) with an error code, or null if success. |
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: 2023-04-28 (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"
}]