IDeviceStateMonitor

public interface IDeviceStateMonitor

com.android.tradefed.device.IDeviceStateMonitor


Fornisce strumenti per monitorare lo stato di un IDevice.

Un dispositivo è attualmente considerato "disponibile" se e solo se quattro eventi sono veri: 1. Il dispositivo è online, ovvero visibile tramite DDMS/adb (waitForDeviceOnline() 2. Il dispositivo ha il flag dev.bootcomplete impostato (@link #waitForBootComplete(long)} 3. Il gestore dei pacchetti del dispositivo è reattivo (potrebbe non funzionare) 4. L'unità di archiviazione esterna del dispositivo è montata 3. & 4. far parte di waitForDeviceAvailable().

Riepilogo

Metodi pubblici

default void attachFinalState(TestDeviceState finalState)

Collega uno stato finale per interrompere waitForDeviceState se raggiunto.

default void clearTcpFastbootMonitor()

Cancella qualsiasi stato in Gestione dispositivi.

abstract TestDeviceState getDeviceState()

Recupera lo stato del dispositivo.

abstract String getFastbootSerialNumber()

Recupera il numero di serie della modalità fastboot.

abstract String getMountPoint(String mountName)

Restituisce un punto di montaggio.

abstract String getSerialNumber()

Ottiene il numero di serie del dispositivo.

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

Imposta il tempo in millisecondi da attendere prima che un dispositivo sia disponibile in waitForDeviceAvailable().

abstract void setDefaultOnlineTimeout(long timeoutMs)

Imposta il tempo in millisecondi da attendere prima che un dispositivo sia online in waitForDeviceOnline().

abstract void setFastbootSerialNumber(String serial)

Imposta il numero di serie della modalità fastboot.

abstract void setIDevice(IDevice device)

Aggiorna l'IDevice attuale.

abstract void setState(TestDeviceState deviceState)

Imposta lo stato attuale del dispositivo.

abstract boolean waitForBootComplete(long waitTime)

Blocca fino a quando non viene impostato il flag di completamento dell'avvio del dispositivo

abstract IDevice waitForDeviceAvailable(long waitTime)

Attende che il dispositivo sia reattivo e disponibile per i test.

abstract IDevice waitForDeviceAvailable()

Attende che il dispositivo sia reattivo e disponibile per i test.

default IDevice waitForDeviceAvailableInRecoverPath(long waitTime)

Variante speciale di waitForDeviceAvailable(long) da chiamare durante il percorso di recupero per personalizzare la gestione.

abstract boolean waitForDeviceBootloader(long waitTime)

Attende che il dispositivo sia nel bootloader.

abstract void waitForDeviceBootloaderStateUpdate()

Attende l'aggiornamento dello stato del bootloader del dispositivo

abstract boolean waitForDeviceFastbootd(String fastbootPath, long waitTime)

Attende che il dispositivo sia in fastbootd.

abstract IDevice waitForDeviceInRecovery()

Attende che il dispositivo sia in modalità di ripristino utilizzando il timeout di avvio standard.

abstract boolean waitForDeviceInRecovery(long waitTime)

Attende che il dispositivo sia nello stato "adb recovery"

abstract boolean waitForDeviceInSideload(long waitTime)

Attende che il dispositivo sia nello stato "adb sideload"

abstract boolean waitForDeviceNotAvailable(long waitTime)

Attende che il dispositivo non sia disponibile

abstract IDevice waitForDeviceOnline()

Attende che il dispositivo sia online utilizzando il timeout di avvio standard.

abstract IDevice waitForDeviceOnline(long time)

Attende che il dispositivo sia online.

abstract boolean waitForDeviceShell(long waitTime)

Attende che il dispositivo risponda a un comando di base della shell ADB.

Metodi pubblici

attachFinalState

public void attachFinalState (TestDeviceState finalState)

Collega uno stato finale per interrompere waitForDeviceState se raggiunto.

Parametri
finalState TestDeviceState

clearTcpFastbootMonitor

public void clearTcpFastbootMonitor ()

Cancella qualsiasi stato in Gestione dispositivi.

getDeviceState

public abstract TestDeviceState getDeviceState ()

Recupera lo stato del dispositivo.

Ritorni
TestDeviceState il TestDeviceState del dispositivo

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Recupera il numero di serie della modalità fastboot.

Ritorni
String

getMountPoint

public abstract String getMountPoint (String mountName)

Restituisce un punto di montaggio.

Esegue query direttamente sul dispositivo se le informazioni memorizzate nella cache in IDevice non sono disponibili.

DA FARE: sposta questo comportamento in IDevice.getMountPoint(String)

Parametri
mountName String: il nome del punto di montaggio

Ritorni
String il punto di montaggio o null

Lanci
DeviceNotAvailableException

getSerialNumber

public abstract String getSerialNumber ()

Ottiene il numero di serie del dispositivo.

Ritorni
String

isAdbTcp

public abstract boolean isAdbTcp ()

Ritorni
boolean true se il dispositivo è connesso ad ADB tramite TCP

setDefaultAvailableTimeout

public abstract void setDefaultAvailableTimeout (long timeoutMs)

Imposta il tempo in millisecondi da attendere prima che un dispositivo sia disponibile in waitForDeviceAvailable().

Parametri
timeoutMs long

setDefaultOnlineTimeout

public abstract void setDefaultOnlineTimeout (long timeoutMs)

Imposta il tempo in millisecondi da attendere prima che un dispositivo sia online in waitForDeviceOnline().

Parametri
timeoutMs long

setFastbootSerialNumber

public abstract void setFastbootSerialNumber (String serial)

Imposta il numero di serie della modalità fastboot.

Parametri
serial String

setIDevice

public abstract void setIDevice (IDevice device)

Aggiorna l'IDevice attuale.

setState

public abstract void setState (TestDeviceState deviceState)

Imposta lo stato attuale del dispositivo.

waitForBootComplete

public abstract boolean waitForBootComplete (long waitTime)

Blocca fino a quando non viene impostato il flag di completamento dell'avvio del dispositivo

Parametri
waitTime long: l'importo in ms da attendere

Ritorni
boolean

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable (long waitTime)

Attende che il dispositivo sia reattivo e disponibile per i test. Al momento, ciò significa che sono disponibili il gestore di pacchetti e lo spazio di archiviazione esterno.

Parametri
waitTime long: il tempo in millisecondi da attendere

Ritorni
IDevice IDevice se il dispositivo torna online prima della scadenza del tempo. null altrimenti.

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable ()

Attende che il dispositivo sia reattivo e disponibile per i test.

Equivalente a waitForDeviceAvailable(long), ma utilizza il timeout di avvio del dispositivo predefinito.

Ritorni
IDevice IDevice se il dispositivo torna online prima della scadenza del tempo. null altrimenti.

waitForDeviceAvailableInRecoverPath

public IDevice waitForDeviceAvailableInRecoverPath (long waitTime)

Variante speciale di waitForDeviceAvailable(long) da chiamare durante il percorso di recupero per personalizzare la gestione.

Parametri
waitTime long

Ritorni
IDevice

Lanci
DeviceNotAvailableException se il dispositivo non è più disponibile.

waitForDeviceBootloader

public abstract boolean waitForDeviceBootloader (long waitTime)

Attende che il dispositivo sia nel bootloader.

Parametri
waitTime long: il tempo massimo in millisecondi da attendere

Ritorni
boolean true se il dispositivo è nel bootloader prima della scadenza del tempo

waitForDeviceBootloaderStateUpdate

public abstract void waitForDeviceBootloaderStateUpdate ()

Attende l'aggiornamento dello stato del bootloader del dispositivo

waitForDeviceFastbootd

public abstract boolean waitForDeviceFastbootd (String fastbootPath, 
                long waitTime)

Attende che il dispositivo sia in fastbootd.

Parametri
fastbootPath String: il percorso del file binario fastboot da utilizzare.

waitTime long: il tempo massimo in millisecondi da attendere

Ritorni
boolean true se il dispositivo è in fastbootd prima della scadenza del tempo

waitForDeviceInRecovery

public abstract IDevice waitForDeviceInRecovery ()

Attende che il dispositivo sia in modalità di ripristino utilizzando il timeout di avvio standard.

Ritorni
IDevice il IDevice se il dispositivo entra in modalità di recupero prima della scadenza del tempo. null altrimenti.

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

Attende che il dispositivo sia nello stato "adb recovery"

Parametri
waitTime long: il tempo massimo in millisecondi da attendere

Ritorni
boolean True se il dispositivo è in modalità di ripristino prima del timeout, False in caso contrario.

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

Attende che il dispositivo sia nello stato "adb sideload"

Parametri
waitTime long: il tempo massimo in millisecondi da attendere

Ritorni
boolean True se il dispositivo è in sideload prima del timeout, False in caso contrario.

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

Attende che il dispositivo non sia disponibile

Parametri
waitTime long: il tempo massimo in millisecondi da attendere

Ritorni
boolean true se il dispositivo non è più disponibile

waitForDeviceOnline

public abstract IDevice waitForDeviceOnline ()

Attende che il dispositivo sia online utilizzando il timeout di avvio standard.

Nota: questo metodo verrà restituito una volta che il dispositivo sarà visibile tramite DDMS. Non garantisce che il dispositivo risponda effettivamente ai comandi adb. Utilizza waitForDeviceAvailable() in alternativa.

Ritorni
IDevice IDevice se il dispositivo torna online prima della scadenza del tempo. null altrimenti.

waitForDeviceOnline

public abstract IDevice waitForDeviceOnline (long time)

Attende che il dispositivo sia online.

Nota: questo metodo verrà restituito una volta che il dispositivo sarà visibile tramite DDMS. Non garantisce che il dispositivo risponda effettivamente ai comandi adb. Utilizza waitForDeviceAvailable() in alternativa.

Parametri
time long: il tempo massimo in millisecondi da attendere

Ritorni
IDevice IDevice se il dispositivo torna online prima della scadenza del tempo. null altrimenti.

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

Attende che il dispositivo risponda a un comando di base della shell ADB.

Parametri
waitTime long: il tempo in millisecondi da attendere

Ritorni
boolean true se il dispositivo torna a rispondere prima che trascorrano waitTime.