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 o Android 11.0 ("R") (nível 30 da API) e o Android 13.0 (Tiramisu) (nível 33 da API).
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 as imagens do sistema, selecione o nome da versão R ou Tiramisu. Essas versões são os destinos do Android 11.0 (Wear OS 3) e o Android 13.0 (Prévia para desenvolvedores do Wear OS 4), respectivamente. Clique em Next.
- 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.
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.
- 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.
- 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.
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.