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. Vá para Ferramentas > o SDK Manager e instale os dois pacotes:

    • Android 14.0 ("UpsideDownCake) (nível 34 da API), que inclui as Wear OS 5 – Imagem do sistema da prévia ARM 64 v8a e o Wear OS 5 – Prévia da imagem do sistema Intel x86 Atom_64. Observe que, mesmo que o pacote contém a palavra "prévia". a própria imagem do emulador contém um versão estável do Wear OS 5.
    • Android 13.0 ("Tiramisu") (nível 33 da API), que inclui as Imagem do sistema do Wear OS 4 ARM 64 v8a e o Wear OS 4 Intel x86 Atom_64 Imagem do sistema.

    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 UpsideDownCake. nome da versão. 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 tem o Wear OS 5 imagem do sistema instalada que corresponda à definição do dispositivo, clique em Para fazer o download, faça o download ao lado de Nome da versão. 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 esses formatos Arquiteturas 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á para a parte inferior 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.

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.

Participe de programas Beta de dispositivos

Em algumas regiões, você pode se registrar na versão Beta do Galaxy One UI da Samsung neste programa. Este programa permite fazer o download do Wear OS 5 em um Samsung Galaxy qualificado Assistir ao dispositivo e testar o comportamento do app.

Para se registrar, siga estas etapas:

  1. Baixe o app Samsung Members, disponível na Google Play Store:
  2. Faça login usando sua conta Samsung.
  3. No banner inicial ou na página de avisos, role até e selecione o Card Inscrição no card do programa Beta do One UI Watch.
  4. Na página que aparecer, leia as instruções e selecione "Participar". que será exibido. Por exemplo, em um dispositivo Samsung Galaxy Watch6, selecione Assista o vídeo 6 "Join".