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

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. 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. A API e a imagem do sistema mais recentes já devem estar selecionadas. 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. Encontre o Executar widget na barra de ferramentas principal. Selecione o emulador que você criou no menu suspenso de dispositivos e clique no botão Executar para iniciar o app.
  2. Após 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 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. 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 pela porta USB, consulte Conectar ao dispositivo usando Wi-Fi

Abrir o app no relógio

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