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 em um dispositivo Google Pixel Watch 3 ou 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. Escolhe uma rede e digite uma 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 relógio

  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, 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 informado na etapa 2. O terminal vai informar se o pareamento foi concluído com êxito. Como 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 abaixo 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. Ele precisa ser 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 em 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.