Glance Wear

  
O Glance Wear é uma biblioteca para criar widgets para o Wear OS.
Atualização mais recente Versão estável Versão candidata a lançamento Versão Beta Versão Alfa
23 de setembro de 2026 - - - 1.0.0-alpha19

Declarar dependências

Para adicionar uma dependência à biblioteca glance-wear, adicione o repositório Maven do Google ao seu projeto. Leia Repositório Maven do Google para ver mais informações.

Adicione as dependências dos artefatos necessários ao arquivo build.gradle do seu app ou módulo:

Groovy

dependencies {
    implementation "androidx.glance.wear:wear:1.0.0-alpha19"

    implementation "androidx.glance.wear:wear-core:1.0.0-alpha19"
}

Kotlin

dependencies {
    implementation("androidx.glance.wear:wear:1.0.0-alpha19")

    implementation("androidx.glance.wear:wear-core:1.0.0-alpha19")
}

Para mais informações sobre dependências, consulte Adicionar dependências de build.

Feedback

Seu feedback ajuda a melhorar o Jetpack. Avise se você descobrir novos problemas ou tiver ideias para melhorar esta biblioteca. Consulte os problemas conhecidos nesta biblioteca antes de criar um novo. Adicione seu voto a um problema clicando no botão de estrela.

Criar novo problema

Consulte a documentação do Issue Tracker para saber mais.

Glance Wear: versão 1.0

Versão 1.0.0-alpha19

23 de setembro de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha19, androidx.glance.wear:wear-core:1.0.0-alpha19 e androidx.glance.wear:wear-tooling-preview:1.0.0-alpha19. A versão 1.0.0-alpha19 contém estes commits.

Mudanças apenas para testes internos.

Versão 1.0.0-alpha18

9 de setembro de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha18, androidx.glance.wear:wear-core:1.0.0-alpha18 e androidx.glance.wear:wear-tooling-preview:1.0.0-alpha18. A versão 1.0.0-alpha18 contém estes commits.

Mudanças na API

  • Adicionado o parâmetro useSafeFallbackRendererVersion a WearWidgetPreview para permitir a visualização de widgets com um conjunto de operações compatíveis de substituição segura para hosts mais antigos. (I9c324).

Correções de bugs

  • O compileSdk para bibliotecas do Compose foi atualizado para a versão 37.1. Isso vai exigir a atualização transitiva do compileSdk para todos os apps e bibliotecas que usam o Compose. (I05b0f).
  • Adicionamos uma verificação de lint para alertar sobre usos redundantes do parâmetro fontFamily em widgets do Wear. (I7730c).

Versão 1.0.0-alpha17

26 de agosto de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha17, androidx.glance.wear:wear-core:1.0.0-alpha17 e androidx.glance.wear:wear-tooling-preview:1.0.0-alpha17. A versão 1.0.0-alpha17 contém estes commits.

Novos recursos

  • Adição de verificações do lint no Glance Wear para garantir que cada <container> em um XML <wearwidget-provider> para metadados de widget especifique explicitamente um atributo de tipo compatível e não defina tipos duplicados. (I52c9a, b/464458215)

Versão 1.0.0-alpha16

12 de agosto de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha16, androidx.glance.wear:wear-core:1.0.0-alpha16 e androidx.glance.wear:wear-tooling-preview:1.0.0-alpha16. A versão 1.0.0-alpha16 contém estes commits.

Novos recursos

  • Adicionamos a validação do Lint para metadados XML <wearwidget-provider> para garantir que os elementos de configuração necessários (como container e previewImage) estejam presentes. (Ia9983, b/464458215)
  • Adição de um aviso de erro do Lint para definir um plano de fundo preto ou transparente em um widget do Wear (Idedb0, b/529269573).
  • Ativada a operação CORE_TEXT Remote Compose para o perfil de widgets do Wear. Isso permite que o RemoteText use recursos de fontes variáveis, como eixos de fontes, alturas de linha etc., em renderizadores de host compatíveis, com fallback automático quando indisponível.

Correções

  • KDocs atualizados para a anotação AssociateWithGlanceWearWidget de acordo com o feedback dos desenvolvedores.

Versão 1.0.0-alpha15

29 de julho de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha15, androidx.glance.wear:wear-core:1.0.0-alpha15 e androidx.glance.wear:wear-tooling-preview:1.0.0-alpha15. A versão 1.0.0-alpha15 contém estes commits.

Novos recursos

  • Adição de um aviso do Lint ao definir um plano de fundo vazio no documento do widget do Wear. (Ic6475, b/529269573)

Versão 1.0.0-alpha14

15 de julho de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha14, androidx.glance.wear:wear-core:1.0.0-alpha14 e androidx.glance.wear:wear-tooling-preview:1.0.0-alpha14. A versão 1.0.0-alpha14 contém estes commits.

Mudanças na API

  • Adicionamos provedores de parâmetros de prévia RoundAllWidgetPreviewParams, RoundSmallWidgetPreviewParams e RoundLargeWidgetPreviewParams para widgets do Glance Wear totalmente arredondados. (If5336, b/512405233)

Novos recursos

  • Configuramos e adicionamos a biblioteca Linter para widgets do Glance Wear.(If4218, b/527402079)
    • Adicionamos uma verificação de lint para garantir que as subclasses de GlanceWearWidgetService declarem explicitamente a classe de widget associada usando a anotação @AssociateWithGlanceWearWidget. (Idc575, b/477024153)
  • Melhoramos a compatibilidade com versões anteriores para widgets executados em hosts mais antigos propagando operações compatíveis via WearWidgetParams e adicionando filtragem do perfil de operações permitidas a eles. (Ib0a1b, I83cb1, [b/526716195])

Versão 1.0.0-alpha13

1º de julho de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha13, androidx.glance.wear:wear-core:1.0.0-alpha13 e androidx.glance.wear:wear-tooling-preview:1.0.0-alpha13. A versão 1.0.0-alpha13 contém estes commits.

Mudanças na API

  • A verificação de permissão foi removida de heartRateAccuracy (I14269, b/522444636).

Correções de bugs

  • Ajustamos os parâmetros do widget do Wear em formato de squircle para prévia de acordo com o feedback da UX

Versão 1.0.0-alpha12

17 de junho de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha12, androidx.glance.wear:wear-core:1.0.0-alpha12 e androidx.glance.wear:wear-tooling-preview:1.0.0-alpha12. A versão 1.0.0-alpha12 contém estes commits.

Novos recursos

  • Adição de AssociateWithGlanceWearWidget, que precisa ser usado no GlanceWearWidgetService para informar a qual implementação de GlanceWearWidget ele está associado. (Ifcabb, b/514679763)

    • Exemplo:
     @AssociateWithGlanceWearWidget(MyGlanceWearWidget::class)
 class MyGlanceWearWidgetService : GlanceWearWidgetService() {
   override val widget = MyGlanceWearWidget()
 }
 ```

  • Adicionamos o pincel image ao WearWidgetBrush para oferecer suporte a planos de fundo de bitmap nos widgets do Wear. (I9a228, b/513481558)

  • Introduzimos uma função auxiliar @Composable, WearWidgetPreview, para simplificar o desenvolvimento de widgets do Glance Wear removendo o boilerplate necessário para prévias do IDE.

Mudanças na API

  • androidx.glance.wear.health.DataType foi renomeado como androidx.glance.wear.health.HealthData (I4cb0b, b/516746689).
  • isHeartRateBpmAvailable é exposto para determinar se heartRateBpm está disponível no host. (I5999d, b/514641567)
  • Operadores de comparação RemoteInt expostos. (I5fe3d, b/513228889).
  • Exposição da API captureRemoteDocument Flow e uma nova sobrecarga captureSingleRemoteDocument (que usa RemoteCreationDisplayInfo) como APIs públicas. (I87b0e, b/513228889)
  • Adicionamos @CallSuper aos métodos de ciclo de vida GlanceWearWidgetService

Versão 1.0.0-alpha11

3 de junho de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha11, androidx.glance.wear:wear-core:1.0.0-alpha11 e androidx.glance.wear:wear-tooling-preview:1.0.0-alpha11. A versão 1.0.0-alpha11 contém estes commits.

Mudanças na API

  • Adicionamos WearWidgetPreview para visualizar widgets do Wear no Android Studio. (I36504, b/485147770)
  • Exponha variáveis is*Available (isDailyStepsAvailable etc.) para verificar se o tipo de dados de saúde relacionado está disponível e é válido. (Ib98a7, b/498179656)
  • Adição da API triggerUpdateAll a GlanceWearWidget para acionar a atualização em todos os widgets do app especificado. (I6ab20, b/510896410)

Correções de bugs

  • Inclua informações da versão do renderizador no WearWidgetParams como um campo interno para evitar falhas no documento gerado com a versão alpha10. (Idcf8e, b/511263591, b/512830184).
  • Acione o fluxo de atualização de extração forçada no modo de depuração ou emulador para widgets do Wear.

Versão 1.0.0-alpha10

19 de maio de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha10, androidx.glance.wear:wear-core:1.0.0-alpha10 e androidx.glance.wear:wear-tooling-preview:1.0.0-alpha10. A versão 1.0.0-alpha10 contém estes commits.

Mudanças na API

  • Exponha as APIs glance.wear.health.DataType no widget do Wear. Essas APIs podem ser usadas por desenvolvedores para acessar dados de integridade do sistema.

Correções de bugs

  • Correção de um loop de falhas na versão alpha09 no emulador do Wear 7 ou em dispositivos que executam o renderizador 1.6 ao não permitir que eixos de fontes vazios sejam enviados ao Player para o widget Glance Wear.

Versão 1.0.0-alpha09

6 de maio de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha09 e androidx.glance.wear:wear-core:1.0.0-alpha09. A versão 1.0.0-alpha09 contém estes commits.

Mudanças na API

  • Adicionamos ExperimentalGlanceWearApi, que será usado para recursos experimentais do Glance Wear. (Id2f76, b/498179813)

Correções de bugs

  • Atualizamos o analisador de metadados XML de widgets do Wear para reconhecer widgets durante a inicialização.

Versão 1.0.0-alpha08

22 abril de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha08 e androidx.glance.wear:wear-core:1.0.0-alpha08. A versão 1.0.0-alpha08 contém estes commits.

Correções de bugs

  • Adicionada a tag <queries> ao manifesto da biblioteca glance:wear:wear para garantir que o PackageManager consulte os serviços corretos para atualizações push. (I192787)

Outro

  • Revertemos "Atualiza o compileSdk do Compose para 37" (I6007), que também se aplica ao glance-wear. Assim, o requisito compileSdk não é mais 37 nesta versão.

Versão 1.0.0-alpha07

8 de abril de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha07 e androidx.glance.wear:wear-core:1.0.0-alpha07. A versão 1.0.0-alpha07 contém estes commits.

Novos recursos

  • Adicione o plano de fundo padrão do widget do Wear quando WearWidgetBrush estiver vazio ou não especificado. (I8300b).
  • Atualização da API getActiveWidgets para retornar o tipo de contêiner do widget. (2772eb1)

Mudanças na API

  • Mude a API de atualização do widget para usar WidgetInstanceId e adicione um auxiliar para buscar IDs de um determinado widget. A nova API gera IllegalArgumentException se o ID fornecido for inválido ou não pertencer ao autor da chamada. (I6f3c5, b/446828899)
  • Adicione gradiente vertical e horizontal em WearWidgetBrush. (If70ae, b/470080675)

Versão 1.0.0-alpha06

25 de março de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha06 e androidx.glance.wear:wear-core:1.0.0-alpha06. A versão 1.0.0-alpha06 contém estes commits.

Novos recursos

  • Defina as operações para o perfil de widgets do Wear inline.

Mudanças na API

  • Renomeamos CONTAINER_TYPE_FULLSCREEN para CONTAINER_TYPE_TILE_COMPAT para diferenciar melhor o widget de compatibilidade com tela cheia. Isso inclui a reversão do mapeamento do tipo FULLSCREEN para LARGE nos parâmetros do widget.

Versão 1.0.0-alpha05

11 de março de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha05 e androidx.glance.wear:wear-core:1.0.0-alpha05. A versão 1.0.0-alpha05 contém estes commits.

Mudanças na API

  • Adicionamos a API WearWidgetBrush com o método color para ser usado no plano de fundo do widget do Wear. (I66f54, b/464273091)
  • O método fetchActiveWidgetsForProvider foi removido porque já existe fetchActiveWidgets. (I85e4e, b/486197890)

Versão 1.0.0-alpha04

25 de fevereiro de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha04 e androidx.glance.wear:wear-core:1.0.0-alpha04. A versão 1.0.0-alpha04 contém estes commits.

Mudanças na API

  • Adicionada a API GlanceWearWidgetManager para permitir que os apps consultem widgets e blocos ativos. (I5be95).
  • Movemos APIs da biblioteca glance:wear:wear-core para o pacote androidx.glance.wear.core. (I429cf).

Correções de bugs

  • Expor tipos comuns de combináveis remotos e modificadores (Id1d40)

Versão 1.0.0-alpha03

11 de fevereiro de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha03 e androidx.glance.wear:wear-core:1.0.0-alpha03. A versão 1.0.0-alpha03 contém estes commits.

Mudanças na API

  • Adição de suporte a eventos de interação ao GlanceWearWidget. (Ia4e28, b/469808447)

Versão 1.0.0-alpha02

28 de janeiro de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha02 e androidx.glance.wear:wear-core:1.0.0-alpha02. A versão 1.0.0-alpha02 contém estes commits.

Novos recursos

  • Remapeamento de FULLSCREEN para LARGE nos parâmetros do widget (ad78d95).

Correções de bugs

  • Correção do uso do DataStore que impedia a exibição de várias instâncias de widget (474f3e4)

Versão 1.0.0-alpha01

14 de janeiro de 2026

Lançamento de androidx.glance.wear:wear:1.0.0-alpha01 e androidx.glance.wear:wear-core:1.0.0-alpha01. A versão 1.0.0-alpha01 contém estes commits.

  • O Glance Wear é uma biblioteca para criar widgets para Wear OS usando o RemoteCompose.