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 Fastboot-Modus. |
Felder | |
---|---|
public static final String | UNKNOWN_DISPLAY_STRING Anzeigezeichenfolge für unbekannte Eigenschaften |
protected DeviceMonitorMultiplexer | mDvcMon |
protected boolean | mFastbootEnabled
|
Öffentliche Bauträger | |
---|---|
DeviceManager () Der DeviceManager sollte aus der |
Öffentliche Methoden | |
---|---|
void | addAvailableDevice (IDevice stubDevice) |
void | addDeviceMonitor ( IDeviceMonitor mon) Fügt einen |
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ügen Sie dem Fastboot-Monitor ein Gerät hinzu. |
ITestDevice | allocateDevice ( IDeviceSelection options, boolean isTemporary) Fordern Sie ein Gerät zum Testen an, das bestimmte Kriterien erfüllt. |
ITestDevice | allocateDevice ( IDeviceSelection options) Fordern Sie ein Gerät zum Testen an, das bestimmte Kriterien erfüllt. |
ITestDevice | allocateDevice () Fordern Sie ein physisches Gerät zum Testen an |
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 überdisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) freigegeben werden sollte. Das zurückgegebene ITestDevice ist online, reagiert jedoch möglicherweise nicht. |
boolean | disconnectFromTcpDevice ( ITestDevice tcpDevice) Trennen Sie die Verbindung zu einem über ADB-über-TCP verbundenen Gerät. |
void | displayDevicesInfo (PrintWriter stream, boolean includeStub) Gibt eine benutzerfreundliche Beschreibung aus, die eine Liste bekannter Geräte, deren Status und Werte 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ühren Sie einen ADB-Befehl aus, der nicht auf ein bestimmtes Gerät ausgerichtet ist, z. B. |
ITestDevice | forceAllocateDevice (String serial) Weisen Sie ein Gerät unhöflich zu, auch wenn es derzeit nicht verfügbar ist. |
void | freeDevice ( ITestDevice device, FreeDeviceState deviceState) Geben Sie ein Gerät in den Pool zurück Versuche, ein Gerät zurückzugeben, das noch nicht zugewiesen wurde, werden ignoriert. |
String | getAdbPath () Gibt den Pfad zur zu verwendenden ADB-Binärdatei zurück. |
String | getAdbVersion () Rufen Sie die aktuell vom Gerätemanager verwendete ADB-Version ab. |
DeviceDescriptor | getDeviceDescriptor (String serial) Gibt den DeviceDescriptor mit der angegebenen Seriennummer zurück. |
String | getFastbootPath () Gibt den Pfad zur zu verwendenden Fastboot-Binärdatei zurück. |
void | init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) Initialisieren Sie den Gerätemanager. |
void | init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) Initialisieren Sie den Gerätemanager. |
void | init () Initialisieren Sie den Gerätemanager. |
boolean | isEmulator (String serial) Stellen Sie fest, ob die angegebene Seriennummer einen Emulator darstellt |
boolean | isFileSystemMountCheckEnabled () Gibt zurück, ob wir in |
boolean | isNullDevice (String serial) Stellen Sie fest, ob die angegebene Seriennummer ein Nullgerät darstellt |
void | killEmulator ( ITestDevice device) Fahren Sie den angegebenen Emulator herunter. |
void | launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) Hilfsmethode zum Starten des Emulators. |
listAllDevices (boolean shortDescriptor) Gibt eine Liste von DeviceDescriptors für alle bekannten Geräte zurück | |
listAllDevices () Gibt eine Liste von 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 schaltet und dann über |
void | removeDeviceMonitor ( IDeviceMonitor mon) Entfernt einen zuvor hinzugefügten |
void | removeFastbootListener ( IDeviceManager.IFastbootListener listener) Informiert den Manager darüber, dass ein Listener nicht mehr an Änderungen des Fastboot-Status interessiert ist. |
void | restartAdbBridge () Starten Sie die ADB-Brücke neu (falls |
void | stopAdbBridge () Stoppen 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 () Stoppen Sie die Geräteüberwachungen. |
void | terminateDeviceRecovery () Stoppt den Gerätewiederherstellungsthread. |
void | terminateHard (String reason) Wie |
void | terminateHard () Wie |
boolean | waitForFirstDeviceAdded (long timeout) Warten Sie, bis ein erstes physisches Gerät angeschlossen ist. |
Felder
UNBEKANNTER_DISPLAY_STRING
public static final String UNKNOWN_DISPLAY_STRING
Anzeigezeichenfolge für unbekannte Eigenschaften
mFastbootEnabled
protected boolean mFastbootEnabled
Öffentliche Bauträger
Gerätemanager
public DeviceManager ()
Der DeviceManager sollte aus der GlobalConfiguration
abgerufen werden
Öffentliche Methoden
addAvailableDevice
public void addAvailableDevice (IDevice stubDevice)
Parameter | |
---|---|
stubDevice | IDevice |
addDeviceMonitor
public void addDeviceMonitor (IDeviceMonitor mon)
Fügt einen IDeviceMonitor
hinzu
Parameter | |
---|---|
mon | IDeviceMonitor |
addFastbootDevice
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 einIDeviceManager
Geräte im Fastboot nur, wenn ein oder mehrere aktive Listener vorhanden sind. TODO: Das ist ein kleiner Trick – finden Sie eine bessere Lösung addMonitoringTcpFastbootDevice
public 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 Fastboot-Modus des Geräts. |
allocateDevice
public ITestDevice allocateDevice (IDeviceSelection options, boolean isTemporary)
Fordern Sie ein Gerät zum Testen an, das bestimmte Kriterien erfüllt.
Parameter | |
---|---|
options | IDeviceSelection : die IDeviceSelection das Gerät erfüllen sollte. |
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 |
allocateDevice
public ITestDevice allocateDevice (IDeviceSelection options)
Fordern Sie ein Gerät zum Testen an, das bestimmte Kriterien erfüllt.
Parameter | |
---|---|
options | IDeviceSelection : die IDeviceSelection das Gerät erfüllen sollte. |
Kehrt zurück | |
---|---|
ITestDevice | ein ITestDevice zum Testen oder null , wenn keines verfügbar ist |
allocateDevice
public 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 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 überdisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)
freigegeben werden sollte. Das zurückgegebene ITestDevice
ist online, reagiert jedoch möglicherweise nicht. Beachten Sie, dass die Ausführung einer Aktion wie etwa eines Neustarts auf einem über TCP verbundenen Gerät die TCP-Verbindung zum Gerät trennt und zu einer DeviceNotAvailableException
führtParameter | |
---|---|
ipAndPort | String : die ursprüngliche IP-Adresse und der Port des Geräts, mit dem eine Verbindung hergestellt werden soll |
Kehrt zurück | |
---|---|
ITestDevice | das ITestDevice oder null , wenn keine TCP-Verbindung hergestellt werden konnte |
„disconnectFromTcpDevice“.
public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)
Trennen Sie die Verbindung zu einem über ADB-über-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 void displayDevicesInfo (PrintWriter stream, boolean includeStub)
Gibt eine benutzerfreundliche Beschreibung aus, die eine Liste bekannter Geräte, deren Status und Werte für häufig verwendete IDeviceSelection
Optionen enthält.
Parameter | |
---|---|
stream | PrintWriter : der ERROR(/PrintWriter) , an den die Beschreibung ausgegeben werden soll |
includeStub | boolean : Ob auch Stub-Geräte angezeigt werden sollen oder nicht. |
ausführenCmdOnAvailableDevice
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 Timeout. |
Kehrt zurück | |
---|---|
CommandResult | Ein CommandResult . |
ausführenGlobalAdbCommand
public String executeGlobalAdbCommand (String... cmdArgs)
Führen Sie einen ADB-Befehl aus, der nicht auf ein bestimmtes Gerät ausgerichtet ist, z. B. 'adb connect'
Kehrt zurück | |
---|---|
String | Standardausgabe, wenn der Befehl erfolgreich ist, andernfalls null. |
forceAllocateDevice
public 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 zuzuordnende Geräteserie |
Kehrt zurück | |
---|---|
ITestDevice | das ITestDevice oder null , wenn es nicht zugewiesen werden konnte |
freeDevice
public void freeDevice (ITestDevice device, FreeDeviceState deviceState)
Geben Sie ein Gerät in den Pool zurück
Versuche, ein Gerät zurückzugeben, das noch nicht zugewiesen wurde, werden ignoriert.Parameter | |
---|---|
device | ITestDevice : das freizugebende ITestDevice |
deviceState | FreeDeviceState : der FreeDeviceState . Wird verwendet, um zu steuern, ob das Gerät in den verfügbaren Gerätepool zurückgeführt wird. |
getAdbPath
public String getAdbPath ()
Gibt den Pfad zur zu verwendenden ADB-Binärdatei zurück.
Kehrt zurück | |
---|---|
String |
getAdbVersion
public String getAdbVersion ()
Rufen Sie die aktuell vom Gerätemanager verwendete ADB-Version ab.
Kehrt zurück | |
---|---|
String |
getDeviceDescriptor
public DeviceDescriptor getDeviceDescriptor (String serial)
Gibt den DeviceDescriptor mit der angegebenen Seriennummer zurück.
Parameter | |
---|---|
serial | String : Seriennummer, die das Gerät erhalten soll |
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 String getFastbootPath ()
Gibt den Pfad zur zu verwendenden Fastboot-Binärdatei zurück.
Kehrt zurück | |
---|---|
String |
drin
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)
Initialisieren Sie den Gerätemanager. Dies muss einmal und nur einmal aufgerufen werden, bevor andere Methoden aufgerufen werden.
Parameter | |
---|---|
globalDeviceFilter | IDeviceSelection |
globalDeviceMonitors | |
deviceFactory | IManagedTestDeviceFactory |
drin
public void init (IDeviceSelection globalDeviceFilter,globalDeviceMonitors)
Initialisieren Sie den Gerätemanager. Dies muss einmal und nur einmal aufgerufen werden, bevor andere Methoden aufgerufen werden.
Parameter | |
---|---|
globalDeviceFilter | IDeviceSelection : der Gerätefilter |
globalDeviceMonitors |
drin
public void init ()
Initialisieren Sie den Gerätemanager. Dies muss einmal und nur einmal aufgerufen werden, bevor andere Methoden aufgerufen werden.
isEmulator
public boolean isEmulator (String serial)
Stellen Sie fest, 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 sollen, ob das Dateisystem ordnungsgemäß gemountet ist.
Kehrt zurück | |
---|---|
boolean |
isNullDevice
public boolean isNullDevice (String serial)
Stellen Sie fest, ob die angegebene Seriennummer ein Nullgerät darstellt
Parameter | |
---|---|
serial | String |
Kehrt zurück | |
---|---|
boolean |
killEmulator
public void killEmulator (ITestDevice device)
Fahren Sie den angegebenen Emulator herunter.
Blockiert, bis der Emulator aus ADB verschwindet. Hat keine Auswirkung, wenn der Emulator bereits nicht verfügbar ist.Parameter | |
---|---|
device | ITestDevice : das ITestDevice das den herunterzufahrenden Emulator darstellt |
Würfe | |
---|---|
DeviceNotAvailableException |
launchEmulator
public void launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil,emulatorArgs)
Hilfsmethode zum Starten des Emulators.
Startet den Emulator wie vom Aufrufer angegebenParameter | |
---|---|
device | ITestDevice : Der Platzhalter ITestDevice der das zugewiesene Emulatorgerät darstellt |
bootTimeout | long : Die Zeit in ms, die auf den Start des Emulators gewartet wird |
emulatorArgs |
Würfe | |
---|---|
DeviceNotAvailableException |
listAllDevices
publiclistAllDevices (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 |
listAllDevices
publiclistAllDevices ()
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 |
reconnectDeviceToTcp
public 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 hergestellt werden konnte |
Würfe | |
---|---|
DeviceNotAvailableException |
RemoveDeviceMonitor
public void removeDeviceMonitor (IDeviceMonitor mon)
Entfernt einen zuvor hinzugefügten IDeviceMonitor
. Hat keine Auswirkung, wenn mon nicht hinzugefügt wurde.
Parameter | |
---|---|
mon | IDeviceMonitor |
RemoveFastbootListener
public void removeFastbootListener (IDeviceManager.IFastbootListener listener)
Informiert den Manager darüber, dass ein Listener nicht mehr an Änderungen des Fastboot-Status interessiert ist.
restartAdbBridge
public void restartAdbBridge ()
Starten Sie die ADB-Brücke neu (falls stopAdbBridge()
aufgerufen wurde), und die Dienste sind von ADB-Verbindungen abhängig.
stopAdbBridge
public void stopAdbBridge ()
Stoppen 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.
Dies muss bei Beendigung der Bewerbung aufgerufen werden.BeendenDeviceMonitor
public void terminateDeviceMonitor ()
Stoppen Sie die Geräteüberwachungen.
BeendenDeviceRecovery
public void terminateDeviceRecovery ()
Stoppt den Gerätewiederherstellungsthread.
beendenHard
public void terminateHard (String reason)
Wie terminateHard()
.
Parameter | |
---|---|
reason | String : optionaler Grund für die Beendigung. |
beendenHard
public void terminateHard ()
Wie terminate()
, versucht aber auch, adb zwangsweise herunterzufahren.
waitForFirstDeviceAdded
public boolean waitForFirstDeviceAdded (long timeout)
Warten Sie, bis ein erstes physisches Gerät angeschlossen ist. Wenn ein Gerät zuvor verbunden war, gibt es direkt True zurück. Wenn kein Gerät hinzugefügt wurde, wird nach einer Zeitüberschreitung „false“ zurückgegeben.
Parameter | |
---|---|
timeout | long : Wartezeit in Millisekunden, bevor false zurückgegeben wird. |
Kehrt zurück | |
---|---|
boolean |
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2023-12-01 (UTC).