Android Debug Bridge (adb)

O Android Debug Bridge (adb) é uma ferramenta de linha de comando versátil que permite a comunicação com um dispositivo. O comando adb facilita uma variedade de ações do dispositivo, como instalar e depurar apps, e fornece acesso a um shell Unix que pode ser usado para executar diversos comandos em um dispositivo. Ele é um programa cliente-servidor com três componentes:

• Um cliente, que envia comandos. O cliente é executado no computador de desenvolvimento. Você pode emitir um comando adb para invocar o cliente de um terminal de linha de comando.
• Um daemon (adbd), que executa comandos em um dispositivo. O daemon é executado como um processo em segundo plano em cada dispositivo.
• Um servidor, que gerencia a comunicação entre o cliente e o daemon. O servidor é executado como um processo em segundo plano na máquina de desenvolvimento.

adb está incluído no pacote Android SDK Platform-Tools. Você pode fazer o download desse pacote com o SDK Manager, que o instala em android_sdk/platform-tools/. Ou, se você quiser o pacote autônomo Android SDK Platform-Tools, faça o download aqui.

Para ver mais informações sobre como conectar um dispositivo para uso no adb, incluindo como usar o Connection Assistant para solucionar problemas comuns, consulte Executar apps em um dispositivo de hardware.

Como o adb funciona

Quando você inicia um cliente do adb, ele primeiro verifica se há um processo de servidor adb em execução. Se não houver, ele iniciará esse processo. Quando o servidor é iniciado, ele é vinculado à porta TCP 5037 local e escuta comandos enviados de clientes do adb. Todos os clientes do adb usam a porta 5037 para se comunicar com o servidor adb.

Em seguida, o servidor configura as conexões para todos os dispositivos em execução. Ele localiza os emuladores verificando as portas de número ímpar no intervalo de 5.555 a 5.585, o que é usado pelos primeiros 16 emuladores. Onde o servidor encontra um daemon do adb (adbd), ele configura uma conexão com a porta em questão. Observe que cada emulador usa um par de portas sequenciais: uma porta com numeração par para conexões de console e uma porta ímpar para conexões adb. Exemplo:

Emulador 1, console: 5554
Emulador 1, adb: 5555
Emulador 2, console: 5556
Emulador 2, adb: 5557
e assim por diante...

Conforme mostrado, o emulador conectado ao adb na porta 5555 é o mesmo cujo console escuta na porta 5554.

Depois que o servidor tiver configurado conexões com todos os dispositivos, você poderá usar os comandos adb para acessá-los. Como o servidor gerencia conexões com dispositivos e manipula comandos de vários clientes adb, você pode controlar qualquer dispositivo de qualquer cliente (ou de um script).

Ative a depuração do adb no seu dispositivo

Para usar o adb com um dispositivo conectado via USB, você precisa ativar a opção Depuração USB nas configurações do sistema do dispositivo, em Opções do desenvolvedor. Para usar o adb com um dispositivo conectado por Wi-Fi, consulte Conectar-se a um dispositivo por Wi-Fi.

No Android 4.2 e versões mais recentes, a tela "Opções do desenvolvedor" fica oculta por padrão. Para exibi-la, acesse Configurações > Sobre o dispositivo e toque em Número da versão sete vezes. Retorne à tela anterior para encontrar as Opções do desenvolvedor na parte inferior.

Em alguns dispositivos, a tela "Opções do desenvolvedor" pode ter uma localização ou um nome diferente.

Agora você pode conectar seu dispositivo a uma porta USB. Verifique se o dispositivo está conectado executando adb devices no diretório android_sdk/platform-tools/. Se estiver conectado, o nome do dispositivo estará listado como um “device”.

Observação: ao conectar um dispositivo com o Android 4.2.2 ou versões mais recentes, o sistema vai mostrar uma caixa de diálogo perguntando se o usuário quer aceitar uma Chave RSA que permite fazer a depuração pelo computador. Esse mecanismo de segurança protege dispositivos de usuários, porque garante que a depuração USB e outros comandos do adb só sejam executados se você conseguir desbloquear o dispositivo e confirmar a caixa de diálogo.

Para ver mais informações sobre a conexão com um dispositivo por USB, leia Executar apps em um dispositivo de hardware.

Conectar-se a um dispositivo por Wi-Fi (Android 11 ou versões mais recentes)

Observação: as instruções abaixo não se aplicam a dispositivos Wear com o Android 11. Para ver mais informações, consulte o guia sobre como depurar um app do Wear OS.

O Android 11 e versões mais recentes oferece suporte à implantação e depuração do app por Wi-Fi pela estação de trabalho usando o Android Debug Bridge (adb). Por exemplo, é possível implantar o app depurável em vários dispositivos remotos sem uma conexão física via USB. Isso elimina a necessidade de resolver problemas comuns de conexão USB, como a instalação do driver.

Antes de começar a usar a depuração por Wi-Fi, é necessário concluir estas etapas:

1. Confira se a estação de trabalho e o dispositivo estão conectados à mesma rede Wi-Fi.

2. Confira se o dispositivo está executando o Android 11 ou uma versão mais recente. Para ver mais informações, consulte Verificar e atualizar a versão do Android.

3. Confira se você tem o Android Studio Bumblebee. Você pode fazer o download dele clicando aqui.

4. Na sua estação de trabalho, instale a versão mais recente do SDK Platform-Tools.

Para usar a depuração por Wi-Fi, é necessário parear seu dispositivo à estação de trabalho usando um código QR ou de pareamento. A estação de trabalho e o dispositivo precisam estar conectados à mesma rede Wi-Fi. Para se conectar ao dispositivo, siga estas etapas:

1. Ative as Opções do desenvolvedor:

   1. No dispositivo, localize a opção Número da versão. Ela está disponível nestes locais, de acordo com seu dispositivo:

      Dispositivo	Configuração
      Google Pixel	Configurações > Sobre o dispositivo > Número da versão
      Samsung Galaxy S8 e versões mais recentes	Configurações > Sobre o dispositivo > Informações do software > Número da versão
      LG G6 e versões mais recentes	Configurações > Sobre o dispositivo > Informações do software > Número da versão
      HTC U11 e versões mais recentes	Configurações > Sobre > Informações do software > Mais > Número da versão ou Configurações > Sistema > Sobre o dispositivo > Informações do software > Mais > Número da versão
      OnePlus 5T e versões mais recentes	Configurações > Sobre o dispositivo > Número da versão

   2. Toque na opção Número da versão sete vezes até ver a mensagem You are now a developer! Isso ativa as Opções do desenvolvedor no smartphone.

2. Ative a depuração por Wi-Fi:

   1. No dispositivo, localize o item Opções do desenvolvedor. Ele está disponível nestes locais, de acordo com seu dispositivo:

      Dispositivo	Configuração
      Google Pixel, OnePlus 5T e versões mais recentes	Configurações > Sistema > Opções do desenvolvedor
      Samsung Galaxy S8, LG G6 e HTC U11 e versões mais recentes de cada um deles	Configurações > Opções do desenvolvedor

   2. Em Opções do desenvolvedor, role para baixo até a seção Depuração e ative a Depuração por Wi-Fi. No pop-up Permitir a depuração por Wi-Fi nesta rede?, selecione Permitir.

3. Abra o Android Studio e selecione Pair Devices Using Wi-Fi no menu suspenso de configurações de execução.

   

   Figura 1. Menu suspenso de configurações de execução.

   A janela Pair devices over Wi-Fi será aberta, como mostrado abaixo.

   

   Figura 2. Janela pop-up de pareamento de dispositivos por código QR ou código de pareamento.

4. No dispositivo, toque em Depuração por Wi-Fi e faça o pareamento:

   

   Figura 3. Captura de tela da configuração de depuração por Wi-Fi em um smartphone Google Pixel.

   1. Se quiser parear o dispositivo com um código QR, selecione Parear o dispositivo com um código QR e leia o código mostrado na janela pop-up Pair devices over Wi-Fi descrita acima.

   2. Se quiser parear o dispositivo com um código de pareamento, selecione Parear o dispositivo com um código de pareamento na janela pop-up Pair devices over Wi-Fi descrita acima. No dispositivo, selecione Parear usando o código de pareamento e salve o código PIN de seis dígitos. Quando o dispositivo aparecer na janela Pair devices over Wi-Fi, selecione Pair e digite o código PIN de seis dígitos mostrado no dispositivo.

      

      Figura 4. Exemplo de entrada do código PIN de seis dígitos.

5. Após o pareamento, você pode tentar implantar o app no dispositivo.

   Se quiser parear um dispositivo diferente ou remover o seu da estação de trabalho, acesse Depuração por Wi-Fi no dispositivo, toque no nome da estação em Dispositivos pareados e selecione Esquecer.

6. Se quiser ativar ou desativar rapidamente a depuração por Wi-Fi, use os blocos de desenvolvedor para as Configurações rápidas da Depuração por Wi-Fi, encontrados em Opções do desenvolvedor > Blocos de desenvolvedor para configurações rápidas.

   

   Figura 5. Com a configuração Blocos de desenvolvedor para configurações rápidas, é possível ativar e desativar rapidamente a depuração por Wi-Fi.

   Para se conectar ao dispositivo por linha de comando sem usar o Android Studio, siga estas etapas:

   1. Ative as Opções do desenvolvedor no seu dispositivo, conforme descrito acima.

   2. Ative a Depuração por Wi-Fi no seu dispositivo, conforme descrito acima.

   3. Na estação de trabalho, abra uma janela do terminal e navegue até android_sdk/platform-tools.

   4. Encontre seu endereço IP, o número da porta e o código de pareamento selecionando Parear o dispositivo com um código de pareamento. Salve o endereço IP, o número da porta e o código de pareamento mostrados no dispositivo.

   5. No terminal da estação de trabalho, execute o adb pair ipaddr:port. Use o endereço IP e o número da porta das etapas acima.

   6. Quando solicitado, digite o código de pareamento, conforme mostrado abaixo.

      

      Figura 6. Uma mensagem indica que o pareamento do dispositivo foi concluído.

Resolver problemas de conexão sem fio

Se você estiver com problemas para conectar o dispositivo sem usar fios, tente seguir as etapas de solução de problemas abaixo.

Conferir se a estação de trabalho e o dispositivo atendem aos pré-requisitos

Para atender aos pré-requisitos da depuração por Wi-Fi, confira se:

1. a estação de trabalho e o dispositivo estão conectados à mesma rede Wi-Fi;

2. seu dispositivo tem o Android 11 ou uma versão mais recente. Para ver mais informações, consulte Verificar e atualizar a versão do Android;

3. você tem o Android Studio Bumblebee. Você pode fazer o download dele clicando aqui;

4. você tem a versão mais recente do SDK Platform-Tools na estação de trabalho.

Conferir se há outros problemas conhecidos

Veja a seguir uma lista dos problemas conhecidos atuais da depuração por Wi-Fi no Android Studio e como eles podem ser resolvidos.

1. O Wi-Fi não conecta: algumas redes Wi-Fi, como as corporativas, podem bloquear conexões P2P e não permitir que você se conecte por Wi-Fi. Tente conectar o dispositivo com um cabo ou a outra rede Wi-Fi.

2. Às vezes, o adb por Wi-Fi é desativado automaticamente: isso pode acontecer se o dispositivo alternar entre redes Wi-Fi ou se desconectar da rede.

Conectar-se a um dispositivo por Wi-Fi (Android 10 e versões anteriores)

Observação: as instruções abaixo não se aplicam a dispositivos Wear com o Android 10 (ou versões anteriores). Para ver mais informações, consulte o guia sobre como depurar um app do Wear OS.

O adb geralmente se comunica com o dispositivo por USB, mas você também pode usar o adb via Wi-Fi. Para se conectar a um dispositivo com o Android 10 ou uma versão anterior por USB, há algumas etapas iniciais que você precisa seguir, conforme descrito abaixo:

1. Conecte o dispositivo Android e o computador host do adb a uma rede Wi-Fi comum acessível a ambos os dispositivos. Esteja ciente de que nem todos os pontos de acesso são adequados: pode ser necessário usar um ponto de acesso cujo firewall esteja corretamente configurado para que haja compatibilidade com adb.
2. Se você estiver se conectando a um dispositivo Wear OS, desative o Bluetooth no smartphone que está pareado com o dispositivo.
3. Conecte o dispositivo ao computador host usando um cabo USB.
4. Configure o dispositivo de destino para detectar uma conexão TCP/IP na porta 5555.

   adb tcpip 5555
   

5. Desconecte a porta USB do dispositivo de destino.
6. Encontre o endereço IP do dispositivo Android. Por exemplo, em um dispositivo Nexus, você pode encontrar o endereço IP em Configurações > Sobre o tablet (ou Sobre o dispositivo) > Status > Endereço IP. Ou, em um dispositivo Wear OS, você pode encontrar o endereço IP em Configurações > Configurações de Wi-Fi > Avançado > Endereço IP.
7. Conecte-se ao dispositivo pelo endereço IP.

   adb connect device_ip_address:5555
   

8. Confirme se seu computador host está conectado ao dispositivo de destino:

   $ adb devices
   List of devices attached
   device_ip_address:5555 device
   

Pronto!

Se você perder a conexão com o adb:

1. Verifique se o host ainda está conectado à mesma rede Wi-Fi que o dispositivo Android.
2. Execute o comando adb connect novamente para reconectar.
3. Se isso não funcionar, redefina o host do adb:

   adb kill-server
   

   Em seguida, reinicie o processo.

Consultar dispositivos

Antes de emitir comandos do adb, é útil saber quais instâncias do dispositivo estão conectadas ao servidor adb. Para gerar uma lista de dispositivos conectados, use o comando devices:

  adb devices -l
  

Em resposta, o adb exibe as seguintes informações de status para cada dispositivo:

• Número de série: uma string criada pelo adb para identificar exclusivamente o dispositivo pelo número da porta. Veja um exemplo de número de série: emulator-5554
• Estado: o estado da conexão do dispositivo pode ser um dos seguintes:
  • offline: o dispositivo não está conectado ao adb ou não está respondendo.
  • device: o dispositivo está conectado ao servidor adb. Observe que esse estado não implica que o sistema Android esteja totalmente inicializado e operacional, porque o dispositivo se conecta ao adb enquanto o sistema ainda está sendo inicializado. No entanto, após a inicialização, esse é o estado operacional normal de um dispositivo.
  • no device: não há dispositivos conectados.
• Descrição: se você incluir a opção -l, o comando devices informará qual é o dispositivo. Essa informação é útil quando há vários dispositivos conectados para que você possa diferenciá-los.

O exemplo a seguir mostra o comando devices e a saída dele. Existem três dispositivos em execução. As duas primeiras linhas da lista são emuladores e a terceira linha é um dispositivo de hardware conectado ao computador.

$ adb devices
List of devices attached
emulator-5556 device product:sdk_google_phone_x86_64 model:Android_SDK_built_for_x86_64 device:generic_x86_64
emulator-5554 device product:sdk_google_phone_x86 model:Android_SDK_built_for_x86 device:generic_x86
0a388e93      device usb:1-1 product:razor model:Nexus_7 device:flo

Emulador não listado

O comando adb devices tem uma sequência de comando de caso isolado que faz com que o emulador em execução não apareça na saída de adb devices mesmo que os emuladores estejam visíveis na sua área de trabalho. Isso acontece quando todas estas condições são verdadeiras:

1. O servidor adb não está em execução.
2. Você usa o comando emulator com a opção -port ou -ports com um valor de porta ímpar entre 5554 e 5584.
3. A porta de numeração ímpar escolhida não está ocupada, portanto, a conexão pode ser feita no número de porta especificado ou, se está ocupada, o emulador alterna para outra porta que atende aos requisitos de 2 e
4. Você inicia o servidor adb depois de iniciar o emulador.

Uma maneira de evitar essa situação é deixar o emulador escolher as próprias portas e não executar mais de 16 emuladores de uma só vez. Outra maneira é sempre iniciar o servidor adb antes de usar o comando emulator, conforme explicado nos exemplos a seguir.

Exemplo 1: na sequência de comandos a seguir, o comando adb devices inicia o servidor adb, mas a lista de dispositivos não é exibida.

Pare o servidor adb e insira os comandos a seguir na ordem mostrada. Para o nome do avd, forneça um nome de avd válido do seu sistema. Para ver uma lista de nomes de avd, digite emulator -list-avds. O comando emulator está no diretório android_sdk/tools.

$ adb kill-server
$ emulator -avd Nexus_6_API_25 -port 5555
$ adb devices

List of devices attached
* daemon not running. starting it now on port 5037 *
* daemon started successfully *

Exemplo 2: na sequência de comandos a seguir, adb devices exibe a lista de dispositivos porque o servidor adb foi iniciado primeiro.

Para ver o emulador na saída adb devices, pare o servidor adb e reinicie-o depois de usar o comando emulator e antes de usar o comando adb devices, como mostrado a seguir:

$ adb kill-server
$ emulator -avd Nexus_6_API_25 -port 5557
$ adb start-server
$ adb devices

List of devices attached
emulator-5557 device

Para ver mais informações sobre as opções de linha de comando do emulador, consulte Como usar os parâmetros da linha de comando.

Enviar comandos a um dispositivo específico

Se vários dispositivos estiverem em execução, você precisará especificar o dispositivo de destino ao emitir o comando adb. Para especificar o destino, use o comando devices e veja o número de série do destino. Com o número de série em mãos, use a opção -s com os comandos adb para especificar o número de série. Se você for emitir muitos comandos adb, defina a variável de ambiente $ANDROID_SERIAL para conter o número de série. Se você usar -s e $ANDROID_SERIAL, -s modificará $ANDROID_SERIAL.

No exemplo a seguir, a lista de dispositivos conectados é acessada e, em seguida, o número de série de um dos dispositivos é usado para instalar o helloWorld.apk no dispositivo.

$ adb devices
List of devices attached
emulator-5554 device
emulator-5555 device

$ adb -s emulator-5555 install helloWorld.apk

Observação: se você emitir um comando sem especificar um dispositivo de destino quando vários dispositivos estiverem disponíveis, o adb vai gerar um erro.

Se você tiver vários dispositivos disponíveis, mas apenas um for um emulador, use a opção -e para enviar comandos ao emulador. Da mesma forma, se houver vários dispositivos, mas apenas um dispositivo de hardware anexado, use a opção -d para enviar comandos ao dispositivo de hardware.

Instalar um app

Você pode usar o adb para instalar um APK em um emulador ou dispositivo conectado com o comando install:

adb install path_to_apk

Use a opção -t com o comando install ao instalar um APK de teste. Para ver mais informações, consulte -t.

Para ver mais informações sobre a criação de um arquivo de APK que possa ser instalado em uma instância de emulador/dispositivo, consulte Criar e executar o app.

Observe que, se você estiver usando o Android Studio, não precisará usar o adb diretamente para instalar seu app no emulador/dispositivo. Em vez disso, o Android Studio realizará o empacotamento e a instalação do app para você.

Configurar o encaminhamento de portas

Você pode usar o comando forward para configurar o encaminhamento de portas arbitrário, que encaminha solicitações em uma porta de host específica para uma porta diferente em um dispositivo. O exemplo a seguir configura o encaminhamento da porta de host 6100 para a porta de dispositivo 7100:

adb forward tcp:6100 tcp:7100

O exemplo a seguir configura o encaminhamento da porta de host 6100 para local:logd:

adb forward tcp:6100 local:logd

Copiar arquivos de/para um dispositivo

Use os comandos pull e push para copiar arquivos de e para um dispositivo. Diferentemente do comando install, que apenas copia um arquivo de APK para um local específico, os comandos pull e push permitem copiar diretórios e arquivos arbitrários para qualquer local em um dispositivo.

Para copiar um arquivo ou diretório e os subdiretórios dele do dispositivo, faça o seguinte:

adb pull remote local

Para copiar um arquivo ou diretório e os subdiretórios dele para o dispositivo, faça o seguinte:

adb push local remote

Substitua local e remote pelos caminhos para o diretório/os arquivos de destino na máquina de desenvolvimento (local) e no dispositivo (remoto). Exemplo:

adb push foo.txt /sdcard/foo.txt

Interromper o servidor adb

Em alguns casos, é preciso encerrar o processo do servidor adb e reiniciá-lo para solucionar um problema (por exemplo, se o adb não responder a um comando).

Para interromper o servidor adb, use o comando adb kill-server. Em seguida, é possível emitir qualquer outro comando do adb para reiniciar o servidor.

Como emitir comandos adb

É possível emitir comandos do adb a partir de uma linha de comando no seu computador de desenvolvimento ou a partir de um script. O uso é o seguinte:

adb [-d | -e | -s serial_number] command

Se houver apenas um emulador em execução ou um dispositivo conectado, o comando do adb será enviado para esse dispositivo por padrão. Se houver vários emuladores em execução e/ou vários dispositivos conectados, será necessário usar a opção -d, -e ou -s para especificar o dispositivo de destino ao qual o comando será direcionado.

Veja uma lista detalhada de todos os comandos adb compatíveis usando o seguinte comando:

adb --help

Emitir comandos do shell

Você pode usar o comando shell para emitir comandos do dispositivo pelo adb ou para iniciar um shell interativo. Para emitir um único comando, use o comando shell da seguinte maneira:

adb [-d |-e | -s serial_number] shell shell_command

Para iniciar um shell interativo em um dispositivo, use o comando shell desta forma:

adb [-d | -e | -s serial_number] shell

Para sair de um shell interativo, pressione Control + D ou digite exit.

Observação: com as Android Platform-Tools 23 ou versões mais recentes, o adb processa argumentos da mesma forma que o comando ssh(1). Essa mudança corrigiu muitos problemas com a injeção de comando e tornou possível executar com segurança comandos que contêm metacaracteres de shell (links em inglês), como adb install Let\'sGo.apk. No entanto, essa mudança significa que a interpretação de qualquer comando que contenha metacaracteres de shell também mudou. Por exemplo, o comando adb shell setprop foo 'a b' agora é um erro porque as aspas simples (') são omitidas pelo shell local, e o dispositivo vê adb shell setprop foo a b. Para que o comando funcione, coloque duas aspas, uma para o shell local e outra para o shell remoto, o mesmo que é feito para ssh(1). Por exemplo, adb shell setprop foo "'a b'".

O Android fornece a maioria das ferramentas de linha de comando Unix comuns. Para ver uma lista de ferramentas disponíveis, use o seguinte comando:

adb shell ls /system/bin

Há ajuda disponível para a maioria dos comandos por meio do argumento --help. Muitos dos comandos do shell são fornecidos pelo toybox. Há uma ajuda geral aplicável a todos os comandos do toybox disponível em toybox --help.

Consulte também a Ferramenta de linha de comando Logcat, que é útil para monitorar o registro do sistema.

Chamar o gerenciador de atividades (am)

Em um shell do adb, é possível emitir comandos com a ferramenta gerenciador de atividades (am) para executar diversas ações do sistema, como iniciar uma atividade, forçar a parada de um processo, transmitir uma intent, modificar as propriedades da tela do dispositivo e muito mais. Em um shell, a sintaxe é a seguinte:

am command

Também é possível emitir um comando do gerenciador de atividades diretamente do adb sem entrar em um shell remoto. Exemplo:

adb shell am start -a android.intent.action.VIEW

Tabela 2. Comandos disponíveis do gerenciador de atividades

Especificação para argumentos de intent

Para comandos do gerenciador de atividades que incluem um argumento de intent, você pode especificar a intent com as seguintes opções:

Chamar o gerenciador de pacotes (pm)

Em um shell do adb, você pode emitir comandos com a ferramenta gerenciador de pacotes (pm) para executar ações e consultas em pacotes de apps instalados no dispositivo. Em um shell, a sintaxe é a seguinte:

pm command

Você também pode emitir um comando do gerenciador de pacotes diretamente do adb sem entrar em um shell remoto. Exemplo:

adb shell pm uninstall com.example.MyApp

Tabela 3. Comandos disponíveis do gerenciador de pacotes.

Chamar o gerenciador de políticas do dispositivo (dpm)

Para ajudar você a desenvolver e testar seus apps de gerenciamento de dispositivos (ou outros apps empresariais), você pode emitir comandos para a ferramenta do gerenciador de políticas de dispositivo (dpm). Use a ferramenta para controlar o app de administração ativo ou mudar os dados de status de uma política no dispositivo. Em um shell, a sintaxe é a seguinte:

dpm command

Você também pode emitir um comando do gerenciador de políticas de dispositivo diretamente do adb sem inserir um shell remoto:

adb shell dpm command

Tabela 4. Comandos disponíveis do gerenciador de políticas de dispositivos

Fazer uma captura de tela

O comando screencap é um utilitário do shell para fazer uma captura de tela de um dispositivo. Em um shell, a sintaxe é a seguinte:

screencap filename

Para usar o screencap na linha de comando, digite o seguinte:

adb shell screencap /sdcard/screen.png

Este é um exemplo de uma sessão de captura de tela usando o shell do adb para fazer a captura e o comando pull para fazer o download do arquivo do dispositivo:

$ adb shell
shell@ $ screencap /sdcard/screen.png
shell@ $ exit
$ adb pull /sdcard/screen.png

Gravar um vídeo

O comando screenrecord é um utilitário de shell para gravar a tela de dispositivos com Android 4.4 (nível 19 da API) e versões mais recentes. O utilitário grava as atividades na tela em um arquivo MPEG-4. Você pode usar esse arquivo para criar vídeos promocionais ou de treinamento ou para depuração e teste.

Em um shell, use a seguinte sintaxe:

screenrecord [options] filename

Para usar screenrecord na linha de comando, digite o seguinte:

adb shell screenrecord /sdcard/demo.mp4

Para interromper a gravação da tela, pressione Control + C (Command + C no Mac). Caso contrário, a gravação será interrompida automaticamente em três minutos ou no limite de tempo definido por --time-limit.

Para começar a gravar a tela do seu dispositivo, execute o comando screenrecord para gravar o vídeo. Em seguida, execute o comando pull para fazer o download do vídeo do dispositivo para o computador host. Veja um exemplo de sessão de gravação:

$ adb shell
shell@ $ screenrecord --verbose /sdcard/demo.mp4
(press Control + C to stop)
shell@ $ exit
$ adb pull /sdcard/demo.mp4

O utilitário screenrecord pode gravar em qualquer resolução e taxa de bits compatível que você solicitar, mantendo a proporção da tela do dispositivo. O utilitário grava na resolução e orientação nativa da tela por padrão, com uma duração máxima de três minutos.

Limitações do utilitário screenrecord:

• O áudio não é gravado nesse arquivo de vídeo.
• A gravação de vídeo não está disponível para dispositivos que executam Wear OS.
• Alguns dispositivos podem não conseguir gravar na resolução nativa das respectivas telas. Se tiver problemas ao gravar a tela, tente usar uma resolução menor.
• Não é possível girar a tela durante a gravação. Se isso acontecer, parte da tela será cortada na gravação.

Tabela 5. Opções screenrecord

screenrecord --bit-rate 6000000 /sdcard/demo.mp4

Ler perfis do ART para apps

A partir do Android 7.0 (nível da API 24), o Android Runtime (ART) coleta perfis de execução dos apps instalados, que são usados para otimizar o desempenho do app. É recomendável verificar os perfis coletados para entender quais métodos são executados com mais frequência e quais classes são usadas durante a inicialização do app.

Para produzir as informações de perfil em forma de texto, use o seguinte comando:

adb shell cmd package dump-profiles package

Para recuperar o arquivo produzido, use este comando:

adb pull /data/misc/profman/package.txt

Redefinir dispositivos de teste

Se você testa seu app em vários dispositivos de teste, pode ser útil redefinir seu dispositivo entre os testes, por exemplo, para remover dados do usuário e redefinir o ambiente de teste. Você pode executar uma redefinição para a configuração original de um dispositivo de teste com o Android 10 (nível 29 da API) ou versões mais recentes usando o comando testharness do shell adb, conforme mostrado abaixo.

adb shell cmd testharness enable

Ao restaurar o dispositivo usando testharness, ele faz backup automaticamente da Chave RSA que permite a depuração na estação de trabalho atual em um local persistente. Ou seja, depois que o dispositivo é redefinido, a estação de trabalho pode continuar depurando e emitindo comandos adb para o dispositivo sem registrar uma nova chave manualmente.

Além disso, para ajudar a tornar mais fácil e segura a ação de continuar testando seu app, o uso de testharness para restaurar um dispositivo também muda as seguintes configurações:

• O dispositivo define determinadas configurações do sistema para que os assistentes de configuração inicial do dispositivo não apareçam. Ou seja, o dispositivo entra em um estado em que você pode instalar, depurar e testar rapidamente seu app.
• Configurações:
  • Desativa a tela de bloqueio
  • Desativa os alertas de emergência
  • Desativa a sincronização automática para contas
  • Desativa as atualizações automáticas do sistema
• Outro:
  • Desativa apps de segurança pré-instalados

Se o app precisa detectar e se adaptar às configurações padrão do comando testharness, use ActivityManager.isRunningInUserTestHarness().

sqlite

sqlite3 inicia o programa da linha de comando sqlite para examinar bancos de dados. Inclui comandos como .dump para exibir o conteúdo de uma tabela e .schema para exibir a instrução SQL CREATE de uma tabela existente. Você também pode executar comandos SQLite na linha de comando, como mostrado abaixo.

$ adb -s emulator-5554 shell
$ sqlite3 /data/data/com.example.app/databases/rssitems.db
SQLite version 3.3.12
Enter ".help" for instructions

Para mais informações, consulte a documentação da linha de comando sqlite3 (link em inglês).