Como instalar um APK com adb pelo computador

Quando o adb é a melhor ferramenta

Instalar pelo computador evita totalmente o instalador do celular, mostra o código de erro real quando algo falha, lida com pacotes divididos sem app de terceiros e é a única forma de instalar em TV boxes Android sem gerenciador de arquivos.

Preparação

1. Obtenha as platform tools: brew install --cask android-platform-tools no macOS, sudo apt install adb no Debian e Ubuntu, ou baixe o SDK Platform-Tools do Google para Windows e descompacte.
2. No celular, ative as opções do desenvolvedor tocando sete vezes em Número da versão em Configurações › Sobre o telefone, e ligue a Depuração USB.
3. Conecte o cabo, execute adb devices e aceite o aviso no celular. O aparelho deve aparecer como device, não unauthorized.

Sem fio: Android 11 e posteriores têm Depuração sem fio nas opções do desenvolvedor, com código de pareamento; adb pair <ip:porta> e depois adb connect <ip:porta>.

Comandos

Downgrades

adb install -r -d app.apk permite um código de versão menor apenas em builds depuráveis; em um app normal a flag -d é ignorada e a instalação falha com INSTALL_FAILED_VERSION_DOWNGRADE. Desinstale antes, como descrito em como voltar a uma versão antiga.

Ler os erros

O adb informa o motivo, diferente do instalador do celular: INSTALL_FAILED_UPDATE_INCOMPATIBLE é incompatibilidade de assinatura, INSTALL_FAILED_NO_MATCHING_ABIS significa que o pacote não tem código nativo para sua CPU, INSTALL_FAILED_OLDER_SDK significa que o app precisa de um Android mais novo, INSTALL_FAILED_MISSING_SPLIT significa que você instalou sozinho o APK base de um pacote.

Dados OBB

O adb não coloca arquivos de expansão. Copie-os com adb push main.1234.com.example.obb /sdcard/Android/obb/com.example/.