Depurar um app para Wear OS

A depuração no Wear OS usa as mesmas ferramentas e processos padrão que a depuração em outros formatos com tecnologia Android.

Esta página contém instruções e links para ajudar você a depurar seus apps do Wear OS.

Destinos de depuração

É possível depurar seu app Wear OS usando o Android Emulator ou um dispositivo físico.

Android Emulator

O Android Emulator permite testar seu app em várias configurações de relógio virtual diretamente do Android Studio.

1. Configure um emulador:se você ainda não fez isso, siga as etapas para configurar um emulador.
2. Selecione o emulador:na barra de ferramentas do Android Studio, escolha o dispositivo virtual do Wear OS em que você quer executar o app no menu suspenso do dispositivo de destino.
3. Execute o app:clique em Executar . O Android Studio instala e inicia o app no emulador.

Para mais detalhes sobre recursos do emulador específicos do Wear OS, consulte O emulador do Wear OS.

Relógio físico

A depuração em um relógio físico ajuda a avaliar a experiência do usuário no mundo real e testar recursos específicos do hardware, como sensores. É possível se conectar a um relógio físico usando Wi-Fi ou, em relógios compatíveis, uma conexão USB.

Para conectar um smartwatch físico:

1. Prepare o relógio:ative a depuração do ADB nas opções do desenvolvedor do relógio.
2. Conectar:siga as instruções detalhadas para conexões USB ou Wi-Fi, incluindo o uso de adb pair e adb connect, em Executar apps em um dispositivo de hardware. O procedimento de configuração é semelhante ao de outros dispositivos Android.

Observação: a depuração via Bluetooth não é mais compatível com o Wear OS 3.

Depuração e configuração adicionais

Embora a maioria das ferramentas de depuração funcione da mesma forma que em outros dispositivos Android, alguns aspectos são específicos do Wear OS.

Instalar uma versão específica do SO

Se o teste exigir uma versão específica do Wear OS, você pode instalar uma imagem de software diretamente 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 Google Pixel Watch.

Testar as conexões entre o relógio e o smartphone

Se a funcionalidade do seu app abranger um relógio e um smartphone, e você estiver testando em um relógio emulado, use o assistente de pareamento do Wear OS do Android Studio para parear seu dispositivo de teste com um smartphone físico ou virtual.

Gere capturas de tela e vídeos

O processo de fazer capturas de tela e vídeos usando a interface do Android Studio é o mesmo para o Wear OS e para outros dispositivos. No entanto, se você usar adb na linha de comando, o processo poderá ser diferente, já que talvez seja necessário especificar codecs específicos. Para mais informações, consulte Capturar capturas de tela do Wear OS.