Conectando um Celular

Testar apps Flutter diretamente no seu celular Android físico é muito mais rápido que usar emuladores — e também evita muitos problemas com NDK, Gradle e desempenho. Aqui vai um guia prático e atualizado para configurar o Android Studio, seu PC e o celular Android para rodar e testar aplicativos Flutter diretamente no dispositivo:

Etapas no Celular

Ative o modo desenvolvedor

• No seu celular, vá em: Configurações → Sobre o telefone

• Toque 7 vezes seguidas em "Número da versão" (ou "Build number")

• Vai aparecer: Você agora é um desenvolvedor!

Ative a depuração USB

•  Acesse: Configurações → Sistema → Opções do desenvolvedor

•  Ou em Configurações → Desenvolvedor

•  Ative: Depuração USB (USB debugging)

•  Opcionalmente, pode ativar também:

  • Instalar via USB, se disponível

  • Depuração sem fio, se quiser testar via Wi-Fi

Etapas no Computador

Conecte o celular via cabo USB

• Use um cabo de dados (não só carregamento) de qualidade

• Quando aparecer a notificação no celular, escolha:

  • Transferência de arquivos ou Transf. de arquivos (MTP)

• Confirme a autorização de depuração USB quando for solicitada.

Verifique se o celular foi reconhecido

No terminal do projeto Flutter, digite:

flutter devices

Se tudo estiver certo, verá algo assim:

1 connected device:

moto g 7 play (mobile) • 0056578268 • android-arm    • Android 10 (API 29)

O modelo também deve aparecer na listagem dos "devices" no Android Studio.

Execute o app no celular

Selecione o celular na lista de "devices" e rode o projeto clicando no "Play" correspondente.

Possíveis Problemas e Soluções

• • Celular não aparece no flutter devices  →  Verifique se o cabo é de dados, ative a depuração USB e aceite a permissão no celular

  • Aparece "device unauthorized"  →  Desconecte, reinicie o celular, aceite a chave de segurança novamente

  • adb não reconhece o dispositivo  →  Rode adb kill-server e adb start-server, ou reinstale o driver USB

  • O celular não aparece no Android Studio  →  Reinicie o Android Studio ou verifique se está selecionado como dispositivo de execução

Dicas Extras

• Você pode usar Hot Reload no terminal durante o flutter run.

• Para instalar o APK diretamente:

flutter build apk

adb install build/app/outputs/flutter-apk/app-release.apk

O Hot Reload recompila e recarrega o aplicativo no dispositivo quando o código é atualizado.

Drivers USB (se necessário)

Se o celular não aparecer mesmo com tudo certo:

•  Baixe o driver do fabricante (Samsung, Xiaomi, Motorola, etc.)

•  Ou use o Google USB Driver (no Android Studio): SDK Manager > SDK Tools > Google USB Driver

Agora seu ambiente está configurado para testar seus apps Flutter diretamente no celular Android, com melhor desempenho e menos problemas que os emuladores.