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 for destinado ao Wear OS 2.0 (nível 28 da API), a maior parte do trabalho de upgrade vai envolver o processamento de mudanças do Android 9 (nível 28 da API) para o Android 11 (nível 30 da API).

Não existe uma versão do Wear OS para o Android 10 (nível 29 da API). É necessário processar essas mudanças de uma só vez ao mudar os campos compileSdkVersion e targetSdkVersion de 28 para 30.

Observação: mesmo que você não mude compileSdkVersion ou targetSdkVersion no app, confira se ele é compatível com o nível 29 da API.

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. Ao fazer upgrade do app, é necessário revisar as interfaces do usuário para incorporar as diretrizes de design mais recentes.

O nível 30 da API inclui a API Ongoing Activity. Uma atividade em andamento permite que uma notificação em andamento seja mostrada em outras plataformas na interface do usuário do Wear OS, permitindo que os usuários fiquem mais engajados 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 o nível 30 da API ou mais recente.

Escolha uma versão para começar

A maioria dos desenvolvedores cria um app estável destinado ao nível 30 da API e 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: a imagem do sistema do emulador do Wear OS com o nível 30 da API está disponível na prévia para desenvolvedores. Acesse as notas da versão (em inglês) para consultar as atualizações mais recentes.

Bibliotecas do Jetpack para Wear OS

As bibliotecas do Jetpack para Wear OS são um conjunto com funcionalidade semelhante à Biblioteca de Suporte de wearables que oferece um suporte melhor ao Wear OS 3.

As bibliotecas do Jetpack para Wear OS substituem a Biblioteca de Suporte de wearables e não foram projetadas para serem usadas em conjunto com ela. A Biblioteca de Suporte de Wearables não funciona no Wear OS 3.

Para mais informações, consulte a postagem do blog Bibliotecas Jetpack do Wear OS agora estáveis (em inglês).