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

abstract boolean connectToWifiNetwork( wifiSsidToPsk)

Verbindung zu einem WLAN herstellen

abstract boolean connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid)

Verbindung zu einem WLAN herstellen

abstract boolean connectToWifiNetwork(String wifiSsid, String wifiPsk)

Verbindung zu einem WLAN herstellen

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

Verbindung zu einem WLAN herstellen

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

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

abstract boolean connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk)

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

abstract int createUser(String name)

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

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

Erstelle einen Nutzer mit einem bestimmten Namen und den angegebenen Flags.

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

Erstelle einen Nutzer mit einem bestimmten Namen und den angegebenen Flags.

abstract int createUserNoThrow(String name)

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

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

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

Erstellen Sie eine Zuordnung von Android-IDs zu übereinstimmenden User-IDs.

abstract PackageInfo getAppPackageInfo(String packageName)

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

abstract 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 Bugreportz 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 getFoldableStates()

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

abstract getInstalledPackageNames()

Ruft die Paketnamen der auf dem Gerät vorhandenen Anwendungen ab.

abstract String getIpAddress()

Ruft die IP-Adresse des Geräts ab.

abstract KeyguardControllerState getKeyguardState()

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

abstract Integer getMainUserId()

Gibt die Hauptnutzer-ID zurück.

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

Maximale Anzahl der unterstützten Nutzer abrufen

abstract TestDeviceOptions getOptions()

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

abstract Integer getPrimaryUserId()

Diese Methode ist veraltet. 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 InputStreamSource getScreenshot(String format, boolean rescale)

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

Erstellt einen Screenshot vom Gerät.

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

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

abstract int getUserFlags(int userId)

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

abstract 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 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 Sie ein Android-Paket auf einem Gerät für einen bestimmten Nutzer.

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

Installieren Sie 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( packageFiles, boolean reinstall, String... extraArgs)

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

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

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

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

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

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

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

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

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

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

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

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 „Kein Administrator“ herabgestuft werden kann.

abstract boolean isMultiUserSupported()

Gibt an, ob mehrere Nutzer unterstützt werden.

abstract boolean isPackageInstalled(String packageName, String userId)

Fragen Sie das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID ab, um zu prüfen, ob 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 auf dem Gerät im Hintergrund in ERROR(/java.android.view.Display#DEFAULT_DISPLAY) sichtbar sein können.

abstract boolean isVisibleBackgroundUsersSupported()

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

abstract boolean isWifiEnabled()

Prüfen, ob WLAN aktiviert ist.

abstract listDisplayIds()

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

abstract listDisplayIdsForStartingVisibleBackgroundUsers()

Ruft die Liste der Displays ab, 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 zum Erstellen eines Fehlerberichts und Protokollieren des Berichts für die Reporter.

default void notifySnapuserd(SnapuserdWaitPhase waitPhase)

Das Gerät wird benachrichtigt, dass es auf den Abschluss von „snapuserd“ warten soll.

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 beendet ist.

abstract boolean startUser(int userId, boolean waitFlag)

Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit beendet 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 innerhalb des angegebenen Zeitlimits zu einer anderen Nutzer-ID.

abstract Bugreport takeBugreport()

Erstellt einen Fehlerbericht 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

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

Returns
boolean

Ausgabe
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

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

Returns
boolean true, wenn das Gerät über eine funktionierende Netzwerkverbindung verfügt, 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äte-UI angezeigt werden.

Returns
boolean true, wenn keine Dialogfelder vorhanden waren oder 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 ()

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 abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

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 : Eine Zuordnung von WLAN-SSIDs zu Passwörtern.
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 ( 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 : Eine Zuordnung von WLAN-SSIDs zu Passwörtern.
scanSsid boolean: Gibt an, ob für dieses Netzwerk nach verborgenen SSIDs gesucht werden soll.
Returns
boolean true, wenn eine Verbindung 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)

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

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.
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: Gibt an, ob für dieses Netzwerk nach einer verborgenen SSID 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 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)

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

Erstelle einen Nutzer mit einem bestimmten Namen und den angegebenen Flags.

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 Nutzerflag „--ephemeral“ während der Erstellung.
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)

Erstelle einen Nutzer mit einem bestimmten Namen und den angegebenen Flags.

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 Nutzerflag „--ephemeral“ während der Erstellung.
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)

Erstellt 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 oder -1 bei einem 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 Eingabeübermittlung 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-Bedingungen aufweist. Anschließend wird der Befehl zum Schließen des Keyguards gesendet (funktioniert nur bei nicht sicheren Keyguards).

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

Die Verbindung zu einem WLAN wird getrennt.

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

Returns
boolean true, wenn die Verbindung zum WLAN getrennt wurde. false wenn das Trennen der Verbindung fehlgeschlagen ist.
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 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 Dateiexistenz 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 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. Dies muss ein Ort sein, an dem dies gemäß den Berechtigungen zulässig ist.
Returns
File 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-Modulen ab.

Returns
ERROR(/Set) von ApexInfo ist 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 einer der folgenden Werte 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)

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

Returns
String

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Erstellen Sie eine Zuordnung von Android-IDs zu übereinstimmenden User-IDs. 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.

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

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

Parameter
packageName String

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

getAppPackageInfos

public abstract  getAppPackageInfos ()

Informationen zu auf dem Gerät installierten Paketen abrufen.

Returns
ERROR(/List) von PackageInfo, die auf dem Gerät installiert sind.
Ausgabe
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).

Returns
InputStreamSource Ein InputStreamSource, das die Inhalte des Fehlerberichts auf Anfrage generiert. Im Fehlerfall gibt InputStreamSource eine leere ERROR(/InputStream) zurück.

getBugreportz

public abstract InputStreamSource getBugreportz ()

Ruft einen Bugreportz 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.

Returns
InputStreamSource InputStreamSource der ZIP-Datei mit den Fehlerberichten. 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.

Returns
DeviceFoldableState

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

Returns
int

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

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

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

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

Ruft die Paketnamen der auf dem Gerät vorhandenen Anwendungen 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 ()

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

Returns
KeyguardControllerState ein KeyguardControllerState mit einem Snapshot des Status des Keyguard zurückgegeben. Wenn die Keyguard-Abfrage nicht unterstützt wird, wird „Null“ zurückgegeben.
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 ()

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

Returns
ERROR(/Set) der String Mainline-Module, die derzeit auf dem Gerät installiert sind.
Ausgabe
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.

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

getMaxNumberOfUsersSupported

public abstract int getMaxNumberOfUsersSupported ()

Maximale Anzahl der unterstützten Nutzer 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 ()

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

Returns
TestDeviceOptions TestDeviceOptions in Bezug auf das zu testende 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 monitorlosen Systemen nicht um einen vollständigen Nutzer handelt.

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 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.
Returns
InputStreamSource 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)

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.
Returns
InputStreamSource 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 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
Returns
InputStreamSource 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 vom Gerät.

Returns
InputStreamSource 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. Der Namespace muss einer der folgenden Werte sein: {"system", "secure", "global"}

Parameter
userId int

namespace String

key String

Returns
String Der Wert, der mit dem Namespace:Schlüssel 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)

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

Parameter
namespace String

key String

Returns
String

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

getUserFlags

public abstract int getUserFlags (int userId)

Sucht die Flags 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

Returns
int Die mit der angegebenen userId verknüpften Flags, falls vorhanden, 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. Löst DeviceRuntimeException aus, 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 dem userId zugeordnete Seriennummer zurück, 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 das Feature gefunden wird, andernfalls „false“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

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

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

Parameter
packageFile File: die zu installierende APK-Datei
reinstall boolean: true, wenn eine Neuinstallation durchgeführt werden soll
extraArgs String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare 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 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“.
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 Sie 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“.
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 Sie 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“.
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.

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

Returns
boolean

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackages

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

Installieren einer Android-Anwendung, die aus mehreren APK-Dateien besteht (ein Hauptpaket 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 : 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“.
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)

Installieren Sie eine Android-Anwendung, 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-Datei 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 : 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“.
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)

Installieren Sie eine Android-Anwendung, 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 : 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“.
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)

Installieren Sie eine Android-Anwendung, 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 : 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“.
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)

Installieren Sie eine Android-Anwendung, 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-Datei in mehrere Dateien aufteilen.

Parameter
remoteApkPaths : die Pfade der Remote-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“.
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)

Installieren Sie eine Android-Anwendung, 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-Datei 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
remoteApkPaths : die Pfade der Remote-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“.
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 auf dem Gerät der monitorlose Systemnutzermodus verwendet wird.

Returns
boolean

Ausgabe
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

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

Returns
boolean

Ausgabe
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

Gibt an, ob mehrere Nutzer unterstützt werden.

Returns
boolean „true“, wenn die Funktion für mehrere Nutzer unterstützt wird, andernfalls „false“
Ausgabe
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 primäre Nutzer 0 verwendet.
Returns
boolean „True“, wenn das Paket als installiert gemeldet wird. ansonsten „falsch“.
Ausgabe
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

Returns
boolean „True“, wenn das Paket als installiert gemeldet wird. ansonsten „falsch“.
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 zurück, ob der angegebene Nutzer anhand seiner 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 Launch-Aktivitäten (in der Regel auf dem Standarddisplay) starten kann.

Parameter
userId int

Returns
boolean

Ausgabe
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

Returns
boolean

Ausgabe
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

Gibt zurück, ob Nutzer auf dem Gerät im Hintergrund in ERROR(/java.android.view.Display#DEFAULT_DISPLAY) sichtbar sein können.

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.

Returns
boolean

Ausgabe
DeviceNotAvailableException

isVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

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

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

listDisplayIds

public abstract  listDisplayIds ()

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

Returns
Die Liste der Displays. „Default“ gibt immer das Standarddisplay 0 zurück.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

Ruft die Liste der Displays ab, 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. Löst DeviceRuntimeException aus, wenn die Ausgabe des Geräts 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 zum Erstellen eines Fehlerberichts und 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.
Returns
boolean „True“, wenn die Protokollierung erfolgreich war, andernfalls „false“.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

Das Gerät wird benachrichtigt, dass es auf den Abschluss von „snapuserd“ warten soll.

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

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 erfolgreich entfernt wurde, andernfalls „false“.
Ausgabe
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 als Geräteinhaber.
userId int: des Nutzers, in dem der Geräteinhaber lebt.
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)

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

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)

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

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit beendet 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 „true“, wenn der Nutzer erfolgreich 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 beendet 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.
Returns
boolean „true“, wenn der Nutzer erfolgreich 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 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.
Returns
boolean true, wenn der Nutzer erfolgreich im Hintergrund gestartet wurde.
Ausgabe
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.
Returns
boolean „true“, 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 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 wurde.
forceFlag boolean: Der Nutzer wird zum Beenden gezwungen.
Returns
boolean „true“, wenn der Nutzer erfolgreich gestoppt wurde.
Ausgabe
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

Returns
boolean „True“, wenn die neue User-ID mit dem User-ID-Anbieter übereinstimmt. ansonsten „falsch“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

Wechseln Sie innerhalb des angegebenen Zeitlimits zu einer anderen Nutzer-ID. Versuche, Keyguard zu deaktivieren, nachdem der Nutzerwechsel erfolgreich war.

Parameter
userId int

timeout long: Die Wartezeit, bevor „false“ für „switch-user failed“ zurückgegeben wird.
Returns
boolean „True“, wenn die neue User-ID mit dem User-ID-Anbieter übereinstimmt. ansonsten „falsch“.
Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

Erstellt einen Fehlerbericht und gibt ihn in einem Bugreport-Objekt zurück, um ihn zu verarbeiten. Gibt bei Problemen „null“ zurück. Dateien, auf die im Bugreport-Objekt verwiesen wird, müssen über Bugreport.close() bereinigt werden.

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

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.
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 gegebenenfalls, bis snapuserd abgeschlossen ist.

Parameter
currentPhase SnapuserdWaitPhase

Ausgabe
DeviceNotAvailableException