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 relógio tenha uma porta USB, é possível conectar via USB.

Ativar as opções do desenvolvedor no relógio

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:

Abra as Configurações do relógio.
Toque em Sistema > Sobre > Versões.
Toque no item Número da versão sete vezes.
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

Abra as Configurações do relógio.
Toque em Conectividade > Wi-Fi.
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

Abra as Configurações do relógio.
Toque em Opções do desenvolvedor > Depurar por Wi-Fi.
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.

Conectar o depurador ao relógio

Conecte a máquina de desenvolvimento e o relógio à mesma rede.
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

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

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

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

Ativar a depuração via Bluetooth no smartphone

No smartphone, abra o app complementar do Wear OS.
Acesse Configurações avançadas e toque para conferir as opções de Configurações avançadas.
Ative a Depuração via Bluetooth. A mensagem de status abaixo vai aparecer debaixo 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.

Conecte o smartphone à máquina de desenvolvimento com um cabo USB.
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 e use a mesma porta nos dois comandos. Neste exemplo, ela é 4444.
Depois de inserir o comando de conexão, o relógio vai pedir que você autorize a depuração adb.
No smartphone, confira o status no app complementar do Wear OS. Ele precisa ser o seguinte:
```
Host: connected
Target: connected
```

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:

Grave frames brutos no smartwatch:

adb shell screenrecord --time-limit 30 --output-format raw-frames --verbose /sdcard/video.raw

Copie o arquivo bruto na sua máquina de desenvolvimento:
```
adb pull /sdcard/video.raw video.raw
```
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.

Confira estes recursos relacionados: