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 Menge 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 Einhängepunkt

Öffentliche Methoden

abstract boolean canSwitchToHeadlessSystemUser ()

Gibt zurück, ob es erlaubt ist, zum kopflosen SYSTEM-Benutzer zu wechseln.

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 Geräte-UI angezeigt werden.

abstract void clearLastConnectedWifiNetwork ()

Löscht das zuletzt verbundene WLAN-Netzwerk.

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

Stellt eine Verbindung zu einem WLAN-Netzwerk her.

abstract boolean connectToWifiNetwork ( wifiSsidToPsk) connectToWifiNetwork ( wifiSsidToPsk)

Stellt eine Verbindung zu einem WLAN-Netzwerk her.

abstract boolean connectToWifiNetwork (String wifiSsid, String wifiPsk)

Stellt eine Verbindung zu einem WLAN-Netzwerk her.

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

Stellt eine Verbindung zu einem WLAN-Netzwerk her.

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

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

abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, String wifiPsk)

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

abstract int createUser (String name)

Erstellen Sie einen Benutzer mit einem bestimmten Namen und Standard-Flags 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 Standard-Flags 0.

abstract void deregisterDeviceActionReceiver ( IDeviceActionReceiver deviceActionReceiver)

Entfernt den registrierten IDeviceActionReceiver .

abstract void disableKeyguard ()

Versucht, die Tastensperre 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 eine Datei auf dem Gerät für einen bestimmten Benutzer vorhanden ist.

abstract File dumpHeap (String process, String devicePath)

Versuchen Sie, den Heap vom system_server auszugeben.

abstract boolean enableNetworkMonitor ()

Aktiviert die Netzwerküberwachung auf dem Gerät.

abstract getActiveApexes ()

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

abstract getAllSettings (String namespace)

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

abstract String getAndroidId (int userId)

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

abstract getAndroidIds ()

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

abstract PackageInfo getAppPackageInfo (String packageName)

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

abstract getAppPackageInfos ()

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

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 oder null zurück, wenn einige Probleme aufgetreten sind.

abstract int getCurrentUser ()

Gibt die ID des aktuell ausgeführten 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 ()

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

abstract Integer getMainUserId ()

Gibt die Hauptbenutzer-ID zurück.

abstract getMainlineModuleInfo ()

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

abstract int getMaxNumberOfRunningUsersSupported ()

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

abstract int getMaxNumberOfUsersSupported ()

Holen Sie sich 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 ()

Schnappt sich einen Screenshot vom Gerät.

abstract InputStreamSource getScreenshot (String format, boolean rescale)

Schnappt sich einen Screenshot vom Gerät.

abstract InputStreamSource getScreenshot (String format)

Schnappt sich einen Screenshot vom Gerät.

abstract InputStreamSource getScreenshot (long displayId)

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

abstract String getSetting (String namespace, String key)

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

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

Gibt den Wert der angeforderten Einstellung zurück.

abstract getUninstallablePackageNames ()

Rufen Sie die Anwendungspaketnamen 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 Seriennummer zurück, die der Benutzer-ID zugeordnet ist, 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 ein zusätzliches Split-Paket).

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 (ein Haupt- und ein zusätzliches 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 (ein Haupt- und ein zusätzliches 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 (ein Haupt- und ein zusätzliches 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 (ein Haupt- und ein zusätzliches 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 (ein Haupt- und ein zusätzliches Split-Paket) besteht, die sich auf dem Android-Gerät befinden.

abstract boolean isHeadlessSystemUserMode ()

Gibt zurück, ob das Gerät den kopflosen Systembenutzermodus verwendet.

abstract boolean isMainUserPermanentAdmin ()

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

abstract boolean isMultiUserSupported ()

Legt fest, ob mehrere Benutzer unterstützt werden.

abstract boolean isPackageInstalled (String packageName)

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

abstract boolean isPackageInstalled (String packageName, String userId)

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

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 erlaubt, dass Benutzer im Hintergrund im ERROR(/java.android.view.Display#DEFAULT_DISPLAY) sichtbar gestartet werden.

abstract boolean isVisibleBackgroundUsersSupported ()

Gibt zurück, ob das Gerät erlaubt, dass Benutzer im Hintergrund sichtbar gestartet werden.

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 verwendet werden können, um start a user visible in the background .

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 den Meldern zu melden.

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 dies erfolgreich war, andernfalls false .

abstract void removeOwners ()

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

abstract boolean removeUser (int userId)

Entfernen Sie einen bestimmten Benutzer vom Gerät.

abstract boolean setDeviceOwner (String componentName, int userId)

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

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

Siehe setSetting(int, String, String, String) und wird vom 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 gegebenen Benutzer im Hintergrund, sichtbar in der gegebenen Anzeige (dh erlaubt 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 Standardzeitlimit.

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 innerhalb eines Bugreport Objekts zurück, um ihn zu behandeln.

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 es erlaubt ist, zum kopflosen SYSTEM-Benutzer zu wechseln.

Kehrt zurück
boolean

Wirft
DeviceNotAvailableException

Konnektivität prüfen

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 eine funktionierende Netzwerkverbindung hat, ansonsten false .

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

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

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird 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 mit dem im vorherigen Test verwendeten WLAN-Netzwerk hergestellt wird.

ConnectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Stellt eine Verbindung zu einem WLAN-Netzwerk her.

Schaltet WLAN ein und blockiert, bis eine erfolgreiche Verbindung mit einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke hergestellt wurde. Sobald eine Verbindung hergestellt ist, versucht die Instanz, die Verbindung nach jedem Neustart 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 erfolgreich mit dem WLAN-Netzwerk verbunden. false sonst

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

ConnectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Stellt eine Verbindung zu einem WLAN-Netzwerk her.

Schaltet WLAN ein und blockiert, bis eine erfolgreiche Verbindung mit einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke hergestellt wurde. Sobald eine Verbindung hergestellt ist, versucht die Instanz, die Verbindung nach jedem Neustart 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 erfolgreich mit dem WLAN-Netzwerk verbunden. false sonst

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

ConnectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Stellt eine Verbindung zu einem WLAN-Netzwerk her.

Schaltet WLAN ein und blockiert, bis eine erfolgreiche Verbindung zum angegebenen WLAN-Netzwerk hergestellt wurde. Sobald eine Verbindung hergestellt ist, versucht die Instanz, die Verbindung nach jedem Neustart 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 erfolgreich mit dem WLAN-Netzwerk verbunden. false sonst

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

ConnectToWifiNetwork

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

Stellt eine Verbindung zu einem WLAN-Netzwerk her.

Schaltet WLAN ein und blockiert, bis eine erfolgreiche Verbindung zum angegebenen WLAN-Netzwerk hergestellt wurde. Sobald eine Verbindung hergestellt ist, versucht die Instanz, die Verbindung nach jedem Neustart 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 versteckten SSIDs für dieses Netzwerk gesucht werden soll.

Kehrt zurück
boolean true , wenn erfolgreich mit dem WLAN-Netzwerk verbunden. false sonst

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

ConnectToWifiNetworkIfNeeded

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

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

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

Kehrt zurück
boolean true , wenn erfolgreich mit dem WLAN-Netzwerk verbunden. false sonst

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

ConnectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

Kehrt zurück
boolean true , wenn erfolgreich mit dem WLAN-Netzwerk verbunden. false sonst

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Benutzer erstellen

public abstract int createUser (String name)

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

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

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

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Benutzer erstellen

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 : Aktivieren Sie das Benutzer-Flag --guest während der Erstellung

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

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

Kehrt zurück
int ID des erstellten Benutzers

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Benutzer erstellen

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 : Aktivieren Sie das Benutzer-Flag --guest während der Erstellung

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

Kehrt zurück
int ID des erstellten Benutzers

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

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

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

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

disableKeyguard

public abstract void disableKeyguard ()

Versucht, die Tastensperre zu deaktivieren.

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

Wirft
DeviceNotAvailableException

Netzwerkmonitor deaktivieren

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.

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

trennenVonWifi

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.

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

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

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

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

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

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

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

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

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getActiveApexes

public abstract  getActiveApexes ()

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

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

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

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

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

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

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

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

Parameter
userId int

Kehrt zurück
String

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

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

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

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

Parameter
packageName String

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

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

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

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Fehlerbericht abrufen

public abstract InputStreamSource getBugreport ()

Ruft einen Fehlerbericht vom Gerät ab.

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

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

Ruft einen Fehlerbericht vom Gerät ab. Fehlerbericht im Zip-Format enthält den Hauptfehlerbericht und andere Protokolldateien, die für die Fehlersuche nützlich sind.

Nur unterstützt für „adb-Version“ > 1.0.36

Kehrt zurück
InputStreamSource eine InputStreamSource der ZIP-Datei, die die Bugreportz enthält, gibt im Fehlerfall null zurück.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Kehrt zurück
DeviceFoldableState

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

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

Kehrt zurück
int

Wirft
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

Wirft
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) of ERROR(/String) Paketnamen, die derzeit auf dem Gerät installiert sind.

Wirft
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

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

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

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getMainUserId

public abstract Integer getMainUserId ()

Gibt die Hauptbenutzer-ID zurück.

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

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

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

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

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

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

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

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptionen

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 userId des primären Benutzers, falls vorhanden, und null, wenn es keinen primären Benutzer gibt.

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

Screenshot abrufen

public abstract InputStreamSource getScreenshot ()

Schnappt sich einen Screenshot vom Gerät.

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

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Screenshot abrufen

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

Parameter
format String : unterstütztes PNG, JPEG

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

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

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Screenshot abrufen

public abstract InputStreamSource getScreenshot (String format)

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

Parameter
format String : unterstütztes PNG, JPEG

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

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Screenshot abrufen

public abstract InputStreamSource getScreenshot (long displayId)

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

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

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

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

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

Parameter
namespace String

key String

Kehrt zurück
String

Wirft
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:key eines Benutzers zugeordnet ist. Null, wenn nicht gefunden.

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

Wirft
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 sind in der Klasse „android.content.pm.UserInfo“ im Android Open Source Project definiert.

Parameter
userId int

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

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Benutzerinfos abrufen

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.

Wirft
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

Parameter
userId int

Kehrt zurück
int

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hatFeature

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: " oder " " direkt.

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

Wirft
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, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen.

Kehrt zurück
String ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird 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 Erteilung von Laufzeitberechtigungen zum Zeitpunkt der Installation erfordern.

Parameter
packageFile File : die zu installierende apk-Datei

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

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

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

Kehrt zurück
String ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
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 Erteilung von Laufzeitberechtigungen zum Zeitpunkt der Installation erfordern.

Parameter
packageFile File : die zu installierende apk-Datei

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

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

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

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

Kehrt zurück
String ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
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, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen.

Kehrt zurück
String ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

Pakete installieren

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

Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien besteht (ein Haupt- und ein zusätzliches Split-Paket). Siehe "https://developer.android.com/studio/build/configure-apk-splits", um zu erfahren, wie man apk in mehrere Dateien aufteilt.

Parameter
packageFiles : die lokalen APK-Dateien

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

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

Kehrt zurück
String ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

Pakete installieren

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

Installieren Sie eine Android-Anwendung, die aus mehreren APK-Dateien (ein Haupt- und ein zusätzliches Split-Paket) besteht, die sich auf dem Android-Gerät befinden. Siehe "https://developer.android.com/studio/build/configure-apk-splits", um zu erfahren, wie man apk in mehrere Dateien aufteilt.

Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Erteilung von Laufzeitberechtigungen zum Zeitpunkt der Installation 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, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen.

Kehrt zurück
String ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
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 (ein Haupt- und ein zusätzliches Split-Paket) besteht. Siehe "https://developer.android.com/studio/build/configure-apk-splits", um zu erfahren, wie man apk in mehrere Dateien aufteilt.

Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Erteilung von Laufzeitberechtigungen zum Zeitpunkt der Installation 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, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen.

Kehrt zurück
String ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
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 (ein Haupt- und ein zusätzliches Split-Paket) besteht. Siehe "https://developer.android.com/studio/build/configure-apk-splits", um zu erfahren, wie man apk in mehrere Dateien aufteilt.

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, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen.

Kehrt zurück
String ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
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 (ein Haupt- und ein zusätzliches Split-Paket) besteht, die sich auf dem Android-Gerät befinden. Siehe "https://developer.android.com/studio/build/configure-apk-splits", um zu erfahren, wie man apk in mehrere Dateien aufteilt.

Parameter
remoteApkPaths : die Remote-APK-Dateipfade

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

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

Kehrt zurück
String ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
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 (ein Haupt- und ein zusätzliches Split-Paket) besteht, die sich auf dem Android-Gerät befinden. Siehe "https://developer.android.com/studio/build/configure-apk-splits", um zu erfahren, wie man apk in mehrere Dateien aufteilt.

Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, die eine explizite Steuerung der Erteilung von Laufzeitberechtigungen zum Zeitpunkt der Installation 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, die übergeben werden sollen. Siehe 'adb shell pm -h' für verfügbare Optionen.

Kehrt zurück
String ein ERROR(/String) mit einem Fehlercode oder null bei Erfolg.

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

istHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Gibt zurück, ob das Gerät den kopflosen Systembenutzermodus verwendet.

Kehrt zurück
boolean

Wirft
DeviceNotAvailableException

istMainUserPermanentAdmin

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

Wirft
DeviceNotAvailableException

wird von mehreren Benutzern unterstützt

public abstract boolean isMultiUserSupported ()

Legt fest, ob mehrere Benutzer unterstützt werden.

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

Wirft
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 überprüfen, ob es derzeit installiert ist oder nicht.

Parameter
packageName String

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

Wirft
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 überprüfen, ob es derzeit für diesen Benutzer installiert ist oder nicht.

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

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

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

Wirft
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 ausgeführt wird, false in allen anderen Fällen.

Wirft
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 sekundär ist, andernfalls false.

Wirft
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 (typischerweise in der Standardanzeige).

Parameter
userId int

Kehrt zurück
boolean

Wirft
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

Wirft
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Gibt zurück, ob das Gerät erlaubt, dass Benutzer im Hintergrund im ERROR(/java.android.view.Display#DEFAULT_DISPLAY) sichtbar gestartet werden.

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

Wirft
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

Gibt zurück, ob das Gerät erlaubt, dass Benutzer im Hintergrund sichtbar gestartet werden.

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

Wirft
DeviceNotAvailableException

istWifiEnabled

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 sollen, z. B. mobile Datentests.

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

Wirft
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird 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.

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Kehrt zurück

Wirft
DeviceNotAvailableException

listBenutzer

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.

Wirft
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logFehlerbericht

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Hilfsmethode, um einen Fehlerbericht aufzunehmen und ihn den Meldern zu melden.

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 s werden benachrichtigt, bevor eine Geräteaktion beginnt und nachdem die Geräteaktion endet.

Parameter
deviceActionReceiver IDeviceActionReceiver : Ein IDeviceActionReceiver , der registriert wird.

entfernenAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

Parameter
componentName String : des zu entfernenden Geräteadministrators.

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

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

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Eigentümer entfernen

public abstract void removeOwners ()

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

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Benutzer entfernen

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 wir den Benutzer erfolgreich entfernen konnten, andernfalls false.

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

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

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

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

Wirft
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 vom Systembenutzer ausgeführt.

Parameter
namespace String

key String

value String

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

Add a setting value to the namespace of a given user. Some settings will only be available after a reboot. namespace must be one of: {"system", "secure", "global"}

Parameter
userId int

namespace String

key String

value String

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP.

Parameter
userId int : of the user to start in the background

Kehrt zurück
boolean true if the user was successfully started in the background.

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Starts a given user in the background if it is currently stopped. If the user is already running in the background, this method is a NOOP. Possible to provide extra flag to wait for the operation to have effect.

Parameter
userId int : of the user to start in the background

waitFlag boolean : will make the command wait until user is started and unlocked.

Kehrt zurück
boolean true if the user was successfully started in the background.

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

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

Starts a given user in the background, visible in the given display (ie, allowing the user to launch activities in that display).

NOTE: this command doesn't check if the user exists, display is available, device supports such feature , etc.

Parameter
userId int : of the user to start in the background

displayId int : display to start user visible on

waitFlag boolean : will make the command wait until user is started and unlocked.

Kehrt zurück
boolean true if the user was successfully started visible in the background.

Wirft
DeviceNotAvailableException

stopUser

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

Stop a given user. Possible to provide extra flags to wait for the operation to have effect, and force terminate the user. Cannot stop current and system user.

Parameter
userId int : of the user to stop.

waitFlag boolean : will make the command wait until user is stopped.

forceFlag boolean : will force stop the user.

Kehrt zurück
boolean true if the user was successfully stopped.

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

Stops a given user. If the user is already stopped, this method is a NOOP. Cannot stop current and system user.

Parameter
userId int : of the user to stop.

Kehrt zurück
boolean true if the user was successfully stopped.

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

Switch to another userId with a default timeout. switchUser(int, long) .

Parameter
userId int

Kehrt zurück
boolean True if the new userId matches the userId provider. False otherwise.

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Switch to another userId with the provided timeout as deadline. Attempt to disable keyguard after user change is successful.

Parameter
userId int

timeout long : to wait before returning false for switch-user failed.

Kehrt zurück
boolean True if the new userId matches the userId provider. False otherwise.

Wirft
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

Take a bugreport and returns it inside a Bugreport object to handle it. Return null in case of issue. File referenced in the Bugreport object need to be cleaned via Bugreport.close() .

Kehrt zurück
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Uninstall an Android package from device.

Parameter
packageName String : the Android package to uninstall

Kehrt zurück
String a ERROR(/String) with an error code, or null if success.

Wirft
DeviceNotAvailableException if connection with device is lost and cannot be recovered.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Uninstall an Android package from device for a given user.

Parameter
packageName String : the Android package to uninstall

userId int : the integer user id to uninstall for.

Kehrt zurück
String a ERROR(/String) with an error code, or null if success.

Wirft
DeviceNotAvailableException if connection with device is lost and cannot be recovered.