Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Testgerät

public class TestDevice
extends NativeDevice

java.lang.Object
com.android.tradefed.device.NativeDevice
com.android.tradefed.device.TestDevice


Implementierung eines ITestDevice für ein Full-Stack-Android-Gerät

Zusammenfassung

Verschachtelte Klassen

class TestDevice.MicrodroidBuilder

Ein Builder zum Erstellen eines Microdroid-Testgeräts.

Felder

public static final String DISMISS_KEYGUARD_CMD

Befehle, die verwendet werden können, um die Tastensperre zu schließen.

Öffentliche Konstrukteure

TestDevice (IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Öffentliche Methoden

boolean clearErrorDialogs ()

Versuchen Sie, alle Fehlerdialoge zu schließen, die derzeit auf der Geräte-UI angezeigt werden.

int createUser (String name)

Erstellen Sie einen Benutzer mit einem bestimmten Namen und Standard-Flags 0.

int createUser (String name, boolean guest, boolean ephemeral)

Erstellen Sie einen Benutzer mit einem bestimmten Namen und den bereitgestellten Flags

int createUserNoThrow (String name)

Erstellen Sie einen Benutzer mit einem bestimmten Namen und Standard-Flags 0.

void disableKeyguard ()

Versucht, die Tastensperre zu deaktivieren.

boolean doesFileExist (String deviceFilePath)

Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät vorhanden ist.

boolean doesFileExist (String deviceFilePath, int userId)

Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät für einen bestimmten Benutzer vorhanden ist.

File dumpHeap (String process, String devicePath)

Versuchen Sie, den Heap vom system_server auszugeben.

getActiveApexes ()

Rufen Sie die Informationen zu APEXs ab, die auf dem Gerät aktiviert sind.

getAllSettings (String namespace)

Geben Sie Schlüsselwertpaare des angeforderten Namespace zurück.

String getAndroidId (int userId)

Suchen Sie die Android-ID, die einer Benutzer-ID zugeordnet ist, und geben Sie sie zurück, null, wenn sie nicht gefunden wird.

getAndroidIds ()

Erstellen Sie eine Karte mit Android-IDs, die übereinstimmende Benutzer-IDs gefunden haben.

PackageInfo getAppPackageInfo (String packageName)

Abrufen von Informationen zu einem auf dem Gerät installierten Paket.

getAppPackageInfos ()

Abrufen von Informationen zu Paketen, die auf dem Gerät installiert sind.

DeviceFoldableState getCurrentFoldableState ()

Gibt den aktuellen faltbaren Zustand des Geräts oder null zurück, wenn einige Probleme aufgetreten sind.

int getCurrentUser ()

Gibt die ID des aktuell ausgeführten Benutzers zurück.

getFoldableStates ()

Gibt die Liste der faltbaren Zustände auf dem Gerät zurück.

getInstalledPackageNames ()

Rufen Sie die auf dem Gerät vorhandenen Anwendungspaketnamen ab.

KeyguardControllerState getKeyguardState ()

Geben Sie ein Objekt zurück, um den aktuellen Zustand des Keyguards abzurufen, oder null, wenn es nicht unterstützt wird.

getMainlineModuleInfo ()

Informieren Sie sich über die auf dem Gerät installierten Mainline-Module.

int getMaxNumberOfRunningUsersSupported ()

Holen Sie sich die maximale Anzahl unterstützter gleichzeitig laufender Benutzer.

int getMaxNumberOfUsersSupported ()

Holen Sie sich die maximale Anzahl unterstützter Benutzer.

String getMicrodroidCID ()
Integer getPrimaryUserId ()

Gibt die primäre Benutzer-ID zurück.

InputStreamSource getScreenshot ()

Schnappt sich einen Screenshot vom Gerät.

InputStreamSource getScreenshot (String format, boolean rescale)

Schnappt sich einen Screenshot vom Gerät.

InputStreamSource getScreenshot (String format)

Schnappt sich einen Screenshot vom Gerät.

InputStreamSource getScreenshot (long displayId)

Erfasst einen Screenshot von dem Gerät mit der angegebenen Anzeige-ID.

String getSetting (String namespace, String key)

Siehe getSetting(int, String, String) und ausgeführt am Systembenutzer.

String getSetting (int userId, String namespace, String key)

Gibt den Wert der angeforderten Einstellung zurück.

getUninstallablePackageNames ()

Rufen Sie die Anwendungspaketnamen ab, die deinstalliert werden können.

int getUserFlags (int userId)

Suchen Sie die Flags eines bestimmten Benutzers und geben Sie sie zurück.

getUserInfos ()

Ruft die Zuordnung von useId zu UserInfo auf dem Gerät ab.

int getUserSerialNumber (int userId)

Gibt die Seriennummer zurück, die der Benutzer-ID zugeordnet ist, falls gefunden, -10000 in allen anderen Fällen.

boolean hasFeature (String feature)

Überprüfen Sie, ob eine Funktion auf einem Gerät verfügbar ist.

String installPackage (File packageFile, boolean reinstall, String... extraArgs)

Installieren Sie ein Android-Paket auf dem Gerät.

String installPackage (File packageFile, 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, boolean grantPermissions, int userId, String... extraArgs)

Installieren Sie ein Android-Paket auf dem Gerät für einen bestimmten Benutzer.

String installPackageForUser (File packageFile, boolean reinstall, int userId, String... extraArgs)

Installieren Sie ein Android-Paket auf dem Gerät für einen bestimmten Benutzer.

String installPackages ( packageFiles, boolean reinstall, String... extraArgs) installPackages ( packageFiles, boolean reinstall, String... extraArgs)

String installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) installPackages ( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

String installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

String installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs) installPackagesForUser ( packageFiles, boolean reinstall, int userId, String... extraArgs)

String installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs)

String installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs) installRemotePackages ( remoteApkPaths, boolean reinstall, String... extraArgs)

boolean isAppEnumerationSupported ()

Überprüfen Sie, ob die Plattform auf dem Gerät die App-Aufzählung unterstützt

boolean isMultiUserSupported ()

Legt fest, ob mehrere Benutzer unterstützt werden.

boolean isPackageInstalled (String packageName)

Fragen Sie das Gerät nach einem bestimmten Paketnamen ab, um zu überprüfen, ob es derzeit installiert ist oder nicht.

boolean isPackageInstalled (String packageName, String userId)

Fragen Sie das Gerät nach einem bestimmten Paketnamen und einer bestimmten Benutzer-ID ab, um zu überprüfen, ob es derzeit für diesen Benutzer installiert ist oder nicht.

boolean isUserRunning (int userId)

Überprüfen Sie, ob ein bestimmter Benutzer ausgeführt wird.

boolean isUserSecondary (int userId)

Gibt zurück, ob der angegebene Benutzer gemäß seinen Flags ein sekundärer Benutzer ist.

listDisplayIds ()

Sammeln Sie die Liste der verfügbaren Display-IDs auf dem Gerät, wie von „dumpsys SurfaceFlinger“ gemeldet.

listUsers ()

Ruft die Liste der Benutzer auf dem Gerät ab.

void postInvocationTearDown (Throwable exception)

Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach Abschluss des Aufrufs ausgeführt werden.

boolean removeAdmin (String componentName, int userId)

Entfernen Sie den angegebenen Geräteadministrator im angegebenen Benutzer und geben Sie „ true “ zurück, wenn dies erfolgreich war, andernfalls „ false “.

void removeOwners ()

Entfernen Sie alle vorhandenen Besitzer von Geräteprofilen nach besten Kräften.

boolean removeUser (int userId)

Entfernen Sie einen bestimmten Benutzer vom Gerät.

boolean setDeviceOwner (String componentName, int userId)

Legen Sie eine Geräteverwaltungskomponente als Geräteeigentümer in einem bestimmten Benutzer fest.

void setSetting (String namespace, String key, String value)

Siehe setSetting(int, String, String, String) und wird vom Systembenutzer ausgeführt.

void setSetting (int userId, String namespace, String key, String value)

Fügen Sie dem Namespace eines bestimmten Benutzers einen Einstellungswert hinzu.

void shutdownMicrodroid ( ITestDevice microdroidDevice)

Fährt das Microdroid-Gerät herunter, falls vorhanden.

boolean startUser (int userId)

Startet einen bestimmten Benutzer im Hintergrund, wenn er gerade gestoppt ist.

boolean startUser (int userId, boolean waitFlag)

Startet einen bestimmten Benutzer im Hintergrund, wenn er gerade gestoppt ist.

boolean stopUser (int userId, boolean waitFlag, boolean forceFlag)

Stoppen Sie einen bestimmten Benutzer.

boolean stopUser (int userId)

Stoppt einen bestimmten Benutzer.

boolean supportsMicrodroid ()

Überprüft die Voraussetzungen zum Ausführen eines Microdroids.

boolean supportsMicrodroid (boolean protectedVm)

Überprüft die Voraussetzungen zum Ausführen eines Microdroids.

boolean switchUser (int userId)

Wechseln Sie zu einer anderen Benutzer-ID mit einem Standardzeitlimit.

boolean switchUser (int userId, long timeout)

Wechseln Sie zu einer anderen Benutzer-ID mit dem angegebenen Timeout als Frist.

String uninstallPackage (String packageName)

Deinstallieren Sie ein Android-Paket vom Gerät.

String uninstallPackageForUser (String packageName, int userId)

Deinstallieren Sie ein Android-Paket vom Gerät für einen bestimmten Benutzer.

Geschützte Methoden

AaptParser createParser (File appFile)
void doAdbReboot ( NativeDevice.RebootMode rebootMode, String reason)

Führen Sie einen adb-Neustart durch.

long getCheckNewUserSleep ()

Zum Testen ausgesetzt.

long getHostCurrentTime ()

Zum Testen ausgesetzt

void prePostBootSetup ()

Ermöglicht jedem Gerätetyp (AndroidNativeDevice, TestDevice), diese Methode für ein bestimmtes Post-Boot-Setup zu überschreiben.

Felder

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Befehle, die verwendet werden können, um die Tastensperre zu schließen.

Öffentliche Konstrukteure

Testgerät

public TestDevice (IDevice device, 
                IDeviceStateMonitor stateMonitor, 
                IDeviceMonitor allocationMonitor)

Öffentliche Methoden

clearErrorDialogs

public boolean clearErrorDialogs ()

Versuchen Sie, alle Fehlerdialoge zu schließen, die derzeit auf der Geräte-UI angezeigt werden.

Kehrt zurück
boolean true wenn keine Dialoge vorhanden waren oder Dialoge erfolgreich gelöscht wurden. false sonst.

Wirft
DeviceNotAvailableException

Benutzer erstellen

public int createUser (String name)

Erstellen Sie einen Benutzer mit einem bestimmten Namen und Standard-Flags 0.

Parameter
name String : des Benutzers, der auf dem Gerät erstellt werden soll

Kehrt zurück
int die Ganzzahl für die erstellte Benutzer-ID

Wirft
DeviceNotAvailableException

Benutzer erstellen

public int createUser (String name, 
                boolean guest, 
                boolean ephemeral)

Erstellen Sie einen Benutzer mit einem bestimmten Namen und den bereitgestellten Flags

Parameter
name String : des Benutzers, der auf dem Gerät erstellt werden soll

guest boolean : Aktivieren Sie das Benutzer-Flag --guest während der Erstellung

ephemeral boolean : Aktivieren Sie das Benutzer-Flag --ephemeral während der Erstellung

Kehrt zurück
int ID des erstellten Benutzers

Wirft
DeviceNotAvailableException

createUserNoThrow

public int createUserNoThrow (String name)

Erstellen Sie einen Benutzer mit einem bestimmten Namen und Standard-Flags 0.

Parameter
name String : des Benutzers, der auf dem Gerät erstellt werden soll

Kehrt zurück
int die Ganzzahl für die erstellte Benutzer-ID oder -1 für Fehler.

Wirft
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

Versucht, die Tastensperre zu deaktivieren.

Warten Sie zunächst, bis der Input-Dispatch bereit ist. Dies geschieht ungefähr zur gleichen Zeit, wenn das Gerät BOOT_COMPLETE meldet, anscheinend asynchron, da die aktuelle Framework-Implementierung gelegentlich eine Race-Bedingung aufweist. Dann wird der Befehl gesendet, die Tastensperre zu schließen (funktioniert nur bei nicht sicheren).

Wirft
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät vorhanden ist.

Parameter
deviceFilePath String : Der absolute Pfad der Datei auf dem zu prüfenden Gerät

Kehrt zurück
boolean true wenn die Datei existiert, andernfalls false .

Wirft
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

Hilfsmethode, um festzustellen, ob eine Datei auf dem Gerät für einen bestimmten Benutzer vorhanden ist.

Parameter
deviceFilePath String : Der absolute Pfad der Datei auf dem zu prüfenden Gerät

userId int : Die Benutzer-ID, anhand derer das Vorhandensein der Datei überprüft werden soll

Kehrt zurück
boolean true wenn die Datei existiert, andernfalls false .

Wirft
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Versuchen Sie, den Heap vom system_server auszugeben. Es liegt in der Verantwortung des Aufrufers, die ausgegebene Datei zu bereinigen.

Parameter
process String : Der Name des Geräteprozesses für den Dumpheap.

devicePath String : Der Pfad auf dem Gerät, wo der Dump abgelegt werden soll. Dies muss ein Ort sein, an dem die Berechtigungen dies zulassen.

Kehrt zurück
File die ERROR(/File) , die den Bericht enthält. Null, wenn etwas fehlgeschlagen ist.

Wirft
DeviceNotAvailableException

getActiveApexes

public  getActiveApexes ()

Rufen Sie die Informationen zu APEXs ab, die auf dem Gerät aktiviert sind.

Kehrt zurück
ERROR(/Set) von ApexInfo , das derzeit auf dem Gerät aktiviert ist

Wirft
DeviceNotAvailableException

getAllSettings

public  getAllSettings (String namespace)

Geben Sie Schlüsselwertpaare des angeforderten Namespace zurück.

Parameter
namespace String : muss einer der folgenden sein: {"system", "secure", "global"}

Kehrt zurück
die Karte der Schlüssel-Wert-Paare. Null, wenn Namespace nicht unterstützt wird.

Wirft
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

Suchen Sie die Android-ID, die einer Benutzer-ID zugeordnet ist, und geben Sie sie zurück, null, wenn sie nicht gefunden wird.

Parameter
userId int

Kehrt zurück
String

Wirft
DeviceNotAvailableException

getAndroidIds

public  getAndroidIds ()

Erstellen Sie eine Karte mit Android-IDs, die übereinstimmende Benutzer-IDs gefunden haben. Es gibt keine Garantie dafür, dass jede Benutzer-ID eine mit dieser Funktion verknüpfte Android-ID findet, daher können einige Benutzer-IDs mit null übereinstimmen.

Kehrt zurück
Karte von Android-IDs, die übereinstimmende Benutzer-IDs gefunden haben.

Wirft
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Abrufen von Informationen zu einem auf dem Gerät installierten Paket.

Parameter
packageName String

Kehrt zurück
PackageInfo die PackageInfo oder null , wenn Informationen nicht abgerufen werden konnten

Wirft
DeviceNotAvailableException

getAppPackageInfos

public  getAppPackageInfos ()

Abrufen von Informationen zu Paketen, die auf dem Gerät installiert sind.

Kehrt zurück
ERROR(/List) von PackageInfo s, die auf dem Gerät installiert sind.

Wirft
DeviceNotAvailableException

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Gibt den aktuellen faltbaren Zustand des Geräts oder null zurück, wenn einige Probleme aufgetreten sind.

Kehrt zurück
DeviceFoldableState

Wirft
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

Gibt die ID des aktuell ausgeführten Benutzers zurück. Im Fehlerfall -10000 zurückgeben.

Kehrt zurück
int

Wirft
DeviceNotAvailableException

getFoldableStates

public  getFoldableStates ()

Gibt die Liste der faltbaren Zustände auf dem Gerät zurück. Kann mit "cmd device_state print-states" abgerufen werden.

Kehrt zurück

Wirft
DeviceNotAvailableException

getInstalledPackageNames

public  getInstalledPackageNames ()

Rufen Sie die auf dem Gerät vorhandenen Anwendungspaketnamen ab.

Kehrt zurück
ERROR(/Set) von String -Paketnamen, die derzeit auf dem Gerät installiert sind.

Wirft
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Geben Sie ein Objekt zurück, um den aktuellen Zustand des Keyguards abzurufen, oder null, wenn es nicht unterstützt wird.

Kehrt zurück
KeyguardControllerState ein KeyguardControllerState , der eine Momentaufnahme des Zustands des Keyguards enthält und Null zurückgibt, wenn die Keyguard-Abfrage nicht unterstützt wird.

Wirft
DeviceNotAvailableException

getMainlineModuleInfo

public  getMainlineModuleInfo ()

Informieren Sie sich über die auf dem Gerät installierten Mainline-Module.

Kehrt zurück
ERROR(/Set) der derzeit auf dem Gerät installierten String -Mainline-Module.

Wirft
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

Holen Sie sich die maximale Anzahl unterstützter gleichzeitig laufender Benutzer. Standardmäßig 0.

Kehrt zurück
int eine Ganzzahl, die die Anzahl der gleichzeitig laufenden Benutzer angibt

Wirft
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

Holen Sie sich die maximale Anzahl unterstützter Benutzer. Standardmäßig 0.

Kehrt zurück
int eine Ganzzahl, die die Anzahl der unterstützten Benutzer angibt

Wirft
DeviceNotAvailableException

getMicrodroidCID

public String getMicrodroidCID ()

Kehrt zurück
String Gibt die CID der Microdroid-VM zurück. Wenn TestDevice kein Microdroid ist, gib null zurück.

getPrimaryUserId

public Integer getPrimaryUserId ()

Gibt die primäre Benutzer-ID zurück.

Kehrt zurück
Integer die userId des primären Benutzers, falls vorhanden, und null, wenn es keinen primären Benutzer gibt.

Wirft
DeviceNotAvailableException

Screenshot abrufen

public InputStreamSource getScreenshot ()

Schnappt sich einen Screenshot vom Gerät.

Kehrt zurück
InputStreamSource eine InputStreamSource des Screenshots im PNG-Format oder null , wenn der Screenshot nicht erfolgreich war.

Wirft
DeviceNotAvailableException

Screenshot abrufen

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Schnappt sich einen Screenshot vom Gerät. Es wird empfohlen, stattdessen getScreenshot(String) mit JPEG-Codierung für eine kleinere Größe zu verwenden.

Parameter
format String : unterstütztes PNG, JPEG

rescale boolean : Wenn der Screenshot neu skaliert werden soll, um die Größe des resultierenden Bildes zu reduzieren

Kehrt zurück
InputStreamSource eine InputStreamSource des Screenshots im Format oder null , wenn der Screenshot nicht erfolgreich war.

Wirft
DeviceNotAvailableException

Screenshot abrufen

public InputStreamSource getScreenshot (String format)

Schnappt sich einen Screenshot vom Gerät. Es wird empfohlen, stattdessen getScreenshot(format) mit JPEG-Codierung für eine kleinere Größe zu verwenden

Parameter
format String : unterstütztes PNG, JPEG

Kehrt zurück
InputStreamSource eine InputStreamSource des Screenshots im Format oder null , wenn der Screenshot nicht erfolgreich war.

Wirft
DeviceNotAvailableException

Screenshot abrufen

public InputStreamSource getScreenshot (long displayId)

Erfasst einen Screenshot von dem Gerät mit der angegebenen Anzeige-ID. Format ist PNG.

TODO: Erweitern Sie die obigen Implementierungen, um „formatieren“ und „neu skalieren“ zu unterstützen.

Parameter
displayId long : die Anzeige-ID des Bildschirms, von dem ein Screenshot abgerufen werden soll.

Kehrt zurück
InputStreamSource eine InputStreamSource des Screenshots im Format oder null , wenn der Screenshot nicht erfolgreich war.

Wirft
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

Siehe getSetting(int, String, String) und ausgeführt am Systembenutzer.

Parameter
namespace String

key String

Kehrt zurück
String

Wirft
DeviceNotAvailableException

getSetting

public String getSetting (int userId, 
                String namespace, 
                String key)

Gibt den Wert der angeforderten Einstellung zurück. Namespace muss einer der folgenden sein: {"system", "secure", "global"}

Parameter
userId int

namespace String

key String

Kehrt zurück
String der Wert, der dem namespace:key eines Benutzers zugeordnet ist. Null, wenn nicht gefunden.

Wirft
DeviceNotAvailableException

getUninstallablePackageNames

public  getUninstallablePackageNames ()

Rufen Sie die Anwendungspaketnamen ab, die deinstalliert werden können. Dies wird derzeit als Nicht-Systempakete und aktualisierte Systempakete definiert.

Kehrt zurück
ERROR(/Set) von nicht installierbaren String -Paketnamen, die derzeit auf dem Gerät installiert sind.

Wirft
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

Suchen Sie die Flags eines bestimmten Benutzers und geben Sie sie zurück. Flags sind in der Klasse „android.content.pm.UserInfo“ im Android Open Source Project definiert.

Parameter
userId int

Kehrt zurück
int die Flags, die der bereitgestellten Benutzer-ID zugeordnet sind, falls gefunden, -10000 in allen anderen Fällen.

Wirft
DeviceNotAvailableException

Benutzerinfos abrufen

public  getUserInfos ()

Ruft die Zuordnung von useId zu UserInfo auf dem Gerät ab. DeviceRuntimeException aus, wenn die Ausgabe vom Gerät nicht wie erwartet ist.

Kehrt zurück
die Liste der UserInfo-Objekte.

Wirft
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

Gibt die Seriennummer zurück, die der Benutzer-ID zugeordnet ist, falls gefunden, -10000 in allen anderen Fällen.

Parameter
userId int

Kehrt zurück
int

Wirft
DeviceNotAvailableException

hatFeature

public boolean hasFeature (String feature)

Überprüfen Sie, ob eine Funktion auf einem Gerät verfügbar ist.

Parameter
feature String : Welches Format sollte "feature: " oder " " direkt.

Kehrt zurück
boolean True, wenn Feature gefunden wird, andernfalls false.

Wirft
DeviceNotAvailableException

Installationspaket

public String installPackage (File packageFile, 
                boolean reinstall, 
                String... extraArgs)

Installieren Sie ein Android-Paket auf dem Gerät.

Parameter
packageFile File : die zu installierende apk-Datei

reinstall boolean : true wenn eine Neuinstallation durchgeführt werden soll

extraArgs String : optionale zusätzliche Argumente, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen.

Kehrt zurück
String ein String mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException

Installationspaket

public String installPackage (File packageFile, 
                File certFile, 
                boolean reinstall, 
                String... extraArgs)

Installieren Sie ein Android-Paket auf dem Gerät.

Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Erteilung von Laufzeitberechtigungen zum Zeitpunkt der Installation erfordern.

Parameter
packageFile File : die zu installierende apk-Datei

certFile File : true wenn eine Neuinstallation durchgeführt werden soll

reinstall boolean : Wenn alle Laufzeitberechtigungen zum Zeitpunkt der Installation gewährt werden sollen

extraArgs String : optionale zusätzliche Argumente, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen.

Kehrt zurück
String ein String mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException

Installationspaket

public String installPackage (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Installieren Sie ein Android-Paket auf dem Gerät.

Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Erteilung von Laufzeitberechtigungen zum Zeitpunkt der Installation erfordern.

Parameter
packageFile File : die zu installierende apk-Datei

reinstall boolean : true wenn eine Neuinstallation durchgeführt werden soll

grantPermissions boolean : Wenn alle Laufzeitberechtigungen zum Zeitpunkt der Installation gewährt werden sollen

extraArgs String : optionale zusätzliche Argumente, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen.

Kehrt zurück
String ein String mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Installieren Sie ein Android-Paket auf dem Gerät für einen bestimmten Benutzer.

Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Erteilung von Laufzeitberechtigungen zum Zeitpunkt der Installation erfordern.

Parameter
packageFile File : die zu installierende apk-Datei

reinstall boolean : true wenn eine Neuinstallation durchgeführt werden soll

grantPermissions boolean : Wenn alle Laufzeitberechtigungen zum Zeitpunkt der Installation gewährt werden sollen

userId int : die ganzzahlige Benutzer-ID, für die installiert werden soll.

extraArgs String : optionale zusätzliche Argumente, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen.

Kehrt zurück
String ein String mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException

installPackageForUser

public String installPackageForUser (File packageFile, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Installieren Sie ein Android-Paket auf dem Gerät für einen bestimmten Benutzer.

Parameter
packageFile File : die zu installierende apk-Datei

reinstall boolean : true wenn eine Neuinstallation durchgeführt werden soll

userId int : die ganzzahlige Benutzer-ID, für die installiert werden soll.

extraArgs String : optionale zusätzliche Argumente, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen.

Kehrt zurück
String ein String mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException

Pakete installieren

public String installPackages ( packageFiles, 
                boolean reinstall, 
                String... extraArgs)

Parameter
packageFiles

reinstall boolean

extraArgs String

Kehrt zurück
String

Wirft
DeviceNotAvailableException

Pakete installieren

public String installPackages ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Parameter
packageFiles

reinstall boolean

grantPermissions boolean

extraArgs String

Kehrt zurück
String

Wirft
DeviceNotAvailableException

InstallPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Parameter
packageFiles

reinstall boolean

grantPermissions boolean

userId int

extraArgs String

Kehrt zurück
String

Wirft
DeviceNotAvailableException

InstallPackagesForUser

public String installPackagesForUser ( packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Parameter
packageFiles

reinstall boolean

userId int

extraArgs String

Kehrt zurück
String

Wirft
DeviceNotAvailableException

InstallRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Parameter
remoteApkPaths

reinstall boolean

grantPermissions boolean

extraArgs String

Kehrt zurück
String

Wirft
DeviceNotAvailableException

InstallRemotePackages

public String installRemotePackages ( remoteApkPaths, 
                boolean reinstall, 
                String... extraArgs)

Parameter
remoteApkPaths

reinstall boolean

extraArgs String

Kehrt zurück
String

Wirft
DeviceNotAvailableException

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

Überprüfen Sie, ob die Plattform auf dem Gerät die App-Aufzählung unterstützt

Kehrt zurück
boolean True, wenn App-Enumeration unterstützt wird, andernfalls false

Wirft
DeviceNotAvailableException

wird von mehreren Benutzern unterstützt

public boolean isMultiUserSupported ()

Legt fest, ob mehrere Benutzer unterstützt werden.

Kehrt zurück
boolean true, wenn mehrere Benutzer unterstützt werden, andernfalls false

Wirft
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName)

Fragen Sie das Gerät nach einem bestimmten Paketnamen ab, um zu überprüfen, ob es derzeit installiert ist oder nicht.

Parameter
packageName String

Kehrt zurück
boolean True, wenn das Paket als installiert gemeldet wird. Sonst falsch.

Wirft
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

Fragen Sie das Gerät nach einem bestimmten Paketnamen und einer bestimmten Benutzer-ID ab, um zu überprüfen, ob es derzeit für diesen Benutzer installiert ist oder nicht.

Parameter
packageName String : das Paket, das wir überprüfen, ob es installiert ist.

userId String : Die Benutzer-ID, für die wir das Paket überprüfen, ist installiert. Wenn null, wird der primäre Benutzer null verwendet.

Kehrt zurück
boolean True, wenn das Paket als installiert gemeldet wird. Sonst falsch.

Wirft
DeviceNotAvailableException

isUserRunning

public boolean isUserRunning (int userId)

Überprüfen Sie, ob ein bestimmter Benutzer ausgeführt wird.

Parameter
userId int

Kehrt zurück
boolean True, wenn der Benutzer ausgeführt wird, false in allen anderen Fällen.

Wirft
DeviceNotAvailableException

isUserSecondary

public boolean isUserSecondary (int userId)

Gibt zurück, ob der angegebene Benutzer gemäß seinen Flags ein sekundärer Benutzer ist.

Parameter
userId int

Kehrt zurück
boolean true, wenn der Benutzer sekundär ist, andernfalls false.

Wirft
DeviceNotAvailableException

listDisplayIds

public  listDisplayIds ()

Sammeln Sie die Liste der verfügbaren Display-IDs auf dem Gerät, wie von „dumpsys SurfaceFlinger“ gemeldet.

Kehrt zurück
Die Liste der Anzeigen. Default gibt immer die Standardanzeige 0 zurück.

Wirft
DeviceNotAvailableException

listBenutzer

public  listUsers ()

Ruft die Liste der Benutzer auf dem Gerät ab. DeviceRuntimeException aus, wenn die Ausgabe vom Gerät nicht wie erwartet ist.

Kehrt zurück
die Liste der Benutzer-IDs.

Wirft
DeviceNotAvailableException

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach Abschluss des Aufrufs ausgeführt werden.

Parameter
exception Throwable : Falls vorhanden, die letzte Ausnahme, die durch den Aufruffehler ausgelöst wurde.

entfernenAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Entfernen Sie den angegebenen Geräteadministrator im angegebenen Benutzer und geben Sie „ true “ zurück, wenn dies erfolgreich war, andernfalls „ false “.

Parameter
componentName String : des zu entfernenden Geräteadministrators.

userId int : des Benutzers, in dem der Geräteadministrator lebt.

Kehrt zurück
boolean True, wenn es erfolgreich ist, andernfalls false.

Wirft
DeviceNotAvailableException

Eigentümer entfernen

public void removeOwners ()

Entfernen Sie alle vorhandenen Besitzer von Geräteprofilen nach besten Kräften.

Wirft
DeviceNotAvailableException

Benutzer entfernen

public boolean removeUser (int userId)

Entfernen Sie einen bestimmten Benutzer vom Gerät.

Parameter
userId int : des zu entfernenden Benutzers

Kehrt zurück
boolean true, wenn wir den Benutzer erfolgreich entfernen konnten, andernfalls false.

Wirft
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Legen Sie eine Geräteverwaltungskomponente als Geräteeigentümer in einem bestimmten Benutzer fest.

Parameter
componentName String : des Geräteadministrators, der Gerätebesitzer sein soll.

userId int : des Benutzers, in dem der Gerätebesitzer lebt.

Kehrt zurück
boolean True, wenn es erfolgreich ist, andernfalls false.

Wirft
DeviceNotAvailableException

setSetting

public void setSetting (String namespace, 
                String key, 
                String value)

Siehe setSetting(int, String, String, String) und wird vom Systembenutzer ausgeführt.

Parameter
namespace String

key String

value String

Wirft
DeviceNotAvailableException

setSetting

public void setSetting (int userId, 
                String namespace, 
                String key, 
                String value)

Fügen Sie dem Namespace eines bestimmten Benutzers einen Einstellungswert hinzu. Einige Einstellungen sind erst nach einem Neustart verfügbar. Namespace muss einer der folgenden sein: {"system", "secure", "global"}

Parameter
userId int

namespace String

key String

value String

Wirft
DeviceNotAvailableException

ShutdownMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

Fährt das Microdroid-Gerät herunter, falls vorhanden.

Parameter
microdroidDevice ITestDevice

Wirft
DeviceNotAvailableException

startBenutzer

public boolean startUser (int userId)

Startet einen bestimmten Benutzer im Hintergrund, wenn er gerade gestoppt ist. Wenn der Benutzer bereits im Hintergrund läuft, ist diese Methode ein NOOP.

Parameter
userId int : des Benutzers, der im Hintergrund gestartet werden soll

Kehrt zurück
boolean true, wenn der Benutzer erfolgreich im Hintergrund gestartet wurde.

Wirft
DeviceNotAvailableException

startBenutzer

public boolean startUser (int userId, 
                boolean waitFlag)

Startet einen bestimmten Benutzer im Hintergrund, wenn er gerade gestoppt ist. Wenn der Benutzer bereits im Hintergrund läuft, ist diese Methode ein NOOP. Es ist möglich, ein zusätzliches Flag bereitzustellen, um zu warten, bis die Operation wirksam wird.

Parameter
userId int : des Benutzers, der im Hintergrund gestartet werden soll

waitFlag boolean : lässt den Befehl warten, bis der Benutzer gestartet und entsperrt wird.

Kehrt zurück
boolean true, wenn der Benutzer erfolgreich im Hintergrund gestartet wurde.

Wirft
DeviceNotAvailableException

Benutzer stoppen

public boolean stopUser (int userId, 
                boolean waitFlag, 
                boolean forceFlag)

Stoppen Sie einen bestimmten Benutzer. Es ist möglich, zusätzliche Flags bereitzustellen, um darauf zu warten, dass die Operation wirksam wird, und das Beenden des Benutzers zu erzwingen. Der aktuelle Benutzer und der Systembenutzer können nicht gestoppt werden.

Parameter
userId int : des zu stoppenden Benutzers.

waitFlag boolean : lässt den Befehl warten, bis der Benutzer gestoppt wird.

forceFlag boolean : erzwingt das Beenden des Benutzers.

Kehrt zurück
boolean true, wenn der Benutzer erfolgreich beendet wurde.

Wirft
DeviceNotAvailableException

Benutzer stoppen

public boolean stopUser (int userId)

Stoppt einen bestimmten Benutzer. Wenn der Benutzer bereits gestoppt ist, ist diese Methode ein NOOP. Der aktuelle Benutzer und der Systembenutzer können nicht gestoppt werden.

Parameter
userId int : des zu stoppenden Benutzers.

Kehrt zurück
boolean true, wenn der Benutzer erfolgreich beendet wurde.

Wirft
DeviceNotAvailableException

unterstütztMicrodroid

public boolean supportsMicrodroid ()

Überprüft die Voraussetzungen zum Ausführen eines Microdroids.

Kehrt zurück
boolean gibt true zurück, wenn die Vorbedingungen erfüllt sind, andernfalls false.

unterstütztMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

Überprüft die Voraussetzungen zum Ausführen eines Microdroids.

Parameter
protectedVm boolean : true, wenn microdroid auf einer geschützten VM ausgeführt werden soll.

Kehrt zurück
boolean gibt true zurück, wenn die Vorbedingungen erfüllt sind, andernfalls false.

Benutzer wechseln

public boolean switchUser (int userId)

Wechseln Sie zu einer anderen Benutzer-ID mit einem Standardzeitlimit. switchUser(int, long) .

Parameter
userId int

Kehrt zurück
boolean True, wenn die neue Benutzer-ID mit dem Benutzer-ID-Anbieter übereinstimmt. Sonst falsch.

Wirft
DeviceNotAvailableException

Benutzer wechseln

public boolean switchUser (int userId, 
                long timeout)

Wechseln Sie zu einer anderen Benutzer-ID mit dem angegebenen Timeout als Frist. Versuchen Sie, die Tastensperre zu deaktivieren, nachdem der Benutzerwechsel erfolgreich war.

Parameter
userId int

timeout long : warten, bevor false zurückgegeben wird, wenn switch-user fehlgeschlagen ist.

Kehrt zurück
boolean True, wenn die neue Benutzer-ID mit dem Benutzer-ID-Anbieter übereinstimmt. Sonst falsch.

Wirft
DeviceNotAvailableException

Paket deinstallieren

public String uninstallPackage (String packageName)

Deinstallieren Sie ein Android-Paket vom Gerät.

Parameter
packageName String : das zu deinstallierende Android-Paket

Kehrt zurück
String ein String mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException

Paket für Benutzer deinstallieren

public String uninstallPackageForUser (String packageName, 
                int userId)

Deinstallieren Sie ein Android-Paket vom Gerät für einen bestimmten Benutzer.

Parameter
packageName String : das zu deinstallierende Android-Paket

userId int : die ganzzahlige Benutzer-ID, für die deinstalliert werden soll.

Kehrt zurück
String ein String mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException

Geschützte Methoden

createParser

protected AaptParser createParser (File appFile)

Parameter
appFile File

Kehrt zurück
AaptParser

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.

Wirft
DeviceNotAvailableException

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Zum Testen ausgesetzt.

Kehrt zurück
long

getHostCurrentTime

protected long getHostCurrentTime ()

Zum Testen ausgesetzt

Kehrt zurück
long

prePostBootSetup

protected void prePostBootSetup ()

Ermöglicht jedem Gerätetyp (AndroidNativeDevice, TestDevice), diese Methode für ein bestimmtes Post-Boot-Setup zu überschreiben.

Wirft
DeviceNotAvailableException