DeviceManager

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 (Fastboot mode). 

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 precisa 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 gerenciador que um listener está interessado em mudanças 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 testes que atenda a determinados critérios.

ITestDevice allocateDevice(IDeviceSelection options)

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

ITestDevice allocateDevice()

Solicitar um dispositivo físico para testes

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.

boolean disconnectFromTcpDevice(ITestDevice tcpDevice)

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

void displayDevicesInfo(PrintWriter stream, 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.

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)

Executar um comando adb não direcionado a um dispositivo específico, por exemplo,

ITestDevice forceAllocateDevice(String serial)

Aloque um dispositivo de maneira grosseira, mesmo que ele não esteja disponível no momento.

void freeDevice(ITestDevice device, FreeDeviceState deviceState)

Devolver um dispositivo para o pool

As tentativas de retornar 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()

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

DeviceDescriptor getDeviceDescriptor(String serial)

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

String getFastbootPath()

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

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors, IManagedTestDeviceFactory deviceFactory)

Inicialize o gerenciador de dispositivos.

void init(IDeviceSelection globalDeviceFilter, globalDeviceMonitors)

Inicialize o gerenciador de dispositivos.

void init()

Inicialize o gerenciador de dispositivos.

boolean isEmulator(String serial)

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

boolean isFileSystemMountCheckEnabled()

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

boolean isNullDevice(String serial)

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

void killEmulator(ITestDevice device)

Encerra o emulador fornecido.

void 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 para o modo adb-over-tcp e se conecta ao via connectToTcpDevice(String).

void removeDeviceMonitor(IDeviceMonitor mon)

Remove um IDeviceMonitor adicionado anteriormente.

void removeFastbootListener(IDeviceManager.IFastbootListener listener)

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

void restartAdbBridge()

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

void stopAdbBridge()

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

void terminate()

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

void terminateDeviceMonitor()

Interrompa os monitores de dispositivos.

void terminateDeviceRecovery()

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

void terminateHard(String reason)

Como terminateHard().

void terminateHard()

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

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

DeviceManager

public DeviceManager ()

O DeviceManager precisa 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 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 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 ITestDevice allocateDevice (IDeviceSelection options, 
                boolean isTemporary)

Solicite um dispositivo para testes 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 ITestDevice allocateDevice (IDeviceSelection options)

Solicite um dispositivo para testes 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 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 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 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 void displayDevicesInfo (PrintWriter stream, 
                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
stream PrintWriter: o ERROR(/PrintWriter) que vai receber a descrição da saída.
includeStub boolean: mostra ou não os 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 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.

executeGlobalAdbCommand

public String executeGlobalAdbCommand (String... cmdArgs)

Executar um comando adb não direcionado a um dispositivo específico, por exemplo, "adb connect"

Retorna
String std se o comando tiver sucesso nulo, caso contrário.

forceAllocateDevice

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

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

getAdbPath

public String getAdbPath ()

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

Retorna
String

getAdbVersion

public String getAdbVersion ()

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

Retorna
String

getDeviceDescriptor

public 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 String getFastbootPath ()

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

Retorna
String

init

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

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

Parâmetros
globalDeviceFilter IDeviceSelection

globalDeviceMonitors

deviceFactory IManagedTestDeviceFactory

init

public void init (IDeviceSelection globalDeviceFilter, 
                 globalDeviceMonitors)

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

Parâmetros
globalDeviceFilter IDeviceSelection: o filtro de dispositivo
globalDeviceMonitors

init

public void init ()

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

isEmulator

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

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

Parâmetros
serial String

Retorna
boolean

killEmulator

public void killEmulator (ITestDevice device)

Encerra o emulador fornecido.

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

iniciarEmulator

public 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

listAllDevices (listar dispositivos)

public  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  listAllDevices ()

Retorna uma lista de DeviceDescriptors para todos os dispositivos conhecidos.

Retorna
uma lista de DeviceDescriptor para todos os dispositivos conhecidos

reconectarDeviceToTcp

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

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

removeDeviceMonitor

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

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

stopAdbBridge

public void stopAdbBridge ()

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

encerrar

public void terminate ()

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

Precisa ser chamado após o encerramento do aplicativo.

encerrarDeviceMonitor

public void terminateDeviceMonitor ()

Interrompa os monitores de dispositivos.

encerrarDeviceRecovery

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

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

"waitForFirstDeviceAdded"

public 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