The Android Developer Challenge is back! Submit your idea before December 2.

Executar apps em um dispositivo de hardware

Ao desenvolver um app Android, é importante testá-lo sempre em um dispositivo real antes de distribuí-lo aos 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, há algumas coisas que você precisa fazer:

  1. No dispositivo, abra o app Config., selecione Opções do desenvolvedor e ative a Depuração USB.

  2. Configure seu sistema para detectar o dispositivo.

    • macOS: nenhuma outra configuração é necessária.
    • Ubuntu Linux: use o apt-get install para instalar o pacote adb. Isso fornece um conjunto padrão mantido pela comunidade de regras do udev para todos os dispositivos Android.

      Você precisa estar no grupo plugdev. Se vir a seguinte mensagem de erro, o adb não encontrou você no grupo plugdev:

      error: insufficient permissions for device: udev requires plugdev group membership
          

      Use id para ver em quais grupos você está. Use sudo usermod -aG plugdev $LOGNAME para entrar no grupo plugdev.

      O exemplo a seguir mostra como instalar o pacote de ferramentas adb do Android.

      apt-get install adb
          
    • Windows: instale um driver USB para o ADB. Para ter um guia de instalação e links para drivers OEM, consulte o documento Instalar drivers USB OEM.

Conectar ao seu dispositivo

Quando você estiver configurado e conectado via USB, poderá clicar em Run no Android Studio para criar e executar seu app no dispositivo.

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

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

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 fornece 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 o dispositivo ainda não for detectado, 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 posterior 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 não sejam executados, a não ser que você consiga desbloquear o dispositivo e confirmar a caixa de diálogo.