TestDevice
public
class
TestDevice
extends NativeDevice
Bekannte direkte Unterklassen
ManagedRemoteDevice |
Ein Gerät, das in einer virtuellen Maschine ausgeführt wird, die wir per Fernzugriff über eine Tradefed-Instanz innerhalb der VM verwalten.
|
NestedRemoteDevice |
Darstellung des Geräts, das in einer Remote-Cuttlefish-VM ausgeführt wird.
|
RemoteAndroidDevice |
Implementierung einer ITestDevice für ein Full-Stack-Android-Gerät, das über adb connect verbunden ist.
|
|
Bekannte indirekte Unterklassen
|
Implementierung von ITestDevice
für ein Full-Stack-Android-Gerät
Zusammenfassung
Felder |
public
static
final
String |
DISMISS_KEYGUARD_CMD
Befehle, mit denen der Keyguard geschlossen werden kann.
|
Öffentliche Methoden |
boolean
|
canSwitchToHeadlessSystemUser()
Gibt an, ob der Wechsel zum headless SYSTEM-Nutzer zulässig ist.
|
boolean
|
clearErrorDialogs()
Schließen Sie alle Fehlerdialogfelder, die derzeit auf der Geräteoberfläche angezeigt werden.
|
int
|
createUser(String name)
Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
|
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen
|
int
|
createUser(String name, boolean guest, boolean ephemeral)
Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen
|
int
|
createUserNoThrow(String name)
Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
|
void
|
disableKeyguard()
Es wird versucht, den Keyguard zu deaktivieren.
|
boolean
|
doesFileExist(String deviceFilePath)
Hilfsmethode, um zu ermitteln, ob eine Datei auf dem Gerät vorhanden ist.
|
boolean
|
doesFileExist(String deviceFilePath, int userId)
Hilfsmethode, um zu ermitteln, ob eine Datei auf dem Gerät für einen bestimmten Nutzer vorhanden ist.
|
File
|
dumpHeap(String process, String devicePath)
Dump des Heaps vom system_server.
|
|
getActiveApexes()
Ruft die Informationen zu den auf dem Gerät aktivierten APEX-Objekten ab.
|
|
getAllSettings(String namespace)
Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück.
|
String
|
getAndroidId(int userId)
Die mit einer Nutzer-ID verknüpfte Android-ID suchen und zurückgeben. Wenn sie nicht gefunden wird, wird „null“ zurückgegeben.
|
|
getAndroidIds()
Erstellen Sie eine Zuordnungstabelle mit den gefundenen Android-IDs und den zugehörigen User-IDs.
|
PackageInfo
|
getAppPackageInfo(String packageName)
Informationen zu einem auf dem Gerät installierten Paket abrufen
|
|
getAppPackageInfos()
Ruft Informationen zu auf dem Gerät installierten Paketen ab.
|
InputStreamSource
|
getBugreport()
Ruft einen Fehlerbericht vom Gerät ab.
|
InputStreamSource
|
getBugreportz()
Ruft einen Fehlerbericht vom Gerät ab.
|
DeviceFoldableState
|
getCurrentFoldableState()
Gibt den aktuellen Faltstatus des Geräts zurück oder „null“, wenn Probleme aufgetreten sind.
|
int
|
getCurrentUser()
Gibt die ID des aktuell ausgeführten Nutzers zurück.
|
|
getFoldableStates()
Liste der Zustände des faltbaren Geräts zurückgeben
|
|
getInstalledPackageNames()
Ruft die Namen der Anwendungspakete auf dem Gerät ab.
|
KeyguardControllerState
|
getKeyguardState()
Gibt ein Objekt zurück, um den aktuellen Status des Keyguard oder null abzurufen, wenn dies nicht unterstützt wird.
|
Integer
|
getMainUserId()
Gibt die Hauptnutzer-ID zurück.
|
|
getMainlineModuleInfo()
Informationen zu den auf dem Gerät installierten Mainline-Modulen abrufen
|
int
|
getMaxNumberOfRunningUsersSupported()
Die maximale Anzahl der gleichzeitig unterstützten Nutzer abrufen
|
int
|
getMaxNumberOfUsersSupported()
Maximal unterstützte Nutzerzahl abrufen
|
Integer
|
getPrimaryUserId()
Gibt die primäre Nutzer-ID zurück.
|
InputStreamSource
|
getScreenshot()
Erstellt einen Screenshot vom Gerät.
|
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Erstellt einen Screenshot auf dem Gerät.
|
InputStreamSource
|
getScreenshot(long displayId)
Erfasst einen Screenshot vom Gerät mit der angegebenen Anzeige-ID.
|
InputStreamSource
|
getScreenshot(String format)
Erstellt einen Screenshot vom Gerät.
|
String
|
getSetting(String namespace, String key)
Siehe getSetting(int, String, String) und wird auf den Systemnutzer angewendet.
|
String
|
getSetting(int userId, String namespace, String key)
Gibt den Wert der angeforderten Einstellung zurück.
|
|
getUninstallablePackageNames()
Rufen Sie die App-Paketnamen ab, die deinstalliert werden können.
|
int
|
getUserFlags(int userId)
Die Markierungen eines bestimmten Nutzers finden und zurückgeben.
|
|
getUserInfos()
Ruft die Map of useId zu UserInfo auf dem Gerät ab.
|
int
|
getUserSerialNumber(int userId)
Gibt die Seriennummer zurück, die mit der userId verknüpft ist, falls gefunden, andernfalls -10000.
|
boolean
|
hasFeature(String feature)
Prüfen, 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)
Sie installieren ein Android-Paket für einen bestimmten Nutzer auf dem Gerät.
|
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer
|
String
|
installPackages( packageFiles, boolean reinstall, String... extraArgs)
|
String
|
installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
|
String
|
installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
|
String
|
installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)
|
String
|
installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs)
|
String
|
installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)
|
boolean
|
isAppEnumerationSupported()
Prüfen, ob die Plattform auf dem Gerät die App-Aufzählung unterstützt
|
boolean
|
isHeadlessSystemUserMode()
Gibt an, ob das Gerät den monitorlosen Systemnutzermodus verwendet.
|
boolean
|
isMainUserPermanentAdmin()
Gibt an, ob der Hauptnutzer ein dauerhafter Administrator ist und nicht gelöscht oder auf den Status „Kein Administrator“ herabgestuft werden kann.
|
boolean
|
isMultiUserSupported()
Bestimmt, ob die Nutzung durch mehrere Nutzer unterstützt wird.
|
boolean
|
isPackageInstalled(String packageName)
Das Gerät wird nach einem bestimmten Paketnamen abgefragt, um zu prüfen, ob es derzeit installiert ist.
|
boolean
|
isPackageInstalled(String packageName, String userId)
Das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID abfragen, um zu prüfen, ob es für diesen Nutzer derzeit installiert ist oder nicht.
|
boolean
|
isUserRunning(int userId)
Prüfen, ob ein bestimmter Nutzer aktiv ist
|
boolean
|
isUserSecondary(int userId)
Gibt an, ob der angegebene Nutzer gemäß seinen Flags ein sekundärer Nutzer ist.
|
boolean
|
isUserVisible(int userId)
Prüft, ob der angegebene Nutzer sichtbar ist.
|
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Prüft, ob der angegebene Nutzer auf dem Display sichtbar ist.
|
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Gibt an, ob Nutzer auf dem Gerät im ERROR(/java.android.view.Display#DEFAULT_DISPLAY) im Hintergrund gestartet werden können.
|
boolean
|
isVisibleBackgroundUsersSupported()
Gibt an, ob Nutzer auf dem Gerät im Hintergrund gestartet werden können.
|
|
listDisplayIds()
Liste der verfügbaren Display-IDs auf dem Gerät erfassen, wie von „dumpsys
SurfaceFlinger“ gemeldet
|
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Liste der Displays abrufen, die für start a user visible in the background verwendet werden können
|
|
listUsers()
Ruft die Liste der Nutzer auf dem Gerät ab.
|
boolean
|
logBugreport(String dataName, ITestLogger listener)
Hilfsmethode, um einen Fehlerbericht zu erstellen und bei den Reportern zu protokollieren.
|
void
|
notifySnapuserd(SnapuserdWaitPhase waitPhase)
|
void
|
postInvocationTearDown(Throwable exception)
Zusätzliche Schritte für die erforderliche gerätespezifische Bereinigung, die nach dem Aufruf ausgeführt wird.
|
boolean
|
removeAdmin(String componentName, int userId)
Entfernt den angegebenen Geräteadministrator beim angegebenen Nutzer und gibt true zurück, wenn der Vorgang erfolgreich war, andernfalls false .
|
void
|
removeOwners()
Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen nach Möglichkeit.
|
boolean
|
removeUser(int userId)
Einen bestimmten Nutzer vom Gerät entfernen
|
boolean
|
setDeviceOwner(String componentName, int userId)
Eine Geräteadministratorkomponente als Geräteinhaber für den angegebenen Nutzer festlegen
|
void
|
setSetting(String namespace, String key, String value)
Siehe setSetting(int, String, String, String) und wird bei einem Systemnutzer ausgeführt.
|
void
|
setSetting(int userId, String namespace, String key, String value)
Dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzufügen.
|
void
|
shutdownMicrodroid(ITestDevice microdroidDevice)
Das Microdroid-Gerät wird heruntergefahren, falls vorhanden.
|
boolean
|
startUser(int userId)
Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist.
|
boolean
|
startUser(int userId, boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist.
|
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, der auf dem entsprechenden Display sichtbar ist (d.h., der Nutzer kann Aktivitäten auf diesem Display starten).
|
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Stoppen Sie einen bestimmten Nutzer.
|
boolean
|
stopUser(int userId)
Stoppt einen bestimmten Nutzer.
|
boolean
|
supportsMicrodroid()
Prüft die Voraussetzungen zum Ausführen eines Mikrodroids.
|
boolean
|
supportsMicrodroid(boolean protectedVm)
Prüft die Voraussetzungen für die Ausführung eines Microdroids.
|
boolean
|
switchUser(int userId)
Zu einer anderen Nutzer-ID mit Standardzeitlimit wechseln.
|
boolean
|
switchUser(int userId, long timeout)
Wechseln Sie zu einer anderen Nutzer-ID mit dem angegebenen Zeitlimit als Frist.
|
Bugreport
|
takeBugreport()
Nimmt einen Fehlerbericht entgegen und gibt ihn in einem Bugreport -Objekt zurück, um ihn zu verarbeiten.
|
String
|
uninstallPackage(String packageName)
Deinstallation eines Android-Pakets vom Gerät
|
String
|
uninstallPackageForUser(String packageName, int userId)
Deinstallation eines Android-Pakets von einem Gerät für einen bestimmten Nutzer
|
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
|
Felder
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Befehle, mit denen der Sperrbildschirm geschlossen werden kann.
Öffentliche Konstruktoren
Öffentliche Methoden
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Gibt an, ob der Wechsel zum headless SYSTEM-Nutzer zulässig ist.
clearErrorDialogs
public boolean clearErrorDialogs ()
Schließen Sie alle Fehlerdialogfelder, die derzeit auf der Geräteoberfläche angezeigt werden.
Returns |
boolean |
true , wenn keine Dialogfelder vorhanden waren oder die Dialogfelder erfolgreich gelöscht wurden.
Andernfalls false . |
createUser
public int createUser (String name)
Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
Parameter |
name |
String : des Nutzers, der auf dem Gerät erstellt werden soll |
Returns |
int |
Die Ganzzahl für die erstellte Nutzer-ID |
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen
Parameter |
name |
String : des Nutzers, der auf dem Gerät erstellt werden soll |
guest |
boolean : Aktivieren Sie beim Erstellen das Nutzerflag „–guest“. |
ephemeral |
boolean : Aktivieren Sie beim Erstellen das Nutzerflag „--ephemeral“. |
forTesting |
boolean : aktiviert das Test-Flag „--for-testing“ beim Erstellen |
Returns |
int |
ID des erstellten Nutzers |
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral)
Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen
Parameter |
name |
String : des Nutzers, der auf dem Gerät erstellt werden soll |
guest |
boolean : Aktivieren Sie beim Erstellen das Nutzerflag „–guest“. |
ephemeral |
boolean : aktiviert das Nutzer-Flag „--sitzungsspezifisch“ beim Erstellen |
Returns |
int |
ID des erstellten Nutzers |
createUserNoThrow
public int createUserNoThrow (String name)
Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
Parameter |
name |
String : des Nutzers, der auf dem Gerät erstellt werden soll |
Returns |
int |
Die Ganzzahl für die erstellte Nutzer-ID oder -1 für einen Fehler. |
disableKeyguard
public void disableKeyguard ()
Es wird versucht, den Keyguard zu deaktivieren.
Warten Sie zuerst, bis die Eingabeweiterleitung bereit ist. Das geschieht ungefähr zur selben Zeit, wenn das Gerät BOOT_COMPLETE meldet, anscheinend asynchron, da die aktuelle Framework-Implementierung gelegentlich zu einer Race-Condition führt. Dann wird der Befehl gesendet, um den Sperrbildschirm zu schließen (funktioniert nur bei nicht sicheren Sperrbildschirmen).
doesFileExist
public boolean doesFileExist (String deviceFilePath)
Hilfsmethode, um zu ermitteln, ob eine Datei auf dem Gerät vorhanden ist.
Parameter |
deviceFilePath |
String : Der absolute Pfad der Datei auf dem Gerät, die geprüft werden soll. |
Returns |
boolean |
true , wenn die Datei vorhanden ist, andernfalls false . |
doesFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)
Hilfsmethode, um zu ermitteln, ob eine Datei auf dem Gerät für einen bestimmten Nutzer vorhanden ist.
Parameter |
deviceFilePath |
String : der absolute Pfad der zu prüfenden Datei auf dem Gerät |
userId |
int : Die Nutzer-ID, anhand derer die Datei geprüft werden soll |
Returns |
boolean |
true , wenn die Datei vorhanden ist, andernfalls false . |
dumpHeap
public File dumpHeap (String process,
String devicePath)
Versuchen Sie, den Heap aus dem system_server zu dumpen. Der Aufrufer ist für die Bereinigung der Dumpdatei verantwortlich.
Parameter |
process |
String : Der Name des Geräteprozesses, auf dem der Dumpheap ausgeführt werden soll. |
devicePath |
String : Der Pfad auf dem Gerät, unter dem der Dump abgelegt werden soll. Dies muss ein Ort sein, an dem dies gemäß den Berechtigungen zulässig ist. |
Returns |
File |
den ERROR(/File) , der den Bericht enthält. Null, wenn ein Fehler aufgetreten ist. |
getActiveApexes
public getActiveApexes ()
Rufen Sie die Informationen zu den auf dem Gerät aktivierten APEXes ab.
Einstellungen abrufen
public getAllSettings (String namespace)
Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück.
Parameter |
namespace |
String : muss einer dieser Werte sein: {"system", "secure", "global"} |
Returns |
|
die Zuordnung von Schlüssel/Wert-Paaren. Null, wenn der Namespace nicht unterstützt wird. |
getAndroidId
public String getAndroidId (int userId)
Die mit einer Nutzer-ID verknüpfte Android-ID suchen und zurückgeben. Wenn sie nicht gefunden wird, wird „null“ zurückgegeben.
getAndroidIds (Abrufen von Android-IDs)
public getAndroidIds ()
Erstellen Sie eine Karte mit Android-IDs, die mit Nutzer-IDs übereinstimmen. Es kann nicht garantiert werden, dass für jede User-ID eine Android-ID gefunden wird, die mit dieser Funktion verknüpft ist. Daher kann es sein, dass einige User-IDs mit „null“ übereinstimmen.
Returns |
|
Zuordnung von Android-IDs zu Nutzer-IDs. |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Informationen zu einem auf dem Gerät installierten Paket abrufen
Parameter |
packageName |
String |
getAppPackageInfos
public getAppPackageInfos ()
Ruft Informationen zu auf dem Gerät installierten Paketen ab.
getBugreport
public InputStreamSource getBugreport ()
Ruft einen Fehlerbericht vom Gerät ab.
Die Implementierung funktioniert garantiert auch auf einem Gerät ohne SD-Karte oder wenn die SD-Karte noch nicht bereitgestellt wurde.
getBugreportz
public InputStreamSource getBugreportz ()
Ruft einen Fehlerbericht vom Gerät ab. Der Fehlerbericht im ZIP-Format enthält den Hauptfehlerbericht und andere Logdateien, die für die Fehlerbehebung hilfreich sind.
Nur für „adb version“ > 1.0.36 unterstützt
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Gibt den aktuellen Faltstatus des Geräts zurück oder „null“, wenn Probleme aufgetreten sind.
getCurrentUser
public int getCurrentUser ()
Gibt die ID des aktuell ausgeführten Nutzers zurück. Bei einem Fehler -10.000 zurückgeben.
getFoldableStates
public getFoldableStates ()
Liste der Zustände des faltbaren Geräts zurückgeben Kann mit „cmd device_state print-states“ abgerufen werden.
getInstalledPackageNames
public getInstalledPackageNames ()
Rufen Sie die auf dem Gerät vorhandenen App-Paketnamen ab.
Returns |
|
ERROR(/Set) von String Paketnamen, die derzeit auf dem Gerät installiert sind. |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Gibt ein Objekt zurück, um den aktuellen Status des Keyguard oder null abzurufen, wenn dies nicht unterstützt wird.
getMainUserId
public Integer getMainUserId ()
Gibt die Hauptnutzer-ID zurück.
Returns |
Integer |
Die userId des Hauptnutzers, falls vorhanden, und null, wenn es keinen Hauptnutzer gibt |
getMainlineModuleInfo
public getMainlineModuleInfo ()
Informationen zu den auf dem Gerät installierten Mainline-Modulen abrufen
Returns |
|
ERROR(/Set) von String Mainline-Modulen, die derzeit auf dem Gerät installiert sind. |
public int getMaxNumberOfRunningUsersSupported ()
Die maximale Anzahl der gleichzeitig unterstützten Nutzer abrufen Die Standardeinstellung ist 0.
Returns |
int |
eine Ganzzahl, die die Anzahl der gleichzeitig ausgeführten Nutzer angibt |
public int getMaxNumberOfUsersSupported ()
Maximal unterstützte Nutzerzahl abrufen Die Standardeinstellung ist 0.
Returns |
int |
eine Ganzzahl, die die Anzahl der unterstützten Nutzer angibt |
getPrimaryUserId (Primäre Nutzer-ID)
public Integer getPrimaryUserId ()
Gibt die primäre Nutzer-ID zurück.
Returns |
Integer |
die userId des Hauptnutzers, falls vorhanden, andernfalls „null“. |
getScreenshot
public InputStreamSource getScreenshot ()
Erstellt einen Screenshot auf dem Gerät.
getScreenshot
public InputStreamSource getScreenshot (String format,
boolean rescale)
Erstellt einen Screenshot auf dem Gerät. Wir empfehlen, stattdessen getScreenshot(String)
mit JPEG-Codierung zu verwenden, um die Größe zu verringern.
Parameter |
format |
String : unterstützt PNG, JPEG |
rescale |
boolean : Gibt an, ob der Screenshot neu skaliert werden soll, um die Größe des resultierenden Bildes zu verringern. |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Erfasst einen Screenshot vom Gerät mit der angegebenen Anzeige-ID. Das Format ist PNG.
TODO: Extend the implementations above to support 'format' and 'rescale'
Parameter |
displayId |
long : Die Display-ID des Bildschirms, von dem ein Screenshot erstellt werden soll. |
getScreenshot
public InputStreamSource getScreenshot (String format)
Erstellt einen Screenshot auf dem Gerät.
Stattdessen wird empfohlen, getScreenshot(format) mit JPEG-Codierung zu verwenden, um eine kleinere Dateigröße zu erzielen.
Parameter |
format |
String : unterstützte PNG- und JPEG-Dateien |
getSetting
public String getSetting (String namespace,
String key)
Siehe getSetting(int, String, String)
und wird auf den Systemnutzer angewendet.
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 eine der folgenden Optionen sein: {"system", "secure", "global"}
Parameter |
userId |
int |
namespace |
String |
key |
String |
Returns |
String |
Wert, der mit „namespace:key“ eines Nutzers verknüpft ist. Null, wenn nicht gefunden. |
getUninstallablePackageNames
public getUninstallablePackageNames ()
Rufen Sie die App-Paketnamen ab, die deinstalliert werden können. Dies wird derzeit als Nicht-Systempakete und aktualisierte Systempakete definiert.
Returns |
|
ERROR(/Set) der Namen von nicht deinstallierbaren String -Paketen, die derzeit auf dem Gerät installiert sind. |
getUserFlags
public int getUserFlags (int userId)
Die Markierungen eines bestimmten Nutzers finden und zurückgeben.
Flags werden in der Klasse „android.content.pm.UserInfo“ im Android Open Source-Projekt definiert.
Returns |
int |
Die Flags, die mit der angegebenen Nutzer-ID verknüpft sind, falls gefunden, andernfalls „-10000“. |
getUserInfos (Nutzerinformationen abrufen)
public getUserInfos ()
Ruft die Map of useId zu UserInfo
auf dem Gerät ab. DeviceRuntimeException
wird ausgegeben, wenn die Ausgabe vom Gerät nicht wie erwartet ist.
Returns |
|
die Liste der UserInfo-Objekte. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Gibt die Seriennummer zurück, die mit der userId verknüpft ist, falls gefunden, andernfalls -10000.
hasFeature
public boolean hasFeature (String feature)
Prüfen, ob eine Funktion auf einem Gerät verfügbar ist
Parameter |
feature |
String : Gibt an, welches Format direkt "feature:" oder "" sein sollte. |
Returns |
boolean |
„True“, wenn die Funktion gefunden wird, andernfalls „false“. |
installPackage
public String installPackage (File packageFile,
boolean reinstall,
String... extraArgs)
Installieren Sie ein Android-Paket auf dem Gerät.
Parameter |
packageFile |
File : die zu installierende APK-Datei |
reinstall |
boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Returns |
String |
String mit einem Fehlercode oder null bei Erfolg. |
installPackage
public String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Installieren Sie ein Android-Paket auf dem Gerät.
Hinweis: Diese Funktion sollte nur bei Anwendungsfällen aufgerufen werden, bei denen die Laufzeitberechtigung bei der Installation explizit gesteuert werden muss.
Parameter |
packageFile |
File : die zu installierende APK-Datei |
reinstall |
boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions |
boolean : ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Returns |
String |
String mit einem Fehlercode oder null bei Erfolg. |
installPackage
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 bei Anwendungsfällen aufgerufen werden, bei denen die Laufzeitberechtigung bei der Installation explizit gesteuert werden muss.
Parameter |
packageFile |
File : die zu installierende APK-Datei |
certFile |
File : true , wenn eine Neuinstallation durchgeführt werden soll |
reinstall |
boolean : ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Returns |
String |
String mit einem Fehlercode oder null bei Erfolg. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer
Hinweis: Diese Funktion sollte nur bei Anwendungsfällen aufgerufen werden, bei denen die Laufzeitberechtigung bei der Installation explizit gesteuert werden muss.
Parameter |
packageFile |
File : die zu installierende APK-Datei |
reinstall |
boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions |
boolean : ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen |
userId |
int : Die Ganzzahl-Nutzer-ID, für die die Installation erfolgen soll. |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Returns |
String |
String mit einem Fehlercode oder null bei Erfolg. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer
Parameter |
packageFile |
File : die zu installierende APK-Datei |
reinstall |
boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
userId |
int : Die Ganzzahl-Nutzer-ID, für die die Installation erfolgen soll. |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“. |
Returns |
String |
einen String mit einem Fehlercode oder null , wenn der Vorgang erfolgreich ist. |
installPackages
public String installPackages ( packageFiles,
boolean reinstall,
String... extraArgs)
Parameter |
packageFiles |
|
reinstall |
boolean |
extraArgs |
String |
installPackages
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 ()
Prüfen, ob die Plattform auf dem Gerät die App-Aufzählung unterstützt
Returns |
boolean |
„True“, wenn die App-Enumeration unterstützt wird, andernfalls „False“ |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Gibt an, ob auf dem Gerät der headless Systemnutzermodus verwendet wird.
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Gibt zurück, ob der Hauptnutzer ein dauerhafter Administrator ist und weder gelöscht noch auf einen Nicht-Administratorstatus herabgestuft werden kann.
isMultiUserSupported
public boolean isMultiUserSupported ()
Legt fest, ob mehrere Nutzer unterstützt werden.
Returns |
boolean |
„true“, wenn mehrere Nutzer unterstützt werden, andernfalls „false“ |
isPackageInstalled
public boolean isPackageInstalled (String packageName)
Fragen Sie das Gerät nach einem bestimmten Paketnamen ab, um zu prüfen, ob es derzeit installiert ist.
Parameter |
packageName |
String |
Returns |
boolean |
„Wahr“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“. |
isPackageInstalled
public boolean isPackageInstalled (String packageName,
String userId)
Frag das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID ab, um zu prüfen, ob es bei diesem Nutzer derzeit installiert ist oder nicht.
Parameter |
packageName |
String : Paket, für das geprüft wird, ob es installiert ist. |
userId |
String : Die Nutzer-ID, für die geprüft wird, ob das Paket installiert ist. Wenn „null“ festgelegt ist, wird „0“ für den Hauptnutzer verwendet. |
Returns |
boolean |
„Wahr“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“. |
isUserRunning
public boolean isUserRunning (int userId)
Prüfen, ob ein bestimmter Nutzer ausgeführt wird
Returns |
boolean |
„True“, wenn der Nutzer läuft, andernfalls „False“. |
istUserSekundär
public boolean isUserSecondary (int userId)
Gibt an, ob der angegebene Nutzer gemäß seinen Flags ein sekundärer Nutzer ist.
Returns |
boolean |
"true", wenn der Nutzer ein sekundärer Nutzer ist, andernfalls "false". |
isUserVisible
public boolean isUserVisible (int userId)
Prüft, ob der angegebene Nutzer sichtbar ist.
Ein „sichtbarer“ Nutzer ist ein Nutzer, der mit dem „menschlichen“ Nutzer interagiert und daher Aktivitäten starten kann (in der Regel im Standarddisplay).
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
Prüft, ob der angegebene Nutzer im angegebenen Display sichtbar ist.
Ein „sichtbarer“ Nutzer ist ein Nutzer, der mit dem „menschlichen“ Nutzer interagiert und daher Aktivitäten auf diesem Display starten kann.
Parameter |
userId |
int |
displayId |
int |
listDisplayIds
public listDisplayIds ()
Liste der verfügbaren Display-IDs auf dem Gerät erfassen, wie von „dumpsys
SurfaceFlinger“ gemeldet
Returns |
|
Die Liste der Displays. Standardmäßig wird immer der Standardwert „0“ zurückgegeben. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
Liste der Displays abrufen, die für start a user visible in the background
verwendet werden können
listUsers
public listUsers ()
Ruft die Liste der Nutzer auf dem Gerät ab. Gibt DeviceRuntimeException
aus, wenn die Ausgabe vom Gerät nicht wie erwartet ist.
Returns |
|
die Liste der Nutzer-IDs. |
logBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)
Hilfsmethode, um einen Fehlerbericht zu erstellen und an die Meldenden zu senden.
Parameter |
dataName |
String : Name, unter dem der Fehlerbericht gemeldet wird. |
listener |
ITestLogger : einen ITestLogger , um den Fehlerbericht zu protokollieren. |
Returns |
boolean |
„True“, wenn die Protokollierung erfolgreich war, andernfalls „false“. |
notifySnapuserd
public void notifySnapuserd (SnapuserdWaitPhase waitPhase)
Parameter |
waitPhase |
SnapuserdWaitPhase |
postInvocationTearDown
public void postInvocationTearDown (Throwable exception)
Zusätzliche Schritte für die erforderliche gerätespezifische Bereinigung, die nach dem Aufruf ausgeführt wird.
Parameter |
exception |
Throwable : die letzte Ausnahme, die durch den Aufruffehler ausgelöst wurde, falls vorhanden. |
removeAdmin
public boolean removeAdmin (String componentName,
int userId)
Entfernt den angegebenen Geräteadministrator beim angegebenen Nutzer und gibt true
zurück, wenn der Vorgang erfolgreich war, andernfalls false
.
Parameter |
componentName |
String : des zu entfernenden Geräteadministrators. |
userId |
int : des Nutzers, in dessen Land sich der Geräteadministrator befindet. |
Returns |
boolean |
„True“, wenn der Vorgang erfolgreich ist, andernfalls „False“. |
removeOwners
public void removeOwners ()
Entfernen Sie nach Möglichkeit alle vorhandenen Geräteprofileigentümer.
removeUser
public boolean removeUser (int userId)
Einen bestimmten Nutzer vom Gerät entfernen.
Parameter |
userId |
int : des zu entfernenden Nutzers |
Returns |
boolean |
„true“, wenn der Nutzer entfernt werden konnte, andernfalls „false“. |
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)
Eine Geräteadministratorkomponente als Geräteinhaber für den angegebenen Nutzer festlegen
Parameter |
componentName |
String : des Geräteadministrators als Geräteinhaber |
userId |
int : des Nutzers, in dessen Land sich der Geräteinhaber befindet. |
Returns |
boolean |
„True“, wenn der Vorgang erfolgreich ist, andernfalls „False“. |
setSetting
public void setSetting (String namespace,
String key,
String value)
Siehe setSetting(int, String, String, String)
und wird auf den Systemnutzer angewendet.
Parameter |
namespace |
String |
key |
String |
value |
String |
setSetting
public void setSetting (int userId,
String namespace,
String key,
String value)
Dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzufügen. Einige Einstellungen sind erst nach einem Neustart verfügbar.
Namespace muss einen der folgenden Werte haben: {"system", "secure", "global"}
Parameter |
userId |
int |
namespace |
String |
key |
String |
value |
String |
shutdownMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Das Microdroid-Gerät wird heruntergefahren, falls vorhanden.
Parameter |
microdroidDevice |
ITestDevice |
startUser (Startnutzer)
public boolean startUser (int userId)
Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist. Wenn der Nutzer bereits im Hintergrund ausgeführt wird, ist diese Methode ein NOOP.
Parameter |
userId |
int : des Nutzers, der im Hintergrund gestartet werden soll |
Returns |
boolean |
"true", wenn der Nutzer im Hintergrund gestartet wurde. |
startUser
public boolean startUser (int userId,
boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist. Wenn der Nutzer bereits im Hintergrund ausgeführt wird, ist diese Methode ein NOOP. Es ist möglich, ein zusätzliches Flag anzugeben, um zu warten, bis der Vorgang wirksam wird.
Parameter |
userId |
int : des Nutzers, der im Hintergrund gestartet werden soll |
waitFlag |
boolean : Der Befehl wartet, bis der Nutzer gestartet und entsperrt ist. |
Returns |
boolean |
"true", wenn der Nutzer im Hintergrund gestartet wurde. |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, der auf dem jeweiligen Bildschirm sichtbar ist (d.h., der Nutzer kann Aktivitäten auf dieser Anzeige starten).
HINWEIS : Mit diesem Befehl wird nicht geprüft, ob der Nutzer vorhanden ist, das Display verfügbar ist usw.device supports such feature
Parameter |
userId |
int : des Nutzers, der im Hintergrund gestartet werden soll |
displayId |
int : Display, auf dem die Benachrichtigung für Nutzer sichtbar sein soll |
waitFlag |
boolean : Der Befehl wartet, bis der Nutzer gestartet und entsperrt ist. |
Returns |
boolean |
true , wenn der Nutzer erfolgreich gestartet wurde und im Hintergrund sichtbar ist. |
stopUser
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Stoppen Sie einen bestimmten Nutzer. Es können zusätzliche Flags bereitgestellt werden, um auf den Vorgang zu warten und die Beendigung des Nutzers zu erzwingen. Der aktuelle Nutzer und der Systemnutzer können nicht angehalten werden.
Parameter |
userId |
int : des Nutzers, der beendet werden soll. |
waitFlag |
boolean : Der Befehl wartet, bis der Nutzer gestoppt wird. |
forceFlag |
boolean : wird der Nutzer zwangsweise beendet. |
Returns |
boolean |
„wahr“, wenn der Nutzer erfolgreich gestoppt wurde. |
stopUser
public boolean stopUser (int userId)
Stoppt einen bestimmten Nutzer. Wenn der Nutzer bereits gestoppt wurde, ist diese Methode eine NOOP-Methode.
Aktuellen Nutzer und Systemnutzer können nicht beendet werden.
Parameter |
userId |
int : des Nutzers, der beendet werden soll. |
Returns |
boolean |
„wahr“, wenn der Nutzer erfolgreich gestoppt wurde. |
supportsMicrodroid
public boolean supportsMicrodroid ()
Prüft die Voraussetzungen für die Ausführung eines Microdroids.
Returns |
boolean |
Gibt „wahr“ zurück, wenn die Vorbedingungen erfüllt sind, andernfalls „falsch“. |
supportsMicrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Prüft die Voraussetzungen für die Ausführung eines Microdroids.
Parameter |
protectedVm |
boolean : „wahr“, wenn Microdroid auf einer geschützten VM ausgeführt werden soll. |
Returns |
boolean |
Gibt „wahr“ zurück, wenn die Vorbedingungen erfüllt sind, andernfalls „falsch“. |
switchUser
public boolean switchUser (int userId)
Zu einer anderen Nutzer-ID mit Standardzeitlimit wechseln. switchUser(int, long)
.
Returns |
boolean |
„True“, wenn die neue User-ID mit dem Anbieter der User-ID übereinstimmt. Andernfalls „false“. |
SwitchUser
public boolean switchUser (int userId,
long timeout)
Wechseln Sie zu einer anderen Nutzer-ID mit dem angegebenen Zeitlimit als Frist.
Versuchen Sie, den Sperrbildschirm zu deaktivieren, nachdem die Nutzeränderung erfolgreich war.
Parameter |
userId |
int |
timeout |
long : Warten, bis „false“ für Switch-User zurückgegeben wird. |
Returns |
boolean |
„True“, wenn die neue User-ID mit dem Anbieter der User-ID übereinstimmt. Andernfalls „false“. |
takeBugreport
public Bugreport takeBugreport ()
Nimmt einen Fehlerbericht entgegen und gibt ihn in einem Bugreport
-Objekt zurück, um ihn zu verarbeiten. Gib bei Problemen „null“ zurück. Die im Bugberichtsobjekt referenzierte Datei muss über Bugreport.close()
bereinigt werden.
uninstallPackage
public String uninstallPackage (String packageName)
Deinstallation eines Android-Pakets vom Gerät
Parameter |
packageName |
String : das zu deinstallierende Android-Paket |
Returns |
String |
einen String mit einem Fehlercode oder null , wenn der Vorgang erfolgreich ist. |
uninstallPackageForUser
public String uninstallPackageForUser (String packageName,
int userId)
Deinstallation eines Android-Pakets von einem Gerät für einen bestimmten Nutzer
Parameter |
packageName |
String : das zu deinstallierende Android-Paket |
userId |
int : die ganzzahlige Nutzer-ID, für die deinstalliert werden soll. |
Returns |
String |
einen String mit einem Fehlercode oder null , wenn der Vorgang erfolgreich ist. |
WartefürSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
Parameter |
currentPhase |
SnapuserdWaitPhase |
Geschützte Methoden
Parser erstellen
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 : einen Modus dieses Neustarts. |
reason |
String : für diesen Neustart. |
getBugreportzInternal
protected File getBugreportzInternal ()
Interne Hilfsmethode zum Abrufen der ZIP-Datei „bugreportz“ als ERROR(/File)
.
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Wird für Tests freigegeben.
getHostCurrentTime
protected long getHostCurrentTime ()
Für Tests freigegeben
prePostBootSetup
protected void prePostBootSetup ()
Damit kann jeder Gerätetyp (AndroidNativeDevice, TestDevice) diese Methode für eine bestimmte Einrichtung nach dem Booten überschreiben.