ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice


Stellt eine zuverlässige und etwas höhere API für ein ddmlib- IDevice bereit.

Wiederholt Gerätebefehle für eine konfigurierbare Anzahl und stellt eine Gerätewiederherstellungsschnittstelle für Geräte bereit, die nicht reagieren.

Zusammenfassung

Verschachtelte Klassen

class ITestDevice.ApexInfo

Eine einfache Strukturklasse zum Speichern von Informationen zu einem einzelnen APEX

class ITestDevice.MountPointInfo

Eine einfache Strukturklasse zum Speichern von Informationen über einen einzelnen Mountpoint

Öffentliche Methoden

abstract boolean canSwitchToHeadlessSystemUser ()

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

abstract boolean checkConnectivity ()

Überprüfen Sie, ob das Gerät über eine Netzwerkverbindung verfügt.

abstract boolean clearErrorDialogs ()

Versuchen Sie, alle Fehlerdialoge zu schließen, die derzeit auf der Benutzeroberfläche des Geräts angezeigt werden.

abstract void clearLastConnectedWifiNetwork ()

Löscht das zuletzt verbundene WLAN-Netzwerk.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid) connectToWifiNetwork ( wifiSsidToPsk, boolean scanSsid)

Verbindet sich mit einem WLAN-Netzwerk.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

Verbindet sich mit einem WLAN-Netzwerk.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

Verbindet sich mit einem WLAN-Netzwerk.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk, boolean scanSsid)

Verbindet sich mit einem WLAN-Netzwerk.

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk, boolean scanSsid)

Eine Variante von connectToWifiNetwork(String, String) , die nur dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkkonnektivität hat.

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

Eine Variante von connectToWifiNetwork(String, String) , die nur dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkkonnektivität hat.

abstract int createUser (String name)

Erstellen Sie einen Benutzer mit einem bestimmten Namen und den Standardflags 0.

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

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

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

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

abstract int createUserNoThrow (String name)

Erstellen Sie einen Benutzer mit einem bestimmten Namen und den Standardflags 0.

abstract void deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Entfernt den registrierten IDeviceActionReceiver .

abstract void disableKeyguard ()

Versucht, den Tastenschutz zu deaktivieren.

abstract boolean disableNetworkMonitor ()

Deaktiviert die Netzwerküberwachung auf dem Gerät.

abstract boolean disconnectFromWifi ()

Trennt die Verbindung zu einem WLAN-Netzwerk.

abstract boolean doesFileExist (String deviceFilePath, int userId)

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

abstract File dumpHeap (String process, String devicePath)

Versuchen Sie, den Heap vom Systemserver zu sichern.

abstract boolean enableNetworkMonitor ()

Aktiviert die Netzwerküberwachung auf dem Gerät.

abstract getActiveApexes ()

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

abstract getAllSettings (String namespace)

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

abstract String getAndroidId (int userId)

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

abstract getAndroidIds ()

Erstellen Sie eine Karte mit gefundenen Android-IDs, die mit Benutzer-IDs übereinstimmen.

abstract PackageInfo getAppPackageInfo (String packageName)

Rufen Sie Informationen zu einem auf dem Gerät installierten Paket ab.

abstract getAppPackageInfos ()

Rufen Sie Informationen zu den auf dem Gerät installierten Paketen ab.

abstract InputStreamSource getBugreport ()

Ruft einen Fehlerbericht vom Gerät ab.

abstract InputStreamSource getBugreportz ()

Ruft einen Fehlerbericht vom Gerät ab.

abstract DeviceFoldableState getCurrentFoldableState ()

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

abstract int getCurrentUser ()

Gibt die ID des aktuell aktiven Benutzers zurück.

abstract getFoldableStates ()

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

abstract getInstalledPackageNames ()

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

abstract String getIpAddress ()

Ruft die IP-Adresse des Geräts ab.

abstract KeyguardControllerState getKeyguardState ()

Gibt ein Objekt zurück, um den aktuellen Status des Keyguards abzurufen, oder null, wenn dies nicht unterstützt wird.

abstract Integer getMainUserId ()

Gibt die Hauptbenutzer-ID zurück.

abstract getMainlineModuleInfo ()

Rufen Sie Informationen zu den auf dem Gerät installierten Hauptmodulen ab.

abstract int getMaxNumberOfRunningUsersSupported ()

Erhalten Sie die maximale Anzahl unterstützter gleichzeitig laufender Benutzer.

abstract int getMaxNumberOfUsersSupported ()

Erhalten Sie die maximale Anzahl unterstützter Benutzer.

abstract TestDeviceOptions getOptions ()

Rufen Sie die Testoptionen für das Gerät ab.

abstract Integer getPrimaryUserId ()

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

abstract InputStreamSource getScreenshot ()

Erfasst einen Screenshot vom Gerät.

abstract InputStreamSource getScreenshot (String format, boolean rescale)

Erfasst einen Screenshot vom Gerät.

abstract InputStreamSource getScreenshot (String format)

Erfasst einen Screenshot vom Gerät.

abstract InputStreamSource getScreenshot (long displayId)

Erfasst einen Screenshot des Geräts mit der angegebenen Anzeige-ID.

abstract String getSetting (String namespace, String key)

Siehe getSetting(int, String, String) und wird für den Systembenutzer ausgeführt.

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

Gibt den Wert der angeforderten Einstellung zurück.

abstract getUninstallablePackageNames ()

Rufen Sie die Namen der Anwendungspakete ab, die deinstalliert werden können.

abstract int getUserFlags (int userId)

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

abstract getUserInfos ()

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

abstract int getUserSerialNumber (int userId)

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

abstract boolean hasFeature (String feature)

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

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

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

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

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

abstract 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.

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

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

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

Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien besteht (ein Haupt- und zusätzliche Split-Pakete).

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

Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht, die sich auf dem Android-Gerät befinden.

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

Installieren Sie für einen bestimmten Benutzer eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht.

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

Installieren Sie für einen bestimmten Benutzer eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht.

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

Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht, die sich auf dem Android-Gerät befinden.

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

Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht, die sich auf dem Android-Gerät befinden.

abstract boolean isHeadlessSystemUserMode ()

Gibt zurück, ob das Gerät den Headless-System-Benutzermodus verwendet.

abstract boolean isMainUserPermanentAdmin ()

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

abstract boolean isMultiUserSupported ()

Legt fest, ob Mehrbenutzer unterstützt werden.

abstract boolean isPackageInstalled (String packageName)

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

abstract boolean isPackageInstalled (String packageName, String userId)

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

abstract boolean isUserRunning (int userId)

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

abstract boolean isUserSecondary (int userId)

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

abstract boolean isUserVisible (int userId)

Überprüft, ob der angegebene Benutzer sichtbar ist.

abstract boolean isUserVisibleOnDisplay (int userId, int displayId)

Überprüft, ob der angegebene Benutzer in der angegebenen Anzeige sichtbar ist.

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Gibt zurück, ob das Gerät das Starten von Benutzern im Hintergrund im ERROR(/java.android.view.Display#DEFAULT_DISPLAY) zulässt.

abstract boolean isVisibleBackgroundUsersSupported ()

Gibt zurück, ob das Gerät das Starten von Benutzern im Hintergrund sichtbar zulässt.

abstract boolean isWifiEnabled ()

Testen Sie, ob WLAN aktiviert ist.

abstract listDisplayIds ()

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

abstract listDisplayIdsForStartingVisibleBackgroundUsers ()

Ruft die Liste der Anzeigen ab, die zum start a user visible in the background verwendet werden können.

abstract listUsers ()

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

abstract boolean logBugreport (String dataName, ITestLogger listener)

Hilfsmethode, um einen Fehlerbericht aufzunehmen und ihn für die Reporter zu protokollieren.

abstract void registerDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Registriert einen IDeviceActionReceiver für dieses Gerät.

abstract boolean removeAdmin (String componentName, int userId)

Entfernen Sie den angegebenen Geräteadministrator im angegebenen Benutzer und geben Sie true zurück, wenn es erfolgreich ist, andernfalls false .

abstract void removeOwners ()

Entfernen Sie mit größtmöglicher Mühe alle vorhandenen Geräteprofilbesitzer.

abstract boolean removeUser (int userId)

Entfernen Sie einen bestimmten Benutzer vom Gerät.

abstract boolean setDeviceOwner (String componentName, int userId)

Legen Sie eine Geräteadministratorkomponente als Geräteeigentümer für einen bestimmten Benutzer fest.

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

Siehe setSetting(int, String, String, String) und wird für den Systembenutzer ausgeführt.

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

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

abstract boolean startUser (int userId)

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

abstract boolean startUser (int userId, boolean waitFlag)

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

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

Startet einen bestimmten Benutzer im Hintergrund, sichtbar in der angegebenen Anzeige (d. h. ermöglicht dem Benutzer, Aktivitäten in dieser Anzeige zu starten).

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

Stoppen Sie einen bestimmten Benutzer.

abstract boolean stopUser (int userId)

Stoppt einen bestimmten Benutzer.

abstract boolean switchUser (int userId)

Wechseln Sie zu einer anderen Benutzer-ID mit einem Standard-Timeout.

abstract boolean switchUser (int userId, long timeout)

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

abstract Bugreport takeBugreport ()

Nehmen Sie einen Bugreport und geben Sie ihn in ein Bugreport Objekt zurück, um ihn zu verarbeiten.

abstract String uninstallPackage (String packageName)

Deinstallieren Sie ein Android-Paket vom Gerät.

abstract String uninstallPackageForUser (String packageName, int userId)

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

Öffentliche Methoden

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

Kehrt zurück
boolean

Würfe
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

Überprüfen Sie, ob das Gerät über eine Netzwerkverbindung verfügt.

Kehrt zurück
boolean true , wenn das Gerät über eine funktionierende Netzwerkverbindung verfügt, andernfalls false .

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

Versuchen Sie, alle Fehlerdialoge zu schließen, die derzeit auf der Benutzeroberfläche des Geräts angezeigt werden.

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

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Löscht das zuletzt verbundene WLAN-Netzwerk. Dies sollte beim Starten eines neuen Aufrufs aufgerufen werden, um zu vermeiden, dass nach dem Neustart des Geräts eine Verbindung zum WLAN-Netzwerk hergestellt wird, das im vorherigen Test verwendet wurde.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Verbindet sich mit einem WLAN-Netzwerk.

Schaltet WLAN ein und blockiert es, bis eine erfolgreiche Verbindung mit einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke hergestellt wird. Sobald eine Verbindung hergestellt ist, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice#disconnectFromWifi() oder ITestDevice#clearLastConnectedWifiNetwork() aufgerufen wird.

Parameter
wifiSsidToPsk : Eine Zuordnung von WLAN-SSIDs zu Passwörtern.

scanSsid boolean : ob nach versteckten SSIDs für dieses Netzwerk gesucht werden soll.

Kehrt zurück
boolean true , wenn die Verbindung zum WLAN-Netzwerk erfolgreich war. sonst false

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Verbindet sich mit einem WLAN-Netzwerk.

Schaltet WLAN ein und blockiert es, bis eine erfolgreiche Verbindung mit einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke hergestellt wird. Sobald eine Verbindung hergestellt ist, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice#disconnectFromWifi() oder ITestDevice#clearLastConnectedWifiNetwork() aufgerufen wird.

Parameter
wifiSsidToPsk : Eine Zuordnung von WLAN-SSIDs zu Passwörtern.

Kehrt zurück
boolean true , wenn die Verbindung zum WLAN-Netzwerk erfolgreich war. sonst false

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Verbindet sich mit einem WLAN-Netzwerk.

Schaltet WLAN ein und blockiert es, bis eine erfolgreiche Verbindung zum angegebenen WLAN-Netzwerk hergestellt wurde. Sobald eine Verbindung hergestellt ist, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice#disconnectFromWifi() oder ITestDevice#clearLastConnectedWifiNetwork() aufgerufen wird.

Parameter
wifiSsid String : die WLAN-SSID, mit der eine Verbindung hergestellt werden soll

wifiPsk String : PSK-Passphrase oder null, wenn unverschlüsselt

Kehrt zurück
boolean true , wenn die Verbindung zum WLAN-Netzwerk erfolgreich war. sonst false

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Verbindet sich mit einem WLAN-Netzwerk.

Schaltet WLAN ein und blockiert es, bis eine erfolgreiche Verbindung zum angegebenen WLAN-Netzwerk hergestellt wurde. Sobald eine Verbindung hergestellt ist, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice#disconnectFromWifi() oder ITestDevice#clearLastConnectedWifiNetwork() aufgerufen wird.

Parameter
wifiSsid String : die WLAN-SSID, mit der eine Verbindung hergestellt werden soll

wifiPsk String : PSK-Passphrase oder null, wenn unverschlüsselt

scanSsid boolean : ob nach versteckter SSID für dieses Netzwerk gesucht werden soll.

Kehrt zurück
boolean true , wenn die Verbindung zum WLAN-Netzwerk erfolgreich war. sonst false

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Eine Variante von connectToWifiNetwork(String, String) , die nur dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkkonnektivität hat.

Parameter
scanSsid boolean : ob nach versteckter SSID für dieses Netzwerk gesucht werden soll

Kehrt zurück
boolean true , wenn die Verbindung zum WLAN-Netzwerk erfolgreich war. sonst false

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Eine Variante von connectToWifiNetwork(String, String) , die nur dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkkonnektivität hat.

Kehrt zurück
boolean true , wenn die Verbindung zum WLAN-Netzwerk erfolgreich war. sonst false

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

public abstract int createUser (String name)

Erstellen Sie einen Benutzer mit einem bestimmten Namen und den Standardflags 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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

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 : Aktiviert das Benutzerflag --guest während der Erstellung

ephemeral boolean : Aktiviert das Benutzerflag --ephemeral während der Erstellung

forTesting boolean : Aktivieren Sie das Testflag --for-testing während der Erstellung

Kehrt zurück
int ID des erstellten Benutzers

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

public abstract 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 : Aktiviert das Benutzerflag --guest während der Erstellung

ephemeral boolean : Aktiviert das Benutzerflag --ephemeral während der Erstellung

Kehrt zurück
int ID des erstellten Benutzers

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

Erstellen Sie einen Benutzer mit einem bestimmten Namen und den Standardflags 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.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Entfernt den registrierten IDeviceActionReceiver .

Parameter
deviceActionReceiver IDeviceActionReceiver : Ein IDeviceActionReceiver , der entfernt wird.

deaktivierenKeyguard

public abstract void disableKeyguard ()

Versucht, den Tastenschutz zu deaktivieren.

Warten Sie zunächst, bis der Eingabeversand bereit ist. Dies geschieht ungefähr zur gleichen Zeit, wenn das Gerät BOOT_COMPLETE meldet, offenbar asynchron, da bei der aktuellen Framework-Implementierung gelegentlich eine Race-Bedingung auftritt. Anschließend wird der Befehl zum Aufheben der Tastensperre gesendet (funktioniert nur bei nicht sicheren Tastensperren).

Würfe
DeviceNotAvailableException

deaktivieren Sie NetworkMonitor

public abstract boolean disableNetworkMonitor ()

Deaktiviert die Netzwerküberwachung auf dem Gerät.

Kehrt zurück
boolean true , wenn die Überwachung erfolgreich deaktiviert wurde. false , wenn es fehlgeschlagen ist.

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.

Vom WLAN trennen

public abstract boolean disconnectFromWifi ()

Trennt die Verbindung zu einem WLAN-Netzwerk.

Entfernt alle Netzwerke aus der Liste bekannter Netzwerke und deaktiviert WLAN.

Kehrt zurück
boolean true , wenn die Verbindung zum WLAN-Netzwerk erfolgreich getrennt wurde. false , wenn die Trennung fehlgeschlagen ist.

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.

DoesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

userId int : Die Benutzer-ID, anhand derer die Dateiexistenz überprüft werden soll

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

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

Versuchen Sie, den Heap vom Systemserver zu sichern. Es liegt in der Verantwortung des Aufrufers, die gespeicherte Datei zu bereinigen.

Parameter
process String : Der Name des Geräteprozesses, auf dem der Dumpheap durchgeführt werden soll.

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.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Aktiviert die Netzwerküberwachung auf dem Gerät.

Kehrt zurück
boolean true , wenn die Überwachung erfolgreich aktiviert wurde. false , wenn es fehlgeschlagen ist.

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.

getActiveApexes

public abstract  getActiveApexes ()

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

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

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

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

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

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

Parameter
userId int

Kehrt zurück
String

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Erstellen Sie eine Karte mit gefundenen Android-IDs, die mit Benutzer-IDs übereinstimmen. Es gibt keine Garantie dafür, dass jede Benutzer-ID eine in dieser Funktion zugeordnete Android-ID findet, sodass einige Benutzer-IDs möglicherweise mit Null übereinstimmen.

Kehrt zurück
Karte der Android-IDs, die mit den Benutzer-IDs übereinstimmen.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

Rufen Sie Informationen zu einem auf dem Gerät installierten Paket ab.

Parameter
packageName String

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

Rufen Sie Informationen zu den auf dem Gerät installierten Paketen ab.

Kehrt zurück
ERROR(/List) der auf dem Gerät installierten PackageInfo .

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

Ruft einen Fehlerbericht vom Gerät ab.

Die Implementierung funktioniert garantiert weiterhin auf einem Gerät ohne SD-Karte (oder bei dem die SD-Karte noch nicht gemountet ist).

Kehrt zurück
InputStreamSource Eine InputStreamSource , die den Inhalt des Fehlerberichts bei Bedarf erstellt. Im Falle eines Fehlers erzeugt die InputStreamSource einen leeren ERROR(/InputStream) .

getBugreportz

public abstract InputStreamSource getBugreportz ()

Ruft einen Fehlerbericht vom Gerät ab. Der Bugreport im Zip-Format enthält den Haupt-Bugreport und andere Protokolldateien, die zum Debuggen nützlich sind.

Wird nur für „ADB-Version“ > 1.0.36 unterstützt

Kehrt zurück
InputStreamSource eine InputStreamSource der ZIP-Datei, die den Bugreportz enthält, im Falle eines Fehlers null zurückgeben.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Kehrt zurück
DeviceFoldableState

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

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

Kehrt zurück
int

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Ruft die IP-Adresse des Geräts ab.

Kehrt zurück
String die IP-Adresse des Geräts oder null , wenn das Gerät keine IP-Adresse hat

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

Gibt ein Objekt zurück, um den aktuellen Status des Keyguards abzurufen, oder null, wenn dies nicht unterstützt wird.

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

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.

getMainUserId

public abstract Integer getMainUserId ()

Gibt die Hauptbenutzer-ID zurück.

Kehrt zurück
Integer die Benutzer-ID des Hauptbenutzers, falls vorhanden, und null, wenn es keinen Hauptbenutzer gibt.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException wenn die Ausgabe des Geräts nicht wie erwartet ist.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Rufen Sie Informationen zu den auf dem Gerät installierten Hauptmodulen ab.

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

Erhalten Sie die maximale Anzahl unterstützter gleichzeitig laufender Benutzer. Der Standardwert ist 0.

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Erhalten Sie die maximale Anzahl unterstützter Benutzer. Der Standardwert ist 0.

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Rufen Sie die Testoptionen für das Gerät ab.

Kehrt zurück
TestDeviceOptions TestDeviceOptions , die sich auf das zu testende Gerät beziehen.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

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

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException wenn die Ausgabe des Geräts nicht wie erwartet ist.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

Erfasst einen Screenshot vom Gerät.

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

Erfasst einen Screenshot vom Gerät. Es wird empfohlen, stattdessen getScreenshot(String) mit JPEG-Kodierung 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.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

Erfasst einen Screenshot vom Gerät. Es wird empfohlen, stattdessen getScreenshot(format) mit JPEG-Kodierung 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.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

TODO: Erweitern Sie die oben genannten Implementierungen, um „Format“ und „Neuskalierung“ zu unterstützen.

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

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

Siehe getSetting(int, String, String) und wird für den Systembenutzer ausgeführt.

Parameter
namespace String

key String

Kehrt zurück
String

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract 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:Schlüssel eines Benutzers zugeordnet ist. Null, wenn nicht gefunden.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

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

Parameter
userId int

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

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

Kehrt zurück
die Liste der UserInfo-Objekte.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

Parameter
userId int

Kehrt zurück
int

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

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

Parameter
feature String : Welches Format sollte „feature:“ sein? " oder " " direkt.

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Installationspaket

public abstract 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 zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“.

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

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.

Installationspaket

public abstract 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 Gewährung von Laufzeitberechtigungen zur Installationszeit 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 zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“.

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

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.
UnsupportedOperationException wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

installPackageForUser

public abstract 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 Gewährung von Laufzeitberechtigungen zur Installationszeit 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 zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“.

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

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.
UnsupportedOperationException wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

installPackageForUser

public abstract 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 zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“.

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

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.

installPackages

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

Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien besteht (ein Haupt- und zusätzliche Split-Pakete). Unter „https://developer.android.com/studio/build/configure-apk-splits“ erfahren Sie, wie Sie eine APK in mehrere Dateien aufteilen.

Parameter
packageFiles : die lokalen APK-Dateien

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

extraArgs String : optionale zusätzliche Argumente zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“.

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

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.
UnsupportedOperationException wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

installPackages

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

Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht, die sich auf dem Android-Gerät befinden. Unter „https://developer.android.com/studio/build/configure-apk-splits“ erfahren Sie, wie Sie eine APK in mehrere Dateien aufteilen.

Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Gewährung von Laufzeitberechtigungen zur Installationszeit erfordern.

Parameter
packageFiles : die zu installierenden Remote-Apk-Dateipfade

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 zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“.

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

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.
UnsupportedOperationException wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

installPackagesForUser

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

Installieren Sie für einen bestimmten Benutzer eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht. Unter „https://developer.android.com/studio/build/configure-apk-splits“ erfahren Sie, wie Sie eine APK in mehrere Dateien aufteilen.

Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Gewährung von Laufzeitberechtigungen zur Installationszeit erfordern.

Parameter
packageFiles : die lokalen APK-Dateien

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 zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“.

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

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.
UnsupportedOperationException wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

installPackagesForUser

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

Installieren Sie für einen bestimmten Benutzer eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht. Unter „https://developer.android.com/studio/build/configure-apk-splits“ erfahren Sie, wie Sie eine APK in mehrere Dateien aufteilen.

Parameter
packageFiles : die lokalen APK-Dateien

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 zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“.

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

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.
UnsupportedOperationException wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

installRemotePackages

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

Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht, die sich auf dem Android-Gerät befinden. Unter „https://developer.android.com/studio/build/configure-apk-splits“ erfahren Sie, wie Sie eine APK in mehrere Dateien aufteilen.

Parameter
remoteApkPaths : die Remote-Apk-Dateipfade

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

extraArgs String : optionale zusätzliche Argumente zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“.

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

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.
UnsupportedOperationException wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

installRemotePackages

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

Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien (einem Haupt- und einem zusätzlichen Split-Paket) besteht, die sich auf dem Android-Gerät befinden. Unter „https://developer.android.com/studio/build/configure-apk-splits“ erfahren Sie, wie Sie eine APK in mehrere Dateien aufteilen.

Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Gewährung von Laufzeitberechtigungen zur Installationszeit erfordern.

Parameter
remoteApkPaths : die Remote-Apk-Dateipfade

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 zur Übergabe. Die verfügbaren Optionen finden Sie unter „adb shell pm -h“.

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

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.
UnsupportedOperationException wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Gibt zurück, ob das Gerät den Headless-System-Benutzermodus verwendet.

Kehrt zurück
boolean

Würfe
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

Kehrt zurück
boolean

Würfe
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Legt fest, ob Mehrbenutzer unterstützt werden.

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

Fragen Sie das Gerät nach einem bestimmten Paketnamen ab, um zu prü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.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Fragen Sie das Gerät nach einem bestimmten Paketnamen und einer bestimmten Benutzer-ID ab, um zu prü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 überprüfen, ob das Paket installiert ist. Wenn null, wird der primäre Benutzer Null verwendet.

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract 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 aktiv ist, false in allen anderen Fällen.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract 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 zweitrangig ist, andernfalls false.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

Überprüft, ob der angegebene Benutzer sichtbar ist.

Ein „sichtbarer“ Benutzer ist ein Benutzer, der mit dem „menschlichen“ Benutzer interagiert und daher in der Lage ist, Startaktivitäten zu starten (normalerweise in der Standardanzeige).

Parameter
userId int

Kehrt zurück
boolean

Würfe
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

Überprüft, ob der angegebene Benutzer in der angegebenen Anzeige sichtbar ist.

Ein „sichtbarer“ Benutzer ist ein Benutzer, der mit dem „menschlichen“ Benutzer interagiert und daher in der Lage ist, Startaktivitäten in dieser Anzeige zu starten.

Parameter
userId int

displayId int

Kehrt zurück
boolean

Würfe
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Gibt zurück, ob das Gerät das Starten von Benutzern im Hintergrund im ERROR(/java.android.view.Display#DEFAULT_DISPLAY) zulässt.

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

Kehrt zurück
boolean

Würfe
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

Gibt zurück, ob das Gerät das Starten von Benutzern im Hintergrund sichtbar zulässt.

Wenn dies der Fall ist, können Sie startVisibleBackgroundUser(int, int, boolean) aufrufen und eine von listDisplayIdsForStartingVisibleBackgroundUsers() zurückgegebene Anzeige übergeben.

Kehrt zurück
boolean

Würfe
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Testen Sie, ob WLAN aktiviert ist.

Überprüft, ob WLAN auf dem Gerät aktiviert ist. Nützlich, um den WLAN-Status vor Tests zu bestätigen, die nicht mit WLAN ausgeführt werden sollten, z. B. mobile Datentests.

Kehrt zurück
boolean true , wenn WLAN aktiviert ist. false , wenn deaktiviert

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.

listDisplayIds

public abstract  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.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

Ruft die Liste der Anzeigen ab, die zum start a user visible in the background verwendet werden können.

Kehrt zurück

Würfe
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

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

Kehrt zurück
die Liste der Benutzer-IDs.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Hilfsmethode, um einen Fehlerbericht aufzunehmen und ihn für die Reporter zu protokollieren.

Parameter
dataName String : Name, unter dem der Fehlerbericht gemeldet wird.

listener ITestLogger : ein ITestLogger zum Protokollieren des Fehlerberichts.

Kehrt zurück
boolean True, wenn die Protokollierung erfolgreich war, andernfalls false.

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registriert einen IDeviceActionReceiver für dieses Gerät.

Alle registrierten IDeviceActionReceiver werden benachrichtigt, bevor eine Geräteaktion beginnt und nachdem die Geräteaktion endet.

Parameter
deviceActionReceiver IDeviceActionReceiver : Ein IDeviceActionReceiver , der registriert wird.

RemoveAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

Entfernen Sie den angegebenen Geräteadministrator im angegebenen Benutzer und geben Sie true zurück, wenn es erfolgreich ist, 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.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

RemoveOwners

public abstract void removeOwners ()

Entfernen Sie mit größtmöglicher Mühe alle vorhandenen Geräteprofilbesitzer.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

RemoveUser

public abstract 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 es uns gelungen ist, den Benutzer zu entfernen, andernfalls false.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Legen Sie eine Geräteadministratorkomponente als Geräteeigentümer für einen bestimmten Benutzer fest.

Parameter
componentName String : Der Geräteadministrator soll Geräteeigentümer sein.

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

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

Siehe setSetting(int, String, String, String) und wird für den Systembenutzer ausgeführt.

Parameter
namespace String

key String

value String

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

public abstract 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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract 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.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract 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 kann ein zusätzliches Flag bereitgestellt werden, um darauf zu warten, dass der Vorgang 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.

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

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

Startet einen bestimmten Benutzer im Hintergrund, sichtbar in der angegebenen Anzeige (d. h. ermöglicht dem Benutzer, Aktivitäten in dieser Anzeige zu starten).

HINWEIS: Dieser Befehl prüft nicht, ob der Benutzer existiert, die Anzeige verfügbar ist, device supports such feature usw.

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

displayId int : Anzeige, auf der der Benutzer zu Beginn sichtbar ist

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

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

Würfe
DeviceNotAvailableException

stopUser

public abstract 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 der Vorgang wirksam wird, und das Beenden des Benutzers zu erzwingen. Aktueller und Systembenutzer können nicht gestoppt werden.

Parameter
userId int : des Benutzers, der angehalten werden soll.

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

forceFlag boolean : erzwingt das Stoppen des Benutzers.

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

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

Parameter
userId int : des Benutzers, der angehalten werden soll.

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Benutzer wechseln

public abstract boolean switchUser (int userId)

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

Parameter
userId int

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Benutzer wechseln

public abstract 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 der Benutzerwechsel fehlgeschlagen ist.

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

Würfe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

Nehmen Sie einen Bugreport und geben Sie ihn in ein Bugreport Objekt zurück, um ihn zu verarbeiten. Im Falle eines Problems null zurückgeben. Die im Bugreport-Objekt referenzierte Datei muss über Bugreport.close() bereinigt werden.

Kehrt zurück
Bugreport

uninstallPackage

public abstract 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.

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.

uninstallPackageForUser

public abstract 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.

Würfe
DeviceNotAvailableException wenn die Verbindung zum Gerät verloren geht und nicht wiederhergestellt werden kann.