Criar e executar seu primeiro app 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 o projeto.

Agora você já pode executar seu primeiro app no Wear OS.

Executar um app no emulador

Uma maneira simples de executar seu app Wear OS é em 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. Feche o SDK Manager.
  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. A menos que você precise de personalizações específicas, mantenha as configurações padrão nessa tela. Por padrão, o Android Studio seleciona a API e a imagem do sistema mais recentes. 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. Na barra de ferramentas principal, encontre o Executar widget. No menu suspenso de dispositivos, selecione o emulador criado e clique no botão Executar "Botão executar" para iniciar o app.
  2. Depois de alguns instantes, uma mensagem "Hello…" vai aparecer no emulador.

Executar um app em um relógio físico (opcional)

Executar e depurar seu app em um relógio físico permite avaliar melhor a experiência total 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. Role 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.

Para mais informações, consulte Configurar opções do desenvolvedor no dispositivo.

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 não for possível depurar o relógio por uma porta USB, consulte Conectar ao dispositivo usando Wi-Fi.

Abrir o app no relógio

  1. No Run Widget (parte da barra de ferramentas principal), use o menu suspenso de dispositivos para selecionar seu dispositivo físico.
  2. Clique no botão Executar "Botão executar" no widget de execução.
  3. Depois de alguns instantes, uma mensagem "Hello…" vai aparecer no dispositivo.

Planejar a arquitetura do app

Agora que você tem um app básico em execução, já pode ir além do modelo. Antes de começar a adicionar novos recursos, é útil pensar nas principais decisões arquitetônicas que vão moldar seu app. As seções a seguir abordam algumas perguntas importantes a serem consideradas.

Modelo de app: independente, dependente ou híbrido

Considere o quanto seu app depende de um smartphone pareado:

  • Híbrida (recomendada para a maioria dos apps): essa é a abordagem mais comum e flexível. Os recursos principais do app funcionam sem um smartphone (como monitorar um treino), mas oferecem funcionalidades aprimoradas quando um smartphone está conectado, como sincronizar dados ou facilitar a configuração.
  • Independente:o app funciona completamente sozinho, sem precisar de um smartphone para os recursos principais. Isso é ótimo para apps que podem funcionar off-line ou usar a própria conexão de Internet. O modelo "Empty Wear App" cria um app independente por padrão.
  • Não independente:o app exige um smartphone para a funcionalidade principal.

Para mais informações e orientações sobre essa escolha, consulte Apps independentes e não independentes para Wear OS.

Criar a interface do usuário

O Compose para Wear OS é um framework declarativo moderno que é a maneira recomendada de criar interfaces para apps do Wear OS. O modelo usado foi criado com o Compose, o que oferece um ótimo ponto de partida.

Ao criar com o Compose, use as bibliotecas projetadas especificamente para o Wear OS. Eles oferecem componentes otimizados para relógios que são essenciais para uma ótima experiência do usuário.

Por exemplo, em vez de um LazyColumn padrão, use TransformingLazyColumn, que é compatível com animações de escalonamento e transformação.

Da mesma forma, para navegação, use o SwipeDismissableNavHost da biblioteca de navegação do Wear OS para integrar ao gesto de deslizar para dispensar do sistema.

Armazenamento e sincronização de dados

A forma como você gerencia os dados é uma escolha arquitetônica fundamental. Para persistência no dispositivo, as opções são as mesmas do dispositivo móvel, com DataStore para dados de chave-valor ou objetos tipados, e Room para dados mais complexos e estruturados, sendo as opções modernas recomendadas.

  • Armazene dados primeiro no dispositivo:crie um app priorizando o modo off-line, armazenando os dados necessários diretamente no relógio para que ele continue funcional sem uma conexão com o smartphone.
  • Sincronizar dados com o smartphone:quando você precisar sincronizar ou transmitir dados (como configurações do usuário ou dados de treino) com um app complementar para smartphone, use a API Data Layer. Ele oferece um canal de comunicação que funciona por Bluetooth e Wi-Fi.

Gerenciar trabalhos de longa duração

Muitas experiências principais do Wear OS, como exercícios ou reprodução de mídia, são de longa duração. É fundamental gerenciar esse trabalho corretamente para manter a confiabilidade e preservar a bateria.

  • Para tarefas de longa duração iniciadas pelo usuário:quando um usuário inicia uma tarefa que precisa continuar mesmo que ele saia do app (como rastrear uma corrida), você precisa usar um serviço em primeiro plano. No Wear OS, pareie esse serviço com a API Ongoing Activity. Isso cria uma notificação persistente e um ícone tocável no mostrador do relógio, permitindo que o usuário volte ao seu app.
  • Para tarefas em segundo plano que podem ser adiadas:para trabalhos que não precisam ser executados imediatamente (como sincronizar dados periodicamente), use o WorkManager. Ele considera a bateria e respeita as otimizações do sistema, como o modo Soneca, sendo uma boa opção para processamento em segundo plano não urgente.

Pense além do app: plataformas e energia

Por fim, lembre-se de que uma experiência do Wear OS é mais do que apenas o aplicativo principal.

  • Compatibilidade com outras plataformas:para criar um app envolvente e de alta qualidade, planeje a compatibilidade com outras plataformas otimizadas para o pulso. Considere criar um título para ações e informações rápidas e um complemento para mostrar dados importantes diretamente no mostrador do relógio do usuário.
  • Planeje a eficiência energética:a duração da bateria é fundamental em um dispositivo vestível. Desde o início, crie seu app para ser eficiente em termos de energia. Isso significa pensar com cuidado em como você busca dados, usa sensores e executa tarefas em segundo plano. Adiar o trabalho até que o relógio esteja carregando é uma boa estratégia. Saiba mais no guia sobre como economizar energia.