Depurar um app para Wear OS

Para depurar um app para Wear OS em um relógio físico, conecte sua máquina de desenvolvimento ao relógio via Wi-Fi ou Bluetooth. Caso o relógio tenha uma porta USB, é possível conectar via USB.

Você também pode testar fluxos de trabalho que abrangem vários dispositivos, como um relógio e um smartphone, se o app exigir esse suporte. Para saber mais sobre como configurar uma conexão para testes, acesse Conectar um relógio a um smartphone.

Observação: se você não tem um relógio físico, também é possível testar e executar o app em um emulador no Android Studio.

Atualizar para a versão mais recente do Wear OS

Para conferir se o app se comporta como esperado no software mais recente, verifique se o dispositivo de teste está executando a versão mais atualizada do Wear OS com suporte.

Siga estas etapas para conferir se há uma atualização do sistema disponível para seu dispositivo de teste:

  1. Conecte o dispositivo a uma rede Wi-Fi.
  2. Carregue o dispositivo.
  3. Aguarde até a bateria chegar a 50% ou mais.
  4. No dispositivo de teste, acesse Configurações > Sistema > Atualizações do sistema.

    Se uma atualização do sistema estiver disponível, ela será transferida por download e instalada no dispositivo de teste.

Instalar uma versão específica do Wear OS (opcional)

Se o caso de teste do app depende de uma versão específica do Wear OS, é possível instalar uma imagem de software em relógios com suporte à conexão de dados USB. Por exemplo, você pode instalar uma imagem de fábrica ou uma imagem OTA completa no Google Pixel Watch 2.

Ativar as opções do desenvolvedor no smartwatch

Antes de depurar no relógio, ative as opções do desenvolvedor. Só é necessário fazer isso uma vez. As opções do desenvolvedor permanecem ativadas até que você as desative. Para ativar as opções do desenvolvedor, faça o seguinte:

  1. Abra as Configurações do relógio.
  2. Toque em Sistema > Sobre > Versões.
  3. Toque no item Número da versão sete vezes.
  4. Uma mensagem será mostrada confirmando que você ativou as Opções do desenvolvedor.

Depurar por Wi-Fi

Antes de começar, ative as opções do desenvolvedor no relógio, conforme descrito anteriormente.

Conectar o relógio a uma rede Wi-Fi

  1. Abra as Configurações do relógio.
  2. Toque em Conectividade > Wi-Fi.
  3. Escolha uma rede e digite a senha, se necessário.

    Observação: o smartwatch e a máquina de desenvolvimento precisam estar conectados à mesma rede. Nem todos os pontos de acesso são adequados. Pode ser necessário usar um ponto de acesso que tenha um firewall configurado corretamente para oferecer suporte ao adb.

Ativar a depuração por Wi-Fi

  1. Abra as Configurações do relógio.
  2. Toque em Opções do desenvolvedor > Depurar por Wi-Fi.
  3. Após alguns instantes, a tela vai mostrar o endereço IP do relógio, por exemplo, 192.168.1.100. Anote esse valor, porque você vai precisar dele na próxima etapa.

Parear o depurador com o smartwatch

  1. No dispositivo Wear OS, encontre as opções de depuração por Wi-Fi nas configurações do sistema. Selecione Parear novo dispositivo.
  2. Anote o código de pareamento do Wi-Fi e o endereço IP e a porta.
  3. Em uma janela de terminal na máquina de desenvolvimento, digite o seguinte comando:
    adb pair IP_ADDRESS:PORT
    
  4. Quando solicitado, digite o código de pareamento do Wi-Fi da etapa 2. O terminal vai informar se o pareamento foi bem-sucedido. Por exemplo:
    Enter pairing code: 123456
    Successfully paired to 192.168.1.100:5555
    
Após o pareamento, o computador host aparece na lista de Dispositivos pareados na tela Depuração por Wi-Fi do dispositivo Wear OS.

Conectar o depurador ao relógio

  1. Conecte a máquina de desenvolvimento e o relógio à mesma rede.
  2. Conecte o depurador ao relógio usando o endereço IP do relógio e um número de porta. Por exemplo, se o endereço IP for 192.168.1.100 e o número da porta for 5555, o comando adb connect e a resposta vão ficar assim:

    adb connect 192.168.1.100:5555
    connected to 192.168.1.100:5555
    

Agora o relógio está conectado ao depurador. Está tudo pronto para começar a depuração. Envie comandos adb ao relógio usando a flag -s, especificando o endereço IP e o número da porta:

adb -s 192.168.1.100:5555 <command>

Se não estiver usando o emulador e tiver apenas um dispositivo conectado para depuração, você não vai precisar especificar o endereço:

adb <command>

Depurar via Bluetooth

Observação: a depuração via Bluetooth só funciona em relógios pareados com dispositivos Android que usam o Wear OS 2.

Antes de começar, pareie o relógio e o smartphone e ative as opções do desenvolvedor no relógio, conforme descrito anteriormente. Para conferir se as opções do desenvolvedor estão ativadas no smartphone, acesse o menu Configurações e procure por Opções do desenvolvedor. Se necessário, ative as opções do desenvolvedor no smartphone.

Ativar a depuração USB no smartphone

  1. Abra o menu Configurações do smartphone.
  2. Selecione Opções do desenvolvedor e ative a Depuração USB.

Ativar a depuração via ADB ou Bluetooth no relógio

  1. Abra o menu Configurações do relógio.
  2. Vá até Opções do desenvolvedor.
  3. Verifique se Depuração ADB está ativada.
  4. Ative a Depuração via Bluetooth.

Ativar a depuração via Bluetooth no smartphone

  1. No smartphone, abra o app complementar do Wear OS.
  2. Acesse Configurações avançadas e toque para conferir as opções.
  3. Ative a Depuração via Bluetooth. A mensagem de status a seguir vai aparecer abaixo da opção:
    Host: disconnected
    Target: connected
    

Nesse momento, a máquina de desenvolvimento (o host) não está se comunicando com o relógio (o destino). É necessário concluir a vinculação.

Observação: só é possível depurar com um dispositivo por vez. Caso haja vários relógios pareados, a depuração via Bluetooth vai ficar ativada apenas para o dispositivo selecionado na tela principal.

Conectar o depurador ao relógio

Nesta etapa final, você vai usar tudo: o depurador, o smartphone e o relógio.

  1. Conecte o smartphone à máquina de desenvolvimento com um cabo USB.
  2. Execute estes dois comandos no depurador:
    adb forward tcp:4444 localabstract:/adb-hub
    adb connect 127.0.0.1:4444
    

    Observação: use o endereço IP 127.0.0.1. Use qualquer porta disponível na máquina de desenvolvimento nos dois comandos. Neste exemplo, ela é 4444.

  3. Depois de inserir o comando de conexão, o relógio vai pedir que você autorize a depuração adb.
  4. No smartphone, confira o status no app complementar do Wear OS para saber o seguinte:
    Host: connected
    Target: connected
    
  5. Agora o relógio está conectado ao depurador. Está tudo pronto para começar a depuração.

Ao depurar um relógio via Bluetooth, o adb sempre usa o endereço IP 127.0.0.1, além da porta atribuída. Neste exemplo, ela é 4444. Todos os comandos do adb usam este formato:

adb -s 127.0.0.1:4444 <command> 

Se não estiver usando o emulador e tiver apenas um dispositivo conectado para depuração, você não vai precisar especificar o endereço:

adb <command>

Usar gravação de tela para Wear OS

Caso esteja desenvolvendo no macOS, você pode usar um projeto do GitHub, a ferramenta Android para Mac (link em inglês), para gravar um vídeo do seu dispositivo Wear OS.

Para gravar um vídeo do seu dispositivo Wear OS, siga estas etapas:

  1. Grave frames brutos no smartwatch:
    adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw
  2. Copie o arquivo bruto na sua máquina de desenvolvimento:
    adb pull /sdcard/video.raw video.raw
  3. Use ffmpeg para converter o arquivo bruto para MP4:
    ffmpeg -f rawvideo -vcodec rawvideo -s 400x400 -pix_fmt rgb24 -r 10 -i video.raw -an -c:v libx264 -pix_fmt yuv420p video.mp4

    Observação: consulte o site do FFmpeg para ver as instruções de download e instalação.