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 em modo Fastboot.

Campos

public static final String UNKNOWN_DISPLAY_STRING

Exibir string 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 alterações de estado do fastboot.

void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

Adicione um dispositivo ao monitor fastboot.

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 eventualmente deve ser liberado via disconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)

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

boolean disconnectFromTcpDevice ( ITestDevice tcpDevice)

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

void displayDevicesInfo (PrintWriter stream, boolean includeStub)

Produza uma descrição amigável contendo uma lista de dispositivos conhecidos, seu estado e valores para opções 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)

Alocar rudemente um dispositivo, mesmo que ele não esteja disponível no momento.

void freeDevice ( ITestDevice device, FreeDeviceState deviceState)

Devolva um dispositivo ao pool

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

String getAdbPath ()

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

String getAdbVersion ()

Obtenha a versão do 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 fastboot 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 determinada série representa um emulador

boolean isFileSystemMountCheckEnabled ()

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

boolean isNullDevice (String serial)

Determinar se determinada série 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, se conecta 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 alterações de estado do fastboot.

void restartAdbBridge ()

Reinicie (se stopAdbBridge() foi chamado) a ponte adb e os 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 do dispositivo.

void terminateDeviceRecovery ()

Interrompe 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 esteja conectado.

Campos

UNKNOWN_DISPLAY_STRING

public static final String UNKNOWN_DISPLAY_STRING

Exibir string 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

adicionarFastbootDevice

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 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 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 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 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 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 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 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 void displayDevicesInfo (PrintWriter stream, 
                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
stream PrintWriter : o ERROR(/PrintWriter) para gerar a descrição para

includeStub boolean : se também deve ou não exibir dispositivos stub.

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 nulo caso contrário.

forceAllocateDevice

public 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 void freeDevice (ITestDevice device, 
                FreeDeviceState deviceState)

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

deviceState FreeDeviceState : o FreeDeviceState . Usado para controlar se o dispositivo retorna 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 do 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 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 String getFastbootPath ()

Retorna o caminho para o binário fastboot 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.

isEmulador

public 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 boolean isNullDevice (String serial)

Determinar se determinada série representa um dispositivo nulo

Parâmetros
serial String

Devoluções
boolean

matarEmulador

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

Lança
DeviceNotAvailableException

lançamentoEmulador

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

listar todos os dispositivos

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

listar todos os dispositivos

public  listAllDevices ()

Retorna uma lista de DeviceDescriptors para todos os dispositivos conhecidos

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

reconectarDeviceToTcp

public 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

removerDeviceMonitor

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

removerFastbootListener

public 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 void restartAdbBridge ()

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

pararAdbBridge

public void stopAdbBridge ()

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

terminar

public void terminate ()

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

Isso deve ser chamado no encerramento do aplicativo.

terminarDeviceMonitor

public void terminateDeviceMonitor ()

Pare os monitores do dispositivo.

terminarDeviceRecovery

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