ITestDevice

public interface ITestDevice
implements INativeDevice

com.android.tradefed.device.ITestDevice

Bekannte indirekte Unterklassen IManagedTestDevice, LocalAndroidVirtualDevice, ManagedRemoteDevice, NativeDevice, NestedRemoteDevice, RemoteAndroidDevice, RemoteAndroidVirtualDevice, TestDevice IManagedTestDevice Ein ITestDevice, dessen Lebenszyklus verwaltet wird.  LocalAndroidVirtualDevice Die Klasse für lokale virtuelle Geräte, die auf dem TradeFed-Host ausgeführt werden.  ManagedRemoteDevice Ein Gerät, das in einer virtuellen Maschine ausgeführt wird, die wir per Fernzugriff über eine Tradefed-Instanz innerhalb der VM verwalten.  NativeDevice Standardimplementierung eines ITestDevice nicht vollständigen Stacks für Android-Geräte.  NestedRemoteDevice Darstellung des Geräts, das in einer Remote-Cuttlefish-VM ausgeführt wird.  Remote-Android-Gerät Implementierung einer ITestDevice für ein Full-Stack-Android-Gerät, das über ADB Connect verbunden wird.  RemoteAndroidVirtualDevice Erweitert das Verhalten von RemoteAndroidDevice für ein Full-Stack-Android-Gerät, das in der Google Compute Engine (GCE) ausgeführt wird.  Testgerät Implementierung von ITestDevice für ein Full-Stack-Android-Gerät

---

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

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

Zusammenfassung

Verschachtelte Klassen
class	ITestDevice.ApexInfo Eine einfache Strukturklasse zum Speichern von Informationen zu einer einzelnen APEX
class	ITestDevice.MountPointInfo Eine einfache Strukturklasse zum Speichern von Informationen zu einem einzelnen Bereitstellungspunkt

Öffentliche Methoden
abstract boolean	canSwitchToHeadlessSystemUser() Gibt zurück, ob ein 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äteoberfläche angezeigt werden.
abstract void	clearLastConnectedWifiNetwork() Das zuletzt verbundene WLAN wird gelöscht.
abstract boolean	connectToWifiNetwork( wifiSsidToPsk) Verbindet sich mit einem WLAN.
abstract boolean	connectToWifiNetwork( wifiSsidToPsk, boolean scanSsid) Stellt eine WLAN-Verbindung her.
abstract boolean	connectToWifiNetwork(String wifiSsid, String wifiPsk) Stellt eine WLAN-Verbindung her.
abstract boolean	connectToWifiNetwork(String wifiSsid, String wifiPsk, boolean scanSsid) Verbindet sich mit einem WLAN.
abstract boolean	connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk, boolean scanSsid) Eine Variante von connectToWifiNetwork(String, String), die nur dann eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.
abstract boolean	connectToWifiNetworkIfNeeded(String wifiSsid, String wifiPsk) Eine Variante von connectToWifiNetwork(String, String), die nur eine Verbindung herstellt, wenn das Gerät derzeit keine Netzwerkverbindung hat.
abstract int	createUser(String name) Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
abstract int	createUser(String name, boolean guest, boolean ephemeral) Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen
abstract int	createUser(String name, boolean guest, boolean ephemeral, boolean forTesting) Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen
abstract int	createUserNoThrow(String name) Erstellen Sie einen Nutzer mit einem bestimmten Namen und den Standard-Flags 0.
abstract void	deregisterDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver) Entfernt die registrierte IDeviceActionReceiver.
abstract void	disableKeyguard() Es wird versucht, den Keyguard zu deaktivieren.
abstract boolean	disableNetworkMonitor() Deaktiviert die Netzwerküberwachung auf dem Gerät.
abstract boolean	disconnectFromWifi() Trennt die Verbindung zum WLAN.
abstract boolean	doesFileExist(String deviceFilePath, int userId) Hilfsmethode, um zu ermitteln, ob eine Datei auf dem Gerät für einen bestimmten Nutzer vorhanden ist.
abstract File	dumpHeap(String process, String devicePath) Versuchen Sie, den Heap aus dem system_server zu dumpen.
abstract boolean	enableNetworkMonitor() Aktiviert die Netzwerküberwachung auf dem Gerät.
abstract	getActiveApexes() Ruft die Informationen zu den auf dem Gerät aktivierten APEX-Objekten ab.
abstract	getAllSettings(String namespace) Gibt Schlüssel/Wert-Paare des angeforderten Namespace zurück.
abstract String	getAndroidId(int userId) Die mit einer Nutzer-ID verknüpfte Android-ID suchen und zurückgeben. Wenn sie nicht gefunden wird, wird „null“ zurückgegeben.
abstract	getAndroidIds() Erstellen Sie eine Zuordnungstabelle mit den gefundenen Android-IDs und den zugehörigen User-IDs.
abstract PackageInfo	getAppPackageInfo(String packageName) Ruft Informationen zu einem auf dem Gerät installierten Paket ab.
abstract	getAppPackageInfos() Ruft Informationen zu auf dem Gerät installierten Paketen ab.
abstract InputStreamSource	getBugreport() Ruft einen Fehlerbericht vom Gerät ab.
abstract InputStreamSource	getBugreportz() Ruft einen Fehlerbericht vom Gerät ab.
abstract DeviceFoldableState	getCurrentFoldableState() Gibt den aktuellen Faltstatus des Geräts zurück oder „null“, wenn Probleme aufgetreten sind.
abstract int	getCurrentUser() Gibt die ID des aktuell laufenden Nutzers zurück.
abstract	getFoldableStates() Gibt die Liste der Status des faltbaren Geräts zurück.
abstract	getInstalledPackageNames() Ruft die Namen der Anwendungspakete auf dem Gerät ab.
abstract String	getIpAddress() Ruft die IP-Adresse des Geräts ab.
abstract KeyguardControllerState	getKeyguardState() Gib ein Objekt zurück, um den aktuellen Status des Sperrbildschirms abzurufen, oder „null“, wenn er nicht unterstützt wird.
abstract Integer	getMainUserId() Gibt die Hauptnutzer-ID zurück.
abstract	getMainlineModuleInfo() Rufen Sie die Informationen zu den auf dem Gerät installierten Mainline-Modulen ab.
abstract int	getMaxNumberOfRunningUsersSupported() Die maximale Anzahl der gleichzeitig unterstützten Nutzer abrufen
abstract int	getMaxNumberOfUsersSupported() Rufen Sie die maximale Anzahl der unterstützten Nutzer ab.
abstract TestDeviceOptions	getOptions() Rufen Sie die Testoptionen für das Gerät ab.
abstract Integer	getPrimaryUserId() Gibt die primäre Nutzer-ID zurück.
abstract InputStreamSource	getScreenshot(String format, boolean rescale) Erstellt einen Screenshot auf dem Gerät.
abstract InputStreamSource	getScreenshot(long displayId) Erstellt einen Screenshot von der angegebenen Anzeige-ID des Geräts.
abstract InputStreamSource	getScreenshot(String format) Erstellt einen Screenshot auf dem Gerät.
abstract InputStreamSource	getScreenshot() Erstellt einen Screenshot auf dem Gerät.
abstract String	getSetting(int userId, String namespace, String key) Gibt den Wert der angeforderten Einstellung zurück.
abstract String	getSetting(String namespace, String key) Siehe getSetting(int, String, String) und wird auf den Systemnutzer angewendet.
abstract	getUninstallablePackageNames() Rufen Sie die Namen der Anwendungspakete ab, die deinstalliert werden können.
abstract int	getUserFlags(int userId) Die Markierungen eines bestimmten Nutzers finden und zurückgeben.
abstract	getUserInfos() Ruft die Zuordnung von „useId“ zu „UserInfo“ auf dem Gerät ab.
abstract int	getUserSerialNumber(int userId) Gibt die Seriennummer zurück, die der userId zugeordnet ist, wenn sie gefunden wird; in allen anderen Fällen -10000.
abstract boolean	hasFeature(String feature) Prüfen, ob eine Funktion auf einem Gerät verfügbar ist
abstract String	installPackage(File packageFile, boolean reinstall, String... extraArgs) Installieren Sie ein Android-Paket auf dem Gerät.
abstract String	installPackage(File packageFile, boolean reinstall, boolean grantPermissions, String... extraArgs) Installieren Sie ein Android-Paket auf dem Gerät.
abstract String	installPackageForUser(File packageFile, boolean reinstall, int userId, String... extraArgs) Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer
abstract String	installPackageForUser(File packageFile, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Installieren eines Android-Pakets auf dem Gerät für einen bestimmten Nutzer
default String	installPackages( packageFiles, boolean reinstall, String... extraArgs) Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen Split-Paket)
default String	installPackages( packageFiles, boolean reinstall, boolean grantPermissions, String... extraArgs) Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen Split-Paket), die sich auf dem Android-Gerät befinden
default String	installPackagesForUser( packageFiles, boolean reinstall, int userId, String... extraArgs) Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen unterteilten Paket) für einen bestimmten Nutzer
default String	installPackagesForUser( packageFiles, boolean reinstall, boolean grantPermissions, int userId, String... extraArgs) Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen unterteilten Paket) für einen bestimmten Nutzer
default String	installRemotePackages( remoteApkPaths, boolean reinstall, String... extraArgs) Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen Split-Paket), die sich auf dem Android-Gerät befinden
default String	installRemotePackages( remoteApkPaths, boolean reinstall, boolean grantPermissions, String... extraArgs) Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen Split-Paket), die sich auf dem Android-Gerät befinden
abstract boolean	isHeadlessSystemUserMode() Gibt an, ob auf dem Gerät der headless Systemnutzermodus verwendet wird.
abstract boolean	isMainUserPermanentAdmin() Gibt an, ob der Hauptnutzer ein dauerhafter Administrator ist und nicht gelöscht oder auf den Status „Kein Administrator“ herabgestuft werden kann.
abstract boolean	isMultiUserSupported() Bestimmt, ob die Nutzung durch mehrere Nutzer unterstützt wird.
abstract boolean	isPackageInstalled(String packageName, String userId) Das Gerät nach einem bestimmten Paketnamen und einer bestimmten Nutzer-ID abfragen, um zu prüfen, ob es für diesen Nutzer derzeit installiert ist oder nicht.
abstract boolean	isPackageInstalled(String packageName) Das Gerät wird nach einem bestimmten Paketnamen abgefragt, um zu prüfen, ob es derzeit installiert ist.
abstract boolean	isUserRunning(int userId) Prüfen, ob ein bestimmter Nutzer aktiv ist
abstract boolean	isUserSecondary(int userId) Gibt zurück, ob der angegebene Nutzer gemäß seinen Flags ein sekundärer Nutzer ist.
abstract boolean	isUserVisible(int userId) Prüft, ob der angegebene Nutzer sichtbar ist.
abstract boolean	isUserVisibleOnDisplay(int userId, int displayId) Prüft, ob der angegebene Nutzer im angegebenen Display sichtbar ist.
abstract boolean	isVisibleBackgroundUsersOnDefaultDisplaySupported() Gibt an, ob Nutzer auf dem Gerät im ERROR(/java.android.view.Display#DEFAULT_DISPLAY) im Hintergrund gestartet werden können.
abstract boolean	isVisibleBackgroundUsersSupported() Gibt an, ob auf dem Gerät Nutzer gestartet werden können, die im Hintergrund sichtbar sind.
abstract boolean	isWifiEnabled() Prüfen, ob WLAN aktiviert ist
abstract	listDisplayIds() Liste der verfügbaren Display-IDs auf dem Gerät erfassen, wie von „dumpsys SurfaceFlinger“ gemeldet
abstract	listDisplayIdsForStartingVisibleBackgroundUsers() Ruft die Liste der Bildschirme ab, die zum start a user visible in the background verwendet werden können.
abstract	listUsers() Ruft die Liste der Nutzer auf dem Gerät ab.
abstract boolean	logBugreport(String dataName, ITestLogger listener) Hilfsmethode, um einen Fehlerbericht zu erstellen und an die Meldenden zu senden.
default void	notifySnapuserd(SnapuserdWaitPhase waitPhase) Das Gerät wird angewiesen, auf den Abschluss von snapuserd zu warten.
abstract void	registerDeviceActionReceiver(IDeviceActionReceiver deviceActionReceiver) Registriert eine IDeviceActionReceiver für dieses Gerät.
abstract boolean	removeAdmin(String componentName, int userId) Entfernt den angegebenen Geräteadministrator beim angegebenen Nutzer und gibt true zurück, wenn der Vorgang erfolgreich war, andernfalls false.
abstract void	removeOwners() Entfernen Sie alle vorhandenen Inhaber von Geräteprofilen nach Möglichkeit.
abstract boolean	removeUser(int userId) Einen bestimmten Nutzer vom Gerät entfernen
abstract boolean	setDeviceOwner(String componentName, int userId) Eine Geräteadministratorkomponente als Geräteinhaber für den angegebenen Nutzer festlegen
abstract void	setSetting(String namespace, String key, String value) Siehe setSetting(int, String, String, String) und wird bei einem Systemnutzer ausgeführt.
abstract void	setSetting(int userId, String namespace, String key, String value) Dem Namespace eines bestimmten Nutzers einen Einstellungswert hinzufügen.
abstract boolean	startUser(int userId) Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist.
abstract boolean	startUser(int userId, boolean waitFlag) Startet einen bestimmten Nutzer im Hintergrund, wenn er derzeit angehalten ist.
abstract boolean	startVisibleBackgroundUser(int userId, int displayId, boolean waitFlag) Startet einen bestimmten Nutzer im Hintergrund, der auf dem jeweiligen Bildschirm sichtbar ist (d.h., der Nutzer kann Aktivitäten auf dieser Anzeige starten).
abstract boolean	stopUser(int userId) Stoppt einen bestimmten Nutzer.
abstract boolean	stopUser(int userId, boolean waitFlag, boolean forceFlag) Einen bestimmten Nutzer anhalten.
abstract boolean	switchUser(int userId) Wechseln Sie zu einer anderen userId mit einer Standardzeitüberschreitung.
abstract boolean	switchUser(int userId, long timeout) Wechseln Sie zu einer anderen Nutzer-ID mit dem angegebenen Zeitlimit als Frist.
abstract Bugreport	takeBugreport() Nimmt einen Fehlerbericht entgegen und gibt ihn in einem Bugreport-Objekt zurück, um ihn zu verarbeiten.
abstract String	uninstallPackage(String packageName) Android-Paket vom Gerät deinstallieren
abstract String	uninstallPackageForUser(String packageName, int userId) Deinstallation eines Android-Pakets von einem Gerät für einen bestimmten Nutzer
default void	waitForSnapuserd(SnapuserdWaitPhase currentPhase) Warten Sie gegebenenfalls, bis „snapuserd“ abgeschlossen ist.

Öffentliche Methoden

canSwitchToHeadlessSystemUser

public abstract boolean canSwitchToHeadlessSystemUser ()

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

Returns
boolean

Ausgabe
DeviceNotAvailableException

checkConnectivity

public abstract boolean checkConnectivity ()

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

Returns
boolean	true, wenn das Gerät eine funktionierende Netzwerkverbindung hat, false.

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

clearErrorDialogs

public abstract boolean clearErrorDialogs ()

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

Returns
boolean	true, wenn keine Dialogfelder vorhanden waren oder die Dialogfelder erfolgreich gelöscht wurden. Andernfalls false.

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

clearLastConnectedWifiNetwork

public abstract void clearLastConnectedWifiNetwork ()

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

mit Wifi-Netzwerk verbinden

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk)

Verbindet sich mit einem WLAN.

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

Parameter
wifiSsidToPsk	: Eine Zuordnung von WLAN-SSIDs zu Passwörtern.

Returns
boolean	true, wenn eine Verbindung zum WLAN hergestellt wurde. false otherwise

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork ( wifiSsidToPsk, 
                boolean scanSsid)

Verbindet sich mit einem WLAN.

Das WLAN wird aktiviert und blockiert, bis eine Verbindung zu einem der in der wifiSsidToPsk-Karte angegebenen WLAN-Netzwerke hergestellt wurde. Sobald eine Verbindung hergestellt wurde, versucht die Instanz nach jedem Neustart, die Verbindung wiederherzustellen, bis ITestDevice#disconnectFromWifi() oder ITestDevice#clearLastConnectedWifiNetwork() aufgerufen wird.

Parameter
wifiSsidToPsk	: Eine Zuordnung der WLAN-SSIDs zu Passwörtern.
scanSsid	boolean: Gibt an, ob nach ausgeblendeten SSIDs für dieses Netzwerk gesucht werden soll.

Returns
boolean	true, wenn eine Verbindung zum WLAN hergestellt wurde. false otherwise

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

connectToWifiNetwork

public abstract boolean connectToWifiNetwork (String wifiSsid, 
                String wifiPsk)

Verbindet sich mit einem WLAN.

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

Parameter
wifiSsid	String: Die WLAN-SSID, mit der eine Verbindung hergestellt werden soll
wifiPsk	String: PSK-Passphrase oder „null“, wenn nicht verschlüsselt

Returns
boolean	true, wenn eine Verbindung zum WLAN hergestellt wurde. false andernfalls

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

connectToWifiNetwork

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

Verbindet sich mit einem WLAN.

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

Parameter
wifiSsid	String: Die WLAN-SSID, mit der eine Verbindung hergestellt werden soll
wifiPsk	String: PSK-Passphrase oder „null“, wenn nicht verschlüsselt
scanSsid	boolean: Gibt an, ob nach ausgeblendeten SSIDs für dieses Netzwerk gesucht werden soll.

Returns
boolean	true, wenn eine Verbindung zum WLAN hergestellt wurde. false andernfalls

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

Verbindung mit WLAN-Netzwerk herstellen (falls erforderlich)

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

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

Parameter
scanSsid	boolean: Ob nach ausgeblendeten SSIDs für dieses Netzwerk gesucht werden soll

Returns
boolean	true, wenn eine Verbindung zum WLAN hergestellt wurde. false andernfalls

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

connectToWifiNetworkIfNeeded

public abstract boolean connectToWifiNetworkIfNeeded (String wifiSsid, 
                String wifiPsk)

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

Returns
boolean	true, wenn eine Verbindung zum WLAN hergestellt wurde. false andernfalls

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

public abstract int createUser (String name)

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

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

Returns
int	Die Ganzzahl für die erstellte Nutzer-ID

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

Parameter
name	String: des Nutzers, der auf dem Gerät erstellt werden soll
guest	boolean: aktiviert das Nutzer-Flag --guest während der Erstellung.
ephemeral	boolean: aktiviert das Nutzer-Flag „--sitzungsspezifisch“ beim Erstellen

Returns
int	ID des erstellten Nutzers

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUser

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

Nutzer mit einem bestimmten Namen und den angegebenen Flags erstellen

Parameter
name	String: des Nutzers, der auf dem Gerät erstellt werden soll
guest	boolean: aktiviert das Nutzer-Flag --guest während der Erstellung.
ephemeral	boolean: aktiviert das Nutzer-Flag „--sitzungsspezifisch“ beim Erstellen
forTesting	boolean: aktiviert das Test-Flag „--for-testing“ beim Erstellen

Returns
int	ID des erstellten Nutzers

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

createUserNoThrow

public abstract int createUserNoThrow (String name)

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

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

Returns
int	Die Ganzzahl für die erstellte User-ID oder -1 für einen Fehler.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

deregisterDeviceActionReceiver

public abstract void deregisterDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Entfernt die registrierte IDeviceActionReceiver.

Parameter
deviceActionReceiver	IDeviceActionReceiver: Ein IDeviceActionReceiver, das entfernt wird.

disableKeyguard

public abstract void disableKeyguard ()

Versucht, den Keyguard zu deaktivieren.

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

Ausgabe
DeviceNotAvailableException

disableNetworkMonitor

public abstract boolean disableNetworkMonitor ()

Deaktiviert die Netzwerküberwachung auf dem Gerät.

Returns
boolean	true, wenn das Monitoring erfolgreich deaktiviert wurde. false , wenn der Vorgang fehlgeschlagen ist.

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

disconnectFromWifi

public abstract boolean disconnectFromWifi ()

Trennen Sie die Verbindung zu einem WLAN.

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

Returns
boolean	true, wenn die Verbindung zum WLAN getrennt wurde. false, wenn die Verbindung nicht getrennt werden konnte.

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

doesFileExist

public abstract boolean doesFileExist (String deviceFilePath, 
                int userId)

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

Parameter
deviceFilePath	String: Der absolute Pfad der Datei auf dem Gerät, die geprüft werden soll.
userId	int: Die Nutzer-ID, anhand derer die Datei geprüft werden soll

Returns
boolean	true, wenn die Datei vorhanden ist, andernfalls false.

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

dumpHeap

public abstract File dumpHeap (String process, 
                String devicePath)

Versuchen Sie, den Heap aus dem system_server zu dumpen. Der Aufrufer ist für die Bereinigung der Dumpdatei verantwortlich.

Parameter
process	String: Der Name des Geräteprozesses, auf dem der Dumpheap 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	den ERROR(/File), der den Bericht enthält. Null, wenn ein Fehler aufgetreten ist.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

enableNetworkMonitor

public abstract boolean enableNetworkMonitor ()

Aktiviert die Netzwerküberwachung auf dem Gerät.

Returns
boolean	true, wenn das Monitoring erfolgreich aktiviert wurde. false , wenn der Vorgang fehlgeschlagen ist.

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

getActiveApexes

public abstract  getActiveApexes ()

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

Returns
	ERROR(/Set) von ApexInfo derzeit auf dem Gerät aktiviert

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAllSettings

public abstract  getAllSettings (String namespace)

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

Parameter
namespace	String: muss einer dieser 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 (GetAndroid-ID)

public abstract String getAndroidId (int userId)

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

Parameter
userId	int

Returns
String

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAndroidIds

public abstract  getAndroidIds ()

Erstellen Sie eine Zuordnungstabelle mit den gefundenen Android-IDs und den zugehörigen User-IDs. Es gibt keine Versicherung, dass jede Nutzer-ID eine Android-ID findet, die mit dieser Funktion verknüpft ist. Daher können einige Nutzer-IDs mit „null“ übereinstimmen.

Returns
	Zuordnung von Android-IDs zu Nutzer-IDs.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfo

public abstract PackageInfo getAppPackageInfo (String packageName)

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

Parameter
packageName	String

Returns
PackageInfo	PackageInfo oder null, wenn keine Informationen abgerufen werden konnten

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getAppPackageInfos

public abstract  getAppPackageInfos ()

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

Returns
	ERROR(/List) von PackageInfo s auf dem Gerät installiert.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getBugreport

public abstract InputStreamSource getBugreport ()

Ruft einen Fehlerbericht vom Gerät ab.

Die Implementierung funktioniert garantiert auch auf einem Gerät ohne SD-Karte oder wenn die SD-Karte noch nicht bereitgestellt wurde.

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

getBugreportz

public abstract InputStreamSource getBugreportz ()

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

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

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

getCurrentFoldableState

public abstract DeviceFoldableState getCurrentFoldableState ()

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

Returns
DeviceFoldableState

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getCurrentUser

public abstract int getCurrentUser ()

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

Returns
int

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getFoldableStates

public abstract  getFoldableStates ()

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

Returns

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getInstalledPackageNames

public abstract  getInstalledPackageNames ()

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

Returns
	ERROR(/Set) von String Paketnamen, die derzeit auf dem Gerät installiert sind.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getIpAddress

public abstract String getIpAddress ()

Ruft die IP-Adresse des Geräts ab.

Returns
String	die IP-Adresse des Geräts oder null, wenn das Gerät keine IP-Adresse hat

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

getKeyguardState

public abstract KeyguardControllerState getKeyguardState ()

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

Returns
KeyguardControllerState	Eine KeyguardControllerState mit einem Snapshot des Status des Keyguard und gibt Null zurück, wenn die Keyguard-Abfrage nicht unterstützt wird.

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

getMainUserId

public abstract Integer getMainUserId ()

Gibt die Hauptnutzer-ID zurück.

Returns
Integer	Die userId des Hauptnutzers, falls vorhanden, und null, wenn es keinen Hauptnutzer gibt

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

getMainlineModuleInfo

public abstract  getMainlineModuleInfo ()

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

Returns
	Derzeit sind ERROR(/Set) von String Mainline-Modulen auf dem Gerät installiert.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfRunningUsersSupported

public abstract int getMaxNumberOfRunningUsersSupported ()

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

Returns
int	eine Ganzzahl, die die Anzahl der gleichzeitig ausgeführten Nutzer angibt

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getMaxNumberOfUsersUnterstützt

public abstract int getMaxNumberOfUsersSupported ()

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

Returns
int	eine Ganzzahl, die die Anzahl der unterstützten Nutzer angibt

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getOptions

public abstract TestDeviceOptions getOptions ()

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

Returns
TestDeviceOptions	TestDeviceOptions zum Testgerät.

getPrimaryUserId (Primäre Nutzer-ID)

public abstract Integer getPrimaryUserId ()

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

Returns
Integer	die userId des Hauptnutzers, falls vorhanden, andernfalls „null“.

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

getScreenshot

public abstract InputStreamSource getScreenshot (String format, 
                boolean rescale)

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

Parameter
format	String: unterstützt PNG, JPEG
rescale	boolean: Gibt an, ob der Screenshot neu skaliert werden soll, um die Größe des resultierenden Bildes zu verringern.

Returns
InputStreamSource	einen InputStreamSource des Screenshots im Format oder null, wenn der Screenshot nicht erfolgreich war.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (long displayId)

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

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

Parameter
displayId	long: Die Display-ID des Bildschirms, von dem ein Screenshot erstellt werden soll.

Returns
InputStreamSource	einen InputStreamSource des Screenshots im Format oder null, wenn der Screenshot nicht erfolgreich war.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getScreenshot

public abstract InputStreamSource getScreenshot (String format)

Erstellt einen Screenshot vom Gerät. Stattdessen wird empfohlen, getScreenshot(format) mit JPEG-Codierung zu verwenden, um eine kleinere Dateigröße zu erzielen.

Parameter
format	String: unterstützt PNG, JPEG

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

Returns
InputStreamSource	einen InputStreamSource des Screenshots im PNG-Format oder null, wenn der Screenshot nicht erfolgreich war.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

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

Gibt den Wert der angeforderten Einstellung zurück. namespace muss eine der folgenden Optionen sein: {"system", "secure", "global"}

Parameter
userId	int
namespace	String
key	String

Returns
String	Der Wert, der mit dem namespace:key eines Nutzers verknüpft ist. Null, wenn nicht gefunden.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getSetting

public abstract String getSetting (String namespace, 
                String key)

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

Parameter
namespace	String
key	String

Returns
String

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUninstallablePackageNames

public abstract  getUninstallablePackageNames ()

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

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

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserFlags

public abstract int getUserFlags (int userId)

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

Parameter
userId	int

Returns
int	die mit der angegebenen Nutzer-ID verknüpften Flags, falls gefunden, andernfalls -10000.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

getUserInfos

public abstract  getUserInfos ()

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

Returns
	die Liste der UserInfo-Objekte.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

getUserSerialNumber

public abstract int getUserSerialNumber (int userId)

Gibt die Seriennummer zurück, die mit der userId verknüpft ist, falls gefunden, andernfalls -10000.

Parameter
userId	int

Returns
int

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

hasFeature

public abstract boolean hasFeature (String feature)

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

Parameter
feature	String: Das Format sollte „feature:“ oder direkt „“ sein.

Returns
boolean	„True“, wenn die Funktion gefunden wird, andernfalls „false“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

installPackage

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

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

Parameter
packageFile	File: die zu installierende APK-Datei
reinstall	boolean: true, wenn eine Neuinstallation durchgeführt werden soll
extraArgs	String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.

Returns
String	String mit einem Fehlercode oder null bei Erfolg.

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

installPackage

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

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

Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, in denen das Gewähren einer Laufzeitberechtigung zum Zeitpunkt der Installation explizit kontrolliert werden muss.

Parameter
packageFile	File: die zu installierende APK-Datei
reinstall	boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions	boolean: wenn bei der Installation alle Laufzeitberechtigungen gewährt werden sollen
extraArgs	String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.

Returns
String	einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.

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

installPackageForUser

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

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

Parameter
packageFile	File: die zu installierende APK-Datei
reinstall	boolean: true, wenn eine Neuinstallation durchgeführt werden soll
userId	int: die ganzzahlige Nutzer-ID, für die die Installation 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	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

installPackageForUser

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

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

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

Parameter
packageFile	File: die zu installierende APK-Datei
reinstall	boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions	boolean: ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen
userId	int: Die Ganzzahl-Nutzer-ID, für die die Installation erfolgen soll.
extraArgs	String: Optionale zusätzliche Argumente, die übergeben werden sollen. 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, 
                String... extraArgs)

Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen Split-Paket) Unter „https://developer.android.com/studio/build/configure-apk-splits“ erfährst du, wie du eine APK-Datei auf mehrere Dateien aufteilen kannst.

Parameter
packageFiles	: die lokalen APK-Dateien
reinstall	boolean: true, wenn eine Neuinstallation durchgeführt werden soll
extraArgs	String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.

Returns
String	String mit einem Fehlercode oder null bei Erfolg.

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

installPackages

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

Installation einer Android-Anwendung aus mehreren APK-Dateien (einem Haupt- und zusätzlichen Split-Paket), die sich auf dem Android-Gerät befinden Unter „https://developer.android.com/studio/build/configure-apk-splits“ erfährst du, wie du eine APK-Datei auf mehrere Dateien aufteilen kannst.

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

Parameter
packageFiles	: die zu installierenden Remote-APK-Dateipfade
reinstall	boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions	boolean: wenn bei der Installation alle Laufzeitberechtigungen gewährt werden sollen
extraArgs	String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.

Returns
String	String mit einem Fehlercode oder null bei Erfolg.

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

installPackagesForUser

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

Installiere für einen bestimmten Nutzer eine Android-App, die aus mehreren APK-Dateien besteht (eines Hauptpakets und eines zusätzlichen aufgeteilten Pakets). Informationen zum Aufteilen einer APK-Datei auf mehrere Dateien findest du unter „https://developer.android.com/studio/build/configure-apk-splits“.

Parameter
packageFiles	: die lokalen APK-Dateien
reinstall	boolean: true, wenn eine Neuinstallation durchgeführt werden soll
userId	int: die ganzzahlige Nutzer-ID, für die die Installation durchgeführt werden soll.
extraArgs	String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“.

Returns
String	einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.

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

installPackagesForUser

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

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

Hinweis: Diese Funktion sollte nur in Anwendungsfällen aufgerufen werden, in denen das Gewähren einer Laufzeitberechtigung zum Zeitpunkt der Installation explizit kontrolliert werden muss.

Parameter
packageFiles	: die lokalen APK-Dateien
reinstall	boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions	boolean: ob alle Laufzeitberechtigungen bei der Installation gewährt werden sollen
userId	int: Die Ganzzahl-Nutzer-ID, für die die Installation erfolgen soll.
extraArgs	String: Optionale zusätzliche Argumente, die übergeben werden sollen. Verfügbare Optionen finden Sie unter „adb shell pm -h“.

Returns
String	einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.

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

installRemotePackages

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

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

Parameter
remoteApkPaths	: die Pfade zu den Remote-APK-Dateien
reinstall	boolean: true, wenn eine Neuinstallation durchgeführt werden soll
extraArgs	String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.

Returns
String	einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.

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

installRemotePackages

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

Installation einer Android-Anwendung, 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 zum Aufteilen der APK in mehrere Dateien.

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

Parameter
remoteApkPaths	: die Pfade zu den Remote-APK-Dateien
reinstall	boolean: true, wenn eine Neuinstallation durchgeführt werden soll
grantPermissions	boolean: wenn bei der Installation alle Laufzeitberechtigungen gewährt werden sollen
extraArgs	String: Optionale zusätzliche Argumente, die übergeben werden sollen. Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm -h“.

Returns
String	einen String mit einem Fehlercode oder null, wenn der Vorgang erfolgreich ist.

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

isHeadlessSystemUserMode

public abstract boolean isHeadlessSystemUserMode ()

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

Returns
boolean

Ausgabe
DeviceNotAvailableException

isMainUserPermanentAdmin

public abstract boolean isMainUserPermanentAdmin ()

Gibt zurück, ob der Hauptnutzer ein dauerhafter Administrator ist und weder gelöscht noch auf einen Nicht-Administratorstatus herabgestuft werden kann.

Returns
boolean

Ausgabe
DeviceNotAvailableException

isMultiUserSupported

public abstract boolean isMultiUserSupported ()

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

Returns
boolean	„true“, wenn mehrere Nutzer unterstützt werden, andernfalls „false“

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName, 
                String userId)

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

Parameter
packageName	String: Paket, für das geprüft wird, ob es installiert ist.
userId	String: Die Nutzer-ID, für die geprüft wird, ob das Paket installiert ist. Wenn „null“ festgelegt ist, wird „0“ für den Hauptnutzer verwendet.

Returns
boolean	„Wahr“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isPackageInstalled

public abstract boolean isPackageInstalled (String packageName)

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

Parameter
packageName	String

Returns
boolean	„Wahr“, wenn das Paket als installiert gemeldet wird. Andernfalls „false“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserRunning

public abstract boolean isUserRunning (int userId)

Prüfen, ob ein bestimmter Nutzer aktiv ist

Parameter
userId	int

Returns
boolean	„True“, wenn der Nutzer läuft, andernfalls „False“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserSecondary

public abstract boolean isUserSecondary (int userId)

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

Parameter
userId	int

Returns
boolean	„true“, wenn der Nutzer sekundär ist, andernfalls „false“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

isUserVisible

public abstract boolean isUserVisible (int userId)

Prüft, ob der angegebene Nutzer sichtbar ist.

Ein „sichtbarer“ Nutzer ist ein Nutzer, der mit dem „menschlichen“ Nutzer interagiert und daher Aktivitäten starten kann (in der Regel im Standarddisplay).

Parameter
userId	int

Returns
boolean

Ausgabe
DeviceNotAvailableException

isUserVisibleOnDisplay

public abstract boolean isUserVisibleOnDisplay (int userId, 
                int displayId)

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

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

Parameter
userId	int
displayId	int

Returns
boolean

Ausgabe
DeviceNotAvailableException

isVisibleBackgroundUsersOnDefaultDisplaySupported

public abstract boolean isVisibleBackgroundUsersOnDefaultDisplaySupported ()

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

In diesem Fall könnten Sie startVisibleBackgroundUser(int, int, boolean) aufrufen und eine von listDisplayIdsForStartingVisibleBackgroundUsers() zurückgegebene Anzeige übergeben, die ERROR(/java.android.view.Display#DEFAULT_DISPLAY) enthalten sollte.

Returns
boolean

Ausgabe
DeviceNotAvailableException

IsVisibleBackgroundUsersSupported

public abstract boolean isVisibleBackgroundUsersSupported ()

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

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

Returns
boolean

Ausgabe
DeviceNotAvailableException

isWifiEnabled

public abstract boolean isWifiEnabled ()

Prüfen, ob WLAN aktiviert ist

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

Returns
boolean	true, wenn WLAN aktiviert ist. false, wenn deaktiviert

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

listDisplayIds

public abstract  listDisplayIds ()

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

Returns
	Die Liste der Displays. Standardmäßig wird immer der Standardwert „0“ zurückgegeben.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

listDisplayIdsForStartingVisibleBackgroundUsers

public abstract  listDisplayIdsForStartingVisibleBackgroundUsers ()

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

Returns

Ausgabe
DeviceNotAvailableException

listUsers

public abstract  listUsers ()

Ruft die Liste der Nutzer auf dem Gerät ab. Wird DeviceRuntimeException ausgegeben, wenn die Ausgabe vom Gerät nicht wie erwartet ist.

Returns
	die Liste der Nutzer-IDs.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
	com.android.tradefed.device.DeviceRuntimeException
DeviceNotAvailableException

logBugreport

public abstract boolean logBugreport (String dataName, 
                ITestLogger listener)

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

Parameter
dataName	String: Name, unter dem der Fehlerbericht gemeldet wird.
listener	ITestLogger: einen ITestLogger, um den Fehlerbericht zu protokollieren.

Returns
boolean	„True“, wenn die Protokollierung erfolgreich war, andernfalls „false“.

notifySnapuserd

public void notifySnapuserd (SnapuserdWaitPhase waitPhase)

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

Parameter
waitPhase	SnapuserdWaitPhase

RegisterDeviceActionReceiver

public abstract void registerDeviceActionReceiver (IDeviceActionReceiver deviceActionReceiver)

Registriert eine IDeviceActionReceiver für dieses Gerät.

Alle registrierten IDeviceActionReceivers werden vor 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 beim 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 dessen Land sich der Geräteadministrator befindet.

Returns
boolean	„True“, wenn erfolgreich, andernfalls „false“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Inhaber entfernen

public abstract void removeOwners ()

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

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Nutzer entfernen

public abstract boolean removeUser (int userId)

Einen bestimmten Nutzer vom Gerät entfernen.

Parameter
userId	int: des zu entfernenden Nutzers

Returns
boolean	true , wenn der Nutzer erfolgreich entfernt wurde, andernfalls false.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setDeviceOwner

public abstract boolean setDeviceOwner (String componentName, 
                int userId)

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

Parameter
componentName	String: des Geräteadministrators wird der Geräteeigentümer sein.
userId	int: des Nutzers, in dessen Land sich der Geräteinhaber befindet.

Returns
boolean	„True“, wenn erfolgreich, andernfalls „false“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

setSetting

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

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

Parameter
namespace	String
key	String
value	String

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Einstellung festlegen

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

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

Parameter
userId	int
namespace	String
key	String
value	String

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId)

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

Parameter
userId	int: des Nutzers, der im Hintergrund gestartet werden soll

Returns
boolean	„wahr“, wenn der Nutzer im Hintergrund gestartet wurde.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startUser

public abstract boolean startUser (int userId, 
                boolean waitFlag)

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

Parameter
userId	int: des Nutzers, der im Hintergrund gestartet werden soll
waitFlag	boolean: Der Befehl wartet, bis der Nutzer gestartet und entsperrt ist.

Returns
boolean	„wahr“, wenn der Nutzer im Hintergrund gestartet wurde.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

startVisibleBackgroundUser

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

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

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

Parameter
userId	int: des Nutzers, der im Hintergrund gestartet werden soll
displayId	int: Display, auf dem die Benachrichtigung für Nutzer sichtbar sein soll
waitFlag	boolean: Der Befehl wartet, bis der Nutzer gestartet und entsperrt ist.

Returns
boolean	true, wenn der Nutzer erfolgreich gestartet wurde und im Hintergrund sichtbar ist.

Ausgabe
DeviceNotAvailableException

stopUser

public abstract boolean stopUser (int userId)

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

Parameter
userId	int: des Nutzers, der beendet werden soll.

Returns
boolean	„wahr“, wenn der Nutzer erfolgreich gestoppt wurde.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

stopUser

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

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

Parameter
userId	int: des Nutzers, der beendet werden soll.
waitFlag	boolean: Der Befehl wartet, bis der Nutzer gestoppt wird.
forceFlag	boolean: wird der Nutzer zwangsweise beendet.

Returns
boolean	„wahr“, wenn der Nutzer erfolgreich gestoppt wurde.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId)

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

Parameter
userId	int

Returns
boolean	"True", wenn die neue userId mit dem userId-Anbieter übereinstimmt. Andernfalls „false“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

switchUser

public abstract boolean switchUser (int userId, 
                long timeout)

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

Parameter
userId	int
timeout	long: Warten, bis „false“ für Switch-User zurückgegeben wird.

Returns
boolean	"True", wenn die neue userId mit dem userId-Anbieter übereinstimmt. Andernfalls „false“.

Ausgabe
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

takeBugreport

public abstract Bugreport takeBugreport ()

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

Returns
Bugreport

uninstallPackage

public abstract String uninstallPackage (String packageName)

Android-Paket vom Gerät deinstallieren

Parameter
packageName	String: das zu deinstallierende Android-Paket

Returns
String	String mit einem Fehlercode oder null bei Erfolg.

Ausgabe
DeviceNotAvailableException	Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

deinstallierenPackageForUser

public abstract String uninstallPackageForUser (String packageName, 
                int userId)

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

Parameter
packageName	String: das zu deinstallierende Android-Paket
userId	int: Die Ganzzahl-Nutzer-ID, für die die Deinstallation erfolgen soll.

Returns
String	String mit einem Fehlercode oder null bei Erfolg.

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

WartefürSnapuserd

public void waitForSnapuserd (SnapuserdWaitPhase currentPhase)

Warten Sie, bis snapuserd abgeschlossen ist.

Parameter
currentPhase	SnapuserdWaitPhase

Ausgabe
DeviceNotAvailableException