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 no modo Fastboot. |
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 deve ser recuperado do |
Métodos públicos | |
---|---|
void | addAvailableDevice (IDevice stubDevice) |
void | addDeviceMonitor ( IDeviceMonitor mon) Adiciona um |
void | addFastbootDevice ( DeviceManager.FastbootDevice fastbootDevice) |
void | addFastbootListener ( IDeviceManager.IFastbootListener listener) Informa ao gerente que um ouvinte está interessado em mudanças de estado de inicialização rápida. |
void | addMonitoringTcpFastbootDevice (String serial, String fastboot_serial) Adicione um dispositivo ao monitor de inicialização rápida. |
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 deve eventualmente ser liberado por meiodisconnectFromTcpDevice(com.android.tradefed.device.ITestDevice) O ITestDevice retornado estará online, mas pode não ser responsivo. |
boolean | disconnectFromTcpDevice ( ITestDevice tcpDevice) Desconecte-se de um dispositivo conectado adb-over-tcp. |
void | displayDevicesInfo (PrintWriter stream, boolean includeStub) Emita uma descrição amigável contendo uma lista de dispositivos conhecidos, seu estado e valores para as opções de |
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) Aloque grosseiramente um dispositivo, mesmo que não esteja disponível no momento. |
void | freeDevice ( ITestDevice device, FreeDeviceState deviceState) Devolver um dispositivo ao pool As tentativas de devolver um dispositivo que não foi alocado anteriormente serão ignoradas. |
String | getAdbPath () Retorna o caminho para o binário adb a ser usado. |
String | getAdbVersion () Obtenha a versão 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 de inicialização rápida 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 determinado serial representa um emulador |
boolean | isFileSystemMountCheckEnabled () Retorna se devemos ou não verificar em |
boolean | isNullDevice (String serial) Determine se determinado serial 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, conecta-se a ele por meio de |
void | removeDeviceMonitor ( IDeviceMonitor mon) Remove um |
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. |
void | restartAdbBridge () Reiniciar (se |
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 de dispositivos. |
void | terminateDeviceRecovery () Pára o thread de recuperação do dispositivo. |
void | terminateHard (String reason) Como |
void | terminateHard () Como |
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
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 |
addFastbootDevice
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 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 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 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 não houver um disponível |
alocar dispositivo
public 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 não houver um disponível |
alocar dispositivo
public 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 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 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 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 void displayDevicesInfo (PrintWriter stream, boolean includeStub)
Emita uma descrição amigável contendo uma lista de dispositivos conhecidos, seu estado e valores para as opções de IDeviceSelection
comumente usadas.
Parâmetros | |
---|---|
stream | PrintWriter : o ERROR(/PrintWriter) para enviar a descrição para |
includeStub | boolean : Se deve ou não exibir dispositivos stub também. |
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, caso contrário. |
forceAllocateDevice
public 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 void freeDevice (ITestDevice device, FreeDeviceState deviceState)
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 |
deviceState | FreeDeviceState : o FreeDeviceState . Usado para controlar se o dispositivo é devolvido 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 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 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 String getFastbootPath ()
Retorna o caminho para o binário de inicialização rápida 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.
isEmulator
public 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
o sistema de arquivos está montado corretamente.
devoluções | |
---|---|
boolean |
isNullDevice
public boolean isNullDevice (String serial)
Determine se determinado serial representa um dispositivo nulo
Parâmetros | |
---|---|
serial | String |
devoluções | |
---|---|
boolean |
killEmulator
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 representa o emulador para desligar |
lances | |
---|---|
DeviceNotAvailableException |
lançarEmulador
public 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 |
listAllDevices
publiclistAllDevices (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
publiclistAllDevices ()
Retorna uma lista de DeviceDescriptors para todos os dispositivos conhecidos
devoluções | |
---|---|
uma lista de DeviceDescriptor para todos os dispositivos conhecidos |
reconnectDeviceToTcp
public 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 |
removeDeviceMonitor
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 |
removeFastbootListener
public 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 void restartAdbBridge ()
Reiniciar (se stopAdbBridge()
foi chamado) adb bridge e serviços dependem de conexões adb.
stopAdbBridge
public void stopAdbBridge ()
Pare a ponte adb e os serviços dependem das conexões adb.
encerrar
public 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 void terminateDeviceMonitor ()
Pare os monitores de dispositivos.
terminaDeviceRecovery
public 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 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 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-01-10 UTC.