TestGerät
public
class
TestDevice
extends NativeDevice
Bekannte direkte abgeleitete Klassen
|
Bekannte indirekte abgeleitete Klassen
|
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 zurück, ob ein Wechsel zum monitorlosen SYSTEM-Nutzer zulässig ist.
|
boolean
|
clearErrorDialogs()
Versuchen Sie, alle Fehlerdialogfelder zu schließen, die derzeit auf der Geräte-UI 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()
Versucht, den Keyguard zu deaktivieren.
|
boolean
|
doesFileExist(String deviceFilePath)
Hilfsmethode zum Ermitteln, ob eine Datei auf dem Gerät vorhanden ist.
|
boolean
|
doesFileExist(String deviceFilePath, int userId)
Hilfsmethode, um festzustellen, ob für einen bestimmten Nutzer eine Datei auf dem Gerät vorhanden ist.
|
File
|
dumpHeap(String process, String devicePath)
Dump des Heaps vom system_server.
|
|
getActiveApexes()
Rufen Sie die Informationen zu den auf dem Gerät aktivierten APEXes ab.
|
|
getAllSettings(String namespace)
Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück.
|
String
|
getAndroidId(int userId)
Sucht nach der mit einer userId verknüpften Android-ID und gibt sie zurück. Wenn sie nicht gefunden wird, null.
|
|
getAndroidIds()
Erstellen Sie eine Karte mit Android-IDs, die mit Nutzer-IDs übereinstimmen.
|
PackageInfo
|
getAppPackageInfo(String packageName)
Informationen zu einem auf dem Gerät installierten Paket abrufen
|
|
getAppPackageInfos()
Informationen zu Paketen abrufen, die auf dem Gerät installiert sind
|
InputStreamSource
|
getBugreport()
Ruft einen Fehlerbericht vom Gerät ab.
|
InputStreamSource
|
getBugreportz()
Ruft einen Fehlerbericht vom Gerät ab
|
DeviceFoldableState
|
getCurrentFoldableState()
Gibt den aktuellen faltbaren Status des Geräts oder null zurück, wenn Probleme aufgetreten sind.
|
int
|
getCurrentUser()
Gibt die ID des aktuell ausgeführten Nutzers zurück.
|
|
getFoldableStates()
Gibt die Liste der Status des faltbaren Geräts zurück.
|
|
getInstalledPackageNames()
Rufen Sie die auf dem Gerät vorhandenen App-Paketnamen 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()
Rufen Sie die Informationen zu den auf dem Gerät installierten Mainline-Modulen ab.
|
int
|
getMaxNumberOfRunningUsersSupported()
Holen Sie sich die maximale Anzahl von Nutzern, die gleichzeitig ausgeführt werden.
|
int
|
getMaxNumberOfUsersSupported()
Rufen Sie die maximale Anzahl der unterstützten Nutzer ab.
|
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 vom Gerät.
|
InputStreamSource
|
getScreenshot(String format)
Erstellt einen Screenshot vom Gerät.
|
InputStreamSource
|
getScreenshot(long displayId)
Erstellt einen Screenshot von der Geräteanzeige-ID.
|
String
|
getSetting(String namespace, String key)
Siehe getSetting(int, String, String) und wird für einen Systemnutzer ausgeführt.
|
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)
Findet die Flags eines bestimmten Nutzers und gibt sie zurück.
|
|
getUserInfos()
Ruft die Map of useId zu UserInfo auf dem Gerät ab.
|
int
|
getUserSerialNumber(int userId)
Gibt die Seriennummer zurück, die der userId zugeordnet ist, wenn sie gefunden wird; in allen anderen Fällen -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)
Ein Android-Paket für einen bestimmten Nutzer auf dem Gerät installieren
|
String
|
installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs)
Ein Android-Paket für einen bestimmten Nutzer auf dem Gerät installieren
|
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 Auflistung von Apps unterstützt
|
boolean
|
isHeadlessSystemUserMode()
Gibt an, ob das Gerät den monitorlosen Systemnutzermodus verwendet.
|
boolean
|
isMainUserPermanentAdmin()
Gibt zurück, ob der Hauptnutzer ein dauerhafter Administrator ist und nicht gelöscht oder herabgestuft werden kann auf
Nicht-Administrator-Status.
|
boolean
|
isMultiUserSupported()
Legt fest, ob mehrere Nutzer unterstützt werden.
|
boolean
|
isPackageInstalled(String packageName)
Fragen Sie das Gerät nach einem bestimmten Paketnamen ab, um zu prüfen, ob es derzeit installiert ist.
|
boolean
|
isPackageInstalled(String packageName, String userId)
Fragen Sie das Gerät nach einem bestimmten Paketnamen und Nutzer-ID ab, um zu prüfen, ob es sich derzeit
installiert haben oder nicht.
|
boolean
|
isUserRunning(int userId)
Prüfen Sie, ob ein bestimmter Nutzer ausgeführt wird.
|
boolean
|
isUserSecondary(int userId)
Gibt zurück, 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 auf dem Gerät Nutzer gestartet werden können, die im Hintergrund im ERROR(/java.android.view.Display#DEFAULT_DISPLAY) sichtbar sind.
|
boolean
|
isVisibleBackgroundUsersSupported()
Gibt an, ob auf dem Gerät Nutzer im Hintergrund sichtbar gemacht werden können.
|
|
listDisplayIds()
Sammeln Sie die Liste der verfügbaren Anzeige-IDs auf dem Gerät, wie von „dumpsys“ gemeldet.
SurfaceFlinger“.
|
|
listDisplayIdsForStartingVisibleBackgroundUsers()
Ruft die Liste der Bildschirme ab, die zum 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 gerätespezifische erforderliche Bereinigung, die nach dem Aufruf ausgeführt wird
fertig ist.
|
boolean
|
removeAdmin(String componentName, int userId)
Den angegebenen Geräteadministrator für den Nutzer entfernen und true zurückgeben, wenn der Vorgang erfolgreich war, andernfalls false .
|
void
|
removeOwners()
Entfernen Sie nach Möglichkeit alle vorhandenen Geräteprofileigentümer.
|
boolean
|
removeUser(int userId)
Einen bestimmten Nutzer vom Gerät entfernen
|
boolean
|
setDeviceOwner(String componentName, int userId)
Komponente zur Geräteverwaltung für einen bestimmten Nutzer als Geräteinhaber festlegen
|
void
|
setSetting(String namespace, String key, String value)
Siehe setSetting(int, String, String, String) und wird für einen Systemnutzer ausgeführt.
|
void
|
setSetting(int userId, String namespace, String key, String value)
Fügt dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzu.
|
void
|
shutdownMicrodroid(ITestDevice microdroidDevice)
Fährt das Mikrodroid-Gerät herunter, falls vorhanden.
|
boolean
|
startUser(int userId)
Startet einen bestimmten Nutzer im Hintergrund, wenn er aktuell beendet ist.
|
boolean
|
startUser(int userId, boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, wenn er aktuell beendet ist.
|
boolean
|
startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, der auf dem jeweiligen Display sichtbar ist (d.h. der Nutzer kann
um Aktivitäten in dieser Anzeige zu 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 zum Ausführen eines Mikrodroids.
|
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()
Erstellen Sie einen Fehlerbericht und geben Sie ihn in einem Bugreport -Objekt zurück, um ihn zu verarbeiten.
|
String
|
uninstallPackage(String packageName)
Android-Paket vom Gerät deinstallieren
|
String
|
uninstallPackageForUser(String packageName, int userId)
Android-Paket für einen bestimmten Nutzer vom Gerät deinstallieren
|
void
|
waitForSnapuserd(SnapuserdWaitPhase currentPhase)
|
Felder
KEYGUARD_CMD_SCHLIEẞEN
public static final String DISMISS_KEYGUARD_CMD
Befehle, mit denen der Keyguard geschlossen werden kann.
Öffentliche Konstruktoren
Öffentliche Methoden
canSwitchToHeadlessSystemUser
public boolean canSwitchToHeadlessSystemUser ()
Gibt zurück, ob ein 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 . |
Nutzer erstellen
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 |
Ganzzahl für die erstellte User-ID |
Nutzer erstellen
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 : aktiviert das Nutzer-Flag --guest während der Erstellung. |
ephemeral |
boolean : aktiviert das Nutzer-Flag „--sitzungsspezifisch“ beim Erstellen |
forTesting |
boolean : aktiviert das Test-Flag „--for-testing“ beim Erstellen |
Returns |
int |
ID des erstellten Nutzers |
Nutzer erstellen
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 : aktiviert das Nutzer-Flag --guest während der Erstellung. |
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 |
Ganzzahl für die erstellte User-ID oder -1 für Fehler. |
Keyguard deaktivieren
public void disableKeyguard ()
Versucht, den Keyguard zu deaktivieren.
Warten Sie zuerst, bis die Eingabe-Weiterleitung bereit ist. Dies geschieht ungefähr zur gleichen Zeit,
Gerät meldet BOOT_COMPLETE, offenbar asynchron, da das aktuelle Framework
-Implementierung eine gelegentliche Race-Bedingung aufweist. Anschließend wird der Befehl zum Schließen von Keyguard gesendet (funktioniert
nur für nicht sichere)
tutFileExist
public boolean doesFileExist (String deviceFilePath)
Hilfsmethode zum Ermitteln, ob eine Datei auf dem Gerät vorhanden ist.
Parameter |
deviceFilePath |
String : der absolute Pfad der zu prüfenden Datei auf dem Gerät |
Returns |
boolean |
true , wenn die Datei vorhanden ist, andernfalls false . |
tutFileExist
public boolean doesFileExist (String deviceFilePath,
int userId)
Hilfsmethode, um festzustellen, ob für einen bestimmten Nutzer eine Datei auf dem Gerät 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 Existenz der Datei geprüft werden soll. |
Returns |
boolean |
true , wenn die Datei vorhanden ist, andernfalls false . |
DumpHeap
public File dumpHeap (String process,
String devicePath)
Dump des Heaps vom system_server. Es liegt in der Verantwortung des Anrufers,
aus der dumpdatei.
Parameter |
process |
String : der Name des Geräteprozesses, für den Dumpheap durchgeführt werden soll. |
devicePath |
String : Pfad auf dem Gerät, in dem der Dump gespeichert wird Dabei muss es sich um einen Ort handeln, an dem
erlauben. |
Returns |
File |
Die ERROR(/File) , die 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 |
|
der Schlüssel/Wert-Paare. Null, wenn der Namespace nicht unterstützt wird. |
getAndroidId (GetAndroid-ID)
public String getAndroidId (int userId)
Sucht nach der mit einer userId verknüpften Android-ID und gibt sie zurück. Wenn sie nicht gefunden wird, null.
getAndroidIds (Abrufen von Android-IDs)
public getAndroidIds ()
Erstellen Sie eine Karte mit Android-IDs, die mit Nutzer-IDs übereinstimmen. Es gibt keine Versicherung, dass jeder Nutzer
id sucht eine Android-ID, die mit dieser Funktion verknüpft ist, sodass einige Nutzer-IDs mit null übereinstimmen können.
Returns |
|
Karte mit 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 (App-Paketinformationen abrufen)
public getAppPackageInfos ()
Informationen zu Paketen abrufen, die auf dem Gerät installiert sind
getBugreport
public InputStreamSource getBugreport ()
Ruft einen Fehlerbericht vom Gerät ab.
Die Implementierung funktioniert auf Geräten ohne SD-Karte garantiert weiterhin
(oder wo die SD-Karte noch nicht bereitgestellt ist).
getBugreportz
public InputStreamSource getBugreportz ()
Ruft einen Fehlerbericht vom Gerät ab Der Fehlerbericht im ZIP-Format enthält den Hauptfehlerbericht und
anderen Protokolldateien, die für die Fehlerbehebung nützlich sind.
Nur unterstützt für „adb version“ > 1.0.36
getCurrentFoldableState
public DeviceFoldableState getCurrentFoldableState ()
Gibt den aktuellen faltbaren Status des Geräts oder null zurück, wenn Probleme aufgetreten sind.
getCurrentUser
public int getCurrentUser ()
Gibt die ID des aktuell ausgeführten Nutzers zurück. Geben Sie im Fall eines Fehlers -10000 zurück.
getFoldableStates
public getFoldableStates ()
Gibt die Liste der Status des faltbaren Geräts zurück. Kann mit „cmd device_state“ abgerufen werden
print-states".
GetInstalldPackageNames
public getInstalledPackageNames ()
Rufen Sie die auf dem Gerät vorhandenen App-Paketnamen ab.
Returns |
|
ERROR(/Set) von String Paketnamen, die momentan 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 ()
Rufen Sie die Informationen zu den auf dem Gerät installierten Mainline-Modulen ab.
Returns |
|
Derzeit sind ERROR(/Set) von String Mainline-Modulen auf dem Gerät installiert. |
public int getMaxNumberOfRunningUsersSupported ()
Holen Sie sich die maximale Anzahl von Nutzern, die gleichzeitig ausgeführt werden. Die Standardeinstellung ist 0.
Returns |
int |
Eine Ganzzahl, die die Anzahl der gleichzeitig aktiven Nutzer angibt |
public int getMaxNumberOfUsersSupported ()
Rufen Sie die maximale Anzahl der unterstützten Nutzer ab. 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 primären Nutzers (falls vorhanden) und null, wenn kein Primärnutzer vorhanden ist |
getScreenshot
public InputStreamSource getScreenshot ()
Erstellt einen Screenshot vom Gerät.
getScreenshot
public InputStreamSource getScreenshot (String format,
boolean rescale)
Erstellt einen Screenshot vom Gerät. Es wird empfohlen, stattdessen getScreenshot(String)
zu verwenden
mit JPEG-Codierung für eine kleinere Größe.
Parameter |
format |
String : unterstützte PNG- und JPEG-Dateien |
rescale |
boolean : ob der Screenshot neu skaliert werden soll, um die Größe des resultierenden Bildes zu verringern |
getScreenshot
public InputStreamSource getScreenshot (String format)
Erstellt einen Screenshot vom Gerät.
Es wird empfohlen, stattdessen getScreenshot(format) mit der JPEG-Codierung für eine kleinere Größe zu verwenden.
Parameter |
format |
String : unterstützte PNG- und JPEG-Dateien |
getScreenshot
public InputStreamSource getScreenshot (long displayId)
Erstellt einen Screenshot von der Geräteanzeige-ID. Das Format ist PNG.
TODO: Implementierungen oben so erweitern, dass "format" unterstützt wird und „Neu skalieren“
Parameter |
displayId |
long : die Anzeige-ID des Bildschirms, von dem ein Screenshot erstellt werden soll. |
getSetting
public String getSetting (String namespace,
String key)
Siehe getSetting(int, String, String)
und wird für einen Systemnutzer ausgeführt.
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 einen der folgenden Werte haben: {"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 ist derzeit definiert als
nicht systemunabhängige Pakete
und aktualisierte Systempakete.
getUserFlags
public int getUserFlags (int userId)
Findet die Flags eines bestimmten Nutzers und gibt sie zurück.
Flags sind in „android.content.pm.UserInfo“ definiert im Android Open Source Project.
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 der userId zugeordnet ist, wenn sie gefunden wird; in allen anderen Fällen -10000.
hasFeature
public boolean hasFeature (String feature)
Prüfen, ob eine Funktion auf einem Gerät verfügbar ist
Parameter |
feature |
String : das Format, das „feature:“ sein sollte oder "" . |
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. Siehe "adb shell pm -h" für verfügbare
Optionen. |
Returns |
String |
einen String mit einem Fehlercode oder null , wenn der Vorgang erfolgreich ist. |
installPackage
public String installPackage (File packageFile,
boolean reinstall,
boolean grantPermissions,
String... extraArgs)
Installieren Sie ein Android-Paket auf dem Gerät.
Hinweis: Nur Anwendungsfälle, die eine ausdrückliche Kontrolle über die Gewährung von Laufzeitberechtigungen erfordern
sollte diese Funktion aufgerufen werden.
Parameter |
packageFile |
File : die zu installierende APK-Datei |
reinstall |
boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions |
boolean : wenn bei der Installation alle Laufzeitberechtigungen gewährt werden sollen |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Siehe "adb shell pm -h" für verfügbare
Optionen. |
Returns |
String |
einen String mit einem Fehlercode oder null , wenn der Vorgang erfolgreich ist. |
installPackage
public String installPackage (File packageFile,
File certFile,
boolean reinstall,
String... extraArgs)
Installieren Sie ein Android-Paket auf dem Gerät.
Hinweis: Nur Anwendungsfälle, die eine ausdrückliche Kontrolle über die Gewährung von Laufzeitberechtigungen erfordern
sollte diese Funktion aufgerufen werden.
Parameter |
packageFile |
File : die zu installierende APK-Datei |
certFile |
File : true , wenn eine Neuinstallation durchgeführt werden soll |
reinstall |
boolean : wenn bei der Installation alle Laufzeitberechtigungen gewährt werden sollen |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Siehe "adb shell pm -h" für verfügbare
Optionen. |
Returns |
String |
einen String mit einem Fehlercode oder null , wenn der Vorgang erfolgreich ist. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
boolean grantPermissions,
int userId,
String... extraArgs)
Ein Android-Paket für einen bestimmten Nutzer auf dem Gerät installieren
Hinweis: Nur Anwendungsfälle, die eine ausdrückliche Kontrolle über die Gewährung von Laufzeitberechtigungen erfordern
sollte diese Funktion aufgerufen werden.
Parameter |
packageFile |
File : die zu installierende APK-Datei |
reinstall |
boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
grantPermissions |
boolean : wenn bei der Installation alle Laufzeitberechtigungen gewährt werden sollen |
userId |
int : die ganzzahlige Nutzer-ID, für die die Installation durchgeführt werden soll. |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Siehe "adb shell pm -h" für verfügbare
Optionen. |
Returns |
String |
einen String mit einem Fehlercode oder null , wenn der Vorgang erfolgreich ist. |
installPackageForUser
public String installPackageForUser (File packageFile,
boolean reinstall,
int userId,
String... extraArgs)
Ein Android-Paket für einen bestimmten Nutzer auf dem Gerät installieren
Parameter |
packageFile |
File : die zu installierende APK-Datei |
reinstall |
boolean : true , wenn eine Neuinstallation durchgeführt werden soll |
userId |
int : die ganzzahlige Nutzer-ID, für die die Installation durchgeführt werden soll. |
extraArgs |
String : Optionale zusätzliche Argumente, die übergeben werden sollen. Siehe "adb shell pm -h" für verfügbare
Optionen. |
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 Auflistung von Apps unterstützt
Returns |
boolean |
„True“, wenn die App-Enumeration unterstützt wird, andernfalls „False“ |
isHeadlessSystemUserMode
public boolean isHeadlessSystemUserMode ()
Gibt an, ob das Gerät den monitorlosen Systemnutzermodus verwendet.
isMainUserPermanentAdmin
public boolean isMainUserPermanentAdmin ()
Gibt zurück, ob der Hauptnutzer ein dauerhafter Administrator ist und nicht gelöscht oder herabgestuft werden kann auf
Nicht-Administrator-Status.
isMultiUserSupported
public boolean isMultiUserSupported ()
Legt fest, ob mehrere Nutzer unterstützt werden.
Returns |
boolean |
„true“, wenn mehrere Nutzer unterstützt werden, andernfalls „false“ |
isPackageInstalliert
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 |
„True“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“. |
isPackageInstalliert
public boolean isPackageInstalled (String packageName,
String userId)
Fragen Sie das Gerät nach einem bestimmten Paketnamen und Nutzer-ID ab, um zu prüfen, ob es sich derzeit
installiert haben oder nicht.
Parameter |
packageName |
String : Das Paket, das geprüft wird, ob es installiert ist. |
userId |
String : Die Nutzer-ID, auf die geprüft wird, ob das Paket installiert ist. Wenn null, ist der primäre Nutzer
0 verwendet. |
Returns |
boolean |
„True“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“. |
isUserRunning
public boolean isUserRunning (int userId)
Prüfen Sie, ob ein bestimmter Nutzer ausgeführt wird.
Returns |
boolean |
"True", wenn der Nutzer ausgeführt wird, "False" in allen anderen Fällen. |
istUserSekundär
public boolean isUserSecondary (int userId)
Gibt zurück, 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 „sichtbares“ Nutzende sind Nutzende,
die mit dem „Menschen“ interagieren, Nutzende und ist daher in der Lage,
Startaktivitäten starten (normalerweise in der Standardanzeige)
isUserVisibleOnDisplay
public boolean isUserVisibleOnDisplay (int userId,
int displayId)
Prüft, ob der angegebene Nutzer auf dem Display sichtbar ist.
Ein „sichtbares“ Nutzende sind Nutzende,
die mit dem „Menschen“ interagieren, Nutzende und ist daher in der Lage,
Markteinführungsaktivitäten in dieser Anzeige.
Parameter |
userId |
int |
displayId |
int |
listDisplayIds
public listDisplayIds ()
Sammeln Sie die Liste der verfügbaren Anzeige-IDs auf dem Gerät, wie von „dumpsys“ gemeldet.
SurfaceFlinger“.
Returns |
|
Die Liste der Bildschirme. Die Standardeinstellung gibt immer die Standardanzeige 0 zurück. |
listDisplayIdsForStartingVisibleBackgroundUsers
public listDisplayIdsForStartingVisibleBackgroundUsers ()
Ruft die Liste der Bildschirme ab, die zum start a user visible in the background
verwendet werden können.
Nutzer auflisten
public listUsers ()
Ruft die Liste der Nutzer auf dem Gerät ab. Gibt bei Ausgabe DeviceRuntimeException
aus
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 bei den Reportern zu protokollieren.
Parameter |
dataName |
String ist der Name, unter dem der Fehlerbericht gemeldet wird. |
listener |
ITestLogger : Ein ITestLogger zum Protokollieren des Fehlerberichts. |
Returns |
boolean |
Der Wert ist "True", wenn das Logging erfolgreich war, andernfalls "False". |
BenachrichtigenSnapuserd
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 wird
fertig ist.
Parameter |
exception |
Throwable : falls vorhanden, die letzte durch den Aufruffehler ausgelöste Ausnahme. |
Admin entfernen
public boolean removeAdmin (String componentName,
int userId)
Den angegebenen Geräteadministrator für den Nutzer entfernen und true
zurückgeben, wenn der Vorgang erfolgreich war, andernfalls false
.
Parameter |
componentName |
String : des Geräteadministrators, der entfernt werden soll |
userId |
int : des Nutzers, in dem der Geräteadministrator lebt. |
Returns |
boolean |
„True“, wenn der Vorgang erfolgreich ist, andernfalls „False“. |
Inhaber entfernen
public void removeOwners ()
Entfernen Sie nach Möglichkeit alle vorhandenen Geräteprofileigentümer.
Nutzer entfernen
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. |
Geräteinhaber festlegen
public boolean setDeviceOwner (String componentName,
int userId)
Komponente zur Geräteverwaltung für einen bestimmten Nutzer als Geräteinhaber festlegen
Parameter |
componentName |
String : des Geräteadministrators wird der Geräteeigentümer sein. |
userId |
int : des Nutzers, in dem der Geräteeigentümer wohnt. |
Returns |
boolean |
„True“, wenn der Vorgang erfolgreich ist, andernfalls „False“. |
Einstellung festlegen
public void setSetting (String namespace,
String key,
String value)
Siehe setSetting(int, String, String, String)
und wird für einen Systemnutzer ausgeführt.
Parameter |
namespace |
String |
key |
String |
value |
String |
Einstellung festlegen
public void setSetting (int userId,
String namespace,
String key,
String value)
Fügt dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzu. Einige Einstellungen sind nur verfügbar
nach einem Neustart wieder.
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)
Fährt das Mikrodroid-Gerät herunter, falls vorhanden.
Parameter |
microdroidDevice |
ITestDevice |
startUser (Startnutzer)
public boolean startUser (int userId)
Startet einen bestimmten Nutzer im Hintergrund, wenn er aktuell beendet ist. Wenn der Nutzer bereits
im Hintergrund ausgeführt wird, ist diese Methode eine NOOP-Methode.
Parameter |
userId |
int : des Nutzers, der im Hintergrund gestartet werden soll |
Returns |
boolean |
true, wenn der Nutzer im Hintergrund gestartet wurde. |
startUser (Startnutzer)
public boolean startUser (int userId,
boolean waitFlag)
Startet einen bestimmten Nutzer im Hintergrund, wenn er aktuell beendet ist. Wenn der Nutzer bereits
im Hintergrund ausgeführt wird, ist diese Methode eine NOOP-Methode. Es kann ein zusätzliches Flag zur Verfügung gestellt werden, auf das gewartet werden soll.
damit 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 wird. |
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 Display sichtbar ist (d.h. der Nutzer kann
um Aktivitäten in dieser Anzeige zu starten).
HINWEIS : Mit diesem Befehl wird nicht geprüft, ob der Nutzer existiert, die Anzeige verfügbar ist, device supports such feature
usw.
Parameter |
userId |
int : des Nutzers, der im Hintergrund gestartet werden soll |
displayId |
int : Anzeige zum Starten des Nutzers sichtbar auf |
waitFlag |
boolean : Der Befehl wartet, bis der Nutzer gestartet und entsperrt wird. |
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, die warten, bis der Vorgang wirksam wird.
und die Beendigung des Nutzers zu erzwingen. Aktuellen Nutzer und Systemnutzer können nicht beendet werden.
Parameter |
userId |
int : des Nutzers, der beendet werden soll. |
waitFlag |
boolean : Der Befehl wartet, bis der Nutzer gestoppt wird. |
forceFlag |
boolean : erzwingt das Beenden des Nutzers. |
Returns |
boolean |
true, wenn der Nutzer erfolgreich beendet 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 |
true, wenn der Nutzer erfolgreich beendet wurde. |
unterstützt Microdroid
public boolean supportsMicrodroid ()
Prüft die Voraussetzungen zum Ausführen eines Mikrodroids.
Returns |
boolean |
gibt „true“ zurück, wenn die Vorbedingungen erfüllt sind, andernfalls „false“. |
unterstützt Microdroid
public boolean supportsMicrodroid (boolean protectedVm)
Prüft die Voraussetzungen zum Ausführen eines Mikrodroids.
Parameter |
protectedVm |
boolean : „true“, wenn 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)
Zu einer anderen Nutzer-ID mit Standardzeitlimit wechseln. switchUser(int, long)
.
Returns |
boolean |
"True", wenn die neue userId mit dem userId-Anbieter übereinstimmt. Andernfalls „false“. |
SwitchUser
public boolean switchUser (int userId,
long timeout)
Wechseln Sie zu einer anderen Nutzer-ID mit dem angegebenen Zeitlimit als Frist.
Es wurde versucht, den Keyguard zu deaktivieren, nachdem die Benutzeränderung erfolgreich war.
Parameter |
userId |
int |
timeout |
long : Warten, bis „false“ für Switch-User zurückgegeben wird. |
Returns |
boolean |
"True", wenn die neue userId mit dem userId-Anbieter übereinstimmt. Andernfalls „false“. |
TakeBugreport
public Bugreport takeBugreport ()
Erstellen Sie einen Fehlerbericht und geben Sie ihn in einem Bugreport
-Objekt zurück, um ihn zu verarbeiten. Null zurückgeben
wenn es ein Problem gibt. Die Datei, auf die im Fehlerbericht-Objekt verwiesen wird, muss mit Bugreport.close()
bereinigt werden.
Deinstallationspaket
public String uninstallPackage (String packageName)
Android-Paket vom Gerät deinstallieren
Parameter |
packageName |
String : das zu deinstallierende Android-Paket |
Returns |
String |
einen String mit einem Fehlercode oder null , wenn der Vorgang erfolgreich ist. |
deinstallierenPackageForUser
public String uninstallPackageForUser (String packageName,
int userId)
Android-Paket für einen bestimmten Nutzer vom Gerät deinstallieren
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)
doAdbNeustart
protected void doAdbReboot (NativeDevice.RebootMode rebootMode,
String reason)
Starten Sie ADB-Neustart.
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 ()
Wird zu Testzwecken zur Verfügung gestellt.
getHostCurrentTime
protected long getHostCurrentTime ()
Zu Testzwecken exponiert
PrePostBootSetup
protected void prePostBootSetup ()
Ermöglicht jedem Gerätetyp (AndroidNativeDevice, TestDevice), diese Methode für
nach der Boot-Einrichtung.