Wear OS 5.1

Conheça a versão mais recente do Wear OS, disponível em alguns dispositivos e no emulador oficial do Android Studio. Confira se o app é executado conforme o esperado depois de atualizar a versão do SDK de destino.

O Wear OS 5.1 é baseado no Android 15 (nível 35 da API), o que exige que você teste os apps que já são direcionados ao nível 34 da API para o Wear OS 5.

Preparar um dispositivo compatível para testes

O Wear OS 5.1 pode ser executado nos seguintes dispositivos:

• Google Pixel Watch 3 (Bluetooth/Wi-Fi)
• Google Pixel Watch 2 (Bluetooth/Wi-Fi)

O dispositivo precisa receber uma atualização de software over the air (OTA). Também é possível atualizar o dispositivo manualmente seguindo um destes procedimentos:

• No app Configurações, navegue até Sistema > Atualizações do sistema.
• Depois de ativar as opções do desenvolvedor, faça o flash de uma imagem de software específica em dispositivos com suporte a uma conexão de dados USB (com fio). Por exemplo, você pode instalar uma imagem de fábrica ou uma imagem OTA completa.

Preparar o emulador para testes

Para executar o Wear OS 5.1 no emulador oficial, primeiro faça o download e instale a imagem do sistema que é executada no emulador. Em seguida, crie um dispositivo virtual que execute essa imagem do sistema.

Fazer o download e instalar a imagem do sistema

Para fazer o download e instalar a imagem de sistema correta, siga estas etapas:

1. Faça o download e instale a versão mais recente do Android Studio Ladybug Feature Drop ou mais recente, caso ainda não tenha feito isso.
2. No Android Studio, clique em Tools > SDK Manager.

3. Na guia SDK Platforms, clique em Show Package Details e expanda a seção Android 15.0 ("VanillaIceCream") que contém artefatos para o nível 35-ext15 da API. Em seguida, selecione Wear OS 5.1 ARM 64 v8a System Image ou Wear OS 5.1 Intel x86_64 Atom System Image:

   

4. Clique em OK. Quando a janela Confirm Change aparecer, clique em OK novamente.

5. Aguarde o Android Studio fazer o download e instalar a imagem do sistema e clique em Finish.

Criar um dispositivo virtual

Para criar um dispositivo virtual que execute essa imagem do sistema no emulador oficial, siga estas etapas:

1. No Android Studio, abra o Gerenciador de dispositivos selecionando Tools > Device Manager. O painel Gerenciador de dispositivos aparece.
2. Na barra de ferramentas do painel Device Manager, clique em Add a new device > Create Virtual Device.
3. No painel Form Factor, selecione Wear OS e escolha um perfil de hardware. Clique em Next.
4. Selecione uma imagem do sistema Wear OS 5.1 para usar. A imagem do sistema precisa ter um nível da API de 35.
5. Clique em Próxima e em Concluir.

Testar o app no emulador

Para testar o app nesse dispositivo virtual que você criou, siga estas etapas:

1. Acesse a barra de ferramentas do Android Studio e selecione o dispositivo virtual.
2. Clique em Run .
3. Instale o app no dispositivo virtual e navegue pelos diferentes fluxos de trabalho voltados ao usuário usados pelo app.

Mudanças que afetam todos os apps

Ao testar seu app no Wear OS 5.1, verifique como ele processa as mudanças de comportamento do sistema que afetam todos os apps no Android 15, que usa o mesmo nível de API do Wear OS 5.1.

Várias mudanças de comportamento não entram em vigor no Wear OS 5.1:

• Os espaços particulares não são compatíveis com o Wear OS 5.1.
• As animações de volta preditiva podem não aparecer.

Atualizar a versão do SDK de destino do app

Você pode melhorar a compatibilidade do app com o Wear OS 5.1 atualizando a versão do SDK de destino para o nível 35 da API. Esse é o mesmo nível de API usado pelo Android 15.

Para fazer isso, abra o arquivo build.gradle ou build.gradle.kts no nível do módulo e atualize-o com valores para o Wear OS 5.1.

A formatação dos valores no arquivo de build depende da versão do Plug-in do Android para Gradle (AGP) que você está usando.

AGP 7.0.0 ou versões mais recentes

Se você estiver usando o AGP 7.0.0 ou mais recente, atualize o arquivo build.gradle ou build.gradle.kts do app com os valores abaixo para o Wear OS 5.1:

Groovy

android {
    compileSdk 35
    ...
    defaultConfig {
        targetSdk 35
    }
}

Kotlin

android {
    compileSdk = 35
    ...
    defaultConfig {
        targetSdk = 35
    }
}

AGP 4.2.0 ou versões anteriores

Se você estiver usando o AGP 4.2.0 ou uma versão anterior, atualize o arquivo build.gradle ou build.gradle.kts do app com os valores abaixo para o Wear OS 5.1:

Groovy

android {
    compileSdkVersion "35"
    ...
    defaultConfig {
        targetSdkVersion "35"
    }
}

Kotlin

android {
    compileSdkVersion = "35"
    ...
    defaultConfig {
        targetSdkVersion = "35"
    }
}

Mudanças que afetam apenas apps destinados ao nível 35 da API

Depois de atualizar a versão do SDK de destino para o nível 35 da API, processe as mudanças para apps destinados ao Android 15, que usam o mesmo nível de API do Wear OS 5.1.

Novos recursos

O Wear OS 5.1 apresenta vários recursos para melhorar a experiência dos apps para Wear OS.

Observação: antes de adicionar esses recursos, prepare seu app para processar as mudanças de comportamento introduzidas pelo Wear OS 5.1.

Confira alguns recursos importantes:

• Suporte ao Gerenciador de credenciais:a API Credential Manager oferece uma solução de autenticação unificada, com suporte a fluxos de login usando senhas, chaves de acesso e identidade federada (como o recurso Fazer login com o Google). As credenciais de um usuário são armazenadas em um provedor de credenciais, que sincroniza as informações da conta entre os dispositivos.
• Reprodução no alto-falante do relógio:em dispositivos compatíveis com a reprodução de mídia pelo alto-falante do relógio, os usuários podem selecionar esse alto-falante como a opção de saída de mídia preferencial se o app for integrado ao Wear Output Switcher.

Notas da versão

A imagem do sistema mais recente para o Wear OS 5.1, que está disponível em dispositivos com suporte e no emulador, tem as seguintes características:

Data de lançamento	4 de março de 2025
Build	BP1A.250305.019.W3 em dispositivos AP4A.241205.004.F4 no emulador
Suporte para emulador	x86 (64-bit), ARM (v8-A)

Problemas conhecidos

A imagem do sistema que contém o Wear OS 5.1 tem os seguintes problemas conhecidos:

• O emulador nem sempre permite que o usuário adicione uma conta durante o fluxo de configuração após uma redefinição do dispositivo.
• Ao tocar em uma notificação, o app que a enviou não é aberto até que o usuário role a tela.
• Às vezes, os Serviços de saúde do Wear não iniciam um exercício.
• Se você acessar as bibliotecas androidx.wear.tiles ou androidx.wear:wear-phone-interactions em um app que é direcionado ao nível 35 da API, uma SecurityException pode ocorrer. Para resolver esse problema, faça upgrade para a versão mais recente de cada biblioteca.