Glance Wear

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:

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

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

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

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

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-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 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 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 e uma nova sobrecarga captureSingleRemoteDocument (que usa RemoteCreationDisplayInfo) expostas 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)
• Variáveis is*Available (isDailyStepsAvailable etc.) expostas 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 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

• APIs glance.wear.health.DataType expostas 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 em dispositivos do Wear 7 que executavam o renderizador 1.6, impedindo que o eixo de fonte 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 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 do 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 composições remotas (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.