adb dispositivo offline: causas e como resolver

O adb devices mostra o seu celular, mas com a palavra offline no lugar de device:

List of devices attached
R58M123ABC	offline

Offline significa que o servidor adb enxerga o celular, mas os dois lados não conseguiram terminar o handshake do ADB, ou a conexão caiu. Comandos como adb shell ou adb install falham com error: device offline. Veja as causas, da mais comum para a menos comum.

1. Reinicie o servidor adb

Um servidor travado é a causa mais frequente, principalmente depois que o celular entrou em repouso, reiniciou ou trocou de modo USB.

adb kill-server
adb start-server
adb devices

Tire o cabo e conecte de novo depois de reiniciar o servidor.

2. Desbloqueie o celular e procure um aviso

Na primeira conexão com um computador, o celular mostra Permitir a depuração USB?. Enquanto o aviso espera por você, algumas versões do adb mostram offline em vez de unauthorized. Desbloqueie a tela e toque em Permitir. Se nenhum aviso aparecer, vá em Opções do desenvolvedor, toque em Revogar autorizações de depuração USB, desligue e ligue a Depuração USB e reconecte.

3. Atualize o platform-tools

Um cliente adb antigo pode falhar no handshake com uma versão mais nova do Android e mostrar offline. Confira sua versão:

adb version

Se ela tiver vários anos, baixe o Android SDK platform-tools mais recente do Google e confira se o seu PATH não aponta ainda para uma cópia antiga (Android Studio, Genymotion e alguns programas de gerenciamento de celular trazem o próprio adb).

4. Dois programas brigando pelo celular

Android Studio, scrcpy, apps de gerenciamento de celular, emuladores e programas de PC das fabricantes podem iniciar cada um o seu servidor adb. Versões diferentes do servidor ficam reiniciando umas às outras e o celular vira offline. Feche as outras ferramentas e reinicie o servidor como no passo 1. Mais detalhes em como resolver dispositivo ocupado ou não autorizado.

5. Cabo, porta e modo USB

• Teste outro cabo que você sabe que transmite dados, numa porta USB direto no computador, não num hub.
• Em alguns celulares, trocar o modo USB de Somente carregamento para Transferência de arquivos na notificação do USB ajuda a conexão a se estabilizar.

6. Pelo Wi-Fi: a conexão caiu

Um celular conectado com adb connect fica offline quando o Wi-Fi entra em repouso, o IP muda ou a Depuração por Wi-Fi se desliga.

adb disconnect 192.168.1.20:5555
adb connect 192.168.1.20:5555

Se isso falhar com Connection refused, o modo de rede está desligado. Veja como resolver Connection refused.

7. Reinicie o celular

Quando nada mais funcionar, reinicie o celular e o computador. Isso destrava um adbd preso no celular e drivers USB travados no computador.

Como o ADBKit lida com isso

O ADBKit não usa o servidor adb do seu computador. O Chrome ou o Edge falam com o celular diretamente pelo WebUSB, então uma diferença de versão do servidor não deixa um dispositivo offline no ADBKit. Mas ele precisa da conexão USB só para ele: se o servidor adb de outro programa estiver com o celular, o ADBKit avisa que o dispositivo está ocupado e diz o que fechar. Pelo Wi-Fi, o ADBKit mostra um estado claro de "conexão perdida" e oferece reconectar.

Se o adb devices não mostra nada, veja celular não aparece no adb devices.