Gerenciador de dispositivos

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Subclasses indiretas conhecidas DeviceManager (link em inglês) DeviceManager (link em inglês)

---

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

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 está interessado em mudanças de estado do fastboot.
abstract void	addMonitoringTcpFastbootDevice(String serial, String fastboot_serial) Adicione um dispositivo ao monitor fastboot.
abstract ITestDevice	allocateDevice(IDeviceSelection options, boolean isTemporary) Solicite um dispositivo para testes que atenda a determinados critérios.
abstract ITestDevice	allocateDevice(IDeviceSelection options) Solicite 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-se a um dispositivo com adb-over-tcp Esse método aloca um novo dispositivo, que acabará sendo liberado via disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) A ITestDevice retornada vai ficar on-line, mas talvez não seja responsiva.
abstract boolean	disconnectFromTcpDevice(ITestDevice tcpDevice) Desconecte-se de um dispositivo conectado a adb-over-tcp.
abstract void	displayDevicesInfo(PrintWriter printWriter, boolean includeStub) Gerar uma descrição fácil de usar contendo uma lista de dispositivos conhecidos, o estado e os valores deles para as opções de IDeviceSelection usadas com frequência.
abstract CommandResult	executeCmdOnAvailableDevice(String serial, String command, long timeout, TimeUnit timeUnit) Um método auxiliar para executar o comando shell no dispositivo disponível.
abstract ITestDevice	forceAllocateDevice(String serial) Aloque um dispositivo de maneira grosseira, mesmo que ele não esteja disponível no momento.
abstract void	freeDevice(ITestDevice device, FreeDeviceState state) Devolver um dispositivo para o pool As tentativas de retornar um dispositivo que não tenha sido alocado anteriormente serão ignoradas.
abstract String	getAdbPath() Retorna o caminho para o binário adb a ser usado.
abstract String	getAdbVersion() Descubra 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 fastboot a ser usado.
abstract void	init(IDeviceSelection globalDeviceFilter, deviceMonitors) Inicialize o gerenciador de dispositivos com um filtro de dispositivo.
abstract void	init() Inicialize o gerenciador de dispositivos.
abstract boolean	isEmulator(String serial) Determinar se determinado número de série representa um emulador
default boolean	isFileSystemMountCheckEnabled() Retorna se é necessário verificar em NativeDeviceStateMonitor o sistema de arquivos é instalado corretamente.
abstract boolean	isNullDevice(String serial) Determinar se determinado número de série representa um dispositivo nulo
abstract void	killEmulator(ITestDevice device) Encerra o emulador especificado.
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 alterna o dispositivo usb para o modo adb-over-tcp e se conecta ao via 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 do fastboot.
abstract void	restartAdbBridge() Reiniciar (se stopAdbBridge() foi chamado) ponte e serviços do adb dependem do adb conexões de rede.
abstract void	stopAdbBridge() A interrupção da ponte e dos serviços adb dependem das conexões adb.
abstract void	terminate() Interrompe os serviços de monitoramento do dispositivo e encerra a biblioteca ddm.
abstract void	terminateDeviceMonitor() Interrompa os monitores de dispositivos.
abstract void	terminateDeviceRecovery() Interrompe a linha de execução de recuperação do dispositivo.
default void	terminateHard(String reason) Como terminateHard().
abstract void	terminateHard() Como terminate(), mas tenta também forçar o encerramento do adb.
abstract boolean	waitForFirstDeviceAdded(long timeout) Aguarde até que um 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 está interessado em mudanças de estado do fastboot.

No momento, um IDeviceManager só vai monitorar os dispositivos no fastboot se houver ou ouvintes mais ativos.

PENDENTE: isso é um truque - encontre uma solução melhor

addMonitoringTcpFastbootDevice

public abstract void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Adicione um dispositivo ao monitor fastboot. O monitor fastboot 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 fastboot do dispositivo.

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

Parâmetros
options	IDeviceSelection: os IDeviceSelection que o dispositivo precisa atender.
isTemporary	boolean: se um NullDevice temporário precisa ou não ser criado.

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

allocateDevice

public abstract ITestDevice allocateDevice (IDeviceSelection options)

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

Parâmetros
options	IDeviceSelection: os IDeviceSelection que o dispositivo precisa atender.

Retorna
ITestDevice	um ITestDevice para testes, ou null se um não está disponível

allocateDevice

public abstract ITestDevice allocateDevice ()

Solicitar um dispositivo físico para testes

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

conectarToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

Conectar-se a um dispositivo com adb-over-tcp

Esse método aloca um novo dispositivo, que acabará sendo liberado via disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

A ITestDevice retornada vai ficar on-line, mas talvez não seja responsiva.

Observe que realizar uma ação como a reinicialização em um dispositivo conectado ao TCP interrompe a conexão TCP ao dispositivo e resultará em uma DeviceNotAvailableException

Parâmetros
ipAndPort	String: o endereço IP original e a porta do dispositivo ao qual se conectar

Retorna
ITestDevice	a ITestDevice ou a null se não for possível estabelecer uma conexão TCP

desconectarDoTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

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

Coloca o dispositivo de volta no modo usb e o libera.

Parâmetros
tcpDevice	ITestDevice: o dispositivo no modo TCP, anteriormente alocado via connectToTcpDevice(String)

Retorna
boolean	true se a mudança para o modo USB for bem-sucedida

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

Gerar uma descrição fácil de usar contendo uma lista de dispositivos conhecidos, o estado e os valores deles para as opções de IDeviceSelection usadas com frequência.

Parâmetros
printWriter	PrintWriter: o ERROR(/PrintWriter) que vai receber a descrição da saída.
includeStub	boolean: mostra ou não os dispositivos stub.

executeCmdOnAvailableDevice

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

Um método auxiliar para executar o comando 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: a quantidade de tempo para a conclusão do comando.
timeUnit	TimeUnit: a unidade do tempo limite.

Retorna
CommandResult	CommandResult.

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

Aloque um dispositivo de maneira grosseira, 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 ele não puder ser alocado

dispositivo sem custo financeiro

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

Devolver um dispositivo para o pool

As tentativas de retornar um dispositivo que não tenha sido alocado anteriormente serão ignoradas.

Parâmetros
device	ITestDevice: os ITestDevice que serão liberados
state	FreeDeviceState: o FreeDeviceState. Usado para controlar se é 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 ()

Descubra 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: o número de série do dispositivo recebido.

Retorna
DeviceDescriptor	o DeviceDescriptor do dispositivo selecionado, ou nulo, se o número de série não correspondem a um dispositivo conhecido.

getFastbootPath

public abstract String getFastbootPath ()

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

Retorna
String

init

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

Inicialize o gerenciador de dispositivos com um filtro de dispositivo. Esse filtro pode ser usado para instruir o DeviceManager para ignorar certos dispositivos conectados.

Parâmetros
globalDeviceFilter	IDeviceSelection: o filtro de dispositivo
deviceMonitors

init

public abstract void init ()

Inicialize o gerenciador de dispositivos. Deve ser chamado apenas uma vez antes de qualquer outro são chamados.

isEmulator

public abstract boolean isEmulator (String serial)

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

Parâmetros
serial	String

Retorna
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

Retorna se é necessário verificar em NativeDeviceStateMonitor o sistema de arquivos é instalado corretamente.

Retorna
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

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

Parâmetros
serial	String

Retorna
boolean

killEmulator

public abstract void killEmulator (ITestDevice device)

Encerra o emulador especificado.

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

Parâmetros
device	ITestDevice: o ITestDevice que representa o emulador a ser encerrado.

Gera
DeviceNotAvailableException	se o emulador não for encerrado

iniciarEmulator

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 ITestDevice que representa o dispositivo emulador alocado.
bootTimeout	long: o tempo em ms para aguardar a inicialização do emulador.
emulatorArgs	: argumentos de linha de comando para iniciar o emulador.

Gera
DeviceNotAvailableException	se o emulador falhar ao inicializar ou ficar on-line

listAllDevices (listar dispositivos)

public abstract  listAllDevices (boolean shortDescriptor)

Retorna uma lista de DeviceDescriptors para todos os dispositivos conhecidos.

Parâmetros
shortDescriptor	boolean: se os descritores serão limitados a informações mínimas

Retorna
	uma lista de DeviceDescriptor para todos os dispositivos conhecidos

listAllDevices (listar dispositivos)

public abstract  listAllDevices ()

Retorna uma lista de DeviceDescriptors para todos os dispositivos conhecidos.

Retorna
	uma lista de DeviceDescriptor para todos os dispositivos conhecidos

reconectarDeviceToTcp

public abstract ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Um método auxiliar que alterna o dispositivo usb fornecido para o modo adb-over-tcp e se conecta via connectToTcpDevice(String).

Parâmetros
usbDevice	ITestDevice: o dispositivo no modo usb no momento.

Retorna
ITestDevice	o ITestDevice recém-alocado no modo TCP ou null se um TCP Não foi possível estabelecer uma conexão

Gera
DeviceNotAvailableException	se a conexão com usbDevice for perdida e não foi possível recuperar

removeDeviceMonitor

public abstract void removeDeviceMonitor (IDeviceMonitor mon)

Remove um IDeviceMonitor adicionado anteriormente. Não terá efeito se Mon não tiver sido adicionado.

Parâmetros
mon	IDeviceMonitor

removerFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

ReiniciarAdbBridge

public abstract void restartAdbBridge ()

Reiniciar (se stopAdbBridge() foi chamado) ponte e serviços do adb dependem do adb conexões de rede.

stopAdbBridge

public abstract void stopAdbBridge ()

A interrupção da ponte e dos serviços adb dependem das conexões adb.

encerrar

public abstract void terminate ()

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

Precisa ser chamado após o encerramento do aplicativo.

Confira também:

• AndroidDebugBridge.terminate()

encerrarDeviceMonitor

public abstract void terminateDeviceMonitor ()

Interrompa os monitores de dispositivos.

encerrarDeviceRecovery

public abstract void terminateDeviceRecovery ()

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

TerminarHard

public void terminateHard (String reason)

Como terminateHard().

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

TerminarHard

public abstract void terminateHard ()

Como terminate(), mas tenta também forçar o encerramento do adb.

"waitForFirstDeviceAdded"

public abstract boolean waitForFirstDeviceAdded (long timeout)

Aguarde até que um primeiro dispositivo físico seja conectado. Se um dispositivo já foi conectado antes, retorna True diretamente. Se nenhum dispositivo foi adicionado, ele retorna "false" após o tempo limite.

Parâmetros
timeout	long: tempo de espera em milissegundos antes de retornar "false".

Retorna
boolean