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 GlobalConfiguration abgerufen werden

Öffentliche Methoden

void addAvailableDevice (IDevice stubDevice)
void addDeviceMonitor ( IDeviceMonitor mon)

Fügt einen IDeviceMonitor hinzu

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 über disconnectFromTcpDevice(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 IDeviceSelection Optionen enthält.

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 NativeDeviceStateMonitor überprüfen sollen, ob das Dateisystem ordnungsgemäß gemountet ist.

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 connectToTcpDevice(String) eine Verbindung zu ihm herstellt.

void removeDeviceMonitor ( IDeviceMonitor mon)

Entfernt einen zuvor hinzugefügten IDeviceMonitor .

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 stopAdbBridge() aufgerufen wurde), und die Dienste sind von ADB-Verbindungen abhängig.

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 terminateHard() .

void terminateHard ()

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

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

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

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 ein IDeviceManager 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 über disconnectFromTcpDevice(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ührt

Parameter
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 angegeben

Parameter
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 : Befehlszeilenargumente zum Starten des Emulators

Würfe
DeviceNotAvailableException

listAllDevices

public  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

listAllDevices

public  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

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