IDeviceManager
public interface IDeviceManager
com.android.tradefed.device.IDeviceManager |
Interface para gerenciamento do conjunto de dispositivos disponíveis para teste.
Resumo
Turmas 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 fastboot. |
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 () Solicitar 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 eventualmente deve ser liberadodisconnectFromTcpDevice(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 por adb-over-tcp. |
abstract void | displayDevicesInfo (PrintWriter printWriter, boolean includeStub) Gere uma descrição amigável contendo uma lista de dispositivos conhecidos, seu estado e valores para opções de |
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 um dispositivo de forma grosseira, mesmo que não esteja disponível no momento. |
abstract void | freeDevice ( ITestDevice device, FreeDeviceState state) Devolva um dispositivo ao pool As tentativas de retornar 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 do 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 no |
abstract boolean | isNullDevice (String serial) Determinar 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, se conecta a ele via |
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 () Reinicie (se |
abstract void | stopAdbBridge () Pare a ponte adb e os serviços dependem de conexões adb. |
abstract void | terminate () Interrompe os serviços de monitoramento de dispositivo e encerra a biblioteca ddm. |
abstract void | terminateDeviceMonitor () Pare os monitores de dispositivos. |
abstract void | terminateDeviceRecovery () Interrompe o encadeamento 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 é um pouco hack - encontre uma solução melhor addMonitoringTcpFastbootDevice
public abstract 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 abstract 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 um não estiver disponível |
alocarDispositivo
public abstract 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 um não estiver disponível |
alocarDispositivo
public abstract ITestDevice allocateDevice ()
Solicitar um dispositivo físico para teste
Devoluções | |
---|---|
ITestDevice | um ITestDevice para teste ou null se um não estiver 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 eventualmente deve ser liberadodisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice)
O ITestDevice
retornado estará online, mas pode não ser responsivo. Observe que executar uma ação, como uma reinicialização em um dispositivo conectado tcp, cortará a conexão tcp com o dispositivo e resultará em um DeviceNotAvailableException
Parâmetros | |
---|---|
ipAndPort | String : o endereço IP original e a porta do dispositivo para se conectar |
Devoluções | |
---|---|
ITestDevice | o ITestDevice ou null se uma conexão tcp não pôde ser formada |
desconectarDeTcpDevice
public abstract 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 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)
Gere uma descrição amigável contendo uma lista de dispositivos conhecidos, seu estado e valores para opções de 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 : A série do dispositivo. |
command | String : O comando shell. |
timeout | long : A quantidade de tempo para que o comando seja concluído. |
timeUnit | TimeUnit : A unidade para o tempo limite. |
Devoluções | |
---|---|
CommandResult | Um CommandResult . |
forceAlocateDevice
public abstract ITestDevice forceAllocateDevice (String serial)
Aloque um dispositivo de forma grosseira, 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 |
dispositivo grátis
public abstract void freeDevice (ITestDevice device, FreeDeviceState state)
Devolva um dispositivo ao pool
As tentativas de retornar 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 é retornado 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 do 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 null 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 no NativeDeviceStateMonitor
o sistema de arquivos está montado corretamente.
Devoluções | |
---|---|
boolean |
isNullDevice
public abstract boolean isNullDevice (String serial)
Determinar 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 representando o emulador para desligar |
Lança | |
---|---|
DeviceNotAvailableException | se o emulador não desligar |
launchEmulator
public abstract void launchEmulator (ITestDevice device, long bootTimeout, IRunUtil runUtil,emulatorArgs)
Método auxiliar para iniciar o emulador.
Iniciará o emulador conforme especificado pelo chamadorParâmetros | |
---|---|
device | ITestDevice : o espaço reservado ITestDevice representando o dispositivo do emulador alocado |
bootTimeout | long : o tempo em ms para esperar o emulador inicializar |
emulatorArgs |
Lança | |
---|---|
DeviceNotAvailableException | se o emulador não inicializar ou ficar online |
listAllDevices
public abstractlistAllDevices (boolean shortDescriptor)
Retorna uma lista de DeviceDescriptors para todos os dispositivos conhecidos
Parâmetros | |
---|---|
shortDescriptor | boolean : se os descritores devem ser limitados 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 |
reconectarDeviceToTcp
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, se conecta a ele via connectToTcpDevice(String)
.
Parâmetros | |
---|---|
usbDevice | ITestDevice : o dispositivo atualmente no 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 | 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 ()
Reinicie (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 de conexões adb.
terminar
public abstract void terminate ()
Interrompe os serviços de monitoramento de dispositivo e encerra a biblioteca ddm.
Isso deve ser chamado no encerramento do aplicativo.Veja também:
encerrarDeviceMonitor
public abstract void terminateDeviceMonitor ()
Pare os monitores de dispositivos.
encerrarDeviceRecovery
public abstract void terminateDeviceRecovery ()
Interrompe o encadeamento de recuperação do dispositivo.
terminarHard
public void terminateHard (String reason)
Como terminateHard()
.
Parâmetros | |
---|---|
reason | String : motivo opcional fornecido para a rescisão. |
terminarHard
public abstract void terminateHard ()
Como terminate()
, mas também tenta encerrar o adb com força.
waitForFirstDeviceAdicionado
public abstract boolean waitForFirstDeviceAdded (long timeout)
Aguarde até que um primeiro dispositivo físico seja conectado. Se um dispositivo foi conectado antes, ele retornará diretamente True. Se nenhum dispositivo foi adicionado, ele retornará false 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 2022-11-07 UTC.