Criar e executar um app para wearables

Os apps Wear OS são executados diretamente em um smartwatch, dando a você acesso ao hardware, como os sensores e a GPU. Eles são semelhantes a outros apps que usam o SDK do Android, mas diferem em design e funcionalidade.

Um app Wear precisa funcionar independentemente de um app para smartphones, oferecendo aos usuários a maior flexibilidade possível na escolha do smartphone. Para mais informações, consulte Apps independentes.

Observação: você pode testar seu app em um relógio real basta se conectar a ele por Wi-Fi ou Bluetooth. O desenvolvimento com um smartwatch real permite avaliar melhor a experiência total do usuário. Um emulador também está disponível. Você pode usar o emulador do smartwatch do Android Studio para testar seu app em diferentes formatos e tamanhos de tela.

Configurar o ambiente

Instale a versão mais recente do Android Studio. Para mais informações sobre a criação de apps no Android Studio, consulte a Visão geral de projetos.

Use o SDK Manager para verificar se você tem a versão mais recente da Plataforma Android. Especificamente, na guia SDK Platforms, selecione Android 8.0 (Oreo).

Se você planeja disponibilizar seus apps Wear OS na China, consulte Criar apps Wear OS para a China.

Criar um app Wear OS

É possível criar um app Wear OS usando o assistente New Project do Android Studio.

Iniciar um projeto do Wear OS

Para criar um projeto no Android Studio:

Clique em File > New > New Project.
Na tela Configure your new project, aceite os valores padrão e clique em Next.
Na tela Target Android Devices, selecione apenas a opção Wear e, na lista Minimum SDK, selecione a opção mais recente disponível.
Clique em Next e, na tela Add an Activity to Wear, selecione Blank Wear Activity e clique em Next.
Na tela Customize the Activity, clique em Finish.
O Android Studio usa modelos para criar um app.
No arquivo build.gradle do módulo do app:
- Na seção android, verifique se a compileSdkVersion está definida como 26.
- Na seção android, verifique se a targetSdkVersion está definida como 26.
- Atualize a seção dependencies. A primeira dependência é para a Biblioteca da IU do Wear, que tem classes que exemplificam as práticas recomendadas. A segunda dependência é para a Biblioteca de Suporte para wearables, que tem outras classes, incluindo para mostradores de relógios:
```
    dependencies {
      implementation 'androidx.wear:wear:1.0.0'
      implementation 'com.google.android.support:wearable:2.5.0'
      compileOnly 'com.google.android.wearable:wearable:2.5.0'
    }
```
No arquivo de manifesto do Android (AndroidManifest.xml) do seu app, indique que o app é independente. Especificamente, adicione uma tag meta-data da seguinte maneira:
- Encontre a tag <application>.
- Como filho dessa tag, use uma tag meta-data com o nome com.google.android.wearable.standalone e o valor true:
```
    <application>
    ...
      <meta-data
        android:name="com.google.android.wearable.standalone"
        android:value="true" />
    ...
    </application>
    
```
No arquivo de manifesto do Android, verifique se a tag <uses-feature> está definida. No mínimo, ela precisa estar definida com android:name="android.hardware.type.watch", da seguinte maneira:
```
    <manifest>
    ...
      <uses-feature android:name="android.hardware.type.watch" />
    ...
    </manifest>
    
```
Sincronize seu projeto do Android Studio. Para executar o código no novo módulo, consulte Iniciar o emulador e executar seu app para Wear OS.

Iniciar o emulador e executar seu app Wear OS

Para usar o emulador, configure um dispositivo virtual Android, chamado de AVD. Pelo SDK Manager, verifique se você tem a versão mais recente do Android SDK Platform-tools.

Configure um AVD e execute seu app da seguinte maneira:

No Android Studio, abra o Android Virtual Device Manager selecionando Tools > AVD Manager.
Clique em Create Virtual Device.
No painel Category, selecione Wear e escolha um perfil de hardware. Clique em Next.
Selecione a imagem O para fazer o download. Por exemplo, selecione a imagem com O como Release Name, 25 como API Level e "Android 8.0 (Wear OS)" como Target. Clique em Next e em Finish.
Feche o Android Virtual Device Manager.
Na barra de ferramentas do Android Studio, selecione o AVD criado no menu suspenso do dispositivo de destino e clique em Run .

O AVD é iniciado e, após alguns instantes, executa seu app. Uma mensagem de "Hello…" será exibida.

Para mais informações sobre o uso de AVDs, consulte Executar apps no Android Emulator.

Parear um smartphone com o AVD de um smartwatch

Observação: não é possível parear um AVD de smartwatch com um AVD de smartphone. Você precisa pareá-lo com um smartphone conectado.

Se quiser usar uma Conta do Google no AVD do smartwatch para desenvolvimento, você poderá parear um smartphone com o AVD do smartwatch e sincronizar:

Siga as etapas para configurar um smartphone.
No smartphone, ative Opções do desenvolvedor e Depuração USB.
Conecte o smartphone ao computador pela porta USB.
Encaminhe a porta de comunicação do AVD para o smartphone conectado sempre que a conexão for feita:
adb -d forward tcp:5601 tcp:5601
No app Wear OS do smartphone, comece o processo de pareamento padrão. Por exemplo, na tela "Welcome", toque no botão Set It Up. Como alternativa, se já houver um smartwatch pareado, toque em Add a New Watch na lista suspensa na parte superior esquerda.
No app Wear OS do smartphone, toque no botão "Overflow" e em Pair with Emulator.
Toque no ícone Settings.
Em Device Settings, toque em Emulator.
Toque em Accounts, selecione uma Conta do Google e siga as etapas no assistente para sincronizar a conta com o emulador. Se necessário, digite a senha de bloqueio de tela do dispositivo e a senha da Conta do Google para iniciar a sincronização da conta.

Atualizar um projeto do Wear OS

Se você houver um projeto existente, talvez seja necessário atualizar o arquivo build.gradle. A versão 4.1 do Gradle é compatível com o uso de google() para indicar o repositório Maven do Google. Versões anteriores não são. Para ver informações relacionadas, consulte o repositório Maven do Google.

Portanto, caso sua versão do Gradle seja anterior à 4.1, forneça o URL do repositório Maven do Google no arquivo build.gradle do seu projeto do Android Studio. Especificamente, adicione uma seção maven à seção repositories, conforme mostrado a seguir:

      allprojects {
          repositories {
              jcenter()
              maven {
                  url "https://maven.google.com"
              }
          }
      }

Configurar um relógio

A implantação de um app em um smartwatch é semelhante à implantação de um app em um smartphone.

Esta seção presume que seu smartwatch tenha uma porta USB. Se ele não tiver, consulte as instruções para conectá-lo por Wi-Fi ou Bluetooth.

Ative a depuração do adb no smartwatch:

Abra o menu Settings do smartwatch.
Role até a parte inferior do menu. Se o item Developer Options não for exibido, toque em System e em About.
Toque no número da versão sete vezes.
No menu Settings, toque em Developer Options.
Ative ADB debugging.

Conecte o smartwatch:

Conecte o smartwatch à sua máquina por USB para que você possa instalar apps diretamente nele. Como alternativa, conecte o smartwatch à máquina por Wi-Fi ou Bluetooth.
No relógio, toque em Always allow from this computer e em OK.

Depois de conectar o smartwatch, execute o app selecionando um destino de implantação, assim como faria com um smartphone.

Configurar um smartphone

Esta seção contém informações sobre a configuração de um smartphone complementar com um app complementar do Wear OS.

Observação: apps do Wear OS precisam ser autônomos e funcionar independentemente de um smartphone. No entanto, caso seu app dependa de um app para smartphones, veja as informações abaixo sobre como atualizar um smartphone com o app complementar mais recente do Wear OS.

Usar a versão para Android do app associado

Em um smartphone Android, acesse a página "Detalhes do app" do Wear OS. Toque em Atualizar para fazer o download do app e instalá-lo. Após a instalação, verifique se a opção Atualizar automaticamente está selecionada para o app. Consulte a seção "Configurar atualizações automáticas em apps específicos" em Atualizar apps transferidos por download. Toque em Abrir para iniciar o app.

Parear um smartphone Android com um smartwatch

Depois de instalar o app complementar em um smartphone, cancele todos os pareamentos obsoletos com smartwatches (“Esquecer”), se necessário. Depois, pareie o smartphone com o smartwatch com a nova imagem:

No smartphone, selecione o nome do seu dispositivo na lista. Um código de pareamento será exibido no smartphone e no smartwatch. Confira se os códigos são iguais.
Toque em Parear para continuar o processo de pareamento. Quando o smartwatch se conectar ao smartphone, uma mensagem de confirmação aparecerá. No smartphone, uma tela que lista as contas será exibida.
Escolha uma Conta do Google para adicionar e sincronizar com o smartwatch.
Confirme o bloqueio de tela e insira a senha para começar a copiar a conta do seu smartphone para o smartwatch.
Siga as instruções no assistente para finalizar o processo de pareamento.

App complementar para iPhones

Um app associado do iOS está disponível, mas o smartphone em que o app está instalado precisa ter o iOS 8.2 ou versão mais recente.

No iPhone, acesse a App Store, faça o download do app associado do Wear e instale-o.
Siga as instruções no smartwatch e no smartphone para começar o processo de pareamento. Para mais informações, consulte a página de Ajuda relacionada.

Adicionar um módulo do Wear OS ao seu projeto

Você pode adicionar um módulo de um dispositivo Wear OS ao seu projeto existente do Android Studio, permitindo que códigos do seu app para dispositivos móveis (smartphone) sejam reutilizados.

Fornecer um módulo do Wear OS no seu projeto existente

Para criar um módulo do Wear OS, abra seu projeto existente do Android Studio e faça o seguinte:

Clique em File > New > New Module.
Na janela New Module, selecione Wear OS Module e clique em Next.
Em Configure the new module, insira:
- Application/Library Name: esta string é o título do ícone na tela de início do app para o novo módulo.
- Module Name: esta string é o nome da pasta dos arquivos de código-fonte e recursos.
- Package Name: esta string é o namespace Java para o código no seu módulo. Ela é adicionada ao atributo package no arquivo de manifesto do Android do módulo.
- Minimum SDK: selecione a versão mais antiga da plataforma compatível com o módulo do app. Por exemplo, selecione API 26: Android 8.0 (Oreo). Esse valor define o atributo minSdkVersion no arquivo build.gradle, que pode ser editado posteriormente.
Clique em Next. Opções que incluem modelos de código são exibidas. Clique em Blank Wear Activity e em Next.
Na janela Configure Activity, insira ou aceite os valores padrão de Activity Name, Layout Name e Source Language. Clique em Finish.

O Android Studio cria e sincroniza os arquivos para o novo módulo. Além disso, adiciona qualquer dependência necessária do Wear OS ao arquivo de versão do novo módulo. O novo módulo aparece na janela Project, no lado esquerdo da tela. Se a pasta do novo módulo não for exibida, verifique se a janela está exibindo a visualização Android.

No arquivo build.gradle para o novo módulo (Wear OS):

Na seção android, defina os valores de compileSdkVersion e targetSdkVersion como 26.

Atualize a seção dependencies para incluir o seguinte:

    dependencies {
      implementation 'androidx.wear:wear:1.0.0'
      implementation 'com.google.android.support:wearable:2.5.0'
      compileOnly 'com.google.android.wearable:wearable:2.5.0'
    }

Sincronize seu projeto do Android Studio. Para executar o código no novo módulo, consulte Iniciar o emulador e executar seu app para Wear OS.

Incluir bibliotecas

Observação: recomendamos usar o Android Studio no desenvolvimento para Wear OS, já que ele oferece configuração de projetos, inclusão de bibliotecas e empacotamento.

Quando você usa o assistente de projetos do Android Studio, esse assistente importa dependências no arquivo build.gradle do módulo adequado. No entanto, as dependências não são necessárias para todos os apps. Leia as informações abaixo sobre as dependências.

Para atualizar um projeto do Wear para a versão mais recente do SDK, use as configurações listadas na seção Iniciar um projeto do Wear OS.

Notificações

Para saber mais informações sobre dependências para notificações, consulte Criar uma notificação no Wear.

Biblioteca de IU do Wear

Os componentes da Biblioteca de IU do Wear são recomendados porque exemplificam as práticas recomendadas de apps para smartwatches. Portanto, é recomendável adicionar uma dependência na Biblioteca de IU do Wear. Para mais informações, consulte as seguintes páginas:

Biblioteca de Suporte de wearables

A Biblioteca de Suporte de wearables tem componentes de IU para apps de smartwatches. Algumas das classes estão obsoletas. Para ver mais informações sobre as classes que substituíram as classes obsoletas, consulte Usar a Biblioteca de IU do Wear.

Embora os componentes de IU possam mudar a qualquer momento, uma alteração em um componente não atrapalha um app, já que os componentes estão compilados dentro dele. Para conseguir novos recursos de uma biblioteca atualizada, conecte estaticamente a nova versão e atualize seu app adequadamente.

Google Play Services e APIs Data Layer de wearables

Caso seu app dependa do Google Play Services para sincronizar e enviar dados (usando as APIs Data Layer) ou por outros motivos, você precisa ter a versão mais recente do Google Play Services. Se você não estiver usando essas APIs, remova a dependência.

Diferenças entre apps para smartphones e para smartwatches

Veja algumas das diferenças entre apps para smartphones e para smartwatches:

Os apps para smartwatches usam APIs específicas do smartwatch sempre que possível (por exemplo, para layouts circulares, gavetas de wearables, modo ambiente etc.).
Os apps para smartwatches contêm funcionalidades adequadas a um smartwatch.
Os apps para smartwatches podem acessar muitas APIs padrão do Android, mas não são compatíveis com:
- android.webkit
- android.print
- android.app.backup
- android.appwidget
- android.hardware.usb
Você pode verificar se um smartwatch é compatível com um recurso chamando hasSystemFeature() antes de usar uma API.

Economizar energia no smartwatch

Para economizar energia em um smartwatch, ative o modo ambiente no seu app. Um smartwatch passa do modo interativo para o modo ambiente quando fica ocioso em uma atividade ou quando um usuário cobre a tela com a palma da mão. Os apps para smartwatches que podem fazer a transição para o modo ambiente são chamados de apps sempre ativados. Veja uma descrição desses dois modos de operação para apps sempre ativados:

Interativo: Use cores com animações fluidas nesse modo. O app também fica responsivo a entradas.
Ambiente: Renderize a tela com gráficos em preto e branco e não apresente nenhuma sugestão de entrada nesse modo. Esse modo de exibição só é compatível com dispositivos que executam o Android 5.1 ou mais recente.

Em dispositivos com versões anteriores ao Android 5.1 ou em apps incompatíveis com o modo ambiente, quando um usuário está ocioso em uma atividade ou quando ele cobre a tela com a palma da mão, a tela inicial do Wear é exibida em vez da atividade no modo ambiente. Se você precisar mostrar conteúdo persistente em versões anteriores ao Android 5.1, crie uma notificação no stream de contexto.