IDeviceManager
public
interface
IDeviceManager
com.android.tradefed.device.IDeviceManager |
Benutzeroberfläche zum Verwalten der für Tests verfügbaren Geräte.
Zusammenfassung
Verschachtelte Klassen | |
---|---|
interface |
IDeviceManager.IFastbootListener
Ein Listener für Änderungen des Fastboot-Status. |
Öffentliche Methoden | |
---|---|
abstract
void
|
addDeviceMonitor(IDeviceMonitor mon)
Fügt |
abstract
void
|
addFastbootListener(IDeviceManager.IFastbootListener listener)
Informiert den Manager darüber, dass ein Listener an Änderungen des Fastboot-Status interessiert ist. |
abstract
void
|
addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)
Fügen Sie dem Fastboot-Monitor ein Gerät hinzu. |
abstract
ITestDevice
|
allocateDevice(IDeviceSelection options, boolean isTemporary)
Sie können ein Gerät für Tests anfordern, das bestimmte Kriterien erfüllt. |
abstract
ITestDevice
|
allocateDevice(IDeviceSelection options)
Sie können ein Gerät für Tests anfordern, das bestimmte Kriterien erfüllt. |
abstract
ITestDevice
|
allocateDevice()
Testgerät anfordern |
abstract
ITestDevice
|
connectToTcpDevice(String ipAndPort)
Verbindung mit einem Gerät über adb-over-tcp herstellen
Mit dieser Methode wird ein neues Gerät zugewiesen, das später über
Die zurückgegebene |
abstract
boolean
|
disconnectFromTcpDevice(ITestDevice tcpDevice)
Trennen Sie die Verbindung zu einem Gerät, das über adb-over-tcp verbunden ist. |
abstract
void
|
displayDevicesInfo(PrintWriter printWriter, boolean includeStub)
Eine nutzerfreundliche Beschreibung mit einer Liste der bekannten Geräte, ihrem Status und den Werten für häufig verwendete |
abstract
CommandResult
|
executeCmdOnAvailableDevice(String serial, String command, long timeout, TimeUnit timeUnit)
Eine Hilfsmethode zum Ausführen eines Shell-Befehls auf einem verfügbaren Gerät. |
abstract
ITestDevice
|
forceAllocateDevice(String serial)
Ein Gerät zugewiesen, das derzeit nicht verfügbar ist. |
abstract
void
|
freeDevice(ITestDevice device, FreeDeviceState state)
Gerät in den Pool zurückgeben Versuche, ein Gerät zurückzugeben, das noch nicht zugewiesen wurde, werden ignoriert. |
abstract
String
|
getAdbPath()
Gibt den Pfad zur zu verwendenden adb-Binärdatei zurück. |
abstract
String
|
getAdbVersion()
Ruft die aktuell vom Gerätemanager verwendete adb-Version ab. |
abstract
DeviceDescriptor
|
getDeviceDescriptor(String serial)
Gibt den DeviceDescriptor mit der angegebenen Seriennummer zurück. |
abstract
String
|
getFastbootPath()
Gibt den Pfad zur zu verwendenden Fastboot-Binärdatei zurück. |
abstract
void
|
init(IDeviceSelection globalDeviceFilter,
Initialisieren Sie den Gerätemanager mit einem Gerätefilter. |
abstract
void
|
init()
Initialisieren Sie den Gerätemanager. |
abstract
boolean
|
isEmulator(String serial)
Prüfen, ob eine angegebene Seriennummer für einen Emulator steht |
default
boolean
|
isFileSystemMountCheckEnabled()
Gibt an, ob in |
abstract
boolean
|
isNullDevice(String serial)
Prüfen, ob eine angegebene Seriennummer ein Nullgerät darstellt |
abstract
void
|
killEmulator(ITestDevice device)
Den angegebenen Emulator herunterfahren. |
abstract
void
|
launchEmulator(ITestDevice device, long bootTimeout, IRunUtil runUtil,
Hilfsmethode zum Starten des Emulators. |
abstract
|
listAllDevices(boolean shortDescriptor)
Gibt eine Liste von DeviceDescriptors für alle bekannten Geräte zurück. |
abstract
|
listAllDevices()
Gibt eine Liste von DeviceDescriptors für alle bekannten Geräte zurück. |
abstract
ITestDevice
|
reconnectDeviceToTcp(ITestDevice usbDevice)
Eine Hilfsmethode, die das angegebene USB-Gerät in den adb-over-tcp-Modus umschaltet und dann über |
abstract
void
|
removeDeviceMonitor(IDeviceMonitor mon)
Entfernt eine zuvor hinzugefügte |
abstract
void
|
removeFastbootListener(IDeviceManager.IFastbootListener listener)
Informiert den Manager darüber, dass ein Listener nicht mehr an Änderungen des Fastboot-Status interessiert ist. |
abstract
void
|
restartAdbBridge()
Starten Sie die adb-Bridge neu, falls |
abstract
void
|
stopAdbBridge()
Die adb-Bridge und Dienste, die von adb-Verbindungen abhängen, werden angehalten. |
abstract
void
|
terminate()
Beendet die Geräteüberwachungsdienste und beendet die DDM-Bibliothek. |
abstract
void
|
terminateDeviceMonitor()
Beenden Sie die Gerätemonitore. |
abstract
void
|
terminateDeviceRecovery()
Beendet den Thread zur Gerätewiederherstellung. |
default
void
|
terminateHard(String reason)
Ähnlich wie |
abstract
void
|
terminateHard()
Wie |
abstract
boolean
|
waitForFirstDeviceAdded(long timeout)
Warten Sie, bis ein erstes physisches Gerät verbunden ist. |
Öffentliche Methoden
addDeviceMonitor
public abstract void addDeviceMonitor (IDeviceMonitor mon)
Fügt IDeviceMonitor
hinzu
Parameter | |
---|---|
mon |
IDeviceMonitor |
addFastbootListener
public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)
Informiert den Manager darüber, dass ein Listener an Änderungen des Fastboot-Status interessiert ist.
Derzeit überwacht ein IDeviceManager
nur Geräte im Fastboot-Modus, wenn mindestens ein aktiver Listener vorhanden ist.
TODO: Das ist ein bisschen ein Hack – eine bessere Lösung finden
addMonitoringTcpFastbootDevice
public abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)
Fügen Sie dem Fastboot-Monitor ein Gerät hinzu. Der Fastboot-Monitor verwendet „fastboot_serial“, um mit dem Gerät zu kommunizieren.
Parameter | |
---|---|
serial |
String : die Seriennummer des Geräts. |
fastboot_serial |
String : die Seriennummer des Geräts im Fastboot-Modus. |
allocateDevice
public abstract ITestDevice allocateDevice (IDeviceSelection options, boolean isTemporary)
Sie können ein Gerät für Tests anfordern, das bestimmte Kriterien erfüllt.
Parameter | |
---|---|
options |
IDeviceSelection : die IDeviceSelection , die das Gerät erfüllen sollte. |
isTemporary |
boolean : ob ein temporäres Nullgerät erstellt werden soll. |
Returns | |
---|---|
ITestDevice |
ITestDevice für Tests oder null , wenn keine verfügbar ist |
allocateDevice
public abstract ITestDevice allocateDevice (IDeviceSelection options)
Sie können ein Gerät für Tests anfordern, das bestimmte Kriterien erfüllt.
Parameter | |
---|---|
options |
IDeviceSelection : die IDeviceSelection , die das Gerät erfüllen sollte. |
Returns | |
---|---|
ITestDevice |
ITestDevice für Tests oder null , wenn keine verfügbar ist |
allocateDevice
public abstract ITestDevice allocateDevice ()
Testgerät anfordern
Returns | |
---|---|
ITestDevice |
ITestDevice für Tests oder null , wenn keine verfügbar ist |
connectToTcpDevice
public abstract ITestDevice connectToTcpDevice (String ipAndPort)
Verbindung mit einem Gerät über adb-over-tcp herstellen
Mit dieser Methode wird ein neues Gerät zugewiesen, das später über disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)
freigegeben werden sollte.
Die zurückgegebene ITestDevice
ist online, reagiert aber möglicherweise nicht.
Beachten Sie, dass durch Aktionen wie einen Neustart auf einem Gerät mit TCP-Verbindung die TCP-Verbindung zum Gerät getrennt wird und ein DeviceNotAvailableException
Parameter | |
---|---|
ipAndPort |
String : die ursprüngliche IP-Adresse und der Port des Geräts, mit dem eine Verbindung hergestellt werden soll |
Returns | |
---|---|
ITestDevice |
ITestDevice oder null , wenn keine TCP-Verbindung hergestellt werden konnte |
disconnectFromTcpDevice
public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)
Trennen Sie die Verbindung zu einem Gerät, das über adb-over-tcp verbunden ist.
Das Gerät wird wieder in den USB-Modus versetzt und freigegeben.
Parameter | |
---|---|
tcpDevice |
ITestDevice : das Gerät, das sich derzeit im TCP-Modus befindet und zuvor über connectToTcpDevice(String) zugewiesen wurde |
Returns | |
---|---|
boolean |
true ob der Wechsel in den USB-Modus erfolgreich war |
displayDevicesInfo
public abstract void displayDevicesInfo (PrintWriter printWriter, boolean includeStub)
Eine nutzerfreundliche Beschreibung mit einer Liste der bekannten Geräte, ihrem Status und den Werten für häufig verwendete IDeviceSelection
-Optionen ausgeben.
Parameter | |
---|---|
printWriter |
PrintWriter : ERROR(/PrintWriter) , in dem die Beschreibung ausgegeben werden soll |
includeStub |
boolean : Ob auch Stub-Geräte angezeigt werden sollen. |
executeCmdOnAvailableDevice
public abstract CommandResult executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit)
Eine Hilfsmethode zum Ausführen eines Shell-Befehls auf einem verfügbaren Gerät.
Parameter | |
---|---|
serial |
String : Die Geräteserie. |
command |
String : Der Shell-Befehl. |
timeout |
long : Die Zeit, die der Befehl benötigt, um ausgeführt zu werden. |
timeUnit |
TimeUnit : Die Einheit für die Zeitüberschreitung. |
Returns | |
---|---|
CommandResult |
Ein CommandResult . |
forceAllocateDevice
public abstract ITestDevice forceAllocateDevice (String serial)
Ein Gerät zugewiesen, das derzeit nicht verfügbar ist.
Hat keine Auswirkungen, wenn das Gerät bereits zugewiesen ist.
Parameter | |
---|---|
serial |
String : Die zuzuweisende Geräteseriennummer |
Returns | |
---|---|
ITestDevice |
ITestDevice oder null , falls keine Zuweisung möglich war |
freeDevice
public abstract void freeDevice (ITestDevice device, FreeDeviceState state)
Gerät in den Pool zurückgeben
Versuche, ein Gerät zurückzugeben, das noch nicht zugewiesen wurde, werden ignoriert.
Parameter | |
---|---|
device |
ITestDevice : die ITestDevice zu „kostenlos“ |
state |
FreeDeviceState : die FreeDeviceState . Wird verwendet, um festzulegen, ob das Gerät in den verfügbaren Gerätepool zurückgegeben wird. |
getAdbPath
public abstract String getAdbPath ()
Gibt den Pfad zur zu verwendenden adb-Binärdatei zurück.
Returns | |
---|---|
String |
getAdbVersion
public abstract String getAdbVersion ()
Ruft die aktuell vom Gerätemanager verwendete adb-Version ab.
Returns | |
---|---|
String |
getDeviceDescriptor
public abstract DeviceDescriptor getDeviceDescriptor (String serial)
Gibt den DeviceDescriptor mit der angegebenen Seriennummer zurück.
Parameter | |
---|---|
serial |
String : Seriennummer des Geräts, für das die Informationen abgerufen werden sollen |
Returns | |
---|---|
DeviceDescriptor |
die DeviceDescriptor für das ausgewählte Gerät oder „null“, wenn die Seriennummer nicht mit einem bekannten Gerät übereinstimmt. |
getFastbootPath
public abstract String getFastbootPath ()
Gibt den Pfad zur zu verwendenden Fastboot-Binärdatei zurück.
Returns | |
---|---|
String |
init
public abstract void init (IDeviceSelection globalDeviceFilter,deviceMonitors)
Initialisieren Sie den Gerätemanager mit einem Gerätefilter. Mit diesem Filter können Sie den DeviceManager anweisen, bestimmte verbundene Geräte zu ignorieren.
Parameter | |
---|---|
globalDeviceFilter |
IDeviceSelection : Gerätefilter |
deviceMonitors |
|
init
public abstract void init ()
Initialisieren Sie den Gerätemanager. Diese Methode muss nur einmal aufgerufen werden, bevor andere Methoden aufgerufen werden.
isEmulator
public abstract boolean isEmulator (String serial)
Prüfen, ob eine angegebene Seriennummer für einen Emulator steht
Parameter | |
---|---|
serial |
String |
Returns | |
---|---|
boolean |
isFileSystemMountCheckEnabled
public boolean isFileSystemMountCheckEnabled ()
Gibt an, ob in NativeDeviceStateMonitor
geprüft werden soll, ob das Dateisystem korrekt bereitgestellt wurde.
Returns | |
---|---|
boolean |
isNullDevice
public abstract boolean isNullDevice (String serial)
Prüfen, ob eine angegebene Seriennummer ein Nullgerät darstellt
Parameter | |
---|---|
serial |
String |
Returns | |
---|---|
boolean |
killEmulator
public abstract void killEmulator (ITestDevice device)
Den angegebenen Emulator herunterfahren.
Blockiert, bis der Emulator aus adb verschwindet. Hat keine Auswirkungen, wenn der Emulator bereits nicht verfügbar ist.
Parameter | |
---|---|
device |
ITestDevice : der ITestDevice , der den zu beendenden Emulator darstellt |
Ausgabe | |
---|---|
DeviceNotAvailableException |
if emulator fails to shut down |
launchEmulator
public abstract void launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil,emulatorArgs)
Hilfsmethode zum Starten des Emulators.
Startet den Emulator wie vom Aufrufer angegeben
Parameter | |
---|---|
device |
ITestDevice : Platzhalter ITestDevice für das zugewiesene Emulatorgerät |
bootTimeout |
long : die Zeit in ms, die gewartet wird, bis der Emulator gestartet ist |
emulatorArgs |
: Befehlszeilenargumente zum Starten des Emulators |
Ausgabe | |
---|---|
DeviceNotAvailableException |
Wenn der Emulator nicht startet oder nicht online kommt |
listAllDevices
public abstractlistAllDevices (boolean shortDescriptor)
Gibt eine Liste von DeviceDescriptors für alle bekannten Geräte zurück.
Parameter | |
---|---|
shortDescriptor |
boolean : ob Beschreibungen auf die Mindestinformationen beschränkt werden sollen |
Returns | |
---|---|
|
eine Liste mit DeviceDescriptor für alle bekannten Geräte |
listAllDevices
public abstractlistAllDevices ()
Gibt eine Liste von DeviceDescriptors für alle bekannten Geräte zurück.
Returns | |
---|---|
|
eine Liste mit DeviceDescriptor für alle bekannten Geräte |
reconnectDeviceToTcp
public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)
Eine Hilfsmethode, die das angegebene USB-Gerät in den adb-over-tcp-Modus umschaltet und dann über connectToTcpDevice(String)
eine Verbindung dazu herstellt.
Parameter | |
---|---|
usbDevice |
ITestDevice : das Gerät, das sich derzeit im USB-Modus befindet |
Returns | |
---|---|
ITestDevice |
die neu zugewiesene ITestDevice im TCP-Modus oder null , wenn keine TCP-Verbindung hergestellt werden konnte |
Ausgabe | |
---|---|
DeviceNotAvailableException |
wenn die Verbindung zu usbDevice unterbrochen wurde und nicht wiederhergestellt werden konnte |
removeDeviceMonitor
public abstract void removeDeviceMonitor (IDeviceMonitor mon)
Entfernt eine zuvor hinzugefügte IDeviceMonitor
. Hat keine Auswirkungen, wenn mon nicht hinzugefügt wurde.
Parameter | |
---|---|
mon |
IDeviceMonitor |
removeFastbootListener
public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)
Informiert den Manager darüber, dass ein Listener nicht mehr an Änderungen des Fastboot-Status interessiert ist.
restartAdbBridge
public abstract void restartAdbBridge ()
Starten Sie die adb-Bridge neu, falls stopAdbBridge()
aufgerufen wurde, und die Dienste, die von adb-Verbindungen abhängen.
stopAdbBridge
public abstract void stopAdbBridge ()
Die adb-Bridge und Dienste, die von adb-Verbindungen abhängen, werden angehalten.
beenden
public abstract void terminate ()
Beendet die Geräteüberwachungsdienste und beendet die DDM-Bibliothek.
Diese Funktion muss beim Beenden der Anwendung aufgerufen werden.
Weitere Informationen
terminateDeviceMonitor
public abstract void terminateDeviceMonitor ()
Beenden Sie die Gerätemonitore.
terminateDeviceRecovery
public abstract void terminateDeviceRecovery ()
Beendet den Thread zur Gerätewiederherstellung.
terminateHard
public void terminateHard (String reason)
Ähnlich wie terminateHard()
.
Parameter | |
---|---|
reason |
String : Optionaler Grund für die Kündigung. |
terminateHard
public abstract void terminateHard ()
Wie terminate()
, aber es wird auch versucht, adb zu beenden.
waitForFirstDeviceAdded
public abstract boolean waitForFirstDeviceAdded (long timeout)
Warten Sie, bis ein erstes physisches Gerät verbunden ist. Wenn ein Gerät bereits verbunden war, wird direkt „True“ zurückgegeben. Wenn kein Gerät hinzugefügt wurde, wird nach Ablauf der Zeitüberschreitung „false“ zurückgegeben.
Parameter | |
---|---|
timeout |
long : Zeit in Millisekunden, die gewartet wird, bevor „false“ zurückgegeben wird. |
Returns | |
---|---|
boolean |