IDeviceStateMonitor

public interface IDeviceStateMonitor

com.android.tradefed.device.IDeviceStateMonitor

Bietet Funktionen zum Überwachen des Status einer IDevice.

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

Zusammenfassung

Öffentliche Methoden

default void attachFinalState(TestDeviceState finalState)

Hängen Sie einen Endstatus an, um „waitForDeviceState“ abzubrechen, wenn er erreicht wird.

default void clearTcpFastbootMonitor()

Löschen Sie alle Status im Geräte-Manager.

abstract TestDeviceState getDeviceState()

Ruft den Gerätestatus ab.

abstract String getFastbootSerialNumber()

Ruft die Seriennummer im 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)

Legt die Wartezeit in Millisekunden fest, bis ein Gerät in waitForDeviceAvailable() verfügbar ist.

abstract void setDefaultOnlineTimeout(long timeoutMs)

Legt die Wartezeit in Millisekunden fest, 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 Boot-Complete-Flag des Geräts gesetzt ist

abstract IDevice waitForDeviceAvailable(long waitTime)

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

abstract IDevice waitForDeviceAvailable()

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

default IDevice waitForDeviceAvailableInRecoverPath(long waitTime)

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

Wartet, bis der Bootloader-Status 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, bis sich das Gerät im Wiederherstellungsmodus befindet. Dabei wird das standardmäßige Boot-Zeitlimit verwendet.

abstract boolean waitForDeviceInRecovery(long waitTime)

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

abstract boolean waitForDeviceInSideload(long waitTime)

Wartet, 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, bis das Gerät online ist, wobei das Standard-Boot-Zeitlimit verwendet wird.

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)

Hängen Sie einen Endstatus an, um „waitForDeviceState“ abzubrechen, wenn er erreicht wird.

Parameter
finalState TestDeviceState

clearTcpFastbootMonitor

public void clearTcpFastbootMonitor ()

Löschen Sie alle Status im Geräte-Manager.

getDeviceState

public abstract TestDeviceState getDeviceState ()

Ruft den Gerätestatus ab.

Returns
TestDeviceState die TestDeviceState des Geräts

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Ruft die Seriennummer im Fastboot-Modus ab.

Returns
String

getMountPoint

public abstract String getMountPoint (String mountName)

Gibt einen Bereitstellungspunkt zurück.

Fragt das Gerät direkt ab, wenn die im Cache gespeicherten Informationen in IDevice 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)

Legt die Wartezeit in Millisekunden fest, bis ein Gerät in waitForDeviceAvailable() verfügbar ist.

Parameter
timeoutMs long

setDefaultOnlineTimeout

public abstract void setDefaultOnlineTimeout (long timeoutMs)

Legt die Wartezeit in Millisekunden fest, 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 Boot-Complete-Flag des Geräts gesetzt ist

Parameter
waitTime long: die Anzahl der Millisekunden, die gewartet werden soll.
Returns
boolean

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable (long waitTime)

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

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

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable ()

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

Entspricht waitForDeviceAvailable(long), verwendet aber das standardmäßige Zeitlimit für den Geräte-Bootvorgang.

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

waitForDeviceAvailableInRecoverPath

public IDevice waitForDeviceAvailableInRecoverPath (long waitTime)

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 Millisekunden
Returns
boolean true, wenn sich das Gerät vor Ablauf der Zeit im Bootloader befindet

waitForDeviceBootloaderStateUpdate

public abstract void waitForDeviceBootloaderStateUpdate ()

Wartet, bis der Bootloader-Status 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 Millisekunden
Returns
boolean true, wenn sich das Gerät vor Ablauf der Zeit im Fastbootd-Modus befindet

waitForDeviceInRecovery

public abstract IDevice waitForDeviceInRecovery ()

Wartet, bis sich das Gerät im Wiederherstellungsmodus befindet. Dabei wird das standardmäßige Boot-Zeitlimit verwendet.

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

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

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

Parameter
waitTime long: die maximale Wartezeit in Millisekunden
Returns
boolean „True“, wenn sich das Gerät vor dem Zeitlimit im Wiederherstellungsmodus befindet, andernfalls „False“.

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

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

Parameter
waitTime long: die maximale Wartezeit in Millisekunden
Returns
boolean „True“, wenn das Gerät vor dem Zeitlimit 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 Millisekunden
Returns
boolean true, wenn das Gerät nicht mehr verfügbar ist

waitForDeviceOnline

public abstract IDevice waitForDeviceOnline ()

Wartet, bis das Gerät online ist, wobei das Standard-Boot-Zeitlimit verwendet wird.

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

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

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 wird nicht garantiert, dass das Gerät tatsächlich auf ADB-Befehle reagiert. Verwenden Sie stattdessen waitForDeviceAvailable().

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

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 Millisekunden
Returns
boolean true, wenn das Gerät reagiert, bevor waitTime abgelaufen ist.