Fazer upgrade para a versão mais recente do Wear OS

Fazer upgrade do Wear 2.0

Este guia descreve o processo para upgrade do Wear OS.

Mudanças específicas do Android

O Wear 2.0 abrange várias versões do Android, do nível 25 ao 28 da API.

Observação: não existe uma versão do Wear OS para o Android 10 (API de nível 29).

Se o app para Wear OS for destinado ao Wear OS 2.0 (API de nível 28), a maior parte do trabalho de upgrade vai envolver o processamento de mudanças do Android 9 (API de nível 28) para o Android 11 (API de nível 30).

Não existe uma versão do Wear OS para o Android 10 (API de nível 29). Portanto, é necessário processar essas alterações de uma só vez ao mudar os campos compileSdkVersion e targetSdkVersion de 28 para 30.

Observação: mesmo que você não mude a compileSdkVersion ou a targetSdkVersion no app, é necessário garantir que ele seja compatível com a API de nível 29.

Mudanças específicas do Wear OS

O Wear OS 2.0 inclui blocos, complicações, apps, mostradores de relógio e várias outras plataformas. Contudo, é necessário revisar a interface do usuário para incorporar as diretrizes de design mais recentes.

A API de nível 30 inclui a API Ongoing Activity.

Uma atividade em andamento permite que uma notificação em andamento seja exibida em outras plataformas na interface do usuário do Wear OS. Assim, é possível aumentar o engajamento do usuário com atividades de longa duração.

Observação: alguns recursos das novas APIs Alfa dos mostradores de relógio estão disponíveis apenas para dispositivos com API de nível 30 ou mais recente.

Escolha uma versão para começar

Conforme mencionado na seção Mudanças específicas do Android, a versão do Wear OS é vinculada a uma versão do Android. Ao escolher uma versão para começar, considere quais são os dispositivos Wear OS mais comuns.

A maioria dos desenvolvedores cria apps estáveis destinados à API de nível 30, mas mantém o número da versão minSdkVersion baixo o suficiente para abranger as versões mais comuns do Android. Por exemplo, para oferecer suporte a dispositivos com Wear 2.0, defina a minSdkVersion como 25.

Se você tem experiência com o desenvolvimento para Android, muitos dos conhecimentos que você já tem podem ser aplicados no Wear OS. Para entender o que é diferente, consulte Diferenças entre desenvolvimento para Wear OS e dispositivos móveis.

Observação: no momento, a imagem do sistema do emulador do Wear OS com API de nível 30 está disponível na prévia para desenvolvedores. Consulte as notas da versão para entender as atualizações mais recentes.

Bibliotecas do Jetpack para Wear OS

As bibliotecas do Jetpack para Wear OS são cinco e contêm funcionalidades semelhantes à Biblioteca de Suporte de wearables, além de melhor compatibilidade com o Wear OS 3.

As bibliotecas do Jetpack para Wear OS substituem as Bibliotecas de Suporte de wearables. Portanto, as duas não foram projetadas para serem usadas em conjunto. A Biblioteca de Suporte de wearables não funciona no Wear OS 3.

Para mais informações, consulte Bibliotecas Jetpack do Wear OS agora estáveis.