ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

Bietet eine zuverlässige API mit etwas höherem Niveau für eine ddmlib IDevice.

Gerätebefehle werden für einen konfigurierbaren Zeitraum wiederholt. Außerdem wird eine Schnittstelle zur Geräte-Wiederherstellung für Geräte bereitgestellt, die nicht reagieren.

Zusammenfassung

Verschachtelte Klassen

class ITestDevice.ApexInfo

Eine einfache Strukturklasse zum Speichern von Informationen zu einem einzelnen APEX-

class ITestDevice.MountPointInfo

Eine einfache Strukturklasse zum Speichern von Informationen zu einem einzelnen Mountpoint 

Öffentliche Methoden

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

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

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

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

abstract boolean canSwitchToHeadlessSystemUser()

Gibt zurück, ob der Wechsel zum monitorlosen 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äte-UI angezeigt werden.

abstract void clearLastConnectedWifiNetwork()

Löscht das zuletzt verbundene WLAN.

default boolean connectToWifiNetwork(Map<String, String> wifiSsidToPsk, boolean scanSsid)

Diese Methode wurde eingestellt. Verwenden Sie stattdessen connectToWifiNetworkWithResult(Map,boolean).

default boolean connectToWifiNetwork(Map<String, String> wifiSsidToPsk)

Diese Methode wurde eingestellt. Verwenden Sie stattdessen connectToWifiNetworkWithResult(Map).

default boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

Diese Methode wurde eingestellt. Verwenden Sie stattdessen connectToWifiNetworkWithResult(String,String).

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

Diese Methode wurde eingestellt. Verwenden Sie stattdessen connectToWifiNetworkWithResult(String,String,boolean).

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

Diese Methode wurde eingestellt. Verwenden Sie stattdessen connectToWifiNetworkIfNeededWithResult(String,String,boolean).

default boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

Diese Methode wurde eingestellt. Verwenden Sie stattdessen connectToWifiNetworkIfNeededWithResult(String,String).

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult(String wifiSsid, String wifiPsk)

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

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk, boolean scanSsid)

Verbindung zu einem WLAN herstellen

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk)

Verbindung zu einem WLAN herstellen

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(Map<String, String> wifiSsidToPsk, boolean scanSsid)

Verbindung zu einem WLAN herstellen

abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult(String wifiSsid, String wifiPsk)

Verbindung zu einem WLAN herstellen

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)

Einen Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

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

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

Die Verbindung zu einem WLAN wird getrennt.

abstract boolean doesFileExist(String deviceFilePath, int userId)

Hilfsmethode, um festzustellen, 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 sichern.

abstract boolean enableNetworkMonitor()

Aktiviert die Netzwerküberwachung auf dem Gerät.

abstract Set<ITestDevice.ApexInfo> getActiveApexes()

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

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

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

abstract String getAndroidId(int userId)

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

abstract Map<Integer, String> getAndroidIds()

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

abstract PackageInfo getAppPackageInfo(String packageName)

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

abstract List<PackageInfo> getAppPackageInfos()

Informationen zu auf dem Gerät installierten Paketen abrufen.

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 Status des faltbaren Geräts zurück oder „null“, wenn Probleme aufgetreten sind.

abstract int getCurrentUser()

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

abstract Set<DeviceFoldableState> getFoldableStates()

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

abstract Set<String> getInstalledPackageNames()

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

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 zu erhalten, oder „null“, wenn dies nicht unterstützt wird.

abstract Integer getMainUserId()

Gibt die Hauptnutzer-ID zurück.

abstract Set<String> getMainlineModuleInfo()

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

abstract int getMaxNumberOfRunningUsersSupported()

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

abstract int getMaxNumberOfUsersSupported(String userType)

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

abstract int getMaxNumberOfUsersSupported()

Diese Methode wurde eingestellt. Verwenden Sie getMaxNumberOfUsersSupported(String userType), um die maximale Anzahl der unterstützten Nutzer für einen bestimmten Nutzertyp abzurufen.

abstract TestDeviceOptions getOptions()

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

abstract Integer getPrimaryUserId()

Diese Methode wurde eingestellt. getPrimaryUser wurde aus dem UserManager-Dienst entfernt. Verwenden Sie ERROR(/android.os.UserManager#getMainUserId()), um den ersten vollständigen Nutzer oder 0 für das System abzurufen. Beachten Sie, dass es sich bei monitorlosen Systemen nicht um vollständige Nutzer handelt.

abstract int getRemainingCreatableUserCount(String userType)

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

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

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

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

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

abstract Set<String> getUninstallablePackageNames()

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

abstract int getUserFlags(int userId)

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

abstract Map<Integer, UserInfo> getUserInfos()

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

abstract int getUserSerialNumber(int userId)

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

abstract int getUserVisibleOnDisplay(int displayId)

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

abstract boolean hasFeature(String feature)

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

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

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

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

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

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

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

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

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

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

Installiert APKs im inkrementellen Modus.

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

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

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

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

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

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

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

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

abstract boolean isHeadlessSystemUserMode()

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

abstract boolean isMainUserPermanentAdmin()

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

abstract boolean isMultiUserSupported()

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

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 die App für diesen Nutzer derzeit installiert ist.

abstract boolean isPackageInstalled(String packageName)

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

abstract boolean isUserRunning(int userId)

Prüfen, ob ein bestimmter Nutzer aktiv ist.

abstract boolean isUserSecondary(int userId)

Gibt zurück, ob der angegebene Nutzer anhand seiner 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 angegebenen Display sichtbar ist.

abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported()

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

abstract boolean isVisibleBackgroundUsersSupported()

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

abstract boolean isWifiEnabled()

Prüfen, ob WLAN aktiviert ist.

abstract Set<Long> listDisplayIds()

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

abstract Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers()

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

abstract ArrayList<Integer> listUsers()

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

abstract boolean logBugreport(String dataName, ITestLogger listener)

Helper-Methode zum Erstellen eines Fehlerberichts und zum Protokollieren des Berichts für die Reporter.

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

Das Gerät wird benachrichtigt, bis snapuserd abgeschlossen ist.

abstract void registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver)

Registriert ein IDeviceActionReceiver für dieses Gerät.

abstract boolean removeAdmin(String componentName, int userId)

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

abstract void removeOwners()

Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen.

abstract boolean removeUser(int userId)

Einen bestimmten Nutzer vom Gerät entfernen.

abstract boolean setDeviceOwner(String componentName, int userId)

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

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

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

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

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

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 angegebenen Display sichtbar ist (d.h. der Nutzer kann Aktivitäten auf diesem Display starten).

abstract boolean stopUser(int userId)

Stoppt einen bestimmten Nutzer.

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

Einen bestimmten Nutzer stoppen.

abstract boolean switchUser(int userId)

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

abstract boolean switchUser(int userId, long timeout)

Wechseln Sie mit dem angegebenen Zeitlimit zu einer anderen userId.

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)

Ein Android-Paket vom Gerät deinstallieren.

abstract String uninstallPackageForUser(String packageName, int userId)

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

default void waitForSnapuserd(SnapuserdWaitPhase currentPhase)

Warten Sie gegebenenfalls, bis „snapuserd“ abgeschlossen ist.

Öffentliche Methoden

adbInstallPackage

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

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

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

adbInstallPackage

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

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

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

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

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

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

Gibt Folgendes zurück:
boolean true, wenn das Gerät über eine funktionierende Netzwerkverbindung verfügt, false andernfalls.
Löst aus
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äte-UI angezeigt werden.

Gibt Folgendes zurück:
boolean true, wenn keine Dialogfelder vorhanden waren oder Dialogfelder erfolgreich gelöscht wurden. Andernfalls false.
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

connectToWifiNetwork

public boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen connectToWifiNetworkWithResult(Map,boolean).

Verbindung zu einem WLAN herstellen

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

Parameter
wifiSsidToPsk Map: Eine Zuordnung von WLAN-SSIDs zu Passwörtern.
scanSsid boolean: Gibt an, ob für dieses Netzwerk nach verborgenen SSIDs gesucht werden soll.
Gibt Folgendes zurück:
boolean true, wenn die Verbindung zum WLAN hergestellt wurde. false andernfalls
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

connectToWifiNetwork

public boolean connectToWifiNetwork (Map<String, String> wifiSsidToPsk)

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen connectToWifiNetworkWithResult(Map).

Verbindung zu einem WLAN herstellen

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

Parameter
wifiSsidToPsk Map: Eine Zuordnung von WLAN-SSIDs zu Passwörtern.
Gibt Folgendes zurück:
boolean true, wenn die Verbindung zum WLAN hergestellt wurde. false andernfalls
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

connectToWifiNetwork

public boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen connectToWifiNetworkWithResult(String,String).

Verbindung zu einem WLAN herstellen

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

Parameter
wifiSsid String: Die WLAN-SSID, mit der eine Verbindung hergestellt werden soll
wifiPsk String: PSK-Passphrase oder „null“, wenn nicht verschlüsselt
Gibt Folgendes zurück:
boolean true, wenn die Verbindung zum WLAN hergestellt wurde. false andernfalls
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

connectToWifiNetwork

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

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen connectToWifiNetworkWithResult(String,String,boolean).

Verbindung zu einem WLAN herstellen

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

Parameter
wifiSsid String: Die WLAN-SSID, mit der eine Verbindung hergestellt werden soll
wifiPsk String: PSK-Passphrase oder „null“, wenn nicht verschlüsselt
scanSsid boolean: Gibt an, ob für dieses Netzwerk nach verborgenen SSIDs gesucht werden soll.
Gibt Folgendes zurück:
boolean true, wenn die Verbindung zum WLAN hergestellt wurde. false andernfalls
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

connectToWifiNetworkIfNeeded

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

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen connectToWifiNetworkIfNeededWithResult(String,String,boolean).

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

Parameter
scanSsid boolean: Gibt an, ob für dieses Netzwerk nach einer verborgenen SSID gesucht werden soll.
Gibt Folgendes zurück:
boolean true, wenn die Verbindung zum WLAN hergestellt wurde. false andernfalls
Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen connectToWifiNetworkIfNeededWithResult(String,String).

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

Gibt Folgendes zurück:
boolean true, wenn die Verbindung zum WLAN hergestellt wurde. false andernfalls
Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeededWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

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

Parameter
scanSsid boolean: Gibt an, ob für dieses Netzwerk nach einer verborgenen SSID gesucht werden soll.
Gibt Folgendes zurück:
IWifiHelper.WifiConnectionResult WifiConnectionResult gibt den Status der Verbindung an.
Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeededWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkIfNeededWithResult (String wifiSsid, 
                String wifiPsk)

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

Gibt Folgendes zurück:
IWifiHelper.WifiConnectionResult WifiConnectionResult gibt den Status der Verbindung an.
Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk, 
                boolean scanSsid)

Verbindung zu einem WLAN herstellen

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

Parameter
wifiSsid String: Die WLAN-SSID, mit der eine Verbindung hergestellt werden soll
wifiPsk String: PSK-Passphrase oder „null“, wenn nicht verschlüsselt
scanSsid boolean: Gibt an, ob für dieses Netzwerk nach verborgenen SSIDs gesucht werden soll.
Gibt Folgendes zurück:
IWifiHelper.WifiConnectionResult WifiConnectionResult gibt den Status der Verbindung an.
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk)

Verbindung zu einem WLAN herstellen

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

Parameter
wifiSsidToPsk Map: Eine Zuordnung von WLAN-SSIDs zu Passwörtern.
Gibt Folgendes zurück:
IWifiHelper.WifiConnectionResult WifiConnectionResult gibt den Status der Verbindung an.
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (Map<String, String> wifiSsidToPsk, 
                boolean scanSsid)

Verbindung zu einem WLAN herstellen

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

Parameter
wifiSsidToPsk Map: Eine Zuordnung von WLAN-SSIDs zu Passwörtern.
scanSsid boolean: Gibt an, ob für dieses Netzwerk nach verborgenen SSIDs gesucht werden soll.
Gibt Folgendes zurück:
IWifiHelper.WifiConnectionResult WifiConnectionResult gibt den Status der Verbindung an.
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

connectToWifiNetworkWithResult

public abstract IWifiHelper.WifiConnectionResult connectToWifiNetworkWithResult (String wifiSsid, 
                String wifiPsk)

Verbindung zu einem WLAN herstellen

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

Parameter
wifiSsid String: Die WLAN-SSID, mit der eine Verbindung hergestellt werden soll
wifiPsk String: PSK-Passphrase oder „null“, wenn nicht verschlüsselt
Gibt Folgendes zurück:
IWifiHelper.WifiConnectionResult WifiConnectionResult gibt den Status der Verbindung an.
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

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

createUser

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

Einen Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

Parameter
name String: des Nutzers, der auf dem Gerät erstellt werden soll
guest boolean: Aktivieren Sie das Nutzer-Flag „--guest“ während der Erstellung.
ephemeral boolean: Aktivieren Sie das Nutzer-Flag „--ephemeral“ bei der Erstellung.
Gibt Folgendes zurück:
int ID des erstellten Nutzers
Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException
IllegalStateException

createUser

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

Einen Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

Parameter
name String: des Nutzers, der auf dem Gerät erstellt werden soll
guest boolean: Aktivieren Sie das Nutzer-Flag „--guest“ während der Erstellung.
ephemeral boolean: Aktivieren Sie das Nutzer-Flag „--ephemeral“ bei der Erstellung.
forTesting boolean: Aktivieren Sie beim Erstellen das Testflag „--for-testing“.
Gibt Folgendes zurück:
int ID des erstellten Nutzers
Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException
IllegalStateException

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
Gibt Folgendes zurück:
int Die Ganzzahl für die erstellte Nutzer-ID oder -1 bei einem Fehler.
Löst aus
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 Eingabe bereit ist. Das passiert ungefähr zur selben Zeit, zu der das Gerät BOOT_COMPLETE meldet. Das geschieht anscheinend asynchron, da die aktuelle Framework-Implementierung gelegentlich Race Conditions aufweist. Anschließend wird der Befehl zum Schließen des Keyguards gesendet (funktioniert nur bei nicht sicheren Keyguards).

Löst aus
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Deaktiviert die Netzwerküberwachung auf dem Gerät.

Gibt Folgendes zurück:
boolean true, wenn das Monitoring erfolgreich deaktiviert wurde. false, wenn der Vorgang fehlgeschlagen ist.
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

Die Verbindung zu einem WLAN wird getrennt.

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

Gibt Folgendes zurück:
boolean true, wenn die Verbindung zum WLAN getrennt wurde. false wenn das Trennen der Verbindung fehlgeschlagen ist.
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

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

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

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Aktiviert die Netzwerküberwachung auf dem Gerät.

Gibt Folgendes zurück:
boolean true, wenn das Monitoring erfolgreich aktiviert wurde. false, wenn der Vorgang fehlgeschlagen ist.
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getActiveApexes

public abstract Set<ITestDevice.ApexInfo> getActiveApexes ()

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

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

getAllSettings

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

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

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

getAndroidId

public abstract String getAndroidId (int userId)

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

Parameter
userId int

Gibt Folgendes zurück:
String

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

getAndroidIds

public abstract Map<Integer, String> getAndroidIds ()

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

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

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

getAppPackageInfos

public abstract List<PackageInfo> getAppPackageInfos ()

Informationen zu auf dem Gerät installierten Paketen abrufen.

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

getBugreport

public abstract InputStreamSource getBugreport ()

Ruft einen Fehlerbericht vom Gerät ab.

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

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

getBugreportz

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

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

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

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Gibt Folgendes zurück:
DeviceFoldableState

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

getCurrentUser

public abstract int getCurrentUser ()

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

Gibt Folgendes zurück:
int

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

getFoldableStates

public abstract Set<DeviceFoldableState> getFoldableStates ()

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

Gibt Folgendes zurück:
Set<DeviceFoldableState>

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

getInstalledPackageNames

public abstract Set<String> getInstalledPackageNames ()

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

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

getIpAddress

public abstract String getIpAddress ()

Ruft die IP-Adresse des Geräts ab.

Gibt Folgendes zurück:
String Die IP-Adresse des Geräts oder null, wenn das Gerät keine IP-Adresse hat
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

Gibt Folgendes zurück:
KeyguardControllerState ein KeyguardControllerState mit einem Snapshot des Status des Keyguard zurückgibt und Null zurückgibt, wenn die Keyguard-Abfrage nicht unterstützt wird.
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

getMainUserId

public abstract Integer getMainUserId ()

Gibt die Hauptnutzer-ID zurück.

Gibt Folgendes zurück:
Integer Die userId des Hauptnutzers, falls vorhanden, andernfalls null.
Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException wenn die Ausgabe des Geräts nicht wie erwartet ist.
DeviceNotAvailableException

getMainlineModuleInfo

public abstract Set<String> getMainlineModuleInfo ()

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

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

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported (String userType)

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

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Diese Methode wurde eingestellt.
Verwenden Sie getMaxNumberOfUsersSupported(String userType), um die maximale Anzahl der unterstützten Nutzer für einen bestimmten Nutzertyp abzurufen.

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

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

getOptions

public abstract TestDeviceOptions getOptions ()

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

Gibt Folgendes zurück:
TestDeviceOptions TestDeviceOptions im Zusammenhang mit dem zu testenden Gerät.

getPrimaryUserId

public abstract Integer getPrimaryUserId ()

Diese Methode wurde eingestellt.
getPrimaryUser wurde aus dem UserManager-Dienst eingestellt. Verwenden Sie ERROR(/android.os.UserManager#getMainUserId()), um den ersten vollständigen Nutzer oder 0 für das System abzurufen. Beachten Sie, dass es sich bei einem monitorlosen System nicht um einen vollständigen Nutzer handelt.

Gibt die Hauptnutzer-ID zurück.

Gibt Folgendes zurück:
Integer Die userId des Hauptnutzers, falls vorhanden, andernfalls „null“.
Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceRuntimeException wenn die Ausgabe des Geräts nicht wie erwartet ist.
DeviceNotAvailableException

getRemainingCreatableUserCount

public abstract int getRemainingCreatableUserCount (String userType)

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

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

getScreenshot

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

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

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

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

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

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

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

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

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

getScreenshot

public abstract InputStreamSource getScreenshot ()

Erstellt einen Screenshot vom Gerät.

Gibt Folgendes zurück:
InputStreamSource InputStreamSource des Screenshots im PNG-Format oder null, wenn der Screenshot nicht erfolgreich war.
Löst aus
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. Der Namespace muss einer der folgenden Werte sein: {"system", "secure", "global"}

Parameter
userId int

namespace String

key String

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

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

Parameter
namespace String

key String

Gibt Folgendes zurück:
String

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

getUninstallablePackageNames

public abstract Set<String> getUninstallablePackageNames ()

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

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

getUserFlags

public abstract int getUserFlags (int userId)

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

Parameter
userId int

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

getUserInfos

public abstract Map<Integer, UserInfo> getUserInfos ()

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

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

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

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

Parameter
userId int

Gibt Folgendes zurück:
int

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

getUserVisibleOnDisplay

public abstract int getUserVisibleOnDisplay (int displayId)

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

Parameter
displayId int: Die ID des Displays.
Gibt Folgendes zurück:
int Die Nutzer-ID des sichtbaren Nutzers auf dem angegebenen Display. Es wird nicht zwischen einem sichtbaren Hintergrundnutzer und dem aktuellen Vordergrundnutzer unterschieden, da beide Arten sichtbar sind. Um die beiden Ergebnisse zu unterscheiden, vergleichen Sie sie mit dem Ergebnis von getCurrentUser().
Löst aus
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.
Gibt Folgendes zurück:
boolean „True“, wenn das Feature gefunden wird, andernfalls „false“.
Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

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 für Anwendungsfälle aufgerufen werden, die eine explizite Steuerung der Erteilung der Laufzeitberechtigung bei der Installation erfordern.

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

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. Verfügbare Optionen finden Sie unter „adb shell pm -h“.
Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.
Löst aus
DeviceNotAvailableException 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)

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

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

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

installPackageForUser

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

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

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

installPackageWithIncrementalMode

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

Installiert APKs im inkrementellen Modus.

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

userId String

Gibt Folgendes zurück:
boolean

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

installPackages

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

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

Parameter
packageFiles List: die lokalen APK-Dateien
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“.
Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.
Löst aus
DeviceNotAvailableException 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 (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                String... extraArgs)

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

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

Parameter
packageFiles List: die Pfade der Remote-APK-Dateien, die installiert werden sollen
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions boolean: Gibt an, ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen.
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“.
Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.
Löst aus
DeviceNotAvailableException 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 (List<File> packageFiles, 
                boolean reinstall, 
                int userId, 
                String... extraArgs)

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

Parameter
packageFiles List: die lokalen APK-Dateien
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
userId int: Die Nutzer-ID als Ganzzahl, für die die Installation erfolgen soll.
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“.
Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.
Löst aus
DeviceNotAvailableException 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 (List<File> packageFiles, 
                boolean reinstall, 
                boolean grantPermissions, 
                int userId, 
                String... extraArgs)

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

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

Parameter
packageFiles List: die lokalen APK-Dateien
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions boolean: Gibt an, ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen.
userId int: Die Nutzer-ID als Ganzzahl, für die die Installation erfolgen soll.
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“.
Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.
Löst aus
DeviceNotAvailableException 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 auf dem Gerät der monitorlose Systemnutzermodus verwendet wird.

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

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

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

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

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

Parameter
packageName String

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

isUserRunning

public abstract boolean isUserRunning (int userId)

Prüfen, ob ein bestimmter Nutzer aktiv ist.

Parameter
userId int

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

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

Parameter
userId int

Gibt Folgendes zurück:
boolean „true“, wenn der Nutzer sekundär ist, andernfalls „false“.
Löst aus
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 Launch-Aktivitäten (in der Regel auf dem Standarddisplay) starten kann.

Parameter
userId int

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

Parameter
userId int

displayId int

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

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

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

Gibt Folgendes zurück:
boolean

Löst aus
DeviceNotAvailableException

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 bestätigen, die nicht mit WLAN ausgeführt werden sollten, z.B. Tests für mobile Daten.

Gibt Folgendes zurück:
boolean true, wenn WLAN aktiviert ist. false, falls deaktiviert
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

listDisplayIds

public abstract Set<Long> listDisplayIds ()

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

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

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract Set<Integer> listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Gibt Folgendes zurück:
Set<Integer>

Löst aus
DeviceNotAvailableException

listUsers

public abstract ArrayList<Integer> listUsers ()

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

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

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

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

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Das Gerät wird benachrichtigt, bis snapuserd abgeschlossen ist.

Parameter
waitPhase SnapuserdWaitPhase

registerDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registriert ein IDeviceActionReceiver für dieses Gerät.

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

Parameter
deviceActionReceiver IDeviceActionReceiver: Eine IDeviceActionReceiver, die registriert wird.

removeAdmin

public abstract boolean removeAdmin (String componentName, 
                int userId)

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

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

removeOwners

public abstract void removeOwners ()

Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen.

Löst aus
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
Gibt Folgendes zurück:
boolean „true“, wenn der Nutzer erfolgreich entfernt wurde, andernfalls „false“.
Löst aus
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

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

setSetting

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

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

Parameter
namespace String

key String

value String

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

setSetting

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

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

Parameter
userId int

namespace String

key String

value String

Löst aus
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
Gibt Folgendes zurück:
boolean „true“, wenn der Nutzer erfolgreich im Hintergrund gestartet wurde.
Löst aus
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 wird erst ausgeführt, wenn der Nutzer gestartet und entsperrt wurde.
Gibt Folgendes zurück:
boolean „true“, wenn der Nutzer erfolgreich im Hintergrund gestartet wurde.
Löst aus
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 angegebenen Display sichtbar ist (d.h. der Nutzer kann Aktivitäten auf diesem Display starten).

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

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

stopUser

public abstract boolean stopUser (int userId)

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

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

stopUser

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

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

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

switchUser

public abstract boolean switchUser (int userId)

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

Parameter
userId int

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

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

Parameter
userId int

timeout long: Die Wartezeit, bevor „false“ für „switch-user failed“ zurückgegeben wird.
Gibt Folgendes zurück:
boolean „True“, wenn die neue User-ID mit dem User-ID-Anbieter übereinstimmt. Andernfalls „Falsch”.
Löst aus
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. Gibt bei Problemen „null“ zurück. Die im Bugreport-Objekt referenzierte Datei muss über Bugreport.close() bereinigt werden.

Gibt Folgendes zurück:
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Ein Android-Paket vom Gerät deinstallieren.

Parameter
packageName String: das Android-Paket, das deinstalliert werden soll
Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

uninstallPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

Parameter
packageName String: das Android-Paket, das deinstalliert werden soll
userId int: Die Nutzer-ID als Ganzzahl, für die die Deinstallation erfolgen soll.
Gibt Folgendes zurück:
String String mit einem Fehlercode oder null bei Erfolg.
Löst aus
DeviceNotAvailableException wenn die Verbindung zum Gerät unterbrochen wird und nicht wiederhergestellt werden kann.

waitForSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Warten Sie gegebenenfalls, bis „snapuserd“ abgeschlossen ist.

Parameter
currentPhase SnapuserdWaitPhase

Löst aus
DeviceNotAvailableException