Esta página contém informações sobre as versões do Wear OS, como o SDK e a Biblioteca de Suporte de Wearables.
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
New components for connecting with Google Play services
When you use classes that extend the
GoogleApi
class, such as
DataClient
and
MessageClient
, the Google Play services SDK manages
connections to Google Play services for you. Apps that use these classes no longer need to
create and manage GoogleApiClient
objects. See the blog post
Moving Past GoogleApiClient for more information.
For the replacements of Wear-related components for connecting to Google
Play services, see
Replacements for deprecated components.
For releases and known issues related to
Google Play services, see the Release Notes for
Google Play services.
Note: If you compile your app with the latest version of
Google Play services, users are prompted to update their devices to that
latest version. However, a known issue for apps that target API version
26 might prevent users from being prompted to update their devices. This
issue is described in the Release Notes for
Google Play services.
2017-Oct-25 Ambient mode and more
This section contains information about new Android Wear features.
Android Support Library, v27.0.0: Features and bugfixes
The
27.0.0 version of the Android Support Library contains new features
for Wear. Review the following section.
New, preferred way to support ambient mode
Ambient mode lets a Wear app remain visible to a user when the
device goes idle. The Android Support Library has a new,
preferred way for your apps to use ambient mode. The Wear team seeks
developer feedback about this significant change.
Specifically, using the
AmbientMode
class offers the following benefits:
- The
Activity
subclasses in the Android Support Library, such as
FragmentActivity
. Functionality for
support library fragments is available.
-
Architecture components, which are
lifecycle aware.
- Better support for Google
Sign-In.
Manifest metadata constants in the Android Support Library
Constants for Android Wear apps, used in the meta-data
tag
in the Android Manifest file, are now
available in the Android Support Library. To use the constants—for
standalone apps, notification bridging mode, and watch face preview
images—add a reference to the following in the dependencies section of
the app module's build.gradle
file, which requires the latest
version of the Google Repository:
Groovy
implementation 'com.android.support:wear:27.0.0'
Kotlin
implementation("com.android.support:wear:27.0.0")
Action drawer updates
Updates are available to the
WearableActionDrawerView
class, which is used for creating a wearable
action drawer. In the latest version:
- When menu items are modified, the action drawer properly updates.
- If set for an action drawer, the title displays correctly.
Inflation of the RoundedDrawable class
Assuming an API level of at least 24, the
RoundedDrawable
class can now be inflated from a drawable XML file;
see
Custom drawables.
Wearable Support Library, v2.1.0: Enhancements and more
The
2.1.0 version of the Wearable Support Library includes the updates
described in the following section, and requires Android Support Library version 26.0.2 or
higher.
Supply burn-in-safe images for ambient mode
The
ComplicationDrawable
class lets you supply burn-in-safe
images for ambient mode. Specifically, a
ComplicationData
object's burn-in protection small
image field lets a watch face display a small image in the
SMALL_IMAGE
complication type, in ambient mode, when burn-in
protection is enabled.
Tap event updates for complications
The
ComplicationDrawable
class has a new onTap
method
that lets your watch face pass tap events to complications. The new
method builds on the existing functionality in which a tap on the watch
face triggers the
WatchFaceService.Engine.onTapCommand
method.
You can pass the coordinates to a ComplicationDrawable
with
an onTap
call to launch the action associated with the
ComplicationDrawable
that contains the tap coordinates. When
the new onTap
method is called, you can use a return value
of true
to see whether a ComplicationDrawable
launched the action associated with it.
Additionally, the setHighlightDuration
method sets the
duration for a complication to remain highlighted after the
onTap
method is called.
Progress bar for ranged value complications
If you prefer to draw your own progress bar for ranged value
complications in your watch face, use the
setRangedValueProgressHidden
method of the
ComplicationDrawable
class to hide the ranged value progress
that's drawn by the ComplicationDrawable
.
2017-Oct-02 Android Wear beta
Date: 2017-Oct-02
Build: OWP4.170828.008
Supported device: LG Watch Sport
This section contains known issues for an Android Wear beta release. For
information about the beta program or to enroll,
see the
Android beta page.
Known issues
- Google Pay and its cards do not function with this Android Wear beta
release.
- Even if cellular connectivity is on, it is turned off after the beta
is installed. As a workaround, turn on cellular connectivity after
the beta is installed by navigating to
Settings > Connectivity > Cellular.
- If notifications are erratic or missing after a beta update,
or contacts were not synced, factory-reset your watch.
- In the Wear tutorial, which starts after a watch is set up, some cards
behave erratically, but they can be dismissed normally with a swipe.
- On Android 6.0 phones, phone call notifications are not
received on the watch.
- Heart rate monitoring sometimes fails after an update. As a workaround,
reboot the watch.
- The OTA card in the stream sometimes fails to enable an installation.
As a workaround, navigate to
Settings > System > About > System Updates.