IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Interface para gerenciar o conjunto de dispositivos disponíveis para teste.

Resumo

Classes aninhadas

interface IDeviceManager.IFastbootListener

Um listener para mudanças de estado do fastboot. 

Métodos públicos

abstract void addDeviceMonitor(IDeviceMonitor mon)

Adiciona um IDeviceMonitor

abstract void addFastbootListener(IDeviceManager.IFastbootListener listener)

Informa ao gerenciador que um listener tem interesse em mudanças de estado de inicialização rápida.

abstract void addMonitoringTcpFastbootDevice(String serial, String fastboot_serial)

Adicionar um dispositivo ao monitor de inicialização rápida.

abstract ITestDevice allocateDevice(IDeviceSelection options, boolean isTemporary)

Solicitar um dispositivo para teste que atenda a determinados critérios.

abstract ITestDevice allocateDevice(IDeviceSelection options)

Solicitar um dispositivo para teste que atenda a determinados critérios.

abstract ITestDevice allocateDevice()

Solicitar um dispositivo físico para testes

abstract ITestDevice connectToTcpDevice(String ipAndPort)

Conectar a um dispositivo com adb-over-tcp

Esse método aloca um novo dispositivo, que precisa ser liberado por disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice).

O ITestDevice retornado vai estar on-line, mas talvez não seja responsivo.

abstract boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

Desconecte de um dispositivo conectado a adb-over-tcp.

abstract void displayDevicesInfo(PrintWriter printWriter, boolean includeStub)

Gera uma descrição fácil de usar com uma lista de dispositivos conhecidos, o estado deles e os valores das opções IDeviceSelection mais usadas.

abstract CommandResult executeCmdOnAvailableDevice(String serial, String command, long timeout, TimeUnit timeUnit)

Um método auxiliar para executar o comando do shell no dispositivo disponível.

abstract ITestDevice forceAllocateDevice(String serial)

Atribuir um dispositivo de forma rude, mesmo que ele não esteja disponível no momento.

abstract void freeDevice(ITestDevice device, FreeDeviceState state)

Devolver um dispositivo ao pool

As tentativas de devolver um dispositivo que não foi alocado anteriormente serão ignoradas.

abstract String getAdbPath()

Retorna o caminho para o binário adb a ser usado.

abstract String getAdbVersion()

Receba a versão do adb atualmente em uso pelo gerenciador de dispositivos.

abstract DeviceDescriptor getDeviceDescriptor(String serial)

Retorna o DeviceDescriptor com o número de série fornecido.

abstract String getFastbootPath()

Retorna o caminho para o binário do fastboot a ser usado.

abstract void init(IDeviceSelection globalDeviceFilter, deviceMonitors)

Inicializar o gerenciador de dispositivos com um filtro de dispositivo.

abstract void init()

Inicializar o gerenciador de dispositivos.

abstract boolean isEmulator(String serial)

Determinar se o número de série fornecido representa um emulador

default boolean isFileSystemMountCheckEnabled()

Retorna se devemos ou não verificar em NativeDeviceStateMonitor se o sistema de arquivos está montado corretamente.

abstract boolean isNullDevice(String serial)

Determinar se o número de série fornecido representa um dispositivo nulo

abstract void killEmulator(ITestDevice device)

Encerra o emulador.

abstract void launchEmulator(ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs)

Método auxiliar para iniciar o emulador.

abstract listAllDevices(boolean shortDescriptor)

Retorna uma lista de DeviceDescriptors para todos os dispositivos conhecidos.

abstract listAllDevices()

Retorna uma lista de DeviceDescriptors para todos os dispositivos conhecidos.

abstract ITestDevice reconnectDeviceToTcp(ITestDevice usbDevice)

Um método auxiliar que muda o dispositivo USB especificado para o modo adb-over-tcp e se conecta a ele por connectToTcpDevice(String).

abstract void removeDeviceMonitor(IDeviceMonitor mon)

Remove um IDeviceMonitor adicionado anteriormente.

abstract void removeFastbootListener(IDeviceManager.IFastbootListener listener)

Informa ao gerenciador que um listener não está mais interessado em mudanças de estado de inicialização rápida.

abstract void restartAdbBridge()

Reinicie (se stopAdbBridge() foi chamado) a ponte adb e os serviços dependem de conexões adb.

abstract void stopAdbBridge()

A ponte adb e os serviços dependem das conexões adb.

abstract void terminate()

Interrompe os serviços de monitoramento do dispositivo e encerra a biblioteca ddm.

abstract void terminateDeviceMonitor()

Pare os monitores de dispositivo.

abstract void terminateDeviceRecovery()

Para a linha de execução de recuperação do dispositivo.

default void terminateHard(String reason)

Como terminateHard().

abstract void terminateHard()

Como terminate(), mas tenta encerrar o adb à força.

abstract boolean waitForFirstDeviceAdded(long timeout)

Aguarde até que o primeiro dispositivo físico seja conectado.

Métodos públicos

addDeviceMonitor

public abstract void addDeviceMonitor (IDeviceMonitor mon)

Adiciona um IDeviceMonitor

Parâmetros
mon IDeviceMonitor

addFastbootListener

public abstract void addFastbootListener (IDeviceManager.IFastbootListener listener)

Informa ao gerenciador que um listener tem interesse em mudanças de estado de inicialização rápida.

No momento, um IDeviceManager só monitora dispositivos em inicialização rápida se houver um ou mais listeners ativos.

TODO: isso é um pouco de hack, encontre uma solução melhor

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Adicionar um dispositivo ao monitor de inicialização rápida. O monitor fastboot vai usar "fastboot_serial" para se comunicar com o dispositivo.

Parâmetros
serial String: o número de série do dispositivo.
fastboot_serial String: o número de série do modo de inicialização rápida do dispositivo.

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Solicitar um dispositivo para teste que atenda a determinados critérios.

Parâmetros
options IDeviceSelection: o IDeviceSelection que o dispositivo precisa atender.
isTemporary boolean: especifica se um NullDevice temporário precisa ser criado.
Retorna
ITestDevice um ITestDevice para testes ou null se não houver um disponível

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options)

Solicitar um dispositivo para teste que atenda a determinados critérios.

Parâmetros
options IDeviceSelection: o IDeviceSelection que o dispositivo precisa atender.
Retorna
ITestDevice um ITestDevice para testes ou null se não estiver disponível

allocateDevice

public abstract ITestDevice allocateDevice ()

Solicitar um dispositivo físico para testes

Retorna
ITestDevice um ITestDevice para testes ou null se não houver um disponível

connectToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

Conectar a um dispositivo com adb-over-tcp

Esse método aloca um novo dispositivo, que precisa ser liberado por disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice).

O ITestDevice retornado vai estar on-line, mas talvez não seja responsivo.

A realização de ações, como uma reinicialização em um dispositivo conectado por TCP, vai interromper a conexão TCP com o dispositivo e resultar em um DeviceNotAvailableException.

Parâmetros
ipAndPort String: o endereço IP original e a porta do dispositivo a que se conectar
Retorna
ITestDevice o ITestDevice ou null se uma conexão TCP não puder ser formada

disconnectFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Desconecte de um dispositivo conectado a adb-over-tcp.

Muda o dispositivo de volta para o modo USB e o libera.

Parâmetros
tcpDevice ITestDevice: o dispositivo atualmente no modo TCP, alocado anteriormente por connectToTcpDevice(String)
Retorna
boolean true se a mudança para o modo USB foi bem-sucedida

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

Gera uma descrição fácil de usar com uma lista de dispositivos conhecidos, o estado deles e os valores das opções IDeviceSelection mais usadas.

Parâmetros
printWriter PrintWriter: o ERROR(/PrintWriter) para gerar a descrição
includeStub boolean: se os dispositivos stub também serão mostrados.

executeCmdOnAvailableDevice

public abstract CommandResult executeCmdOnAvailableDevice (String serial, 
                String command, 
                long timeout, 
                TimeUnit timeUnit)

Um método auxiliar para executar o comando do shell no dispositivo disponível.

Parâmetros
serial String: o número de série do dispositivo.
command String: o comando do shell.
timeout long: o tempo necessário para a conclusão do comando.
timeUnit TimeUnit: a unidade do tempo limite.
Retorna
CommandResult CommandResult.

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

Atribuir um dispositivo de forma rude, mesmo que ele não esteja disponível no momento.

Não terá efeito se o dispositivo já estiver alocado.

Parâmetros
serial String: o número de série do dispositivo a ser alocado
Retorna
ITestDevice o ITestDevice ou null se não puder ser alocado

freeDevice

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

Devolver um dispositivo ao pool

As tentativas de devolver um dispositivo que não foi alocado anteriormente serão ignoradas.

Parâmetros
device ITestDevice: o ITestDevice para liberar
state FreeDeviceState: o FreeDeviceState. Usado para controlar se o dispositivo é retornado ao pool de dispositivos disponível.

getAdbPath

public abstract String getAdbPath ()

Retorna o caminho para o binário adb a ser usado.

Retorna
String

getAdbVersion

public abstract String getAdbVersion ()

Receba a versão do adb atualmente em uso pelo gerenciador de dispositivos.

Retorna
String

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

Retorna o DeviceDescriptor com o número de série fornecido.

Parâmetros
serial String: número de série do dispositivo a ser recebido
Retorna
DeviceDescriptor o DeviceDescriptor do dispositivo selecionado ou nulo se o número de série não corresponder a um dispositivo conhecido.

getFastbootPath

public abstract String getFastbootPath ()

Retorna o caminho para o binário do fastboot a ser usado.

Retorna
String

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Inicializar o gerenciador de dispositivos com um filtro de dispositivo. Esse filtro pode ser usado para instruir o DeviceManager a ignorar determinados dispositivos conectados.

Parâmetros
globalDeviceFilter IDeviceSelection: o filtro do dispositivo
deviceMonitors

init

public abstract void init ()

Inicializar o gerenciador de dispositivos. Ele precisa ser chamado uma vez e apenas uma vez antes que outros métodos sejam chamados.

isEmulator

public abstract boolean isEmulator (String serial)

Determinar se o número de série fornecido representa um emulador

Parâmetros
serial String

Retorna
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

Retorna se devemos ou não verificar em NativeDeviceStateMonitor se o sistema de arquivos está montado corretamente.

Retorna
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

Determinar se o número de série fornecido representa um dispositivo nulo

Parâmetros
serial String

Retorna
boolean

killEmulator

public abstract void killEmulator (ITestDevice device)

Encerra o emulador.

Bloqueia até que o emulador desapareça do adb. Não terá efeito se o emulador já não estiver disponível.

Parâmetros
device ITestDevice: o ITestDevice que representa o emulador a ser encerrado
Gera
DeviceNotAvailableException Se o emulador não for encerrado

launchEmulator

public abstract void launchEmulator (ITestDevice device, 
                long bootTimeout, 
                IRunUtil runUtil, 
                 emulatorArgs)

Método auxiliar para iniciar o emulador.

Inicia o emulador conforme especificado pelo autor da chamada.

Parâmetros
device ITestDevice: o marcador de posição ITestDevice que representa o dispositivo do emulador alocado
bootTimeout long: o tempo em ms para aguardar a inicialização do emulador
emulatorArgs : argumentos da linha de comando para iniciar o emulador
Gera
DeviceNotAvailableException Se o emulador não inicializar ou não entrar on-line

listAllDevices

public abstract  listAllDevices (boolean shortDescriptor)

Retorna uma lista de DeviceDescriptors para todos os dispositivos conhecidos.

Parâmetros
shortDescriptor boolean: se os descritores devem ser limitados a informações mínimas
Retorna
uma lista de DeviceDescriptor para todos os dispositivos conhecidos

listAllDevices

public abstract  listAllDevices ()

Retorna uma lista de DeviceDescriptors para todos os dispositivos conhecidos.

Retorna
uma lista de DeviceDescriptor para todos os dispositivos conhecidos

reconnectDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Um método auxiliar que muda o dispositivo USB especificado para o modo adb-over-tcp e se conecta a ele por connectToTcpDevice(String).

Parâmetros
usbDevice ITestDevice: o dispositivo está no modo USB
Retorna
ITestDevice o ITestDevice recém-alocado no modo TCP ou null, se não foi possível formar uma conexão TCP
Gera
DeviceNotAvailableException se a conexão com usbDevice foi perdida e não pôde ser recuperada

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

Remove um IDeviceMonitor adicionado anteriormente. Não tem efeito se mon não tiver sido adicionado.

Parâmetros
mon IDeviceMonitor

removeFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Informa ao gerenciador que um listener não está mais interessado em mudanças de estado de inicialização rápida.

restartAdbBridge

public abstract void restartAdbBridge ()

Reinicie (se stopAdbBridge() foi chamado) a ponte adb e os serviços dependem de conexões adb.

stopAdbBridge

public abstract void stopAdbBridge ()

A ponte adb e os serviços dependem das conexões adb.

encerrar

public abstract void terminate ()

Interrompe os serviços de monitoramento do dispositivo e encerra a biblioteca ddm.

Ele precisa ser chamado após o encerramento do aplicativo.

terminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

Pare os monitores de dispositivo.

terminateDeviceRecovery

public abstract void terminateDeviceRecovery ()

Para a linha de execução de recuperação do dispositivo.

terminateHard

public void terminateHard (String reason)

Como terminateHard().

Parâmetros
reason String: motivo opcional fornecido para a rescisão.

terminateHard

public abstract void terminateHard ()

Como terminate(), mas tenta encerrar o adb à força.

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

Aguarde até que o primeiro dispositivo físico seja conectado. Se um dispositivo já estava conectado, ele vai retornar diretamente "True". Se nenhum dispositivo for adicionado, o método retornará "false" após o tempo limite.

Parâmetros
timeout long: tempo de espera em milissegundos antes de retornar falso.
Retorna
boolean