Esta página oferece um guia para você criar seu primeiro app para Wear OS usando um modelo do Android Studio. O app destaca as diferentes maneiras de visualizar informações rapidamente em dispositivos Wear OS e apresenta algumas práticas recomendadas para desenvolver apps na plataforma.
Este guia se aprofunda em alguns conhecimentos prévios sobre a plataforma Android e o ambiente de desenvolvimento integrado do Android Studio. Se você nunca usou o Android, crie um app usando este codelab. Para saber mais sobre os recursos do Android Studio, acesse a página Conheça o Android Studio.
Criar um app para Wear OS
Depois de fazer o download e instalar a versão mais recente do Android Studio, siga as instruções do assistente "New Project":
- Abra o Android Studio e acesse File > New > New Project. A janela New Project vai aparecer.
- No painel Templates, selecione Wear OS. Em seguida, no painel principal, selecione Empty Wear App.
- Atribua um nome ao projeto e clique em Finish. O Android Studio faz o download das dependências necessárias e cria a versão inicial do projeto.
Acesse Tools > SDK Manager e instale os dois pacotes a seguir:
- Android 14.0 ("UpsideDownCake) (nível 34 da API), que inclui a Wear OS 5 — ARM 64 v8a System Image e a Wear OS 5 — Intel x86 Atom_64 System Image.
- Android 13.0 ("Tiramisu") (nível 33 da API), que inclui a imagem do sistema Wear OS 4 ARM 64 v8a e a imagem do sistema Wear OS 4 Intel x86 Atom_64.
Para fechar o SDK Manager, clique em OK.
Agora você já pode executar seu primeiro app no Wear OS.
Executar um app no emulador
A maneira mais fácil de executar seu primeiro app para Wear OS é configurar um emulador.
Configurar um emulador
Para configurar um emulador no Android Studio, siga estas etapas:
- No SDK Manager, abra a guia das SDK Tools (Ferramentas do SDK). Confirme se você tem a versão mais recente das ferramentas da plataforma do SDK do Android.
- Acesse Tools > Device Manager.
- Selecione Create (+). O assistente Virtual Device Configuration vai aparecer.
- No painel Category, selecione Wear OS e escolha um perfil de hardware, como Wear OS Small Round. Clique em Next.
Para imagens do sistema usadas fora da China, selecione o nome da versão UpsideDownCake. Esta versão é destinada ao Android 14.0 (Wear OS 5). Para imagens do sistema usadas na China, selecione o nome da versão R. Esta versão é direcionada ao Android 11.0 (Wear OS 3). Se você ainda não tiver uma imagem do sistema do Wear OS 5 instalada que corresponda à definição do dispositivo, clique em Download ao lado de Release Name. Clique em Próxima.
Observação: as imagens do sistema do emulador do Wear OS incluem avisos de arquivos de terceiros e código-fonte. Para conferir avisos de terceiros sobre uma imagem específica do sistema, abra o arquivo
NOTICE.txt
, que está em um dos diretórios abaixo:$ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear/ABI
para emuladores usados fora da China.$ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABI
para emuladores usados na China.
Você pode manter o valor padrão para todas as configurações dessa tela, a menos que queira personalizar o emulador. Clique em Finish.
Para mais informações sobre o uso de emuladores, consulte o guia sobre como executar apps no Android Emulator.
Abrir o app no emulador
- Acesse Run > Select Device. Escolha o emulador que você acabou de criar.
- Na barra de ferramentas do Android Studio, clique em Run . O emulador inicia e abre seu app.
- Após alguns instantes, uma mensagem "Hello…" vai aparecer no emulador.
Testar o áudio Bluetooth usando o emulador
Nas imagens do sistema executadas no Wear OS 4 ou em versões mais recentes, o emulador oferece suporte ao Bluetooth emulado, o que permite testar áudio Bluetooth em vários casos de uso.
As imagens recentes do sistema só oferecem suporte a arquiteturas de 64 bits
As imagens do sistema do emulador para o Wear OS 4 e versões mais recentes oferecem suporte apenas a estas arquiteturas
de 64 bits: x86-64
e arm64-v8a
. Se você sabe ou suspeita que seu app
usa código nativo (que não esteja escrito nas
linguagens de programação Kotlin ou Java), confira se ele inclui bibliotecas nativas de 32
e 64 bits.
Saiba mais sobre como oferecer suporte a arquiteturas de 64 bits.
Executar um app em um relógio físico (opcional)
Executar e depurar seu app em um relógio real permite avaliar melhor a experiência real do usuário. Isso é importante principalmente se o app depende de hardware específico, como sensores ou GPU.
Para executar um app em um relógio físico, prepare o dispositivo para testes e conecte-o à máquina de desenvolvimento.
Preparar o relógio para testes
Para preparar o relógio para testes, ative a depuração do adb seguindo as etapas abaixo.
- No relógio, abra o menu Configurações.
- Vá até a parte de baixo do menu. Se nenhum item de Opções do desenvolvedor aparecer,
siga as subetapas abaixo. Caso contrário, vá para a próxima etapa.
- Toque em Sistema > Sobre ou Sistema > Sobre > Versões.
- Encontre o item Número da versão e toque nele sete vezes. Se o relógio estiver protegido por um PIN ou padrão, insira-o quando solicitado.
- No menu Configurações, toque em Opções do desenvolvedor.
- Ative a opção Depuração adb.
Conectar o relógio à máquina de desenvolvimento
Alguns relógios permitem a conexão por USB. Outros exigem uma conexão sem fio.
Configurar uma conexão usando um cabo USB
Siga estas etapas para conectar o smartwatch:
- Usando um cabo USB, conecte o relógio à máquina de desenvolvimento.
- No relógio, ative a opção Sempre permitir neste computador e toque em OK.
Configurar uma conexão sem fio
Se o relógio não tiver uma porta USB, aprenda a conectar um relógio usando Wi-Fi ou Bluetooth.
Instalar uma versão específica do Wear OS (opcional)
Se o caso de teste do app depende de uma versão específica do Wear OS, é possível instalar uma imagem de software em relógios com suporte à conexão de dados USB (com fio). Por exemplo, você pode atualizar uma imagem de fábrica ou uma imagem OTA completa em um dispositivo Google Pixel Watch 3 ou Google Pixel Watch 2.
Abrir o app no relógio
- Acesse Run > Select Device. Escolha o relógio conectado à máquina.
- Na barra de ferramentas do Android Studio, clique em Run . O emulador inicia e abre seu app.
- Após alguns instantes, uma mensagem "Hello…" vai aparecer no relógio.
Recomendados para você
Integrar sistemas de compilação C/C++ personalizados usando o Ninja (experimental)
Saiba mais sobre o suporte experimental ao sistema de build C/C++ Ninja