TestDevice

public class TestDevice
extends NativeDevice

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

Implementierung von ITestDevice für ein Android-Gerät mit vollständigem Stack

Zusammenfassung

Verschachtelte Klassen

class TestDevice.MicrodroidBuilder

Ein Builder zum Erstellen eines Microdroid-Testgeräts. 

Konstanten

String DISMISS_KEYGUARD_CMD

Befehle, mit denen der Keyguard geschlossen werden kann.

Öffentliche Konstruktoren

TestDevice(IDevice device, IDeviceStateMonitor stateMonitor, IDeviceMonitor allocationMonitor)

Öffentliche Methoden

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

Installieren Sie ein Android-Paket mit dem adb-Befehl auf einem Gerät.

String adbInstallPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs)

Installieren Sie ein Android-Paket mit dem adb-Befehl auf einem Gerät.

boolean canSwitchToHeadlessSystemUser()

Gibt zurück, ob der Wechsel zum monitorlosen SYSTEM-Nutzer zulässig ist.

boolean clearErrorDialogs()

Schließen Sie alle Fehlerdialogfelder, die derzeit auf der Geräte-UI angezeigt werden.

int createUser(String name)

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

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

Einen Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

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

Einen 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, die Keyguard-Funktion zu deaktivieren.

boolean doesFileExist(String deviceFilePath, int userId)

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

boolean doesFileExist(String deviceFilePath)

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

File dumpHeap(String process, String devicePath)

Versuchen Sie, den Heap aus dem system_server zu sichern.

Set<ITestDevice.ApexInfo> getActiveApexes()

Ruft die Informationen zu den auf dem Gerät aktivierten APEX-Modulen ab.

Map<String, String> getAllSettings(String namespace)

Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück.

String getAndroidId(int userId)

Sucht die Android-ID, die einem Nutzer zugeordnet ist, und gibt sie zurück. Wenn sie nicht gefunden wird, wird „null“ zurückgegeben.

Map<Integer, String> getAndroidIds()

Erstellen Sie eine Zuordnung von Android-IDs, die mit Nutzer-IDs übereinstimmen.

PackageInfo getAppPackageInfo(String packageName)

Informationen zu einem auf dem Gerät installierten Paket abrufen.

List<PackageInfo> getAppPackageInfos()

Informationen zu auf dem Gerät installierten Paketen abrufen.

InputStreamSource getBugreport()

Ruft einen Fehlerbericht vom Gerät ab.

InputStreamSource getBugreportz()

Ruft einen Fehlerbericht vom Gerät ab.

DeviceFoldableState getCurrentFoldableState()

Gibt den aktuellen Status des faltbaren Geräts zurück oder „null“, wenn Probleme aufgetreten sind.

int getCurrentUser()

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

Set<DeviceFoldableState> getFoldableStates()

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

Set<String> getInstalledPackageNames()

Die Paketnamen der auf dem Gerät vorhandenen Anwendungen abrufen.

KeyguardControllerState getKeyguardState()

Gibt ein Objekt zurück, um den aktuellen Status des Keyguard zu erhalten, oder „null“, wenn dies nicht unterstützt wird.

Integer getMainUserId()

Gibt die Hauptnutzer-ID zurück.

Set<String> getMainlineModuleInfo()

Ruft Informationen zu den auf dem Gerät installierten Mainline-Modulen ab.

int getMaxNumberOfRunningUsersSupported()

Die maximale Anzahl der unterstützten gleichzeitig aktiven Nutzer abrufen.

int getMaxNumberOfUsersSupported(String userType)

Ruft die maximale Anzahl der unterstützten Nutzer des angegebenen Nutzertyps ab.

int getMaxNumberOfUsersSupported()

Ruft die maximale Anzahl der unterstützten wechselbaren Nutzer ab, ohne Gäste.

Integer getPrimaryUserId()

Gibt die Hauptnutzer-ID zurück.

int getRemainingCreatableUserCount(String userType)

Gibt zurück, wie viele Nutzer des angegebenen Nutzertyps auf diesem Gerät erstellt werden können.

InputStreamSource getScreenshot(Long displayId, String format, boolean rescale)

Erstellt einen Screenshot des Displays mit der angegebenen ID im unterstützten Format.

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 des Geräts mit der angegebenen Anzeige-ID.

InputStreamSource getScreenshot()

Erstellt einen Screenshot vom Gerät.

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

Gibt den Wert der angeforderten Einstellung zurück.

String getSetting(String namespace, String key)

Weitere Informationen finden Sie unter getSetting(int,String,String).

Set<String> getUninstallablePackageNames()

Ruft die Paketnamen der Anwendungen ab, die deinstalliert werden können.

int getUserFlags(int userId)

Sucht nach den Markierungen eines bestimmten Nutzers und gibt sie zurück.

Map<Integer, UserInfo> getUserInfos()

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

int getUserSerialNumber(int userId)

Gibt die dem userId zugeordnete Seriennummer zurück, falls gefunden, andernfalls -10000.

int getUserVisibleOnDisplay(int displayId)

Ruft die Nutzer-ID des sichtbaren Nutzers auf dem angegebenen Display ab.

boolean hasFeature(String feature)

Prüfen, ob eine Funktion auf einem Gerät verfügbar ist

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

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

String installPackage(File packageFile, 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)

Installiert ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.

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

Installiert ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.

boolean installPackageWithIncrementalMode(File[] apkFiles, String[] extraArgs, String userId)

Installiert APKs im inkrementellen Modus.

String installPackages(List<File> packageFiles, boolean reinstall, String... extraArgs)

String installPackages(List<File> packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs)

String installPackagesForUser(List<File> packageFiles, boolean reinstall, int userId, String... extraArgs)

String installPackagesForUser(List<File> packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs)

boolean isAppEnumerationSupported()

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

boolean isHeadlessSystemUserMode()

Gibt zurück, ob auf dem Gerät der monitorlose Systemnutzermodus verwendet wird.

boolean isMainUserPermanentAdmin()

Gibt zurück, ob der Hauptnutzer ein permanenter Administrator ist und nicht gelöscht oder auf den Status „Nicht-Administrator“ herabgestuft werden kann.

boolean isMultiUserSupported()

Gibt zurück, ob dieses Gerät mehrere umschaltbare Nutzer mit eigenem Login und anpassbarem Bereich unterstützt.

boolean isPackageInstalled(String packageName, String userId)

Fragen Sie das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID ab, um zu prüfen, ob die App für diesen Nutzer derzeit installiert ist.

boolean isPackageInstalled(String packageName)

Fragen Sie das Gerät nach einem bestimmten Paketnamen, um zu prüfen, ob das Paket derzeit installiert ist.

boolean isUserRunning(int userId)

Prüfen, ob ein bestimmter Nutzer aktiv ist.

boolean isUserSecondary(int userId)

Gibt zurück, ob der angegebene Nutzer anhand seiner Flags ein sekundärer Nutzer ist.

boolean isUserVisible(int userId)

Prüft, ob der angegebene Nutzer sichtbar ist.

boolean isUserVisibleOnDisplay(int userId, int displayId)

Prüft, ob der angegebene Nutzer auf dem angegebenen Display sichtbar ist.

boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

Gibt zurück, ob Nutzer im Hintergrund in ERROR(/java.android.view.Display#DEFAULT_DISPLAY) sichtbar sein dürfen.

boolean isVisibleBackgroundUsersSupported()

Gibt zurück, ob Nutzer im Hintergrund sichtbar sein dürfen.

Set<Long> listDisplayIds()

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

Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers()

Ruft die Liste der Displays ab, die für start a user visible in the background verwendet werden können.

ArrayList<Integer> listUsers()

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

boolean logBugreport(String dataName, ITestLogger listener)

Hilfsmethode zum Erstellen eines Fehlerberichts und zum Protokollieren des Berichts für die Reporter.

void notifySnapuserd(SnapuserdWaitPhase waitPhase)
void postInvocationTearDown(Throwable exception)

Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach dem Aufruf ausgeführt werden.

boolean removeAdmin(String componentName, int userId)

Entfernt den angegebenen Geräteadministrator für den angegebenen Nutzer und gibt true zurück, wenn der Vorgang erfolgreich war, andernfalls false.

void removeOwners()

Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen.

boolean removeUser(int userId)

Einen bestimmten Nutzer vom Gerät entfernen.

boolean setDeviceOwner(String componentName, int userId)

Legt eine Geräteadministrator-Komponente als Geräteinhaber für einen bestimmten Nutzer fest.

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

Weitere Informationen finden Sie unter setSetting(int,String,String,String).

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

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

void shutdownMicrodroid(ITestDevice microdroidDevice)

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

boolean startUser(int userId)

Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit 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 angegebenen Display sichtbar ist (d.h. der Nutzer kann Aktivitäten auf diesem Display starten).

boolean stopUser(int userId)

Stoppt einen bestimmten Nutzer.

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

Einen bestimmten Nutzer stoppen.

boolean supportsMicrodroid()

Prüft die Voraussetzungen für die Ausführung eines Microdroid.

boolean supportsMicrodroid(boolean protectedVm)

Prüft die Voraussetzungen für die Ausführung eines Microdroid.

boolean switchUser(int userId)

Wechseln Sie mit einem Standard-Timeout zu einer anderen userId.

boolean switchUser(int userId, long timeout)

Wechseln Sie mit dem angegebenen Zeitlimit zu einer anderen userId.

Bugreport takeBugreport()

Nimmt einen Fehlerbericht entgegen und gibt ihn in einem Bugreport-Objekt zurück, um ihn zu verarbeiten.

String uninstallPackage(String packageName)

Ein Android-Paket vom Gerät deinstallieren.

String uninstallPackageForUser(String packageName, int userId)

Deinstalliert ein Android-Paket für einen bestimmten Nutzer von einem Gerät.

void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Geschützte Methoden

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

Führen Sie einen ADB-Neustart durch.

InputStreamSource getBugreportInternal()
File getBugreportzInternal()

Interne Hilfsmethode zum Abrufen der ZIP-Datei „bugreportz“ als File.

long getCheckNewUserSleep()

Für Tests verfügbar gemacht.

long getHostCurrentTime()

Für Tests verfügbar gemacht

void prePostBootSetup()

Ermöglicht es jedem Gerätetyp (AndroidNativeDevice, TestDevice), diese Methode für die spezifische Einrichtung nach dem Booten zu überschreiben.

Konstanten

DISMISS_KEYGUARD_CMD

public static final String DISMISS_KEYGUARD_CMD

Befehle, mit denen der Keyguard geschlossen werden kann.

Konstanter Wert: "input keyevent 82"

Öffentliche Konstruktoren

TestDevice

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

Öffentliche Methoden

adbInstallPackage

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

Installieren Sie ein Android-Paket mit dem adb-Befehl auf einem Gerät.

Parameter
packageFile File: die zu installierende APK-Datei
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“.
Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.
Löst aus
DeviceNotAvailableException

adbInstallPackage

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

Installieren Sie ein Android-Paket mit dem adb-Befehl auf einem Gerät.

Hinweis: Diese Funktion sollte nur für Anwendungsfälle aufgerufen werden, die eine explizite Steuerung der Erteilung der Laufzeitberechtigung bei der Installation erfordern.

Parameter
packageFile File: die zu installierende APK-Datei
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions boolean: Gibt an, ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen.
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“.
Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.
Löst aus
DeviceNotAvailableException

canSwitchToHeadlessSystemUser

public boolean canSwitchToHeadlessSystemUser ()

Gibt zurück, ob der Wechsel zum monitorlosen SYSTEM-Nutzer zulässig ist.

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

clearErrorDialogs

public boolean clearErrorDialogs ()

Schließen Sie alle Fehlerdialogfelder, die derzeit auf der Geräte-UI angezeigt werden.

Gibt Folgendes zurück:
boolean true, wenn keine Dialogfelder vorhanden waren oder Dialogfelder erfolgreich gelöscht wurden. Andernfalls false.
Löst aus
DeviceNotAvailableException

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
Gibt Folgendes zurück:
int Die Ganzzahl für die erstellte Nutzer-ID.
Löst aus
DeviceNotAvailableException
IllegalStateException

createUser

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

Einen 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 das Nutzer-Flag „--guest“ während der Erstellung.
ephemeral boolean: Aktivieren Sie das Nutzer-Flag „--ephemeral“ bei der Erstellung.
Gibt Folgendes zurück:
int ID des erstellten Nutzers
Löst aus
DeviceNotAvailableException
IllegalStateException

createUser

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

Einen 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 das Nutzer-Flag „--guest“ während der Erstellung.
ephemeral boolean: Aktivieren Sie das Nutzer-Flag „--ephemeral“ bei der Erstellung.
forTesting boolean: Aktivieren Sie beim Erstellen das Testflag „--for-testing“.
Gibt Folgendes zurück:
int ID des erstellten Nutzers
Löst aus
DeviceNotAvailableException
IllegalStateException

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
Gibt Folgendes zurück:
int Die Ganzzahl für die erstellte Nutzer-ID oder -1 bei einem Fehler.
Löst aus
DeviceNotAvailableException

disableKeyguard

public void disableKeyguard ()

Es wird versucht, die Keyguard-Funktion zu deaktivieren.

Warten Sie zuerst, bis die Eingabe bereit ist. Das passiert ungefähr zur selben Zeit, zu der das Gerät BOOT_COMPLETE meldet. Das geschieht anscheinend asynchron, da die aktuelle Framework-Implementierung gelegentlich Race Conditions aufweist. Anschließend wird der Befehl zum Schließen des Keyguards gesendet (funktioniert nur bei nicht sicheren Keyguards).

Löst aus
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath, 
                int userId)

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

Parameter
deviceFilePath String: Der absolute Pfad der Datei auf dem Gerät, die geprüft werden soll.
userId int: Die Nutzer-ID, anhand der die Existenz der Datei geprüft werden soll.
Gibt Folgendes zurück:
boolean true, wenn die Datei vorhanden ist, andernfalls false.
Löst aus
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 Gerät, die geprüft werden soll.
Gibt Folgendes zurück:
boolean true, wenn die Datei vorhanden ist, andernfalls false.
Löst aus
DeviceNotAvailableException

dumpHeap

public File dumpHeap (String process, 
                String devicePath)

Versuchen Sie, den Heap aus dem system_server zu sichern. Der Aufrufer ist für das Bereinigen der gesicherten Datei verantwortlich.

Parameter
process String: Der Name des Geräteprozesses, für den „dumpheap“ ausgeführt werden soll.
devicePath String: Der Pfad auf dem Gerät, unter dem der Dump abgelegt werden soll. Das muss ein Ort sein, an dem dies aufgrund der Berechtigungen zulässig ist.
Gibt Folgendes zurück:
File File, der den Bericht enthält. „Null“, wenn ein Fehler aufgetreten ist.
Löst aus
DeviceNotAvailableException

getActiveApexes

public Set<ITestDevice.ApexInfo> getActiveApexes ()

Ruft die Informationen zu den auf dem Gerät aktivierten APEX-Modulen ab.

Gibt Folgendes zurück:
Set<ITestDevice.ApexInfo> Set von ApexInfo ist derzeit auf dem Gerät aktiviert
Löst aus
DeviceNotAvailableException

getAllSettings

public Map<String, String> getAllSettings (String namespace)

Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück.

Parameter
namespace String: muss einer der folgenden Werte sein: {"system", "secure", "global"}
Gibt Folgendes zurück:
Map<String, String> Die Zuordnung von Schlüssel/Wert-Paaren. „Null“, wenn der Namespace nicht unterstützt wird.
Löst aus
DeviceNotAvailableException

getAndroidId

public String getAndroidId (int userId)

Sucht die Android-ID, die einem Nutzer zugeordnet ist, und gibt sie zurück. Wenn sie nicht gefunden wird, wird „null“ zurückgegeben.

Parameter
userId int

Gibt Folgendes zurück:
String

Löst aus
DeviceNotAvailableException

getAndroidIds

public Map<Integer, String> getAndroidIds ()

Erstellen Sie eine Zuordnung von Android-IDs, die mit Nutzer-IDs übereinstimmen. Es gibt keine Garantie, dass für jede User-ID eine zugehörige Android-ID gefunden wird. Daher kann es vorkommen, dass einige User-IDs mit „null“ übereinstimmen.

Gibt Folgendes zurück:
Map<Integer, String> Zuordnung von Android-IDs, die mit Nutzer-IDs übereinstimmen.
Löst aus
DeviceNotAvailableException

getAppPackageInfo

public PackageInfo getAppPackageInfo (String packageName)

Informationen zu einem auf dem Gerät installierten Paket abrufen.

Parameter
packageName String

Gibt Folgendes zurück:
PackageInfo PackageInfo oder null, wenn Informationen nicht abgerufen werden konnten
Löst aus
DeviceNotAvailableException

getAppPackageInfos

public List<PackageInfo> getAppPackageInfos ()

Informationen zu auf dem Gerät installierten Paketen abrufen.

Gibt Folgendes zurück:
List<PackageInfo> List von PackageInfo, die auf dem Gerät installiert sind.
Löst aus
DeviceNotAvailableException

getBugreport

public InputStreamSource getBugreport ()

Ruft einen Fehlerbericht vom Gerät ab.

Die Implementierung dieser Funktion funktioniert garantiert auch auf Geräten ohne SD-Karte (oder wenn die SD-Karte noch nicht eingebunden ist).

Gibt Folgendes zurück:
InputStreamSource Ein InputStreamSource, das die Inhalte des Fehlerberichts auf Anfrage generiert. Im Fehlerfall gibt InputStreamSource eine leere InputStream zurück.

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 nützlich sind.

Wird nur für „adb version“ > 1.0.36 unterstützt.

Gibt Folgendes zurück:
InputStreamSource InputStreamSource der ZIP-Datei mit den Bugreportz. Bei einem Fehler wird „null“ zurückgegeben.

getCurrentFoldableState

public DeviceFoldableState getCurrentFoldableState ()

Gibt den aktuellen Status des faltbaren Geräts zurück oder „null“, wenn Probleme aufgetreten sind.

Gibt Folgendes zurück:
DeviceFoldableState

Löst aus
DeviceNotAvailableException

getCurrentUser

public int getCurrentUser ()

Gibt die ID des aktuell ausgeführten Nutzers zurück. Im Fehlerfall wird -10000 zurückgegeben.

Gibt Folgendes zurück:
int

Löst aus
DeviceNotAvailableException

getFoldableStates

public Set<DeviceFoldableState> getFoldableStates ()

Gibt die Liste der faltbaren Status auf dem Gerät zurück. Kann mit „cmd device_state print-states“ abgerufen werden.

Gibt Folgendes zurück:
Set<DeviceFoldableState>

Löst aus
DeviceNotAvailableException

getInstalledPackageNames

public Set<String> getInstalledPackageNames ()

Die Paketnamen der auf dem Gerät vorhandenen Anwendungen abrufen.

Gibt Folgendes zurück:
Set<String> Set von String Paketnamen, die derzeit auf dem Gerät installiert sind.
Löst aus
DeviceNotAvailableException

getKeyguardState

public KeyguardControllerState getKeyguardState ()

Gibt ein Objekt zurück, um den aktuellen Status des Keyguard zu erhalten, oder „null“, wenn dies nicht unterstützt wird.

Gibt Folgendes zurück:
KeyguardControllerState ein KeyguardControllerState mit einem Snapshot des Status des Keyguard zurückgibt und Null zurückgibt, wenn die Keyguard-Abfrage nicht unterstützt wird.
Löst aus
DeviceNotAvailableException

getMainUserId

public Integer getMainUserId ()

Gibt die Hauptnutzer-ID zurück.

Gibt Folgendes zurück:
Integer Die userId des Hauptnutzers, falls vorhanden, andernfalls null.
Löst aus
DeviceNotAvailableException

getMainlineModuleInfo

public Set<String> getMainlineModuleInfo ()

Ruft Informationen zu den auf dem Gerät installierten Mainline-Modulen ab.

Gibt Folgendes zurück:
Set<String> Set der String-Mainline-Module, die derzeit auf dem Gerät installiert sind.
Löst aus
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public int getMaxNumberOfRunningUsersSupported ()

Die maximale Anzahl der unterstützten gleichzeitig aktiven Nutzer abrufen. Die Standardeinstellung ist 0.

Gibt Folgendes zurück:
int Eine Ganzzahl, die die Anzahl der gleichzeitig ausgeführten Nutzer angibt.
Löst aus
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported (String userType)

Ruft die maximale Anzahl der unterstützten Nutzer des angegebenen Nutzertyps ab. Die Standardeinstellung ist 0.

Parameter
userType String: Der Nutzertyp, wie in UserManager definiert, z. B. „android.os.usertype.full.SECONDARY“.
Gibt Folgendes zurück:
int Eine Ganzzahl, die die Anzahl der unterstützten Nutzer des angegebenen Nutzertyps angibt.
Löst aus
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public int getMaxNumberOfUsersSupported ()

Ruft die maximale Anzahl der unterstützten wechselbaren Nutzer ab, ohne Gäste. Ab API-Version 36 sind nicht wechselbare Nutzer (z. B. Profile) nicht mehr enthalten. Die Standardeinstellung ist 0.

Gibt Folgendes zurück:
int Eine Ganzzahl, die die Anzahl der unterstützten umschaltbaren Nutzer angibt
Löst aus
DeviceNotAvailableException

getPrimaryUserId

public Integer getPrimaryUserId ()

Gibt die Hauptnutzer-ID zurück.

Gibt Folgendes zurück:
Integer Die userId des Hauptnutzers, falls vorhanden, andernfalls „null“.
Löst aus
DeviceNotAvailableException

getRemainingCreatableUserCount

public int getRemainingCreatableUserCount (String userType)

Gibt zurück, wie viele Nutzer des angegebenen Nutzertyps auf diesem Gerät erstellt werden können.

Parameter
userType String: Der Nutzertyp, wie in UserManager definiert, z. B. „android.os.usertype.full.SECONDARY“.
Gibt Folgendes zurück:
int wie viele Nutzer des angegebenen Nutzertyps hinzugefügt werden können
Löst aus
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (Long displayId, 
                String format, 
                boolean rescale)

Erstellt einen Screenshot des Displays mit der angegebenen ID im unterstützten Format. Reskalierung zulassen, um kleinere Größen zu unterstützen

Parameter
displayId Long: Die Anzeige-ID des Bildschirms, von dem ein Screenshot erstellt werden soll.
format String: Unterstützte PNG- und JPEG-Dateien
rescale boolean: Gibt an, ob der Screenshot skaliert werden soll, um die Größe des resultierenden Bildes zu verringern.
Gibt Folgendes zurück:
InputStreamSource InputStreamSource des Screenshots im Format oder null, wenn der Screenshot nicht erfolgreich war.
Löst aus
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (String format, 
                boolean rescale)

Erstellt einen Screenshot vom Gerät. Wir empfehlen, stattdessen getScreenshot(String) mit JPEG-Codierung zu verwenden, um die Größe zu verringern.

Parameter
format String: Unterstützte PNG- und JPEG-Dateien
rescale boolean: Gibt an, ob der Screenshot skaliert werden soll, um die Größe des resultierenden Bildes zu verringern.
Gibt Folgendes zurück:
InputStreamSource InputStreamSource des Screenshots im Format oder null, wenn der Screenshot nicht erfolgreich war.
Löst aus
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (String format)

Erstellt einen Screenshot vom Gerät. Es wird empfohlen, stattdessen „getScreenshot(format)“ mit JPEG-Codierung zu verwenden, um die Größe zu verringern.

Parameter
format String: Unterstützte PNG- und JPEG-Dateien
Gibt Folgendes zurück:
InputStreamSource InputStreamSource des Screenshots im Format oder null, wenn der Screenshot nicht erfolgreich war.
Löst aus
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot (long displayId)

Erstellt einen Screenshot des Geräts mit der angegebenen Anzeige-ID. Das Format ist PNG.

AUFGABE: Die Implementierungen oben müssen erweitert werden, um „format“ und „rescale“ zu unterstützen.

Parameter
displayId long: Die Anzeige-ID des Bildschirms, von dem ein Screenshot erstellt werden soll.
Gibt Folgendes zurück:
InputStreamSource InputStreamSource des Screenshots im Format oder null, wenn der Screenshot nicht erfolgreich war.
Löst aus
DeviceNotAvailableException

getScreenshot

public InputStreamSource getScreenshot ()

Erstellt einen Screenshot vom Gerät.

Gibt Folgendes zurück:
InputStreamSource InputStreamSource des Screenshots im PNG-Format oder null, wenn der Screenshot nicht erfolgreich war.
Löst aus
DeviceNotAvailableException

getSetting

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

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

Parameter
userId int

namespace String

key String

Gibt Folgendes zurück:
String Der Wert, der mit dem Namespace:Schlüssel eines Nutzers verknüpft ist. Null, wenn nicht gefunden.
Löst aus
DeviceNotAvailableException

getSetting

public String getSetting (String namespace, 
                String key)

Weitere Informationen finden Sie unter getSetting(int,String,String).

Parameter
namespace String

key String

Gibt Folgendes zurück:
String

Löst aus
DeviceNotAvailableException

getUninstallablePackageNames

public Set<String> getUninstallablePackageNames ()

Ruft die Paketnamen der Anwendungen ab, die deinstalliert werden können. Derzeit sind das Nicht-Systempakete und aktualisierte Systempakete.

Gibt Folgendes zurück:
Set<String> Set der nicht deinstallierbaren String-Paketnamen, die derzeit auf dem Gerät installiert sind.
Löst aus
DeviceNotAvailableException

getUserFlags

public int getUserFlags (int userId)

Sucht nach den Markierungen eines bestimmten Nutzers und gibt sie zurück. Flags werden in der Klasse „android.content.pm.UserInfo“ im Open-Source-Projekt für Android definiert.

Parameter
userId int

Gibt Folgendes zurück:
int Die mit der angegebenen userId verknüpften Flags, falls vorhanden, andernfalls -10000.
Löst aus
DeviceNotAvailableException

getUserInfos

public Map<Integer, UserInfo> getUserInfos ()

Ruft die Zuordnung von useId zu UserInfo auf dem Gerät ab. Löst DeviceRuntimeException aus, wenn die Ausgabe des Geräts nicht wie erwartet ist.

Gibt Folgendes zurück:
Map<Integer, UserInfo> Die Liste der UserInfo-Objekte.
Löst aus
DeviceNotAvailableException

getUserSerialNumber

public int getUserSerialNumber (int userId)

Gibt die dem userId zugeordnete Seriennummer zurück, falls gefunden, andernfalls -10000.

Parameter
userId int

Gibt Folgendes zurück:
int

Löst aus
DeviceNotAvailableException

getUserVisibleOnDisplay

public int getUserVisibleOnDisplay (int displayId)

Ruft die Nutzer-ID des sichtbaren Nutzers auf dem angegebenen Display ab.

Parameter
displayId int: Die ID des Displays.
Gibt Folgendes zurück:
int Die Nutzer-ID des sichtbaren Nutzers auf dem angegebenen Display. Es wird nicht zwischen einem sichtbaren Hintergrundnutzer und dem aktuellen Vordergrundnutzer unterschieden, da beide Arten sichtbar sind. Um die beiden Ergebnisse zu unterscheiden, vergleichen Sie sie mit dem Ergebnis von getCurrentUser().
Löst aus
DeviceNotAvailableException

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.
Gibt Folgendes zurück:
boolean „True“, wenn das Feature gefunden wird, andernfalls „false“.
Löst aus
DeviceNotAvailableException

installPackage

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

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

Hinweis: Diese Funktion sollte nur für Anwendungsfälle aufgerufen werden, die eine explizite Steuerung der Erteilung der Laufzeitberechtigung bei der Installation erfordern.

Parameter
packageFile File: die zu installierende APK-Datei
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions boolean: Gibt an, ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen.
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“.
Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.
Löst aus
DeviceNotAvailableException

installPackage

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

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

Parameter
packageFile File: die zu installierende APK-Datei
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“.
Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.
Löst aus
DeviceNotAvailableException

installPackageForUser

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

Installiert ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.

Hinweis: Diese Funktion sollte nur für Anwendungsfälle aufgerufen werden, die eine explizite Steuerung der Erteilung der Laufzeitberechtigung bei der Installation erfordern.

Parameter
packageFile File: die zu installierende APK-Datei
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions boolean: Gibt an, ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen.
userId int: Die Nutzer-ID als Ganzzahl, für die die Installation erfolgen soll.
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“.
Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.
Löst aus
DeviceNotAvailableException

installPackageForUser

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

Installiert ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.

Parameter
packageFile File: die zu installierende APK-Datei
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
userId int: Die Nutzer-ID als Ganzzahl, für die die Installation erfolgen soll.
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“.
Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.
Löst aus
DeviceNotAvailableException

installPackageWithIncrementalMode

public boolean installPackageWithIncrementalMode (File[] apkFiles, 
                String[] extraArgs, 
                String userId)

Installiert APKs im inkrementellen Modus.

Parameter
apkFiles File: die zu installierenden APK-Dateien.
extraArgs String

userId String

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

installPackages

public String installPackages (List<File> packageFiles, 
                boolean reinstall, 
                String... extraArgs)

Parameter
packageFiles List

reinstall boolean

extraArgs String

Gibt Folgendes zurück:
String

Löst aus
DeviceNotAvailableException

installPackages

public String installPackages (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

Parameter
packageFiles List

reinstall boolean

grantPermissions boolean

extraArgs String

Gibt Folgendes zurück:
String

Löst aus
DeviceNotAvailableException

installPackagesForUser

public String installPackagesForUser (List<File> packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

Parameter
packageFiles List

reinstall boolean

userId int

extraArgs String

Gibt Folgendes zurück:
String

Löst aus
DeviceNotAvailableException

installPackagesForUser

public String installPackagesForUser (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

Parameter
packageFiles List

reinstall boolean

grantPermissions boolean

userId int

extraArgs String

Gibt Folgendes zurück:
String

Löst aus
DeviceNotAvailableException

isAppEnumerationSupported

public boolean isAppEnumerationSupported ()

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

Gibt Folgendes zurück:
boolean „True“, wenn die App-Aufzählung unterstützt wird, andernfalls „false“
Löst aus
DeviceNotAvailableException

isHeadlessSystemUserMode

public boolean isHeadlessSystemUserMode ()

Gibt zurück, ob auf dem Gerät der monitorlose Systemnutzermodus verwendet wird.

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

isMainUserPermanentAdmin

public boolean isMainUserPermanentAdmin ()

Gibt zurück, ob der Hauptnutzer ein permanenter Administrator ist und nicht gelöscht oder auf den Status „Nicht-Administrator“ herabgestuft werden kann.

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

isMultiUserSupported

public boolean isMultiUserSupported ()

Gibt zurück, ob dieses Gerät mehrere umschaltbare Nutzer mit eigenem Login und anpassbarem Bereich unterstützt.

Auch wenn die Antwort „Falsch“ lautet, können mehrere Nutzer möglicherweise trotzdem möglich sein, sofern keine Anmelde-UI erforderlich ist. Profile werden beispielsweise möglicherweise weiterhin unterstützt, da sie keine Anmelde-UI erfordern.

Außerdem wird „config_enableMultiUserUI“ geprüft. Auf Anfrage dürfen wir davon ausgehen, dass Geräte, für die dies zutrifft, so konfiguriert sind, dass sekundäre Nutzer über ADB hinzugefügt werden können.

Gibt Folgendes zurück:
boolean Gibt an, ob das Gerät mehrere umschaltbare Nutzer unterstützt.
Löst aus
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName, 
                String userId)

Fragen Sie das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID ab, um zu prüfen, ob die App für diesen Nutzer derzeit installiert ist.

Parameter
packageName String: Das Paket, für das wir prüfen, ob es installiert ist.
userId String: Die Nutzer-ID, für die wir prüfen, ob das Paket installiert ist. Wenn „null“, wird der Hauptnutzer 0 verwendet.
Gibt Folgendes zurück:
boolean „True“, wenn das Paket als installiert gemeldet wird. Andernfalls „Falsch”.
Löst aus
DeviceNotAvailableException

isPackageInstalled

public boolean isPackageInstalled (String packageName)

Fragen Sie das Gerät nach einem bestimmten Paketnamen, um zu prüfen, ob das Paket derzeit installiert ist.

Parameter
packageName String

Gibt Folgendes zurück:
boolean „True“, wenn das Paket als installiert gemeldet wird. Andernfalls „Falsch”.
Löst aus
DeviceNotAvailableException

isUserRunning

public boolean isUserRunning (int userId)

Prüfen, ob ein bestimmter Nutzer aktiv ist.

Parameter
userId int

Gibt Folgendes zurück:
boolean „True“, wenn der Nutzer läuft, andernfalls „False“.
Löst aus
DeviceNotAvailableException

isUserSecondary

public boolean isUserSecondary (int userId)

Gibt zurück, ob der angegebene Nutzer anhand seiner Flags ein sekundärer Nutzer ist.

Parameter
userId int

Gibt Folgendes zurück:
boolean „true“, wenn der Nutzer sekundär ist, andernfalls „false“.
Löst aus
DeviceNotAvailableException

isUserVisible

public boolean isUserVisible (int userId)

Prüft, ob der angegebene Nutzer sichtbar ist.

Ein „sichtbarer“ Nutzer ist ein Nutzer, der mit dem „menschlichen“ Nutzer interagiert und daher Launch-Aktivitäten (in der Regel auf dem Standarddisplay) starten kann.

Parameter
userId int

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

isUserVisibleOnDisplay

public boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Prüft, ob der angegebene Nutzer auf dem angegebenen Display sichtbar ist.

Ein „sichtbarer“ Nutzer ist ein Nutzer, der mit dem „menschlichen“ Nutzer interagiert und daher Aktivitäten auf diesem Display starten kann.

Parameter
userId int

displayId int

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Gibt zurück, ob Nutzer im Hintergrund in ERROR(/java.android.view.Display#DEFAULT_DISPLAY) sichtbar sein dürfen.

Wenn das der Fall ist, können Sie startVisibleBackgroundUser(int, int, boolean) aufrufen und ein von listDisplayIdsForStartingVisibleBackgroundUsers() zurückgegebenes Display übergeben, das ERROR(/java.android.view.Display#DEFAULT_DISPLAY) enthalten sollte.

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public boolean isVisibleBackgroundUsersSupported ()

Gibt zurück, ob Nutzer im Hintergrund sichtbar sein dürfen.

Wenn dies der Fall ist, können Sie startVisibleBackgroundUser(int, int, boolean) aufrufen und ein von listDisplayIdsForStartingVisibleBackgroundUsers() zurückgegebenes Display übergeben.

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

listDisplayIds

public Set<Long> listDisplayIds ()

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

Gibt Folgendes zurück:
Set<Long> Die Liste der Displays. „Default“ gibt immer die Standardanzeige 0 zurück.
Löst aus
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

Ruft die Liste der Displays ab, die für start a user visible in the background verwendet werden können.

Gibt Folgendes zurück:
Set<Integer>

Löst aus
DeviceNotAvailableException

listUsers

public ArrayList<Integer> listUsers ()

Ruft die Liste der Nutzer auf dem Gerät ab. Löst DeviceRuntimeException aus, wenn die Ausgabe des Geräts nicht wie erwartet ist.

Gibt Folgendes zurück:
ArrayList<Integer> Die Liste der Nutzer-IDs.
Löst aus
DeviceNotAvailableException

logBugreport

public boolean logBugreport (String dataName, 
                ITestLogger listener)

Hilfsmethode zum Erstellen eines Fehlerberichts und zum Protokollieren des Berichts für die Reporter.

Parameter
dataName String: Der Name, unter dem der Fehlerbericht gemeldet wird.
listener ITestLogger: eine ITestLogger zum Protokollieren des Fehlerberichts.
Gibt Folgendes zurück:
boolean „True“, wenn die Protokollierung erfolgreich war, andernfalls „false“.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Parameter
waitPhase SnapuserdWaitPhase

postInvocationTearDown

public void postInvocationTearDown (Throwable exception)

Zusätzliche Schritte für die gerätespezifische erforderliche Bereinigung, die nach dem Aufruf ausgeführt werden.

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

removeAdmin

public boolean removeAdmin (String componentName, 
                int userId)

Entfernt den angegebenen Geräteadministrator für den angegebenen Nutzer und gibt true zurück, wenn der Vorgang erfolgreich war, andernfalls false.

Parameter
componentName String: des zu entfernenden Geräteadministrators.
userId int: des Nutzers, in dem sich der Geräteadministrator befindet.
Gibt Folgendes zurück:
boolean „True“, wenn erfolgreich, andernfalls „false“.
Löst aus
DeviceNotAvailableException

removeOwners

public void removeOwners ()

Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen.

Löst aus
DeviceNotAvailableException

removeUser

public boolean removeUser (int userId)

Einen bestimmten Nutzer vom Gerät entfernen.

Parameter
userId int: des zu entfernenden Nutzers
Gibt Folgendes zurück:
boolean „true“, wenn der Nutzer erfolgreich entfernt wurde, andernfalls „false“.
Löst aus
DeviceNotAvailableException

setDeviceOwner

public boolean setDeviceOwner (String componentName, 
                int userId)

Legt eine Geräteadministrator-Komponente als Geräteinhaber für einen bestimmten Nutzer fest.

Parameter
componentName String: des Geräteadministrators zum Geräteinhaber.
userId int: des Nutzers, in dem der Geräteinhaber lebt.
Gibt Folgendes zurück:
boolean „True“, wenn erfolgreich, andernfalls „false“.
Löst aus
DeviceNotAvailableException

setFirstBootloaderReboot

public void setFirstBootloaderReboot ()

setSetting

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

Weitere Informationen finden Sie unter setSetting(int,String,String,String).

Parameter
namespace String

key String

value String

Löst aus
DeviceNotAvailableException

setSetting

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

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

Parameter
userId int

namespace String

key String

value String

Löst aus
DeviceNotAvailableException

shutdownMicrodroid

public void shutdownMicrodroid (ITestDevice microdroidDevice)

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

Parameter
microdroidDevice ITestDevice

Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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
Gibt Folgendes zurück:
boolean „true“, wenn der Nutzer erfolgreich im Hintergrund gestartet wurde.
Löst aus
DeviceNotAvailableException

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 wird erst ausgeführt, wenn der Nutzer gestartet und entsperrt wurde.
Gibt Folgendes zurück:
boolean „true“, wenn der Nutzer erfolgreich im Hintergrund gestartet wurde.
Löst aus
DeviceNotAvailableException

startVisibleBackgroundUser

public boolean startVisibleBackgroundUser (int userId, 
                int displayId, 
                boolean waitFlag)

Startet einen bestimmten Nutzer im Hintergrund, der auf dem angegebenen Display sichtbar ist (d.h. der Nutzer kann Aktivitäten auf diesem Display starten).

HINWEIS : Mit diesem Befehl wird nicht geprüft, ob der Nutzer vorhanden ist, ob die Anzeige verfügbar ist, ob device supports such feature usw.

Parameter
userId int: des Nutzers, der im Hintergrund gestartet werden soll
displayId int: Display, auf dem der Nutzer die Anzeige sehen soll
waitFlag boolean: Der Befehl wird erst ausgeführt, wenn der Nutzer gestartet und entsperrt wurde.
Gibt Folgendes zurück:
boolean true, wenn der Nutzer sichtbar im Hintergrund gestartet wurde.
Löst aus
DeviceNotAvailableException

stopUser

public boolean stopUser (int userId)

Stoppt einen bestimmten Nutzer. Wenn der Nutzer bereits angehalten wurde, ist diese Methode ein NOOP. Der aktuelle Nutzer und der Systemnutzer können nicht beendet werden.

Parameter
userId int: des Nutzers, der gestoppt werden soll.
Gibt Folgendes zurück:
boolean „true“, wenn der Nutzer erfolgreich gestoppt wurde.
Löst aus
DeviceNotAvailableException

stopUser

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

Einen bestimmten Nutzer stoppen. Es ist möglich, zusätzliche Flags anzugeben, um zu warten, bis der Vorgang wirksam wird, und den Nutzer zu beenden. Der aktuelle Nutzer und der Systemnutzer können nicht beendet werden.

Parameter
userId int: des Nutzers, der gestoppt werden soll.
waitFlag boolean: Der Befehl wartet, bis der Nutzer gestoppt wird.
forceFlag boolean: Der Nutzer wird zum Beenden gezwungen.
Gibt Folgendes zurück:
boolean „true“, wenn der Nutzer erfolgreich gestoppt wurde.
Löst aus
DeviceNotAvailableException

supportsMicrodroid

public boolean supportsMicrodroid ()

Prüft die Voraussetzungen für die Ausführung eines Microdroid.

Gibt Folgendes zurück:
boolean Gibt „true“ zurück, wenn die Voraussetzungen erfüllt sind, andernfalls „false“.
Löst aus
Exception

supportsMicrodroid

public boolean supportsMicrodroid (boolean protectedVm)

Prüft die Voraussetzungen für die Ausführung eines Microdroid.

Parameter
protectedVm boolean: „true“, wenn der Microdroid auf einer geschützten VM ausgeführt werden soll.
Gibt Folgendes zurück:
boolean Gibt „true“ zurück, wenn die Voraussetzungen erfüllt sind, andernfalls „false“.
Löst aus
DeviceNotAvailableException

switchUser

public boolean switchUser (int userId)

Wechseln Sie mit einem Standard-Timeout zu einer anderen userId. switchUser(int, long).

Parameter
userId int

Gibt Folgendes zurück:
boolean „True“, wenn die neue User-ID mit dem User-ID-Anbieter übereinstimmt. Andernfalls „Falsch”.
Löst aus
DeviceNotAvailableException

switchUser

public boolean switchUser (int userId, 
                long timeout)

Wechseln Sie mit dem angegebenen Zeitlimit zu einer anderen userId. Versuche, die Keyguard-Sperre zu deaktivieren, nachdem der Nutzerwechsel erfolgreich war.

Parameter
userId int

timeout long: Die Wartezeit, bevor „false“ für „switch-user failed“ zurückgegeben wird.
Gibt Folgendes zurück:
boolean „True“, wenn die neue User-ID mit dem User-ID-Anbieter übereinstimmt. Andernfalls „Falsch”.
Löst aus
DeviceNotAvailableException

takeBugreport

public Bugreport takeBugreport ()

Nimmt einen Fehlerbericht entgegen und gibt ihn in einem Bugreport-Objekt zurück, um ihn zu verarbeiten. Gibt bei Problemen „null“ zurück. Auf Dateien, auf die im Bugreport-Objekt verwiesen wird, muss über Bugreport.close() zugegriffen werden.

Gibt Folgendes zurück:
Bugreport

uninstallPackage

public String uninstallPackage (String packageName)

Ein Android-Paket vom Gerät deinstallieren.

Parameter
packageName String: das Android-Paket, das deinstalliert werden soll
Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.
Löst aus
DeviceNotAvailableException

uninstallPackageForUser

public String uninstallPackageForUser (String packageName, 
                int userId)

Deinstalliert ein Android-Paket für einen bestimmten Nutzer von einem Gerät.

Parameter
packageName String: das Android-Paket, das deinstalliert werden soll
userId int: Die Nutzer-ID als Ganzzahl, für die die Deinstallation erfolgen soll.
Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.
Löst aus
DeviceNotAvailableException

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Parameter
currentPhase SnapuserdWaitPhase

Löst aus
DeviceNotAvailableException

Geschützte Methoden

createParser

protected AaptParser createParser (File appFile)

Parameter
appFile File

Gibt Folgendes 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.
Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreportInternal

protected InputStreamSource getBugreportInternal ()

Gibt Folgendes zurück:
InputStreamSource

getBugreportzInternal

protected File getBugreportzInternal ()

Interne Hilfsmethode zum Abrufen der ZIP-Datei „bugreportz“ als File.

Gibt Folgendes zurück:
File

getCheckNewUserSleep

protected long getCheckNewUserSleep ()

Für Tests verfügbar gemacht.

Gibt Folgendes zurück:
long

getHostCurrentTime

protected long getHostCurrentTime ()

Für Tests verfügbar gemacht

Gibt Folgendes zurück:
long

prePostBootSetup

protected void prePostBootSetup ()

Ermöglicht es jedem Gerätetyp (AndroidNativeDevice, TestDevice), diese Methode für die spezifische Einrichtung nach dem Booten zu überschreiben.

Löst aus
DeviceNotAvailableException