Glance Wear

  
Glance Wear è una libreria per la creazione di widget per Wear OS
Ultimo aggiornamento Release stabile Candidato per la release Release beta Release alpha
9 settembre 2026 - - - 1.0.0-alpha18

Dichiara le dipendenze

Per aggiungere una dipendenza da glance-wear, devi aggiungere il repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle per la tua app o il tuo modulo:

Alla moda

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")
}

Per saperne di più sulle dipendenze, consulta Aggiungere dipendenze di build.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di segnalare un nuovo problema, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Crea un nuovo problema

Per saperne di più, consulta la documentazione di Issue Tracker.

Glance Wear versione 1.0

Versione 1.0.0-alpha18

9 settembre 2026

Sono state rilasciate le versioni 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. La versione 1.0.0-alpha18 contiene questi commit.

Modifiche alle API

  • È stato aggiunto il parametro useSafeFallbackRendererVersion a WearWidgetPreview per consentire l'anteprima dei widget con un set di fallback sicuro di operazioni supportate per gli host precedenti. (I9c324)

Correzioni di bug

  • compileSdk per le librerie Compose aggiornato alla versione 37.1. Ciò richiederà l'aggiornamento transitivo di compileSdk per tutte le app e le librerie che utilizzano Compose. (I05b0f)
  • È stato aggiunto un controllo lint per avvisare dell'utilizzo ridondante del parametro fontFamily nei widget Wear. (I7730c)

Versione 1.0.0-alpha17

26 agosto 2026

Sono state rilasciate le versioni 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. La versione 1.0.0-alpha17 contiene questi commit.

Nuove funzionalità

  • Sono stati aggiunti controlli lint in Glance Wear per garantire che ogni <container> in un XML <wearwidget-provider> per i metadati dei widget specifichi esplicitamente un attributo di tipo supportato e non definisca tipi duplicati. (I52c9a, b/464458215)

Versione 1.0.0-alpha16

12 agosto 2026

Sono state rilasciate le versioni 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. La versione 1.0.0-alpha16 contiene questi commit.

Nuove funzionalità

  • È stata aggiunta la convalida Lint per i metadati XML <wearwidget-provider> per garantire la presenza degli elementi di configurazione obbligatori (come container e previewImage). (Ia9983, b/464458215)
  • È stato aggiunto un avviso di errore Lint per l'impostazione di uno sfondo nero o trasparente per un widget Wear (Idedb0, b/529269573)
  • È stata abilitata l'operazione Remote Compose CORE_TEXT per il profilo dei widget Wear. Ciò consente a RemoteText di utilizzare le funzionalità dei caratteri variabili, come gli assi dei caratteri, le altezze delle righe e così via, sui renderer host supportati, con fallback automatico quando non è supportato.

Correzioni

  • Sono stati aggiornati i KDoc per l'annotazione AssociateWithGlanceWearWidget in base al feedback degli sviluppatori

Versione 1.0.0-alpha15

29 luglio 2026

Sono state rilasciate le versioni 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. La versione 1.0.0-alpha15 contiene questi commit.

Nuove funzionalità

  • È stato aggiunto un avviso Lint quando si imposta uno sfondo vuoto per il documento del widget Wear. (Ic6475, b/529269573)

Versione 1.0.0-alpha14

15 luglio 2026

Sono state rilasciate le versioni 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. La versione 1.0.0-alpha14 contiene questi commit.

Modifiche alle API

  • Sono stati aggiunti i provider di parametri di anteprima RoundAllWidgetPreviewParams, RoundSmallWidgetPreviewParams e RoundLargeWidgetPreviewParams per i widget Glance Wear completamente arrotondati. (If5336, b/512405233)

Nuove funzionalità

  • È stata configurata e aggiunta la libreria Linter per i widget Glance Wear.(If4218, b/527402079)
    • È stato aggiunto un controllo lint per garantire che le sottoclassi di GlanceWearWidgetService dichiarino esplicitamente la classe di widget associata utilizzando l'annotazione @AssociateWithGlanceWearWidget. (Idc575, b/477024153)
  • È stata migliorata la compatibilità con le versioni precedenti per i widget in esecuzione su host precedenti propagando le operazioni supportate tramite WearWidgetParams e aggiungendo il filtro del profilo delle operazioni consentite a queste. (Ib0a1b, I83cb1, [b/526716195])

Versione 1.0.0-alpha13

1° luglio 2026

Sono state rilasciate le versioni 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. La versione 1.0.0-alpha13 contiene questi commit.

Modifiche alle API

  • È stato rimosso il controllo delle autorizzazioni da heartRateAccuracy (I14269, b/522444636)

Correzioni di bug

  • Sono stati modificati i parametri del widget Wear a forma di squircle per l'anteprima in base al feedback sull'esperienza utente

Versione 1.0.0-alpha12

17 giugno 2026

Sono state rilasciate le versioni 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. La versione 1.0.0-alpha12 contiene questi commit.

Nuove funzionalità

  • È stata aggiunta l'annotazione AssociateWithGlanceWearWidget che deve essere utilizzata in GlanceWearWidgetService per indicare a quale implementazione di GlanceWearWidget è associata. (Ifcabb, b/514679763)

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

  • È stato aggiunto il pennello image a WearWidgetBrush per supportare gli sfondi bitmap nei widget Wear. (I9a228, b/513481558)

  • È stata introdotta una funzione helper @Composable, WearWidgetPreview, per semplificare lo sviluppo dei widget Glance Wear rimuovendo il codice boilerplate richiesto per le anteprime IDE.

Modifiche alle API

  • È stato rinominato androidx.glance.wear.health.DataType in androidx.glance.wear.health.HealthData (I4cb0b, b/516746689)
  • isHeartRateBpmAvailable è esposto per determinare se heartRateBpm è disponibile sull'host. (I5999d, b/514641567)
  • Sono stati esposti gli operatori di confronto RemoteInt. (I5fe3d, b/513228889)
  • Sono state esposte l'API Flow captureRemoteDocument e una nuova API captureSingleRemoteDocument (che accetta RemoteCreationDisplayInfo) come API pubbliche. (I87b0e, b/513228889)
  • È stato aggiunto @CallSuper ai metodi del ciclo di vita di GlanceWearWidgetService

Versione 1.0.0-alpha11

3 giugno 2026

Sono state rilasciate le versioni 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. La versione 1.0.0-alpha11 contiene questi commit.

Modifiche alle API

  • È stato aggiunto WearWidgetPreview per l'anteprima dei widget Wear in Android Studio. (I36504, b/485147770)
  • Sono state esposte le variabili is*Available (isDailyStepsAvailable, e così via) per verificare se il tipo di dati sanitari correlato è disponibile e valido. (Ib98a7, b/498179656)
  • È stata aggiunta l'API triggerUpdateAll a GlanceWearWidget per attivare l'aggiornamento di tutti i widget dell'app specificata. (I6ab20, b/510896410)

Correzioni di bug

  • Sono state incluse le informazioni sulla versione del renderer nel campo interno WearWidgetParams per evitare interruzioni nel documento generato con la versione alpha10. (Idcf8e, b/511263591, b/512830184)
  • È stato attivato il flusso di aggiornamento forzato in modalità di debug o nell'emulatore per i widget Wear.

Versione 1.0.0-alpha10

19 maggio 2026

Sono state rilasciate le versioni 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. La versione 1.0.0-alpha10 contiene questi commit.

Modifiche alle API

  • Sono state esposte le API glance.wear.health.DataType nel widget Wear. Gli sviluppatori possono utilizzare queste API per accedere ai dati sulla salute del sistema.

Correzioni di bug

  • È stato corretto un loop di arresti anomali che si verificava nella versione alpha09 sull'emulatore Wear 7 o sui dispositivi con renderer 1.6 non consentendo l'invio di assi dei caratteri vuoti al Player per il widget Glance Wear.

Versione 1.0.0-alpha09

6 maggio 2026

Sono state rilasciate le versioni androidx.glance.wear:wear:1.0.0-alpha09 e androidx.glance.wear:wear-core:1.0.0-alpha09. La versione 1.0.0-alpha09 contiene questi commit.

Modifiche alle API

  • È stata aggiunta l'API ExperimentalGlanceWearApi che verrà utilizzata per le funzionalità sperimentali di Glance Wear. (Id2f76, b/498179813)

Correzioni di bug

  • È stato aggiornato il parser per i metadati XML dei widget Wear in modo che riconosca i widget durante l'avvio.

Versione 1.0.0-alpha08

22 aprile 2026

Sono state rilasciate le versioni androidx.glance.wear:wear:1.0.0-alpha08 e androidx.glance.wear:wear-core:1.0.0-alpha08. La versione 1.0.0-alpha08 contiene questi commit.

Correzioni di bug

  • È stato aggiunto il tag <queries> al manifest della libreria glance:wear:wear per assicurarsi che PackageManager esegua query sui servizi corretti per gli aggiornamenti push. (I192787)

Altro

  • È stato ripristinato "Aggiorna compileSdk di Compose alla versione 37" (I6007), che si applica anche a glance-wear, quindi il requisito compileSdk non è più 37 in questa release.

Versione 1.0.0-alpha07

8 aprile 2026

Sono state rilasciate le versioni androidx.glance.wear:wear:1.0.0-alpha07 e androidx.glance.wear:wear-core:1.0.0-alpha07. La versione 1.0.0-alpha07 contiene questi commit.

Nuove funzionalità

  • È stato aggiunto lo sfondo predefinito del widget Wear quando WearWidgetBrush è vuoto o non specificato. (I8300b)
  • È stata aggiornata l'API getActiveWidgets per restituire il tipo di contenitore del widget. (2772eb1)

Modifiche alle API

  • È stata modificata l'API di aggiornamento dei widget in modo che accetti WidgetInstanceId e sia stato aggiunto un helper per recuperare gli ID di un determinato widget. La nuova API genera IllegalArgumentException se l'ID fornito non è valido o non è di proprietà del chiamante. (I6f3c5, b/446828899)
  • È stato aggiunto il gradiente verticale e orizzontale in WearWidgetBrush. (If70ae, b/470080675)

Versione 1.0.0-alpha06

25 marzo 2026

Sono state rilasciate le versioni androidx.glance.wear:wear:1.0.0-alpha06 e androidx.glance.wear:wear-core:1.0.0-alpha06. La versione 1.0.0-alpha06 contiene questi commit.

Nuove funzionalità

  • Le operazioni per il profilo dei widget Wear sono definite in linea.

Modifiche alle API

  • È stato rinominato CONTAINER_TYPE_FULLSCREEN in CONTAINER_TYPE_TILE_COMPAT per distinguere meglio il widget di compatibilità a schermo intero. Ciò include il ripristino del tipo FULLSCREEN precedentemente mappato su LARGE nei parametri del widget.

Versione 1.0.0-alpha05

11 marzo 2026

Sono state rilasciate le versioni androidx.glance.wear:wear:1.0.0-alpha05 e androidx.glance.wear:wear-core:1.0.0-alpha05. La versione 1.0.0-alpha05 contiene questi commit.

Modifiche alle API

  • È stata aggiunta l'API WearWidgetBrush con il metodo color da utilizzare per lo sfondo del widget Wear. (I66f54, b/464273091)
  • Il metodo fetchActiveWidgetsForProvider è stato rimosso perché esiste già fetchActiveWidgets. (I85e4e, b/486197890)

Versione 1.0.0-alpha04

25 febbraio 2026

Sono state rilasciate le versioni androidx.glance.wear:wear:1.0.0-alpha04 e androidx.glance.wear:wear-core:1.0.0-alpha04. La versione 1.0.0-alpha04 contiene questi commit.

Modifiche alle API

  • È stata aggiunta l'API GlanceWearWidgetManager per consentire alle app di eseguire query sui widget e sui riquadri attivi. (I5be95)
  • Le API sono state spostate dalla libreria glance:wear:wear-core al pacchetto androidx.glance.wear.core. (I429cf)

Correzioni di bug

  • Sono stati esposti i tipi di modificatori e composable remoti comuni (Id1d40)

Versione 1.0.0-alpha03

11 febbraio 2026

Sono state rilasciate le versioni androidx.glance.wear:wear:1.0.0-alpha03 e androidx.glance.wear:wear-core:1.0.0-alpha03. La versione 1.0.0-alpha03 contiene questi commit.

Modifiche alle API

  • È stato aggiunto il supporto per gli eventi di interazione a GlanceWearWidget. (Ia4e28, b/469808447)

Versione 1.0.0-alpha02

28 gennaio 2026

Sono state rilasciate le versioni androidx.glance.wear:wear:1.0.0-alpha02 e androidx.glance.wear:wear-core:1.0.0-alpha02. La versione 1.0.0-alpha02 contiene questi commit.

Nuove funzionalità

  • È stato rimappato FULLSCREEN su LARGE nei parametri del widget (ad78d95)

Correzioni di bug

  • È stato corretto l'utilizzo di DataStore che impediva la visualizzazione di più istanze di widget (474f3e4)

Versione 1.0.0-alpha01

14 gennaio 2026

Sono state rilasciate le versioni androidx.glance.wear:wear:1.0.0-alpha01 e androidx.glance.wear:wear-core:1.0.0-alpha01. La versione 1.0.0-alpha01 contiene questi commit.

  • Glance Wear è una libreria per la creazione di widget per Wear OS utilizzando RemoteCompose.