IDeviceStateMonitor

public interface IDeviceStateMonitor

com.android.tradefed.device.IDeviceStateMonitor


Fornisce strumenti 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 non essere operativo) 4. L'unità di archiviazione esterna del dispositivo sia montata. 3. 4. che fanno parte di waitForDeviceAvailable().

Riepilogo

Metodi pubblici

default void attachFinalState(TestDeviceState finalState)

Collega uno stato finale per interrompere waitForDeviceState se viene raggiunto.

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

Recupera il numero di serie del dispositivo.

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

Imposta il tempo in ms di attesa per la disponibilità di un dispositivo in waitForDeviceAvailable().

abstract void setDefaultOnlineTimeout(long timeoutMs)

Imposta il tempo in millisecondi di attesa per l'online di un dispositivo 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)

Blocca fino all'impostazione dell'indicatore di completamento dell'avvio del dispositivo

abstract IDevice waitForDeviceAvailable(long waitTime)

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

abstract IDevice waitForDeviceAvailable()

Attende che il dispositivo risponda e sia 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 in 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 "sideload adb"

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 viene raggiunto.

Parametri
finalState TestDeviceState

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

Recupera 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 ms di attesa per la disponibilità di un dispositivo in waitForDeviceAvailable().

Parametri
timeoutMs long

setDefaultOnlineTimeout

public abstract void setDefaultOnlineTimeout (long timeoutMs)

Imposta il tempo in millisecondi di attesa per l'online di un dispositivo 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)

Blocca fino all'impostazione dell'indicatore di completamento dell'avvio del dispositivo

Parametri
waitTime long: il tempo di attesa in ms

Ritorni
boolean

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable (long waitTime)

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

Parametri
waitTime long: il tempo in millisecondi da attendere

Ritorni
IDevice IDevice se il dispositivo diventa online prima della scadenza del tempo. null in caso contrario.

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable ()

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

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

Ritorni
IDevice IDevice se il dispositivo diventa online prima della scadenza del tempo. null in caso contrario.

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 è disponibile.

waitForDeviceBootloader

public abstract boolean waitForDeviceBootloader (long waitTime)

Attende che il dispositivo sia in bootloader.

Parametri
waitTime long: il tempo massimo in millisecondi da attendere

Ritorni
boolean true se il dispositivo è in 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 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 "sideload adb"

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 è disponibile

waitForDeviceOnline

public abstract IDevice waitForDeviceOnline ()

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

Nota: questo metodo viene restituito quando il dispositivo è visibile tramite DDMS. Non garantisce che il dispositivo risponda effettivamente ai comandi adb. Utilizza waitForDeviceAvailable().

Ritorni
IDevice IDevice se il dispositivo diventa online prima della scadenza del tempo. null in caso contrario.

waitForDeviceOnline

public abstract IDevice waitForDeviceOnline (long time)

Attende che il dispositivo sia online.

Nota: questo metodo viene restituito quando il dispositivo è visibile tramite DDMS. Non garantisce che il dispositivo risponda effettivamente ai comandi adb. Utilizza waitForDeviceAvailable().

Parametri
time long: il tempo massimo in millisecondi da attendere

Ritorni
IDevice IDevice se il dispositivo diventa online prima della scadenza del tempo. null in caso contrario.

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 risponde prima del termine del periodo waitTime.