TestDevice
public
class
TestDevice
extends NativeDevice
Bekannte direkte Unterklassen
ManagedRemoteDevice |
Ein Gerät, das in einer virtuellen Maschine ausgeführt wird, die wir aus der Ferne über eine Tradefed-Instanz in 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 einer ITestDevice
für ein Full-Stack-Android-Gerät
Zusammenfassung
Felder |
public
static
final
String |
DISMISS_KEYGUARD_CMD
Befehle, mit denen der Sperrbildschirm 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)
Versuchen Sie, den Heap aus dem system_server zu dumpen.
|
|
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)
Ruft Informationen zu einem auf dem Gerät installierten Paket ab.
|
|
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 laufenden 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()
Gib ein Objekt zurück, um den aktuellen Status des Sperrbildschirms abzurufen, oder „null“, wenn er 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 auf dem 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 auf dem 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 Namen der Anwendungspakete ab, die deinstalliert werden können.
|
int
|
getUserFlags(int userId)
Die Markierungen eines bestimmten Nutzers suchen und zurückgeben.
|
|
getUserInfos()
Ruft die Zuordnung von „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)
Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer
|
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 auf dem Gerät der headless Systemnutzermodus verwendet wird.
|
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 im angegebenen Display sichtbar ist.
|
boolean
|
isVisibleBackgroundUsersOnDefaultDisplaySupported()
Gibt an, ob Nutzer auf dem Gerät in der 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 an die Meldenden zu senden.
|
void
|
notifySnapuserd(SnapuserdWaitPhase waitPhase)
|
void
|
postInvocationTearDown(Throwable exception)
Zusätzliche Schritte für die erforderliche gerätespezifische Bereinigung, die nach dem Aufruf ausgeführt werden.
|
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
|
setFirstBootloaderReboot()
|
void
|
setSetting(String namespace, String key, String value)
Siehe setSetting(int, String, String, String) und wird auf den Systemnutzer angewendet.
|
void
|
setSetting(int userId, String namespace, String key, String value)
Dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzufügen.
|
void
|
shutdownMicrodroid(ITestDevice microdroidDevice)
Schaltet das Microdroid-Gerät aus, 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, sodass der Nutzer Aktivitäten auf diesem Display starten kann.
|
boolean
|
stopUser(int userId, boolean waitFlag, boolean forceFlag)
Einen bestimmten Nutzer anhalten.
|
boolean
|
stopUser(int userId)
Stoppt einen bestimmten Nutzer.
|
boolean
|
supportsMicrodroid()
Prüft die Voraussetzungen für die Ausführung eines Microdroids.
|
boolean
|
supportsMicrodroid(boolean protectedVm)
Prüft die Voraussetzungen für die Ausführung eines Microdroids.
|
boolean
|
switchUser(int userId)
Wechseln Sie zu einer anderen userId mit einer Standardzeitüberschreitung.
|
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 : Aktivieren Sie beim Erstellen das Testflag „--for-testing“. |
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 : Aktivieren Sie beim Erstellen das Nutzerflag „--ephemeral“. |
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 User-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 Datei auf dem Gerät, die geprüft werden soll. |
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 erstellt 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 ()
Ruft die Informationen zu den auf dem Gerät aktivierten APEX-Objekten ab.
getAllSettings
public getAllSettings (String namespace)
Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück.
Parameter |
namespace |
String : Muss eine der folgenden Optionen 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
public getAndroidIds ()
Erstellen Sie eine Zuordnungstabelle mit den gefundenen Android-IDs und den zugehörigen User-IDs. 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)
Ruft Informationen zu einem auf dem Gerät installierten Paket ab.
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 Protokolldateien, 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 laufenden 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 ()
Ruft die Namen der Anwendungspakete auf dem Gerät ab.
Returns |
|
ERROR(/Set) von String Paketnamen, die derzeit auf dem Gerät installiert sind. |
getKeyguardState
public KeyguardControllerState getKeyguardState ()
Gib ein Objekt zurück, um den aktuellen Status des Sperrbildschirms 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 ()
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
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.
Wir empfehlen stattdessen die Verwendung von getScreenshot(format) mit JPEG-Codierung für eine kleinere Größe.
Parameter |
format |
String : unterstützt PNG, JPEG |
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 |
Der Wert, der mit dem namespace:key eines Nutzers verknüpft ist. Null, wenn nicht gefunden. |
getUninstallablePackageNames
public getUninstallablePackageNames ()
Rufen Sie die Namen der Anwendungspakete ab, die deinstalliert werden können. Derzeit sind das nicht systemeigene Pakete und aktualisierte Systempakete.
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 suchen und zurückgeben.
Flags werden in der Klasse „android.content.pm.UserInfo“ im Android Open Source-Projekt definiert.
Returns |
int |
die mit der angegebenen Nutzer-ID verknüpften Flags, falls gefunden, andernfalls -10000. |
getUserInfos
public getUserInfos ()
Ruft die Zuordnung von „useId“ zu „UserInfo
“ auf dem Gerät ab. Wird DeviceRuntimeException
ausgegeben, wenn die Ausgabe des Geräts 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 : Das Format sollte „feature:“ oder direkt „“ sein. |
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 erteilt 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 erteilt 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 erteilt 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 |
String mit einem Fehlercode oder null bei Erfolg. |
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-Aufzählung 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 an, ob der Hauptnutzer ein dauerhafter Administrator ist und nicht gelöscht oder auf den Status „Kein Administrator“ herabgestuft werden kann.
isMultiUserSupported
public boolean isMultiUserSupported ()
Bestimmt, ob die Nutzung durch mehrere Nutzer unterstützt wird.
Returns |
boolean |
„true“, wenn mehrere Nutzer unterstützt werden, andernfalls „false“ |
isPackageInstalled
public boolean isPackageInstalled (String packageName)
Das Gerät wird nach einem bestimmten Paketnamen abgefragt, um zu prüfen, ob es derzeit installiert ist.
Parameter |
packageName |
String |
Returns |
boolean |
„True“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“. |
isPackageInstalled
public 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.
Parameter |
packageName |
String : das 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 |
„True“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“. |
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 an, ob der angegebene Nutzer gemäß seinen 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 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. Wird DeviceRuntimeException
ausgegeben, 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 werden.
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 : der zu entfernenden Geräteverwaltung. |
userId |
int : des Nutzers, in dessen Land sich der Geräteadministrator befindet. |
Returns |
boolean |
„True“, wenn erfolgreich, andernfalls „false“. |
removeOwners
public void removeOwners ()
Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen nach Möglichkeit.
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 erfolgreich, andernfalls „false“. |
setFirstBootloaderReboot
public void setFirstBootloaderReboot ()
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 eine der folgenden Optionen sein: {"system", "secure", "global"}
Parameter |
userId |
int |
namespace |
String |
key |
String |
value |
String |
shutdownMicrodroid
public void shutdownMicrodroid (ITestDevice microdroidDevice)
Schaltet das Microdroid-Gerät aus, falls vorhanden.
Parameter |
microdroidDevice |
ITestDevice |
startUser
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 |
„wahr“, 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 |
„wahr“, 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 entsprechenden Display sichtbar ist, sodass der Nutzer Aktivitäten auf diesem Display starten kann.
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)
Einen bestimmten Nutzer anhalten. 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 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 angehalten hat, ist diese Methode ein NOOP.
Der aktuelle Nutzer und der Systemnutzer können nicht angehalten 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)
Wechseln Sie zu einer anderen userId mit einer Standardzeitüberschreitung. 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 : Wartezeit, bevor „false“ zurückgegeben wird, wenn der Wechsel des Nutzers fehlgeschlagen ist. |
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 Bugreport-Objekt 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 |
String mit einem Fehlercode oder null bei Erfolg. |
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 Ganzzahl-Nutzer-ID, 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 : 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 ()
Ermöglicht es jedem Gerätetyp (AndroidNativeDevice, TestDevice), diese Methode für die spezifische Einrichtung nach dem Start zu überschreiben.