Enviar comandos do console do emulador

Cada dispositivo virtual em execução dispõe de um console que permite consultar e controlar o ambiente do dispositivo emulado. Por exemplo, é possível usar o console para gerenciar redirecionamentos de porta, características de rede e eventos de telefonia enquanto o app é executado no emulador.

Os comandos a seguir exigem que um emulador já esteja em execução. Para mais informações sobre como executar um emulador, consulte Executar apps no Android Emulator e Iniciar o emulador na linha de comando.

Iniciar e parar uma sessão do console

Para acessar o console e inserir comandos em uma janela de terminal, use telnet para se conectar à porta do console e informe o token de autenticação. Cada vez que o console mostra OK, ele está pronto para aceitar comandos. Não há um comando típico.

Para conectar-se ao console de um dispositivo virtual em execução:

1. Abra uma janela de terminal e insira o seguinte comando:

   telnet localhost console-port
   

   O título da janela do emulador lista o número da porta do console quando executado em uma janela separada, mas não em uma de ferramentas. Por exemplo, o título da janela de um emulador usando a porta de console 5554 pode ser Pixel8_API_34:5554. Além disso, o comando adb devices mostra uma lista de dispositivos virtuais em execução e os números de porta de console. Para mais informações, consulte Consultar dispositivos.

   Observação:o emulador detecta conexões nas portas 5554 a 5585 e aceita conexões apenas do localhost.

2. Depois que o console exibir OK, insira o comando auth auth_token.

   Para que você insira comandos, o console do emulador requer autenticação. auth_token precisa corresponder ao conteúdo do arquivo .emulator_console_auth_token no seu diretório inicial.

   O comando telnet localhost console-port cria esse arquivo, que contém um token de autenticação gerado aleatoriamente, caso ele não exista. Para desativar a autenticação, exclua o token do arquivo .emulator_console_auth_token ou crie um arquivo vazio se ele não existir.

3. Depois de se conectar ao console, insira os comandos.

   Digite help, help command ou help-verbose para ver uma lista de comandos de console e saber mais sobre comandos específicos.

4. Para sair da sessão de console, insira quit ou exit.

Veja um exemplo de sessão:

$ telnet localhost 5554
Trying ::1...
telnet: connect to address ::1: Connection refused
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
Android Console: Authentication required
Android Console: type 'auth <auth_token>' to authenticate
Android Console: you can find your <auth_token> in
'/Users/me/.emulator_console_auth_token'
OK
auth 123456789ABCdefZ
Android Console: type 'help' for a list of commands
OK
help-verbose
Android console command help:
    help|h|?         Prints a list of commands
    help-verbose     Prints a list of commands with descriptions
    ping             Checks if the emulator is alive
    automation       Manages emulator automation
    event            Simulates hardware events
    geo              Geo-location commands
    gsm              GSM related commands
    cdma             CDMA related commands
    crash            Crashes the emulator instance
    crash-on-exit    Simulates crash on exit for the emulator instance
    kill             Terminates the emulator instance
    restart          Restarts the emulator instance
    network          Manages network settings  (ethernet and cellular only)
    power            Power related commands
    quit|exit        Quits control session
    redir            Manages port redirections
    sms              SMS related commands
    avd              Controls virtual device execution
    qemu             QEMU-specific commands
    sensor           Manages emulator sensors
    physics          Manages physical model
    finger           Manages emulator finger print
    debug            Controls the emulator debug output tags
    rotate           Rotates the screen clockwise by 90 degrees
    screenrecord     Records the emulator's display
    fold             Folds the device
    unfold           Unfolds the device
    multidisplay     Configures the multi-display
    nodraw           turn on/off NoDraw mode. (experimental)
    resize-display   resize the display resolution to the preset size
    virtualscene-image  customize virtualscene image for virtulscene camera
    proxy            manage network proxy server settings
    phonenumber      set phone number for the device

try 'help <command>' for command-specific help
OK
exit
Connection closed by foreign host.

Comandos de execução e esquecimento

Se você não precisar manter a sessão aberta, use o atalho adb emu, que executa o comando e retorna imediatamente o controle ao shell de invocação:

adb emu command commandParameter

A invocação com adb emu se conecta ao emulador disponível. Se você tiver vários emuladores em execução ao mesmo tempo, transmita o número de série do emulador específico que você está segmentando:

adb -s emulator-serial emu command commandParameter

Referência de comando do emulador

As listas a seguir descrevem os comandos do console do emulador com os parâmetros e valores relacionados:

Comandos gerais

• avd {stop| start| status| name} Consulta, controla e gerencia o dispositivo virtual da seguinte maneira:

  • stop: para a execução do dispositivo.
  • start: inicia a execução do dispositivo.
  • status: consulta o status do dispositivo virtual, que pode ser "running" ou "stopped".
  • name: consulta o nome do dispositivo virtual.

• avd snapshot {list| save name| load name| delete name} Salva e restaura o estado do dispositivo em snapshots desta maneira:

  • list: lista todos os snapshots salvos.
  • save name: salva o snapshot como nome.
  • load name: carrega o snapshot nomeado.
  • delete name: exclui o snapshot nomeado.

  O exemplo a seguir salva um snapshot com o nome firstactivitysnapshot:

  avd snapshot save firstactivitysnapshot
  

• fold: dobra o dispositivo para mostrar a menor configuração da tela se ele for dobrável e estiver aberto no momento.

• desdobrar: desdobra o dispositivo para mostrar a maior configuração da tela se ele for dobrável e estiver dobrado no momento.

• kill: encerra o dispositivo virtual.

• ping: verifica se o dispositivo virtual está sendo executado.

• rotate: gira o AVD no sentido anti-horário em incrementos de 45 graus.

Falha no emulador

• crash: causa uma falha no emulador durante a execução do app.

• crash-on-exit: causa uma falha no emulador quando o app é encerrado.

Tags de depuração

• tags de depuração ...: ativa ou desativa mensagens de depuração de partes específicas do emulador. O parâmetro "tags" precisa ser um valor da lista de tags de depuração que aparece quando você executa emulator -help-debug-tags. Para mais informações sobre a opção -help-debug-tags, consulte a tabela de opções usadas com mais frequência. O exemplo a seguir ativa a tag "radio":

  debug radio
  

Redirecionamento de porta

• redir list: lista o redirecionamento de porta atual.

• redir add protocol:host-port:guest-port Adiciona um novo redirecionamento de porta, da seguinte maneira:

  • protocol: precisa ser tcp ou udp.
  • host-port: número da porta a ser aberta no host.
  • guest-port: número da porta para a qual rotear dados no emulador.

• redir del protocol:host-port Exclui um redirecionamento de porta.

  • protocol: precisa ser tcp ou udp.
  • host-port: número da porta a ser aberta no host.

Localização geográfica

Define a localização geográfica relatada para os apps em execução dentro de um emulador, enviando um ponto GPS para o emulador.

Você poderá emitir um dos seguintes comandos geo assim que um dispositivo virtual estiver em execução. O emulador define o local que você insere criando um provedor de locais fictícios. Esse provedor responde aos listeners de localização definidos por apps e informa o local para o LocationManager. Qualquer app pode consultar o gerenciador de localização para acessar o ponto GPS atual do dispositivo emulado chamando LocationManager.getLastKnownLocation("gps").

• geo fix longitude latitude [altitude] [satellites] [velocity]: envia um ponto GPS simples para o emulador. Especifique a longitude e a latitude em graus decimais. Use um número de 1 a 12 para especificar a quantidade de satélites a serem usados para determinar a posição e especifique a altitude em metros e a velocidade em nós.

• geo nmea sentence: envia uma sentença NMEA 0183 para o dispositivo emulado como se ela tivesse sido enviada de um modem GPS emulado. Comece a frase com "$GP". No momento, só há suporte para as sentenças "$GPGGA" e "$GPRCM". O exemplo a seguir é uma sentença de Dados de Posição do Sistema de Posicionamento Global (GPGGA, na sigla em inglês) que recebe o horário, a posição e os dados de localização de um receptor GPS:

  geo nmea $GPGGA,hhmmss.ss,llll.ll,a,yyyyy.yy,a,x,xx,x.x,x.x,M,x.x,M,x.x,xxxx
  

Eventos falsos de hardware

O subsistema de eventos de hardware do console do emulador permite simular praticamente qualquer interação física com o dispositivo. Isso inclui botões físicos, toque/gestos na tela, controles giratórios, entradas de joystick e chaves de hardware.

• event types: lista todos os tipos de eventos falsos. Para eventos que têm códigos, o número de códigos é listado entre parênteses à direita. Exemplo de saída:

  event types
  event <type> can be an integer or one of the following aliases:
      EV_SYN
      EV_KEY    (405 code aliases)
      EV_REL    (2 code aliases)
      EV_ABS    (27 code aliases)
      EV_MSC
      EV_SW     (4 code aliases)
      EV_LED
      EV_SND
      EV_REP
      EV_FF
      EV_PWR
      EV_FF_STATUS
      EV_MAX
  OK
  

• event send types [types ...]: envia um ou mais tipos de eventos falsos.

• Tipo de códigos de evento: lista os códigos de evento para o tipo de evento falso especificado.

• event send type[:code]:[value] [...]: envia um ou mais eventos falsos com códigos e valores de código opcionais.

EV_KEY: referências de código de tecla

O tipo de evento EV_KEY é usado para simular pressionamentos e liberações de botões. As tabelas a seguir dividem a vasta lista de códigos de tecla compatíveis em categorias lógicas. Para cada código de tecla, o envio de um valor 1 simula uma ação de pressionar, enquanto um valor 0 simula uma ação de soltar. Um valor de 2 representa a repetição de tecla.

Subtabela A: chaves do sistema Android

Subtabela B: controles de mídia e reprodução

Subtabela C: navegação e teclados gerais

Subtabela D: alfanuméricos e símbolos do teclado numérico

• Letras padrão do alfabeto:KEY_A a KEY_Z (26 códigos).
• Teclas do teclado numérico:KEY_1 a KEY_0 (10 códigos).

Subtabela E: teclas modificadoras e de função

• Teclas de função padrão:KEY_F1 a KEY_F24 (24 códigos).

Subtabela F: gamepads e joysticks

Subtabela G: entradas de mouse, toque e stylus

Subtabela H: atalhos de aplicativos

EV_ABS: eventos de movimento absoluto

O tipo de evento EV_ABS é crucial para simular toques precisos, gestos de arrastar e soltar, ações de pinça multitoque e ajustes de joystick. As coordenadas absolutas abaixo do mapa correspondem diretamente à resolução da tela física.

A interação por toque do Android é impulsionada por protocolos multitoque (MT). Os emuladores modernos implementam o Protocolo A (sem estado, enviando pacotes de contato separados por marcas de sincronização) e o Protocolo B (com estado, atribuindo contatos a slots de rastreamento dedicados). O protocolo B permite o acompanhamento eficiente de vários toques simultâneos para gestos como pinça para zoom.

EV_REL e EV_SW: movimento e interruptores de hardware

A categoria de evento EV_REL gerencia mudanças relativas de ponteiro ou coordenadas, que são usadas principalmente para emular movimentos externos do mouse ou rolagem de rodas. A categoria de evento EV_SW gerencia chaves de dispositivos físicos, como se um smartphone dobrável ou tablet está dobrado ou se um hardware de áudio externo está inserido.

Sintaxe de envio de comandos

Para enviar esses códigos, formate o comando do console com tipos, códigos e valores separados por dois-pontos. É possível enfileirar várias mudanças de coordenadas em uma única string. É fundamental sempre adicionar uma marca de sincronização final (EV_SYN:0:0) para indicar que o framework do emulador precisa agrupar e processar essas entradas juntas.

Exemplos de gestos e programação de eventos

Como o Telnet permite enviar parâmetros de várias partes, é possível simular sequências de gestos físicos realistas. Confira abaixo as estruturas de script de evento bruto para automatizar gestos do console do host.

Simular um toque na tela

Para fazer um toque limpo na tela em uma coordenada de destino, atribua um ID de rastreamento, especifique as coordenadas X e Y na tela, simule o toque, sincronize e solte.

# Press down at coordinate (400, 800) and sync
event send EV_ABS:ABS_MT_TRACKING_ID:1
OK
event send EV_ABS:ABS_MT_POSITION_X:400
OK
event send EV_ABS:ABS_MT_POSITION_Y:800
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Lift finger up and sync
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK

Como simular uma rolagem vertical (deslizar)

Para executar um gesto de deslizar para rolar, mantenha o contato pressionado na coordenada inicial, envie frames de coordenadas de movimento intermediário e solte no final.

# Finger touch down at start coordinate (500, 1600)
event send EV_ABS:ABS_MT_TRACKING_ID:2
OK
event send EV_ABS:ABS_MT_POSITION_X:500
OK
event send EV_ABS:ABS_MT_POSITION_Y:1600
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Move coordinates upward dynamically
event send EV_ABS:ABS_MT_POSITION_Y:1200
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_POSITION_Y:800
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_POSITION_Y:400
OK
event send EV_SYN:0:0
OK
# Finger release at coordinate (500, 400)
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK

Simular um gesto de pinça para aplicar zoom

Para acionar um zoom de dois dedos, use slots MT ativos (0 e 1) para rastrear e coordenar duas coordenadas de toque simultâneas que se afastam uma da outra.

# Finger 1 down at (500, 1000) using slot 0
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_TRACKING_ID:10
OK
event send EV_ABS:ABS_MT_POSITION_X:500
OK
event send EV_ABS:ABS_MT_POSITION_Y:1000
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Finger 2 down at (600, 1000) using slot 1
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_TRACKING_ID:11
OK
event send EV_ABS:ABS_MT_POSITION_X:600
OK
event send EV_ABS:ABS_MT_POSITION_Y:1000
OK
event send EV_SYN:0:0
OK
# Fingers slide apart from each other
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_POSITION_X:300
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_POSITION_X:800
OK
event send EV_SYN:0:0
OK
# Lift Finger 1 using slot 0
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_SYN:0:0
OK
# Lift Finger 2 using slot 1
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK

Como simular uma troca de conexão de fones de ouvido

Simule inserções ou remoções de entrada para fone de ouvido para testar as chaves de roteamento de áudio. Um valor de 1 representa a inserção do conector, e 0 é a remoção do fone de ouvido.

# Simulate headphones plugged in
event send EV_SW:SW_HEADPHONE_INSERT:1 EV_SYN:0:0
OK
# Simulate headphones unplugged
event send EV_SW:SW_HEADPHONE_INSERT:0 EV_SYN:0:0
OK

Descobrindo códigos de eventos do console em um dispositivo real

Para descobrir a sequência exata de sintaxe de evento para qualquer ação personalizada ou gesto de botão, conecte-se via adb shell e execute o utilitário de diagnóstico getevent. À medida que você interage com a GUI do emulador, o console imprime os códigos, tipos e posições exatos dos eventos.

# Run getevent to monitor input events dynamically
adb shell getevent -lt
/dev/input/event12: EV_KEY       KEY_POWER            DOWN
/dev/input/event12: EV_SYN       SYN_REPORT           00000000
/dev/input/event12: EV_KEY       KEY_POWER            UP
/dev/input/event12: EV_SYN       SYN_REPORT           00000000

• Mensagem de texto do evento: envia uma string de caracteres que simulam pressionamentos de tecla. A mensagem precisa ser uma string UTF-8. As postagens Unicode são mapeadas de maneira reversa de acordo com o teclado do dispositivo atual, e os caracteres sem suporte são descartados silenciosamente.

Controles de estado de energia

• power display: mostra o estado da bateria e do carregador.

• power ac {on| off}: define o estado de carregamento CA como ativado ou desativado.

• power status {unknown| charging| discharging| not-charging| full}: muda o status da bateria conforme especificado.

• power present {true| false}: define o estado de presença da bateria.

• power health {unknown| good| overheat| dead| overvoltage| failure}: define o estado de integridade da bateria.

• power capacity percent: define o estado da capacidade da bateria restante como uma porcentagem de 0 a 100.

Status da conexão de rede (somente Ethernet e celular)

• status da rede: verifica o status da rede e as características atuais de atraso e velocidade.

• network delay latency Modifica a latência da rede emulada.

  O emulador permite simular vários níveis de latência de rede para que você possa testar o app em um ambiente mais próximo de condições reais de execução. Você pode definir um nível de latência ou um intervalo na inicialização do emulador ou usar o console para mudar a latência enquanto o app está sendo executado no emulador.

  O formato de latência de rede é um dos seguintes (os números estão em milissegundos):

  Formato de latência de rede:

• gprs: GPRS, que usa um intervalo de latência de no mínimo 150 e no máximo 550.

• edge: EDGE/EGPRS, que usa um intervalo de latência de no mínimo 80 e no máximo 400.

• umts: UMTS/3G, que usa um intervalo de latência de no mínimo 35 e no máximo 200.

• none: sem latência.

• num: emula a latência especificada em milissegundos.

• min:max: emula o intervalo de latência especificado.

  Para definir a latência na inicialização, use a opção de emulador -netdelay com um valor de latência compatível. Exemplos:

  emulator -netdelay gprs
  emulator -netdelay 40,100
  

  Para fazer mudanças no atraso da rede enquanto o emulador está em execução, conecte-se ao console e use o comando network delay:

  network delay gprs
  network delay 40 100
  

• network speed speed O emulador permite simular várias taxas de transferência de rede. Você pode definir uma taxa de transferência ou um intervalo na inicialização do emulador ou usar o console para mudar a taxa enquanto o app está sendo executado no emulador.

  O formato da velocidade da rede é um dos seguintes (os números estão em kilobits/s):

  Formato de velocidade da rede:

• gsm: GSM/CSD, que usa uma velocidade de 14,4 de upload e 14,4 de download.

• hscsd: HSCSD, que usa uma velocidade de 14,4 de upload e 43,2 de download.

• gprs: GPRS, que usa uma velocidade de 40,0 de upload e 80,0 de download.

• edge: EDGE/EGPRS, que usa uma velocidade de 118,4 de upload e 236,8 de download.

• umts: UMTS/3G, que usa uma velocidade de 128,0 de upload e 1.920 de download.

• hsdpa: HSDPA, que usa uma velocidade de 348 de upload e 14.400 de download.

• lte: LTE, que usa uma velocidade de 58.000 de upload e 173.000 de download.

• evdo: EVDO, que usa uma velocidade de 75.000 de upload e 280.000 de download.

• full: velocidade ilimitada, mas depende da velocidade de conexão do seu computador.

• num: define uma taxa exata em kilobits/s usada para upload e download.

• up:down: define taxas exatas em kilobits/s para upload e download separadamente.

  Para definir a velocidade da rede na inicialização do emulador, use a opção de emulador -netspeed. Exemplos:

  emulator -netspeed gsm @Pixel_API_26
  emulator -netspeed 14.4,80 @Pixel_API_26
  

  Para fazer mudanças na velocidade da rede enquanto o emulador está em execução, conecte-se ao console e use o comando network speed:

  network speed 14.4 80
  

• network capture {start| stop} file Envia pacotes para um arquivo. A lista a seguir descreve os parâmetros e valores relacionados:

  Observação:a partir do Android Emulator 36.5 e versões mais recentes, o tráfego de conexão Wi-Fi é processado pelo netsim por padrão. O comando do console de captura de rede captura apenas o tráfego celular/WAN legado roteado pela pilha slirp do QEMU. Para capturar pacotes de rede Wi-Fi, Bluetooth ou avançados em versões modernas do emulador, consulte Capturar tráfego de rede no guia de rede avançada do emulador.

• start file: começa a capturar pacotes de rede. Por segurança, o arquivo precisa ser um nome de arquivo simples (sem separadores de caminho, como /, e sem ..). O arquivo de captura de pacote será salvo no diretório de conteúdo do AVD, na pasta console_out/ (por exemplo, ~/.android/avd/avd_name.avd/console_out/file).

• stop file: para de enviar pacotes para o arquivo especificado.

Emulação de telefonia

O emulador Android inclui os próprios modems emulados GSM e CDMA que permitem simular funções de telefonia. Por exemplo, com o GSM, é possível simular chamadas de entrada, além de estabelecer e encerrar conexões de dados. Com o CDMA, você informa uma fonte de assinatura e a lista de roaming preferencial. O sistema Android processa ligações simuladas exatamente como faria com as reais. O emulador não tem suporte a áudio de ligações.

• gsm {call| accept| cancel| busy} phonenumber Os parâmetros gsm são os seguintes:

  • call: simula uma ligação recebida de um número de telefone.
  • accept: aceita uma chamada recebida de um número de telefone e muda o estado da chamada para ativo. Você só pode mudar o estado de uma chamada para "ativa" quando o estado atual é "em espera" ou "em espera".
  • cancel: encerra uma ligação recebida de ou realizada para phonenumber.
  • busy: encerra uma chamada de saída para um número de telefone e muda o estado da chamada para ocupado. Você só pode mudar o estado de uma chamada para ocupado quando o estado atual é aguardando.

• gsm {data| voice} state O comando de estado de dados muda o estado da conexão de dados GPRS, e o comando de estado de voz muda o estado da conexão de voz GPRS, da seguinte maneira:

  • unregistered: nenhuma rede disponível
  • home: em rede local, sem roaming
  • roaming: em rede com roaming
  • searching: pesquisando redes
  • denied: somente chamadas de emergência
  • off: igual a "unregistered".
  • on: igual a "home".

• gsm hold: muda o estado de uma chamada para em espera. Você só pode mudar o estado de uma chamada para espera quando o estado atual é ativo ou aguardando.

• gsm list: lista todas as chamadas de entrada e de saída e os estados delas.

• gsm status: informa o estado atual de voz/dados GSM. Os valores são aqueles descritos para os comandos de voz e dados.

• gsm signal {rssi| ber} Muda a intensidade do sinal relatado (rssi) e a taxa de erros de bit (ber) nos próximos 15 segundos de atualização. A lista a seguir descreve os parâmetros e valores relacionados:

  • rssi: o intervalo é de 0 a 31 e 99 para desconhecido.
  • ber: o intervalo é de 0 a 7, e 99 para desconhecido.

• gsm signal-profile num: define o perfil da intensidade do sinal. "num" é um número de 0 a 4.

• cdma ssource source Define a origem da assinatura CDMA atual, em que "source" é uma lista de permissões baseada em rede que contém os assinantes da operadora CDMA e os valores correspondentes, da seguinte maneira:

  • nv: lê a assinatura da RAM não volátil.
  • ruim: lê a assinatura do Removable User Identity Module (R-UIM).

• cdma prl_version version: despeja a versão atual da lista de roaming preferencial (PRL). O número da versão se destina ao banco de dados da PRL que contém informações usadas durante o processo de seleção e aquisição do sistema.

Gerenciar sensores no emulador

Esses comandos se referem aos sensores que estão disponíveis no AVD. Além de usar o comando de sensor, você pode consultar e ajustar as configurações no emulador na tela "Sensores virtuais", nas guias "Acelerômetro" e "Sensores adicionais".

• sensor status: lista todos os sensores e os status deles.

• sensor get sensor-name: acessa as configurações de sensor-name. O exemplo a seguir acessa o valor do sensor de aceleração:

  sensor get acceleration
  acceleration = 2.23517e-07:9.77631:0.812348
  

  Os valores de aceleração separados por dois pontos(:) referem-se às coordenadas x, y e z dos sensores virtuais.

• sensor set sensor-name value-x:value-y:value-z: define os valores para sensor-name. O exemplo a seguir define o sensor de aceleração com os valores de x, y e z separados por dois pontos.

  sensor set acceleration 2.23517e-07:9.77631:0.812348
  

Emulação de SMS

• sms send sender-phone-number textmessage Gera um SMS recebido emulado. A lista a seguir descreve os parâmetros e valores relacionados:

  • sender-phone-number: contém uma string numérica arbitrária.
  • textmessage: é a mensagem SMS.

  O exemplo a seguir envia a mensagem "olá" para o número de telefone 4085555555:

  sms send 4085555555 hi there
  

O console encaminha a mensagem SMS para o framework do Android, que a transmite para um app no emulador que processa SMS, como o app Mensagens. Se você transmitir 10 números, eles vão ser formatados pelo app como um número de telefone. Sequências numéricas mais longas ou mais curtas são exibidas da maneira como você as envia.

Simulação de impressão digital

• finger touch fingerprint-id: simula um dedo tocando o sensor.

• finger remove: simula um dedo deixando o sensor.

Para instruções sobre como usar esses comandos, consulte a seção a seguir sobre simulação e validação de impressão digital.

Gravador de tela

O comando de gravação de tela permite capturar arquivos de vídeo de alta qualidade da tela física do emulador diretamente do sistema host. Isso é muito útil para pipelines de integração contínua e relatórios de bugs automatizados.

• screenrecord {start| stop} file Inicia ou interrompe o processo de gravação da tela.
  • start file: inicia a gravação de vídeo. O arquivo de saída precisa terminar com a extensão obrigatória .webm. O vídeo capturado é salvo diretamente no diretório de saída do console do AVD: ~/.android/avd/avd_name.avd/console_out/file.
  • stop file: interrompe o processo de gravação de tela ativo.

Automação e macro

O subsistema de automação permite que os desenvolvedores gravem transições de estado de macro no dispositivo virtual em execução e as reproduzam para executar fluxos de teste automatizados.

• automation {record| stop-record| play| stop-play} Gerencia gravações de macros automatizadas.
  • record: inicia a gravação de mudanças de estado e entradas do dispositivo.
  • stop-record: interrompe a sessão de gravação de macro atual.
  • play: inicia a reprodução de uma sequência de macro gravada.
  • stop-play: interrompe a sequência de reprodução de macro ativa.

Física (6DoF)

Os comandos de física gerenciam a verdade fundamental de registro de posturas espaciais para modelos de movimento físico de seis graus de liberdade (6DoF), que são usados para simular o rastreamento avançado de movimento.

• physics {record-gt| stop} Gerencia gravações de modelos de postura física.
  • record-gt: começa a gravar dados de movimento 6DoF de verdade absoluta.
  • stop: interrompe o processo de gravação da verdade fundamental atual.

Controles avançados de dispositivos

Esta seção agrega endpoints de comando do console altamente especializados para configurações avançadas de emulação, incluindo proxies de rede, configurações de vários monitores, substituições de renderização e depuração direta do hipervisor.

• multidisplay {add| del} Adiciona ou exclui monitores virtuais secundários para testar configurações de várias telas. Observação:monitores secundários não são compatíveis com perfis de dobra, como o Pixel Fold ou o emulador redimensionável.

• proxy {set| clear} Configura o encaminhamento de proxy de rede de forma programática no console.

  • set host port: Configura as configurações de proxy de destino.
  • clear: redefine as configurações de proxy para o padrão. Observação:as operações de definição de proxy falham em ambientes de execução sem interface gráfica.

• virtualscene-image {wall| table} image_path Personaliza as paredes de fundo ou as mesas horizontais mostradas na transmissão da câmera de cena virtual com um arquivo de imagem do usuário personalizado.

• resize-display scale Ajusta dinamicamente a resolução da tela entre escalas predefinidas. Observação:os ajustes de resolução não são compatíveis com configurações headless.

• nodraw {on| off} Desativa a renderização física da GUI na tela do host para reduzir a memória do sistema e a carga da GPU durante execuções de automação sem interface gráfica em segundo plano de alto volume.

• grpc port Configura o controle programático avançado de dispositivos em endpoints de porta gRPC personalizados.

• qemu monitor Fornece acesso direto ao terminal interativo do console do hipervisor subjacente. Esse comando só pode ser inserido em sessões ativas do console Telnet.

• icebox track pid Ativa snapshots automáticos do sistema quando o processo do app especificado passa por uma exceção ou falha não processada.

• phonenumber number Define o número de telefone local virtual do dispositivo de destino.

Interface programática do gRPC

As versões modernas do emulador oferecem suporte a uma interface programática gRPC avançada além do console Telnet legado. Embora o console Telnet seja ótimo para sessões interativas rápidas ou scripts simples, a interface gRPC foi projetada para controle automatizado de alto desempenho, seguro e robusto em ambientes de integração contínua (CI) e sem interface gráfica. Ao oferecer endpoints de serviço diretos, o gRPC elimina a necessidade de analisar fluxos de texto, gerenciar handshakes de sessão de terminal ou expor portas de localhost não criptografadas.

Para ajudar a escolher entre o console Telnet legado e a interface programática gRPC moderna, confira a comparação a seguir de desempenho, segurança e recursos:

Como iniciar e chamar o gRPC

Para usar os endpoints gRPC, inicie o Android Emulator na linha de comando e inclua a flag -grpc, especificando a porta de loopback de destino.

# Start the emulator with the gRPC service enabled on port 8556
emulator -grpc localhost:8556 @Pixel_Fold

Depois que o emulador estiver em execução com o serviço gRPC ativado, você poderá fazer chamadas de RPC programáticas. Para testes de linha de comando, use o utilitário grpcurl para se comunicar com os serviços do emulador. Todas as solicitações são formatadas em JSON e enviadas em texto simples.

# Query the status of the virtual device using grpcurl
grpcurl -plaintext -d '{}' localhost:8556 \
  android.emulation.control.EmulatorController/getStatus

# Simulate an incoming phone call
grpcurl -plaintext -d '{"operation": "InitCall", "number": "1234567890"}' localhost:8556 \
  android.emulation.control.EmulatorController/sendPhone

# Simulate typing text into the guest OS
grpcurl -plaintext -d '{"text": "Hello"}' localhost:8556 \
  android.emulation.control.EmulatorController/sendKey

Mapeamento do console Telnet para o serviço gRPC

A tabela de referência a seguir mapeia os comandos legados do console Telnet para os serviços e métodos gRPC correspondentes, indicando como automatizar interações comuns de dispositivos virtuais de maneira programática:

Comandos programáticos exclusivos do gRPC

A interface gRPC oferece vários recursos de ponta que são fisicamente impossíveis de executar em conexões legadas do console Telnet. Isso inclui streaming direto de logcat, captura ou injeção de áudio bidirecional, modificações na GUI do host e acesso direto ao shell.

Simulação e validação de impressão digital

Use o comando "finger" para simular e validar a autenticação de impressão digital para seu app. Você precisa das Ferramentas do SDK 24.3 ou mais recente e do Android 6.0 (nível da API 23) ou mais recente.

Para simular e validar a autenticação de impressão digital, siga estas etapas:

1. Se você ainda não tem um ID de impressão digital, cadastre uma nova impressão digital no emulador selecionando Configurações > Segurança > Impressão digital e seguindo as instruções de cadastro.

2. Configure seu app para aceitar a autenticação por impressão digital. Quando essa configuração é concluída, o dispositivo exibe a tela de autenticação de impressão digital.

3. Enquanto o app estiver exibindo a tela de autenticação de impressão digital, vá para o console e insira o comando finger touch e o ID de impressão digital que você criou. Isso simula um toque do dedo.

4. Em seguida, insira o comando finger remove para simular a elevação do dedo. Seu app deve responder como se o usuário tivesse tocado e elevado o dedo do sensor de impressão digital.