IDeviceStateMonitor

public interface IDeviceStateMonitor

com.android.tradefed.device.IDeviceStateMonitor

Bietet Funktionen zum Überwachen des Status einer IDevice.

Ein Gerät gilt derzeit nur dann als „verfügbar“, wenn vier Ereignisse wahr sind: 1. Das Gerät ist online, d. h. über DDMS/adb sichtbar (waitForDeviceOnline() 2. Auf dem Gerät ist das Flag „dev.bootcomplete“ gesetzt (@link #waitForBootComplete(long)} 3. Der Paketmanager des Geräts reagiert (möglicherweise nicht funktionsfähig) 4. Der externe Speicher des Geräts ist bereitgestellt. 3. & 4. Teil von waitForDeviceAvailable() sein.

Zusammenfassung

Öffentliche Methoden

default void attachFinalState(TestDeviceState finalState)

Fügen Sie einen Endstatus an, um waitForDeviceState abzubrechen, wenn er erreicht wird.

abstract TestDeviceState getDeviceState()

Ruft den Gerätestatus ab.

abstract String getFastbootSerialNumber()

Ruft die Seriennummer des Fastboot-Modus ab.

abstract String getMountPoint(String mountName)

Gibt einen Bereitstellungspunkt zurück.

abstract String getSerialNumber()

Ruft die Seriennummer des Geräts ab.

abstract boolean isAdbTcp()
abstract void setDefaultAvailableTimeout(long timeoutMs)

Legen Sie die Zeit in ms fest, die gewartet werden soll, bis ein Gerät in waitForDeviceAvailable() verfügbar ist.

abstract void setDefaultOnlineTimeout(long timeoutMs)

Legen Sie die Zeit in ms fest, die gewartet werden soll, bis ein Gerät in waitForDeviceOnline() online ist.

abstract void setFastbootSerialNumber(String serial)

Legt die Seriennummer für den Fastboot-Modus fest.

abstract void setIDevice(IDevice device)

Aktualisiert das aktuelle IDevice.

abstract void setState(TestDeviceState deviceState)

Legt den aktuellen Status des Geräts fest.

abstract boolean waitForBootComplete(long waitTime)

Blockiert, bis das Flag „Boot complete“ des Geräts gesetzt ist

abstract IDevice waitForDeviceAvailable(long waitTime)

Wartet, bis das Gerät reagiert und für den Test verfügbar ist.

abstract IDevice waitForDeviceAvailable()

Wartet, bis das Gerät reagiert und für den Test verfügbar ist.

default IDevice waitForDeviceAvailableInRecoverPath(long waitTime)

Eine spezielle Variante von waitForDeviceAvailable(long), die während des Wiederherstellungspfads aufgerufen wird, um die Verarbeitung anzupassen.

abstract boolean waitForDeviceBootloader(long waitTime)

Wartet, bis sich das Gerät im Bootloader befindet.

abstract void waitForDeviceBootloaderStateUpdate()

Warten, bis der Status des Bootloaders des Geräts aktualisiert wurde

abstract boolean waitForDeviceFastbootd(String fastbootPath, long waitTime)

Wartet, bis sich das Gerät in fastbootd befindet.

abstract IDevice waitForDeviceInRecovery()

Wartet mit der standardmäßigen Zeitüberschreitung für das Hochfahren, bis sich das Gerät im Wiederherstellungsmodus befindet.

abstract boolean waitForDeviceInRecovery(long waitTime)

Warten, bis sich das Gerät im Status „adb recovery“ befindet

abstract boolean waitForDeviceInSideload(long waitTime)

Warten, bis sich das Gerät im Status „adb sideload“ befindet

abstract boolean waitForDeviceNotAvailable(long waitTime)

Warten, bis das Gerät nicht verfügbar ist

abstract IDevice waitForDeviceOnline()

Wartet mit der Standard-Bootzeitüberschreitung, bis das Gerät online ist.

abstract IDevice waitForDeviceOnline(long time)

Wartet, bis das Gerät online ist.

abstract boolean waitForDeviceShell(long waitTime)

Wartet, bis das Gerät auf einen einfachen adb-Shell-Befehl reagiert.

Öffentliche Methoden

attachFinalState

public void attachFinalState (TestDeviceState finalState)

Fügen Sie einen Endstatus an, um waitForDeviceState abzubrechen, wenn er erreicht wird.

Parameter
finalState TestDeviceState

getDeviceState

public abstract TestDeviceState getDeviceState ()

Ruft den Gerätestatus ab.

Returns
TestDeviceState TestDeviceState des Geräts

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Ruft die Seriennummer des Fastboot-Modus ab.

Returns
String

getMountPoint

public abstract String getMountPoint (String mountName)

Gibt einen Bereitstellungspunkt zurück.

Das Gerät wird direkt abgefragt, wenn die im Cache in IDevice gespeicherten Informationen nicht verfügbar sind.

TODO: dieses Verhalten zu IDevice.getMountPoint(String) verschieben

Parameter
mountName String: der Name des Bereitstellungspunkts
Returns
String den Bereitstellungspunkt oder null
Ausgabe
DeviceNotAvailableException

Weitere Informationen

getSerialNumber

public abstract String getSerialNumber ()

Ruft die Seriennummer des Geräts ab.

Returns
String

isAdbTcp

public abstract boolean isAdbTcp ()

Returns
boolean true, wenn das Gerät über TCP mit adb verbunden ist

setDefaultAvailableTimeout

public abstract void setDefaultAvailableTimeout (long timeoutMs)

Legen Sie die Zeit in ms fest, die gewartet werden soll, bis ein Gerät in waitForDeviceAvailable() verfügbar ist.

Parameter
timeoutMs long

setDefaultOnlineTimeout

public abstract void setDefaultOnlineTimeout (long timeoutMs)

Legen Sie die Zeit in ms fest, die gewartet werden soll, bis ein Gerät in waitForDeviceOnline() online ist.

Parameter
timeoutMs long

setFastbootSerialNumber

public abstract void setFastbootSerialNumber (String serial)

Legt die Seriennummer für den Fastboot-Modus fest.

Parameter
serial String

setIDevice

public abstract void setIDevice (IDevice device)

Aktualisiert das aktuelle IDevice.

setState

public abstract void setState (TestDeviceState deviceState)

Legt den aktuellen Status des Geräts fest.

waitForBootComplete

public abstract boolean waitForBootComplete (long waitTime)

Blockiert, bis das Flag „Boot complete“ des Geräts gesetzt ist

Parameter
waitTime long: Wartezeit in ms
Returns
boolean

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable (long waitTime)

Wartet, bis das Gerät reagiert und für den Test verfügbar ist. Derzeit bedeutet das, dass der Paketmanager und der externe Speicher verfügbar sind.

Parameter
waitTime long: die Wartezeit in ms
Returns
IDevice die IDevice, wenn das Gerät vor Ablauf der Zeit online geht. null andernfalls.

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable ()

Wartet, bis das Gerät reagiert und für den Test verfügbar ist.

Entspricht waitForDeviceAvailable(long), verwendet jedoch das standardmäßige Zeitlimit für das Starten des Geräts.

Returns
IDevice die IDevice, wenn das Gerät vor Ablauf der Zeit online geht. null andernfalls.

waitForDeviceAvailableInRecoverPath

public IDevice waitForDeviceAvailableInRecoverPath (long waitTime)

Eine spezielle Variante von waitForDeviceAvailable(long), die während des Wiederherstellungspfads aufgerufen wird, um die Verarbeitung anzupassen.

Parameter
waitTime long

Returns
IDevice

Ausgabe
DeviceNotAvailableException wenn das Gerät nicht mehr verfügbar ist.

waitForDeviceBootloader

public abstract boolean waitForDeviceBootloader (long waitTime)

Wartet, bis sich das Gerät im Bootloader befindet.

Parameter
waitTime long: die maximale Wartezeit in ms
Returns
boolean true wenn sich das Gerät vor Ablauf der Zeit im Bootloader befindet

waitForDeviceBootloaderStateUpdate

public abstract void waitForDeviceBootloaderStateUpdate ()

Warten, bis der Status des Bootloaders des Geräts aktualisiert wurde

waitForDeviceFastbootd

public abstract boolean waitForDeviceFastbootd (String fastbootPath, 
                long waitTime)

Wartet, bis sich das Gerät in fastbootd befindet.

Parameter
fastbootPath String: der Pfad der zu verwendenden Fastboot-Binärdatei.
waitTime long: die maximale Wartezeit in ms
Returns
boolean true, wenn sich das Gerät vor Ablauf der Zeit in fastbootd befindet

waitForDeviceInRecovery

public abstract IDevice waitForDeviceInRecovery ()

Wartet mit der standardmäßigen Zeitüberschreitung für das Hochfahren, bis sich das Gerät im Wiederherstellungsmodus befindet.

Returns
IDevice die IDevice, wenn das Gerät vor Ablauf der Frist wiederhergestellt wird. null andernfalls.

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

Warten, bis sich das Gerät im Status „adb recovery“ befindet

Parameter
waitTime long: die maximale Wartezeit in ms
Returns
boolean „True“, wenn sich das Gerät vor Ablauf der Zeitüberschreitung im Wiederherstellungsmodus befindet, andernfalls „False“.

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

Warten, bis sich das Gerät im Status „adb sideload“ befindet

Parameter
waitTime long: die maximale Wartezeit in ms
Returns
boolean „True“, wenn das Gerät vor Ablauf der Zeitüberschreitung im Sideload-Modus ist, andernfalls „False“.

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

Warten, bis das Gerät nicht verfügbar ist

Parameter
waitTime long: die maximale Wartezeit in ms
Returns
boolean true, wenn das Gerät nicht mehr verfügbar ist

waitForDeviceOnline

public abstract IDevice waitForDeviceOnline ()

Wartet mit der Standard-Bootzeitüberschreitung, bis das Gerät online ist.

Hinweis: Diese Methode wird zurückgegeben, sobald das Gerät über DDMS sichtbar ist. Es ist nicht garantiert, dass das Gerät tatsächlich auf adb-Befehle reagiert. Verwenden Sie stattdessen waitForDeviceAvailable().

Returns
IDevice die IDevice, wenn das Gerät vor Ablauf der Zeit online geht. null andernfalls.

waitForDeviceOnline

public abstract IDevice waitForDeviceOnline (long time)

Wartet, bis das Gerät online ist.

Hinweis: Diese Methode wird zurückgegeben, sobald das Gerät über DDMS sichtbar ist. Es ist nicht garantiert, dass das Gerät tatsächlich auf adb-Befehle reagiert. Verwenden Sie stattdessen waitForDeviceAvailable().

Parameter
time long: die maximale Wartezeit in ms
Returns
IDevice die IDevice, wenn das Gerät vor Ablauf der Zeit online geht. null andernfalls.

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

Wartet, bis das Gerät auf einen einfachen adb-Shell-Befehl reagiert.

Parameter
waitTime long: die Wartezeit in ms
Returns
boolean true, wenn das Gerät reagiert, bevor waitTime abgelaufen ist.