Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.

Diese Seite wurde von der Cloud Translation API übersetzt.

StubDevice

public class StubDevice
extends Object implements IDevice

java.lang.Object
↳	com.android.tradefed.device.StubDevice

Bekannte direkte Unterklassen

DeviceManager.FastbootDevice, NullDevice, RemoteAvdIDevice, StubLocalAndroidVirtualDevice, VmRemoteDevice

DeviceManager.FastbootDevice	Darstellung eines Geräts im Schnellstartmodus (Fastboot mode).
NullDevice	Ein Platzhalter `IDevice`, der von `DeviceManager` verwendet wird, um die Zuweisung zu bestimmen, wenn `IDeviceSelection.nullDeviceRequested()` `true` ist
RemoteAvdIDevice	Ein Platzhalter `IDevice`, der von `DeviceManager` verwendet wird, um die Zuweisung zu bestimmen, wenn `DeviceSelectionOptions.gceDeviceRequested()` `true` ist
StubLocalAndroidVirtualDevice	Ein Platzhalter `IDevice`, der von `DeviceManager` verwendet wird, um die Zuweisung zu bestimmen, wenn `DeviceSelectionOptions.localVirtualDeviceRequested()` `true` ist
VmRemoteDevice	Ein virtuelles Remote-Gerät, das wir in der virtuellen Maschine verwalten.

Stub-Platzhalterimplementierung eines IDevice.

Zusammenfassung

Öffentliche Konstruktoren
`StubDevice(String serial)`
`StubDevice(String serial, boolean isEmulator)`

Öffentliche Methoden
`boolean`	`arePropertiesSet()` Gibt `true` zurück, wenn Properties im Cache gespeichert wurden.
`void`	`createForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)` Erstellt eine Portweiterleitung zwischen einem lokalen TCP-Port und einem Remote-Unix-Domain-Socket.
`void`	`createForward(int localPort, int remotePort)` Erstellt eine Portweiterleitung zwischen einem lokalen und einem Remote-Port.
`void`	`createReverse(int remotePort, int localPort)` Erstellt eine Portumkehrung zwischen einem Remote- und einem lokalen Port.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Führt einen Shell-Befehl auf dem Gerät aus und sendet das Ergebnis an eine `receiver`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver)` Führt einen Shell-Befehl auf dem Gerät aus und sendet das Ergebnis an eine `receiver`. Dies entspricht dem Aufruf von `executeShellCommand(command, receiver, DdmPreferences.getTimeOut())`.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)` Diese Methode ist veraltet. `executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit)` verwenden.
`void`	`executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits)` Führt einen Shell-Befehl auf dem Gerät aus und sendet das Ergebnis an eine `receiver`.
	`getAbis()` Gibt die von diesem Gerät unterstützten ABIs zurück.
`String`	`getAvdName()` Gibt den Namen des AVD zurück, auf dem der Emulator ausgeführt wird.
`String`	`getAvdPath()` Gibt den absoluten Pfad zum virtuellen Gerät im Dateisystem zurück.
	`getBattery(long freshnessTime, TimeUnit timeUnit)` Gibt den Akkustand des Geräts in Prozent zurück (0 bis 100 %).
	`getBattery()` Gibt den Akkustand des Geräts in Prozent zurück (0 bis 100 %).
`Integer`	`getBatteryLevel(long freshnessMs)` Diese Methode ist veraltet. Verwenden Sie stattdessen `getBattery(long, TimeUnit)`.
`Integer`	`getBatteryLevel()` Diese Methode ist veraltet. Verwenden Sie stattdessen `getBattery()`.
`Client`	`getClient(String applicationName)` Gibt ein `Client` anhand des Anwendungsnamens zurück.
`String`	`getClientName(int pid)` Gibt den Namen des Clients anhand der PID oder `null` zurück, wenn die PID unbekannt ist.
`Client[]`	`getClients()` Gibt das Array von Clients zurück.
`int`	`getDensity()` Gibt den Dichte-Bucket des Gerätebildschirms zurück, indem der Wert für die Systemeigenschaft `PROP_DEVICE_DENSITY` gelesen wird.
`FileListingService`	`getFileListingService()` Gibt eine `FileListingService` für dieses Gerät zurück.
`String`	`getLanguage()` Gibt die Sprache des Nutzers zurück.
`String`	`getMountPoint(String name)` Gibt einen Bereitstellungspunkt zurück.
`String`	`getName()` Gibt einen (lesbaren) Namen für dieses Gerät zurück.
	`getProperties()` Diese Methode ist veraltet. Verwenden Sie stattdessen `getSystemProperty(String)`.
`String`	`getProperty(String name)` Praktische Methode, die versucht, eine Property über `IShellEnabledDevice.getSystemProperty(String)` mit einer sehr kurzen Wartezeit abzurufen, und Ausnahmen abfängt.
`String`	`getPropertyCacheOrSync(String name)` Diese Methode ist veraltet. Verwenden Sie stattdessen `getProperty(String)`.
`int`	`getPropertyCount()` Diese Methode ist veraltet. in ddmlib mit dem Grund „Implementierungsdetail“ als veraltet markiert.
`String`	`getPropertySync(String name)` Diese Methode ist veraltet. Verwenden Sie stattdessen `getProperty(String)`.
`String`	`getRegion()` Gibt die Region des Nutzers zurück.
`RawImage`	`getScreenshot()` Erstellt einen Screenshot des Geräts und gibt ihn als `RawImage` zurück.
`RawImage`	`getScreenshot(long timeout, TimeUnit unit)`
`String`	`getSerialNumber()` Gibt die Seriennummer des Geräts zurück.
`IDevice.DeviceState`	`getState()` Gibt den Status des Geräts zurück.
`SyncService`	`getSyncService()` Gibt ein `SyncService`-Objekt zurück, um Dateien auf das Gerät zu übertragen und vom Gerät abzurufen.
`ListenableFuture<String>`	`getSystemProperty(String name)` Führen Sie eine potenzielle asynchrone Abfrage für eine Systemeigenschaft durch.
`boolean`	`hasClients()` Gibt zurück, ob `IDevice` `Client` enthält.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` Installiert eine Android-App auf dem Gerät.
`void`	`installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Installiert eine Android-App auf dem Gerät.
`void`	`installPackage(String packageFilePath, boolean reinstall, String... extraArgs)` Installiert eine Android-App auf dem Gerät.
`void`	`installPackages( apkFilePaths, boolean reinstall, extraArgs, long timeOutInMs, TimeUnit timeunit)` Installiert eine Android-Anwendung, die aus mehreren APK-Dateien besteht (ein Hauptpaket und 0 bis n unterteilte Pakete)
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)` Installiert das Anwendungspaket, das an einen temporären Speicherort auf dem Gerät übertragen wurde.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, String... extraArgs)` Installiert das Anwendungspaket, das an einen temporären Speicherort auf dem Gerät übertragen wurde.
`void`	`installRemotePackage(String remoteFilePath, boolean reinstall, InstallReceiver receiver, long maxTimeout, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, String... extraArgs)` Installiert das Anwendungspaket, das an einen temporären Speicherort auf dem Gerät übertragen wurde.
`boolean`	`isBootLoader()` Gibt zurück, ob sich das Gerät im Bootloader-Modus befindet.
`boolean`	`isEmulator()` Gibt `true` zurück, wenn es sich bei dem Gerät um einen Emulator handelt.
`boolean`	`isOffline()` Gibt zurück, ob das Gerät offline ist.
`boolean`	`isOnline()` Gibt zurück, ob das Gerät bereit ist.
`boolean`	`isRoot()` Fragt den aktuellen Root-Status des Geräts ab.
`void`	`pullFile(String remote, String local)` Ruft eine einzelne Datei ab.
`void`	`pushFile(String local, String remote)` Pushes a single file.
`void`	`reboot(String into)` Starten Sie das Gerät neu.
`void`	`removeForward(int localPort)` Entfernt eine Portweiterleitung zwischen einem lokalen und einem Remote-Port.
`void`	`removeForward(int localPort, int remotePort)`
`void`	`removeForward(int localPort, String remoteSocketName, IDevice.DeviceUnixSocketNamespace namespace)`
`void`	`removeRemotePackage(String remoteFilePath)` Entfernt eine Datei vom Gerät.
`void`	`removeReverse(int remotePort)` Entfernt eine Portumkehrung zwischen einem Remote- und einem lokalen Port.
`boolean`	`root()` Fordert den ADB-Daemon auf, auf dem Gerät Root zu werden.
`void`	`setSerial(String serial)`
`void`	`startScreenRecorder(String remoteFilePath, ScreenRecorderOptions options, IShellOutputReceiver receiver)` Startet die Bildschirmaufzeichnung auf dem Gerät, wenn das Gerät `IDevice.Feature.SCREEN_RECORD` unterstützt.
`boolean`	`supportsFeature(IDevice.HardwareFeature arg0)` Gibt zurück, ob dieses Gerät die angegebene Hardwarefunktion unterstützt.
`boolean`	`supportsFeature(IDevice.Feature feature)` Gibt zurück, ob dieses Gerät die angegebene Softwarefunktion unterstützt.
`String`	`syncPackageToDevice(String localFilePath)` Eine Datei auf ein Gerät übertragen
`String`	`uninstallApp(String applicationID, String... extraArgs)` Deinstalliert eine App vom Gerät.
`String`	`uninstallPackage(String packageName)` Deinstalliert ein Paket vom Gerät.

Öffentliche Konstruktoren

StubDevice

public StubDevice (String serial)

Parameter
`serial`	`String`

StubDevice

public StubDevice (String serial, 
                boolean isEmulator)

Parameter
`serial`	`String`
`isEmulator`	`boolean`

Öffentliche Methoden

arePropertiesSet

public boolean arePropertiesSet ()

Gibt true zurück, wenn Properties im Cache gespeichert wurden.

Returns
`boolean`

createForward

public void createForward (int localPort, 
                String remoteSocketName, 
                IDevice.DeviceUnixSocketNamespace namespace)

Erstellt eine Portweiterleitung zwischen einem lokalen TCP-Port und einem Remote-Unix-Domain-Socket.

Parameter
`localPort`	`int`: der lokale Port, der weitergeleitet werden soll
`remoteSocketName`	`String`: Name des auf dem Gerät erstellten UNIX-Domain-Sockets
`namespace`	`IDevice.DeviceUnixSocketNamespace`: Namespace, in dem der UNIX-Domain-Socket erstellt wurde

Ausgabe
`AdbCommandRejectedException`
`TimeoutException`

createForward

public void createForward (int localPort, 
                int remotePort)

Erstellt eine Portweiterleitung zwischen einem lokalen und einem Remote-Port.

Parameter
`localPort`	`int`: der lokale Port, der weitergeleitet werden soll
`remotePort`	`int`: der Remote-Port.

Ausgabe
`AdbCommandRejectedException`
`TimeoutException`

createReverse

public void createReverse (int remotePort, 
                int localPort)

Erstellt eine Portumkehrung zwischen einem Remote- und einem lokalen Port.

Parameter
`remotePort`	`int`: der Remote-Port, der umgekehrt werden soll.
`localPort`	`int`: der lokale Port

Ausgabe
`AdbCommandRejectedException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Führt einen Shell-Befehl auf dem Gerät aus und sendet das Ergebnis an eine receiver.

maxTimeToOutputResponse wird als maximale Wartezeit verwendet, wenn die Befehlsausgabe vom Gerät erwartet wird.
Wenn der Shell-Befehl über einen Zeitraum von mehr als maxTimeToOutputResponse nichts ausgibt, löst die Methode ShellCommandUnresponsiveException aus.

Für Befehle wie die Protokollausgabe sollte ein maxTimeToOutputResponse-Wert von 0 verwendet werden. Das bedeutet, dass die Methode nie einen Fehler ausgibt und blockiert wird, bis IShellOutputReceiver.isCancelled() des Empfängers true zurückgibt.

Parameter
`command`	`String`: Der auszuführende Shell-Befehl
`receiver`	`IShellOutputReceiver`: die `IShellOutputReceiver`, die die Ausgabe des Shellbefehls empfängt
`maxTimeToOutputResponse`	`long`: Die maximale Zeit, in der der Befehl keine Ausgabe erzeugen darf. Ein Wert von 0 bedeutet, dass die Methode unbegrenzt auf die Befehlsausgabe wartet (bis `receiver` die Ausführung abbricht) und nie eine Ausnahme auslöst.
`maxTimeUnits`	`TimeUnit`: Einheiten für `maxTimeToOutputResponse`-Werte ungleich null.

Ausgabe
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver)

Führt einen Shell-Befehl auf dem Gerät aus und sendet das Ergebnis an eine receiver.

Dies entspricht dem Aufruf von executeShellCommand(command, receiver, DdmPreferences.getTimeOut()).

Parameter
`command`	`String`: Der auszuführende Shell-Befehl
`receiver`	`IShellOutputReceiver`: die `IShellOutputReceiver`, die die Ausgabe des Shellbefehls empfängt

Ausgabe
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                int maxTimeToOutputResponse)

Diese Methode wurde eingestellt.
Verwenden Sie executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit).

Parameter
`command`	`String`
`receiver`	`IShellOutputReceiver`
`maxTimeToOutputResponse`	`int`

Ausgabe
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

executeShellCommand

public void executeShellCommand (String command, 
                IShellOutputReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits)

Führt einen Shell-Befehl auf dem Gerät aus und sendet das Ergebnis an eine receiver.

Parameter
`command`	`String`: Der auszuführende Shell-Befehl
`receiver`	`IShellOutputReceiver`: die `IShellOutputReceiver`, die die Ausgabe des Shellbefehls empfängt
`maxTimeout`	`long`: Das maximale Zeitlimit für die Rückgabe des Befehls. Ein Wert von 0 bedeutet, dass kein maximales Zeitlimit angewendet wird.
`maxTimeToOutputResponse`	`long`: Die maximale Zeit, in der der Befehl keine Ausgabe erzeugen darf. Ein Wert von 0 bedeutet, dass die Methode unbegrenzt auf die Befehlsausgabe wartet (bis `receiver` die Ausführung abbricht) und nie eine Ausnahme auslöst.
`maxTimeUnits`	`TimeUnit`: Einheiten für `maxTimeout`- und `maxTimeToOutputResponse`-Werte ungleich null.

Ausgabe
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getAbis

public  getAbis ()

Gibt die von diesem Gerät unterstützten ABIs zurück. Die ABIs sind in der bevorzugten Reihenfolge sortiert, wobei das erste ABI das bevorzugteste ist.

Returns
	die Liste der ABIs.

getAvdName

public String getAvdName ()

Gibt den Namen des AVD zurück, auf dem der Emulator ausgeführt wird.

Dies ist nur gültig, wenn isEmulator() „true“ zurückgibt.

Wenn auf dem Emulator kein AVD ausgeführt wird (z. B. wenn er aus einem Android-Quellbaum-Build ausgeführt wird), gibt diese Methode „<build>“ zurück.

Hinweis: Verwenden Sie getAvdData(), wenn Sie das Zeitlimit selbst festlegen möchten.

Returns
`String`	Der Name des AVD oder `null`, wenn keiner vorhanden ist.

getAvdPath

public String getAvdPath ()

Gibt den absoluten Pfad zum virtuellen Gerät im Dateisystem zurück. Der Pfad ist vom Betriebssystem abhängig. Unter Linux werden / als Trennzeichen verwendet, unter Windows \.

Hinweis: Verwenden Sie getAvdData(), wenn Sie das Zeitlimit selbst festlegen möchten.

Returns
`String`	Der AVD-Pfad oder „null“, wenn es sich um ein physisches Gerät handelt, der Emulator-Konsolenunterbefehl fehlgeschlagen ist oder die Version des Emulators älter als 30.0.18 ist.

getBattery

public  getBattery (long freshnessTime, 
                TimeUnit timeUnit)

Gibt den Akkustand des Geräts in Prozent zurück (0 bis 100 %).

Der Akkustand wird möglicherweise im Cache gespeichert. Fragt den Akkustand des Geräts nur ab, wenn freshnessTime seit der letzten erfolgreichen Abfrage abgelaufen ist.

Parameter
`freshnessTime`	`long`: die gewünschte Aktualität des Akkustands
`timeUnit`	`TimeUnit`: die `ERROR(/TimeUnit)` von „freshnessTime“

Returns
	Ein `ERROR(/Future)`, mit dem der Akkustand abgefragt werden kann. Das Future gibt `ERROR(/ExecutionException)` zurück, wenn der Akkustand nicht abgerufen werden konnte.

getBattery

public  getBattery ()

Gibt den Akkustand des Geräts in Prozent zurück (0 bis 100 %).

Der Akkustand wird möglicherweise im Cache gespeichert. Fragt den Akkustand des Geräts nur ab, wenn seit der letzten erfolgreichen Abfrage 5 Minuten vergangen sind.

Returns
	Ein `ERROR(/Future)`, mit dem der Akkustand abgefragt werden kann. Das Future gibt `ERROR(/ExecutionException)` zurück, wenn der Akkustand nicht abgerufen werden konnte.

getBatteryLevel

public Integer getBatteryLevel (long freshnessMs)

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen getBattery(long, TimeUnit).

Gibt den Akkustand des Geräts in Prozent zurück (0 bis 100 %).

Der Akkustand wird möglicherweise im Cache gespeichert. Fragt den Akkustand des Geräts nur ab, wenn seit der letzten erfolgreichen Abfrage freshnessMs ms vergangen sind.

Returns
`Integer`	den Akkustand oder `null`, wenn er nicht abgerufen werden konnte

Ausgabe
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getBatteryLevel

public Integer getBatteryLevel ()

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen getBattery().

Gibt den Akkustand des Geräts in Prozent zurück (0 bis 100 %).

Der Akkustand wird möglicherweise im Cache gespeichert. Fragt den Akkustand des Geräts nur ab, wenn seit der letzten erfolgreichen Abfrage 5 Minuten vergangen sind.

Returns
`Integer`	den Akkustand oder `null`, wenn er nicht abgerufen werden konnte

Ausgabe
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getClient

public Client getClient (String applicationName)

Gibt ein Client anhand des Anwendungsnamens zurück.

Parameter
`applicationName`	`String`: der Name der Anwendung

Returns
`Client`	das `Client`-Objekt oder `null`, wenn keine Übereinstimmung gefunden wurde.

getClientName

public String getClientName (int pid)

Gibt den Namen des Clients anhand der PID oder null zurück, wenn die PID unbekannt ist.

Parameter
`pid`	`int`: Die PID des Clients.

Returns
`String`

getClients

public Client[] getClients ()

Gibt das Array von Clients zurück.

Returns
`Client[]`

getDensity

public int getDensity ()

Gibt den Dichte-Bucket des Gerätebildschirms zurück, indem der Wert für die Systemeigenschaft PROP_DEVICE_DENSITY gelesen wird.

Returns
`int`	die Dichte oder -1, wenn sie nicht ermittelt werden kann.

getFileListingService

public FileListingService getFileListingService ()

Gibt eine FileListingService für dieses Gerät zurück.

Returns
`FileListingService`

getLanguage

public String getLanguage ()

Gibt die Sprache des Nutzers zurück.

Returns
`String`	Die Sprache des Nutzers oder „null“, wenn sie unbekannt ist.

getMountPoint

public String getMountPoint (String name)

Gibt einen Bereitstellungspunkt zurück.

Parameter
`name`	`String`: der Name des zurückzugebenden Bereitstellungspunkts.

Returns
`String`

getName

public String getName ()

Gibt einen (lesbaren) Namen für dieses Gerät zurück. In der Regel ist dies der AVD-Name für AVDs und eine Kombination aus Herstellername, Modellname und Seriennummer für Geräte.

Returns
`String`

getProperties

public  getProperties ()

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen getSystemProperty(String).

Gibt die im Cache gespeicherten Geräteeigenschaften zurück. Sie enthält die gesamte Ausgabe von „getprop“.

Returns

getProperty

public String getProperty (String name)

Praktische Methode, die versucht, eine Property über IShellEnabledDevice.getSystemProperty(String) mit einer sehr kurzen Wartezeit abzurufen, und Ausnahmen abfängt.

Hinweis: Verwenden Sie vorzugsweise IShellEnabledDevice.getSystemProperty(String), wenn Sie das Zeitlimit steuern möchten.

Parameter
`name`	`String`: Der Name des zurückzugebenden Werts.

Returns
`String`	der Wert oder `null`, wenn der Eigenschaftswert nicht sofort verfügbar war

getPropertyCacheOrSync

public String getPropertyCacheOrSync (String name)

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen getProperty(String).

Eine Kombination aus getProperty(String) und getPropertySync(String), mit der versucht wird, die Eigenschaft aus dem Cache abzurufen. Wenn sie nicht gefunden wird, wird synchron versucht, das Gerät direkt abzufragen und den Cache bei Erfolg neu zu füllen.

Parameter
`name`	`String`: Der Name des zurückzugebenden Werts.

Returns
`String`	Der Wert oder `null`, wenn die Eigenschaft nicht vorhanden ist

Ausgabe
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getPropertyCount

public int getPropertyCount ()

Diese Methode wurde eingestellt.
deprecated in ddmlib with "implementation detail" as reason.

Gibt die Anzahl der Properties für dieses Gerät zurück.

Returns
`int`

getPropertySync

public String getPropertySync (String name)

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen getProperty(String).

Eine Variante von getProperty(String), mit der versucht wird, das angegebene Attribut direkt vom Gerät abzurufen, ohne den Cache zu verwenden. Diese Methode sollte (nur) für alle flüchtigen Eigenschaften verwendet werden.

Parameter
`name`	`String`: Der Name des zurückzugebenden Werts.

Returns
`String`	Der Wert oder `null`, wenn die Eigenschaft nicht vorhanden ist

Ausgabe
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

getRegion

public String getRegion ()

Gibt die Region des Nutzers zurück.

Returns
`String`	Die Region des Nutzers oder „null“, wenn sie unbekannt ist

getScreenshot

public RawImage getScreenshot ()

Erstellt einen Screenshot des Geräts und gibt ihn als RawImage zurück.

Returns
`RawImage`	den Screenshot als `RawImage` oder `null`, wenn etwas schiefgegangen ist.

Ausgabe
`AdbCommandRejectedException`
`TimeoutException`

getScreenshot

public RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Parameter
`timeout`	`long`
`unit`	`TimeUnit`

Returns
`RawImage`

Ausgabe
`AdbCommandRejectedException`
`TimeoutException`

getSerialNumber

public String getSerialNumber ()

Gibt die Seriennummer des Geräts zurück.

Returns
`String`

getState

public IDevice.DeviceState getState ()

Gibt den Status des Geräts zurück.

Returns
`IDevice.DeviceState`

getSyncService

public SyncService getSyncService ()

Gibt ein SyncService-Objekt zurück, um Dateien auf das Gerät zu übertragen und vom Gerät abzurufen.

Returns
`SyncService`	`null`, wenn der SyncService nicht erstellt werden konnte. Das kann passieren, wenn adb die Verbindung nicht öffnen kann, weil `IDevice` ungültig ist oder die Verbindung getrennt wurde.

Ausgabe
`AdbCommandRejectedException`
`TimeoutException`

getSystemProperty

public ListenableFuture<String> getSystemProperty (String name)

Führen Sie eine potenzielle asynchrone Abfrage für eine Systemeigenschaft durch.

Parameter
`name`	`String`: Der Name des zurückzugebenden Werts.

Returns
`ListenableFuture<String>`	Ein `ListenableFuture.` `ERROR(get/Future#get() get)` kann null zurückgeben.

hasClients

public boolean hasClients ()

Gibt zurück, ob IDevice Client enthält.

Returns
`boolean`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

Installiert eine Android-App auf dem Gerät. Dies ist eine Hilfsmethode, die die Schritte „syncPackageToDevice“, „installRemotePackage“ und „removePackage“ kombiniert.

Parameter
`packageFilePath`	`String`: der absolute Dateisystempfad zur Datei auf dem lokalen Host, die installiert werden soll
`reinstall`	`boolean`: auf `true` setzen, wenn die App neu installiert werden soll
`receiver`	`InstallReceiver`: Die `InstallReceiver`, die zum Überwachen der Installation und zum Abrufen des endgültigen Status verwendet werden soll.
`maxTimeout`	`long`: Das maximale Zeitlimit für die Rückgabe des Befehls. Ein Wert von 0 bedeutet, dass kein maximales Zeitlimit angewendet wird.
`maxTimeToOutputResponse`	`long`: Die maximale Zeit, in der der Befehl keine Ausgabe erzeugen darf. Ein Wert von 0 bedeutet, dass die Methode unbegrenzt auf die Befehlsausgabe wartet (bis `receiver` die Ausführung abbricht) und nie eine Ausnahme auslöst.
`maxTimeUnits`	`TimeUnit`: Einheiten für `maxTimeout`- und `maxTimeToOutputResponse`-Werte ungleich null.
`extraArgs`	`String`: Optionale zusätzliche Argumente, die übergeben werden sollen. Weitere Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm install --help“.

Ausgabe
`InstallException`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

Installiert eine Android-App auf dem Gerät. Dies ist eine Hilfsmethode, die die Schritte „syncPackageToDevice“, „installRemotePackage“ und „removePackage“ kombiniert.

Parameter
`packageFilePath`	`String`: der absolute Dateisystempfad zur Datei auf dem lokalen Host, die installiert werden soll
`reinstall`	`boolean`: auf `true` setzen, wenn die App neu installiert werden soll
`receiver`	`InstallReceiver`: Die `InstallReceiver`, die zum Überwachen der Installation und zum Abrufen des endgültigen Status verwendet werden soll.
`extraArgs`	`String`: Optionale zusätzliche Argumente, die übergeben werden sollen. Weitere Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm install --help“.

Ausgabe
`InstallException`

installPackage

public void installPackage (String packageFilePath, 
                boolean reinstall, 
                String... extraArgs)

Installiert eine Android-App auf dem Gerät. Dies ist eine Hilfsmethode, die die Schritte „syncPackageToDevice“, „installRemotePackage“ und „removePackage“ kombiniert.

Parameter
`packageFilePath`	`String`: der absolute Dateisystempfad zur Datei auf dem lokalen Host, die installiert werden soll
`reinstall`	`boolean`: auf `true` setzen, wenn die App neu installiert werden soll
`extraArgs`	`String`: Optionale zusätzliche Argumente, die übergeben werden sollen. Weitere Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm install --help“.

Ausgabe
`InstallException`

installPackages

public void installPackages ( apkFilePaths, 
                boolean reinstall, 
                 extraArgs, 
                long timeOutInMs, 
                TimeUnit timeunit)

Installiert eine Android-Anwendung, die aus mehreren APK-Dateien besteht (ein Hauptpaket und 0 bis n unterteilte Pakete)

Parameter
`apkFilePaths`	: Liste der zu installierenden APKs (1 Haupt-APK + 0..n Split-APKs)
`reinstall`	`boolean`: auf `true` setzen, wenn die App neu installiert werden soll
`extraArgs`	: Optionale zusätzliche Argumente, die übergeben werden sollen. Weitere Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm install --help“.
`timeOutInMs`	`long`: Installationszeitüberschreitung
`timeunit`	`TimeUnit`: `ERROR(/TimeUnit)` entsprechend dem Zeitlimitparameter

Ausgabe
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                String... extraArgs)

Installiert das Anwendungspaket, das an einen temporären Speicherort auf dem Gerät übertragen wurde.

Parameter
`remoteFilePath`	`String`: Absoluter Dateipfad zur Paketdatei auf dem Gerät.
`reinstall`	`boolean`: auf `true` setzen, wenn die App neu installiert werden soll
`receiver`	`InstallReceiver`: Die `InstallReceiver`, die zum Überwachen der Installation und zum Abrufen des endgültigen Status verwendet werden soll.
`extraArgs`	`String`: Optionale zusätzliche Argumente, die übergeben werden sollen. Weitere Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm install --help“.

Ausgabe
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                String... extraArgs)

Installiert das Anwendungspaket, das an einen temporären Speicherort auf dem Gerät übertragen wurde.

Parameter
`remoteFilePath`	`String`: Absoluter Dateipfad zur Paketdatei auf dem Gerät.
`reinstall`	`boolean`: auf `true` setzen, wenn die App neu installiert werden soll
`extraArgs`	`String`: Optionale zusätzliche Argumente, die übergeben werden sollen. Weitere Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm install --help“.

Ausgabe
`InstallException`

installRemotePackage

public void installRemotePackage (String remoteFilePath, 
                boolean reinstall, 
                InstallReceiver receiver, 
                long maxTimeout, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                String... extraArgs)

Installiert das Anwendungspaket, das an einen temporären Speicherort auf dem Gerät übertragen wurde.

Parameter
`remoteFilePath`	`String`: Absoluter Dateipfad zur Paketdatei auf dem Gerät.
`reinstall`	`boolean`: auf `true` setzen, wenn die App neu installiert werden soll
`receiver`	`InstallReceiver`: Die `InstallReceiver`, die zum Überwachen der Installation und zum Abrufen des endgültigen Status verwendet werden soll.
`maxTimeout`	`long`: Das maximale Zeitlimit für die Rückgabe des Befehls. Ein Wert von 0 bedeutet, dass kein maximales Zeitlimit angewendet wird.
`maxTimeToOutputResponse`	`long`: Die maximale Zeit, in der der Befehl keine Ausgabe erzeugen darf. Ein Wert von 0 bedeutet, dass die Methode unbegrenzt auf die Befehlsausgabe wartet (bis `receiver` die Ausführung abbricht) und nie eine Ausnahme auslöst.
`maxTimeUnits`	`TimeUnit`: Einheiten für `maxTimeout`- und `maxTimeToOutputResponse`-Werte ungleich null.
`extraArgs`	`String`: Optionale zusätzliche Argumente, die übergeben werden sollen. Weitere Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm install --help“.

Ausgabe
`InstallException`

isBootLoader

public boolean isBootLoader ()

Gibt zurück, ob sich das Gerät im Bootloader-Modus befindet.

Returns
`boolean`	`true`, wenn `getState()` `DeviceState.BOOTLOADER` zurückgibt.

isEmulator

public boolean isEmulator ()

Gibt true zurück, wenn es sich bei dem Gerät um einen Emulator handelt.

Returns
`boolean`

isOffline

public boolean isOffline ()

Gibt zurück, ob das Gerät offline ist.

Returns
`boolean`	`true`, wenn `getState()` `DeviceState.OFFLINE` zurückgibt.

isOnline

public boolean isOnline ()

Gibt zurück, ob das Gerät bereit ist.

Returns
`boolean`	`true`, wenn `getState()` `DeviceState.ONLINE` zurückgibt.

isRoot

public boolean isRoot ()

Fragt den aktuellen Root-Status des Geräts ab. Weitere Informationen finden Sie unter „adb root“.

Returns
`boolean`	„true“, wenn der ADB-Daemon als Root ausgeführt wird, andernfalls „false“.

Ausgabe
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

pullFile

public void pullFile (String remote, 
                String local)

Ruft eine einzelne Datei ab.

Parameter
`remote`	`String`: der vollständige Pfad zur Remotedatei
`local`	`String`: Das lokale Ziel.

Ausgabe
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

pushFile

public void pushFile (String local, 
                String remote)

Pushes a single file.

Parameter
`local`	`String`: der lokale Dateipfad.
`remote`	`String`: der Remote-Dateipfad

Ausgabe
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

neu starten

public void reboot (String into)

Starten Sie das Gerät neu.

Parameter
`into`	`String`: Der Name des Bootloaders, in den neu gestartet werden soll, oder „null“, um das Gerät nur neu zu starten.

Ausgabe
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort)

Entfernt eine Portweiterleitung zwischen einem lokalen und einem Remote-Port.

Parameter
`localPort`	`int`: der lokale Port, der weitergeleitet werden soll

Ausgabe
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort, 
                int remotePort)

Parameter
`localPort`	`int`
`remotePort`	`int`

Ausgabe
`AdbCommandRejectedException`
`TimeoutException`

removeForward

public void removeForward (int localPort, 
                String remoteSocketName, 
                IDevice.DeviceUnixSocketNamespace namespace)

Parameter
`localPort`	`int`
`remoteSocketName`	`String`
`namespace`	`IDevice.DeviceUnixSocketNamespace`

Ausgabe
`AdbCommandRejectedException`
`TimeoutException`

removeRemotePackage

public void removeRemotePackage (String remoteFilePath)

Entfernt eine Datei vom Gerät.

Parameter
`remoteFilePath`	`String`: Pfad der Datei auf dem Gerät, die entfernt werden soll

Ausgabe
`InstallException`

removeReverse

public void removeReverse (int remotePort)

Entfernt eine Portumkehrung zwischen einem Remote- und einem lokalen Port.

Parameter
`remotePort`	`int`: der Remote-Port.

Ausgabe
`AdbCommandRejectedException`
`TimeoutException`

root

public boolean root ()

Fordert den ADB-Daemon auf, auf dem Gerät Root zu werden. Dies kann im Hintergrund fehlschlagen und nur bei Entwickler-Builds funktionieren. Weitere Informationen finden Sie unter „adb root“.

Returns
`boolean`	„true“, wenn der ADB-Daemon als Root ausgeführt wird, andernfalls „false“.

Ausgabe
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

setSerial

public void setSerial (String serial)

Parameter
`serial`	`String`

startScreenRecorder

public void startScreenRecorder (String remoteFilePath, 
                ScreenRecorderOptions options, 
                IShellOutputReceiver receiver)

Startet die Bildschirmaufzeichnung auf dem Gerät, wenn das Gerät IDevice.Feature.SCREEN_RECORD unterstützt.

Parameter
`remoteFilePath`	`String`
`options`	`ScreenRecorderOptions`
`receiver`	`IShellOutputReceiver`

Ausgabe
`AdbCommandRejectedException`
`ShellCommandUnresponsiveException`
`TimeoutException`

supportsFeature

public boolean supportsFeature (IDevice.HardwareFeature arg0)

Gibt zurück, ob dieses Gerät die angegebene Hardwarefunktion unterstützt.

Parameter
`arg0`	`IDevice.HardwareFeature`

Returns
`boolean`

supportsFeature

public boolean supportsFeature (IDevice.Feature feature)

Gibt zurück, ob dieses Gerät die angegebene Softwarefunktion unterstützt.

Parameter
`feature`	`IDevice.Feature`

Returns
`boolean`

syncPackageToDevice

public String syncPackageToDevice (String localFilePath)

Eine Datei auf ein Gerät übertragen

Parameter
`localFilePath`	`String`: der absolute Pfad zur Datei auf dem lokalen Host

Returns
`String`	`String` – Zielpfad auf dem Gerät für die Datei

Ausgabe
`AdbCommandRejectedException`
`SyncException`
`TimeoutException`

uninstallApp

public String uninstallApp (String applicationID, 
                String... extraArgs)

Deinstalliert eine App vom Gerät.

Parameter
`applicationID`	`String`: die Android-Anwendungs-ID, die deinstalliert werden soll
`extraArgs`	`String`: Optionale zusätzliche Argumente, die übergeben werden sollen. Weitere Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm install --help“.

Returns
`String`	`String` mit einem Fehlercode oder `null` bei Erfolg.

Ausgabe
`InstallException`

uninstallPackage

public String uninstallPackage (String packageName)

Deinstalliert ein Paket vom Gerät.

Parameter
`packageName`	`String`: die Android-Anwendungs-ID, die deinstalliert werden soll

Returns
`String`	`String` mit einem Fehlercode oder `null` bei Erfolg.

Ausgabe
`InstallException`