A Visualização do desenvolvedor para Android 11 já está disponível. Teste e compartilhe seu feedback.

Ambiente de desenvolvimento

Transferir seu app por sideload

Para transferir seu app por sideload para o Chromebook e realizar testes, entre no modo de desenvolvedor no dispositivo Chrome OS e ative a opção fontes desconhecidas. Consulte o documento Modo de desenvolvedor (em inglês) para ver instruções detalhadas de como colocar o dispositivo no modo de desenvolvedor. Depois que o dispositivo estiver no modo de desenvolvedor, você poderá acessar as configurações do Chrome e selecionar Ativar fontes desconhecidas na configuração de segurança no app.

Depois de ativar o modo de desenvolvedor, você pode carregar um app para Android no dispositivo Chrome OS por meio de um dos vários métodos. Para mais detalhes, consulte a seção Carregar seu aplicativo da página "Carregar aplicativos em Chromebooks".

Para que o app para Android funcione bem em vários dispositivos Chromebook e formatos disponíveis, o Google recomenda que você teste o app nos seguintes dispositivos:

  • Chromebook baseado em ARM
  • Chromebook baseado em x86
  • Dispositivos com e sem tela touchscreen
  • Dispositivo conversível, ou seja, que pode alternar entre laptop e tablet
  • Dispositivo com stylus

Para ver a lista completa de dispositivos compatíveis, consulte a página Compatibilidade com dispositivos Chrome OS para aplicativos.

Depurar com ADB

Use o Android Debug Bridge (ADB) da sua máquina de desenvolvimento para transferir por sideload e depurar o app enquanto ele é executado em um dispositivo Chrome OS. Você pode usar USB ou um endereço de rede para conectar o dispositivo ao ADB.

Para usar o ADB, é preciso iniciar o Chrome OS no modo de desenvolvedor para transferir apps para Android por sideload para o Chromebook.

Depois de iniciar no modo de desenvolvedor, siga estas etapas de configuração:

  1. Pressione Control+D para iniciar o dispositivo.
  2. Conclua o processo de configuração.
  3. Faça login na conta de teste.
  4. Aceite as condições dos Termos de Serviço da Google Play Store.

Ativar depuração do ADB

Primeiro, verifique se seu dispositivo é compatível com a depuração USB (em inglês).

Para ativar a depuração:

  1. Clique no relógio no canto inferior direito da tela.
  2. Clique no ícone de engrenagem.
  3. Clique na seção Google Play Store, depois em Gerenciar preferências do Android. Isso exibirá as configurações do Android. Para acessar essa opção mais rapidamente nas próximas vezes, clique com o botão direito no ícone de configurações na estante e fixe-o.
  4. Role para baixo e clique em Sobre o dispositivo.
  5. Clique em Número da versão sete vezes para acessar o modo de desenvolvedor.
  6. Clique na seta na área superior esquerda da janela para voltar à tela principal "Configurações".
  7. Clique no novo item de Opções do desenvolvedor, ative a opção Depuração ADB e clique em OK.

Também é possível selecionar estas opções para desenvolvedor Android para o Chrome OS:

  • Permitir redimensionamento livre de janela arrastando a borda: essa opção permite redimensionar a janela do app. Use-a para ver se o app lida com as mudanças de tamanho da janela corretamente e para garantir que o redimensionamento seja rápido e fluido.
  • Depurar informações: exibe informações de depuração para aplicativos para Android na barra de título da janela.

Conectar ao ADB por USB

  1. Verifique se seu dispositivo é compatível com depuração USB (em inglês).
  2. Pressione Control+Alt+T para iniciar o terminal do Chrome OS.
  3. Digite shell para acessar o shell do comando bash:

    crosh> shell
        chronos@localhost / $
        
  4. Digite os seguintes comandos para configurar o dispositivo:

    $ sudo crossystem dev_enable_udc=1
        $ sudo reboot
        
  5. Depois da reinicialização, abra o terminal novamente e execute o seguinte comando para ativar o ADB na porta USB do Chromebook:

    $ sudo ectool usbpd <port number> dr_swap
        

    Use esse comando sempre que desconectar e reconectar um cabo USB. Para verificar se o Chromebook está no modo UFP, execute ectool usbpd <port number>.

  6. Conecte um cabo USB a uma porta compatível no dispositivo.

  7. Execute adb devices nas ferramentas de plataforma do SDK Android na sua máquina host para ver seu Chromebook listado como dispositivo compatível com adb.

  8. No Chromebook, clique em Permitir ao ver a pergunta se você quer permitir o depurador. A sessão do ADB é estabelecida.

Conectar ao ADB por uma rede

Para depurar em uma rede, é necessário configurar o firewall do Chrome OS para permitir conexões de entrada do ADB:

  1. Pressione Control+Alt+T para iniciar o terminal do Chrome OS.
  2. Digite shell para acessar o shell do comando bash:

    crosh> shell
        chronos@localhost / $
        
  3. Digite os seguintes comandos para configurar recursos de desenvolvedor e ativar o acesso de gravação em disco para as mudanças nas configurações de firewall. Se você precisa inserir uma senha sudo para o usuário chronos, é possível (re)definir uma executando chromeos-setdevpassword no prompt VT-2 (em inglês) (Control+Alt+→). Você precisará da sua senha raiz.

    $ sudo crossystem dev_boot_signed_only=0
        $ sudo /usr/libexec/debugd/helpers/dev_features_rootfs_verification
        $ sudo reboot
        
  4. O comando sudo reboot reiniciará o Chromebook. Pressione a tecla Tab para ativar o preenchimento automático dos nomes dos arquivos. É preciso realizar esse procedimento apenas uma vez no Chromebook.

Depois que o dispositivo for reiniciado, faça login na conta de teste e digite o seguinte comando para ativar o shell seguro e configurar o firewall corretamente:

$ sudo /usr/libexec/debugd/helpers/dev_features_ssh
    

Quando o comando for concluído, você poderá sair do shell.

Veja o endereço IP do seu Chromebook:

  1. Clique no relógio na área inferior direita da tela.
  2. Clique no ícone de engrenagem.
  3. Clique no tipo de rede em que a conexão foi estabelecida (Wi-Fi ou dados móveis) e dê um nome à rede.
  4. Anote o endereço IP.

Conecte-se ao Chromebook:

  1. Volte para a máquina de desenvolvimento e use o ADB para conectar-se ao Chromebook por meio do endereço IP:

    adb connect <ip_address>:22
        
  2. No Chromebook, clique em "Permitir" ao ver a pergunta se você quer permitir o depurador. A sessão do ADB é estabelecida.

Solucionar problemas de depuração do ADB em uma rede

Em alguns casos, o dispositivo ADB mostra que está off-line mesmo quando a conexão está correta. Nesse caso, siga estas etapas para resolver o problema:

  1. Desative a depuração ADB nas Opções do desenvolvedor.
  2. Em uma janela de terminal, execute adb kill-server.
  3. Ative a opção Depuração ADB novamente.
  4. Em uma janela de terminal, tente executar adb connect.
  5. Clique em Permitir ao ver a pergunta se você quer permitir a depuração. A sessão do ADB é estabelecida.