Ícone do app ADB Shell - Debug ToolboxADB Shell - Debug ToolboxTerminal e ferramentas de depuração

Execute comandos ADB. Resolva problemas do dispositivo.

ADB Shell é um conjunto de ferramentas de comandos e depuração para Android. Use uma conexão ADB sem fio autorizada para executar comandos, filtrar o Logcat e acessar ferramentas de apps, arquivos e configurações de tela.

Terminal do ADB Shell com sugestões de comandos e controles de entrada

Escolha a ferramenta para a tarefa

Comandos ADB, apps, arquivos e ferramentas do dispositivo.

Use o terminal para comandos ou abra uma ferramenta específica do dispositivo.

01 / Na prática

Use comandos para investigar problemas no dispositivo.

Investigue um processo em segundo plano, transfira um arquivo ou confira um layout na tela.

01

Guarde o comando. Evite digitar de novo.

Consulte o histórico, use sugestões de comandos e caminhos e compartilhe a saída do terminal quando precisar de ajuda.

SOMENTE LEITURA · NO SHELL DO DISPOSITIVOgetprop ro.build.version.release

Lê o valor da versão do Android. Não altera configurações.

Conheça o terminal
02

Investigue o que está em execução em segundo plano.

Confira apps e processos em execução, consulte detalhes dos pacotes e acompanhe logs para investigar comportamentos inesperados.

AppsProcessosDiagnósticos
Conheça o gerenciamento de apps
03

Transfira arquivos. Controle sua TV.

Explore pastas e transfira arquivos entre dispositivos. Use teclas de controle remoto e entrada de texto para controlar um Android TV conectado.

ArquivosTransferênciasControle remoto da TV
Conheça os controles do dispositivo
04

Experimente outro layout de tela.

Ajuste a densidade, a resolução e a rotação da tela e capture o resultado. Restaure os valores ao terminar de comparar os layouts.

TelaCaptura de tela
Conheça as ferramentas de teste

Passe de um app ou processo aos seus logs, arquivos e detalhes do sistema sem sair do conjunto de ferramentas.

02 / Ferramentas disponíveis

Conheça todas as ferramentas de depuração.

Oito grupos de ferramentas cobrem comandos, gerenciamento de dispositivos e diagnóstico de problemas.

Terminal e conexões com dispositivos

Execute comandos sem precisar redigitá-los.

Abra um shell local ou conecte-se a um dispositivo Android por ADB. Reutilize o histórico, consulte sugestões de comandos, complete a entrada e alterne entre janelas de shell. Compartilhe a saída quando precisar de ajuda.

Ver um exemplo
Na prática

Conecte um celular, examine-o com um comando e reutilize esse comando pelo histórico.

Apps e processos em execução

Veja o que está instalado e o que está ativo.

Consulte apps instalados e em execução, examine detalhes dos pacotes e veja processos. Abra, desinstale, interrompa, ative ou desative apps, limpe seus dados e acesse diagnósticos dos pacotes.

Ver um exemplo
Na prática

Encontre um app pelo nome, consulte os detalhes e investigue seu processo em execução.

Arquivos locais e remotos

Transfira arquivos entre dispositivos.

Explore pastas locais e do dispositivo conectado. Envie arquivos para o destino, copie-os de volta, abra arquivos e remova itens desnecessários.

Ver um exemplo
Na prática

Transfira um arquivo do celular para um dispositivo conectado e confira a pasta de destino.

Controle remoto e ações do dispositivo

Controle o dispositivo conectado pelo celular.

Use teclas direcionais, início, voltar, menu, números e volume no Android TV. Envie texto pela ferramenta dedicada, ligue ou desligue a tela e acesse ações de reinicialização ou dados móveis.

Ver um exemplo
Na prática

Digite uma busca no Android TV pelo celular, em vez de usar o teclado da TV.

Configurações de tela

Encontre um layout adequado à sua tela.

Veja e ajuste a resolução e a densidade da tela, escolha a rotação e ajuste as margens. Restaure os valores quando quiser voltar aos padrões.

Ver um exemplo
Na prática

Experimente outra densidade de tela, compare o layout e restaure o valor original.

Capturas de tela

Mostre o resultado que quer explicar.

Capture a tela do dispositivo conectado, visualize a imagem e salve ou compartilhe. Registre o estado de um app ou o resultado de um ajuste no dispositivo.

Ver um exemplo
Na prática

Capture um problema de exibição e compartilhe a imagem com suas observações.

Monitoramento do sistema e informações do dispositivo

Relacione o problema com a atividade do dispositivo.

Acompanhe o uso de CPU e memória e consulte informações do dispositivo. Use o filtro de texto do Logcat para focar nas mensagens relevantes ao investigar um app.

Ver um exemplo
Na prática

Leia logs filtrados junto com a atividade de CPU e memória enquanto reproduz um problema.

Propriedades do sistema

Confira informações do sistema e da compilação Android.

Consulte propriedades do sistema Android e informações da compilação do dispositivo. Use esses valores para conhecer o destino e documentar sua configuração.

Ver um exemplo
Na prática

Confira uma propriedade da compilação antes de comparar o comportamento de dois dispositivos.

03 / Estabeleça a conexão

Escolha um shell local ou conecte-se por ADB.

Abra um shell local no celular ou selecione um dispositivo para conectar por ADB.

01

Shell local

Abra um terminal local e execute comandos diretamente no dispositivo que está usando.

02

Pareamento sem fio

Em dispositivos compatíveis com Android 11 ou superior, ative a depuração sem fio. Use o endereço, a porta e o código de pareamento do Android para estabelecer confiança.

03

ADB em rede

Conecte-se ao endereço ADB atual do dispositivo de destino. A porta de conexão pode ser diferente da porta de pareamento. Configurações mais antigas podem exigir ativação inicial por USB em um computador.

Consulte detalhes de pareamento e permissões nas perguntas frequentes ou siga um dos guias abaixo.

Referência de ADB sem fio do Android (em inglês)

04 / Antes de começar

Perguntas sobre ADB Shell e respostas úteis.

Precisa de ajuda com a configuração?

Falar com o suporte
O que posso fazer com ADB Shell?

Execute comandos shell, examine o Logcat, gerencie apps e arquivos, ajuste a tela e consulte diagnósticos do sistema. Conecte-se por uma conexão ADB autorizada para usar as ferramentas de gerenciamento do dispositivo.

Como evitar digitar os mesmos comandos?

Reutilize comandos do histórico e use sugestões de comandos e caminhos para digitar menos. Filtre o Logcat para encontrar mensagens relevantes e compartilhe a saída do terminal ao investigar problemas.

Posso gerenciar outro dispositivo Android?

Sim. Escolha um dispositivo acessível, ative a depuração e autorize a conexão ADB. Você pode trabalhar com outro celular, tablet ou Android TV, ou usar uma conexão ADB local compatível no próprio dispositivo.

Preciso de um computador?

É possível configurar o pareamento por depuração sem fio em dispositivos compatíveis com Android 11 ou superior. Configurações mais antigas de ADB em rede podem exigir uma conexão USB inicial com um computador. Escolha o guia adequado ao seu dispositivo.

Como funcionam o pareamento e a conexão?

O pareamento estabelece uma relação de confiança com o dispositivo. Depois, conecte-se usando o endereço ADB e a porta de conexão atuais. A porta de conexão pode ser diferente da porta de pareamento. Mantenha a depuração ativada durante o uso.

Quais permissões as ferramentas usam?

O shell local usa as permissões do app; o shell ADB conectado usa o acesso de depuração autorizado no dispositivo de destino. A autorização ADB não concede acesso root. A versão do Android, o software do dispositivo e as permissões determinam quais arquivos, configurações e ações ficam acessíveis.

Como obter ajuda com a conexão?

Envie um e-mail para support@nextaix.com com a versão do Android, a versão do app, o método de conexão e o erro exibido. Remova informações pessoais antes de compartilhar capturas de tela ou logs.

ADB Shell - Debug Toolbox

Execute comandos pelo celular.

Baixe ADB Shell no Google Play para executar comandos e usar as ferramentas do dispositivo.