IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager

Subclasses indiretas conhecidas Gerenciador de Dispositivos Gerenciador de Dispositivos

---

Interface para gerenciamento do conjunto de dispositivos disponíveis para teste.

Resumo

Classes aninhadas
interface	IDeviceManager.IFastbootListener Um ouvinte para alterações de estado do fastboot.

Métodos públicos
abstract void	addDeviceMonitor ( IDeviceMonitor mon) Adiciona um IDeviceMonitor
abstract void	addFastbootListener ( IDeviceManager.IFastbootListener listener) Informa ao gerente que um ouvinte está interessado em alterações 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 teste 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 () Solicite um dispositivo físico para teste
abstract ITestDevice	connectToTcpDevice (String ipAndPort) Conecte-se a um dispositivo com adb-over-tcp Este método aloca um novo dispositivo, que eventualmente deve ser liberado via disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) O ITestDevice retornado estará online, mas pode não responder.
abstract boolean	disconnectFromTcpDevice ( ITestDevice tcpDevice) Desconecte-se de um dispositivo conectado por adb-over-tcp.
abstract void	displayDevicesInfo (PrintWriter printWriter, boolean includeStub) Produza uma descrição amigável contendo uma lista de dispositivos conhecidos, seu estado e valores para opções IDeviceSelection comumente usadas.
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) Alocar rudemente um dispositivo, mesmo que ele não esteja disponível no momento.
abstract void	freeDevice ( ITestDevice device, FreeDeviceState state) Devolva um dispositivo ao pool As tentativas de devolver 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 () Obtenha a versão do adb atualmente em uso pelo gerenciador de dispositivos.
abstract DeviceDescriptor	getDeviceDescriptor (String serial) Retorna o DeviceDescriptor com o serial fornecido.
abstract String	getFastbootPath () Retorna o caminho para o binário fastboot a ser usado.
abstract void	init ( IDeviceSelection globalDeviceFilter, deviceMonitors) 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) Determine se determinada série 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 determinada série representa um dispositivo nulo
abstract void	killEmulator ( ITestDevice device) Desligue o emulador fornecido.
abstract void	launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) 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 fornecido para o modo adb-over-tcp e, em seguida, se conecta a ele por meio de connectToTcpDevice(String) .
abstract void	removeDeviceMonitor ( IDeviceMonitor mon) Remove um IDeviceMonitor adicionado anteriormente.
abstract void	removeFastbootListener ( IDeviceManager.IFastbootListener listener) Informa ao gerente que um ouvinte não está mais interessado em alterações de estado do fastboot.
abstract void	restartAdbBridge () Reinicie (se stopAdbBridge() foi chamado) a ponte adb e os serviços dependem de conexões adb.
abstract void	stopAdbBridge () Pare a ponte adb e os serviços dependem das conexões adb.
abstract void	terminate () Interrompe os serviços de monitoramento de dispositivos e encerra a biblioteca ddm.
abstract void	terminateDeviceMonitor () Pare os monitores do dispositivo.
abstract void	terminateDeviceRecovery () Interrompe o thread de recuperação do dispositivo.
default void	terminateHard (String reason) Como terminateHard() .
abstract void	terminateHard () Como terminate() , mas também tenta desligar o adb à força.
abstract boolean	waitForFirstDeviceAdded (long timeout) Aguarde até que um primeiro dispositivo físico esteja 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 gerente que um ouvinte está interessado em alterações de estado do fastboot.

Atualmente, um IDeviceManager só monitorará dispositivos em fastboot se houver um ou mais ouvintes ativos.

TODO: isso é um pouco complicado - 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.

alocarDispositivo

public abstract ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

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

Devoluções
ITestDevice	um ITestDevice para teste ou null se não estiver disponível

alocarDispositivo

public abstract ITestDevice allocateDevice (IDeviceSelection options)

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

Parâmetros
options	IDeviceSelection : o IDeviceSelection o dispositivo deve atender.

Devoluções
ITestDevice	um ITestDevice para teste ou null se não estiver disponível

alocarDispositivo

public abstract ITestDevice allocateDevice ()

Solicite um dispositivo físico para teste

Devoluções
ITestDevice	um ITestDevice para teste ou null se não estiver disponível

conectarToTcpDevice

public abstract ITestDevice connectToTcpDevice (String ipAndPort)

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

Este método aloca um novo dispositivo, que eventualmente deve ser liberado via disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

O ITestDevice retornado estará online, mas pode não responder.

Observe que executar ações como reinicializar um dispositivo conectado por TCP interromperá a conexão TCP com o dispositivo e resultará em uma DeviceNotAvailableException

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

Devoluções
ITestDevice	o ITestDevice ou null se uma conexão TCP não puder ser formada

desconectarFromTcpDevice

public abstract boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

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

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

Parâmetros
tcpDevice	ITestDevice : o dispositivo atualmente em modo tcp, previamente alocado via connectToTcpDevice(String)

Devoluções
boolean	true se a mudança para o modo USB foi bem-sucedida

displayDevicesInfo

public abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

Produza uma descrição amigável contendo uma lista de dispositivos conhecidos, seu estado e valores para opções IDeviceSelection comumente usadas.

Parâmetros
printWriter	PrintWriter : o ERROR(/PrintWriter) para gerar a descrição para
includeStub	boolean : se também deve ou não exibir 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 serial do dispositivo.
command	String : O comando shell.
timeout	long : a quantidade de tempo para o comando ser concluído.
timeUnit	TimeUnit : A unidade para o tempo limite.

Devoluções
CommandResult	Um CommandResult .

forceAllocateDevice

public abstract ITestDevice forceAllocateDevice (String serial)

Alocar rudemente um dispositivo, 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 serial do dispositivo a ser alocado

Devoluções
ITestDevice	o ITestDevice ou null se não puder ser alocado

dispositivo grátis

public abstract void freeDevice (ITestDevice device, 
                FreeDeviceState state)

Devolva um dispositivo ao pool

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

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

getAdbPath

public abstract String getAdbPath ()

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

Devoluções
String

getAdbVersion

public abstract String getAdbVersion ()

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

Devoluções
String

getDeviceDescriptor

public abstract DeviceDescriptor getDeviceDescriptor (String serial)

Retorna o DeviceDescriptor com o serial fornecido.

Parâmetros
serial	String : número de série do dispositivo a ser obtido

Devoluções
DeviceDescriptor	o DeviceDescriptor do dispositivo selecionado ou nulo se o serial não corresponder a um dispositivo conhecido.

getFastbootPath

public abstract String getFastbootPath ()

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

Devoluções
String

iniciar

public abstract void init (IDeviceSelection globalDeviceFilter, 
                 deviceMonitors)

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

Parâmetros
globalDeviceFilter	IDeviceSelection : o filtro do dispositivo
deviceMonitors

iniciar

public abstract void init ()

Inicialize o gerenciador de dispositivos. Isso deve ser chamado uma vez e apenas uma vez antes de qualquer outro método ser chamado.

isEmulador

public abstract boolean isEmulator (String serial)

Determine se determinada série representa um emulador

Parâmetros
serial	String

Devoluções
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

Devoluções
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

Determinar se determinada série representa um dispositivo nulo

Parâmetros
serial	String

Devoluções
boolean

matarEmulador

public abstract void killEmulator (ITestDevice device)

Desligue o emulador fornecido.

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 para desligar

Lança
DeviceNotAvailableException	se o emulador falhar ao desligar

lançamentoEmulador

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

Método auxiliar para iniciar o emulador.

Irá iniciar o emulador conforme especificado pelo chamador

Parâmetros
device	ITestDevice : o espaço reservado ITestDevice que representa o dispositivo emulador alocado
bootTimeout	long : o tempo em ms para esperar o emulador inicializar
emulatorArgs	: argumentos de linha de comando para iniciar o emulador

Lança
DeviceNotAvailableException	se o emulador falhar ao inicializar ou ficar online

listar todos os dispositivos

public abstract  listAllDevices (boolean shortDescriptor)

Retorna uma lista de DeviceDescriptors para todos os dispositivos conhecidos

Parâmetros
shortDescriptor	boolean : se deve limitar os descritores a informações mínimas

Devoluções
	uma lista de DeviceDescriptor para todos os dispositivos conhecidos

listar todos os dispositivos

public abstract  listAllDevices ()

Retorna uma lista de DeviceDescriptors para todos os dispositivos conhecidos

Devoluções
	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, em seguida, se conecta a ele por meio de connectToTcpDevice(String) .

Parâmetros
usbDevice	ITestDevice : o dispositivo atualmente em modo USB

Devoluções
ITestDevice	o ITestDevice recém-alocado no modo tcp ou null se uma conexão tcp não puder ser formada

Lança
DeviceNotAvailableException	se a conexão com usbDevice foi perdida e não pôde ser recuperada

removerDeviceMonitor

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

removerFastbootListener

public abstract void removeFastbootListener (IDeviceManager.IFastbootListener listener)

Informa ao gerente que um ouvinte não está mais interessado em alterações de estado do fastboot.

reiniciarAdbBridge

public abstract void restartAdbBridge ()

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

pararAdbBridge

public abstract void stopAdbBridge ()

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

encerrar

public abstract void terminate ()

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

Isso deve ser chamado no encerramento do aplicativo.

Veja também:

• AndroidDebugBridge.terminate()

terminarDeviceMonitor

public abstract void terminateDeviceMonitor ()

Pare os monitores do dispositivo.

terminarDeviceRecovery

public abstract void terminateDeviceRecovery ()

Interrompe o thread de recuperação do dispositivo.

terminarHard

public void terminateHard (String reason)

Como terminateHard() .

Parâmetros
reason	String : motivo opcional fornecido para o encerramento.

terminarHard

public abstract void terminateHard ()

Como terminate() , mas também tenta desligar o adb à força.

waitForFirstDeviceAdded

public abstract boolean waitForFirstDeviceAdded (long timeout)

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

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

Devoluções
boolean