StubDevice
public
class
StubDevice
extends Object
implements
IDevice,
Serializable
| java.lang.Object | |
| ↳ | com.android.tradefed.device.StubDevice |
Stub-Platzhalterimplementierung eines IDevice.
Zusammenfassung
Öffentliche Konstruktoren | |
|---|---|
StubDevice(String serial)
|
|
StubDevice(String serial, boolean isEmulator)
|
|
Öffentliche Methoden | |
|---|---|
boolean
|
arePropertiesSet()
Gibt |
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)
Führt einen Shell-Befehl auf dem Gerät aus und sendet das Ergebnis an eine receiver. Dies entspricht dem Aufruf von |
void
|
executeShellCommand(String command, IShellOutputReceiver receiver, int maxTimeToOutputResponse)
Diese Methode wurde eingestellt.
|
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 ein receiver. |
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 ein receiver. |
List<String>
|
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. |
Future<Integer>
|
getBattery(long freshnessTime, TimeUnit timeUnit)
Gibt den Akkustand des Geräts in Prozent zurück (0 bis 100 %). |
Future<Integer>
|
getBattery()
Gibt den Akkustand des Geräts in Prozent zurück (0 bis 100 %). |
Integer
|
getBatteryLevel(long freshnessMs)
Diese Methode wurde eingestellt.
Verwenden Sie stattdessen |
Integer
|
getBatteryLevel()
Diese Methode wurde eingestellt.
Verwenden Sie stattdessen |
int
|
getDensity()
Gibt den Dichte-Bucket des Gerätebildschirms zurück, indem der Wert für die Systemeigenschaft |
FileListingService
|
getFileListingService()
Gibt eine |
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. |
Map<String, String>
|
getProperties()
Diese Methode wurde eingestellt.
Verwenden Sie stattdessen |
String
|
getProperty(String name)
Praktische Methode, die versucht, eine Property über |
String
|
getPropertyCacheOrSync(String name)
Diese Methode wurde eingestellt.
Verwenden Sie stattdessen |
int
|
getPropertyCount()
Diese Methode wurde eingestellt. in ddmlib mit dem Grund „Implementierungsdetail“ als veraltet markiert. |
String
|
getPropertySync(String name)
Diese Methode wurde eingestellt.
Verwenden Sie stattdessen |
String
|
getRegion()
Gibt die Region des Nutzers zurück. |
RawImage
|
getScreenshot()
Erstellt einen Screenshot des Geräts und gibt ihn als |
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 |
ListenableFuture<String>
|
getSystemProperty(String name)
Führen Sie eine potenzielle asynchrone Abfrage für eine Systemeigenschaft durch. |
void
|
installPackage(String packageFilePath, boolean reinstall, InstallReceiver receiver, String... extraArgs)
Installiert eine Android-App auf dem Gerät. |
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, String... extraArgs)
Installiert eine Android-App auf dem Gerät. |
void
|
installPackages(List<File> apkFilePaths, boolean reinstall, List<String> extraArgs, long timeOutInMs, TimeUnit timeunit)
Installiert eine Android-App, 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 |
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)
Starte 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()
Fordern Sie den ADB-Daemon auf, auf dem Gerät zum Root-Nutzer 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 |
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)
Datei auf 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.
| Gibt Folgendes zurück: | |
|---|---|
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 |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
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. |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
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 |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
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 |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
ShellCommandUnresponsiveException |
|
TimeoutException |
|
executeShellCommand
public void executeShellCommand (String command,
IShellOutputReceiver receiver,
int maxTimeToOutputResponse)
Diese Methode wurde eingestellt.
Verwenden Sie executeShellCommand(String,IShellOutputReceiver,long,TimeUnit).
| Parameter | |
|---|---|
command |
String |
receiver |
IShellOutputReceiver |
maxTimeToOutputResponse |
int |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
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 ein receiver.
maxTimeToOutputResponse wird als maximale Wartezeit verwendet, wenn die Befehlsausgabe vom Gerät erwartet wird.
Wenn der Shell-Befehl zu einem beliebigen Zeitpunkt länger 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 |
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. |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
ShellCommandUnresponsiveException |
|
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 ein receiver.
maxTimeToOutputResponse wird als maximale Wartezeit verwendet, wenn die Befehlsausgabe vom Gerät erwartet wird.
Wenn der Shell-Befehl zu einem beliebigen Zeitpunkt länger 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. |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
ShellCommandUnresponsiveException |
|
TimeoutException |
|
getAbis
public List<String> 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.
| Gibt Folgendes zurück: | |
|---|---|
List<String> |
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 vorzugsweise getAvdData(), wenn Sie das Zeitlimit selbst festlegen möchten.
| Gibt Folgendes zurück: | |
|---|---|
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 vorzugsweise getAvdData(), wenn Sie das Zeitlimit selbst festlegen möchten.
| Gibt Folgendes zurück: | |
|---|---|
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 Future<Integer> 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 TimeUnit von „freshnessTime“ |
| Gibt Folgendes zurück: | |
|---|---|
Future<Integer> |
Ein Future, mit dem der Akkustand abgefragt werden kann. Die Future gibt ExecutionException zurück, wenn der Akkustand nicht abgerufen werden konnte. |
getBattery
public Future<Integer> 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.
| Gibt Folgendes zurück: | |
|---|---|
Future<Integer> |
Ein Future, mit dem der Akkustand abgefragt werden kann. Die Future gibt 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.
| Gibt Folgendes zurück: | |
|---|---|
Integer |
den Akkustand oder null, wenn er nicht abgerufen werden konnte |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
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.
| Gibt Folgendes zurück: | |
|---|---|
Integer |
den Akkustand oder null, wenn er nicht abgerufen werden konnte |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
ShellCommandUnresponsiveException |
|
TimeoutException |
|
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.
| Gibt Folgendes zurück: | |
|---|---|
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.
| Gibt Folgendes zurück: | |
|---|---|
FileListingService |
|
getLanguage
public String getLanguage ()
Gibt die Sprache des Nutzers zurück.
| Gibt Folgendes zurück: | |
|---|---|
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. |
| Gibt Folgendes zurück: | |
|---|---|
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.
| Gibt Folgendes zurück: | |
|---|---|
String |
|
getProperties
public Map<String, String> 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“.
| Gibt Folgendes zurück: | |
|---|---|
Map<String, String> |
|
getProperty
public String getProperty (String name)
Praktische Methode, die versucht, eine Property über getSystemProperty(String) mit einer sehr kurzen Wartezeit abzurufen, und Ausnahmen abfängt.
Hinweis: Verwenden Sie vorzugsweise getSystemProperty(String), wenn Sie das Zeitlimit steuern möchten.
| Parameter | |
|---|---|
name |
String: Der Name des zurückzugebenden Werts. |
| Gibt Folgendes zurück: | |
|---|---|
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. |
| Gibt Folgendes zurück: | |
|---|---|
String |
Der Wert oder null, wenn die Eigenschaft nicht vorhanden ist |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
ShellCommandUnresponsiveException |
|
TimeoutException |
|
getPropertyCount
public int getPropertyCount ()
Diese Methode wurde eingestellt.
In ddmlib als „Implementierungsdetail“ eingestellt.
Gibt die Anzahl der Properties für dieses Gerät zurück.
| Gibt Folgendes zurück: | |
|---|---|
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. |
| Gibt Folgendes zurück: | |
|---|---|
String |
Der Wert oder null, wenn die Eigenschaft nicht vorhanden ist |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
ShellCommandUnresponsiveException |
|
TimeoutException |
|
getRegion
public String getRegion ()
Gibt die Region des Nutzers zurück.
| Gibt Folgendes zurück: | |
|---|---|
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.
| Gibt Folgendes zurück: | |
|---|---|
RawImage |
den Screenshot als RawImage oder null, wenn etwas schiefgegangen ist. |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
TimeoutException |
|
getScreenshot
public RawImage getScreenshot (long timeout, TimeUnit unit)
| Parameter | |
|---|---|
timeout |
long |
unit |
TimeUnit |
| Gibt Folgendes zurück: | |
|---|---|
RawImage |
|
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
TimeoutException |
|
getSerialNumber
public String getSerialNumber ()
Gibt die Seriennummer des Geräts zurück.
| Gibt Folgendes zurück: | |
|---|---|
String |
|
getStat
public IDevice.DeviceState getState ()
Gibt den Status des Geräts zurück.
| Gibt Folgendes zurück: | |
|---|---|
IDevice.DeviceState |
|
getSyncService
public SyncService getSyncService ()
Gibt ein SyncService-Objekt zurück, um Dateien auf das Gerät zu übertragen oder vom Gerät abzurufen.
| Gibt Folgendes zurück: | |
|---|---|
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. |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
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. |
| Gibt Folgendes zurück: | |
|---|---|
ListenableFuture<String> |
Ein ListenableFuture. get kann null zurückgeben. |
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“. |
| Löst aus | |
|---|---|
InstallException |
|
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“. |
| Löst aus | |
|---|---|
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“. |
| Löst aus | |
|---|---|
InstallException |
|
installPackages
public void installPackages (List<File> apkFilePaths,
boolean reinstall,
List<String> extraArgs,
long timeOutInMs,
TimeUnit timeunit)Installiert eine Android-App, die aus mehreren APK-Dateien besteht (ein Hauptpaket und 0 bis n unterteilte Pakete)
| Parameter | |
|---|---|
apkFilePaths |
List: 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 |
List: 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: TimeUnit entsprechend dem Zeitlimitparameter |
| Löst aus | |
|---|---|
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“. |
| Löst aus | |
|---|---|
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“. |
| Löst aus | |
|---|---|
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“. |
| Löst aus | |
|---|---|
InstallException |
|
isBootLoader
public boolean isBootLoader ()
Gibt zurück, ob sich das Gerät im Bootloader-Modus befindet.
| Gibt Folgendes zurück: | |
|---|---|
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.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
isOffline
public boolean isOffline ()
Gibt zurück, ob das Gerät offline ist.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
true, wenn getState() DeviceState.OFFLINE zurückgibt. |
isOnline
public boolean isOnline ()
Gibt zurück, ob das Gerät bereit ist.
| Gibt Folgendes zurück: | |
|---|---|
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“.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„true“, wenn der ADB-Daemon als Root ausgeführt wird, andernfalls „false“. |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
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. |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
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 |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
SyncException |
|
TimeoutException |
|
neu starten
public void reboot (String into)
Starte 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. |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
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 |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
TimeoutException |
|
removeForward
public void removeForward (int localPort,
int remotePort)| Parameter | |
|---|---|
localPort |
int |
remotePort |
int |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
TimeoutException |
|
removeForward
public void removeForward (int localPort,
String remoteSocketName,
IDevice.DeviceUnixSocketNamespace namespace)| Parameter | |
|---|---|
localPort |
int |
remoteSocketName |
String |
namespace |
IDevice.DeviceUnixSocketNamespace |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
TimeoutException |
|
removeRemotePackage
public void removeRemotePackage (String remoteFilePath)
Entfernt eine Datei vom Gerät.
| Parameter | |
|---|---|
remoteFilePath |
String: Pfad der Datei, die auf dem Gerät entfernt werden soll |
| Löst aus | |
|---|---|
InstallException |
|
removeReverse
public void removeReverse (int remotePort)
Entfernt eine Portumkehrung zwischen einem Remote- und einem lokalen Port.
| Parameter | |
|---|---|
remotePort |
int: der Remote-Port. |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
TimeoutException |
|
root
public boolean root ()
Fordern Sie den ADB-Daemon auf, auf dem Gerät zum Root-Nutzer zu werden. Dies kann im Hintergrund fehlschlagen und ist nur bei Entwickler-Builds möglich. Weitere Informationen finden Sie unter „adb root“.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„true“, wenn der ADB-Daemon als Root ausgeführt wird, andernfalls „false“. |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
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 Feature.SCREEN_RECORD unterstützt.
| Parameter | |
|---|---|
remoteFilePath |
String |
options |
ScreenRecorderOptions |
receiver |
IShellOutputReceiver |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
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 |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
supportsFeature
public boolean supportsFeature (IDevice.Feature feature)
Gibt zurück, ob dieses Gerät die angegebene Softwarefunktion unterstützt.
| Parameter | |
|---|---|
feature |
IDevice.Feature |
| Gibt Folgendes zurück: | |
|---|---|
boolean |
|
syncPackageToDevice
public String syncPackageToDevice (String localFilePath)
Datei auf Gerät übertragen
| Parameter | |
|---|---|
localFilePath |
String: der absolute Pfad zur Datei auf dem lokalen Host |
| Gibt Folgendes zurück: | |
|---|---|
String |
String – Zielpfad auf dem Gerät für die Datei |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
|
IOException |
|
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“. |
| Gibt Folgendes zurück: | |
|---|---|
String |
String mit einem Fehlercode oder null bei Erfolg. |
| Löst aus | |
|---|---|
InstallException |
|
uninstallPackage
public String uninstallPackage (String packageName)
Deinstalliert ein Paket vom Gerät.
| Parameter | |
|---|---|
packageName |
String: die Android-Anwendungs-ID, die deinstalliert werden soll |
| Gibt Folgendes zurück: | |
|---|---|
String |
String mit einem Fehlercode oder null bei Erfolg. |
| Löst aus | |
|---|---|
InstallException |
|