IDeviceManager
public interface IDeviceManager
com.android.tradefed.device.IDeviceManager |
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 |
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 überdisconnectFromTcpDevice(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 |
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 |
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 |
abstract void | removeDeviceMonitor ( IDeviceMonitor mon) Entfernt einen zuvor hinzugefügten |
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 |
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 |
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 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 einIDeviceManager
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 überdisconnectFromTcpDevice(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ührtParameter | |
---|---|
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 angegebenParameter | |
---|---|
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 |
Wirft | |
---|---|
DeviceNotAvailableException | wenn der Emulator nicht booten oder online gehen kann |
ListeAlleGeräte
public abstractlistAllDevices (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 abstractlistAllDevices ()
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:
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 |
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-03-30 (UTC).