Gerenciador de Dispositivos

public class DeviceManager
extends Object implements IDeviceManager

java.lang.Object
↳	com.android.tradefed.device.DeviceManager

---

Resumo

Classes aninhadas
class	DeviceManager.FastbootDevice Representação de um dispositivo no modo Fastboot.

Campos
public static final String	UNKNOWN_DISPLAY_STRING String de exibição para propriedades desconhecidas
protected DeviceMonitorMultiplexer	mDvcMon
protected boolean	mFastbootEnabled

Construtores públicos
DeviceManager () O DeviceManager deve ser recuperado do GlobalConfiguration

Métodos públicos
void	addAvailableDevice (IDevice stubDevice)
void	addDeviceMonitor ( IDeviceMonitor mon) Adiciona um IDeviceMonitor
void	addFastbootDevice ( DeviceManager.FastbootDevice fastbootDevice)
void	addFastbootListener ( IDeviceManager.IFastbootListener listener) Informa ao gerente que um ouvinte está interessado em mudanças de estado de inicialização rápida.
void	addMonitoringTcpFastbootDevice (String serial, String fastboot_serial) Adicione um dispositivo ao monitor de inicialização rápida.
ITestDevice	allocateDevice ( IDeviceSelection options, boolean isTemporary) Solicite um dispositivo para teste que atenda a determinados critérios.
ITestDevice	allocateDevice ( IDeviceSelection options) Solicite um dispositivo para teste que atenda a determinados critérios.
ITestDevice	allocateDevice () Solicite um dispositivo físico para teste
ITestDevice	connectToTcpDevice (String ipAndPort) Conecte-se a um dispositivo com adb-over-tcp Este método aloca um novo dispositivo, que deve eventualmente ser liberado por meio disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) O ITestDevice retornado estará online, mas pode não ser responsivo.
boolean	disconnectFromTcpDevice ( ITestDevice tcpDevice) Desconecte-se de um dispositivo conectado adb-over-tcp.
void	displayDevicesInfo (PrintWriter stream, boolean includeStub) Emita uma descrição amigável contendo uma lista de dispositivos conhecidos, seu estado e valores para as opções de IDeviceSelection comumente usadas.
CommandResult	executeCmdOnAvailableDevice (String serial, String command, long timeout, TimeUnit timeUnit) Um método auxiliar para executar o comando shell no dispositivo disponível.
String	executeGlobalAdbCommand (String... cmdArgs) Execute um comando adb não direcionado a um dispositivo específico, por exemplo.
ITestDevice	forceAllocateDevice (String serial) Aloque grosseiramente um dispositivo, mesmo que não esteja disponível no momento.
void	freeDevice ( ITestDevice device, FreeDeviceState deviceState) Devolver um dispositivo ao pool As tentativas de devolver um dispositivo que não foi alocado anteriormente serão ignoradas.
String	getAdbPath () Retorna o caminho para o binário adb a ser usado.
String	getAdbVersion () Obtenha a versão adb atualmente em uso pelo gerenciador de dispositivos.
DeviceDescriptor	getDeviceDescriptor (String serial) Retorna o DeviceDescriptor com o serial fornecido.
String	getFastbootPath () Retorna o caminho para o binário de inicialização rápida a ser usado.
void	init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory) Inicialize o gerenciador de dispositivos.
void	init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) init ( IDeviceSelection globalDeviceFilter, globalDeviceMonitors) Inicialize o gerenciador de dispositivos.
void	init () Inicialize o gerenciador de dispositivos.
boolean	isEmulator (String serial) Determine se determinado serial representa um emulador
boolean	isFileSystemMountCheckEnabled () Retorna se devemos ou não verificar em NativeDeviceStateMonitor o sistema de arquivos está montado corretamente.
boolean	isNullDevice (String serial) Determine se determinado serial representa um dispositivo nulo
void	killEmulator ( ITestDevice device) Desligue o emulador fornecido.
void	launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) launchEmulator ( ITestDevice device, long bootTimeout, IRunUtil runUtil, emulatorArgs) Método auxiliar para iniciar o emulador.
	listAllDevices (boolean shortDescriptor) Retorna uma lista de DeviceDescriptors para todos os dispositivos conhecidos
	listAllDevices () Retorna uma lista de DeviceDescriptors para todos os dispositivos conhecidos
ITestDevice	reconnectDeviceToTcp ( ITestDevice usbDevice) Um método auxiliar que alterna o dispositivo usb fornecido para o modo adb-over-tcp e, em seguida, conecta-se a ele por meio de connectToTcpDevice(String) .
void	removeDeviceMonitor ( IDeviceMonitor mon) Remove um IDeviceMonitor adicionado anteriormente.
void	removeFastbootListener ( IDeviceManager.IFastbootListener listener) Informa ao gerente que um ouvinte não está mais interessado em mudanças de estado de inicialização rápida.
void	restartAdbBridge () Reiniciar (se stopAdbBridge() foi chamado) adb bridge e serviços dependem de conexões adb.
void	stopAdbBridge () Pare a ponte adb e os serviços dependem das conexões adb.
void	terminate () Interrompe os serviços de monitoramento de dispositivos e encerra a biblioteca ddm.
void	terminateDeviceMonitor () Pare os monitores de dispositivos.
void	terminateDeviceRecovery () Pára o thread de recuperação do dispositivo.
void	terminateHard (String reason) Como terminateHard() .
void	terminateHard () Como terminate() , mas também tenta desligar o adb à força.
boolean	waitForFirstDeviceAdded (long timeout) Aguarde até que um primeiro dispositivo físico seja conectado.

Campos

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

String de exibição para propriedades desconhecidas

mDvcMon

protected DeviceMonitorMultiplexer mDvcMon

mFastbootEnabled

protected boolean mFastbootEnabled

Construtores públicos

Gerenciador de Dispositivos

public DeviceManager ()

O DeviceManager deve ser recuperado do GlobalConfiguration

Métodos públicos

addAvailableDevice

public void addAvailableDevice (IDevice stubDevice)

Parâmetros
stubDevice	IDevice

addDeviceMonitor

public void addDeviceMonitor (IDeviceMonitor mon)

Adiciona um IDeviceMonitor

Parâmetros
mon	IDeviceMonitor

addFastbootDevice

public void addFastbootDevice (DeviceManager.FastbootDevice fastbootDevice)

Parâmetros
fastbootDevice	DeviceManager.FastbootDevice

addFastbootListener

public void addFastbootListener (IDeviceManager.IFastbootListener listener)

Informa ao gerente que um ouvinte está interessado em mudanças de estado de inicialização rápida.

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

TODO: isso é meio que um hack - encontre uma solução melhor

addMonitoringTcpFastbootDevice

public void addMonitoringTcpFastbootDevice (String serial, 
                String fastboot_serial)

Adicione um dispositivo ao monitor de inicialização rápida. 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.

alocar dispositivo

public ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

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

Parâmetros
options	IDeviceSelection : o IDeviceSelection que 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 houver um disponível

alocar dispositivo

public ITestDevice allocateDevice (IDeviceSelection options)

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

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

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

alocar dispositivo

public ITestDevice allocateDevice ()

Solicite um dispositivo físico para teste

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

connectToTcpDevice

public ITestDevice connectToTcpDevice (String ipAndPort)

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

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

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

Observe que a execução de ações como reinicialização em um dispositivo conectado a tcp cortará 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

devoluções
ITestDevice	o ITestDevice ou null se uma conexão tcp não puder ser formada

desconectarDoTcpDevice

public boolean disconnectFromTcpDevice (ITestDevice tcpDevice)

Desconecte-se de um dispositivo conectado 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, previamente alocado via connectToTcpDevice(String)

devoluções
boolean	true se a mudança para o modo usb foi bem-sucedida

displayDevicesInfo

public void displayDevicesInfo (PrintWriter stream, 
                boolean includeStub)

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

Parâmetros
stream	PrintWriter : o ERROR(/PrintWriter) para enviar a descrição para
includeStub	boolean : Se deve ou não exibir dispositivos stub também.

executeCmdOnAvailableDevice

public 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 .

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Execute um comando adb não direcionado a um dispositivo específico, por exemplo. 'adb conectar'

devoluções
String	saída std se o comando for bem-sucedido, caso contrário.

forceAllocateDevice

public ITestDevice forceAllocateDevice (String serial)

Aloque grosseiramente um dispositivo, mesmo que 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

freeDevice

public void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

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
deviceState	FreeDeviceState : o FreeDeviceState . Usado para controlar se o dispositivo é devolvido ao pool de dispositivos disponíveis.

getAdbPath

public String getAdbPath ()

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

devoluções
String

getAdbVersion

public String getAdbVersion ()

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

devoluções
String

getDeviceDescriptor

public DeviceDescriptor getDeviceDescriptor (String serial)

Retorna o DeviceDescriptor com o serial fornecido.

Parâmetros
serial	String : número de série para o dispositivo obter

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

getFastbootPath

public String getFastbootPath ()

Retorna o caminho para o binário de inicialização rápida a ser usado.

devoluções
String

iniciar

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors, 
                IManagedTestDeviceFactory deviceFactory)

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

Parâmetros
globalDeviceFilter	IDeviceSelection
globalDeviceMonitors
deviceFactory	IManagedTestDeviceFactory

iniciar

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

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

Parâmetros
globalDeviceFilter	IDeviceSelection : o filtro do dispositivo
globalDeviceMonitors

iniciar

public 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.

isEmulator

public boolean isEmulator (String serial)

Determine se determinado serial representa um emulador

Parâmetros
serial	String

devoluções
boolean

isFileSystemMountCheckEnabled

public boolean isFileSystemMountCheckEnabled ()

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

devoluções
boolean

isNullDevice

public boolean isNullDevice (String serial)

Determine se determinado serial representa um dispositivo nulo

Parâmetros
serial	String

devoluções
boolean

killEmulator

public 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 representa o emulador para desligar

lances
DeviceNotAvailableException

lançarEmulador

public 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 representando 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

lances
DeviceNotAvailableException

listAllDevices

public  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

listAllDevices

public  listAllDevices ()

Retorna uma lista de DeviceDescriptors para todos os dispositivos conhecidos

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

reconnectDeviceToTcp

public ITestDevice reconnectDeviceToTcp (ITestDevice usbDevice)

Um método auxiliar que alterna o dispositivo usb fornecido para o modo adb-over-tcp e, em seguida, conecta-se a ele por meio de connectToTcpDevice(String) .

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

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

lances
DeviceNotAvailableException

removeDeviceMonitor

public 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 void removeFastbootListener (IDeviceManager.IFastbootListener listener)

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

reiniciarAdbBridge

public void restartAdbBridge ()

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

stopAdbBridge

public void stopAdbBridge ()

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

encerrar

public void terminate ()

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

Isso deve ser chamado no encerramento do aplicativo.

TerminateDeviceMonitor

public void terminateDeviceMonitor ()

Pare os monitores de dispositivos.

terminaDeviceRecovery

public void terminateDeviceRecovery ()

Pára o thread de recuperação do dispositivo.

TerminateHard

public void terminateHard (String reason)

Como terminateHard() .

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

TerminateHard

public void terminateHard ()

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

waitForFirstDeviceAdded

public boolean waitForFirstDeviceAdded (long timeout)

Aguarde até que um primeiro dispositivo físico seja 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 false.

devoluções
boolean