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 for5555
, o comandoadb 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: