Uma reimplementação em TypeScript do cliente ADB que roda em navegadores Chromium, Node.js e Electron e se conecta a dispositivos Android via WebUSB.
mzlogin/awesome-adb
Referência bilíngue abrangente de comandos do Android Debug Bridge (adb) para instalar apps, gerenciar arquivos, consultar logs e obter informações do dispositivo.
- Estrelas
- 12,528
- Forks
- 2,288
- Issues abertas
- 52
- Último commit
- mês passado
O que é?
awesome-adb é uma referência organizada por categorias de comandos do Android Debug Bridge (adb). Ela aborda situações comuns para desenvolvedores Android, testadores e entusiastas de dispositivos: conectar aparelhos por USB ou Wi-Fi, instalar e desinstalar APKs, listar e desativar pacotes, limpar dados de apps e iniciar activities ou services com as ferramentas am e pm.
Além de conexão e gerenciamento de apps, o documento explica como enviar e baixar arquivos, simular pressionamentos de teclas e entrada de texto com o comando input, filtrar a saída do logcat por nível e tag e consultar propriedades de hardware e do sistema, como modelo, bateria, densidade da tela, CPU e memória. Também lista códigos comuns de erro na instalação de APKs, seus significados e possíveis soluções, além de observações sobre comandos que exigem root e comportamentos que variam conforme a versão, entre diferentes versões do Android e ROMs customizadas.
O conteúdo é mantido em um documento Markdown com sumário, e há um link para a versão em inglês no README.
Recursos principais
- 01Abrange conexões de dispositivos por USB e Wi-Fi, incluindo a depuração sem fio do Android 11+.
- 02Lista comandos de instalação e desinstalação, com uma tabela de códigos comuns de erro INSTALL_FAILED e suas soluções.
- 03Mostra como consultar, ativar, desativar e limpar pacotes de apps com pm.
- 04Documenta como iniciar activities, services e broadcasts com am, incluindo ações comuns de broadcasts do sistema.
- 05Explica como simular eventos de tecla e entrada de texto com o comando input, com uma referência de keycodes.
- 06Descreve como filtrar a saída do logcat por nível e tag, além de consultar propriedades de hardware e do sistema do dispositivo.
Casos de uso
- Instalar, atualizar ou depurar um APK em um dispositivo físico ou emulador.
- Encontrar o comando adb para uma tarefa específica sem ter que pesquisar em fontes dispersas.
- Diagnosticar uma falha na instalação de APK relacionando o código de erro à solução sugerida.
- Criar scripts de automação de dispositivos, como enviar eventos de tecla ou disparar broadcasts para testes.
Início rápido
- 1
Conecte seu dispositivo Android por USB e verifique se ele foi detectado
adb devices - 2
Instale um app a partir de um arquivo APK
adb install <path_to_apk> - 3
Liste os apps de terceiros instalados
adb shell pm list packages -3
Antes de usar
- Este é um documento de referência de comandos, não uma ferramenta de software, portanto não há nenhum programa instalável.
- Alguns comandos dependem da versão do Android e da ROM personalizada do dispositivo.
Em coleções
Tópicos
Perguntas frequentes
- O que é awesome-adb?
- Referência bilíngue abrangente de comandos do Android Debug Bridge (adb) para instalar apps, gerenciar arquivos, consultar logs e obter informações do dispositivo. awesome-adb é uma referência organizada por categorias de comandos do Android Debug Bridge (adb). Ela aborda situações comuns para desenvolvedores Android, testadores e entusiastas de dispositivos: conectar aparelhos por USB ou Wi-Fi, instalar e desinstalar APKs, listar e desativar pacotes, limpar dados de apps e iniciar activities ou services com as ferramentas am e pm.
- awesome-adb é gratuito? Qual é a licença?
- awesome-adb é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- awesome-adb ainda é mantido?
- Atualizado nos últimos 6 meses. O último commit de awesome-adb foi em 29 de set. de 2026.
- Para que posso usar awesome-adb?
- Instalar, atualizar ou depurar um APK em um dispositivo físico ou emulador. Encontrar o comando adb para uma tarefa específica sem ter que pesquisar em fontes dispersas. Diagnosticar uma falha na instalação de APK relacionando o código de erro à solução sugerida. Criar scripts de automação de dispositivos, como enviar eventos de tecla ou disparar broadcasts para testes.
- Como instalar awesome-adb?
- Conecte seu dispositivo Android por USB e verifique se ele foi detectado: adb devices Instale um app a partir de um arquivo APK: adb install <path_to_apk> Liste os apps de terceiros instalados: adb shell pm list packages -3
- Onde consigo awesome-adb?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/mzlogin/awesome-adb
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Aplicativo web auto-hospedado para visualizar, controlar e gerenciar remotamente dispositivos Android (e, experimentalmente, iOS) pelo navegador.
Referência pesquisável com mais de 600 comandos Linux, manuais, explicações e notas de aprendizado, publicada como site e pacote npm.
Cliente e servidor WebSocket de linha de comando, como netcat, curl e socat para conexões ws:// e wss://.
Espelha e controla dispositivos Android pelo computador via USB ou TCP/IP, sem root nem app instalado no dispositivo.
Cliente desktop baseado em Qt para exibir e controlar dispositivos Android por USB ou Wi-Fi, sem root nem instalação no dispositivo.