Verschachtelte Klassen |
---|
class | TestDevice.MicrodroidBuilder Ein Builder zum Erstellen eines Microdroid-Testgeräts. |
Felder |
---|
public static final String | DISMISS_KEYGUARD_CMD Befehle, die verwendet werden können, um die Tastensperre zu schließen. |
Öffentliche Methoden |
---|
boolean | canSwitchToHeadlessSystemUser () Gibt zurück, ob es erlaubt ist, zum kopflosen SYSTEM-Benutzer zu wechseln. |
boolean | clearErrorDialogs () Versuchen Sie, alle Fehlerdialoge zu schließen, die derzeit auf der Geräte-UI angezeigt werden. |
int | createUser (String name) Erstellen Sie einen Benutzer mit einem bestimmten Namen und Standard-Flags 0. |
int | createUser (String name, boolean guest, boolean ephemeral, boolean forTesting) Erstellen Sie einen Benutzer mit einem bestimmten Namen und den bereitgestellten Flags |
int | createUser (String name, boolean guest, boolean ephemeral) Erstellen Sie einen Benutzer mit einem bestimmten Namen und den bereitgestellten Flags |
int | createUserNoThrow (String name) Erstellen Sie einen Benutzer mit einem bestimmten Namen und Standard-Flags 0. |
void | disableKeyguard () Versucht, die Tastensperre zu deaktivieren. |
boolean | doesFileExist (String deviceFilePath) Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät vorhanden ist. |
boolean | doesFileExist (String deviceFilePath, int userId) Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät für einen bestimmten Benutzer vorhanden ist. |
File | dumpHeap (String process, String devicePath) Versuchen Sie, den Heap vom system_server auszugeben. |
| getActiveApexes () Rufen Sie die Informationen zu APEXs ab, die auf dem Gerät aktiviert sind. |
| getAllSettings (String namespace) Geben Sie Schlüsselwertpaare des angeforderten Namespace zurück. |
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 () Erstellen Sie eine Karte mit Android-IDs, die übereinstimmende Benutzer-IDs gefunden haben. |
PackageInfo | getAppPackageInfo (String packageName) Abrufen von Informationen zu einem auf dem Gerät installierten Paket. |
| getAppPackageInfos () Abrufen von Informationen zu Paketen, die auf dem Gerät installiert sind. |
InputStreamSource | getBugreport () Ruft einen Fehlerbericht vom Gerät ab. |
InputStreamSource | getBugreportz () Ruft einen Fehlerbericht vom Gerät ab. |
DeviceFoldableState | getCurrentFoldableState () Gibt den aktuellen faltbaren Zustand des Geräts oder null zurück, wenn einige Probleme aufgetreten sind. |
int | getCurrentUser () Gibt die ID des aktuell ausgeführten Benutzers zurück. |
| getFoldableStates () Gibt die Liste der faltbaren Zustände auf dem Gerät zurück. |
| getInstalledPackageNames () Rufen Sie die auf dem Gerät vorhandenen Anwendungspaketnamen ab. |
KeyguardControllerState | getKeyguardState () Geben Sie ein Objekt zurück, um den aktuellen Zustand des Keyguards abzurufen, oder null, wenn es nicht unterstützt wird. |
Integer | getMainUserId () Gibt die Hauptbenutzer-ID zurück. |
| getMainlineModuleInfo () Informieren Sie sich über die auf dem Gerät installierten Mainline-Module. |
int | getMaxNumberOfRunningUsersSupported () Holen Sie sich die maximale Anzahl unterstützter gleichzeitig laufender Benutzer. |
int | getMaxNumberOfUsersSupported () Holen Sie sich die maximale Anzahl unterstützter Benutzer. |
Integer | getPrimaryUserId () Gibt die primäre Benutzer-ID zurück. |
InputStreamSource | getScreenshot () Schnappt sich einen Screenshot vom Gerät. |
InputStreamSource | getScreenshot (String format, boolean rescale) Schnappt sich einen Screenshot vom Gerät. |
InputStreamSource | getScreenshot (String format) Schnappt sich einen Screenshot vom Gerät. |
InputStreamSource | getScreenshot (long displayId) Erfasst einen Screenshot von dem Gerät mit der angegebenen Anzeige-ID. |
String | getSetting (String namespace, String key) Siehe getSetting(int, String, String) und ausgeführt am Systembenutzer. |
String | getSetting (int userId, String namespace, String key) Gibt den Wert der angeforderten Einstellung zurück. |
| getUninstallablePackageNames () Rufen Sie die Anwendungspaketnamen ab, die deinstalliert werden können. |
int | getUserFlags (int userId) Suchen Sie die Flags eines bestimmten Benutzers und geben Sie sie zurück. |
| getUserInfos () Ruft die Zuordnung von useId zu UserInfo auf dem Gerät ab. |
int | getUserSerialNumber (int userId) Gibt die Seriennummer zurück, die der Benutzer-ID zugeordnet ist, falls gefunden, -10000 in allen anderen Fällen. |
boolean | hasFeature (String feature) Überprüfen Sie, ob eine Funktion auf einem Gerät verfügbar ist. |
String | installPackage (File packageFile, boolean reinstall, String... extraArgs) Installieren Sie ein Android-Paket auf dem Gerät. |
String | installPackage (File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Installieren Sie ein Android-Paket auf dem Gerät. |
String | installPackage (File packageFile, File certFile, boolean reinstall, String... extraArgs) Installieren Sie ein Android-Paket auf dem Gerät. |
String | installPackageForUser (File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Installieren Sie ein Android-Paket auf dem Gerät für einen bestimmten Benutzer. |
String | installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs) Installieren Sie ein Android-Paket auf dem Gerät für einen bestimmten Benutzer. |
String | installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs) |
String | installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) |
String | installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) |
String | installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) |
String | installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) |
String | installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) |
boolean | isAppEnumerationSupported () Überprüfen Sie, ob die Plattform auf dem Gerät die App-Aufzählung unterstützt |
boolean | isHeadlessSystemUserMode () Gibt zurück, ob das Gerät den kopflosen Systembenutzermodus verwendet. |
boolean | isMainUserPermanentAdmin () Gibt zurück, ob der Hauptbenutzer ein permanenter Administrator ist und nicht gelöscht oder auf den Nicht-Administratorstatus herabgestuft werden kann. |
boolean | isMultiUserSupported () Legt fest, ob mehrere Benutzer unterstützt werden. |
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. |
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. |
boolean | isUserRunning (int userId) Überprüfen Sie, ob ein bestimmter Benutzer ausgeführt wird. |
boolean | isUserSecondary (int userId) Gibt zurück, ob der angegebene Benutzer gemäß seinen Flags ein sekundärer Benutzer ist. |
boolean | isUserVisible (int userId) Überprüft, ob der angegebene Benutzer sichtbar ist. |
boolean | isUserVisibleOnDisplay (int userId, int displayId) Überprüft, ob der angegebene Benutzer in der angegebenen Anzeige sichtbar ist. |
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. |
boolean | isVisibleBackgroundUsersSupported () Gibt zurück, ob das Gerät erlaubt, dass Benutzer im Hintergrund sichtbar gestartet werden. |
| listDisplayIds () Sammeln Sie die Liste der verfügbaren Display-IDs auf dem Gerät, wie von „dumpsys SurfaceFlinger“ gemeldet. |
| listDisplayIdsForStartingVisibleBackgroundUsers () Ruft die Liste der Anzeigen ab, die verwendet werden können, um start a user visible in the background . |
| listUsers () Ruft die Liste der Benutzer auf dem Gerät ab. |
boolean | logBugreport (String dataName, ITestLogger listener) Hilfsmethode, um einen Fehlerbericht aufzunehmen und ihn den Meldern zu melden. |
void | postInvocationTearDown (Throwable exception) Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach Abschluss des Aufrufs ausgeführt werden. |
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 . |
void | removeOwners () Entfernen Sie alle vorhandenen Besitzer von Geräteprofilen nach besten Kräften. |
boolean | removeUser (int userId) Entfernen Sie einen bestimmten Benutzer vom Gerät. |
boolean | setDeviceOwner (String componentName, int userId) Legen Sie eine Geräteverwaltungskomponente als Geräteeigentümer in einem bestimmten Benutzer fest. |
void | setSetting (String namespace, String key, String value) Siehe setSetting(int, String, String, String) und wird vom Systembenutzer ausgeführt. |
void | setSetting (int userId, String namespace, String key, String value) Fügen Sie dem Namespace eines bestimmten Benutzers einen Einstellungswert hinzu. |
void | shutdownMicrodroid ( ITestDevice microdroidDevice) Fährt das Microdroid-Gerät herunter, falls vorhanden. |
boolean | startUser (int userId) Startet einen bestimmten Benutzer im Hintergrund, wenn er gerade gestoppt ist. |
boolean | startUser (int userId, boolean waitFlag) Startet einen bestimmten Benutzer im Hintergrund, wenn er gerade gestoppt ist. |
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). |
boolean | stopUser (int userId, boolean waitFlag, boolean forceFlag) Stoppen Sie einen bestimmten Benutzer. |
boolean | stopUser (int userId) Stoppt einen bestimmten Benutzer. |
boolean | supportsMicrodroid () Überprüft die Voraussetzungen zum Ausführen eines Microdroids. |
boolean | supportsMicrodroid (boolean protectedVm) Überprüft die Voraussetzungen zum Ausführen eines Microdroids. |
boolean | switchUser (int userId) Wechseln Sie zu einer anderen Benutzer-ID mit einem Standardzeitlimit. |
boolean | switchUser (int userId, long timeout) Wechseln Sie zu einer anderen Benutzer-ID mit dem angegebenen Timeout als Frist. |
Bugreport | takeBugreport () Nehmen Sie einen Bugreport und geben Sie ihn innerhalb eines Bugreport Objekts zurück, um ihn zu behandeln. |
String | uninstallPackage (String packageName) Deinstallieren Sie ein Android-Paket vom Gerät. |
String | uninstallPackageForUser (String packageName, int userId) Deinstallieren Sie ein Android-Paket vom Gerät für einen bestimmten Benutzer. |
Felder
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Befehle, die verwendet werden können, um die Tastensperre zu schließen.
Öffentliche Konstrukteure
Öffentliche Methoden
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Gibt zurück, ob es erlaubt ist, zum kopflosen SYSTEM-Benutzer zu wechseln.
clearErrorDialogs
public 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. |
Benutzer erstellen
public 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 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 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 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 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).
doesFileExist
public boolean doesFileExist (String deviceFilePath)
Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät vorhanden ist.
Parameter |
---|
deviceFilePath | String : Der absolute Pfad der Datei auf dem zu prüfenden Gerät |
Kehrt zurück |
---|
boolean | true , wenn die Datei existiert, andernfalls false . |
doesFileExist
public 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 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. |
getActiveApexes
public getActiveApexes ()
Rufen Sie die Informationen zu APEXs ab, die auf dem Gerät aktiviert sind.
getAllSettings
public 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 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 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 PackageInfo getAppPackageInfo (String packageName)
Abrufen von Informationen zu einem auf dem Gerät installierten Paket.
Parameter |
---|
packageName | String |
getAppPackageInfos
public getAppPackageInfos ()
Abrufen von Informationen zu Paketen, die auf dem Gerät installiert sind.
Fehlerbericht erhalten
public 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 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 DeviceFoldableState getCurrentFoldableState ()
Gibt den aktuellen faltbaren Zustand des Geräts oder null zurück, wenn einige Probleme aufgetreten sind.
getCurrentUser
public int getCurrentUser ()
Gibt die ID des aktuell ausgeführten Benutzers zurück. Im Fehlerfall -10000 zurückgeben.
getFoldableStates
public 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 getInstalledPackageNames ()
Rufen Sie die auf dem Gerät vorhandenen Anwendungspaketnamen ab.
getKeyguardState
public 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 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 getMainlineModuleInfo ()
Informieren Sie sich über die auf dem Gerät installierten Mainline-Module.
public 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 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 |
getPrimaryUserId
public 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 InputStreamSource getScreenshot ()
Schnappt sich einen Screenshot vom Gerät.
Screenshot abrufen
public 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 reduzieren |
Screenshot abrufen
public 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 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 String getSetting (String namespace,
String key)
Siehe getSetting(int, String, String)
und ausgeführt am Systembenutzer.
Parameter |
---|
namespace | String |
key | String |
getSetting
public 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 getUninstallablePackageNames ()
Rufen Sie die Anwendungspaketnamen ab, die deinstalliert werden können. Dies wird derzeit als Nicht-Systempakete und aktualisierte Systempakete definiert.
getUserFlags
public 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 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. |
getUserSerialNumber
public 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 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 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 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. |
Installationspaket
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
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 |
certFile | File : true wenn eine Neuinstallation durchgeführt werden soll |
reinstall | 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. |
installPackageForUser
public 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. |
installPackageForUser
public 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)
Parameter |
---|
packageFiles | |
reinstall | boolean |
extraArgs | String |
Pakete installieren
public String installPackages ( packageFiles,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Parameter |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
InstallPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Parameter |
---|
packageFiles | |
reinstall | boolean |
grantPermissions | boolean |
userId | int |
extraArgs | String |
InstallPackagesForUser
public String installPackagesForUser ( packageFiles,
boolean reinstall,
int userId,
String... extraArgs)
Parameter |
---|
packageFiles | |
reinstall | boolean |
userId | int |
extraArgs | String |
InstallRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
String... extraArgs)
Parameter |
---|
remoteApkPaths | |
reinstall | boolean |
extraArgs | String |
InstallRemotePackages
public String installRemotePackages ( remoteApkPaths,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Parameter |
---|
remoteApkPaths | |
reinstall | boolean |
grantPermissions | boolean |
extraArgs | String |
isAppEnumerationSupported
public boolean isAppEnumerationSupported ()
Überprüfen Sie, ob die Plattform auf dem Gerät die App-Aufzählung unterstützt
Kehrt zurück |
---|
boolean | True, wenn App-Enumeration unterstützt wird, andernfalls false |
istHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Gibt zurück, ob das Gerät den kopflosen Systembenutzermodus verwendet.
istMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Gibt zurück, ob der Hauptbenutzer ein permanenter Administrator ist und nicht gelöscht oder auf den Nicht-Administratorstatus heruntergestuft werden kann.
wird von mehreren Benutzern unterstützt
public 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 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 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 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 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 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 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 |
listDisplayIds
public 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 listDisplayIdsForStartingVisibleBackgroundUsers ()
Ruft die Liste der Anzeigen ab, die verwendet werden können, um start a user visible in the background
.
listBenutzer
public 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. |
logFehlerbericht
public 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. |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach Abschluss des Aufrufs ausgeführt werden.
Parameter |
---|
exception | Throwable : Falls vorhanden, die letzte Ausnahme, die durch den Aufruffehler ausgelöst wurde. |
entfernenAdmin
public 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 void removeOwners ()
Entfernen Sie alle vorhandenen Besitzer von Geräteprofilen nach besten Kräften.
Benutzer entfernen
public 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 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 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 void setSetting (int userId,
String namespace,
String key,
String value)
Fügen Sie dem Namespace eines bestimmten Benutzers einen Einstellungswert hinzu. Einige Einstellungen sind erst nach einem Neustart verfügbar. Namespace muss einer der folgenden sein: {"system", "secure", "global"}
Parameter |
---|
userId | int |
namespace | String |
key | String |
value | String |
ShutdownMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Fährt das Microdroid-Gerät herunter, falls vorhanden.
Parameter |
---|
microdroidDevice | ITestDevice |
startBenutzer
public boolean startUser (int userId)
Startet einen bestimmten Benutzer im Hintergrund, wenn er gerade gestoppt ist. Wenn der Benutzer bereits im Hintergrund läuft, ist diese Methode ein NOOP.
Parameter |
---|
userId | int : des Benutzers, der im Hintergrund gestartet werden soll |
Kehrt zurück |
---|
boolean | true, wenn der Benutzer erfolgreich im Hintergrund gestartet wurde. |
startBenutzer
public boolean startUser (int userId,
boolean waitFlag)
Startet einen bestimmten Benutzer im Hintergrund, wenn er gerade gestoppt ist. Wenn der Benutzer bereits im Hintergrund läuft, ist diese Methode ein NOOP. Es ist möglich, ein zusätzliches Flag bereitzustellen, um zu warten, bis die Operation wirksam wird.
Parameter |
---|
userId | int : des Benutzers, der im Hintergrund gestartet werden soll |
waitFlag | boolean : lässt den Befehl warten, bis der Benutzer gestartet und entsperrt wird. |
Kehrt zurück |
---|
boolean | true, wenn der Benutzer erfolgreich im Hintergrund gestartet wurde. |
startVisibleBackgroundUser
public 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).
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, der im Hintergrund gestartet werden soll |
displayId | int : Anzeige, um den Benutzer sichtbar zu starten |
waitFlag | boolean : lässt den Befehl warten, bis der Benutzer gestartet und entsperrt wird. |
Kehrt zurück |
---|
boolean | true , wenn der Benutzer erfolgreich im Hintergrund sichtbar gestartet wurde. |
Benutzer stoppen
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Stoppen Sie einen bestimmten Benutzer. Es ist möglich, zusätzliche Flags bereitzustellen, um darauf zu warten, dass die Operation wirksam wird, und das Beenden des Benutzers zu erzwingen. Der aktuelle Benutzer und der Systembenutzer können nicht gestoppt werden.
Parameter |
---|
userId | int : des zu stoppenden Benutzers. |
waitFlag | boolean : lässt den Befehl warten, bis der Benutzer gestoppt wird. |
forceFlag | boolean : erzwingt das Beenden des Benutzers. |
Kehrt zurück |
---|
boolean | true, wenn der Benutzer erfolgreich beendet wurde. |
Benutzer stoppen
public boolean stopUser (int userId)
Stoppt einen bestimmten Benutzer. Wenn der Benutzer bereits gestoppt ist, ist diese Methode ein NOOP. Der aktuelle Benutzer und der Systembenutzer können nicht gestoppt werden.
Parameter |
---|
userId | int : des zu stoppenden Benutzers. |
Kehrt zurück |
---|
boolean | true, wenn der Benutzer erfolgreich beendet wurde. |
unterstütztMicrodroid
public boolean supportsMicrodroid ()
Überprüft die Voraussetzungen zum Ausführen eines Microdroids.
Kehrt zurück |
---|
boolean | gibt true zurück, wenn die Vorbedingungen erfüllt sind, andernfalls false. |
unterstütztMicrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Überprüft die Voraussetzungen zum Ausführen eines Microdroids.
Parameter |
---|
protectedVm | boolean : true, wenn microdroid auf einer geschützten VM ausgeführt werden soll. |
Kehrt zurück |
---|
boolean | gibt true zurück, wenn die Vorbedingungen erfüllt sind, andernfalls false. |
Benutzer wechseln
public boolean switchUser (int userId)
Wechseln Sie zu einer anderen Benutzer-ID mit einem Standardzeitlimit. switchUser(int, long)
.
Kehrt zurück |
---|
boolean | True, wenn die neue Benutzer-ID mit dem Benutzer-ID-Anbieter übereinstimmt. Sonst falsch. |
Benutzer wechseln
public boolean switchUser (int userId,
long timeout)
Wechseln Sie zu einer anderen Benutzer-ID mit dem angegebenen Timeout als Frist. Versuchen Sie, die Tastensperre zu deaktivieren, nachdem der Benutzerwechsel erfolgreich war.
Parameter |
---|
userId | int |
timeout | long : warten, bevor false zurückgegeben wird, wenn switch-user fehlgeschlagen ist. |
Kehrt zurück |
---|
boolean | True, wenn die neue Benutzer-ID mit dem Benutzer-ID-Anbieter übereinstimmt. Sonst falsch. |
nimm Bugreport
public Bugreport takeBugreport ()
Nehmen Sie einen Bugreport und geben Sie ihn innerhalb eines Bugreport
Objekts zurück, um ihn zu behandeln. Geben Sie im Falle eines Problems null zurück. Dateien, auf die im Bugreport-Objekt verwiesen wird, müssen über Bugreport.close()
bereinigt werden.
Paket deinstallieren
public String uninstallPackage (String packageName)
Deinstallieren Sie ein Android-Paket vom Gerät.
Parameter |
---|
packageName | String : das zu deinstallierende Android-Paket |
Kehrt zurück |
---|
String | ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg. |
Paket für Benutzer deinstallieren
public String uninstallPackageForUser (String packageName,
int userId)
Deinstallieren Sie ein Android-Paket vom Gerät für einen bestimmten Benutzer.
Parameter |
---|
packageName | String : das zu deinstallierende Android-Paket |
userId | int : die ganzzahlige Benutzer-ID, für die deinstalliert werden soll. |
Kehrt zurück |
---|
String | ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg. |
Geschützte Methoden
createParser
protected AaptParser createParser (File appFile)
doAdbReboot
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
Führen Sie einen adb-Neustart durch.
Parameter |
---|
rebootMode | NativeDevice.RebootMode : ein Modus dieses Neustarts. |
reason | String : für diesen Neustart. |
getBugreportzInternal
protected File getBugreportzInternal ()
Interne Hilfsmethode zum Abrufen der Bugreportz-Zip-Datei als ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Zum Testen ausgesetzt.
getHostCurrentTime
protected long getHostCurrentTime ()
Zum Testen ausgesetzt
prePostBootSetup
protected void prePostBootSetup ()
Ermöglicht jedem Gerätetyp (AndroidNativeDevice, TestDevice), diese Methode für ein bestimmtes Post-Boot-Setup zu überschreiben.
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"
}]