Ab dem 27. März 2025 empfehlen wir, android-latest-release anstelle von aosp-main zu verwenden, um AOSP zu erstellen und Beiträge dazu zu leisten. Weitere Informationen finden Sie unter Änderungen am AOSP.

Diese Seite wurde von der Cloud Translation API übersetzt.

IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Bekannte indirekte Unterklassen

DeviceManager

Benutzeroberfläche zum Verwalten der für Tests verfügbaren Geräte.

Zusammenfassung

Verschachtelte Klassen
`interface`	`IDeviceManager.IFastbootListener` Ein Listener für Änderungen des Fastboot-Status.

Öffentliche Methoden
`abstract void`	`addDeviceMonitor(IDeviceMonitor mon)` Fügt `IDeviceMonitor` hinzu
`abstract void`	`addFastbootListener(IDeviceManager.IFastbootListener listener)` Informiert den Manager darüber, dass ein Listener an Änderungen des Fastboot-Status 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)` Sie können ein Gerät für Tests anfordern, das bestimmte Kriterien erfüllt.
`abstract ITestDevice`	`allocateDevice(IDeviceSelection options)` Sie können ein Gerät für Tests anfordern, das bestimmte Kriterien erfüllt.
`abstract ITestDevice`	`allocateDevice()` Testgerät anfordern
`abstract ITestDevice`	`connectToTcpDevice(String ipAndPort)` Verbindung mit einem Gerät über adb-over-tcp herstellen Mit dieser Methode wird ein neues Gerät zugewiesen, das später über `disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)` freigegeben werden sollte. Die zurückgegebene `ITestDevice` ist online, reagiert aber möglicherweise nicht.
`abstract boolean`	`disconnectFromTcpDevice(ITestDevice tcpDevice)` Trennen Sie die Verbindung zu einem Gerät, das über adb-over-tcp verbunden ist.
`abstract void`	`displayDevicesInfo(PrintWriter printWriter, boolean includeStub)` Eine nutzerfreundliche Beschreibung mit einer Liste der bekannten Geräte, ihrem Status und den Werten für häufig verwendete `IDeviceSelection`-Optionen ausgeben.
`abstract CommandResult`	`executeCmdOnAvailableDevice(String serial, String command, long timeout, TimeUnit timeUnit)` Eine Hilfsmethode zum Ausführen eines Shell-Befehls auf einem verfügbaren Gerät.
`abstract ITestDevice`	`forceAllocateDevice(String serial)` Ein Gerät zugewiesen, das derzeit nicht verfügbar ist.
`abstract void`	`freeDevice(ITestDevice device, FreeDeviceState state)` Gerät in den Pool zurückgeben Versuche, ein Gerät zurückzugeben, das noch nicht zugewiesen wurde, werden ignoriert.
`abstract String`	`getAdbPath()` Gibt den Pfad zur zu verwendenden adb-Binärdatei zurück.
`abstract String`	`getAdbVersion()` Ruft die aktuell vom Gerätemanager 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)` Initialisieren Sie den Gerätemanager mit einem Gerätefilter.
`abstract void`	`init()` Initialisieren Sie den Gerätemanager.
`abstract boolean`	`isEmulator(String serial)` Prüfen, ob eine angegebene Seriennummer für einen Emulator steht
`default boolean`	`isFileSystemMountCheckEnabled()` Gibt an, ob in `NativeDeviceStateMonitor` geprüft werden soll, ob das Dateisystem korrekt bereitgestellt wurde.
`abstract boolean`	`isNullDevice(String serial)` Prüfen, ob eine angegebene Seriennummer ein Nullgerät darstellt
`abstract void`	`killEmulator(ITestDevice device)` Den angegebenen Emulator herunterfahren.
`abstract void`	`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 umschaltet und dann über `connectToTcpDevice(String)` eine Verbindung dazu herstellt.
`abstract void`	`removeDeviceMonitor(IDeviceMonitor mon)` Entfernt eine zuvor hinzugefügte `IDeviceMonitor`.
`abstract void`	`removeFastbootListener(IDeviceManager.IFastbootListener listener)` Informiert den Manager darüber, dass ein Listener nicht mehr an Änderungen des Fastboot-Status interessiert ist.
`abstract void`	`restartAdbBridge()` Starten Sie die adb-Bridge neu, falls `stopAdbBridge()` aufgerufen wurde, und die Dienste, die von adb-Verbindungen abhängen.
`abstract void`	`stopAdbBridge()` Die adb-Bridge und Dienste, die von adb-Verbindungen abhängen, werden angehalten.
`abstract void`	`terminate()` Beendet die Geräteüberwachungsdienste und beendet die DDM-Bibliothek.
`abstract void`	`terminateDeviceMonitor()` Beenden Sie die Gerätemonitore.
`abstract void`	`terminateDeviceRecovery()` Beendet den Thread zur Gerätewiederherstellung.
`default void`	`terminateHard(String reason)` Ähnlich wie `terminateHard()`.
`abstract void`	`terminateHard()` Wie `terminate()`, aber es wird auch versucht, adb zu beenden.
`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 IDeviceMonitor hinzu

Parameter
`mon`	`IDeviceMonitor`

addFastbootListener

public abstract 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 mindestens ein aktiver Listener vorhanden ist.

TODO: Das ist ein bisschen ein Hack – eine bessere Lösung finden

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

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Sie können ein Gerät für Tests anfordern, das bestimmte Kriterien erfüllt.

Parameter
`options`	`IDeviceSelection`: die `IDeviceSelection`, die das Gerät erfüllen sollte.
`isTemporary`	`boolean`: ob ein temporäres Nullgerät erstellt werden soll.

Returns
`ITestDevice`	`ITestDevice` für Tests oder `null`, wenn keine verfügbar ist

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options)

Sie können ein Gerät für Tests anfordern, das bestimmte Kriterien erfüllt.

Parameter
`options`	`IDeviceSelection`: die `IDeviceSelection`, die das Gerät erfüllen sollte.

Returns
`ITestDevice`	`ITestDevice` für Tests oder `null`, wenn keine verfügbar ist

allocateDevice

public abstract ITestDevice allocateDevice ()

Testgerät anfordern

Returns
`ITestDevice`	`ITestDevice` für Tests oder `null`, wenn keine verfügbar ist

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

Verbindung mit einem Gerät über adb-over-tcp herstellen

Mit dieser Methode wird ein neues Gerät zugewiesen, das später über disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) freigegeben werden sollte.

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

Beachten Sie, dass durch Aktionen wie einen Neustart auf einem Gerät mit TCP-Verbindung die TCP-Verbindung zum Gerät getrennt wird und ein DeviceNotAvailableException

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

Returns
`ITestDevice`	`ITestDevice` oder `null`, wenn keine TCP-Verbindung hergestellt werden konnte

disconnectFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Trennen Sie die Verbindung zu einem Gerät, das über adb-over-tcp verbunden ist.

Das Gerät wird wieder in den USB-Modus versetzt und freigegeben.

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

Returns
`boolean`	`true` ob der Wechsel in den USB-Modus erfolgreich war

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

Eine nutzerfreundliche Beschreibung mit einer Liste der bekannten Geräte, ihrem Status und den Werten für häufig verwendete IDeviceSelection-Optionen ausgeben.

Parameter
`printWriter`	`PrintWriter`: `ERROR(/PrintWriter)`, in dem die Beschreibung ausgegeben werden soll
`includeStub`	`boolean`: Ob auch Stub-Geräte angezeigt werden sollen.

executeCmdOnAvailableDevice

public abstract 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 Geräteserie.
`command`	`String`: Der Shell-Befehl.
`timeout`	`long`: Die Zeit, die der Befehl benötigt, um ausgeführt zu werden.
`timeUnit`	`TimeUnit`: Die Einheit für die Zeitüberschreitung.

Returns
`CommandResult`	Ein `CommandResult`.

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

Ein Gerät zugewiesen, das derzeit nicht verfügbar ist.

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

Parameter
`serial`	`String`: Die zuzuweisende Geräteseriennummer

Returns
`ITestDevice`	`ITestDevice` oder `null`, falls keine Zuweisung möglich war

freeDevice

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

Gerät in den Pool zurückgeben

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

Parameter
`device`	`ITestDevice`: die `ITestDevice` zu „kostenlos“
`state`	`FreeDeviceState`: die `FreeDeviceState`. Wird verwendet, um festzulegen, ob das Gerät in den verfügbaren Gerätepool zurückgegeben wird.

getAdbPath

public abstract String getAdbPath ()

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

Returns
`String`

getAdbVersion

public abstract String getAdbVersion ()

Ruft die aktuell vom Gerätemanager verwendete adb-Version ab.

Returns
`String`

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

Gibt den DeviceDescriptor mit der angegebenen Seriennummer zurück.

Parameter
`serial`	`String`: Seriennummer des Geräts, für das die Informationen abgerufen werden sollen

Returns
`DeviceDescriptor`	die `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.

Returns
`String`

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Initialisieren Sie den Gerätemanager mit einem Gerätefilter. Mit diesem Filter können Sie den DeviceManager anweisen, bestimmte verbundene Geräte zu ignorieren.

Parameter
`globalDeviceFilter`	`IDeviceSelection`: Gerätefilter
`deviceMonitors`

init

public abstract void init ()

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

isEmulator

public abstract boolean isEmulator (String serial)

Prüfen, ob eine angegebene Seriennummer für einen Emulator steht

Parameter
`serial`	`String`

Returns
`boolean`

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

Gibt an, ob in NativeDeviceStateMonitor geprüft werden soll, ob das Dateisystem korrekt bereitgestellt wurde.

Returns
`boolean`

isNullDevice

public abstract boolean isNullDevice (String serial)

Prüfen, ob eine angegebene Seriennummer ein Nullgerät darstellt

Parameter
`serial`	`String`

Returns
`boolean`

killEmulator

public abstract void killEmulator (ITestDevice device)

Den angegebenen Emulator herunterfahren.

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

Parameter
`device`	`ITestDevice`: der `ITestDevice`, der den zu beendenden Emulator darstellt

Ausgabe
`DeviceNotAvailableException`	if emulator fails to shut down

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`: Platzhalter `ITestDevice` für das zugewiesene Emulatorgerät
`bootTimeout`	`long`: die Zeit in ms, die gewartet wird, bis der Emulator gestartet ist
`emulatorArgs`	: Befehlszeilenargumente zum Starten des Emulators

Ausgabe
`DeviceNotAvailableException`	Wenn der Emulator nicht startet oder nicht online kommt

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

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

Parameter
`shortDescriptor`	`boolean`: ob Beschreibungen auf die Mindestinformationen beschränkt werden sollen

Returns
	eine Liste mit `DeviceDescriptor` für alle bekannten Geräte

listAllDevices

public abstract  listAllDevices ()

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

Returns
	eine Liste mit `DeviceDescriptor` für alle bekannten Geräte

reconnectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Eine Hilfsmethode, die das angegebene USB-Gerät in den adb-over-tcp-Modus umschaltet und dann über connectToTcpDevice(String) eine Verbindung dazu herstellt.

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 keine TCP-Verbindung hergestellt werden konnte

Ausgabe
`DeviceNotAvailableException`	wenn die Verbindung zu `usbDevice` unterbrochen wurde und nicht wiederhergestellt werden konnte

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

Entfernt eine zuvor hinzugefügte IDeviceMonitor. Hat keine Auswirkungen, wenn mon nicht hinzugefügt wurde.

Parameter
`mon`	`IDeviceMonitor`

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Informiert den Manager darüber, dass ein Listener nicht mehr an Änderungen des Fastboot-Status interessiert ist.

restartAdbBridge

public abstract void restartAdbBridge ()

Starten Sie die adb-Bridge neu, falls stopAdbBridge() aufgerufen wurde, und die Dienste, die von adb-Verbindungen abhängen.

stopAdbBridge

public abstract void stopAdbBridge ()

Die adb-Bridge und Dienste, die von adb-Verbindungen abhängen, werden angehalten.

beenden

public abstract void terminate ()

Beendet die Geräteüberwachungsdienste und beendet die DDM-Bibliothek.

Diese Funktion muss beim Beenden der Anwendung aufgerufen werden.

Weitere Informationen

AndroidDebugBridge.terminate()

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

Beenden Sie die Gerätemonitore.

terminateDeviceRecovery

public abstract void terminateDeviceRecovery ()

Beendet den Thread zur Gerätewiederherstellung.

terminateHard

public void terminateHard (String reason)

Ähnlich wie terminateHard().

Parameter
`reason`	`String`: Optionaler Grund für die Kündigung.

terminateHard

public abstract void terminateHard ()

Wie terminate(), aber es wird auch versucht, adb zu beenden.

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

Warten Sie, bis ein erstes physisches Gerät verbunden ist. Wenn ein Gerät bereits verbunden war, wird direkt „True“ zurückgegeben. Wenn kein Gerät hinzugefügt wurde, wird nach Ablauf der Zeitüberschreitung „false“ zurückgegeben.

Parameter
`timeout`	`long`: Zeit in Millisekunden, die gewartet wird, bevor „false“ zurückgegeben wird.

Returns
`boolean`

IDeviceManager

Zusammenfassung

Verschachtelte Klassen

Öffentliche Methoden

Öffentliche Methoden

addDeviceMonitor

addFastbootListener

addMonitoringTcpFastbootDevice

allocateDevice

allocateDevice

allocateDevice

connectToTcpDevice

disconnectFromTcpDevice

displayDevicesInfo

executeCmdOnAvailableDevice

forceAllocateDevice

freeDevice

getAdbPath

getAdbVersion

getDeviceDescriptor

getFastbootPath

init

init

isEmulator

isFileSystemMountCheckEnabled

isNullDevice

killEmulator

launchEmulator

listAllDevices

listAllDevices

reconnectDeviceToTcp

removeDeviceMonitor

removeFastbootListener

restartAdbBridge

stopAdbBridge

beenden

terminateDeviceMonitor

terminateDeviceRecovery

terminateHard

terminateHard

waitForFirstDeviceAdded