Wear OS 5.1

Conheça a versão mais recente do Wear OS, disponível no emulador oficial do Android Studio. Confira se o app funciona 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 o emulador para testes

Para executar o Wear OS 5.1 no emulador oficial, primeiro é necessário fazer o download e instalar 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 Meerkat, caso ainda não tenha feito isso.
  2. No Android Studio, clique em Tools > SDK Manager.

  3. Na guia SDK Platforms, expanda a seção Android 15.0 ("VanillaIceCream") e selecione Wear OS 5.1 - Preview ARM 64 v8a System Image ou Wear OS 5.1 - Preview Intel x86_64 Atom System Image:

    "As imagens de build do emulador aparecem no grupo de imagens de build para a API 35 do Android"

  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 que ele usa.

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:

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 direcionados 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 usa 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.

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 disponível no emulador do Wear OS 5.1 tem as seguintes características:

  • Data de lançamento:19 de novembro de 2024
  • ID da versão:AP4A.241205.004.F1

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.