Depurar um app para Wear OS

Para depurar um app para Wear OS, conecte sua máquina de desenvolvimento a um smartwatch via Wi-Fi ou Bluetooth. Caso o smartwatch tenha uma porta USB, é possível conectar via USB.

Ativar as opções do desenvolvedor no smartwatch

Antes de depurar no seu smartwatch, 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 smartwatch.
  2. Toque em Sistema > Sobre.
  3. Vá até o Número da versão e toque nele sete vezes.
  4. Uma caixa de diálogo aparecerá, confirmando que você é um desenvolvedor.

Depurar por Wi-Fi

Antes de começar, ative as opções do desenvolvedor no smartwatch.

Conectar o smartwatch a uma rede Wi-Fi

  1. Abra as Configurações do smartwatch.
  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. Talvez seja necessário usar um ponto de acesso que tenha um firewall configurado adequadamente para oferecer suporte ao adb.

Ativar a depuração por Wi-Fi

  1. Abra as Configurações do smartwatch.
  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 smartwatch (por exemplo, 192.168.1.100). Anote esse endereço, porque você vai precisar dele na próxima etapa.

Conectar o depurador ao smartwatch

  1. Conecte a máquina de desenvolvimento e o smartwatch à mesma rede.
  2. Conecte o depurador ao smartwatch usando o endereço IP do smartwatch. Por exemplo, se o endereço IP for 192.168.1.100, o comando de conexão adb e a resposta serão assim (um número de porta, 5555, é adicionado ao endereço):

    adb connect 192.168.1.100:5555
    connected to 192.168.1.100:5555
    

O smartwatch está conectado ao depurador, e está tudo pronto para começar a depuração. Envie comandos adb para o smartwatch usando a sinalização "-s" e especifique o endereço IP do smartwatch, incluindo o número de 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 precisará especificar o endereço:

adb <command>

Depurar via Bluetooth

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

Antes de começar, pareie o smartwatch e o smartphone e ative as opções do desenvolvedor no smartwatch. Confira se as opções do desenvolvedor também estão ativadas no smartphone. Para isso, abra as Configurações do smartphone, selecione Sobre o telefone e clique no número da versão sete vezes.

Ativar depuração USB no smartphone

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

Ativar depuração ADB/via Bluetooth no smartwatch

  1. Abra o menu Configurações do smartwatch.
  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. Vá até Configurações avançadas e toque para ver as opções de Configurações avançadas.
  3. Ative a Depuração via Bluetooth. Uma mensagem de status é exibida abaixo da opção. Ela é assim:
    Host: disconnected
    Target: connected
    

Nesse ponto, a máquina de desenvolvimento (o host) não estará se comunicando com o smartwatch (o destino). É necessário concluir o vínculo.

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

Conectar o depurador ao smartwatch

Nesta etapa final, você usará tudo: o depurador, o smartphone e o smartwatch.

  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 sua máquina de desenvolvimento. Use a mesma porta nos dois comandos. Neste exemplo, ela é 4444.

  3. Depois de digitar o comando de conexão, observe o smartwatch. Ele vai pedir uma confirmação de permissão da 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. O smartwatch está conectado ao depurador, e está tudo pronto para começar a depuração.

Ao depurar um smartwatch via Bluetooth, o adb sempre usará o endereço IP 127.0.0.1, além da porta atribuída. Neste exemplo, a porta é 4444. Todos os comandos adb usam o seguinte 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 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, ferramenta Android para Mac (link em inglês), para gravar um vídeo do seu dispositivo Wear.

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