ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

Bietet eine zuverlässige und etwas höhere API für eine ddmlib IDevice.

Wiederholt Gerätebefehle für eine konfigurierbare Anzahl von Malen und bietet eine Benutzeroberfläche zur Gerätewiederherstellung für Geräte, die nicht reagieren.

Zusammenfassung

Verschachtelte Klassen

class ITestDevice.ApexInfo

Eine einfache Strukturklasse zum Speichern von Informationen zu einer einzelnen APEX 

class ITestDevice.MountPointInfo

Eine einfache Strukturklasse zum Speichern von Informationen zu einem einzelnen Bereitstellungspunkt 

Öffentliche Methoden

abstract boolean canSwitchToHeadlessSystemUser()

Gibt an, ob der Wechsel zum headless SYSTEM-Nutzer zulässig ist.

abstract boolean checkConnectivity()

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

abstract boolean clearErrorDialogs()

Schließen Sie alle Fehlerdialogfelder, die derzeit auf der Geräteoberfläche angezeigt werden.

abstract void clearLastConnectedWifiNetwork()

Das zuletzt verbundene WLAN wird gelöscht.

abstract boolean connectToWifiNetwork( wifiSsidToPsk)

Verbindet sich mit einem WLAN.

abstract boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

Verbindet sich mit einem WLAN.

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

Verbindet sich mit einem WLAN.

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

Verbindet sich mit einem WLAN.

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

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

abstract boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

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

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()

Es wird versucht, den Keyguard zu deaktivieren.

abstract boolean disableNetworkMonitor()

Deaktiviert die Netzwerküberwachung auf dem Gerät.

abstract boolean disconnectFromWifi()

Trennen Sie die Verbindung zu einem WLAN.

abstract boolean doesFileExist(String deviceFilePath, int userId)

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

abstract File dumpHeap(String process, String devicePath)

Versuchen Sie, den Heap aus dem system_server zu dumpen.

abstract boolean enableNetworkMonitor()

Aktiviert die Netzwerküberwachung auf dem Gerät.

abstract getActiveApexes()

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

abstract getAllSettings(String namespace)

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

abstract String getAndroidId(int userId)

Die mit einer Nutzer-ID verknüpfte Android-ID suchen und zurückgeben. Wenn sie nicht gefunden wird, wird „null“ zurückgegeben.

abstract getAndroidIds()

Erstellen Sie eine Zuordnungstabelle mit den gefundenen Android-IDs und den zugehörigen User-IDs.

abstract PackageInfo getAppPackageInfo(String packageName)

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

abstract getAppPackageInfos()

Ruft Informationen zu auf dem Gerät installierten Paketen ab.

abstract InputStreamSource getBugreport()

Ruft einen Fehlerbericht vom Gerät ab.

abstract InputStreamSource getBugreportz()

Ruft einen Fehlerbericht vom Gerät ab.

abstract DeviceFoldableState getCurrentFoldableState()

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

abstract int getCurrentUser()

Gibt die ID des aktuell laufenden Nutzers zurück.

abstract getFoldableStates()

Liste der Zustände des faltbaren Geräts zurückgeben

abstract getInstalledPackageNames()

Ruft die Namen der Anwendungspakete auf dem Gerät ab.

abstract String getIpAddress()

Ruft die IP-Adresse des Geräts ab.

abstract KeyguardControllerState getKeyguardState()

Gib ein Objekt zurück, um den aktuellen Status des Sperrbildschirms abzurufen, oder „null“, wenn er nicht unterstützt wird.

abstract Integer getMainUserId()

Gibt die Hauptnutzer-ID zurück.

abstract getMainlineModuleInfo()

Informationen zu den auf dem Gerät installierten Mainline-Modulen abrufen

abstract int getMaxNumberOfRunningUsersSupported()

Die maximale Anzahl der gleichzeitig unterstützten Nutzer abrufen

abstract int getMaxNumberOfUsersSupported()

Maximal unterstützte Nutzerzahl abrufen

abstract TestDeviceOptions getOptions()

Rufen Sie 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 auf dem Gerät.

abstract InputStreamSource getScreenshot(long displayId)

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

abstract InputStreamSource getScreenshot(String format)

Erstellt einen Screenshot auf dem Gerät.

abstract InputStreamSource getScreenshot()

Erstellt einen Screenshot auf dem 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 auf den Systemnutzer angewendet.

abstract getUninstallablePackageNames()

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

abstract int getUserFlags(int userId)

Die Markierungen eines bestimmten Nutzers suchen und zurückgeben.

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 mit der userId verknüpft ist, falls gefunden, andernfalls -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)

Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer

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

Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer

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

Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen Split-Paket)

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

Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen Split-Paket), die sich auf dem Android-Gerät befinden

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

Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen unterteilten Paket) für einen bestimmten Nutzer

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

Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen unterteilten Paket) für einen bestimmten Nutzer

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

Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen Split-Paket), die sich auf dem Android-Gerät befinden

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

Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen Split-Paket), die sich auf dem Android-Gerät befinden

abstract boolean isHeadlessSystemUserMode()

Gibt an, ob auf dem Gerät der headless Systemnutzermodus verwendet wird.

abstract boolean isMainUserPermanentAdmin()

Gibt an, ob der Hauptnutzer ein dauerhafter Administrator ist und nicht gelöscht oder auf den Status „Kein Administrator“ herabgestuft werden kann.

abstract boolean isMultiUserSupported()

Bestimmt, ob die Nutzung durch mehrere Nutzer unterstützt wird.

abstract boolean isPackageInstalled(String packageName, String userId)

Das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID abfragen, um zu prüfen, ob es für diesen Nutzer derzeit installiert ist oder nicht.

abstract boolean isPackageInstalled(String packageName)

Das Gerät wird nach einem bestimmten Paketnamen abgefragt, um zu prüfen, ob es derzeit installiert ist.

abstract boolean isUserRunning(int userId)

Prüfen, ob ein bestimmter Nutzer aktiv ist

abstract boolean isUserSecondary(int userId)

Gibt an, 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 im angegebenen Display sichtbar ist.

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

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

abstract boolean isVisibleBackgroundUsersSupported()

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

abstract boolean isWifiEnabled()

Prüfen, ob WLAN aktiviert ist

abstract listDisplayIds()

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

abstract listDisplayIdsForStartingVisibleBackgroundUsers()

Liste der Displays abrufen, die für 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 an die Meldenden zu senden.

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

Das Gerät wird angewiesen, auf den Abschluss von snapuserd zu warten.

abstract void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Registriert eine IDeviceActionReceiver für dieses Gerät.

abstract boolean removeAdmin(String componentName, int userId)

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

abstract void removeOwners()

Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen nach Möglichkeit.

abstract boolean removeUser(int userId)

Einen bestimmten Nutzer vom Gerät entfernen.

abstract boolean setDeviceOwner(String componentName, int userId)

Eine Geräteadministratorkomponente als Geräteinhaber für den angegebenen Nutzer festlegen

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

Siehe setSetting(int, String, String, String) und wird auf den Systemnutzer angewendet.

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

Dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzufügen.

abstract boolean startUser(int userId)

Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist.

abstract boolean startUser(int userId, boolean waitFlag)

Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist.

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

Startet einen bestimmten Nutzer im Hintergrund, der auf dem entsprechenden Display sichtbar ist, sodass der Nutzer Aktivitäten auf diesem Display starten kann.

abstract boolean stopUser(int userId)

Stoppt einen bestimmten Nutzer.

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

Einen bestimmten Nutzer anhalten.

abstract boolean switchUser(int userId)

Wechseln Sie zu einer anderen userId mit einer Standardzeitüberschreitung.

abstract boolean switchUser(int userId, long timeout)

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

abstract Bugreport takeBugreport()

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

abstract String uninstallPackage(String packageName)

Deinstallation eines Android-Pakets vom Gerät

abstract String uninstallPackageForUser(String packageName, int userId)

Deinstallation eines Android-Pakets von einem Gerät für einen bestimmten Nutzer

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Warten Sie, bis snapuserd abgeschlossen ist.

Öffentliche Methoden

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

Gibt an, ob der Wechsel zum headless SYSTEM-Nutzer zulässig ist.

Returns
boolean

Ausgabe
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

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

Returns
boolean true, wenn das Gerät eine funktionierende Netzwerkverbindung hat, false andernfalls.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

Schließen Sie alle Fehlerdialogfelder, die derzeit auf der Geräteoberfläche angezeigt werden.

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

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

Das zuletzt verbundene WLAN wird gelöscht. Diese Funktion sollte beim Starten einer neuen Aufrufinstanz aufgerufen werden, um zu verhindern, dass nach dem Neustart des Geräts eine Verbindung zum WLAN hergestellt wird, das im vorherigen Test verwendet wurde.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Verbindet sich mit einem WLAN.

Aktiviert das WLAN und blockiert es, bis eine Verbindung zu einem der WLANs hergestellt wurde, die in der Zuordnungstabelle „wifiSsidToPsk“ angegeben sind. Sobald eine Verbindung hergestellt wurde, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice.disconnectFromWifi() oder ITestDevice.clearLastConnectedWifiNetwork() aufgerufen wird.

Parameter
wifiSsidToPsk : Eine Zuordnung von WLAN-SSIDs zu Passwörtern.
Returns
boolean true, wenn eine Verbindung zum WLAN hergestellt wurde. false otherwise
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Verbindet sich mit einem WLAN.

Aktiviert das WLAN und blockiert es, bis eine Verbindung zu einem der WLANs hergestellt wurde, die in der Zuordnungstabelle „wifiSsidToPsk“ angegeben sind. Sobald eine Verbindung hergestellt wurde, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice.disconnectFromWifi() oder ITestDevice.clearLastConnectedWifiNetwork() aufgerufen wird.

Parameter
wifiSsidToPsk : Eine Zuordnung von WLAN-SSIDs zu Passwörtern.
scanSsid boolean: Gibt an, ob nach ausgeblendeten SSIDs für dieses Netzwerk gesucht werden soll.
Returns
boolean true, wenn eine Verbindung zum WLAN hergestellt wurde. false otherwise
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Verbindet sich mit einem WLAN.

Das WLAN wird aktiviert und blockiert, bis eine Verbindung zum angegebenen WLAN hergestellt wurde. Sobald eine Verbindung hergestellt wurde, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice.disconnectFromWifi() oder ITestDevice.clearLastConnectedWifiNetwork() aufgerufen wird.

Parameter
wifiSsid String: Die WLAN-SSID, mit der eine Verbindung hergestellt werden soll
wifiPsk String: PSK-Passphrase oder „null“, wenn nicht verschlüsselt
Returns
boolean true, wenn eine Verbindung zum WLAN hergestellt wurde. false andernfalls
Ausgabe
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)

Verbindet sich mit einem WLAN.

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

Parameter
wifiSsid String: Die WLAN-SSID, mit der eine Verbindung hergestellt werden soll
wifiPsk String: PSK-Passphrase oder „null“, wenn nicht verschlüsselt
scanSsid boolean: Gibt an, ob nach ausgeblendeten SSIDs für dieses Netzwerk gesucht werden soll.
Returns
boolean true, wenn eine Verbindung zum WLAN hergestellt wurde. false andernfalls
Ausgabe
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 dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.

Parameter
scanSsid boolean: Ob nach ausgeblendeten SSIDs für dieses Netzwerk gesucht werden soll
Returns
boolean true, wenn eine Verbindung zum WLAN hergestellt wurde. false andernfalls
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

Returns
boolean true, wenn eine Verbindung zum WLAN hergestellt wurde. false andernfalls
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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 die Ganzzahl für die erstellte Nutzer-ID
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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: Aktivieren Sie beim Erstellen das Nutzerflag „--guest“.
ephemeral boolean: Aktivieren Sie beim Erstellen das Nutzerflag „--ephemeral“.
Returns
int ID des erstellten Nutzers
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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: Aktivieren Sie beim Erstellen das Nutzerflag „--guest“.
ephemeral boolean: Aktivieren Sie beim Erstellen das Nutzerflag „--ephemeral“.
forTesting boolean: Aktivieren Sie beim Erstellen das Testflag „--for-testing“.
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 Die Ganzzahl für die erstellte User-ID oder -1 für einen Fehler.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Entfernt die registrierte IDeviceActionReceiver.

Parameter
deviceActionReceiver IDeviceActionReceiver: Ein IDeviceActionReceiver, das entfernt wird.

disableKeyguard

public abstract void disableKeyguard ()

Es wird versucht, den Keyguard zu deaktivieren.

Warten Sie zuerst, bis die Eingabeweiterleitung bereit ist. Das geschieht ungefähr zur selben Zeit, wenn das Gerät BOOT_COMPLETE meldet, anscheinend asynchron, da die aktuelle Framework-Implementierung gelegentlich zu einer Race-Condition führt. Dann wird der Befehl gesendet, um den Sperrbildschirm zu schließen (funktioniert nur bei nicht sicheren Sperrbildschirmen).

Ausgabe
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Deaktiviert die Netzwerküberwachung auf dem Gerät.

Returns
boolean true, wenn das Monitoring erfolgreich deaktiviert wurde. false , wenn der Vorgang fehlgeschlagen ist.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

Trennen Sie die Verbindung zu einem WLAN.

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

Returns
boolean true, wenn die Verbindung zum WLAN getrennt wurde. false if disconnect failed.
Ausgabe
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 zu ermitteln, ob eine Datei auf dem Gerät für einen bestimmten Nutzer vorhanden ist.

Parameter
deviceFilePath String: Der absolute Pfad der Datei auf dem Gerät, die geprüft werden soll.
userId int: Die Nutzer-ID, anhand derer die Datei geprüft werden soll
Returns
boolean true, wenn die Datei vorhanden ist, andernfalls false.
Ausgabe
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 aus dem system_server zu dumpen. Der Aufrufer ist für die Bereinigung der Dumpdatei verantwortlich.

Parameter
process String: Der Name des Geräteprozesses, auf dem der Dumpheap erstellt werden soll.
devicePath String: Der Pfad auf dem Gerät, unter dem der Dump abgelegt werden soll. Dies muss ein Ort sein, an dem dies gemäß den Berechtigungen zulässig ist.
Returns
File den ERROR(/File), der 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 , wenn der Vorgang fehlgeschlagen ist.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getActiveApexes

public abstract  getActiveApexes ()

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

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

getAllSettings

public abstract  getAllSettings (String namespace)

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

Parameter
namespace String: Muss eine der folgenden Optionen sein: {"system", "secure", "global"}
Returns
die Zuordnung von Schlüssel/Wert-Paaren. Null, wenn der Namespace nicht unterstützt wird.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidId

public abstract String getAndroidId (int userId)

Die mit einer Nutzer-ID verknüpfte Android-ID suchen und zurückgeben. Wenn sie nicht gefunden wird, wird „null“ zurückgegeben.

Parameter
userId int

Returns
String

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Erstellen Sie eine Zuordnungstabelle mit den gefundenen Android-IDs und den zugehörigen User-IDs. Es kann nicht garantiert werden, dass für jede User-ID eine Android-ID gefunden wird, die mit dieser Funktion verknüpft ist. Daher kann es sein, dass einige User-IDs mit „null“ übereinstimmen.

Returns
Zuordnung von Android-IDs zu Nutzer-IDs.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

Parameter
packageName String

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

getAppPackageInfos

public abstract  getAppPackageInfos ()

Ruft Informationen zu auf dem Gerät installierten Paketen ab.

Returns
ERROR(/List) von PackageInfo 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 garantiert auch auf einem Gerät ohne SD-Karte oder wenn die SD-Karte noch nicht bereitgestellt wurde.

Returns
InputStreamSource Eine InputStreamSource, die den Inhalt des Fehlerberichts auf Anfrage erstellt. Bei einem Fehler wird durch die InputStreamSource eine leere ERROR(/InputStream) zurückgegeben.

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 hilfreich sind.

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

Returns
InputStreamSource eine InputStreamSource der ZIP-Datei mit dem Fehlerbericht zurückgeben, andernfalls „null“.

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Returns
DeviceFoldableState

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

Gibt die ID des aktuell laufenden Nutzers zurück. Bei einem Fehler -10.000 zurückgeben.

Returns
int

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

Liste der Zustände des faltbaren Geräts zurückgeben Kann mit „cmd device_state print-states“ abgerufen werden.

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Ruft die Namen der Anwendungspakete auf dem Gerät ab.

Returns
ERROR(/Set) von String Paketnamen, die derzeit 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 wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

Gib ein Objekt zurück, um den aktuellen Status des Sperrbildschirms abzurufen, oder „null“, wenn er nicht unterstützt wird.

Returns
KeyguardControllerState eine KeyguardControllerState mit einem Snapshot des Status des Sperrbildschirms und gibt „Null“ zurück, wenn die Sperrbildschirmabfrage nicht unterstützt wird.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getMainUserId

public abstract Integer getMainUserId ()

Gibt die Hauptnutzer-ID zurück.

Returns
Integer die userId des Hauptnutzers, falls vorhanden, andernfalls „null“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException wenn die Ausgabe des Geräts nicht wie erwartet ist.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

Informationen zu den auf dem Gerät installierten Mainline-Modulen abrufen

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

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

Returns
int eine Ganzzahl, die die Anzahl der gleichzeitig ausgeführten Nutzer angibt
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Maximal unterstützte Nutzerzahl abrufen 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 ()

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

Returns
TestDeviceOptions TestDeviceOptions zum Testgerät.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

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

Returns
Integer die userId des Hauptnutzers, falls vorhanden, andernfalls „null“.
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 auf dem Gerät. Wir empfehlen, stattdessen getScreenshot(String) mit JPEG-Codierung zu verwenden, um die Größe zu verringern.

Parameter
format String: unterstützt PNG, JPEG
rescale boolean: Gibt an, ob der Screenshot neu skaliert werden soll, um die Größe des resultierenden Bildes zu verringern.
Returns
InputStreamSource einen InputStreamSource des Screenshots im Format oder null, wenn der Screenshot nicht erfolgreich war.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

TODO: Extend the implementations above to support 'format' and 'rescale'

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

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

Erstellt einen Screenshot auf dem Gerät. Wir empfehlen stattdessen die Verwendung von getScreenshot(format) mit JPEG-Codierung für eine kleinere Größe.

Parameter
format String: unterstützt PNG, JPEG
Returns
InputStreamSource einen InputStreamSource des Screenshots im Format oder null, wenn der Screenshot nicht erfolgreich war.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot ()

Erstellt einen Screenshot auf dem Gerät.

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

Parameter
userId int

namespace String

key String

Returns
String Der Wert, der mit dem 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 den Systemnutzer ausgeführt.

Parameter
namespace String

key String

Returns
String

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

Rufen Sie die Namen der Anwendungspakete ab, die deinstalliert werden können. Derzeit sind das nicht systemeigene Pakete und aktualisierte Systempakete.

Returns
ERROR(/Set) der Namen von nicht deinstallierbaren String-Paketen, die derzeit auf dem Gerät installiert sind.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

Die Markierungen eines bestimmten Nutzers suchen und zurückgeben. Flags werden in der Klasse „android.content.pm.UserInfo“ im Android Open Source-Projekt definiert.

Parameter
userId int

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

getUserInfos

public abstract  getUserInfos ()

Ruft die Zuordnung von „useId“ zu „UserInfo“ auf dem Gerät ab. Wird DeviceRuntimeException ausgegeben, wenn die Ausgabe des Geräts 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 mit der userId verknüpft ist, falls gefunden, andernfalls -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 sollte „feature:“ oder direkt „“ sein.
Returns
boolean „True“, wenn die Funktion 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. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.
Returns
String String mit einem Fehlercode oder null bei Erfolg.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

installPackage

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 bei Anwendungsfällen aufgerufen werden, bei denen die Laufzeitberechtigung bei der Installation explizit gesteuert werden muss.

Parameter
packageFile File: die zu installierende APK-Datei
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions boolean: ob alle Laufzeitberechtigungen bei der Installation erteilt werden sollen
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.
Returns
String String mit einem Fehlercode oder null bei Erfolg.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
UnsupportedOperationException wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

installPackageForUser

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

Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer

Parameter
packageFile File: die zu installierende APK-Datei
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
userId int: Die Ganzzahl-Nutzer-ID, für die die Installation erfolgen soll.
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.
Returns
String String mit einem Fehlercode oder null bei Erfolg.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

installPackageForUser

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

Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer

Hinweis: Diese Funktion sollte nur bei Anwendungsfällen aufgerufen werden, bei denen die Laufzeitberechtigung bei der Installation explizit gesteuert werden muss.

Parameter
packageFile File: die zu installierende APK-Datei
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions boolean: ob alle Laufzeitberechtigungen bei der Installation erteilt werden sollen
userId int: Die Ganzzahl-Nutzer-ID, für die die Installation erfolgen soll.
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.
Returns
String String mit einem Fehlercode oder null bei Erfolg.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
UnsupportedOperationException wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

installPackages

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

Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen Split-Paket) Unter „https://developer.android.com/studio/build/configure-apk-splits“ erfahren Sie, wie Sie die APK in mehrere Dateien aufteilen.

Parameter
packageFiles : die lokalen APK-Dateien
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.
Returns
String String mit einem Fehlercode oder null bei Erfolg.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
UnsupportedOperationException wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

installPackages

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

Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen Split-Paket), die sich auf dem Android-Gerät befinden Unter https://developer.android.com/studio/build/configure-apk-splits finden Sie Informationen zum Aufteilen der APK in mehrere Dateien.

Hinweis: Diese Funktion sollte nur bei Anwendungsfällen aufgerufen werden, bei denen die Laufzeitberechtigung bei der Installation explizit gesteuert werden muss.

Parameter
packageFiles : die Pfade zu den zu installierenden Remote-APK-Dateien
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions boolean: ob alle Laufzeitberechtigungen bei der Installation erteilt werden sollen
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.
Returns
String String mit einem Fehlercode oder null bei Erfolg.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
UnsupportedOperationException wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

installPackagesForUser

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

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

Parameter
packageFiles : die lokalen APK-Dateien
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
userId int: Die Ganzzahl-Nutzer-ID, für die die Installation erfolgen soll.
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.
Returns
String String mit einem Fehlercode oder null bei Erfolg.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
UnsupportedOperationException wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

installPackagesForUser

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

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

Hinweis: Diese Funktion sollte nur bei Anwendungsfällen aufgerufen werden, bei denen die Laufzeitberechtigung bei der Installation explizit gesteuert werden muss.

Parameter
packageFiles : die lokalen APK-Dateien
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions boolean: ob alle Laufzeitberechtigungen bei der Installation erteilt werden sollen
userId int: Die Ganzzahl-Nutzer-ID, für die die Installation erfolgen soll.
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.
Returns
String String mit einem Fehlercode oder null bei Erfolg.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
UnsupportedOperationException wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

installRemotePackages

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

Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen Split-Paket), die sich auf dem Android-Gerät befinden Unter https://developer.android.com/studio/build/configure-apk-splits finden Sie Informationen zum Aufteilen der APK in mehrere Dateien.

Parameter
remoteApkPaths : die Pfade zu den Remote-APK-Dateien
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.
Returns
String String mit einem Fehlercode oder null bei Erfolg.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
UnsupportedOperationException wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

installRemotePackages

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

Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen Split-Paket), die sich auf dem Android-Gerät befinden Unter https://developer.android.com/studio/build/configure-apk-splits finden Sie Informationen zum Aufteilen der APK in mehrere Dateien.

Hinweis: Diese Funktion sollte nur bei Anwendungsfällen aufgerufen werden, bei denen die Laufzeitberechtigung bei der Installation explizit gesteuert werden muss.

Parameter
remoteApkPaths : die Pfade zu den Remote-APK-Dateien
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions boolean: ob alle Laufzeitberechtigungen bei der Installation erteilt werden sollen
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.
Returns
String String mit einem Fehlercode oder null bei Erfolg.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.
UnsupportedOperationException wenn die Laufzeitberechtigung von der Plattform auf dem Gerät nicht unterstützt wird.

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

Gibt zurück, ob das Gerät den headless-Nutzermodus des Systems verwendet.

Returns
boolean

Ausgabe
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

Gibt an, ob der Hauptnutzer ein dauerhafter Administrator ist und nicht gelöscht oder auf den Status „Kein Administrator“ herabgestuft werden kann.

Returns
boolean

Ausgabe
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Bestimmt, ob die Nutzung durch mehrere Nutzer unterstützt wird.

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

Das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID abfragen, um zu prüfen, ob es für diesen Nutzer derzeit installiert ist oder nicht.

Parameter
packageName String: das Paket, für das geprüft wird, ob es installiert ist.
userId String: Die Nutzer-ID, für die geprüft wird, ob das Paket installiert ist. Wenn „null“ festgelegt ist, wird „0“ für den Hauptnutzer verwendet.
Returns
boolean „True“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

Das Gerät wird nach einem bestimmten Paketnamen abgefragt, 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, ob ein bestimmter Nutzer aktiv ist

Parameter
userId int

Returns
boolean „True“, wenn der Nutzer läuft, andernfalls „False“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

Parameter
userId int

Returns
boolean „true“, wenn der Nutzer sekundär 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 „sichtbarer“ Nutzer ist ein Nutzer, der mit dem „menschlichen“ Nutzer interagiert und daher Aktivitäten starten kann (in der Regel im Standarddisplay).

Parameter
userId int

Returns
boolean

Ausgabe
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

Parameter
userId int

displayId int

Returns
boolean

Ausgabe
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

In diesem Fall kannst du startVisibleBackgroundUser(int, int, boolean) aufrufen und ein Display übergeben, das von listDisplayIdsForStartingVisibleBackgroundUsers() zurückgegeben wurde (und ERROR(/java.android.view.Display#DEFAULT_DISPLAY) enthalten sollte).

Returns
boolean

Ausgabe
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

In diesem Fall können Sie startVisibleBackgroundUser(int, int, boolean) aufrufen und ein Display übergeben, das von listDisplayIdsForStartingVisibleBackgroundUsers() zurückgegeben wird.

Returns
boolean

Ausgabe
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Prüfen, ob WLAN aktiviert ist

Prüft, ob WLAN auf dem Gerät aktiviert ist. Nützlich, um den WLAN-Status vor Tests zu prüfen, die nicht über WLAN ausgeführt werden sollten, z.B. Tests für mobile Daten.

Returns
boolean true, wenn WLAN aktiviert ist. false, wenn deaktiviert
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

listDisplayIds

public abstract  listDisplayIds ()

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

Returns
Die Liste der Displays. Standardmäßig wird immer der Standardwert „0“ zurückgegeben.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Returns
Ausgabe
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

Ruft die Liste der Nutzer auf dem Gerät ab. Wird DeviceRuntimeException ausgegeben, wenn die Ausgabe 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 an die Meldenden zu senden.

Parameter
dataName String: Name, unter dem der Fehlerbericht gemeldet wird.
listener ITestLogger: einen ITestLogger, um den Fehlerbericht zu protokollieren.
Returns
boolean „True“, wenn die Protokollierung erfolgreich war, andernfalls „false“.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Das Gerät wird angewiesen, auf den Abschluss von snapuserd zu warten.

Parameter
waitPhase SnapuserdWaitPhase

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registriert eine IDeviceActionReceiver für dieses Gerät.

Alle registrierten IDeviceActionReceivers werden vor Beginn und nach Ende einer Geräteaktion benachrichtigt.

Parameter
deviceActionReceiver IDeviceActionReceiver: Ein IDeviceActionReceiver, das registriert wird.

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

Parameter
componentName String: der zu entfernenden Geräteverwaltung.
userId int: des Nutzers, in dessen Land sich der Geräteadministrator befindet.
Returns
boolean „True“, wenn erfolgreich, andernfalls „false“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeOwners

public abstract void removeOwners ()

Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen nach Möglichkeit.

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

removeUser

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 entfernt werden konnte, andernfalls „false“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

Eine Geräteadministratorkomponente als Geräteinhaber für den angegebenen Nutzer festlegen

Parameter
componentName String: des Geräteadministrators als Geräteinhaber.
userId int: des Nutzers, in dessen Land sich der Geräteinhaber befindet.
Returns
boolean „True“, wenn erfolgreich, andernfalls „false“.
Ausgabe
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 auf den Systemnutzer angewendet.

Parameter
namespace String

key String

value String

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

Dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzufügen. Einige Einstellungen sind erst nach einem Neustart verfügbar. namespace muss eine der folgenden Optionen sein: {"system", "secure", "global"}

Parameter
userId int

namespace String

key String

value String

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist. Wenn der Nutzer bereits im Hintergrund ausgeführt wird, ist diese Methode ein NOOP.

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

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist. Wenn der Nutzer bereits im Hintergrund ausgeführt wird, ist diese Methode ein NOOP. Es ist möglich, ein zusätzliches Flag anzugeben, um zu warten, bis der Vorgang wirksam wird.

Parameter
userId int: des Nutzers, der im Hintergrund gestartet werden soll
waitFlag boolean: Der Befehl wartet, bis der Nutzer gestartet und entsperrt ist.
Returns
boolean „wahr“, 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 entsprechenden Display sichtbar ist, sodass der Nutzer Aktivitäten auf diesem Display starten kann.

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

Parameter
userId int: des Nutzers, der im Hintergrund gestartet werden soll
displayId int: Display, auf dem die Benachrichtigung für Nutzer sichtbar sein soll
waitFlag boolean: Der Befehl wartet, bis der Nutzer gestartet und entsperrt ist.
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 angehalten hat, ist diese Methode ein NOOP. Der aktuelle Nutzer und der Systemnutzer können nicht angehalten werden.

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

stopUser

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

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

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

switchUser

public abstract boolean switchUser (int userId)

Wechseln Sie zu einer anderen userId mit einer Standardzeitüberschreitung. switchUser(int, long).

Parameter
userId int

Returns
boolean „True“, wenn die neue User-ID mit dem Anbieter der User-ID ü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. Versuchen Sie, den Sperrbildschirm zu deaktivieren, nachdem die Nutzeränderung erfolgreich war.

Parameter
userId int

timeout long: Wartezeit, bevor „false“ zurückgegeben wird, wenn der Wechsel des Nutzers fehlgeschlagen ist.
Returns
boolean „True“, wenn die neue User-ID mit dem Anbieter der User-ID übereinstimmt. Andernfalls „false“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

Nimmt einen Fehlerbericht entgegen und gibt ihn in einem Bugreport-Objekt zurück, um ihn zu verarbeiten. Gib bei Problemen „null“ zurück. Die im Bugreport-Objekt referenzierte Datei muss über Bugreport.close() bereinigt werden.

Returns
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Deinstallation eines Android-Pakets vom Gerät

Parameter
packageName String: das zu deinstallierende Android-Paket
Returns
String String mit einem Fehlercode oder null bei Erfolg.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

Deinstallation eines Android-Pakets von einem Gerät für einen bestimmten Nutzer

Parameter
packageName String: das zu deinstallierende Android-Paket
userId int: Die Ganzzahl-Nutzer-ID, für die die Deinstallation erfolgen soll.
Returns
String String mit einem Fehlercode oder null bei Erfolg.
Ausgabe
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Warten Sie, bis snapuserd abgeschlossen ist.

Parameter
currentPhase SnapuserdWaitPhase

Ausgabe
DeviceNotAvailableException