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 está sendo 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. A mensagem OK no console indica que ele está pronto para aceitar comandos. Não há um prompt típico.

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

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 Nexus_5X_API_23: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, acesse Consultar dispositivos.

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

Depois que o console mostrar a mensagem 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 criará 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.

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.

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

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

Referência de comando do emulador

A tabela a seguir descreve os comandos do console do emulador com os parâmetros e valores relacionados:

Tabela 1. Comandos do console do emulador.

Comandos gerais	Descrição
`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 `name`. `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 de tela se ele for dobrável e estiver aberto no momento.
`unfold`	Desdobra o dispositivo para mostrar a maior configuração de 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	Descrição
`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	Descrição
`debug tags ...`	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	Descrição
`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`: o número da porta a ser aberta no host. `guest-port`: o 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`: o número da porta a ser aberta no host.
Localização geográfica	Descrição
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 `longitude` e `latitude` em graus decimais. Use um número de 1 a 12 para especificar a quantidade de `satellites` a ser usada para determinar a posição e especifique a `altitude` em metros e a `velocity` 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. Inicie `sentence` 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	Descrição
`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. 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.
`event codes type`	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 opcionais e valores de código. Para descobrir exatamente que evento enviar, você pode usar o comando `adb` enquanto pressiona manualmente os botões no emulador. Estes são os eventos gerados quando você pressiona o botão liga/desliga: 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 Por exemplo, para simular a ação de pressionar o botão liga/desliga e manter pressionado, envie dois eventos `EV_KEY` para keydown e keyup: event send EV_KEY:KEY_POWER:0 OK event send EV_KEY:KEY_POWER:1 OK
`event text message`	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	Descrição
`power display`	Mostra o estado da bateria e do carregador.
`power ac {on\|off}`	Define o estado de carregamento CA como `on` ou `off`.
`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 restante da bateria como uma porcentagem de 0 a 100.
Status da conexão de rede	Descrição
`network status`	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 `latency` da rede é um dos seguintes. Os números estão em milissegundos: Formatos 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 `latency` compatível, conforme mencionado abaixo na lista Formatos de latência de rede. Estes são alguns 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 `netdelay` com um valor de `latency` compatível da lista Formatos de latência de rede acima. 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 de `speed` 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 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, use a opção de emulador `-netspeed` com um valor de `speed` compatível, como na lista Formatos de velocidade da rede acima. Estes são alguns 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` com um valor de `speed` compatível da lista Formatos de velocidade da rede acima. 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: `start file`: começa a enviar pacotes para o arquivo especificado. `stop file`: para de enviar pacotes para o arquivo especificado.
Emulação de telefonia	Descrição
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 ligações recebidas, 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 `phonenumber`. `accept`: aceita uma ligação recebida de `phonenumber` e muda o estado dela para `active`. Você só pode mudar um estado de ligação para `active` quando o estado atual é `waiting` ou `held`. `cancel`: encerra uma ligação recebida de ou realizada para `phonenumber`. `busy`: encerra uma ligação realizada para `phonenumber` e muda o estado dela para `busy`. Só é possível mudar um estado de ligação para `busy` quando o atual é `waiting`.
`gsm {data\|voice} state`	O comando `data state` muda o estado da conexão de dados GPRS, e o `data voice state` 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 de 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 ligação para `hold`. Você só pode mudar um estado de ligação para `hold` quando o atual é `active` ou `waiting`.
`gsm list`	Lista todas as ligação recebidas ou feitas, assim como os estados delas.
`gsm status`	Informa o estado atual de voz/dados GSM. Os valores são aqueles descritos para os comandos `voice` e `data`.
`gsm signal {rssi\|ber}`	Muda a intensidade do sinal relatado (rssi) e a taxa de erros de bit (ber) nos 15 segundos seguintes de atualização. A lista a seguir descreve os parâmetros e valores relacionados: O intervalo de `rssi` é de 0 a 31, e 99 para desconhecido. O intervalo de `ber` é 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, na sigla em inglês). 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	Descrição
Esses comandos se referem aos sensores que estão disponíveis no AVD. Além de usar o comando `sensor`, você pode consultar e ajustar as configurações no emulador na tela Virtual sensors, nas guias Accelerometer e Additional sensors.
`sensor status`	Lista todos os sensores e os status deles. Este é um exemplo de saída para o comando `sensor status`:
`sensor get sensor-name`	Recebe 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 `acceleration` separados por dois-pontos (:) se referem às coordenadas x, y e z dos sensores virtuais.
`sensor set sensor-name value-x:value-y:value-z`	Define os valores de `sensor-name`. O exemplo a seguir define o sensor de aceleração com os seguintes valores de x, y e z separados por dois pontos. sensor set acceleration 2.23517e-07:9.77631:0.812348
Emulação de SMS	Descrição
`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 "hi there" 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	Descrição
`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.

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

Figura 1. Tela de autenticação de impressão digital.

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

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

Se você ainda não tem um ID de impressão digital, cadastre uma nova impressão digital no emulador selecionando Settings > Security > Fingerprint e seguindo as instruções de cadastro.
Configure seu app para aceitar a autenticação de impressão digital. Quando essa configuração é concluída, o dispositivo exibe a tela de autenticação de impressão digital.
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.
Em seguida, insira o comando finger remove para simular a elevação do dedo.
Seu app responderá como se o usuário tivesse tocado e elevado o dedo do sensor de impressão digital.