TestDevice
public
class
TestDevice
extends NativeDevice
Bekannte direkte Unterklassen
| ManagedRemoteDevice |
Ein Gerät, das auf einer virtuellen Maschine ausgeführt wird, die wir remote über eine Tradefed-Instanz auf der VM verwalten.
|
| NestedRemoteDevice |
Darstellung des Geräts, das in einer Remote-Cuttlefish-VM ausgeführt wird.
|
| RemoteAndroidDevice |
Implementierung eines ITestDevice für ein Full-Stack-Android-Gerät, das über „adb connect“ verbunden ist.
|
|
Bekannte indirekte Unterklassen
|
Implementierung eines ITestDevice für ein Android-Gerät mit vollständigem Stack
Zusammenfassung
Öffentliche Methoden |
boolean
|
canSwitchToHeadlessSystemUser()
Gibt zurück, ob der Wechsel zum monitorlosen SYSTEM-Nutzer zulässig ist.
|
boolean
|
clearErrorDialogs()
Schließen Sie alle Fehlerdialogfelder, die derzeit auf der Geräte-UI angezeigt werden.
|
int
|
createUser(String name)
Erstellt einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
|
int
|
createUser(String name, boolean guest, boolean ephemeral)
Erstelle einen Nutzer mit einem bestimmten Namen und den angegebenen Flags.
|
int
|
createUser(String name, boolean guest, boolean ephemeral, boolean forTesting)
Erstellt einen Nutzer mit einem bestimmten Namen und den angegebenen Flags
|
int
|
createUserNoThrow(String name)
Erstellt einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
|
void
|
disableKeyguard()
Es wird versucht, den Keyguard zu deaktivieren.
|
boolean
|
doesFileExist(String deviceFilePath, int userId)
Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät für einen bestimmten Nutzer vorhanden ist.
|
boolean
|
doesFileExist(String deviceFilePath)
Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät vorhanden ist.
|
File
|
dumpHeap(String process, String devicePath)
Versuchen Sie, den Heap aus dem system_server zu sichern.
|
|
getActiveApexes()
Ruft die Informationen zu den auf dem Gerät aktivierten APEX-Modulen ab.
|
|
getAllSettings(String namespace)
Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück.
|
String
|
getAndroidId(int userId)
Sucht die Android-ID, die einem Nutzer zugeordnet ist, und gibt sie zurück. Wenn sie nicht gefunden wird, wird „null“ zurückgegeben.
|
|
getAndroidIds()
Erstellen Sie eine Zuordnung von Android-IDs zu übereinstimmenden User-IDs.
|
PackageInfo
|
getAppPackageInfo(String packageName)
Informationen zu einem auf dem Gerät installierten Paket abrufen.
|
|
getAppPackageInfos()
Informationen zu auf dem Gerät installierten Paketen abrufen.
|
InputStreamSource
|
getBugreport()
Ruft einen Fehlerbericht vom Gerät ab.
|
InputStreamSource
|
getBugreportz()
Ruft einen Fehlerbericht vom Gerät ab.
|
DeviceFoldableState
|
getCurrentFoldableState()
Gibt den aktuellen Status des faltbaren Geräts zurück oder „null“, wenn Probleme aufgetreten sind.
|
int
|
getCurrentUser()
Gibt die ID des aktuell ausgeführten Nutzers zurück.
|
|
getFoldableStates()
Gibt die Liste der faltbaren Status auf dem Gerät zurück.
|
|
getInstalledPackageNames()
Ruft die auf dem Gerät vorhandenen Anwendungs-Paketnamen ab.
|
KeyguardControllerState
|
getKeyguardState()
Gibt ein Objekt zurück, um den aktuellen Status des Keyguards abzurufen, oder „null“, wenn er nicht unterstützt wird.
|
Integer
|
getMainUserId()
Gibt die Hauptnutzer-ID zurück.
|
|
getMainlineModuleInfo()
Ruft Informationen zu den auf dem Gerät installierten Mainline-Modulen ab.
|
int
|
getMaxNumberOfRunningUsersSupported()
Die maximale Anzahl der unterstützten gleichzeitig aktiven Nutzer abrufen.
|
int
|
getMaxNumberOfUsersSupported()
Maximale Anzahl der unterstützten Nutzer abrufen
|
Integer
|
getPrimaryUserId()
Gibt die primäre Nutzer-ID zurück.
|
InputStreamSource
|
getScreenshot(String format, boolean rescale)
Erstellt einen Screenshot vom Gerät.
|
InputStreamSource
|
getScreenshot(long displayId)
Erstellt einen Screenshot des Geräts mit der angegebenen Anzeige-ID.
|
InputStreamSource
|
getScreenshot(String format)
Erstellt einen Screenshot vom Gerät.
|
InputStreamSource
|
getScreenshot()
Erstellt einen Screenshot vom Gerät.
|
String
|
getSetting(int userId, String namespace, String key)
Gibt den Wert der angeforderten Einstellung zurück.
|
String
|
getSetting(String namespace, String key)
Weitere Informationen finden Sie unter getSetting(int, String, String).
|
|
getUninstallablePackageNames()
Ruft die Paketnamen der Anwendungen ab, die deinstalliert werden können.
|
int
|
getUserFlags(int userId)
Sucht die Flags eines bestimmten Nutzers und gibt sie zurück.
|
|
getUserInfos()
Ruft die Zuordnung von useId zu UserInfo auf dem Gerät ab.
|
int
|
getUserSerialNumber(int userId)
Gibt die dem userId zugeordnete Seriennummer zurück, 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, File certFile, 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
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Installieren Sie ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.
|
String
|
installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)
Installiert ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.
|
boolean
|
installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)
Installiert APKs im inkrementellen Modus.
|
String
|
installPackages( packageFiles, boolean reinstall, String... extraArgs)
|
String
|
installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)
|
String
|
installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs)
|
String
|
installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, 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 zurück, ob auf dem Gerät der monitorlose Systemnutzermodus verwendet wird.
|
boolean
|
isMainUserPermanentAdmin()
Gibt zurück, ob der Hauptnutzer ein permanenter Administrator ist und nicht gelöscht oder auf den Status „Kein Administrator“ herabgestuft werden kann.
|
boolean
|
isMultiUserSupported()
Gibt an, ob mehrere Nutzer unterstützt werden.
|
boolean
|
isPackageInstalled(String packageName, String userId)
Fragen Sie das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID ab, um zu prüfen, ob die App für diesen Nutzer derzeit installiert ist.
|
boolean
|
isPackageInstalled(String packageName)
Fragen Sie das Gerät nach einem bestimmten Paketnamen, um zu prüfen, ob das Paket derzeit installiert ist.
|
boolean
|
isUserRunning(int userId)
Prüfen, ob ein bestimmter Nutzer aktiv ist.
|
boolean
|
isUserSecondary(int userId)
Gibt zurück, ob der angegebene Nutzer anhand seiner Flags ein sekundärer Nutzer ist.
|
boolean
|
isUserVisible(int userId)
Prüft, ob der angegebene Nutzer sichtbar ist.
|
boolean
|
isUserVisibleOnDisplay(int userId, int displayId)
Prüft, ob der angegebene Nutzer auf dem angegebenen Display sichtbar ist.
|
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Gibt zurück, ob Nutzer auf dem Gerät im Hintergrund in ERROR(/java.android.view.Display#DEFAULT_DISPLAY) sichtbar sein können.
|
boolean
|
isVisibleBackgroundUsersSupported()
Gibt zurück, ob Nutzer im Hintergrund sichtbar gestartet werden dürfen.
|
|
listDisplayIds()
Erfassen Sie die Liste der verfügbaren Display-IDs auf dem Gerät, wie von „dumpsys SurfaceFlinger“ gemeldet.
|
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Ruft die Liste der Displays ab, 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 zum Erstellen eines Fehlerberichts und zum Protokollieren des Berichts für die Reporter.
|
void
|
notifySnapuserd(SnapuserdWaitPhase waitPhase)
|
void
|
postInvocationTearDown(Throwable exception)
Zusätzliche Schritte für die gerätespezifische Bereinigung, die nach dem Aufruf ausgeführt werden.
|
boolean
|
removeAdmin(String componentName, int userId)
Entfernt den angegebenen Geräteadministrator für den angegebenen Nutzer und gibt true zurück, wenn der Vorgang erfolgreich war, andernfalls false.
|
void
|
removeOwners()
Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen.
|
boolean
|
removeUser(int userId)
Einen bestimmten Nutzer vom Gerät entfernen.
|
boolean
|
setDeviceOwner(String componentName, int userId)
Legt eine Geräteadministrator-Komponente als Geräteinhaber für einen bestimmten Nutzer fest.
|
void
|
setFirstBootloaderReboot()
|
void
|
setSetting(String namespace, String key, String value)
Weitere Informationen finden Sie unter setSetting(int, String, String, String).
|
void
|
setSetting(int userId, String namespace, String key, String value)
Fügen Sie dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzu.
|
void
|
shutdownMicrodroid(ITestDevice microdroidDevice)
Fährt das Microdroid-Gerät herunter, falls es vorhanden ist.
|
boolean
|
startUser(int userId)
Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit beendet ist.
|
boolean
|
startUser(int userId, boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit beendet ist.
|
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, der auf dem angegebenen Display sichtbar ist (d.h. der Nutzer kann Aktivitäten auf diesem Display starten).
|
boolean
|
stopUser(int userId)
Stoppt einen bestimmten Nutzer.
|
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Einen bestimmten Nutzer stoppen.
|
boolean
|
supportsMicrodroid()
Prüft die Voraussetzungen für die Ausführung eines Microdroid.
|
boolean
|
supportsMicrodroid(boolean protectedVm)
Prüft die Voraussetzungen für die Ausführung eines Microdroid.
|
boolean
|
switchUser(int userId)
Wechseln Sie zu einer anderen userId mit einem Standard-Timeout.
|
boolean
|
switchUser(int userId, long timeout)
Wechseln Sie innerhalb des angegebenen Zeitlimits zu einer anderen Nutzer-ID.
|
Bugreport
|
takeBugreport()
Erstellt einen Fehlerbericht und gibt ihn in einem Bugreport-Objekt zurück, um ihn zu verarbeiten.
|
String
|
uninstallPackage(String packageName)
Ein Android-Paket vom Gerät deinstallieren.
|
String
|
uninstallPackageForUser(String packageName, int userId)
Deinstalliert ein Android-Paket für einen bestimmten Nutzer von einem Gerät.
|
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
|
Konstanten
DISMISS_KEYGUARD_CMD
public static final String DISMISS_KEYGUARD_CMD
Befehle, mit denen der Keyguard geschlossen werden kann.
Konstanter Wert:
"input keyevent 82"
Öffentliche Konstruktoren
Öffentliche Methoden
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Gibt zurück, ob der Wechsel zum monitorlosen SYSTEM-Nutzer zulässig ist.
clearErrorDialogs
public boolean clearErrorDialogs ()
Versuchen Sie, alle Fehlerdialogfelder zu schließen, die derzeit auf der Geräte-UI angezeigt werden.
| Returns |
boolean |
true, wenn keine Dialogfelder vorhanden waren oder 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)
Erstelle einen Nutzer mit einem bestimmten Namen und den angegebenen Flags.
| Parameter |
name |
String: des Nutzers, der auf dem Gerät erstellt werden soll |
guest |
boolean: Aktivieren Sie das Nutzer-Flag „--guest“ während der Erstellung. |
ephemeral |
boolean: Aktivieren Sie das Nutzerflag „--ephemeral“ während der Erstellung. |
| Returns |
int |
ID des erstellten Nutzers |
createUser
public int createUser (String name,
boolean guest,
boolean ephemeral,
boolean forTesting)
Erstelle einen Nutzer mit einem bestimmten Namen und den angegebenen Flags.
| Parameter |
name |
String: des Nutzers, der auf dem Gerät erstellt werden soll |
guest |
boolean: Aktivieren Sie das Nutzer-Flag „--guest“ während der Erstellung. |
ephemeral |
boolean: Aktivieren Sie das Nutzerflag „--ephemeral“ während der Erstellung. |
forTesting |
boolean: Aktivieren Sie beim Erstellen das Testflag „--for-testing“. |
| Returns |
int |
ID des erstellten Nutzers |
createUserNoThrow
public int createUserNoThrow (String name)
Erstellt 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 bei einem Fehler. |
disableKeyguard
public void disableKeyguard ()
Es wird versucht, den Keyguard zu deaktivieren.
Warten Sie zuerst, bis die Eingabeübermittlung bereit ist. Das passiert ungefähr zur selben Zeit, zu der das Gerät BOOT_COMPLETE meldet. Das geschieht anscheinend asynchron, da die aktuelle Framework-Implementierung gelegentlich Race-Bedingungen aufweist. Anschließend wird der Befehl zum Schließen des Keyguards gesendet (funktioniert nur bei nicht sicheren Keyguards).
doesFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)
Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät für einen bestimmten Nutzer vorhanden ist.
| Parameter |
deviceFilePath |
String: Der absolute Pfad der Datei auf dem Gerät, die geprüft werden soll. |
userId |
int: Die Nutzer-ID, anhand der die Dateiexistenz geprüft werden soll. |
| Returns |
boolean |
true, wenn die Datei vorhanden ist, andernfalls false. |
doesFileExist
public boolean doesFileExist (String deviceFilePath)
Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät vorhanden ist.
| Parameter |
deviceFilePath |
String: Der absolute Pfad der Datei auf dem Gerät, die geprüft werden soll. |
| 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 sichern. Der Aufrufer ist für das Bereinigen der gesicherten Datei verantwortlich.
| Parameter |
process |
String: Der Name des Geräteprozesses, für den „dumpheap“ ausgeführt werden soll. |
devicePath |
String: Der Pfad auf dem Gerät, unter dem der Dump abgelegt werden soll. Dies muss ein Ort sein, an dem dies gemäß den Berechtigungen zulässig ist. |
| Returns |
File |
ERROR(/File), der den Bericht enthält. „Null“, wenn ein Fehler aufgetreten ist. |
getActiveApexes
public getActiveApexes ()
Ruft die Informationen zu den auf dem Gerät aktivierten APEX-Modulen ab.
getAllSettings
public getAllSettings (String namespace)
Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück.
| Parameter |
namespace |
String: Muss einer der folgenden Werte sein: {„system“, „secure“, „global“} |
| Returns |
|
Die Zuordnung von Schlüssel/Wert-Paaren. „Null“, wenn der Namespace nicht unterstützt wird. |
getAndroidId
public String getAndroidId (int userId)
Sucht die Android-ID, die einem Nutzer zugeordnet ist, und gibt sie zurück. Wenn sie nicht gefunden wird, wird „null“ zurückgegeben.
getAndroidIds
public getAndroidIds ()
Erstellen Sie eine Zuordnung von Android-IDs zu übereinstimmenden User-IDs. Es gibt keine Garantie, dass für jede User-ID eine zugehörige Android-ID gefunden wird. Daher kann es vorkommen, dass einige User-IDs mit „null“ übereinstimmen.
| Returns |
|
Karte der Android-IDs, die mit Nutzer-IDs übereinstimmen. |
getAppPackageInfo
public PackageInfo getAppPackageInfo (String packageName)
Informationen zu einem auf dem Gerät installierten Paket abrufen.
| Parameter |
packageName |
String |
getAppPackageInfos
public getAppPackageInfos ()
Informationen zu auf dem Gerät installierten Paketen abrufen.
getBugreport
public InputStreamSource getBugreport ()
Ruft einen Fehlerbericht vom Gerät ab.
Die Implementierung dieser Funktion funktioniert garantiert auch auf Geräten ohne SD-Karte (oder wenn die SD-Karte noch nicht eingebunden ist).
getBugreportz
public InputStreamSource getBugreportz ()
Ruft einen Bugreportz vom Gerät ab. Der Fehlerbericht im ZIP-Format enthält den Hauptfehlerbericht und andere Protokolldateien, die für die Fehlerbehebung nützlich sind.
Wird nur für „adb version“ > 1.0.36 unterstützt.
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Gibt den aktuellen Status des faltbaren Geräts zurück oder „null“, wenn Probleme aufgetreten sind.
getCurrentUser
public int getCurrentUser ()
Gibt die ID des aktuell ausgeführten Nutzers zurück. Im Fehlerfall wird -10000 zurückgegeben.
getFoldableStates
public getFoldableStates ()
Gibt die Liste der faltbaren Status auf dem Gerät zurück. Kann mit „cmd device_state
print-states“ abgerufen werden.
getInstalledPackageNames
public getInstalledPackageNames ()
Ruft die Paketnamen der auf dem Gerät vorhandenen Anwendungen 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 Keyguards abzurufen, oder „null“, wenn er nicht unterstützt wird.
getMainUserId
public Integer getMainUserId ()
Gibt die Hauptnutzer-ID zurück.
| Returns |
Integer |
Die userId des Hauptnutzers, falls vorhanden, andernfalls null. |
getMainlineModuleInfo
public getMainlineModuleInfo ()
Ruft Informationen zu den auf dem Gerät installierten Mainline-Modulen ab.
| Returns |
|
ERROR(/Set) der String Mainline-Module, die derzeit auf dem Gerät installiert sind. |
public int getMaxNumberOfRunningUsersSupported ()
Die maximale Anzahl der unterstützten gleichzeitig aktiven Nutzer abrufen. Die Standardeinstellung ist 0.
| Returns |
int |
Eine Ganzzahl, die die Anzahl der gleichzeitig aktiven Nutzer angibt |
public int getMaxNumberOfUsersSupported ()
Maximale Anzahl der unterstützten Nutzer abrufen Die Standardeinstellung ist 0.
| Returns |
int |
Eine Ganzzahl, die die Anzahl der unterstützten Nutzer angibt |
getPrimaryUserId
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 (String format,
boolean rescale)
Erstellt einen Screenshot vom Gerät. Wir empfehlen, stattdessen getScreenshot(String) mit JPEG-Codierung zu verwenden, um die Größe zu verringern.
| Parameter |
format |
String: Unterstützte PNG- und JPEG-Dateien |
rescale |
boolean: Gibt an, ob der Screenshot skaliert werden soll, um die Größe des resultierenden Bildes zu verringern. |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Erstellt einen Screenshot des Geräts mit der angegebenen Anzeige-ID. Das Format ist PNG.
AUFGABE: Die Implementierungen oben müssen erweitert werden, um „format“ und „rescale“ zu unterstützen.
| Parameter |
displayId |
long: Die Anzeige-ID des Bildschirms, von dem ein Screenshot erstellt werden soll. |
getScreenshot
public InputStreamSource getScreenshot (String format)
Erstellt einen Screenshot vom Gerät.
Es wird empfohlen, stattdessen „getScreenshot(format)“ mit JPEG-Codierung zu verwenden, um die Größe zu verringern.
| Parameter |
format |
String: Unterstützte PNG- und JPEG-Dateien |
getScreenshot
public InputStreamSource getScreenshot ()
Erstellt einen Screenshot vom Gerät.
getSetting
public String getSetting (int userId,
String namespace,
String key)
Gibt den Wert der angeforderten Einstellung zurück.
Der Namespace muss einer der folgenden Werte sein: {"system", "secure", "global"}
| Parameter |
userId |
int |
namespace |
String |
key |
String |
| Returns |
String |
Der Wert, der mit dem Namespace:Schlüssel eines Nutzers verknüpft ist. Null, wenn nicht gefunden. |
getSetting
public String getSetting (String namespace,
String key)
Weitere Informationen finden Sie unter getSetting(int, String, String).
| Parameter |
namespace |
String |
key |
String |
getUninstallablePackageNames
public getUninstallablePackageNames ()
Ruft die Paketnamen der Anwendungen ab, die deinstalliert werden können. Derzeit sind das Nicht-Systempakete und aktualisierte Systempakete.
| Returns |
|
ERROR(/Set) der nicht deinstallierbaren String-Paketnamen, die derzeit auf dem Gerät installiert sind. |
getUserFlags
public int getUserFlags (int userId)
Sucht die Flags eines bestimmten Nutzers und gibt sie zurück.
Flags werden in der Klasse „android.content.pm.UserInfo“ im Open-Source-Projekt für Android definiert.
| Returns |
int |
Die mit der angegebenen userId verknüpften Flags, falls vorhanden, andernfalls -10000. |
getUserInfos
public getUserInfos ()
Ruft die Zuordnung von useId zu UserInfo auf dem Gerät ab. Löst DeviceRuntimeException aus, wenn die Ausgabe des Geräts nicht wie erwartet ist.
| Returns |
|
Die Liste der UserInfo-Objekte. |
getUserSerialNumber
public int getUserSerialNumber (int userId)
Gibt die dem userId zugeordnete Seriennummer zurück, 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: Das Format sollte „feature:“ oder direkt „“ sein. |
| Returns |
boolean |
„True“, wenn das Feature 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. Verfügbare 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 für Anwendungsfälle aufgerufen werden, die eine explizite Steuerung der Erteilung der Laufzeitberechtigung bei der Installation erfordern.
| Parameter |
packageFile |
File: die zu installierende APK-Datei |
certFile |
File: true, wenn eine Neuinstallation durchgeführt werden soll |
reinstall |
boolean: Gibt an, ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen. |
extraArgs |
String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“. |
| 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 für Anwendungsfälle aufgerufen werden, die eine explizite Steuerung der Erteilung der Laufzeitberechtigung bei der Installation erfordern.
| Parameter |
packageFile |
File: die zu installierende APK-Datei |
reinstall |
boolean: true, wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions |
boolean: Gibt an, ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen. |
extraArgs |
String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“. |
| Returns |
String |
String mit einem Fehlercode oder null bei Erfolg. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
Installiert ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.
| Parameter |
packageFile |
File: die zu installierende APK-Datei |
reinstall |
boolean: true, wenn eine Neuinstallation durchgeführt werden soll |
userId |
int: Die Nutzer-ID als Ganzzahl, für die die Installation erfolgen soll. |
extraArgs |
String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“. |
| 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 Sie ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.
Hinweis: Diese Funktion sollte nur für Anwendungsfälle aufgerufen werden, die eine explizite Steuerung der Erteilung der Laufzeitberechtigung bei der Installation erfordern.
| Parameter |
packageFile |
File: die zu installierende APK-Datei |
reinstall |
boolean: true, wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions |
boolean: Gibt an, ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen. |
userId |
int: Die Nutzer-ID als Ganzzahl, für die die Installation erfolgen soll. |
extraArgs |
String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“. |
| Returns |
String |
String mit einem Fehlercode oder null bei Erfolg. |
installPackageWithIncrementalMode
public boolean installPackageWithIncrementalMode (File[] apkFiles,
String[] extraArgs,
String userId)
Installiert APKs im inkrementellen Modus.
| Parameter |
apkFiles |
File: die zu installierenden APK-Dateien. |
extraArgs |
String |
userId |
String |
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,
int userId,
String... extraArgs)
| Parameter |
packageFiles |
|
reinstall |
boolean |
userId |
int |
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 |
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-Aufzählung unterstützt wird, andernfalls „false“ |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Gibt zurück, ob auf dem Gerät der monitorlose Systemnutzermodus verwendet wird.
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Gibt zurück, ob der Hauptnutzer ein permanenter Administrator ist und nicht gelöscht oder auf den Status „Kein Administrator“ herabgestuft werden kann.
isMultiUserSupported
public boolean isMultiUserSupported ()
Gibt an, ob mehrere Nutzer unterstützt werden.
| Returns |
boolean |
„true“, wenn die Funktion für mehrere Nutzer unterstützt wird, andernfalls „false“ |
isPackageInstalled
public boolean isPackageInstalled (String packageName,
String userId)
Fragen Sie das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID ab, um zu prüfen, ob die App für diesen Nutzer derzeit installiert ist.
| Parameter |
packageName |
String: Das Paket, für das wir prüfen, ob es installiert ist. |
userId |
String: Die Nutzer-ID, für die wir prüfen, ob das Paket installiert ist. Wenn null, wird der primäre Nutzer 0 verwendet. |
| Returns |
boolean |
„True“, wenn das Paket als installiert gemeldet wird. ansonsten „falsch“. |
isPackageInstalled
public boolean isPackageInstalled (String packageName)
Fragen Sie das Gerät nach einem bestimmten Paketnamen, um zu prüfen, ob das Paket derzeit installiert ist.
| Parameter |
packageName |
String |
| Returns |
boolean |
„True“, wenn das Paket als installiert gemeldet wird. ansonsten „falsch“. |
isUserRunning
public boolean isUserRunning (int userId)
Prüfen, ob ein bestimmter Nutzer aktiv ist.
| Returns |
boolean |
„True“, wenn der Nutzer läuft, andernfalls „false“. |
isUserSecondary
public boolean isUserSecondary (int userId)
Gibt zurück, ob der angegebene Nutzer anhand seiner Flags ein sekundärer Nutzer ist.
| Returns |
boolean |
„true“, wenn der Nutzer sekundär 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 Launch-Aktivitäten (in der Regel auf dem Standarddisplay) starten kann.
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
Prüft, ob der angegebene Nutzer auf dem angegebenen Display sichtbar ist.
Ein „sichtbarer“ Nutzer ist ein Nutzer, der mit dem „menschlichen“ Nutzer interagiert und daher Aktivitäten auf diesem Display starten kann.
| Parameter |
userId |
int |
displayId |
int |
listDisplayIds
public listDisplayIds ()
Erfassen Sie die Liste der verfügbaren Display-IDs auf dem Gerät, wie von „dumpsys SurfaceFlinger“ gemeldet.
| Returns |
|
Die Liste der Displays. „Default“ gibt immer das Standarddisplay 0 zurück. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
Ruft die Liste der Displays ab, 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. Löst DeviceRuntimeException aus, wenn die Ausgabe des Geräts nicht wie erwartet ist.
| Returns |
|
die Liste der Nutzer-IDs. |
logBugreport
public boolean logBugreport (String dataName,
ITestLogger listener)
Hilfsmethode zum Erstellen eines Fehlerberichts und Protokollieren des Berichts für die Reporter.
| Parameter |
dataName |
String: Der Name, unter dem der Fehlerbericht gemeldet wird. |
listener |
ITestLogger: eine ITestLogger zum Protokollieren des Fehlerberichts. |
| 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 gerätespezifische erforderliche Bereinigung, die nach dem Aufruf ausgeführt werden.
| Parameter |
exception |
Throwable: Falls vorhanden, die endgültige Ausnahme, die durch den Aufruffehler ausgelöst wurde. |
removeAdmin
public boolean removeAdmin (String componentName,
int userId)
Entfernt den angegebenen Geräteadministrator für den angegebenen Nutzer und gibt true zurück, wenn der Vorgang erfolgreich war, andernfalls false.
| Parameter |
componentName |
String: des zu entfernenden Geräteadministrators. |
userId |
int: des Nutzers, in dem sich der Geräteadministrator befindet. |
| Returns |
boolean |
„True“, wenn erfolgreich, andernfalls „false“. |
removeOwners
public void removeOwners ()
Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen.
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 erfolgreich entfernt wurde, andernfalls „false“. |
setDeviceOwner
public boolean setDeviceOwner (String componentName,
int userId)
Legt eine Geräteadministrator-Komponente als Geräteinhaber für einen bestimmten Nutzer fest.
| Parameter |
componentName |
String: des Geräteadministrators als Geräteinhaber. |
userId |
int: des Nutzers, in dem der Geräteinhaber lebt. |
| Returns |
boolean |
„True“, wenn erfolgreich, andernfalls „false“. |
setFirstBootloaderReboot
public void setFirstBootloaderReboot ()
setSetting
public void setSetting (String namespace,
String key,
String value)
Weitere Informationen finden Sie unter setSetting(int, String, String, String).
| Parameter |
namespace |
String |
key |
String |
value |
String |
setSetting
public void setSetting (int userId,
String namespace,
String key,
String value)
Fügen Sie dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzu. Einige Einstellungen sind erst nach einem Neustart verfügbar.
Der Namespace muss einer der folgenden Werte sein: {"system", "secure", "global"}
| Parameter |
userId |
int |
namespace |
String |
key |
String |
value |
String |
shutdownMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Fährt das Microdroid-Gerät herunter, falls es vorhanden ist.
| Parameter |
microdroidDevice |
ITestDevice |
startUser
public boolean startUser (int userId)
Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit beendet 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 erfolgreich im Hintergrund gestartet wurde. |
startUser
public boolean startUser (int userId,
boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit beendet ist. Wenn der Nutzer bereits im Hintergrund ausgeführt wird, ist diese Methode ein NOOP. Es ist möglich, ein zusätzliches Flag anzugeben, um zu warten, bis der Vorgang wirksam wird.
| Parameter |
userId |
int: des Nutzers, der im Hintergrund gestartet werden soll |
waitFlag |
boolean: Der Befehl wird erst ausgeführt, wenn der Nutzer gestartet und entsperrt wurde. |
| Returns |
boolean |
„true“, wenn der Nutzer erfolgreich im Hintergrund gestartet wurde. |
startVisibleBackgroundUser
public boolean startVisibleBackgroundUser (int userId,
int displayId,
boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, der auf dem angegebenen Display sichtbar ist (d.h. der Nutzer kann Aktivitäten auf diesem Display starten).
HINWEIS : Mit diesem Befehl wird nicht geprüft, ob der Nutzer vorhanden ist, ob die Anzeige verfügbar ist, ob device supports such feature usw.
| Parameter |
userId |
int: des Nutzers, der im Hintergrund gestartet werden soll |
displayId |
int: Display, auf dem der Nutzer die Anzeige sehen soll |
waitFlag |
boolean: Der Befehl wird erst ausgeführt, wenn der Nutzer gestartet und entsperrt wurde. |
| Returns |
boolean |
true, wenn der Nutzer erfolgreich im Hintergrund gestartet wurde. |
stopUser
public boolean stopUser (int userId)
Stoppt einen bestimmten Nutzer. Wenn der Nutzer bereits angehalten wurde, ist diese Methode ein NOOP.
Der aktuelle Nutzer und der Systemnutzer können nicht beendet werden.
| Parameter |
userId |
int: des Nutzers, der gestoppt werden soll. |
| Returns |
boolean |
„true“, wenn der Nutzer erfolgreich gestoppt wurde. |
stopUser
public boolean stopUser (int userId,
boolean waitFlag,
boolean forceFlag)
Einen bestimmten Nutzer stoppen. Es ist möglich, zusätzliche Flags anzugeben, um zu warten, bis der Vorgang wirksam wird, und den Nutzer zu beenden. Der aktuelle Nutzer und der Systemnutzer können nicht beendet werden.
| Parameter |
userId |
int: des Nutzers, der gestoppt werden soll. |
waitFlag |
boolean: Der Befehl wartet, bis der Nutzer gestoppt wurde. |
forceFlag |
boolean: Der Nutzer wird zum Beenden gezwungen. |
| Returns |
boolean |
„true“, wenn der Nutzer erfolgreich gestoppt wurde. |
supportsMicrodroid
public boolean supportsMicrodroid ()
Prüft die Voraussetzungen für die Ausführung eines Microdroid.
| Returns |
boolean |
Gibt „true“ zurück, wenn die Vorbedingungen erfüllt sind, andernfalls „false“. |
supportsMicrodroid
public boolean supportsMicrodroid (boolean protectedVm)
Prüft die Voraussetzungen für die Ausführung eines Microdroid.
| Parameter |
protectedVm |
boolean: „true“, wenn der Microdroid auf einer geschützten VM ausgeführt werden soll. |
| Returns |
boolean |
Gibt „true“ zurück, wenn die Vorbedingungen erfüllt sind, andernfalls „false“. |
switchUser
public boolean switchUser (int userId)
Wechseln Sie mit einem Standard-Timeout zu einer anderen userId. switchUser(int, long).
| Returns |
boolean |
„True“, wenn die neue User-ID mit dem User-ID-Anbieter übereinstimmt. ansonsten „falsch“. |
switchUser
public boolean switchUser (int userId,
long timeout)
Wechseln Sie innerhalb des angegebenen Zeitlimits zu einer anderen Nutzer-ID.
Versuche, Keyguard zu deaktivieren, nachdem der Nutzerwechsel erfolgreich war.
| Parameter |
userId |
int |
timeout |
long: Die Wartezeit, bevor „false“ für „switch-user failed“ zurückgegeben wird. |
| Returns |
boolean |
„True“, wenn die neue User-ID mit dem User-ID-Anbieter übereinstimmt. ansonsten „falsch“. |
takeBugreport
public Bugreport takeBugreport ()
Erstellt einen Fehlerbericht und gibt ihn in einem Bugreport-Objekt zurück, um ihn zu verarbeiten. Gibt bei Problemen „null“ zurück. Dateien, auf die im Bugreport-Objekt verwiesen wird, müssen über Bugreport.close() bereinigt werden.
uninstallPackage
public String uninstallPackage (String packageName)
Ein Android-Paket vom Gerät deinstallieren.
| Parameter |
packageName |
String: das Android-Paket, das deinstalliert werden soll |
| Returns |
String |
String mit einem Fehlercode oder null bei Erfolg. |
uninstallPackageForUser
public String uninstallPackageForUser (String packageName,
int userId)
Deinstalliert ein Android-Paket für einen bestimmten Nutzer von einem Gerät.
| Parameter |
packageName |
String: das Android-Paket, das deinstalliert werden soll |
userId |
int: Die Nutzer-ID als Ganzzahl, für die die Deinstallation erfolgen soll. |
| Returns |
String |
String mit einem Fehlercode oder null bei Erfolg. |
waitForSnapuserd
public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)
| Parameter |
currentPhase |
SnapuserdWaitPhase |
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 ZIP-Datei „bugreportz“ als ERROR(/File).
getCheckNewUserSleep
protected long getCheckNewUserSleep ()
Für Tests verfügbar gemacht.
getHostCurrentTime
protected long getHostCurrentTime ()
Für Tests verfügbar gemacht
prePostBootSetup
protected void prePostBootSetup ()
Ermöglicht es jedem Gerätetyp (AndroidNativeDevice, TestDevice), diese Methode für die spezifische Einrichtung nach dem Booten zu überschreiben.