IDDeviceStateMonitor

public interface IDeviceStateMonitor

com.android.tradefed.device.IDeviceStateMonitor


Fornisce funzionalità per il monitoraggio dello 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 pacchetti del dispositivo è reattivo (potrebbe essere inoperativo) 4. La memoria esterna del dispositivo è montata 3. & 4. fa parte di waitForDeviceAvailable() .

Riepilogo

Metodi pubblici

abstract TestDeviceState getDeviceState ()

Ottiene lo stato del dispositivo.

abstract String getFastbootSerialNumber ()

Ottiene 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 ms per attendere che un dispositivo sia disponibile in waitForDeviceAvailable() .

abstract void setDefaultOnlineTimeout (long timeoutMs)

Imposta il tempo in ms per attendere 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 corrente.

abstract void setState ( TestDeviceState deviceState)

Imposta lo stato corrente del dispositivo.

abstract boolean waitForBootComplete (long waitTime)

Si blocca finché non viene impostato il flag di avvio completo del dispositivo

abstract IDevice waitForDeviceAvailable ()

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

abstract IDevice waitForDeviceAvailable (long waitTime)

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

default IDevice waitForDeviceAvailableInRecoverPath (long waitTime)

Variante speciale di waitForDeviceAvailable(long) da chiamare durante il percorso di ripristino 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 boolean waitForDeviceInRecovery (long waitTime)

Attende che il dispositivo sia nello stato di "ripristino adb".

abstract IDevice waitForDeviceInRecovery ()

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

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 shell adb di base.

Metodi pubblici

getDeviceState

public abstract TestDeviceState getDeviceState ()

Ottiene lo stato del dispositivo.

ritorna
TestDeviceState il TestDeviceState del dispositivo

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Ottiene il numero di serie della modalità fastboot.

ritorna
String

getMountPoint

public abstract String getMountPoint (String mountName)

Restituisce un punto di montaggio.

Interroga direttamente il dispositivo se le informazioni memorizzate nella cache in IDevice non sono disponibili.

TODO: sposta questo comportamento su IDevice#getMountPoint(String)

Parametri
mountName String : il nome del punto di montaggio

ritorna
String il punto di montaggio o null

Getta
DeviceNotAvailableException

getSerialNumber

public abstract String getSerialNumber ()

Ottiene il numero di serie del dispositivo.

ritorna
String

isAdbTcp

public abstract boolean isAdbTcp ()

ritorna
boolean true se il dispositivo è connesso ad adb tramite tcp

setDefaultAvailableTimeout

public abstract void setDefaultAvailableTimeout (long timeoutMs)

Imposta il tempo in ms per attendere che un dispositivo sia disponibile in waitForDeviceAvailable() .

Parametri
timeoutMs long

setDefaultOnlineTimeout

public abstract void setDefaultOnlineTimeout (long timeoutMs)

Imposta il tempo in ms per attendere 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 corrente.

setState

public abstract void setState (TestDeviceState deviceState)

Imposta lo stato corrente del dispositivo.

waitForBootComplete

public abstract boolean waitForBootComplete (long waitTime)

Si blocca finché non viene impostato il flag di avvio completo del dispositivo

Parametri
waitTime long : la quantità in ms da attendere

ritorna
boolean

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable ()

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

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

ritorna
IDevice l' IDevice se il dispositivo diventa online prima dello scadere del tempo. null altrimenti.

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable (long waitTime)

Attende che il dispositivo sia reattivo e disponibile per il test. Attualmente ciò significa che sono disponibili il gestore pacchetti e l'archiviazione esterna.

Parametri
waitTime long : il tempo in ms di attesa

ritorna
IDevice l' IDevice se il dispositivo diventa online prima dello scadere del tempo. null altrimenti.

waitForDeviceAvailableInRecoverPath

public IDevice waitForDeviceAvailableInRecoverPath (long waitTime)

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

Parametri
waitTime long

ritorna
IDevice

Getta
DeviceNotAvailableException se il dispositivo non è disponibile.

waitForDeviceBootloader

public abstract boolean waitForDeviceBootloader (long waitTime)

Attende che il dispositivo sia nel bootloader.

Parametri
waitTime long : il tempo massimo di attesa in ms

ritorna
boolean true se il dispositivo è nel bootloader prima che scada il 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 di attesa in ms

ritorna
boolean true se il dispositivo è in fastbootd prima dello scadere del tempo

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

Attende che il dispositivo sia nello stato di "ripristino adb".

Parametri
waitTime long : il tempo massimo di attesa in ms

ritorna
boolean True se il dispositivo è in Recovery prima del timeout, False in caso contrario.

waitForDeviceInRecovery

public abstract IDevice waitForDeviceInRecovery ()

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

ritorna
IDevice l' IDevice se il dispositivo viene ripristinato prima dello scadere del tempo. null altrimenti.

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

Attende che il dispositivo sia nello stato 'adb sideload'

Parametri
waitTime long : il tempo massimo di attesa in ms

ritorna
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 di attesa in ms

ritorna
boolean true se il dispositivo diventa non 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: usa invece waitForDeviceAvailable() .

ritorna
IDevice l' IDevice se il dispositivo diventa online prima dello scadere 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: usa invece waitForDeviceAvailable() .

Parametri
time long : il tempo massimo di attesa in ms

ritorna
IDevice l' IDevice se il dispositivo diventa online prima dello scadere del tempo. null altrimenti.

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

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

Parametri
waitTime long : il tempo in ms di attesa

ritorna
boolean true se il dispositivo risponde prima che sia trascorso waitTime .