IDevice

public interface IDevice
implements IShellEnabledDevice

com.android.ddmlib.IDevice

Ein Gerät. Das kann ein physisches Gerät oder ein Emulator sein.

Zusammenfassung

Konstanten

int CHANGE_BUILD_INFO

Bitmaske für Geräteänderung: Build-Info-Änderung.

int CHANGE_CLIENT_LIST

Bitmaske für Geräteänderungen: Client-Listenänderung.

int CHANGE_PROFILEABLE_CLIENT_LIST

Bitmaske für Geräteänderungen: ProfileableClient-Listenänderung.

int CHANGE_STATE

Geräteänderungs-Bitmaske: DeviceState-Änderung.

String FIRST_EMULATOR_SN

Die Seriennummer des ersten verbundenen Emulators.

String MNT_DATA

String MNT_EXTERNAL_STORAGE

String MNT_ROOT

String PROP_BUILD_API_LEVEL

String PROP_BUILD_CHARACTERISTICS

String PROP_BUILD_CODENAME

String PROP_BUILD_TAGS

String PROP_BUILD_TYPE

String PROP_BUILD_VERSION

String PROP_BUILD_VERSION_NUMBER

Diese Konstante ist veraltet. Verwenden Sie PROP_BUILD_API_LEVEL.

String PROP_DEBUGGABLE

String PROP_DEVICE_CPU_ABI

String PROP_DEVICE_CPU_ABI2

String PROP_DEVICE_CPU_ABI_LIST

String PROP_DEVICE_DENSITY

String PROP_DEVICE_EMULATOR_DENSITY

String PROP_DEVICE_LANGUAGE

String PROP_DEVICE_MANUFACTURER

String PROP_DEVICE_MODEL

String PROP_DEVICE_REGION

String RE_EMULATOR_SN

Regulärer Ausdruck für die Seriennummer des Emulators.

String UNKNOWN_PACKAGE

Öffentliche Methoden

abstract boolean arePropertiesSet()

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

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

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

abstract void createForward(int localPort, int remotePort)

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

default void createReverse(int remotePort, int localPort)

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

default void executeBinderCommand(String[] parameters, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)

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

Dazu wird der Aufruf exec:cmd oder, falls sowohl das Gerätebetriebssystem als auch der Host-ADB-Server die Ausführungsfunktion von Android Binder Bridge unterstützen, der schnellere Aufruf abb_exec: verwendet.

default void executeShellCommand(String command, IShellOutputReceiver receiver, long maxTimeToOutputResponse, TimeUnit maxTimeUnits, InputStream is)

Eine Version des Befehls „executeShell“, die einen Eingabestream für die Übertragung über „stdin“ akzeptieren kann.

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

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

Diese Methode ist veraltet. Verwenden Sie IShellEnabledDevice.executeShellCommand(String, com.android.ddmlib.IShellOutputReceiver, long, TimeUnit).

default void forceStop(String applicationName)

Beenden einer App nach Anwendungsname erzwingen

abstract getAbis()

Gibt die von diesem Gerät unterstützten ABIs zurück.

default ListenableFuture<AvdData> getAvdData()

Gibt Informationen zum AVD zurück, auf dem der Emulator ausgeführt wird.

abstract String getAvdName()

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

abstract String getAvdPath()

Gibt den absoluten Pfad zum virtuellen Gerät im Dateisystem zurück.

abstract getBattery(long freshnessTime, TimeUnit timeUnit)

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

abstract getBattery()

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

abstract Integer getBatteryLevel(long freshnessMs)

Diese Methode ist veraltet. getBattery(long, TimeUnit) verwenden

abstract Integer getBatteryLevel()

Diese Methode ist veraltet. getBattery() verwenden

abstract Client getClient(String applicationName)

Gibt ein Client anhand des Anwendungsnamens zurück.

abstract String getClientName(int pid)

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

abstract Client[] getClients()

Gibt das Array von Clients zurück.

abstract int getDensity()

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

abstract FileListingService getFileListingService()

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

default getHardwareCharacteristics()

Gibt Funktionen zurück, die durch Lesen des Attributs „Build-Merkmale“ abgerufen wurden.

abstract String getLanguage()

Gibt die Sprache des Nutzers zurück.

default InstallMetrics getLastInstallMetrics()

Ruft die Informationen zur letzten Installation auf diesem Gerät ab.

abstract String getMountPoint(String name)

Gibt einen Bereitstellungspunkt zurück.

default ProfileableClient[] getProfileableClients()

Gibt das Array der profilierbaren Clients zurück.

abstract getProperties()

Diese Methode ist veraltet. Verwenden Sie stattdessen IShellEnabledDevice.getSystemProperty(String).

abstract String getProperty(String name)

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

abstract String getPropertyCacheOrSync(String name)

Diese Methode ist veraltet. Verwenden Sie stattdessen IShellEnabledDevice.getSystemProperty(String).

abstract int getPropertyCount()

Diese Methode ist veraltet. Implementierungsdetail

abstract String getPropertySync(String name)

Diese Methode ist veraltet. IShellEnabledDevice.getSystemProperty(String) verwenden

abstract String getRegion()

Gibt die Region des Nutzers zurück.

abstract RawImage getScreenshot()

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

abstract RawImage getScreenshot(long timeout, TimeUnit unit)
abstract String getSerialNumber()

Gibt die Seriennummer des Geräts zurück.

abstract IDevice.DeviceState getState()

Gibt den Status des Geräts zurück.

abstract SyncService getSyncService()

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

abstract boolean hasClients()

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

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

Installiert eine Android-App auf dem Gerät.

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

Installiert eine Android-App auf dem Gerät.

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

Installiert eine Android-App auf dem Gerät.

default void installPackages( apks, boolean reinstall, installOptions)

Installiert eine Android-Anwendung, die aus mehreren APK-Dateien besteht (ein Haupt-APK und 0..n Split-Pakete) mit dem Standard-Zeitlimit.

abstract void installPackages( apks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)

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

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

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

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

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

default void installRemotePackages( remoteApks, boolean reinstall, installOptions)

Installiert eine Android-Anwendung, die aus mehreren APK-Dateien besteht, die sich lokal auf dem Gerät befinden, mit dem Standard-Timeout.

default void installRemotePackages( remoteApks, boolean reinstall, installOptions, long timeout, TimeUnit timeoutUnit)

Installiert eine Android-Anwendung, die aus mehreren APK-Dateien besteht, die sich lokal auf dem Gerät befinden

abstract boolean isBootLoader()

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

abstract boolean isEmulator()

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

abstract boolean isOffline()

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

abstract boolean isOnline()

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

abstract boolean isRoot()

Fragt den aktuellen Root-Status des Geräts ab.

default void kill(String applicationName)

Beendet eine Anwendung anhand ihres Namens.

abstract void pullFile(String remote, String local)

Ruft eine einzelne Datei ab.

default void push(String[] local, String remote)

Überträgt mehrere Dateien oder Verzeichnisse.

abstract void pushFile(String local, String remote)

Pushes a single file.

default SocketChannel rawBinder(String service, String[] parameters)

Den Android Binder Bridge-Dienst auf einem Remote-Gerät aufrufen

default SocketChannel rawExec(String executable, String[] parameters)

Rufen Sie den Dienst „host:exec“ auf einem Remote-Gerät auf.

abstract void reboot(String into)

Starten Sie das Gerät neu.

default void removeForward(int localPort)

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

default void removeForward(int localPort, int remotePort)

Diese Methode ist veraltet. Verwenden Sie removeForward(int).

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

Diese Methode ist veraltet. Verwenden Sie removeForward(int).

abstract void removeRemotePackage(String remoteFilePath)

Entfernt eine Datei vom Gerät.

default void removeReverse(int remotePort)

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

abstract boolean root()

Fordert den ADB-Daemon auf, auf dem Gerät Root zu werden.

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

abstract boolean supportsFeature(IDevice.HardwareFeature feature)

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

abstract boolean supportsFeature(IDevice.Feature feature)

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

abstract String syncPackageToDevice(String localFilePath)

Eine Datei auf ein Gerät übertragen

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

Deinstalliert eine App vom Gerät.

abstract String uninstallPackage(String packageName)

Deinstalliert ein Paket vom Gerät.

Konstanten

CHANGE_BUILD_INFO

public static final int CHANGE_BUILD_INFO

Bitmaske für Geräteänderung: Build-Info-Änderung.

Konstanter Wert: 4 (0x00000004)

CHANGE_CLIENT_LIST

public static final int CHANGE_CLIENT_LIST

Bitmaske für Geräteänderungen: Client-Listenänderung.

Konstanter Wert: 2 (0x00000002)

CHANGE_PROFILEABLE_CLIENT_LIST

public static final int CHANGE_PROFILEABLE_CLIENT_LIST

Bitmaske für Geräteänderungen: ProfileableClient-Listenänderung.

Konstanter Wert: 8 (0x00000008)

CHANGE_STATE

public static final int CHANGE_STATE

Geräteänderungs-Bitmaske: DeviceState-Änderung.

Konstanter Wert: 1 (0x00000001)

FIRST_EMULATOR_SN

public static final String FIRST_EMULATOR_SN

Die Seriennummer des ersten verbundenen Emulators.

Constant Value: "emulator-5554"

MNT_DATA

public static final String MNT_DATA

Konstanter Wert: "ANDROID_DATA"

MNT_EXTERNAL_STORAGE

public static final String MNT_EXTERNAL_STORAGE

Konstanter Wert: "EXTERNAL_STORAGE"

MNT_ROOT

public static final String MNT_ROOT

Konstanter Wert: „ANDROID_ROOT“

PROP_BUILD_API_LEVEL

public static final String PROP_BUILD_API_LEVEL

Konstanter Wert: "ro.build.version.sdk"

PROP_BUILD_CHARACTERISTICS

public static final String PROP_BUILD_CHARACTERISTICS

Konstanter Wert: "ro.build.characteristics"

PROP_BUILD_CODENAME

public static final String PROP_BUILD_CODENAME

Konstanter Wert: "ro.build.version.codename"

PROP_BUILD_TAGS

public static final String PROP_BUILD_TAGS

Konstanter Wert: "ro.build.tags"

PROP_BUILD_TYPE

public static final String PROP_BUILD_TYPE

Konstanter Wert: "ro.build.type"

PROP_BUILD_VERSION

public static final String PROP_BUILD_VERSION

Konstanter Wert: "ro.build.version.release"

PROP_BUILD_VERSION_NUMBER

public static final String PROP_BUILD_VERSION_NUMBER

Diese Konstante ist veraltet.
Verwenden Sie PROP_BUILD_API_LEVEL.

Konstanter Wert: "ro.build.version.sdk"

PROP_DEBUGGABLE

public static final String PROP_DEBUGGABLE

Konstanter Wert: "ro.debuggable"

PROP_DEVICE_CPU_ABI

public static final String PROP_DEVICE_CPU_ABI

Konstanter Wert: "ro.product.cpu.abi"

PROP_DEVICE_CPU_ABI2

public static final String PROP_DEVICE_CPU_ABI2

Konstanter Wert: "ro.product.cpu.abi2"

PROP_DEVICE_CPU_ABI_LIST

public static final String PROP_DEVICE_CPU_ABI_LIST

Konstanter Wert: "ro.product.cpu.abilist"

PROP_DEVICE_DENSITY

public static final String PROP_DEVICE_DENSITY

Konstanter Wert: "ro.sf.lcd_density"

PROP_DEVICE_EMULATOR_DENSITY

public static final String PROP_DEVICE_EMULATOR_DENSITY

Konstanter Wert: "qemu.sf.lcd_density"

PROP_DEVICE_LANGUAGE

public static final String PROP_DEVICE_LANGUAGE

Konstanter Wert: "persist.sys.language"

PROP_DEVICE_MANUFACTURER

public static final String PROP_DEVICE_MANUFACTURER

Konstanter Wert: "ro.product.manufacturer"

PROP_DEVICE_MODEL

public static final String PROP_DEVICE_MODEL

Konstanter Wert: "ro.product.model"

PROP_DEVICE_REGION

public static final String PROP_DEVICE_REGION

Konstanter Wert: "persist.sys.country"

RE_EMULATOR_SN

public static final String RE_EMULATOR_SN

Regulärer Ausdruck für die Seriennummer des Emulators.

Konstanter Wert: "emulator-(\d+)"

UNKNOWN_PACKAGE

public static final String UNKNOWN_PACKAGE

Konstanter Wert: ""

Öffentliche Methoden

arePropertiesSet

public abstract boolean arePropertiesSet ()

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

Returns
boolean

createForward

public abstract 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
TimeoutException bei Zeitüberschreitung der Verbindung.
AdbCommandRejectedException Wenn der Befehl von ADB abgelehnt wird
bei einem E/A-Fehler bei der Verbindung.

createForward

public abstract 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
TimeoutException bei Zeitüberschreitung der Verbindung.
AdbCommandRejectedException Wenn der Befehl von ADB abgelehnt wird
bei einem E/A-Fehler bei der Verbindung.

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
TimeoutException bei Zeitüberschreitung der Verbindung.
AdbCommandRejectedException Wenn der Befehl von ADB abgelehnt wird
bei einem E/A-Fehler bei der Verbindung.

executeBinderCommand

public void executeBinderCommand (String[] parameters, 
                IShellOutputReceiver receiver, 
                long maxTimeToOutputResponse, 
                TimeUnit maxTimeUnits, 
                InputStream is)

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

Dazu wird der Aufruf exec:cmd oder, falls sowohl das Gerätebetriebssystem als auch der Host-ADB-Server die Ausführungsfunktion von Android Binder Bridge unterstützen, der schnellere Aufruf abb_exec: verwendet.

Parameter
parameters String: Der auszuführende Binder-Befehl.
receiver IShellOutputReceiver: die IShellOutputReceiver, die die Ausgabe des Binder-Befehls empfängt
maxTimeToOutputResponse long

maxTimeUnits TimeUnit

is InputStream: optionaler Eingabestream, der über stdin gesendet werden soll
Ausgabe
TimeoutException bei Zeitüberschreitung der Verbindung.
AdbCommandRejectedException Wenn der Befehl von ADB abgelehnt wird
ShellCommandUnresponsiveException wenn der Binder-Befehl für einen bestimmten Zeitraum keine Ausgabe sendet.
bei einem E/A-Fehler bei der Verbindung.

Weitere Informationen

executeShellCommand

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

Eine Version des Befehls „executeShell“, die einen Eingabestream für die Übertragung über „stdin“ akzeptieren kann.

Parameter
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse long

maxTimeUnits TimeUnit

is InputStream

Ausgabe
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

executeShellCommand

public abstract 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
TimeoutException bei Zeitüberschreitung der Verbindung.
AdbCommandRejectedException Wenn der Befehl von ADB abgelehnt wird
ShellCommandUnresponsiveException wenn der Shell-Befehl über einen bestimmten Zeitraum keine Ausgabe sendet.
bei einem E/A-Fehler bei der Verbindung.

executeShellCommand

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

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

Parameter
command String

receiver IShellOutputReceiver

maxTimeToOutputResponse int

Ausgabe
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

forceStop

public void forceStop (String applicationName)

Beenden einer App nach Anwendungsname erzwingen Dadurch werden alle ausstehenden Benachrichtigungen und in der Warteschlange befindlichen Berechnungen entfernt.

Parameter
applicationName String: der Name der Anwendung

getAbis

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

getAvdData

public ListenableFuture<AvdData> getAvdData ()

Gibt Informationen zum AVD zurück, auf dem der Emulator ausgeführt wird.

AvdData.getName ist der Name des AVD oder null, wenn keiner vorhanden ist.

AvdData.getPath ist der AVD-Pfad oder „null“, wenn es sich um ein physisches Gerät handelt, der Emulator-Konsolenunterbefehl fehlgeschlagen ist oder die Emulatorversion älter als 30.0.18 ist.

Returns
ListenableFuture<AvdData> die AvdData für das Gerät.

getAvdName

public abstract 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 abstract 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 abstract  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 abstract  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 abstract Integer getBatteryLevel (long freshnessMs)

Diese Methode wurde eingestellt.
getBattery(long, TimeUnit) verwenden

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
com.android.ddmlib.ShellCommandUnresponsiveException
AdbCommandRejectedException
ShellCommandUnresponsiveException
TimeoutException

getBatteryLevel

public abstract Integer getBatteryLevel ()

Diese Methode wurde eingestellt.
getBattery() verwenden

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 abstract 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 abstract 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 abstract Client[] getClients ()

Gibt das Array von Clients zurück.

Returns
Client[]

getDensity

public abstract 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 abstract FileListingService getFileListingService ()

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

Returns
FileListingService

getHardwareCharacteristics

public  getHardwareCharacteristics ()

Gibt Funktionen zurück, die durch Lesen des Attributs „Build-Merkmale“ abgerufen wurden.

Returns

getLanguage

public abstract String getLanguage ()

Gibt die Sprache des Nutzers zurück.

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

getLastInstallMetrics

public InstallMetrics getLastInstallMetrics ()

Ruft die Informationen zur letzten Installation auf diesem Gerät ab.

Returns
InstallMetrics InstallMetrics-Messwerte zur Beschreibung der Installation.

getMountPoint

public abstract String getMountPoint (String name)

Gibt einen Bereitstellungspunkt zurück.

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

Weitere Informationen

getProfileableClients

public ProfileableClient[] getProfileableClients ()

Gibt das Array der profilierbaren Clients zurück.

Returns
ProfileableClient[]

getProperties

public abstract  getProperties ()

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

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

Returns

getProperty

public abstract 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 abstract String getPropertyCacheOrSync (String name)

Diese Methode wurde eingestellt.
Verwenden Sie stattdessen IShellEnabledDevice.getSystemProperty(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
TimeoutException bei Zeitüberschreitung der Verbindung.
AdbCommandRejectedException Wenn der Befehl von ADB abgelehnt wird
ShellCommandUnresponsiveException wenn der Shell-Befehl über einen bestimmten Zeitraum keine Ausgabe sendet.
bei einem E/A-Fehler bei der Verbindung.

getPropertyCount

public abstract int getPropertyCount ()

Diese Methode wurde eingestellt.
Implementierungsdetail

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

Returns
int

getPropertySync

public abstract String getPropertySync (String name)

Diese Methode wurde eingestellt.
IShellEnabledDevice.getSystemProperty(String) verwenden

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
TimeoutException bei Zeitüberschreitung der Verbindung.
AdbCommandRejectedException Wenn der Befehl von ADB abgelehnt wird
ShellCommandUnresponsiveException wenn der Shell-Befehl über einen bestimmten Zeitraum keine Ausgabe sendet.
bei einem E/A-Fehler bei der Verbindung.

getRegion

public abstract String getRegion ()

Gibt die Region des Nutzers zurück.

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

getScreenshot

public abstract 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
TimeoutException bei Zeitüberschreitung der Verbindung.
AdbCommandRejectedException Wenn der Befehl von ADB abgelehnt wird
bei einem E/A-Fehler bei der Verbindung.

getScreenshot

public abstract RawImage getScreenshot (long timeout, 
                TimeUnit unit)

Parameter
timeout long

unit TimeUnit

Returns
RawImage

Ausgabe
AdbCommandRejectedException
TimeoutException

getSerialNumber

public abstract String getSerialNumber ()

Gibt die Seriennummer des Geräts zurück.

Returns
String

getState

public abstract IDevice.DeviceState getState ()

Gibt den Status des Geräts zurück.

Returns
IDevice.DeviceState

getSyncService

public abstract 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
TimeoutException bei Zeitüberschreitung der Verbindung.
AdbCommandRejectedException Wenn der Befehl von ADB abgelehnt wird
wenn die Verbindung mit adb fehlgeschlagen ist.

hasClients

public abstract boolean hasClients ()

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

Returns
boolean

installPackage

public abstract 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 wenn die Installation fehlschlägt.

installPackage

public abstract 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 wenn die Installation fehlschlägt.

installPackage

public abstract 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 wenn die Installation fehlschlägt.

installPackages

public void installPackages ( apks, 
                boolean reinstall, 
                 installOptions)

Installiert eine Android-Anwendung, die aus mehreren APK-Dateien besteht (ein Haupt-APK und 0..n Split-Pakete) mit dem Standard-Zeitlimit.

Parameter
apks : Liste der zu installierenden APKs (1 Haupt-APK + 0..n Split-APKs)
reinstall boolean: auf true setzen, wenn die App neu installiert werden soll
installOptions : 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 wenn die Installation fehlschlägt.

installPackages

public abstract void installPackages ( apks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

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

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

installRemotePackage

public abstract 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 wenn die Installation fehlschlägt.

installRemotePackage

public abstract 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 wenn die Installation fehlschlägt.

installRemotePackage

public abstract 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 wenn die Installation fehlschlägt.

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions)

Installiert eine Android-Anwendung, die aus mehreren APK-Dateien besteht, die sich lokal auf dem Gerät befinden, mit dem Standard-Timeout.

Parameter
remoteApks : Liste der APK-Dateipfade auf dem Gerät, die installiert werden sollen
reinstall boolean: auf true setzen, wenn die App neu installiert werden soll
installOptions : 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 wenn die Installation fehlschlägt.

installRemotePackages

public void installRemotePackages ( remoteApks, 
                boolean reinstall, 
                 installOptions, 
                long timeout, 
                TimeUnit timeoutUnit)

Installiert eine Android-Anwendung, die aus mehreren APK-Dateien besteht, die sich lokal auf dem Gerät befinden

Parameter
remoteApks : Liste der APK-Dateipfade auf dem Gerät, die installiert werden sollen
reinstall boolean: auf true setzen, wenn die App neu installiert werden soll
installOptions : Optionale zusätzliche Argumente, die übergeben werden sollen. Weitere Informationen zu den verfügbaren Optionen finden Sie unter „adb shell pm install --help“.
timeout long: Installationszeitüberschreitung
timeoutUnit TimeUnit: ERROR(/TimeUnit) entsprechend dem Zeitlimitparameter
Ausgabe
InstallException wenn die Installation fehlschlägt.

isBootLoader

public abstract 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 abstract boolean isEmulator ()

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

Returns
boolean

isOffline

public abstract boolean isOffline ()

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

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

isOnline

public abstract boolean isOnline ()

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

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

isRoot

public abstract 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
TimeoutException bei Zeitüberschreitung der Verbindung.
AdbCommandRejectedException wenn der Befehl von ADB abgelehnt wird.
ShellCommandUnresponsiveException

aufhören

public void kill (String applicationName)

Beendet eine Anwendung anhand ihres Namens. Dadurch werden nur die Aktivitäten zerstört, der Status bleibt im Android-System erhalten.

Parameter
applicationName String: der Name der Anwendung

pullFile

public abstract 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
im Falle einer E/A-Ausnahme.
AdbCommandRejectedException Wenn der Befehl von ADB abgelehnt wird
TimeoutException bei einer Zeitüberschreitung beim Lesen von Antworten vom Gerät.
SyncException bei einer Synchronisierungsabweichung.

push

public void push (String[] local, 
                String remote)

Überträgt mehrere Dateien oder Verzeichnisse.

Parameter
local String: die lokalen Dateien, die übertragen werden sollen
remote String: der Remote-Pfad, der ein Verzeichnis darstellt
Ausgabe
bei einem E/A-Fehler bei der Verbindung
AdbCommandRejectedException Wenn der Befehl von ADB abgelehnt wird
TimeoutException bei einer Zeitüberschreitung beim Lesen von Antworten vom Gerät
SyncException wenn einige Dateien nicht übertragen werden konnten

pushFile

public abstract void pushFile (String local, 
                String remote)

Pushes a single file.

Parameter
local String: der lokale Dateipfad.
remote String: der Remote-Dateipfad
Ausgabe
bei einem E/A-Fehler bei der Verbindung
AdbCommandRejectedException Wenn der Befehl von ADB abgelehnt wird
TimeoutException bei einer Zeitüberschreitung beim Lesen von Antworten vom Gerät
SyncException wenn die Datei nicht übertragen werden konnte

rawBinder

public SocketChannel rawBinder (String service, 
                String[] parameters)

Den Android Binder Bridge-Dienst auf einem Remote-Gerät aufrufen Gibt einen Socket-Channel zurück, der mit dem Gerätebinder-Befehl verbunden ist.

Das Eigentum am SocketChannel wird an den Aufrufer übertragen. Er muss nach der Verwendung explizit geschlossen werden.

Parameter
service String: Der Name des Android-Dienstes, zu dem eine Verbindung hergestellt werden soll.
parameters String: die Parameter des Binder-Befehls
Returns
SocketChannel Ein SocketChannel, der mit dem ausgeführten Prozess auf dem Gerät verbunden ist.
Ausgabe
AdbCommandRejectedException
TimeoutException

rawExec

public SocketChannel rawExec (String executable, 
                String[] parameters)

Rufen Sie den Dienst „host:exec“ auf einem Remote-Gerät auf. Gibt einen Socket-Channel zurück, der mit dem ausgeführten Prozess verbunden ist. Der Exec-Dienst unterscheidet nicht zwischen stdout und stderr. Was vom Socket gelesen wird, kann also aus beiden Ausgaben stammen und verschachtelt sein.

Das Eigentum am SocketChannel wird an den Aufrufer übertragen. Er muss nach der Verwendung explizit geschlossen werden.

Parameter
executable String

parameters String

Returns
SocketChannel Ein SocketChannel, der mit dem ausgeführten Prozess auf dem Gerät verbunden ist.
Ausgabe
AdbCommandRejectedException
TimeoutException

neu starten

public abstract 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
TimeoutException bei Zeitüberschreitung der Verbindung.
AdbCommandRejectedException Wenn der Befehl von ADB abgelehnt wird
IOException

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
TimeoutException bei Zeitüberschreitung der Verbindung.
AdbCommandRejectedException Wenn der Befehl von ADB abgelehnt wird
bei einem E/A-Fehler bei der Verbindung.

removeForward

public void removeForward (int localPort, 
                int remotePort)

Diese Methode wurde eingestellt.
removeForward(int) verwenden

Parameter
localPort int

remotePort int

Ausgabe
AdbCommandRejectedException
TimeoutException

removeForward

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

Diese Methode wurde eingestellt.
removeForward(int) verwenden

Parameter
localPort int

remoteSocketName String

namespace IDevice.DeviceUnixSocketNamespace

Ausgabe
AdbCommandRejectedException
TimeoutException

removeRemotePackage

public abstract 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 wenn die Installation fehlschlägt.

removeReverse

public void removeReverse (int remotePort)

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

Parameter
remotePort int: der Remote-Port.
Ausgabe
TimeoutException bei Zeitüberschreitung der Verbindung.
AdbCommandRejectedException Wenn der Befehl von ADB abgelehnt wird
bei einem E/A-Fehler bei der Verbindung.

root

public abstract 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
TimeoutException bei Zeitüberschreitung der Verbindung.
AdbCommandRejectedException wenn der Befehl von ADB abgelehnt wird.
ShellCommandUnresponsiveException wenn der Root-Status nicht abgefragt werden kann.
IOException

startScreenRecorder

public abstract 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 abstract boolean supportsFeature (IDevice.HardwareFeature feature)

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

Parameter
feature IDevice.HardwareFeature

Returns
boolean

supportsFeature

public abstract 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 abstract 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
TimeoutException bei Zeitüberschreitung der Verbindung.
AdbCommandRejectedException Wenn der Befehl von ADB abgelehnt wird
bei einem E/A-Fehler bei der Verbindung.
SyncException wenn beim Pushen des Pakets auf das Gerät ein Fehler auftritt.

uninstallApp

public abstract 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 wenn die Deinstallation fehlschlägt.

uninstallPackage

public abstract 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 wenn die Deinstallation fehlschlägt.