Criar e executar um app no Wear OS

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":

  1. Abra o Android Studio e acesse File > New > New Project. A janela New Project vai aparecer.
  2. No painel Templates, selecione Wear OS. Em seguida, no painel principal, selecione Empty Wear App.
  3. 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.
  4. 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:

  1. 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.
  2. Acesse Tools > Device Manager.
  3. Selecione Create (+). O assistente Virtual Device Configuration vai aparecer.
  4. No painel Category, selecione Wear OS e escolha um perfil de hardware, como Wear OS Small Round. Clique em Next.
  5. 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.
  6. 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

  1. Acesse Run > Select Device. Escolha o emulador que você acabou de criar.
  2. Na barra de ferramentas do Android Studio, clique em Run . O emulador inicia e abre seu app.
  3. 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.

  1. No relógio, abra o menu Configurações.
  2. 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.
    1. Toque em Sistema > Sobre ou Sistema > Sobre > Versões.
    2. 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.
  3. No menu Configurações, toque em Opções do desenvolvedor.
  4. 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:

  1. Usando um cabo USB, conecte o relógio à máquina de desenvolvimento.
  2. 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

  1. Acesse Run > Select Device. Escolha o relógio conectado à máquina.
  2. Na barra de ferramentas do Android Studio, clique em Run . O emulador inicia e abre seu app.
  3. Após alguns instantes, uma mensagem "Hello…" vai aparecer no relógio.