Executar apps em um dispositivo de hardware

Ao desenvolver um app para Android, é importante testá-lo sempre em um dispositivo real antes de liberá-lo para os usuários. Esta página descreve como configurar seu ambiente de desenvolvimento e dispositivo Android para testar e depurar em uma conexão do Android Debug Bridge (ADB).

Configurar um dispositivo para desenvolvimento

Antes de começar a depuração no dispositivo, decida se você quer conectá-lo usando Wi-Fi ou um cabo USB. Em seguida, faça o seguinte:

  1. No dispositivo, abra o app Configurações, selecione Opções do desenvolvedor e ative a Depuração USB, se aplicável.

  2. Configure seu sistema para detectar o dispositivo.

    • Chrome OS: nenhuma outra configuração é necessária.
    • macOS: nenhuma outra configuração é necessária.
    • Ubuntu Linux: duas coisas precisam ser configuradas corretamente. Cada usuário que queira usar o adb precisa estar no grupo plugdev, e o sistema precisa ter as regras udev que abrangem o dispositivo instaladas.

      Grupo plugdev: se for exibida uma mensagem de erro informando que você não está no grupo plugdev, será necessário adicionar a si mesmo ao grupo:

      sudo usermod -aG plugdev $LOGNAME
      

      Os grupos só são atualizados no login. Por isso, você precisa sair para que essa mudança tenha efeito. Ao fazer login novamente, você pode usar id para verificar se está no grupo plugdev.

      Regras udev: o pacote android-sdk-platform-tools-common contém um conjunto padrão mantido pela comunidade de regras udev para dispositivos Android. Para instalar:

      apt-get install android-sdk-platform-tools-common
      
    • Windows: instale um driver USB para o adb, se aplicável. Para ter um guia de instalação e links para drivers OEM, consulte o documento Instalar drivers USB OEM.

Conectar ao dispositivo por USB

Quando estiver tudo pronto e você estiver conectado via USB, clique em Run no Android Studio para criar e executar seu app no dispositivo.

Também é possível usar adb para emitir comandos da seguinte maneira:

  • Verifique se o dispositivo está conectado executando o comando adb devices a partir do diretório android_sdk/platform-tools/. Se estiver, você verá o dispositivo listado.
  • Emita qualquer comando adb com a sinalização -d para direcioná-lo ao dispositivo.

Conectar ao dispositivo por Wi-Fi

O Android 11 (e versões mais recentes) é compatível com a implantação e a depuração do app por Wi-Fi na estação de trabalho usando o Android Debug Bridge (adb). Por exemplo, é possível implantar o app depurável em vários dispositivos remotos sem conectar fisicamente o dispositivo via USB e resolver problemas comuns de conexão USB, como a instalação do driver.

Para usar a depuração por Wi-Fi, é necessário parear seu dispositivo com a estação de trabalho usando um código de pareamento. A estação de trabalho e o dispositivo precisam estar conectados à mesma rede Wi-Fi. Para se conectar ao dispositivo, siga estas etapas:

Caixa de diálogo de pareamento do adb por Wi-Fi
  1. Na sua estação de trabalho, instale a versão mais recente do SDK Platform-Tools.
  2. Ative a opção Wireless debugging nas Developer options.
  3. Na caixa de diálogo que diz Allow wireless debugging on this network?, clique em Allow.
  4. Selecione Pair device with pairing code. Anote o código de pareamento, o endereço IP e o número da porta exibidos no dispositivo (veja a imagem).
  5. Na estação de trabalho, abra um terminal e navegue até android_sdk/platform-tools.
  6. Execute adb pair ipaddr:port. Use o endereço IP e o número da porta que anotou na etapa 3.
  7. Quando solicitado, digite o código de pareamento que você anotou na etapa 4. O pareamento do dispositivo será confirmado com uma mensagem.

    Enter pairing code: 482924
    Successfully paired to 192.168.1.130:37099 [guid=adb-235XY]
    
  8. Execute adb connect ipaddr:port. Use o endereço IP e a porta exibidos em Wireless debugging (Depuração por Wi-Fi). Veja a imagem abaixo.

    IP e número da porta do adb por Wi-Fi

Solucionar problemas de conexão de dispositivos com o Connection Assistant

O Connection Assistant fornece instruções passo a passo para ajudar você a configurar e usar um dispositivo pela conexão ADB.

Para iniciar o assistente, escolha Tools > Connection Assistant.

O Connection Assistant oferece instruções, controles em contexto e uma lista de dispositivos conectados em uma série de páginas no painel Assistant. Use os botões Next e Previous na parte inferior do painel Assistant para trabalhar nas páginas conforme necessário:

  • Conecte o dispositivo via USB: o Connection Assistant começa solicitando que você conecte seu dispositivo via USB e fornece um botão Rescan USB devices que você pode usar para iniciar uma nova busca para dispositivos conectados.
  • Ative a depuração USB: o Connection Assistant informa como ativar a depuração USB nas opções do desenvolvedor no dispositivo.
  • Reinicie o servidor ADB: por fim, se você ainda não vir o dispositivo na lista de dispositivos disponíveis, poderá usar o botão Restart ADB server na última página do Connection Assistant. Reiniciar o servidor ADB também faz com que o ADB busque novamente os dispositivos. Se mesmo assim o dispositivo não aparecer na lista de dispositivos disponíveis, tente as etapas de solução de problemas na próxima seção desta página.

Resolver problemas de conexão USB

Se o Connection Assistant não detectar o dispositivo por USB, você poderá tentar as seguintes etapas de solução de problemas para resolver o problema:

Verificar se o Android Studio pode se conectar ao Android Emulator

Para verificar se o problema está sendo causado pela conexão entre o Android Studio e o Android Emulator, siga estas etapas:

  1. Abra o AVD Manager.
  2. Crie um novo AVD se você ainda não tiver um.
  3. Execute o emulador usando seu AVD.
  4. Realize uma das seguintes ações:
    • Se o Android Studio não conseguir se conectar ao emulador, faça o download do SDK Platform Tools mais recente e tente novamente.
    • Se o emulador for iniciado sem problemas, verifique o cabo USB.

Verificar o cabo USB

Para verificar se o problema está sendo causado por um cabo USB defeituoso, siga as etapas nesta seção.

Se você tiver outro cabo USB:

  1. Conecte o dispositivo usando o cabo secundário.
  2. Verifique se o Connection Assistant agora consegue detectar o dispositivo.
  3. Se o dispositivo não for detectado, tente o cabo principal novamente.
  4. Se a detecção ainda não ocorrer, presuma que o problema está no dispositivo e verifique se ele está configurado para desenvolvimento.

Se você não tiver outro cabo USB, mas tiver outro dispositivo Android:

  1. Conecte o dispositivo secundário ao computador.
  2. Se o Connection Assistant detectar o dispositivo secundário, presuma que o problema está no dispositivo principal e verifique se ele está configurado para desenvolvimento.

    Se o dispositivo secundário não for detectado, o problema pode estar no cabo USB.

Verificar se o dispositivo está configurado para desenvolvimento

Para verificar se o problema está sendo causado por configurações no dispositivo, siga estas etapas:

  1. Siga as etapas na seção Configurar um dispositivo para desenvolvimento.
  2. Se isso não resolver o problema, entre em contato com o suporte ao cliente do dispositivo OEM para conseguir ajuda. Diga ao representante de suporte ao cliente que o dispositivo não se conecta ao Android Studio usando o ADB.

Chave de segurança RSA

Ao conectar um dispositivo com Android 4.2.2 (API de nível 17) ou versão mais recente ao computador, o sistema mostrará uma caixa de diálogo perguntando se você aceita uma Chave RSA que permite a depuração por esse computador. Esse mecanismo de segurança protege dispositivos de usuários, porque garante que a depuração USB e outros comandos do adb só sejam executados se você conseguir desbloquear o dispositivo e confirmar a caixa de diálogo.