Depurar um app Wear OS

Para depurar seu app para Wear OS, você pode conectar sua máquina de desenvolvimento a um smartwatch via Wi-Fi ou Bluetooth, conforme descrito nesta página. Se o smartwatch tiver uma porta USB, você poderá fazer a conexão via USB.

Confira os seguintes recursos relacionados:

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.

  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 do 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. Esteja ciente de que 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 compatibilidade com 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 exibirá o endereço IP do smartwatch (por exemplo, 192.168.1.100). Anote esse endereço, já que ele será necessário na próxima etapa.

Conectar o depurador ao smartwatch

  1. Verifique se o smartwatch e a máquina de desenvolvimento estão conectados à 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 sua 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 você está pronto para começar a depuração. Envie comandos adb para o smartwatch com o sinalizador -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, não precisará especificar o endereço:

    adb <command>
    

Depurar via Bluetooth

A depuração via Bluetooth só funciona para smartwatches pareados com um dispositivo Android. Antes de começar, pareie o smartwatch com um smartphone e ative as opções do desenvolvedor do smartwatch. Verifique também se as opções do desenvolvedor estão ativadas no smartphone. Para isso, abra o menu Config. do smartphone, selecione Sobre o smartphone 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.
  2. Vá até Configurações avançadas e toque para visualizar as opções de Configurações avançadas.
  3. Ative a Depuração via Bluetooth. Uma mensagem de status é exibida abaixo da opção. Fica assim:
        Host: disconnected
        Target: connected
        

Neste 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. Se você tiver vários smartwatches pareados, a depuração via Bluetooth só será ativada com 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. Você pode usar qualquer porta disponível na sua máquina de desenvolvimento. Use a mesma porta em ambos os comandos. Neste exemplo, a porta é 4444.

  3. Depois de digitar o comando de conexão, observe o smartwatch. Ele pedirá que você confirme que está permitindo a Depuração ADB.
  4. Volte para o smartphone e verifique o status no app complementar do Wear. Ele precisa ser o seguinte:
        Host: connected
        Target: connected
        
  5. O smartwatch está conectado ao depurador, e você está 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. Portanto, todos os comandos adb usam esse formato (continuando o exemplo, a porta é 4444):

adb -s 127.0.0.1:4444 <command> 

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

    adb <command>
    

Usar o screenrecord para Wear

Se você faz o desenvolvimento no macOS®, pode usar um projeto do GitHub, ferramenta Android para Mac (link em inglês), para gravar um vídeo do seu dispositivo Wear.

Como alternativa, você pode gravar um vídeo do seu dispositivo Wear seguindo 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.