Preparar o ambiente de desenvolvimento

Executar apps Android em um Chromebook dá aos usuários acesso ao vasto ecossistema Android e aos desenvolvedores Android a oportunidade de alcançar usuários do ChromeOS.

O ChromeOS oferece aos desenvolvedores Android as ferramentas para implantar e testar os apps em Chromebooks. Para melhorar a experiência dos usuários, verifique seus apps em diferentes formatos.

Se você estiver implantando o app Android diretamente no ChromeOS (usando o Android Studio no Chromebook) ou em outro dispositivo, poderá usar a Android Debug Bridge para implantar o app e depurar diferentes interações com Chromebooks.

Ativar depuração do ADB

Observação: esse recurso está disponível em Chromebooks lançados após 2020.

Antes, usar o ADB em um Chromebook só era possível no modo de desenvolvedor. Desde o Chrome 81, os desenvolvedores não precisam entrar no modo de desenvolvedor e ainda podem implantar apps que desenvolvem diretamente no ChromeOS. Veja como:

1. Acesse Configurações e ative o Linux, se ainda não tiver feito isso.

   

   Figura 1. Ativar o Linux nas configurações do ChromeOS.

2. Quando o Linux estiver disponível, abra as configurações dele.

3. Abra a opção Desenvolver apps Android.

4. Ative a opção Ativar depuração do adb. O Chromebook será reiniciado.

   

   Figura 2. Ativar a depuração do adb nas configurações do Linux.

   Observação :se a opção de ativar/desativar o ADB não estiver disponível depois que você ativar o Linux ou se não for possível ativar/desativar, talvez seja necessário redefinir o dispositivo para a configuração original.

5. Depois que o Chromebook for reiniciado, uma mensagem vai informar que pode haver aplicativos que não foram transferidos da app store para o dispositivo.

   

   Figura 3. Aviso sobre apps que não são da Play Store após ativar o ADB.

6. O adb agora está disponível para implantar apps no Chromebook, executar comandos de depuração e interagir diretamente com o dispositivo.

Para verificar se o app Android funciona 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
• Um Chromebook baseado em x86
• Dispositivos com e sem tela touchscreen
• Um dispositivo conversível que alterna entre um laptop e um tablet
• Dispositivo com stylus

Implantar no ChromeOS

Depois de ativar a depuração do adb, você pode carregar um app Android diretamente no dispositivo ChromeOS usando o Android Studio. Se você tiver um kit de pacote Android (APK), poderá carregá-lo usando o terminal.

Implantar com o Android Studio

Depois de configurar o Android Studio e o adb, você pode enviar seus apps para o contêiner do Android no Chromebook diretamente do Android Studio. O Chromebook aparece como uma opção no menu do dispositivo:

Figura 4. Chromebook listado no menu de dispositivos do Android Studio.

Quando você envia o app para um Chromebook, a caixa de diálogo de autorização do adb aparece. Depois que você autorizar, o aplicativo será iniciado em uma nova janela.

Figura 5. Autorizar o ADB e executar um app no Android Studio.

Agora é possível implantar o app no Chromebook e testar e depurar.

Implantar com o terminal

Siga estas etapas para implantar o app em um Chromebook usando o terminal:

1. Instale o adb, se necessário, usando o seguinte comando:

   sudo apt install adb
   

2. Conecte-se ao dispositivo usando o seguinte comando:

   adb connect arc
   

3. Uma caixa de diálogo de autorização para depuração USB é exibida. Conceda a autorização:

   

   Figura 6. Caixa de diálogo de autorização da depuração USB.

4. Instale o app do terminal usando o seguinte comando:

   adb install [path to your APK]
   

Figura 7. Conectar a um Chromebook e instalar um APK pelo terminal.

Implantar de outro dispositivo

Se não for possível usar o método anterior e for necessária a instalação do app via push de outro dispositivo, você poderá conectar o dispositivo ao adb usando uma conexão USB ou um endereço de rede.

Conectar ao adb por uma rede

Siga estas etapas para se conectar ao ADB por uma rede:

1. Verifique se a depuração do adb está ativada.

2. Para ver o endereço IP do seu Chromebook, siga estas etapas:

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

Dica: outra maneira rápida de encontrar o endereço IP do Chromebook é clicar no relógio no canto inferior direito, depois no ícone do Wi-Fi e, por fim, no botão de informações da rede.

Conecte-se ao Chromebook:

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

   adb connect <ip_address>
   

2. No Chromebook, clique em Permitir quando for solicitado a permitir o depurador. A sessão do ADB é estabelecida.

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

Observação: se a rede não permitir esses tipos de conexões, configure seu próprio roteador ou ponto de acesso ou tente usar Ethernet com uma porta ou um dongle.

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 quando aparecer a pergunta se você quer permitir a depuração. Sua sessão do ADB é estabelecida.

Conectar ao adb por USB

Para instalar seu APK via push de outro dispositivo para o Chromebook, inicie o ChromeOS no modo de desenvolvedor para configurar o Chromebook e instalar apps pela máquina host.

Cuidado: depois de colocar o dispositivo ChromeOS no modo de desenvolvedor, ele será reiniciado e limpará todos os dados existentes no dispositivo. O nível de segurança do dispositivo também será significativamente reduzido.

Siga estas etapas para entrar no modo de desenvolvedor:

1. Ative a depuração do adb.
2. Verifique se o dispositivo é compatível com depuração USB.
3. Pressione Control+Alt+T para iniciar o terminal do ChromeOS.

4. Digite shell para acessar o shell do comando bash:

   crosh> shell
   chronos@localhost / $
   

5. Digite os seguintes comandos para configurar o dispositivo:

   $ sudo crossystem dev_enable_udc=1
   $ sudo reboot
   

6. 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>.

Para estabelecer uma sessão do ADB, siga estas etapas:

1. Conecte um cabo USB a uma porta compatível no dispositivo.
2. Execute adb devices nas ferramentas de plataforma do SDK do Android na máquina host para ver o Chromebook listado como dispositivo compatível com adb.
3. No Chromebook, clique em Permitir quando for solicitado a permitir o depurador. A sessão do ADB é estabelecida.