Gerätemanager
public
class
DeviceManager
extends Object
implements
IDeviceManager
java.lang.Object | |
😎 | com.android.tradefed.device.DeviceManager. |
Zusammenfassung
Verschachtelte Klassen | |
---|---|
class |
DeviceManager.FastbootDevice
Darstellung eines Geräts im Schnellstartmodus (Fastboot mode). |
Felder | |
---|---|
public
static
final
String |
UNKNOWN_DISPLAY_STRING
Anzeigestring für unbekannte Eigenschaften |
protected
DeviceMonitorMultiplexer |
mDvcMon
|
protected
boolean |
mFastbootEnabled
|
Öffentliche Konstruktoren | |
---|---|
DeviceManager()
Der DeviceManager sollte aus dem |
Öffentliche Methoden | |
---|---|
void
|
addAvailableDevice(IDevice stubDevice)
|
void
|
addDeviceMonitor(IDeviceMonitor mon)
Fügt ein |
void
|
addFastbootDevice(DeviceManager.FastbootDevice fastbootDevice)
|
void
|
addFastbootListener(IDeviceManager.IFastbootListener listener)
Informiert den Manager darüber, dass ein Listener an Änderungen des Fastboot-Status interessiert ist. |
void
|
addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)
Füge dem Fastboot Monitor ein Gerät hinzu. |
ITestDevice
|
allocateDevice(IDeviceSelection options, boolean isTemporary)
Fordere ein Gerät zum Testen an, das bestimmte Kriterien erfüllt. |
ITestDevice
|
allocateDevice(IDeviceSelection options)
Fordere ein Gerät zum Testen an, das bestimmte Kriterien erfüllt. |
ITestDevice
|
allocateDevice()
Physisches Gerät zum Testen anfordern |
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
Die zurückgegebene |
boolean
|
disconnectFromTcpDevice(ITestDevice tcpDevice)
Trennen Sie die Verbindung zu einem mit ADB-over-tcp verbundenen Gerät. |
void
|
displayDevicesInfo(PrintWriter stream, boolean includeStub)
Ausgabe einer nutzerfreundlichen Beschreibung mit einer Liste bekannter Geräte, deren Status und Werten
für häufig verwendete |
CommandResult
|
executeCmdOnAvailableDevice(String serial, String command, long timeout, TimeUnit timeUnit)
Eine Hilfsmethode zum Ausführen eines Shell-Befehls auf einem verfügbaren Gerät. |
String
|
executeGlobalAdbCommand(String... cmdArgs)
Führt einen ADB-Befehl aus, der nicht auf ein bestimmtes Gerät ausgerichtet ist, z. B. |
ITestDevice
|
forceAllocateDevice(String serial)
Weisen Sie unhöflich ein Gerät zu, auch wenn es im Moment nicht verfügbar ist. |
void
|
freeDevice(ITestDevice device, FreeDeviceState deviceState)
Gerät an den Pool zurückgeben Versuche, ein noch nicht zugewiesenes Gerät zurückzugeben, werden ignoriert. |
String
|
getAdbPath()
Gibt den Pfad zur zu verwendenden ADB-Binärdatei zurück. |
String
|
getAdbVersion()
Laden Sie die ADB-Version herunter, die derzeit vom Gerätemanager verwendet wird. |
DeviceDescriptor
|
getDeviceDescriptor(String serial)
Gibt den DeviceDescriptor mit der angegebenen Seriennummer zurück. |
String
|
getFastbootPath()
Gibt den Pfad zum Fastboot-Binärprogramm zurück, das verwendet werden soll. |
void
|
init(IDeviceSelection globalDeviceFilter,
Initialisieren Sie den Gerätemanager. |
void
|
init(IDeviceSelection globalDeviceFilter,
Initialisieren Sie den Gerätemanager. |
void
|
init()
Initialisieren Sie den Gerätemanager. |
boolean
|
isEmulator(String serial)
Bestimmt, ob die angegebene Seriennummer einen Emulator darstellt |
boolean
|
isFileSystemMountCheckEnabled()
Gibt zurück, ob in |
boolean
|
isNullDevice(String serial)
Bestimmt, ob die angegebene Seriennummer ein Nullgerät darstellt |
void
|
killEmulator(ITestDevice device)
Beenden Sie den angegebenen Emulator. |
void
|
launchEmulator(ITestDevice device, long bootTimeout, IRunUtil runUtil,
Hilfsmethode zum Starten des Emulators. |
|
listAllDevices(boolean shortDescriptor)
Gibt eine Liste der DeviceDescriptors für alle bekannten Geräte zurück |
|
listAllDevices()
Gibt eine Liste der DeviceDescriptors für alle bekannten Geräte zurück |
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 |
void
|
removeDeviceMonitor(IDeviceMonitor mon)
Entfernt einen zuvor hinzugefügten |
void
|
removeFastbootListener(IDeviceManager.IFastbootListener listener)
Informiert den Manager, dass ein Listener nicht mehr an Änderungen des Fastboot-Status interessiert ist. |
void
|
restartAdbBridge()
ADB-Brücke und Dienste neu starten (wenn |
void
|
stopAdbBridge()
Beenden Sie die ADB-Brücke und die Dienste sind von ADB-Verbindungen abhängig. |
void
|
terminate()
Stoppt Geräteüberwachungsdienste und beendet die ddm-Bibliothek. |
void
|
terminateDeviceMonitor()
Beenden Sie die Gerätemonitore. |
void
|
terminateDeviceRecovery()
Beendet den Thread zur Gerätewiederherstellung. |
void
|
terminateHard(String reason)
Zum Beispiel |
void
|
terminateHard()
Wie |
boolean
|
waitForFirstDeviceAdded(long timeout)
Warten Sie, bis ein erstes physisches Gerät verbunden ist. |
Felder
UNBEKANNTER_DISPLAY_STRING
public static final String UNKNOWN_DISPLAY_STRING
Anzeigestring für unbekannte Eigenschaften
mFastbootEnabled
protected boolean mFastbootEnabled
Öffentliche Konstruktoren
Gerätemanager
public DeviceManager ()
Der DeviceManager sollte aus dem GlobalConfiguration
abgerufen werden
Öffentliche Methoden
addAvailableDevice (verfügbares Gerät hinzufügen)
public void addAvailableDevice (IDevice stubDevice)
Parameter | |
---|---|
stubDevice |
IDevice |
addDeviceMonitor
public void addDeviceMonitor (IDeviceMonitor mon)
Fügt ein IDeviceMonitor
hinzu
Parameter | |
---|---|
mon |
IDeviceMonitor |
FastbootDevice hinzufügen
public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)
Parameter | |
---|---|
fastbootDevice |
DeviceManager.FastbootDevice |
addFastbootListener
public 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 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 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 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 ITestDevice allocateDevice ()
Physisches Gerät zum Testen anfordern
Returns | |
---|---|
ITestDevice |
ITestDevice zum Testen oder null , wenn kein Wert verfügbar ist |
ConnectToTcpDevice
public 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 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 void displayDevicesInfo (PrintWriter stream, boolean includeStub)
Ausgabe einer nutzerfreundlichen Beschreibung mit einer Liste bekannter Geräte, deren Status und Werten
für häufig verwendete IDeviceSelection
-Optionen.
Parameter | |
---|---|
stream |
PrintWriter : ERROR(/PrintWriter) , an den die Beschreibung ausgegeben werden soll |
includeStub |
boolean : Gibt an, ob auch Stub-Geräte angezeigt werden sollen. |
runCmdOnAvailableDevice
public 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 . |
AusführenGlobalAdbCommand
public String executeGlobalAdbCommand (String... cmdArgs)
Führt einen ADB-Befehl aus, der nicht auf ein bestimmtes Gerät ausgerichtet ist, z. B. "adb connect"
Returns | |
---|---|
String |
std-Ausgabe, wenn der Befehl „successm“ andernfalls null ist. |
PowerAllocateDevice
public 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 void freeDevice (ITestDevice device, FreeDeviceState deviceState)
Gerät an den Pool zurückgeben
Versuche, ein noch nicht zugewiesenes Gerät zurückzugeben, werden ignoriert.
Parameter | |
---|---|
device |
ITestDevice : die kostenlose ITestDevice |
deviceState |
FreeDeviceState : die FreeDeviceState . Wird verwendet, um zu steuern,
Gerät wird in den verfügbaren Gerätepool zurückgeführt. |
getAdbPath
public String getAdbPath ()
Gibt den Pfad zur zu verwendenden ADB-Binärdatei zurück.
Returns | |
---|---|
String |
getAdbVersion
public String getAdbVersion ()
Laden Sie die ADB-Version herunter, die derzeit vom Gerätemanager verwendet wird.
Returns | |
---|---|
String |
getDeviceDescriptor,
public 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 String getFastbootPath ()
Gibt den Pfad zum Fastboot-Binärprogramm zurück, das verwendet werden soll.
Returns | |
---|---|
String |
init
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)
Initialisieren Sie den Gerätemanager. Dies darf nur einmal und vor jedem anderen aufgerufen werden. aufgerufen werden.
Parameter | |
---|---|
globalDeviceFilter |
IDeviceSelection |
globalDeviceMonitors |
|
deviceFactory |
IManagedTestDeviceFactory |
init
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors)
Initialisieren Sie den Gerätemanager. Dies darf nur einmal und vor jedem anderen aufgerufen werden. aufgerufen werden.
Parameter | |
---|---|
globalDeviceFilter |
IDeviceSelection : der Gerätefilter |
globalDeviceMonitors |
|
init
public void init ()
Initialisieren Sie den Gerätemanager. Dies darf nur einmal und vor jedem anderen aufgerufen werden. aufgerufen werden.
isEmulator
public 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 boolean isNullDevice (String serial)
Bestimmt, ob die angegebene Seriennummer ein Nullgerät darstellt
Parameter | |
---|---|
serial |
String |
Returns | |
---|---|
boolean |
KillEmulator
public 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 |
startEmulator
public 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 |
ListeAlleGeräte
publiclistAllDevices (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
publiclistAllDevices ()
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 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 |
removeDeviceMonitor
public void removeDeviceMonitor (IDeviceMonitor mon)
Entfernt einen zuvor hinzugefügten IDeviceMonitor
. Hat keine Auswirkung, wenn kein Mo. hinzugefügt wurde.
Parameter | |
---|---|
mon |
IDeviceMonitor |
removeFastbootListener
public void removeFastbootListener (IDeviceManager.IFastbootListener listener)
Informiert den Manager, dass ein Listener nicht mehr an Änderungen des Fastboot-Status interessiert ist.
AdBBridge neu starten
public void restartAdbBridge ()
ADB-Brücke und Dienste neu starten (wenn stopAdbBridge()
aufgerufen wurde), sind von ADB abhängig
Verbindungen.
stopAdBridge
public void stopAdbBridge ()
Beenden Sie die ADB-Brücke und die Dienste sind von ADB-Verbindungen abhängig.
beenden
public void terminate ()
Stoppt Geräteüberwachungsdienste und beendet die ddm-Bibliothek.
Diese muss bei Beendigung der Anwendung aufgerufen werden.
beendenDeviceMonitor
public void terminateDeviceMonitor ()
Beenden Sie die Gerätemonitore.
Gerätewiederherstellung beenden
public void terminateDeviceRecovery ()
Beendet den Thread zur Gerätewiederherstellung.
BeendenHard
public void terminateHard (String reason)
Zum Beispiel terminateHard()
.
Parameter | |
---|---|
reason |
String : optionaler Grund für die Kündigung. |
WaitForFirstDeviceAdded
public 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 |