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
9 de setembro de 2026 - - - 1.0.0-alpha18

Declarar dependências

Para adicionar uma dependência ao 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-alpha13"

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

Kotlin

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

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

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-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 estas confirmações.

Mudanças na API

  • Adição do parâmetro useSafeFallbackRendererVersion ao WearWidgetPreview para permitir a visualização de widgets com um conjunto de operações de fallback seguras para hosts mais antigos. (I9c324)

Correções de bugs

  • compileSdk para bibliotecas do Compose atualizado para 37.1. Isso vai exigir a atualização transitiva de compileSdk para todos os apps e bibliotecas que usam o Compose. (I05b0f)
  • Adição de 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 estas confirmações.

Novos recursos

  • Adição de verificações de 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 estas confirmações.

Novos recursos

  • Adição da validação de 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 de lint para definir um plano de fundo preto ou transparente para um widget do Wear (Idedb0, b/529269573)
  • Ativação da operação CORE_TEXT do Remote Compose para o perfil de widgets do Wear. Isso permite que RemoteText use recursos de fontes variáveis, como eixos de fontes, alturas de linhas etc., em renderizadores de host compatíveis, com fallback automático quando indisponível.

Correções

  • Atualização dos KDocs 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 estas confirmações.

Novos recursos

  • Adição de um aviso de lint ao definir um plano de fundo vazio para o 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 estas confirmações.

Mudanças na API

  • Adicionamos provedores de parâmetros de visualização 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)
    • Adição de 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 de widgets executados em hosts mais antigos, propagando operações compatíveis por meio de WearWidgetParams e adicionando a 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 estas confirmações.

Mudanças na API

  • Remoção da verificação de permissão de heartRateAccuracy (I14269, b/522444636)

Correções de bugs

  • Ajustamos os parâmetros do widget do Wear em formato de squircle para visualização 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 estas confirmações.

Novos recursos

  • Adição de AssociateWithGlanceWearWidget, que precisa ser usado no GlanceWearWidgetService para fornecer a implementação de GlanceWearWidget a que 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 em widgets do Wear. (I9a228, b/513481558)

  • Introduzimos uma função auxiliar @Composable, WearWidgetPreview, para simplificar o desenvolvimento de widgets do Glance Wear, removendo o código clichê necessário para visualizações do ambiente de desenvolvimento integrado.

Mudanças na API

  • Renomeação de androidx.glance.wear.health.DataType para 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)
  • API de fluxo captureRemoteDocument exposta 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 estas confirmações.

Mudanças na API

  • Adicionamos WearWidgetPreview para visualizar widgets do Wear no Android Studio. (I36504, b/485147770)
  • Exposição de 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 ao GlanceWearWidget para acionar a atualização em todos os widgets do app especificado. (I6ab20, b/510896410)

Correções de bugs

  • Inclusão de 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)
  • Acionamento do 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 estas confirmações.

Mudanças na API

  • Exposição das APIs glance.wear.health.DataType no widget do Wear. Essas APIs podem ser usadas por desenvolvedores para acessar dados de saúde do sistema.

Correções de bugs

  • Correção de um loop de falhas que ocorria na versão alpha09 no emulador ou dispositivos do Wear 7 que executavam o renderizador 1.6, impedindo que o eixo de fontes vazio fosse enviado ao player para o widget do 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 estas confirmações.

Mudanças na API

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

Correções de bugs

  • Atualização do analisador de metadados XML do widget 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 estas confirmações.

Correções de bugs

  • Adição da 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

  • Reversão de "Atualizações do Compose compileSdk para 37" (I6007), que também se aplica ao glance-wear. Portanto, o requisito do 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 estas confirmações.

Novos recursos

  • Adição do plano de fundo padrão do widget do Wear quando WearWidgetBrush está 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

  • Mudança da API de atualização de widget para usar WidgetInstanceId e adição de 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)
  • Adição de 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 estas confirmações.

Novos recursos

  • Definição das 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 de tela cheia. Isso inclui a reversão do mapeamento do tipo FULLSCREEN anterior 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 estas confirmações.

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 estas confirmações (link em inglês).

Mudanças na API

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

Correções de bugs

  • Exposição de tipos comuns de modificadores e combináveis remotos (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 estas confirmações.

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 estas confirmações.

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 estas confirmações.

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