IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager.


Benutzeroberfläche zum Verwalten der Gruppe verfügbarer Geräte für Tests.

Zusammenfassung

Verschachtelte Klassen

interface IDeviceManager.IFastbootListener

Listener für Statusänderungen von Fastboot-Status. 

Öffentliche Methoden

abstract void addDeviceMonitor(IDeviceMonitor mon)

Fügt ein IDeviceMonitor hinzu

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üge dem Fastboot Monitor ein Gerät hinzu.

abstract ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

Fordere ein Gerät zum Testen an, das bestimmte Kriterien erfüllt.

abstract ITestDevice allocateDevice(IDeviceSelection options)

Fordere ein Gerät zum Testen an, das bestimmte Kriterien erfüllt.

abstract ITestDevice allocateDevice()

Physisches Gerät zum Testen anfordern

abstract ITestDevice connectToTcpDevice(String ipAndPort)

Mit ADB-over-tcp eine Verbindung zu einem Gerät herstellen

Mit dieser Methode wird ein neues Gerät zugewiesen, das schließlich über disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

Die zurückgegebene ITestDevice ist online, reagiert aber möglicherweise nicht.

abstract boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

Trennen Sie die Verbindung zu einem mit ADB-over-tcp verbundenen Gerät.

abstract void displayDevicesInfo(PrintWriter printWriter, boolean includeStub)

Ausgabe einer nutzerfreundlichen Beschreibung mit einer Liste bekannter Geräte, deren Status und Werten für häufig verwendete IDeviceSelection-Optionen.

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)

Weisen Sie unhöflich ein Gerät zu, auch wenn es im Moment nicht verfügbar ist.

abstract void freeDevice(ITestDevice device, FreeDeviceState state)

Gerät an den Pool zurückgeben

Versuche, ein noch nicht zugewiesenes Gerät zurückzugeben, werden ignoriert.

abstract String getAdbPath()

Gibt den Pfad zur zu verwendenden ADB-Binärdatei zurück.

abstract String getAdbVersion()

Laden Sie die ADB-Version herunter, die derzeit vom Gerätemanager verwendet wird.

abstract DeviceDescriptor getDeviceDescriptor(String serial)

Gibt den DeviceDescriptor mit der angegebenen Seriennummer zurück.

abstract String getFastbootPath()

Gibt den Pfad zum Fastboot-Binärprogramm zurück, das verwendet werden soll.

abstract void init(IDeviceSelection globalDeviceFilter, deviceMonitors)

Gerätemanager mit einem Gerätefilter initialisieren

abstract void init()

Initialisieren Sie den Gerätemanager.

abstract boolean isEmulator(String serial)

Bestimmt, ob die angegebene Seriennummer einen Emulator darstellt

default boolean isFileSystemMountCheckEnabled()

Gibt zurück, ob in NativeDeviceStateMonitor geprüft werden soll, ob das Dateisystem korrekt montiert sind.

abstract boolean isNullDevice(String serial)

Bestimmt, ob die angegebene Seriennummer ein Nullgerät darstellt

abstract void killEmulator(ITestDevice device)

Beenden Sie den angegebenen Emulator.

abstract void launchEmulator(ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs)

Hilfsmethode zum Starten des Emulators.

abstract listAllDevices(boolean shortDescriptor)

Gibt eine Liste der DeviceDescriptors für alle bekannten Geräte zurück

abstract listAllDevices()

Gibt eine Liste der 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 eine Verbindung herstellt über connectToTcpDevice(String).

abstract void removeDeviceMonitor(IDeviceMonitor mon)

Entfernt einen zuvor hinzugefügten IDeviceMonitor.

abstract void removeFastbootListener(IDeviceManager.IFastbootListener listener)

Informiert den Manager, dass ein Listener nicht mehr an Änderungen des Fastboot-Status interessiert ist.

abstract void restartAdbBridge()

ADB-Brücke und Dienste neu starten (wenn stopAdbBridge() aufgerufen wurde), sind von ADB abhängig Verbindungen.

abstract void stopAdbBridge()

Beenden Sie die ADB-Brücke und die Dienste sind von ADB-Verbindungen abhängig.

abstract void terminate()

Stoppt 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)

Zum Beispiel terminateHard().

abstract void terminateHard()

Wie terminate(), versucht aber auch, ADB zu erzwingen.

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 ein 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 eines oder mehr aktive Zuhörer.

AUFGABE: Dies ist ein kleiner Hack – suchen Sie eine bessere Lösung

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Füge dem Fastboot Monitor ein Gerät hinzu. Der Fastboot-Monitor verwendet "fastboot_serial". bis mit dem Gerät kommunizieren.

Parameter
serial String: die Seriennummer des Geräts.

fastboot_serial String: die Seriennummer des Geräts im Fastboot-Modus

assignDevice-Gerät

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Fordere ein Gerät zum Testen an, das bestimmte Kriterien erfüllt.

Parameter
options IDeviceSelection: die IDeviceSelection, die das Gerät erfüllen soll.

isTemporary boolean: Gibt an, ob ein temporäres NullDevice-Gerät erstellt werden soll.

Returns
ITestDevice ITestDevice zum Testen oder null, wenn kein Wert verfügbar ist

assignDevice-Gerät

public abstract ITestDevice allocateDevice (IDeviceSelection options)

Fordere ein Gerät zum Testen an, das bestimmte Kriterien erfüllt.

Parameter
options IDeviceSelection: die IDeviceSelection, die das Gerät erfüllen soll.

Returns
ITestDevice ITestDevice für Tests oder null, wenn eine ist nicht verfügbar

assignDevice-Gerät

public abstract ITestDevice allocateDevice ()

Physisches Gerät zum Testen anfordern

Returns
ITestDevice ITestDevice zum Testen oder null, wenn kein Wert verfügbar ist

ConnectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

Mit ADB-over-tcp eine Verbindung zu einem Gerät herstellen

Mit dieser Methode wird ein neues Gerät zugewiesen, das schließlich über disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

Die zurückgegebene ITestDevice ist online, reagiert aber möglicherweise nicht.

Hinweis: Bei Aktionen wie einem Neustart auf einem über TCP verbundenen Gerät wird der TCP-Verbindung zum Gerät und führt zu einer DeviceNotAvailableException

Parameter
ipAndPort String: die ursprüngliche IP-Adresse und der Port des Geräts, zu dem eine Verbindung hergestellt werden soll

Returns
ITestDevice ITestDevice oder null, wenn keine TCP-Verbindung hergestellt werden konnte

TrennenVonTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Trennen Sie die Verbindung zu einem mit ADB-over-tcp verbundenen Gerät.

Schaltet das Gerät zurück in den USB-Modus und gibt ihn frei.

Parameter
tcpDevice ITestDevice: das Gerät, das sich derzeit im TCP-Modus befindet, zuvor zugewiesen über connectToTcpDevice(String)

Returns
boolean true, wenn der Wechsel in den USB-Modus erfolgreich war

Geräteinformationen anzeigen

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

Ausgabe einer nutzerfreundlichen Beschreibung mit einer Liste bekannter Geräte, deren Status und Werten für häufig verwendete IDeviceSelection-Optionen.

Parameter
printWriter PrintWriter: ERROR(/PrintWriter), an den die Beschreibung ausgegeben werden soll

includeStub boolean: Gibt an, ob auch Stub-Geräte angezeigt werden sollen.

runCmdOnAvailableDevice

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 Seriennummer des Geräts.

command String: Der Shell-Befehl.

timeout long: Die Zeit, die für die Ausführung des Befehls benötigt wird.

timeUnit TimeUnit: Die Einheit für das Zeitlimit.

Returns
CommandResult Ein CommandResult.

PowerAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

Weisen Sie unhöflich ein Gerät zu, auch wenn es im Moment nicht verfügbar ist.

Dies hat keine Auswirkungen, wenn das Gerät bereits zugewiesen ist.

Parameter
serial String: die Geräteserie, die zugewiesen werden soll

Returns
ITestDevice das ITestDevice oder null, wenn es nicht zugewiesen werden konnte

FreeDevice

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

Gerät an den Pool zurückgeben

Versuche, ein noch nicht zugewiesenes Gerät zurückzugeben, werden ignoriert.

Parameter
device ITestDevice: die kostenlose ITestDevice

state FreeDeviceState: die FreeDeviceState. Wird verwendet, um zu steuern, Gerät wird in den verfügbaren Gerätepool zurückgeführt.

getAdbPath

public abstract String getAdbPath ()

Gibt den Pfad zur zu verwendenden ADB-Binärdatei zurück.

Returns
String

getAdbVersion

public abstract String getAdbVersion ()

Laden Sie die ADB-Version herunter, die derzeit vom Gerätemanager verwendet wird.

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, das abgerufen werden soll

Returns
DeviceDescriptor DeviceDescriptor für das ausgewählte Gerät oder null, wenn die Seriennummer nicht mit einem bekannten Gerät übereinstimmen.

getFastbootPath

public abstract String getFastbootPath ()

Gibt den Pfad zum Fastboot-Binärprogramm zurück, das verwendet werden soll.

Returns
String

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Gerätemanager mit einem Gerätefilter initialisieren Mit diesem Filter können Sie Gerätemanager, um bestimmte verbundene Geräte zu ignorieren.

Parameter
globalDeviceFilter IDeviceSelection: der Gerätefilter

deviceMonitors

init

public abstract void init ()

Initialisieren Sie den Gerätemanager. Dies darf nur einmal und vor jedem anderen aufgerufen werden. aufgerufen werden.

isEmulator

public abstract boolean isEmulator (String serial)

Bestimmt, ob die angegebene Seriennummer einen Emulator darstellt

Parameter
serial String

Returns
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

Gibt zurück, ob in NativeDeviceStateMonitor geprüft werden soll, ob das Dateisystem korrekt montiert sind.

Returns
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

Bestimmt, ob die angegebene Seriennummer ein Nullgerät darstellt

Parameter
serial String

Returns
boolean

KillEmulator

public abstract void killEmulator (ITestDevice device)

Beenden Sie den angegebenen Emulator.

Blockiert, bis der Emulator aus ADB entfernt wird. Hat keine Auswirkung, wenn der Emulator nicht bereits aktiviert ist verfügbar.

Parameter
device ITestDevice: ITestDevice, die den herunterzufahrenden Emulator darstellt

Ausgabe
DeviceNotAvailableException Emulator wird nicht heruntergefahren.

startEmulator

public abstract void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                 emulatorArgs)

Hilfsmethode zum Starten des Emulators.

Startet den Emulator gemäß den Angaben des Aufrufers

Parameter
device ITestDevice: der Platzhalter ITestDevice, der für das zugewiesene Emulatorgerät steht

bootTimeout long: die Zeit in ms, die auf das Starten des Emulators gewartet werden soll

emulatorArgs : Befehlszeilenargumente zum Starten des Emulators

Ausgabe
DeviceNotAvailableException Wenn der Emulator nicht startet oder online geht

ListeAlleGeräte

public abstract  listAllDevices (boolean shortDescriptor)

Gibt eine Liste der DeviceDescriptors für alle bekannten Geräte zurück

Parameter
shortDescriptor boolean: ob Deskriptoren auf die Mindestinformationen beschränkt werden sollen

Returns
Liste mit DeviceDescriptor für alle bekannten Geräte

ListeAlleGeräte

public abstract  listAllDevices ()

Gibt eine Liste der DeviceDescriptors für alle bekannten Geräte zurück

Returns
Liste mit DeviceDescriptor für alle bekannten Geräte

Wiedereinstellen von Geräten zu Tcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Eine Hilfsmethode, die das angegebene USB-Gerät in den ADB-over-tcp-Modus umschaltet und dann eine Verbindung herstellt über connectToTcpDevice(String).

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 ein TCP- Verbindung konnte nicht hergestellt werden

Ausgabe
DeviceNotAvailableException Die Verbindung zu usbDevice wurde unterbrochen und konnte nicht wiederhergestellt werden

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

Entfernt einen zuvor hinzugefügten IDeviceMonitor. Hat keine Auswirkung, wenn kein Mo. hinzugefügt wurde.

Parameter
mon IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Informiert den Manager, dass ein Listener nicht mehr an Änderungen des Fastboot-Status interessiert ist.

AdBBridge neu starten

public abstract void restartAdbBridge ()

ADB-Brücke und Dienste neu starten (wenn stopAdbBridge() aufgerufen wurde), sind von ADB abhängig Verbindungen.

stopAdBridge

public abstract void stopAdbBridge ()

Beenden Sie die ADB-Brücke und die Dienste sind von ADB-Verbindungen abhängig.

beenden

public abstract void terminate ()

Stoppt Geräteüberwachungsdienste und beendet die ddm-Bibliothek.

Diese muss bei Beendigung der Anwendung aufgerufen werden.

Weitere Informationen:

beendenDeviceMonitor

public abstract void terminateDeviceMonitor ()

Beenden Sie die Gerätemonitore.

Gerätewiederherstellung beenden

public abstract void terminateDeviceRecovery ()

Beendet den Thread zur Gerätewiederherstellung.

terminHard

public void terminateHard (String reason)

Zum Beispiel terminateHard().

Parameter
reason String: optionaler Grund für die Kündigung.

terminHard

public abstract void terminateHard ()

Wie terminate(), versucht aber auch, ADB zu erzwingen.

WaitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

Warten Sie, bis ein erstes physisches Gerät verbunden ist. Wenn schon einmal ein Gerät verbunden war, gibt direkt "True" zurück. Wurde kein Gerät hinzugefügt, wird nach Ablauf des Zeitlimits „false“ zurückgegeben.

Parameter
timeout long: Wartezeit in Millisekunden, bevor „false“ zurückgegeben wird.

Returns
boolean