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 einen konfigurierbaren Betrag und bietet eine Gerätewiederherstellung für Geräte, die nicht reagieren.

Zusammenfassung

Verschachtelte Klassen

class ITestDevice.ApexInfo

Einfache Strukturklasse zum Speichern von Informationen zu einem einzelnen APEX

class ITestDevice.MountPointInfo

Einfache Strukturklasse zum Speichern von Informationen zu einem einzelnen Bereitstellungspunkt

Öffentliche Methoden

abstract boolean canSwitchToHeadlessSystemUser()

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

abstract boolean checkConnectivity()

Prüfe, ob das Gerät eine Netzwerkverbindung hat.

abstract boolean clearErrorDialogs()

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

abstract void clearLastConnectedWifiNetwork()

Löscht das zuletzt verbundene WLAN.

abstract boolean connectToWifiNetwork( wifiSsidToPsk)

Stellt eine WLAN-Verbindung her.

abstract boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

Stellt eine WLAN-Verbindung her.

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

Stellt eine WLAN-Verbindung her.

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

Stellt eine WLAN-Verbindung her.

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

Eine Variante von connectToWifiNetwork(String, String), die nur verbunden wird, wenn Gerät verfügt derzeit über keine Netzwerkverbindung.

abstract boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

Eine Variante von connectToWifiNetwork(String, String), die nur verbunden wird, wenn Gerät verfügt derzeit über keine Netzwerkverbindung.

abstract int createUser(String name)

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

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

Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

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

Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

abstract int createUserNoThrow(String name)

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

abstract void deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Entfernt die registrierte IDeviceActionReceiver.

abstract void disableKeyguard()

Versucht, den Keyguard zu deaktivieren.

abstract boolean disableNetworkMonitor()

Deaktiviert die Netzwerküberwachung auf dem Gerät.

abstract boolean disconnectFromWifi()

Trennt die Verbindung zum WLAN.

abstract boolean doesFileExist(String deviceFilePath, int userId)

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

abstract File dumpHeap(String process, String devicePath)

Dump des Heaps vom system_server.

abstract boolean enableNetworkMonitor()

Aktiviert die Netzwerküberwachung auf dem Gerät.

abstract getActiveApexes()

Rufen Sie die Informationen zu den auf dem Gerät aktivierten APEXes ab.

abstract getAllSettings(String namespace)

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

abstract String getAndroidId(int userId)

Sucht nach der mit einer userId verknüpften Android-ID und gibt sie zurück. Wenn sie nicht gefunden wird, null.

abstract getAndroidIds()

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

abstract PackageInfo getAppPackageInfo(String packageName)

Informationen zu einem auf dem Gerät installierten Paket abrufen

abstract getAppPackageInfos()

Informationen zu Paketen abrufen, 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 Status des Geräts oder null zurück, wenn Probleme aufgetreten sind.

abstract int getCurrentUser()

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

abstract getFoldableStates()

Gibt die Liste der Status des faltbaren Geräts zurück.

abstract getInstalledPackageNames()

Rufen Sie die auf dem Gerät vorhandenen App-Paketnamen 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 Keyguard oder null abzurufen, wenn dies nicht unterstützt wird.

abstract Integer getMainUserId()

Gibt die Hauptnutzer-ID zurück.

abstract getMainlineModuleInfo()

Rufen Sie die Informationen zu den auf dem Gerät installierten Mainline-Modulen ab.

abstract int getMaxNumberOfRunningUsersSupported()

Holen Sie sich die maximale Anzahl von Nutzern, die gleichzeitig ausgeführt werden.

abstract int getMaxNumberOfUsersSupported()

Rufen Sie die maximale Anzahl der unterstützten Nutzer ab.

abstract TestDeviceOptions getOptions()

Rufe die Testoptionen für das Gerät ab.

abstract Integer getPrimaryUserId()

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

abstract InputStreamSource getScreenshot(String format, boolean rescale)

Erstellt einen Screenshot vom Gerät.

abstract InputStreamSource getScreenshot(String format)

Erstellt einen Screenshot vom Gerät.

abstract InputStreamSource getScreenshot(long displayId)

Erstellt einen Screenshot von der Geräteanzeige-ID.

abstract InputStreamSource getScreenshot()

Erstellt einen Screenshot vom Gerät.

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

Gibt den Wert der angeforderten Einstellung zurück.

abstract String getSetting(String namespace, String key)

Siehe getSetting(int, String, String) und wird bei einem Systemnutzer ausgeführt.

abstract getUninstallablePackageNames()

Rufen Sie die App-Paketnamen ab, die deinstalliert werden können.

abstract int getUserFlags(int userId)

Findet die Flags eines bestimmten Nutzers und gibt sie zurück.

abstract getUserInfos()

Ruft die Map of useId zu UserInfo auf dem Gerät ab.

abstract int getUserSerialNumber(int userId)

Gibt die Seriennummer zurück, die der userId zugeordnet ist, wenn sie gefunden wird; in allen anderen Fällen -10000.

abstract boolean hasFeature(String feature)

Prüfen, 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, int userId, String... extraArgs)

Ein Android-Paket für einen bestimmten Nutzer auf dem Gerät installieren

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

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

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

Installieren Sie eine Android-App, die aus mehreren APK-Dateien besteht (eines Hauptpakets und eines zusätzlichen aufgeteilten Pakets).

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

Android-App installieren, die aus mehreren APK-Dateien besteht (eines Hauptpakets und ein zusätzliches aufgeteiltes Paket) die auf dem Android-Gerät installiert sind.

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

Android-App installieren, die aus mehreren APK-Dateien besteht (eines Hauptpakets und ein zusätzliches aufgeteiltes Paket) für einen bestimmten Nutzer.

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

Android-App installieren, die aus mehreren APK-Dateien besteht (eines Hauptpakets und ein zusätzliches aufgeteiltes Paket) für einen bestimmten Nutzer.

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

Android-App installieren, die aus mehreren APK-Dateien besteht (eines Hauptpakets und ein zusätzliches aufgeteiltes Paket) die auf dem Android-Gerät installiert sind.

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

Android-App installieren, die aus mehreren APK-Dateien besteht (eines Hauptpakets und ein zusätzliches aufgeteiltes Paket) die auf dem Android-Gerät installiert sind.

abstract boolean isHeadlessSystemUserMode()

Gibt an, ob das Gerät den monitorlosen Systemnutzermodus verwendet.

abstract boolean isMainUserPermanentAdmin()

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

abstract boolean isMultiUserSupported()

Legt fest, ob mehrere Nutzer unterstützt werden.

abstract boolean isPackageInstalled(String packageName, String userId)

Fragen Sie das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID ab, um zu prüfen, ob es sich derzeit installiert haben oder nicht.

abstract boolean isPackageInstalled(String packageName)

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

abstract boolean isUserRunning(int userId)

Prüfen Sie, ob ein bestimmter Nutzer ausgeführt wird.

abstract boolean isUserSecondary(int userId)

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

abstract boolean isUserVisible(int userId)

Prüft, ob der angegebene Nutzer sichtbar ist.

abstract boolean isUserVisibleOnDisplay(int userId, int displayId)

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

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

Gibt an, ob auf dem Gerät Nutzer gestartet werden können, die im Hintergrund im ERROR(/java.android.view.Display#DEFAULT_DISPLAY) sichtbar sind.

abstract boolean isVisibleBackgroundUsersSupported()

Gibt an, ob auf dem Gerät Nutzer gestartet werden können, die im Hintergrund sichtbar sind.

abstract boolean isWifiEnabled()

Teste, ob WLAN aktiviert ist.

abstract listDisplayIds()

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

abstract listDisplayIdsForStartingVisibleBackgroundUsers()

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

abstract listUsers()

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

abstract boolean logBugreport(String dataName, ITestLogger listener)

Hilfsmethode, um einen Fehlerbericht zu erstellen und bei den Reportern zu protokollieren.

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

Benachrichtigen Sie das Gerät, dass es auf den Abschluss von Snapuser warten soll.

abstract void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Registriert eine IDeviceActionReceiver für dieses Gerät.

abstract boolean removeAdmin(String componentName, int userId)

Den angegebenen Geräteadministrator für den Nutzer entfernen und true zurückgeben, wenn der Vorgang erfolgreich war, andernfalls false.

abstract void removeOwners()

Entfernen Sie nach Möglichkeit alle vorhandenen Geräteprofileigentümer.

abstract boolean removeUser(int userId)

Einen bestimmten Nutzer vom Gerät entfernen

abstract boolean setDeviceOwner(String componentName, int userId)

Komponente zur Geräteverwaltung für einen bestimmten Nutzer als Geräteinhaber festlegen

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

Siehe setSetting(int, String, String, String) und wird bei einem Systemnutzer ausgeführt.

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

Fügt dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzu.

abstract boolean startUser(int userId)

Startet einen bestimmten Nutzer im Hintergrund, wenn er aktuell beendet ist.

abstract boolean startUser(int userId, boolean waitFlag)

Startet einen bestimmten Nutzer im Hintergrund, wenn er aktuell beendet ist.

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

Startet einen bestimmten Nutzer im Hintergrund, der auf dem jeweiligen Display sichtbar ist (d.h. der Nutzer kann um Aktivitäten in dieser Anzeige zu starten).

abstract boolean stopUser(int userId)

Stoppt einen bestimmten Nutzer.

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

Stoppen Sie einen bestimmten Nutzer.

abstract boolean switchUser(int userId)

Zu einer anderen Nutzer-ID mit Standardzeitlimit wechseln.

abstract boolean switchUser(int userId, long timeout)

Wechseln Sie zu einer anderen Nutzer-ID mit dem angegebenen Zeitlimit als Frist.

abstract Bugreport takeBugreport()

Erstellen Sie einen Fehlerbericht und geben Sie ihn in einem Bugreport-Objekt zurück, um ihn zu verarbeiten.

abstract String uninstallPackage(String packageName)

Android-Paket vom Gerät deinstallieren

abstract String uninstallPackageForUser(String packageName, int userId)

Android-Paket für einen bestimmten Nutzer vom Gerät deinstallieren

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Warten Sie gegebenenfalls, bis „snapuserd“ abgeschlossen ist.

Öffentliche Methoden

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

Returns
boolean

Ausgabe
DeviceNotAvailableException

Verbindung prüfen

public abstract boolean checkConnectivity ()

Prüfe, ob das Gerät eine Netzwerkverbindung hat.

Returns
boolean true, wenn das Gerät eine funktionierende Netzwerkverbindung hat, false.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

ClearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

Returns
boolean true, wenn keine Dialogfelder vorhanden waren oder Dialogfelder erfolgreich gelöscht wurden. Andernfalls false.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

ClearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Löscht das zuletzt verbundene WLAN. Sollte beim Start eines neuen Aufrufs aufgerufen werden um nach einem Neustart des Geräts keine Verbindung zum WLAN herzustellen, das im vorherigen Test verwendet wurde.

mit Wifi-Netzwerk verbinden

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Stellt eine WLAN-Verbindung her.

Das WLAN wird aktiviert und blockiert, bis eine Verbindung zu einem WLAN hergestellt wurde. Netzwerken aus der wifiSsidToPsk-Karte. Sobald eine Verbindung hergestellt ist, versucht die Instanz, Stellen Sie die Verbindung nach jedem Neustart bis ITestDevice#disconnectFromWifi() wieder her oder ITestDevice#clearLastConnectedWifiNetwork() wird aufgerufen.

Parameter
wifiSsidToPsk : Eine Zuordnung der WLAN-SSIDs zu Passwörtern.
Returns
boolean true, wenn eine Verbindung mit dem WLAN hergestellt wurde. false sonst
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

mit Wifi-Netzwerk verbinden

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Stellt eine WLAN-Verbindung her.

Das WLAN wird aktiviert und blockiert, bis eine Verbindung zu einem WLAN hergestellt wurde. Netzwerken aus der wifiSsidToPsk-Karte. Sobald eine Verbindung hergestellt ist, versucht die Instanz, Stellen Sie die Verbindung nach jedem Neustart bis ITestDevice#disconnectFromWifi() wieder her oder ITestDevice#clearLastConnectedWifiNetwork() wird aufgerufen.

Parameter
wifiSsidToPsk : Eine Zuordnung der WLAN-SSIDs zu Passwörtern.
scanSsid boolean: Gibt an, ob für dieses Netzwerk nach verborgenen SSIDs gesucht werden soll.
Returns
boolean true, wenn eine Verbindung mit dem WLAN hergestellt wurde. false sonst
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

mit Wifi-Netzwerk verbinden

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Stellt eine WLAN-Verbindung her.

Aktiviert das WLAN und blockiert, bis eine Verbindung zum angegebenen WLAN hergestellt wurde. Nachdem eine Verbindung hergestellt wurde, versucht die Instanz, die Verbindung nach jedem Neustart wiederherzustellen bis ITestDevice#disconnectFromWifi() oder ITestDevice#clearLastConnectedWifiNetwork() wird aufgerufen.

Parameter
wifiSsid String: das WLAN-Signal, mit dem eine Verbindung hergestellt werden soll
wifiPsk String: PSK-Passphrase oder null, falls unverschlüsselt
Returns
boolean true, wenn eine Verbindung mit dem WLAN hergestellt wurde. false sonst
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

mit Wifi-Netzwerk verbinden

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

Stellt eine WLAN-Verbindung her.

Aktiviert das WLAN und blockiert, bis eine Verbindung zum angegebenen WLAN hergestellt wurde. Nachdem eine Verbindung hergestellt wurde, versucht die Instanz, die Verbindung nach jedem Neustart wiederherzustellen bis ITestDevice#disconnectFromWifi() oder ITestDevice#clearLastConnectedWifiNetwork() wird aufgerufen.

Parameter
wifiSsid String: das WLAN-Signal, mit dem eine Verbindung hergestellt werden soll
wifiPsk String: PSK-Passphrase oder null, falls unverschlüsselt
scanSsid boolean: Gibt an, ob für dieses Netzwerk nach versteckter SSID gesucht werden soll.
Returns
boolean true, wenn eine Verbindung mit dem WLAN hergestellt wurde. false sonst
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

Verbindung mit WLAN-Netzwerk herstellen (falls erforderlich)

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

Eine Variante von connectToWifiNetwork(String, String), die nur verbunden wird, wenn Gerät verfügt derzeit über keine Netzwerkverbindung.

Parameter
scanSsid boolean: ob für dieses Netzwerk nach versteckter SSID gesucht werden soll
Returns
boolean true, wenn eine Verbindung mit dem WLAN hergestellt wurde. false sonst
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Verbindung mit WLAN-Netzwerk herstellen (falls erforderlich)

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Eine Variante von connectToWifiNetwork(String, String), die nur verbunden wird, wenn Gerät verfügt derzeit über keine Netzwerkverbindung.

Returns
boolean true, wenn eine Verbindung mit dem WLAN hergestellt wurde. false sonst
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Nutzer erstellen

public abstract int createUser (String name)

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

Parameter
name String: des Nutzers, der auf dem Gerät erstellt werden soll
Returns
int Ganzzahl für die erstellte User-ID
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Nutzer erstellen

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

Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

Parameter
name String: des Nutzers, der auf dem Gerät erstellt werden soll
guest boolean: aktiviert das Nutzer-Flag --guest während der Erstellung.
ephemeral boolean: aktiviert das Nutzer-Flag „--sitzungsspezifisch“ beim Erstellen
Returns
int ID des erstellten Nutzers
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Nutzer erstellen

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

Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

Parameter
name String: des Nutzers, der auf dem Gerät erstellt werden soll
guest boolean: aktiviert das Nutzer-Flag --guest während der Erstellung.
ephemeral boolean: aktiviert das Nutzer-Flag „--sitzungsspezifisch“ beim Erstellen
forTesting boolean: aktiviert das Test-Flag „--for-testing“ beim Erstellen
Returns
int ID des erstellten Nutzers
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

Parameter
name String: des Nutzers, der auf dem Gerät erstellt werden soll
Returns
int Ganzzahl für die erstellte User-ID oder -1 für Fehler.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

RegistrierungDeviceActionReceiver abmelden

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Entfernt die registrierte IDeviceActionReceiver.

Parameter
deviceActionReceiver IDeviceActionReceiver: Eine IDeviceActionReceiver, die entfernt wird.

Keyguard deaktivieren

public abstract void disableKeyguard ()

Versucht, den Keyguard zu deaktivieren.

Warten Sie zuerst, bis die Eingabe-Weiterleitung bereit ist. Dies geschieht ungefähr zur gleichen Zeit, Gerät meldet BOOT_COMPLETE, offenbar asynchron, da das aktuelle Framework -Implementierung eine gelegentliche Race-Bedingung aufweist. Anschließend wird der Befehl zum Schließen von Keyguard gesendet (funktioniert nur für nicht sichere)

Ausgabe
DeviceNotAvailableException

Netzwerkmonitor deaktivieren

public abstract boolean disableNetworkMonitor ()

Deaktiviert die Netzwerküberwachung auf dem Gerät.

Returns
boolean true, wenn das Monitoring erfolgreich deaktiviert wurde. false falls er fehlgeschlagen ist.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

VonWLAN trennen

public abstract boolean disconnectFromWifi ()

Trennt die Verbindung zum WLAN.

Entfernt alle Netzwerke aus der Liste der bekannten Netzwerke und deaktiviert das WLAN.

Returns
boolean true, wenn die Verbindung zum WLAN erfolgreich getrennt wurde. false wenn die Verbindung nicht getrennt werden konnte.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

tutFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

Parameter
deviceFilePath String: der absolute Pfad der zu prüfenden Datei auf dem Gerät
userId int: Die Nutzer-ID, anhand derer die Existenz der Datei geprüft werden soll.
Returns
boolean true, wenn die Datei vorhanden ist, andernfalls false.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

DumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

Dump des Heaps vom system_server. Es liegt in der Verantwortung des Anrufers, aus der dumpdatei.

Parameter
process String: der Name des Geräteprozesses, für den Dumpheap durchgeführt werden soll.
devicePath String: Pfad auf dem Gerät, in dem der Dump gespeichert wird Dabei muss es sich um einen Ort handeln, an dem erlauben.
Returns
File Die ERROR(/File), die den Bericht enthält. Null, wenn ein Fehler aufgetreten ist.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

EnableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Aktiviert die Netzwerküberwachung auf dem Gerät.

Returns
boolean true, wenn das Monitoring erfolgreich aktiviert wurde. false falls er fehlgeschlagen ist.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

getActiveApexes

public abstract  getActiveApexes ()

Rufen Sie die Informationen zu den auf dem Gerät aktivierten APEXes ab.

Returns
Derzeit sind ERROR(/Set) von ApexInfo auf dem Gerät aktiviert
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Einstellungen abrufen

public abstract  getAllSettings (String namespace)

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

Parameter
namespace String: muss einer dieser Werte sein: {"system", "secure", "global"}
Returns
der Schlüssel/Wert-Paare. Null, wenn der Namespace nicht unterstützt wird.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId (GetAndroid-ID)

public abstract String getAndroidId (int userId)

Sucht nach der mit einer userId verknüpften Android-ID und gibt sie zurück. Wenn sie nicht gefunden wird, null.

Parameter
userId int

Returns
String

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds (Abrufen von Android-IDs)

public abstract  getAndroidIds ()

Erstellen Sie eine Karte mit Android-IDs, die mit Nutzer-IDs übereinstimmen. Es gibt keine Versicherung, dass jeder Nutzer id sucht eine Android-ID, die mit dieser Funktion verknüpft ist, sodass einige Nutzer-IDs mit null übereinstimmen können.

Returns
Karte mit Android-IDs, die mit Nutzer-IDs übereinstimmen.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

Informationen zu einem auf dem Gerät installierten Paket abrufen

Parameter
packageName String

Returns
PackageInfo PackageInfo oder null, wenn Informationen nicht abgerufen werden konnten
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos (App-Paketinformationen abrufen)

public abstract  getAppPackageInfos ()

Informationen zu Paketen abrufen, die auf dem Gerät installiert sind

Returns
ERROR(/List) von PackageInfo s auf dem Gerät installiert.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

Ruft einen Fehlerbericht vom Gerät ab.

Die Implementierung funktioniert auf Geräten ohne SD-Karte garantiert weiterhin (oder wo die SD-Karte noch nicht bereitgestellt ist).

Returns
InputStreamSource Ein InputStreamSource, das bei Bedarf den Inhalt des Fehlerberichts generiert. In Fehler auftreten, erzeugt InputStreamSource ein leeres ERROR(/InputStream).

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

Nur unterstützt für „adb version“ > 1.0.36

Returns
InputStreamSource ein InputStreamSource der ZIP-Datei mit den Fehlerbericht, gibt null zurück in Fehler.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Returns
DeviceFoldableState

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

Gibt die ID des aktuell ausgeführten Nutzers zurück. Geben Sie im Fall eines Fehlers -10000 zurück.

Returns
int

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

Gibt die Liste der Status des faltbaren Geräts zurück. Kann mit „cmd device_state“ abgerufen werden print-states".

Returns
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

GetInstalldPackageNames

public abstract  getInstalledPackageNames ()

Rufen Sie die auf dem Gerät vorhandenen App-Paketnamen ab.

Returns
ERROR(/Set) von String Paketnamen, die momentan auf dem Gerät installiert sind.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Ruft die IP-Adresse des Geräts ab.

Returns
String Die IP-Adresse des Geräts oder null, wenn das Gerät keine IP-Adresse hat
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

Returns
KeyguardControllerState KeyguardControllerState mit einem Snapshot des Status des Keyguard und gibt Null zurück, wenn die Keyguard-Abfrage nicht unterstützt wird.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

getMainUserId

public abstract Integer getMainUserId ()

Gibt die Hauptnutzer-ID zurück.

Returns
Integer Die userId des Hauptnutzers, falls vorhanden, und null, wenn es keinen Hauptnutzer gibt
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException wenn die Ausgabe des Geräts nicht wie erwartet ist.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Rufen Sie die Informationen zu den auf dem Gerät installierten Mainline-Modulen ab.

Returns
Derzeit sind ERROR(/Set) von String Mainline-Modulen auf dem Gerät installiert.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

Holen Sie sich die maximale Anzahl von Nutzern, die gleichzeitig ausgeführt werden. Die Standardeinstellung ist 0.

Returns
int Eine Ganzzahl, die die Anzahl der gleichzeitig aktiven Nutzer angibt
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersUnterstützt

public abstract int getMaxNumberOfUsersSupported ()

Rufen Sie die maximale Anzahl der unterstützten Nutzer ab. Die Standardeinstellung ist 0.

Returns
int Eine Ganzzahl, die die Anzahl der unterstützten Nutzer angibt
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

Rufe die Testoptionen für das Gerät ab.

Returns
TestDeviceOptions TestDeviceOptions bezieht sich auf das zu testende Gerät.

getPrimaryUserId (Primäre Nutzer-ID)

public abstract Integer getPrimaryUserId ()

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

Returns
Integer Die userId des primären Nutzers (falls vorhanden) und null, wenn kein Primärnutzer vorhanden ist
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException wenn die Ausgabe des Geräts nicht wie erwartet ist.
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

Parameter
format String: unterstützte PNG- und JPEG-Dateien
rescale boolean: ob der Screenshot neu skaliert werden soll, um die Größe des resultierenden Bildes zu verringern
Returns
InputStreamSource InputStreamSource des Screenshots im Format oder null, wenn der Screenshot konnte nicht erstellt werden.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

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

Parameter
format String: unterstützte PNG- und JPEG-Dateien
Returns
InputStreamSource InputStreamSource des Screenshots im Format oder null, wenn Der Screenshot war nicht erfolgreich.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

Erstellt einen Screenshot von der Geräteanzeige-ID. Das Format ist PNG.

TODO: Implementierungen oben so erweitern, dass "format" unterstützt wird und „Neu skalieren“

Parameter
displayId long: die Anzeige-ID des Bildschirms, von dem ein Screenshot erstellt werden soll.
Returns
InputStreamSource InputStreamSource des Screenshots im Format oder null, wenn der Screenshot konnte nicht erstellt werden.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

Erstellt einen Screenshot vom Gerät.

Returns
InputStreamSource InputStreamSource des Screenshots im PNG-Format oder null, wenn Der Screenshot war nicht erfolgreich.
Ausgabe
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 einen der folgenden Werte haben: {"system", "secure", "global"}

Parameter
userId int

namespace String

key String

Returns
String Wert, der mit „namespace:key“ eines Nutzers verknüpft ist. Null, wenn nicht gefunden.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

Siehe getSetting(int, String, String) und wird für einen Systemnutzer ausgeführt.

Parameter
namespace String

key String

Returns
String

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

Rufen Sie die App-Paketnamen ab, die deinstalliert werden können. Dies ist derzeit definiert als nicht systemunabhängige Pakete und aktualisierte Systempakete.

Returns
ERROR(/Set) der deinstallierten String-Paketnamen sind derzeit auf dem .
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

Findet die Flags eines bestimmten Nutzers und gibt sie zurück. Flags sind in „android.content.pm.UserInfo“ definiert im Android Open Source Project.

Parameter
userId int

Returns
int Die Flags, die mit der angegebenen Nutzer-ID verknüpft sind, falls gefunden, andernfalls „-10000“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos (Nutzerinformationen abrufen)

public abstract  getUserInfos ()

Ruft die Map of useId zu UserInfo auf dem Gerät ab. DeviceRuntimeException wird ausgegeben, wenn die Ausgabe vom Gerät nicht wie erwartet ist.

Returns
Die Liste der UserInfo-Objekte.
Ausgabe
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 userId zugeordnet ist, wenn sie gefunden wird; in allen anderen Fällen -10000.

Parameter
userId int

Returns
int

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

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

Parameter
feature String: das Format, das „feature:“ sein sollte oder "" .
Returns
boolean "True", wenn das Feature gefunden wird, andernfalls "False".
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

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.
Returns
String einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

installPackage

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

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

Hinweis: Nur Anwendungsfälle, die eine ausdrückliche Kontrolle über die Gewährung von Laufzeitberechtigungen erfordern sollte diese Funktion aufgerufen werden.

Parameter
packageFile File: die zu installierende APK-Datei
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions boolean: wenn bei der Installation alle Laufzeitberechtigungen gewährt werden sollen
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Siehe "adb shell pm -h" für verfügbare Optionen.
Returns
String einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.
UnsupportedOperationException Laufzeitberechtigung wird von der Plattform nicht unterstützt auf dem Gerät.

installPackageForUser

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

Ein Android-Paket für einen bestimmten Nutzer auf dem Gerät installieren

Parameter
packageFile File: die zu installierende APK-Datei
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
userId int: die ganzzahlige Nutzer-ID, für die die Installation durchgeführt werden soll.
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Siehe "adb shell pm -h" für verfügbare Optionen.
Returns
String einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

installPackageForUser

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

Ein Android-Paket für einen bestimmten Nutzer auf dem Gerät installieren

Hinweis: Nur Anwendungsfälle, die eine ausdrückliche Kontrolle über die Gewährung von Laufzeitberechtigungen erfordern sollte diese Funktion aufgerufen werden.

Parameter
packageFile File: die zu installierende APK-Datei
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions boolean: wenn bei der Installation alle Laufzeitberechtigungen gewährt werden sollen
userId int: die ganzzahlige Nutzer-ID, für die die Installation durchgeführt werden soll.
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Siehe "adb shell pm -h" für verfügbare Optionen.
Returns
String einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.
UnsupportedOperationException Laufzeitberechtigung wird von der Plattform nicht unterstützt auf dem Gerät.

installPackages

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

Installieren Sie eine Android-App, die aus mehreren APK-Dateien besteht (eines Hauptpakets und eines zusätzlichen aufgeteilten Pakets). Siehe https://developer.android.com/studio/build/configure-apk-splits wie Sie die APK-Datei mehrere Dateien gleichzeitig.

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.
Returns
String einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.
UnsupportedOperationException Laufzeitberechtigung wird von der Plattform nicht unterstützt auf dem Gerät.

installPackages

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

Android-App installieren, die aus mehreren APK-Dateien besteht (eines Hauptpakets und ein zusätzliches aufgeteiltes Paket) die auf dem Android-Gerät installiert sind. Weitere Informationen finden Sie unter „https://developer.android.com/studio/build/configure-apk-splits“ wie Sie die APK-Datei mehrere Dateien gleichzeitig.

Hinweis: Nur Anwendungsfälle, die eine ausdrückliche Kontrolle über die Gewährung von Laufzeitberechtigungen erfordern sollte diese Funktion aufgerufen werden.

Parameter
packageFiles : die zu installierenden Remote-APK-Dateipfade
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions boolean: wenn bei der Installation alle Laufzeitberechtigungen gewährt werden sollen
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Siehe "adb shell pm -h" für verfügbare Optionen.
Returns
String einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.
UnsupportedOperationException Laufzeitberechtigung wird von der Plattform nicht unterstützt auf dem Gerät.

installPackagesForUser

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

Android-App installieren, die aus mehreren APK-Dateien besteht (eines Hauptpakets und ein zusätzliches aufgeteiltes Paket) für einen bestimmten Nutzer. Siehe https://developer.android.com/studio/build/configure-apk-splits am wie Sie eine APK-Datei auf mehrere Dateien aufteilen.

Parameter
packageFiles : die lokalen APK-Dateien
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
userId int: die ganzzahlige Nutzer-ID, für die die Installation durchgeführt werden soll.
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Siehe "adb shell pm -h" für verfügbare Optionen.
Returns
String einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.
UnsupportedOperationException Laufzeitberechtigung wird von der Plattform nicht unterstützt auf dem Gerät.

installPackagesForUser

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

Android-App installieren, die aus mehreren APK-Dateien besteht (eines Hauptpakets und ein zusätzliches aufgeteiltes Paket) für einen bestimmten Nutzer. Siehe https://developer.android.com/studio/build/configure-apk-splits am wie Sie eine APK-Datei auf mehrere Dateien aufteilen.

Hinweis: Nur Anwendungsfälle, die eine ausdrückliche Kontrolle über die Gewährung von Laufzeitberechtigungen erfordern sollte diese Funktion aufgerufen werden.

Parameter
packageFiles : die lokalen APK-Dateien
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions boolean: wenn bei der Installation alle Laufzeitberechtigungen gewährt werden sollen
userId int: die ganzzahlige Nutzer-ID, für die die Installation durchgeführt werden soll.
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Siehe "adb shell pm -h" für verfügbare Optionen.
Returns
String einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.
UnsupportedOperationException Laufzeitberechtigung wird von der Plattform nicht unterstützt auf dem Gerät.

installRemotePackages

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

Android-App installieren, die aus mehreren APK-Dateien besteht (eines Hauptpakets und ein zusätzliches aufgeteiltes Paket) die auf dem Android-Gerät installiert sind. Weitere Informationen finden Sie unter „https://developer.android.com/studio/build/configure-apk-splits“ wie Sie die APK-Datei mehrere Dateien gleichzeitig.

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.
Returns
String einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.
UnsupportedOperationException Laufzeitberechtigung wird von der Plattform nicht unterstützt auf dem Gerät.

installRemotePackages

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

Android-App installieren, die aus mehreren APK-Dateien besteht (eines Hauptpakets und ein zusätzliches aufgeteiltes Paket) die auf dem Android-Gerät installiert sind. Weitere Informationen finden Sie unter „https://developer.android.com/studio/build/configure-apk-splits“ wie Sie die APK-Datei mehrere Dateien gleichzeitig.

Hinweis: Nur Anwendungsfälle, die eine ausdrückliche Kontrolle über die Gewährung von Laufzeitberechtigungen erfordern sollte diese Funktion aufgerufen werden.

Parameter
remoteApkPaths : die Remote-APK-Dateipfade
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions boolean: wenn bei der Installation alle Laufzeitberechtigungen gewährt werden sollen
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Siehe "adb shell pm -h" für verfügbare Optionen.
Returns
String einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.
UnsupportedOperationException Laufzeitberechtigung wird von der Plattform nicht unterstützt auf dem Gerät.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Gibt an, ob das Gerät den monitorlosen Systemnutzermodus verwendet.

Returns
boolean

Ausgabe
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

Returns
boolean

Ausgabe
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Legt fest, ob mehrere Nutzer unterstützt werden.

Returns
boolean „true“, wenn mehrere Nutzer unterstützt werden, andernfalls „false“
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalliert

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Fragen Sie das Gerät nach einem bestimmten Paketnamen und Nutzer-ID ab, um zu prüfen, ob es sich derzeit ob der jeweilige Nutzer installiert ist oder nicht.

Parameter
packageName String: Das Paket, das geprüft wird, ob es installiert ist.
userId String: Die Nutzer-ID, auf die geprüft wird, ob das Paket installiert ist. Wenn null, ist der primäre Nutzer 0 verwendet.
Returns
boolean „True“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalliert

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.

Parameter
packageName String

Returns
boolean „True“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

Prüfen Sie, ob ein bestimmter Nutzer ausgeführt wird.

Parameter
userId int

Returns
boolean "True", wenn der Nutzer ausgeführt wird, "False" in allen anderen Fällen.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

istUserSekundär

public abstract boolean isUserSecondary (int userId)

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

Parameter
userId int

Returns
boolean "true", wenn der Nutzer ein sekundärer Nutzer ist, andernfalls "false".
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

Prüft, ob der angegebene Nutzer sichtbar ist.

Ein „sichtbares“ Nutzende sind Nutzende, die mit dem „Menschen“ interagieren, Nutzende und ist daher in der Lage, Startaktivitäten starten (normalerweise in der Standardanzeige)

Parameter
userId int

Returns
boolean

Ausgabe
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

Ein „sichtbares“ Nutzende sind Nutzende, die mit dem „Menschen“ interagieren, Nutzende und ist daher in der Lage, Markteinführungsaktivitäten in dieser Anzeige.

Parameter
userId int

displayId int

Returns
boolean

Ausgabe
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Gibt an, ob auf dem Gerät Nutzer gestartet werden können, die im Hintergrund im ERROR(/java.android.view.Display#DEFAULT_DISPLAY) sichtbar sind.

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

Returns
boolean

Ausgabe
DeviceNotAvailableException

IsVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

Gibt an, ob auf dem Gerät Nutzer im Hintergrund sichtbar gemacht werden können.

Ist dies der Fall, können Sie startVisibleBackgroundUser(int, int, boolean) aufrufen und dabei Folgendes übergeben: Eine von listDisplayIdsForStartingVisibleBackgroundUsers() zurückgegebene Anzeige.

Returns
boolean

Ausgabe
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Teste, ob WLAN aktiviert ist.

Prüft, ob auf dem Gerät WLAN aktiviert ist. Nützlich, um den WLAN-Status vor Tests zu bestätigen, sollte nicht über WLAN laufen, z.B. Tests für mobile Daten.

Returns
boolean true, wenn WLAN aktiviert ist. false, wenn deaktiviert
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

listDisplayIds

public abstract  listDisplayIds ()

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

Returns
Die Liste der Bildschirme. Die Standardeinstellung gibt immer die Standardanzeige 0 zurück.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Returns
Ausgabe
DeviceNotAvailableException

Nutzer auflisten

public abstract  listUsers ()

Ruft die Liste der Nutzer auf dem Gerät ab. Gibt bei Ausgabe DeviceRuntimeException aus vom Gerät nicht wie erwartet ist.

Returns
die Liste der Nutzer-IDs.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

Hilfsmethode, um einen Fehlerbericht zu erstellen und bei den Reportern zu protokollieren.

Parameter
dataName String ist der Name, unter dem der Fehlerbericht gemeldet wird.
listener ITestLogger: Ein ITestLogger zum Protokollieren des Fehlerberichts.
Returns
boolean Der Wert ist "True", wenn das Logging erfolgreich war, andernfalls "False".

BenachrichtigenSnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Benachrichtigen Sie das Gerät, dass es auf den Abschluss von Snapuser warten soll.

Parameter
waitPhase SnapuserdWaitPhase

RegisterDeviceActionReceiver 

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registriert eine IDeviceActionReceiver für dieses Gerät.

Alle registrierten IDeviceActionReceivers werden vor einer Geräteaktion benachrichtigt und nachdem die Geräteaktion beendet wurde.

Parameter
deviceActionReceiver IDeviceActionReceiver: Eine IDeviceActionReceiver, die registriert wird.

Admin entfernen

public abstract boolean removeAdmin (String componentName, 
                int userId)

Den angegebenen Geräteadministrator für den Nutzer entfernen und true zurückgeben, wenn der Vorgang erfolgreich war, andernfalls false.

Parameter
componentName String: des Geräteadministrators, der entfernt werden soll
userId int: des Nutzers, in dem der Geräteadministrator lebt.
Returns
boolean „True“, wenn der Vorgang erfolgreich ist, andernfalls „False“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Inhaber entfernen

public abstract void removeOwners ()

Entfernen Sie nach Möglichkeit alle vorhandenen Geräteprofileigentümer.

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Nutzer entfernen

public abstract boolean removeUser (int userId)

Einen bestimmten Nutzer vom Gerät entfernen

Parameter
userId int: des zu entfernenden Nutzers
Returns
boolean true , wenn der Nutzer erfolgreich entfernt wurde, andernfalls false.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Geräteinhaber festlegen

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Komponente zur Geräteverwaltung für einen bestimmten Nutzer als Geräteinhaber festlegen

Parameter
componentName String: des Geräteadministrators wird der Geräteeigentümer sein.
userId int: des Nutzers, in dem der Geräteeigentümer wohnt.
Returns
boolean „True“, wenn der Vorgang erfolgreich ist, andernfalls „False“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Einstellung festlegen

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

Siehe setSetting(int, String, String, String) und wird für einen Systemnutzer ausgeführt.

Parameter
namespace String

key String

value String

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Einstellung festlegen

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

Fügt dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzu. Einige Einstellungen sind nur verfügbar nach einem Neustart wieder. Namespace muss einen der folgenden Werte haben: {"system", "secure", "global"}

Parameter
userId int

namespace String

key String

value String

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser (Startnutzer)

public abstract boolean startUser (int userId)

Startet einen bestimmten Nutzer im Hintergrund, wenn er aktuell beendet ist. Wenn der Nutzer bereits im Hintergrund ausgeführt wird, ist diese Methode eine NOOP-Methode.

Parameter
userId int: des Nutzers, der im Hintergrund gestartet werden soll
Returns
boolean true, wenn der Nutzer im Hintergrund gestartet wurde.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser (Startnutzer)

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Startet einen bestimmten Nutzer im Hintergrund, wenn er aktuell beendet ist. Wenn der Nutzer bereits im Hintergrund ausgeführt wird, ist diese Methode eine NOOP-Methode. Es kann ein zusätzliches Flag zur Verfügung gestellt werden, auf das gewartet werden soll. damit der Vorgang wirksam wird.

Parameter
userId int: des Nutzers, der im Hintergrund gestartet werden soll
waitFlag boolean: Der Befehl wartet, bis der Nutzer gestartet und entsperrt wird.
Returns
boolean true, wenn der Nutzer im Hintergrund gestartet wurde.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

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

Startet einen bestimmten Nutzer im Hintergrund, der auf dem jeweiligen Display sichtbar ist (d.h. der Nutzer kann um Aktivitäten in dieser Anzeige zu starten).

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

Parameter
userId int: des Nutzers, der im Hintergrund gestartet werden soll
displayId int: Anzeige zum Starten des Nutzers sichtbar auf
waitFlag boolean: Der Befehl wartet, bis der Nutzer gestartet und entsperrt wird.
Returns
boolean true, wenn der Nutzer erfolgreich gestartet wurde und im Hintergrund sichtbar ist.
Ausgabe
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

Stoppt einen bestimmten Nutzer. Wenn der Nutzer bereits gestoppt wurde, ist diese Methode eine NOOP-Methode. Aktuellen Nutzer und Systemnutzer können nicht beendet werden.

Parameter
userId int: des Nutzers, der beendet werden soll.
Returns
boolean true, wenn der Nutzer erfolgreich beendet wurde.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

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

Stoppen Sie einen bestimmten Nutzer. Es können zusätzliche Flags bereitgestellt werden, die warten, bis der Vorgang wirksam wird. und die Beendigung des Nutzers zu erzwingen. Aktuellen Nutzer und Systemnutzer können nicht beendet werden.

Parameter
userId int: des Nutzers, der beendet werden soll.
waitFlag boolean: Der Befehl wartet, bis der Nutzer gestoppt wird.
forceFlag boolean: erzwingt das Beenden des Nutzers.
Returns
boolean true, wenn der Nutzer erfolgreich beendet wurde.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

SwitchUser

public abstract boolean switchUser (int userId)

Zu einer anderen Nutzer-ID mit Standardzeitlimit wechseln. switchUser(int, long).

Parameter
userId int

Returns
boolean "True", wenn die neue userId mit dem userId-Anbieter übereinstimmt. Andernfalls „false“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

SwitchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Wechseln Sie zu einer anderen Nutzer-ID mit dem angegebenen Zeitlimit als Frist. Es wurde versucht, den Keyguard zu deaktivieren, nachdem die Benutzeränderung erfolgreich war.

Parameter
userId int

timeout long: Warten, bis „false“ für Switch-User zurückgegeben wird.
Returns
boolean "True", wenn die neue userId mit dem userId-Anbieter übereinstimmt. Andernfalls „false“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

TakeBugreport

public abstract Bugreport takeBugreport ()

Erstellen Sie einen Fehlerbericht und geben Sie ihn in einem Bugreport-Objekt zurück, um ihn zu verarbeiten. Null zurückgeben wenn es ein Problem gibt. Die Datei, auf die im Fehlerbericht-Objekt verwiesen wird, muss mit Bugreport.close() bereinigt werden.

Returns
Bugreport

Deinstallationspaket

public abstract String uninstallPackage (String packageName)

Android-Paket vom Gerät deinstallieren

Parameter
packageName String: das zu deinstallierende Android-Paket
Returns
String einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

deinstallierenPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Android-Paket für einen bestimmten Nutzer vom Gerät deinstallieren

Parameter
packageName String: das zu deinstallierende Android-Paket
userId int: die ganzzahlige Nutzer-ID, für die deinstalliert werden soll.
Returns
String einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.
Ausgabe
DeviceNotAvailableException Verbindung zum Gerät unterbrochen wiederhergestellt.

WartefürSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Warten Sie gegebenenfalls, bis „snapuserd“ abgeschlossen ist.

Parameter
currentPhase SnapuserdWaitPhase

Ausgabe
DeviceNotAvailableException