Notas da versão do Wear OS

Esta página contém informações sobre as versões do Wear OS, como o SDK e a Biblioteca de Suporte de Wearables.

21 de novembro de 2024 – SDK de Wearables 19.0.0

A versão 19.0.0 do SDK de Wearables inclui pequenas atualizações do SDK. Confira o que as atualizações incluem:

• As dependências da biblioteca foram atualizadas para as versões mais recentes.
• Uma variante da API sendMessage() que não tinha suporte e incluía um parâmetro MessageOptions foi removida

31 de agosto de 2023 – SDK de Wearables 18.1.0

A versão 18.1.0 do SDK de Wearables inclui pequenas atualizações da API para oferecer suporte à próxima versão da Biblioteca de Suporte de Wearables. Confira o que as atualizações incluem:

• Suporte à troca de smartphones. Consulte NodeClient.OnNodeMigratedListener para saber mais.
• Documentação extra para MessageClient enviar e responder mensagens.
• Links atualizados nas descrições da API.

20 de setembro de 2022 – SDK de Wearables 18.0.0

A versão 18.0.0 do SDK de Wearables inclui pequenas atualizações da API para oferecer suporte à próxima versão da Biblioteca de Suporte de Wearables. Confira o que as atualizações incluem:

• Suporte a WearableListenerService para apps Android 13: problema 235538840.
• Novo método MessageClient.sendRequest().

16 de fevereiro de 2022 – Biblioteca de Suporte de Wearables v2.9.0

A versão 2.9.0 da Biblioteca de Suporte de Wearables descontinua todas as classes restantes. Use as Bibliotecas Jetpack do Wear OS.

29 de outubro de 2021 – Biblioteca do Jetpack para Wear OS

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

27 de abril de 2021: SDK de Wearables 17.1.0

A versão 17.1.0 do SDK de Wearables inclui pequenas atualizações da API para oferecer suporte à próxima versão da Biblioteca de Suporte de Wearables.

28 de setembro de 2020 – Biblioteca de Suporte de Wearables v2.8.1

A versão 2.8.1 da Biblioteca de Suporte de Wearables inclui a mudança abaixo.

Permite que o Jetifier seja desativado com o uso do modelo do mostrador do relógio

O modelo de mostrador do relógio do Android Studio agora usa dependências do AndroidX para permitir a desativação do Jetifier. Essas correções se aplicam ao uso do modelo de mostrador do relógio com o Android Studio 4.2 ou mais recente.

24 de setembro de 2020 – Biblioteca de Suporte de Wearables v2.8.0

A versão 2.8.0 da Biblioteca de Suporte de Wearables inclui as mudanças abaixo.

Recurso de substituição para especificar provedores de complementos padrão que não são do sistema

Os mostradores de relógio agora podem usar o elemento setDefaultComplicationProviderWithFallbacks para especificar um ou mais provedores de complementos que não são do sistema a serem usados por padrão. Se nenhum dos provedores especificados que não são do sistema estiverem instalados, o sistema voltará a usar o provedor padrão do sistema.

A WearableActivity foi descontinuada

O uso de WearableActivity foi descontinuado. Use AmbientModeSupport.

SKIP_CONFIRMATION_UI foi descontinuado

O uso de ActionConfirmationActivity.SKIP_CONFIRMATION_UI foi descontinuado. Esse extra não é usado desde o lançamento do Wear 2.0.

15 de maio de 2020 – Biblioteca de Suporte de Wearables v2.7.0

A versão 2.7.0 da Biblioteca de Suporte de Wearables inclui o recurso abaixo.

Aceleração de hardware para mostradores de relógio

Agora você pode pedir uma tela acelerada por hardware ao usar a classe CanvasWatchFaceService. Aproveite a aceleração de hardware para melhorar o desempenho do mostrador do relógio e acessar mais dados de desempenho da IU.

Para ver mais informações, consulte Melhorar o desempenho do mostrador do relógio com a aceleração de hardware.

21 de abril de 2020 – Biblioteca de Suporte de Wearables v2.6.0

A versão 2.6.0 da Biblioteca de Suporte de Wearables inclui a melhoria abaixo.

Migração para o Android Jetpack

A Biblioteca de Suporte de Wearables foi migrada para o Android Jetpack. As bibliotecas existentes agora são mapeadas e acessíveis no AndroidX usando o namespace androidx, e todas as dependências na Biblioteca de Suporte descontinuada foram removidas.

Essa mudança também permite usar as Bibliotecas de Suporte de Wearables no Android Studio 4.0 e mais recentes, o que resolve problemas como o 147972079.

28 de agosto de 2019 – Biblioteca de Suporte de Wearables v2.5.0

A versão 2.5.0 da Biblioteca de Suporte de Wearables inclui a melhoria abaixo.

Correção para ComplicationDrawable quando o método startActivity() é chamado com o tipo de complemento TYPE_NO_PERMISSION

ComplicationDrawable agora inclui uma flag NEW_TASK que garante que chamadas de startActivity() originadas de um WatchFaceService incluam FLAG_ACTIVITY_NEW_TASK para evitar uma android.util.AndroidRuntimeException.

Essa mudança permite que o tipo de complemento TYPE_NO_PERMISSION inicie de maneira adequada a atividade do pedido de permissão em vez de resultar em falha no mostrador do relógio.

25 de setembro de 2018 – SDK de Wearables 16.0.0

A versão 16.0.0 do SDK de Wearables reduz a versão exigida do Google Play Services de 12.4 para 8.6. Essa mudança permite que os apps existentes sejam atualizados para a versão mais recente do SDK de Wearables sem exigir uma atualização do APK do Google Play Services.

11 de junho de 2018 – Atualização da prévia para desenvolvedores do Wear OS 2

Uma atualização over the air recente da prévia para desenvolvedores do Wear OS 2 reativou alarmes e jobs para apps em segundo plano.

Embora essa mudança de política possibilite maior flexibilidade no desenvolvimento de apps, os alarmes e jobs em segundo plano continuam sujeitos a outras restrições do Android P, incluindo as que pertencem aos buckets de apps em espera. Siga as práticas recomendadas para garantir que os apps tenham bom funcionamento independente do bucket em que estão inseridos.

Essa atualização também melhora a entrada e a privacidade dos dados do usuário ao limitar o acesso de um app em segundo plano aos dados do sensor e de entrada do usuário. Dependendo dos requisitos do app, talvez seja necessário usar um serviço em primeiro plano para ativar o acesso contínuo aos dados do sensor.

8 de maio de 2018 – Prévia para desenvolvedores do Wear OS 2

Essa prévia apresenta recursos como uma experiência melhorada do Google Assistente.

Envie feedback ou relatórios de bugs pelo Issue Tracker do Wear OS by Google. Quanto mais cedo eles forem enviados, maior será a probabilidade de incluirmos as correções na versão final.

Problemas conhecidos

Esta seção contém os problemas conhecidos da versão 2 de pré-lançamento.

Problemas na imagem do Wear OS

• Ao pressionar o botão liga/desliga na lateral do relógio quando está em um app, você pode voltar à tela anterior em vez de ao mostrador do relógio.

Problemas na imagem chinesa do Wear OS

• Ao pressionar o botão liga/desliga na lateral do relógio quando está em um app, você pode voltar à tela anterior em vez de ao mostrador do relógio.
• As configurações de volume não são mantidas. Por exemplo, uma chamada recebida resulta em toques audíveis no relógio, mesmo que o som esteja desativado. Se você ajusta o volume do alarme, a mudança não tem efeito.
• Várias notificações em andamento podem não ser exibidas corretamente. Por exemplo, se um timer e um cronômetro são configurados ao mesmo tempo, as notificações não são exibidas. Recomendamos testar o app com apenas uma notificação em andamento.
• A app store do Wear não funciona na versão chinesa. Os desenvolvedores não conseguem atualizar ou instalar novos apps usando esse canal. Recomendamos usar o adb como alternativa para o sideload do aplicativo em testes.

Problemas no emulador do Wear

• Uma chamada recebida em um telefone associado não é mostrada ou _mirrored_ como uma recebida no emulador pareado.
• Quando você usa o SDK Manager para instalar ou confirmar que você tem a instalação mais recente do Android P ou a versão chinesa, as caixas de seleção ao lado dessas opções podem ser desmarcadas por conta própria. Se isso acontecer, marque-as novamente.
• Quando o emulador executa uma inicialização a frio, o seguinte erro pode ser mostrado: "Há um problema interno com seu dispositivo. Entre em contato com o fabricante para saber mais detalhes". Isso não afeta a funcionalidade. Role para baixo e clique em OK para começar a testar o app.
• A resposta por voz pode não funcionar no emulador. Por exemplo, se você recebe uma notificação sobre uma mensagem do Google Hangouts no emulador do Wear e tenta responder à mensagem por voz, a mensagem de erro "O Google apresenta falhas contínuas" é exibida, impedindo que você faça a ação.
• O Instant Run pode ser incompatível com o emulador do Wear.
• Fazer uma captura de tela de forma programática, como por adb ou registrando um relatório de bug, pode não funcionar. Como solução alternativa, clique no botão de câmera da barra de ferramentas do emulador para capturar a tela.

Problemas na versão chinesa do emulador do Wear

• Uma chamada recebida em um telefone associado pode não ser mostrada ou _mirrored_ como uma recebida no emulador pareado. Da mesma forma, notificações de chamadas perdidas podem não ser exibidas no emulador. Além disso, pode não ser possível responder a uma chamada no emulador e, nesse caso, ela continua a tocar.
• Quando você usa o SDK Manager para instalar ou confirmar que você tem a instalação mais recente do Android P ou a versão chinesa, as caixas de seleção ao lado dessas opções podem ser desmarcadas por conta própria. Se isso acontecer, marque-as novamente.
• Quando o emulador executa uma inicialização a frio, o seguinte erro pode ser mostrado: "Há um problema interno com seu dispositivo. Entre em contato com o fabricante para saber mais detalhes". Isso não afeta a funcionalidade. Role para baixo e clique em OK para começar a testar o app.
• O Instant Run pode ser incompatível com o emulador do Wear.
• Fazer uma captura de tela de forma programática, como por adb ou registrando um relatório de bug, pode não funcionar. Como solução alternativa, clique no botão de câmera da barra de ferramentas do emulador para capturar a tela.

Google Assistente no Wear

O suporte avançado do Google Assistente no Wear OS permite criar uma experiência pronta para wearables sem programar código para Android. Especificamente, você pode criar para a plataforma Actions on Google, ajudando usuários a realizarem tarefas com seus produtos e serviços.

Além disso, o Wear OS agora oferece suporte a interações mais rápidas por voz e toque. Chips de sugestão de resposta também são permitidos. Confira o que eles fazem:

• Ajudam os usuários a realizar interações rapidamente
• Dão dicas aos usuários sobre a capacidade da sua Ação

Agora, o Wear OS também oferece suporte a mais cards visuais, bem como listas e carrosséis.

Você pode usar o DialogFlow, modelos (em inglês) ou o SDK do Actions para criar Actions on Google para o Wear OS. Você também pode usar os novos modelos de resposta específicos para relógios. Exemplos de práticas recomendadas para o Actions on Google:

• Caixas de diálogo breves e concisas
• Feedback visual e por voz

Essas melhorias do Google Assistente no Wear OS não dependem do Android P e serão implementadas para todos os usuários do Wear 2.0. Para conferir uma introdução à criação com o Actions on Google, consulte Integrar com o Google Assistente.

Economia de bateria na prévia para desenvolvedores 2

Conforme descrito na seção a seguir, estão disponíveis recursos para aumentar a duração da bateria. As informações desta seção sobre a prévia para desenvolvedores 2 substituem as informações relacionadas à duração da bateria da prévia para desenvolvedores 1.

Novo modo: economia avançada de bateria

Quando o relógio está no modo de economia avançada de bateria, um mostrador padrão com alimentação otimizada é mostrado. Todas as opções a seguir são desativadas:

• Rádios
• A touch screen
• O recurso de inclinar para ativar

Os usuários podem ver a hora ao tocar no botão lateral. Manter esse botão pressionado permite que o usuário volte a um modo totalmente operacional e realize tarefas, como pagar via NFC ou responder a uma mensagem. Considere que apps, mostradores de relógio e provedores de dados de complemento estarão indisponíveis no modo de economia avançada de bateria.

Atividades limitadas em segundo plano

Para melhorar o gerenciamento de energia, os apps em segundo plano não podem mais iniciar alarmes e jobs, a não ser que o relógio esteja sendo carregado. Exceções incluem os mostradores do relógio e complicações ativas.

Observação: se o app precisar ser executado constantemente, por exemplo, para monitoramento em segundo plano, recomendamos usar um serviço em primeiro plano com o método startForegroundService(). Consulte Limitações de serviços em segundo plano para saber mais. Usar um serviço em primeiro plano é adequado para casos de uso excepcionais, como o monitoramento de saúde.

Melhoria na compatibilidade com apps

Para melhorar a compatibilidade com apps, o Android P começou a implementar determinadas restrições para o uso de interfaces que não fazem parte do SDK. É preciso fazer um planejamento para migrar dos métodos e campos que não fazem parte do SDK. Se nenhum equivalente público estiver disponível para seu caso de uso, entre em contato conosco.

Tema escuro para a interface do sistema

Desde o início de 2018, o Wear OS adotou um tema de interface padrão que tem um plano de fundo mais escuro para o fluxo de notificações e a tela de início do sistema. O objetivo dessa mudança é melhorar a nitidez dos apps. Confira a acessibilidade do app com esse novo tema de interface.

Codelabs atualizados estão disponíveis

Codelabs atualizados estão disponíveis para apresentar formas importantes de desenvolver com o Wear OS. Por exemplo, tente o novo codelab de mostrador de relógio baseado em Kotlin para fazer experimentos com a linguagem específica de domínio do Kotlin ou DSL.

27 de março de 2018 – Prévia para desenvolvedores do Wear OS 1

Esta seção contém informações sobre a prévia para desenvolvedores do Wear OS by Google 1. Esperamos que essa prévia ainda passe por várias atualizações antes do lançamento do produto final. Informe qualquer bug encontrado usando o Issue Tracker do Wear OS by Google. Quanto mais cedo eles forem enviados, maior será a probabilidade de incluirmos as correções na versão final.

Problemas conhecidos

• No app complementar do Wear OS, tocar em Relatar bug do wearable parece funcionar, mas nenhum relatório de bug é gerado. Como alternativa, use adb bugreport.
• Aceitar uma chamada telefônica usando o relógio nem sempre funciona. Nesse caso, o usuário precisa aceitar a chamada diretamente no smartphone.
• Um erro "Problemas de compatibilidade com a API detectados" às vezes é mostrado depois do pareamento ou da inicialização de um app pré-carregado. Essa mensagem de erro desaparece após um curto período e não afeta a usabilidade.
• No menu Configurações do relógio e do emulador, a opção Criar relatório do bug é mostrada duas vezes. Para registrar um relatório de bug, tente usar as duas opções, já que apenas uma delas funciona. Ao tocar na opção que funciona, uma notificação de aviso é exibida, mostrando que um relatório de bug está sendo gerado.
• Na versão chinesa, a entrada de texto por voz causa uma falha no app. Isso ocorre, por exemplo, com a pesquisa por voz ou ao usar o recurso de voz para adicionar um lembrete, já que essa funcionalidade usa APIs de entrada de texto por voz. Para testes, use entradas de teclado ou escritas à mão em vez de entradas de texto por voz.
• A app store do Wear não funciona na versão chinesa. Os desenvolvedores não conseguem atualizar ou instalar novos apps usando esse canal. Recomendamos usar o adb como alternativa para o sideload do aplicativo em testes.

Destaques da versão da prévia para desenvolvedores

A prévia para desenvolvedores 1 inclui os recursos a seguir para testes de apps:

• Atividades limitadas em segundo plano: para melhorar a duração da bateria, os apps em segundo plano não têm mais permissão para usar alarmes e jobs. Exceções incluem mostradores do relógio e complicações selecionadas pelo usuário. Esse recurso será implantado gradualmente nas versões da prévia para desenvolvedores, portanto, é possível que você não o veja imediatamente no relógio.

  Observação: se o app precisar ser executado constantemente, faça uma modificação para usar um serviço em primeiro plano com o método startForegroundService(). Consulte as Restrições de serviços em segundo plano para saber mais.

• Restrições para o uso de interfaces que não fazem parte do SDK: para melhorar a compatibilidade do app, o Android P começou a implementar determinadas restrições para o uso de interfaces que não fazem parte do SDK. É preciso fazer um planejamento para migrar dos métodos e campos que não fazem parte do SDK. Se nenhum equivalente público estiver disponível para seu caso de uso entre em contato conosco.
• Tema escuro do sistema de interface: desde o início de 2018, o Wear OS adotou um tema de interface padrão que tem um plano de fundo mais escuro para o fluxo de notificações e a tela de início do sistema. O objetivo dessa mudança é melhorar a nitidez dos apps. Confira a acessibilidade do app com esse novo tema de interface.
• Rádios são desligados quando o relógio é retirado do pulso: para melhorar a duração da bateria, o rádio Bluetooth, Wi-Fi e celular serão desligados quando o relógio detectar que foi retirado do pulso por um longo período. Esse recurso será implantado gradualmente nas versões da prévia para desenvolvedores. Portanto, é possível que você não o veja inicialmente no relógio. Se ele dificultar o processo de desenvolvimento, é possível desativá-lo pelo adb com este comando:
  adb shell settings put global off_body_radios_off_for_small_battery_enabled 0.
• O Wi-Fi é desligado quando o Bluetooth é desconectado: para melhorar o uso da bateria, o relógio deixará de se conectar automaticamente ao Wi-Fi quando o Bluetooth for desconectado. Exceções incluem quando o app solicitar uma rede de alta largura de banda e quando o relógio estiver conectado a um carregador. Esse recurso será implantado gradualmente nas versões da prévia para desenvolvedores. Portanto, é possível que você não o veja inicialmente no relógio.

Atualizações para a Biblioteca de Suporte de Wearables v2.3.0

A documentação da atualização v2.3.0 da Biblioteca de Suporte de Wearables inclui atualizações de rebranding.

Além disso, a v2.3.0 da biblioteca inclui atualizações relacionadas ao ComplicationDrawable e ao TextRenderer para texto com objetos de marcação anexados a intervalos de texto. Essas classes melhoraram o uso de textos com período. Apenas um determinado subconjunto de períodos tem permissão para ser renderizado para que não pareçam estar fora de lugar no mostrador do relógio. Consulte o método setText para saber quais tipos de período podem ser exibidos.

15 de março de 2018 – Rebranding do Wear

Esta seção contém informações sobre os recursos do Wear OS.

Novo nome do Android Wear

O Android Wear foi renomeado como Wear OS by Google.

27 de fevereiro de 2018 – Atualização do modo ambiente

Esta seção contém informações sobre os novos recursos do Android Wear.

Nova classe para suporte ao modo ambiente

A versão 27.1.0 da Biblioteca de Suporte do Android contém uma nova classe, AmbientModeSupport, que substitui a classe AmbientMode descontinuada. Estamos planejando atualizações para os exemplos nas próximas semanas.

25 de janeiro de 2018 – Emulador final e muito mais

Esta seção contém informações sobre os novos recursos do Android Wear.

Android Emulator: atualização para o Wear

A atualização final para o Android Emulator relacionada ao Wear está disponível para testes de apps com base na versão 26 da API.

Melhorias na Biblioteca de Suporte de Wearables versão 2.2.0

A versão 2.2.0 da Biblioteca de Suporte de Wearables inclui as atualizações descritas abaixo.

Um novo indicador de notificação não lida

Como os usuários querem estar cientes de notificações não lidas, fornecemos um novo indicador: um ponto circunscrito na parte de baixo do mostrador do relógio. Se você preferir gerenciar as notificações por conta própria, use setHideNotificationIndicator para ocultar o indicador padrão e mostrar o seu próprio ou setShowUnreadCountIndicator para mostrar uma contagem de notificações na barra de status.

Personalize a cor do anel externo do indicador de notificação não lida com o método setAccentColor.

Observação: o indicador de notificações não lidas não está ativado na versão de produção do Wear 2.8.0. Teste suas implementações usando o emulador do Wear mais recente. A partir da próxima versão do consumidor do Wear (versão 2.9.0), o indicador de notificações não lidas será exibido por padrão.

Melhorias na classe ComplicationDrawable

A classe ComplicationDrawable inicia uma solicitação de permissão para um mostrador do relógio que é tocado quando o sistema indica um valor de TYPE_NO_PERMISSION. Isso significa que o mostrador não tem permissão para receber os dados de complemento.

Além disso, a classe ComplicationDrawable se invalida quando termina de carregar imagens ou quando um destaque de toque expira. Para responder a essa invalidação, por exemplo, para reexibir o mostrador do relógio, adicione um Drawable.Callback.

Problemas conhecidos

• Se você ativa o Modo Teatro no emulador, conforme descrito em Mudar configurações de tela e brilho, o emulador pode ficar preso nesse modo. Para corrigir esse problema, é preciso limpar os dados do emulador. Consulte Executar e parar um emulador e limpar os dados.
• Na janela de um emulador do nível 25 ou 26 da API, o botão liga/desliga não funciona. Não use o botão liga/desliga. Especificamente, para mudar para o modo ambiente, por exemplo, como se um usuário tivesse coberto a tela com a palma da mão, use o botão liga/desliga da barra de ferramentas do emulador, à direita da tela. Para executar o inicializador do aplicativo no modo interativo, use o botão "Página inicial" da barra de ferramentas do emulador.
• Na versão chinesa do emulador, se você usa o método de entrada de escrita à mão, a tela pode começar a piscar. Então, quando você clicar no botão para acessar o teclado virtual, ele ocupará metade da tela.

18 de dezembro de 2017 – Novo acesso ao Google Play Services

Esta seção contém informações sobre os novos recursos do Android Wear.

Migrar do uso da classe GoogleApiClient

A partir da versão 11.8.0 do Google Play Services, os apps para Wear precisam migrar da classe GoogleApiClient e usar os objetos de cliente da API baseados na classe GoogleApi, bem como a API Tasks.

Observação: essa atualização não se aplica a apps para Android Wear na China, que geralmente usam a versão 10.2.0 do Google Play Services.

Para saber mais, consulte os tópicos abaixo:

• Como migrar apps do Android Wear para a classe GoogleApi
• Acessar APIs do Google
• Wearable class documentation

implementation 'com.android.support:wear:27.0.0'

implementation("com.android.support:wear:27.0.0")