IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Bekannte indirekte Unterklassen Gerätemanager Gerätemanager

---

Schnittstelle zum Verwalten des Satzes verfügbarer Geräte zum Testen.

Zusammenfassung

Verschachtelte Klassen
interface	IDeviceManager.IFastbootListener Ein Listener für Fastboot-Statusänderungen.

Öffentliche Methoden
abstract void	addDeviceMonitor ( IDeviceMonitor mon) Fügt einen IDeviceMonitor hinzu
abstract void	addFastbootListener ( IDeviceManager.IFastbootListener listener) Informiert den Manager, dass ein Listener an Fastboot-Statusänderungen 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) Fordern Sie ein Gerät zum Testen an, das bestimmte Kriterien erfüllt.
abstract ITestDevice	allocateDevice ( IDeviceSelection options) Fordern Sie ein Gerät zum Testen an, das bestimmte Kriterien erfüllt.
abstract ITestDevice	allocateDevice () Fordern Sie ein physisches Gerät zum Testen an
abstract ITestDevice	connectToTcpDevice (String ipAndPort) Stellen Sie mit adb-over-tcp eine Verbindung zu einem Gerät her Diese Methode weist ein neues Gerät zu, das schließlich über disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) freigegeben werden sollte. Das zurückgegebene ITestDevice ist online, reagiert aber möglicherweise nicht.
abstract boolean	disconnectFromTcpDevice ( ITestDevice tcpDevice) Trennen Sie die Verbindung zu einem per Adb-over-TCP verbundenen Gerät.
abstract void	displayDevicesInfo (PrintWriter printWriter, boolean includeStub) Geben Sie eine benutzerfreundliche Beschreibung aus, die eine Liste bekannter Geräte, ihren Status und Werte für häufig verwendete IDeviceSelection Optionen enthält.
abstract CommandResult	executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit) Eine Hilfsmethode zum Ausführen von Shell-Befehlen auf einem verfügbaren Gerät.
abstract ITestDevice	forceAllocateDevice (String serial) Weisen Sie ein Gerät unhöflich zu, auch wenn es derzeit nicht verfügbar ist.
abstract void	freeDevice ( ITestDevice device, FreeDeviceState state) Geben Sie ein Gerät in den Pool zurück Versuche, ein Gerät zurückzugeben, das zuvor nicht zugewiesen wurde, werden ignoriert.
abstract String	getAdbPath () Gibt den Pfad zur zu verwendenden adb-Binärdatei zurück.
abstract String	getAdbVersion () Rufen Sie die derzeit vom Geräte-Manager 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, deviceMonitors) init ( IDeviceSelection globalDeviceFilter, deviceMonitors) Initialisieren Sie den Geräte-Manager mit einem Gerätefilter.
abstract void	init () Initialisieren Sie den Gerätemanager.
abstract boolean	isEmulator (String serial) Bestimmen Sie, ob die angegebene Seriennummer einen Emulator darstellt
default boolean	isFileSystemMountCheckEnabled () Gibt zurück, ob wir in NativeDeviceStateMonitor überprüfen sollten, ob das Dateisystem ordnungsgemäß gemountet ist.
abstract boolean	isNullDevice (String serial) Bestimmen Sie, 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) launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) 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 schaltet und dann über connectToTcpDevice(String) eine Verbindung zu ihm herstellt.
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 Fastboot-Statusänderungen interessiert ist.
abstract void	restartAdbBridge () Neustart (wenn stopAdbBridge() aufgerufen wurde) ADB Bridge und Dienste hängen von ADB-Verbindungen ab.
abstract void	stopAdbBridge () Beenden Sie die ADB-Brücke und die Dienste hängen von ADB-Verbindungen ab.
abstract void	terminate () Stoppt Geräteüberwachungsdienste und beendet die ddm-Bibliothek.
abstract void	terminateDeviceMonitor () Stoppen Sie die Geräteüberwachung.
abstract void	terminateDeviceRecovery () Stoppt den Thread zur Gerätewiederherstellung.
default void	terminateHard (String reason) Wie terminateHard() .
abstract void	terminateHard () Wie terminate() , versucht aber auch, adb zwangsweise herunterzufahren.
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 einen IDeviceMonitor hinzu

Parameter
mon	IDeviceMonitor

addFastbootListener

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

Informiert den Manager, dass ein Listener an Fastboot-Statusänderungen interessiert ist.

Derzeit überwacht ein IDeviceManager nur Geräte im Fastboot, wenn ein oder mehrere aktive Listener vorhanden sind.

TODO: Dies ist ein kleiner Hack - finden Sie eine bessere Lösung

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

Gerät zuweisen

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Fordern Sie 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 : ob ein temporäres NullDevice erstellt werden soll oder nicht.

Kehrt zurück
ITestDevice	ein ITestDevice zum Testen oder null , wenn keines verfügbar ist

Gerät zuweisen

public abstract ITestDevice allocateDevice (IDeviceSelection options)

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

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

Kehrt zurück
ITestDevice	ein ITestDevice zum Testen oder null , wenn keines verfügbar ist

Gerät zuweisen

public abstract ITestDevice allocateDevice ()

Fordern Sie ein physisches Gerät zum Testen an

Kehrt zurück
ITestDevice	ein ITestDevice zum Testen oder null , wenn keines verfügbar ist

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

Stellen Sie mit adb-over-tcp eine Verbindung zu einem Gerät her

Diese Methode weist ein neues Gerät zu, das schließlich über disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) freigegeben werden sollte.

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

Beachten Sie, dass das Durchführen einer Aktion wie ein Neustart auf einem über TCP verbundenen Gerät die TCP-Verbindung zum Gerät trennt und zu einer DeviceNotAvailableException führt

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

Kehrt zurück
ITestDevice	das ITestDevice oder null , wenn keine TCP-Verbindung hergestellt werden konnte

disconnectFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Trennen Sie die Verbindung zu einem per Adb-over-TCP verbundenen Gerät.

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

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

Kehrt zurück
boolean	true , wenn der Wechsel in den USB-Modus erfolgreich war

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

Geben Sie eine benutzerfreundliche Beschreibung aus, die eine Liste bekannter Geräte, ihren Status und Werte für häufig verwendete IDeviceSelection Optionen enthält.

Parameter
printWriter	PrintWriter : der ERROR(/PrintWriter) für die Ausgabe der Beschreibung
includeStub	boolean : Ob auch Stub-Geräte angezeigt werden sollen oder nicht.

AusführenCmdOnAvailableDevice

public abstract CommandResult executeCmdOnAvailableDevice (String serial, 
                String command, 
                long timeout, 
                TimeUnit timeUnit)

Eine Hilfsmethode zum Ausführen von Shell-Befehlen auf einem verfügbaren Gerät.

Parameter
serial	String : Die Seriennummer des Geräts.
command	String : Der Shell-Befehl.
timeout	long : Die Zeitdauer für die Ausführung des Befehls.
timeUnit	TimeUnit : Die Einheit für das Timeout.

Kehrt zurück
CommandResult	Ein CommandResult .

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

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

Hat keine Auswirkung, wenn das Gerät bereits zugewiesen ist.

Parameter
serial	String : die zuzuweisende Geräteserie

Kehrt zurück
ITestDevice	das ITestDevice oder null , wenn es nicht zugewiesen werden konnte

freeDevice

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

Geben Sie ein Gerät in den Pool zurück

Versuche, ein Gerät zurückzugeben, das zuvor nicht zugewiesen wurde, werden ignoriert.

Parameter
device	ITestDevice : das freizugebende ITestDevice
state	FreeDeviceState : der FreeDeviceState . Wird verwendet, um zu steuern, ob das Gerät an den verfügbaren Gerätepool zurückgegeben wird.

getAdbPath

public abstract String getAdbPath ()

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

Kehrt zurück
String

getAdbVersion

public abstract String getAdbVersion ()

Rufen Sie die derzeit vom Geräte-Manager verwendete adb-Version ab.

Kehrt zurück
String

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

Gibt den DeviceDescriptor mit der angegebenen Seriennummer zurück.

Parameter
serial	String : Seriennummer für das zu erhaltende Gerät

Kehrt zurück
DeviceDescriptor	der 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.

Kehrt zurück
String

drin

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Initialisieren Sie den Geräte-Manager mit einem Gerätefilter. Dieser Filter kann verwendet werden, um den DeviceManager anzuweisen, bestimmte angeschlossene Geräte zu ignorieren.

Parameter
globalDeviceFilter	IDeviceSelection : der Gerätefilter
deviceMonitors

drin

public abstract void init ()

Initialisieren Sie den Gerätemanager. Dies muss einmal und nur einmal aufgerufen werden, bevor andere Methoden aufgerufen werden.

istEmulator

public abstract boolean isEmulator (String serial)

Bestimmen Sie, ob die angegebene Seriennummer einen Emulator darstellt

Parameter
serial	String

Kehrt zurück
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

Gibt zurück, ob wir in NativeDeviceStateMonitor überprüfen sollten, ob das Dateisystem ordnungsgemäß gemountet ist.

Kehrt zurück
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

Bestimmen Sie, ob die angegebene Seriennummer ein Nullgerät darstellt

Parameter
serial	String

Kehrt zurück
boolean

KillEmulator

public abstract void killEmulator (ITestDevice device)

Beenden Sie den angegebenen Emulator.

Blockiert, bis der Emulator aus adb verschwindet. Hat keine Auswirkungen, wenn der Emulator bereits nicht verfügbar ist.

Parameter
device	ITestDevice : das ITestDevice das den herunterzufahrenden Emulator darstellt

Wirft
DeviceNotAvailableException	wenn der Emulator nicht heruntergefahren werden kann

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 : der Platzhalter ITestDevice der das zugewiesene Emulatorgerät darstellt
bootTimeout	long : Die Zeit in ms, die auf das Booten des Emulators gewartet wird
emulatorArgs	: Befehlszeilenargumente zum Starten des Emulators

Wirft
DeviceNotAvailableException	wenn der Emulator nicht booten oder online gehen kann

ListeAlleGeräte

public abstract  listAllDevices (boolean shortDescriptor)

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

Parameter
shortDescriptor	boolean : ob Deskriptoren auf minimale Informationen beschränkt werden sollen

Kehrt zurück
	eine Liste von DeviceDescriptor für alle bekannten Geräte

ListeAlleGeräte

public abstract  listAllDevices ()

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

Kehrt zurück
	eine Liste von DeviceDescriptor für alle bekannten Geräte

Gerät erneut mit TCP verbinden

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Eine Hilfsmethode, die das angegebene USB-Gerät in den Adb-over-TCP-Modus schaltet und dann über connectToTcpDevice(String) eine Verbindung zu ihm herstellt.

Parameter
usbDevice	ITestDevice : das Gerät, das sich derzeit im USB-Modus befindet

Kehrt zurück
ITestDevice	das neu zugewiesene ITestDevice im TCP-Modus oder null , wenn keine TCP-Verbindung aufgebaut werden konnte

Wirft
DeviceNotAvailableException	wenn die Verbindung mit usbDevice unterbrochen wurde und nicht wiederhergestellt werden konnte

entfernenDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

Entfernt einen zuvor hinzugefügten IDeviceMonitor . Hat keine Auswirkung, wenn mon nicht hinzugefügt wurde.

Parameter
mon	IDeviceMonitor

entfernenFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

Starten Sie AdbBridge neu

public abstract void restartAdbBridge ()

Neustart (wenn stopAdbBridge() aufgerufen wurde) ADB Bridge und Dienste hängen von ADB-Verbindungen ab.

StopAdbBridge

public abstract void stopAdbBridge ()

Beenden Sie die ADB-Brücke und die Dienste hängen von ADB-Verbindungen ab.

beenden

public abstract void terminate ()

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

Diese muss bei der Anwendungsbeendigung aufgerufen werden.

Siehe auch:

• AndroidDebugBridge.terminate()

DeviceMonitor beenden

public abstract void terminateDeviceMonitor ()

Stoppen Sie die Geräteüberwachung.

Gerätewiederherstellung beenden

public abstract void terminateDeviceRecovery ()

Stoppt den Thread zur Gerätewiederherstellung.

terminierenHart

public void terminateHard (String reason)

Wie terminateHard() .

Parameter
reason	String : Optionaler Grund für die Beendigung.

terminierenHart

public abstract void terminateHard ()

Wie terminate() , versucht aber auch, adb zwangsweise herunterzufahren.

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

Warten Sie, bis ein erstes physisches Gerät verbunden ist. Wenn zuvor ein Gerät verbunden war, gibt es direkt True zurück. Wenn kein Gerät hinzugefügt wurde, wird nach dem Timeout false zurückgegeben.

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

Kehrt zurück
boolean