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 |
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 meiodisconnectFromTcpDevice(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 |
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 |
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 |
abstract void | removeDeviceMonitor ( IDeviceMonitor mon) Remove um |
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 |
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 |
abstract void | terminateHard () Como |
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, umIDeviceManager
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 meiodisconnectFromTcpDevice(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 chamadorParâ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 |
lances | |
---|---|
DeviceNotAvailableException | se o emulador falhar ao inicializar ou ficar online |
listAllDevices
public abstractlistAllDevices (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 abstractlistAllDevices ()
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.Veja também:
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 |
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2023-03-30 UTC.