Executar apps em um dispositivo de hardware

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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 de regras udev mantido pela comunidade 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. Para começar, siga estas etapas:

  1. Confira se a estação de trabalho e o dispositivo estão conectados à mesma rede Wi-Fi.
  2. Confira se o dispositivo está executando o Android 11 ou uma versão mais recente. Para ver mais informações, consulte Conferir e atualizar a versão do Android.
  3. Confira se você tem o Android Studio Bumblebee Canary. Você pode fazer o download dele clicando aqui.
  4. Na sua estação de trabalho, instale a versão mais recente do SDK Platform-Tools.

Para se conectar ao dispositivo, siga estas etapas:

  1. Abra o Android Studio e selecione Pair Devices Using Wi-Fi no menu suspenso de configurações de execução.
    Menu suspenso de configurações de execução
    Figura 1. Menu suspenso de configurações de execução.

    A janela Pair devices over Wi-Fi será aberta, como mostrado abaixo.
    Captura de tela da janela pop-up "Pair devices over Wi-Fi"
    Figura 2. Janela pop-up de pareamento de dispositivos por código QR ou código de pareamento.
  2. Ative as Opções do desenvolvedor no dispositivo.
  3. Ative a depuração por Wi-Fi no dispositivo.
    Captura de tela de
      um Smartphone Pixel mostrando a configuração de sistemas de depuração por Wi-Fi.
    Figura 3. Captura de tela da configuração de depuração por Wi-Fi em um smartphone Google Pixel.
  4. Toque em Depuração por Wi-Fi e faça o pareamento do dispositivo:
    1. Se quiser parear o dispositivo com um código QR, selecione Parear o dispositivo com um código QR e leia o código QR mostrado acima.
    2. Se quiser parear o dispositivo com um código de pareamento, selecione Parear o dispositivo com um código de pareamento na janela Pair devices over Wi-Fi descrita acima. No dispositivo, selecione Parear usando o código de pareamento e salve o código PIN de seis dígitos. Quando o dispositivo aparecer na janela Pair devices over Wi-Fi, selecione Pair e digite o código PIN de seis dígitos mostrado no dispositivo.
      Captura de tela com um exemplo de entrada do código PIN
      Figura 4. Exemplo de entrada do código PIN de seis dígitos.
  5. Após o pareamento, você pode tentar implantar o app no dispositivo.

    Se quiser parear um dispositivo diferente ou remover o seu da estação de trabalho, acesse Depuração por Wi-Fi no dispositivo, toque no nome da estação em Dispositivos pareados e selecione Esquecer.

Resolver problemas de conexão do dispositivo

Se o dispositivo não se conectar ao Android Studio, tente o seguinte para resolver o problema.

Resolver problemas do 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, selecione Tools > Troubleshoot Device Connections.

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.

Resolver problemas de conexão sem fio

Se você estiver com problemas para conectar o dispositivo sem fios, tente seguir as etapas solução de problemas abaixo.

Conferir se a estação de trabalho e o dispositivo atendem aos pré-requisitos

Para atender aos pré-requisitos da depuração por Wi-Fi, confira se:

  1. a estação de trabalho e o dispositivo estão conectados à mesma rede Wi-Fi;
  2. seu dispositivo tem o Android 11 ou uma versão mais recente. Para ver mais informações, consulte Verificar e atualizar a versão do Android;
  3. você tem o Android Studio Bumblebee. Você pode fazer o download dele clicando aqui;
  4. você tem a versão mais recente do SDK Platform-Tools na estação de trabalho.

Conferir se há outros problemas conhecidos

Veja a seguir uma lista dos problemas conhecidos atuais da depuração por Wi-Fi no Android Studio e como eles podem ser resolvidos.

  1. O Wi-Fi não conecta: algumas redes Wi-Fi, como as corporativas, podem bloquear conexões P2P e não permitir que você se conecte ao Wi-Fi. Tente conectar o dispositivo com um cabo ou a outra rede.
  2. Às vezes, o adb por Wi-Fi é desativado automaticamente: isso pode acontecer se o dispositivo alternar entre redes Wi-Fi ou se desconectar da rede.

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.