IDeviceManager

public interface IDeviceManager

com.android.tradefed.device.IDeviceManager


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

Resumo

Classes aninhadas

interface IDeviceManager.IFastbootListener

Um ouvinte para mudanças de estado de inicialização rápida.

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 mudanças de estado de inicialização rápida.

abstract void addMonitoringTcpFastbootDevice (String serial, String fastboot_serial)

Adicione um dispositivo ao monitor de inicialização rápida.

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

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

abstract boolean disconnectFromTcpDevice ( ITestDevice tcpDevice)

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

abstract void displayDevicesInfo (PrintWriter printWriter, boolean includeStub)

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

Aloque grosseiramente um dispositivo, mesmo que não esteja disponível no momento.

abstract void freeDevice ( ITestDevice device, FreeDeviceState state)

Devolver um dispositivo ao pool

As tentativas de devolver um dispositivo que não foi 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 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 de inicialização rápida 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 determinado serial 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)

Determine se determinado serial 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, conecta-se 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 mudanças de estado de inicialização rápida.

abstract void restartAdbBridge ()

Reiniciar (se stopAdbBridge() foi chamado) adb bridge e 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 de dispositivos.

abstract void terminateDeviceRecovery ()

Pára 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 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 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 abstract 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 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 houver um disponível

alocar dispositivo

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 houver um disponível

alocar dispositivo

public abstract 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 abstract 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 uma 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 abstract 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 abstract void displayDevicesInfo (PrintWriter printWriter, 
                boolean includeStub)

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

Parâmetros
printWriter PrintWriter : o ERROR(/PrintWriter) para enviar a descrição para

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

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)

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

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

state FreeDeviceState : o FreeDeviceState . Usado para controlar se o dispositivo é devolvido 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 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 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 abstract String getFastbootPath ()

Retorna o caminho para o binário de inicialização rápida 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.

isEmulator

public abstract 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 se o sistema de arquivos está montado corretamente.

devoluções
boolean

isNullDevice

public abstract boolean isNullDevice (String serial)

Determine se determinado serial representa um dispositivo nulo

Parâmetros
serial String

devoluções
boolean

killEmulator

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

lances
DeviceNotAvailableException se o emulador falhar ao desligar

lançarEmulador

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 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 se o emulador falhar ao inicializar ou ficar online

listAllDevices

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

listAllDevices

public abstract  listAllDevices ()

Retorna uma lista de DeviceDescriptors para todos os dispositivos conhecidos

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

reconnectDeviceToTcp

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, 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 se a conexão com usbDevice foi perdida e não pôde ser recuperada

removeDeviceMonitor

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

removeFastbootListener

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

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

stopAdbBridge

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.

TerminateDeviceMonitor

public abstract void terminateDeviceMonitor ()

Pare os monitores de dispositivos.

terminaDeviceRecovery

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