IDeviceStateMonitor

public interface IDeviceStateMonitor

com.android.tradefed.device.IDeviceStateMonitor


Fornece recursos para monitorar o estado de um IDevice.

Um dispositivo é considerado "disponível" se e somente se quatro eventos forem verdadeiros: 1. O dispositivo está on-line, ou seja, visível via DDMS/adb (waitForDeviceOnline() 2. O dispositivo tem a flag dev.bootcomplete definida (@link #waitForBootComplete(long)} 3. O gerenciador de pacotes do dispositivo está responsivo (pode estar inoperante) 4. O armazenamento externo do dispositivo está conectado 3. & 4. fazer parte de waitForDeviceAvailable().

Resumo

Métodos públicos

default void attachFinalState(TestDeviceState finalState)

Anexe um estado final para interromper "waitForDeviceState" se ele for atingido.

default void clearTcpFastbootMonitor()

Limpe qualquer estado no gerenciador de dispositivos.

abstract TestDeviceState getDeviceState()

Recebe o estado do dispositivo.

abstract String getFastbootSerialNumber()

Recebe o número de série do modo fastboot.

abstract String getMountPoint(String mountName)

Retorna um ponto de montagem.

abstract String getSerialNumber()

Recebe o número de série do dispositivo.

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

Defina o tempo em ms para aguardar a disponibilidade de um dispositivo em waitForDeviceAvailable().

abstract void setDefaultOnlineTimeout(long timeoutMs)

Defina o tempo em ms para esperar que um dispositivo fique on-line em waitForDeviceOnline().

abstract void setFastbootSerialNumber(String serial)

Define o número de série do modo fastboot.

abstract void setIDevice(IDevice device)

Atualiza o IDevice atual.

abstract void setState(TestDeviceState deviceState)

Define o estado atual do dispositivo.

abstract boolean waitForBootComplete(long waitTime)

Bloqueia até que a flag de conclusão da inicialização do dispositivo seja definida.

abstract IDevice waitForDeviceAvailable(long waitTime)

Aguarde até que o dispositivo esteja responsivo e disponível para testes.

abstract IDevice waitForDeviceAvailable()

Aguarde até que o dispositivo esteja responsivo e disponível para testes.

default IDevice waitForDeviceAvailableInRecoverPath(long waitTime)

Variante especial de waitForDeviceAvailable(long) a ser chamada durante o caminho de recuperação para adaptar o processamento.

abstract boolean waitForDeviceBootloader(long waitTime)

Aguarde o dispositivo entrar no carregador de inicialização.

abstract void waitForDeviceBootloaderStateUpdate()

Aguardar a atualização do estado do carregador de inicialização do dispositivo

abstract boolean waitForDeviceFastbootd(String fastbootPath, long waitTime)

Aguarde o dispositivo entrar no fastbootd.

abstract IDevice waitForDeviceInRecovery()

Aguarde o dispositivo entrar no modo de recuperação usando o tempo limite de inicialização padrão.

abstract boolean waitForDeviceInRecovery(long waitTime)

Aguardar o dispositivo estar no estado "adb recovery"

abstract boolean waitForDeviceInSideload(long waitTime)

Aguardar o dispositivo estar no estado "adb sideload"

abstract boolean waitForDeviceNotAvailable(long waitTime)

Aguardar até que o dispositivo não esteja disponível

abstract IDevice waitForDeviceOnline()

Aguarde que o dispositivo fique on-line usando o tempo limite de inicialização padrão.

abstract IDevice waitForDeviceOnline(long time)

Aguarde até que o dispositivo fique on-line.

abstract boolean waitForDeviceShell(long waitTime)

Aguarde até que o dispositivo responda a um comando básico do shell adb.

Métodos públicos

attachFinalState

public void attachFinalState (TestDeviceState finalState)

Anexe um estado final para interromper "waitForDeviceState" se ele for atingido.

Parâmetros
finalState TestDeviceState

clearTcpFastbootMonitor

public void clearTcpFastbootMonitor ()

Limpe qualquer estado no gerenciador de dispositivos.

getDeviceState

public abstract TestDeviceState getDeviceState ()

Recebe o estado do dispositivo.

Retorna
TestDeviceState o TestDeviceState do dispositivo

getFastbootSerialNumber

public abstract String getFastbootSerialNumber ()

Recebe o número de série do modo fastboot.

Retorna
String

getMountPoint

public abstract String getMountPoint (String mountName)

Retorna um ponto de montagem.

Consulta o dispositivo diretamente se as informações armazenadas em cache em IDevice não estiverem disponíveis.

TODO: mover esse comportamento para IDevice.getMountPoint(String)

Parâmetros
mountName String: o nome do ponto de montagem

Retorna
String o ponto de montagem ou null

Gera
DeviceNotAvailableException

getSerialNumber

public abstract String getSerialNumber ()

Recebe o número de série do dispositivo.

Retorna
String

isAdbTcp

public abstract boolean isAdbTcp ()

Retorna
boolean true se o dispositivo estiver conectado ao adb via tcp

setDefaultAvailableTimeout

public abstract void setDefaultAvailableTimeout (long timeoutMs)

Defina o tempo em ms para aguardar a disponibilidade de um dispositivo em waitForDeviceAvailable().

Parâmetros
timeoutMs long

setDefaultOnlineTimeout

public abstract void setDefaultOnlineTimeout (long timeoutMs)

Defina o tempo em ms para esperar que um dispositivo fique on-line em waitForDeviceOnline().

Parâmetros
timeoutMs long

setFastbootSerialNumber

public abstract void setFastbootSerialNumber (String serial)

Define o número de série do modo fastboot.

Parâmetros
serial String

setIDevice

public abstract void setIDevice (IDevice device)

Atualiza o IDevice atual.

setState

public abstract void setState (TestDeviceState deviceState)

Define o estado atual do dispositivo.

waitForBootComplete

public abstract boolean waitForBootComplete (long waitTime)

Bloqueia até que a flag de conclusão da inicialização do dispositivo seja definida.

Parâmetros
waitTime long: a quantidade em ms a ser aguardada

Retorna
boolean

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable (long waitTime)

Aguarde até que o dispositivo esteja responsivo e disponível para testes. No momento, isso significa que o gerenciador de pacotes e o armazenamento externo estão disponíveis.

Parâmetros
waitTime long: o tempo em ms para aguardar

Retorna
IDevice o IDevice se o dispositivo ficar on-line antes do vencimento do prazo. null caso contrário.

waitForDeviceAvailable

public abstract IDevice waitForDeviceAvailable ()

Aguarde até que o dispositivo esteja responsivo e disponível para testes.

Equivalente a waitForDeviceAvailable(long), mas usa o tempo limite de inicialização padrão do dispositivo.

Retorna
IDevice o IDevice se o dispositivo ficar on-line antes do vencimento do prazo. null caso contrário.

waitForDeviceAvailableInRecoverPath

public IDevice waitForDeviceAvailableInRecoverPath (long waitTime)

Variante especial de waitForDeviceAvailable(long) a ser chamada durante o caminho de recuperação para adaptar o processamento.

Parâmetros
waitTime long

Retorna
IDevice

Gera
DeviceNotAvailableException se o dispositivo ficar indisponível.

waitForDeviceBootloader

public abstract boolean waitForDeviceBootloader (long waitTime)

Aguarde o dispositivo entrar no carregador de inicialização.

Parâmetros
waitTime long: o tempo máximo em ms para aguardar

Retorna
boolean true se o dispositivo estiver no carregador de inicialização antes do fim do tempo

waitForDeviceBootloaderStateUpdate

public abstract void waitForDeviceBootloaderStateUpdate ()

Aguardar a atualização do estado do carregador de inicialização do dispositivo

waitForDeviceFastbootd

public abstract boolean waitForDeviceFastbootd (String fastbootPath, 
                long waitTime)

Aguarde o dispositivo entrar no fastbootd.

Parâmetros
fastbootPath String: o caminho do binário fastboot a ser usado.

waitTime long: o tempo máximo em ms para aguardar

Retorna
boolean true se o dispositivo estiver no fastbootd antes do tempo expirar

waitForDeviceInRecovery

public abstract IDevice waitForDeviceInRecovery ()

Aguarde o dispositivo entrar no modo de recuperação usando o tempo limite de inicialização padrão.

Retorna
IDevice o IDevice se o dispositivo entrar em recuperação antes do tempo expirar. null caso contrário.

waitForDeviceInRecovery

public abstract boolean waitForDeviceInRecovery (long waitTime)

Aguardar o dispositivo estar no estado "adb recovery"

Parâmetros
waitTime long: o tempo máximo em ms para aguardar

Retorna
boolean True se o dispositivo estiver em recuperação antes do tempo limite. Caso contrário, False.

waitForDeviceInSideload

public abstract boolean waitForDeviceInSideload (long waitTime)

Aguardar o dispositivo estar no estado "adb sideload"

Parâmetros
waitTime long: o tempo máximo em ms para aguardar

Retorna
boolean True se o dispositivo estiver em sideload antes do tempo limite. Caso contrário, False.

waitForDeviceNotAvailable

public abstract boolean waitForDeviceNotAvailable (long waitTime)

Aguardar até que o dispositivo não esteja disponível

Parâmetros
waitTime long: o tempo máximo em ms para aguardar

Retorna
boolean true se o dispositivo ficar indisponível

waitForDeviceOnline

public abstract IDevice waitForDeviceOnline ()

Aguarde que o dispositivo fique on-line usando o tempo limite de inicialização padrão.

Observação: esse método será retornado quando o dispositivo estiver visível pelo DDMS. Isso não garante que o dispositivo responda aos comandos adb. Use waitForDeviceAvailable() em vez disso.

Retorna
IDevice o IDevice se o dispositivo ficar on-line antes do vencimento do prazo. null caso contrário.

waitForDeviceOnline

public abstract IDevice waitForDeviceOnline (long time)

Aguarde até que o dispositivo fique on-line.

Observação: esse método será retornado quando o dispositivo estiver visível pelo DDMS. Isso não garante que o dispositivo responda aos comandos adb. Use waitForDeviceAvailable() em vez disso.

Parâmetros
time long: o tempo máximo em ms para aguardar

Retorna
IDevice o IDevice se o dispositivo ficar on-line antes do vencimento do prazo. null caso contrário.

waitForDeviceShell

public abstract boolean waitForDeviceShell (long waitTime)

Aguarde até que o dispositivo responda a um comando básico do shell adb.

Parâmetros
waitTime long: o tempo em ms para aguardar

Retorna
boolean true se o dispositivo responder antes do fim de waitTime.