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
7 ottobre 2026 - - - 1.0.0-alpha20

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:

Groovy

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

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

Kotlin

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

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

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-alpha20

7 ottobre 2026

androidx.glance.wear:wear:1.0.0-alpha20, androidx.glance.wear:wear-core:1.0.0-alpha20 e androidx.glance.wear:wear-tooling-preview:1.0.0-alpha20 sono stati rilasciati. La versione 1.0.0-alpha20 contiene questi commit.

Modifiche alle API

  • Sono state aggiunte le costanti CATEGORY_PROVIDER_CONFIG, EXTRA_CONFIG_WIDGET_ID e EXTRA_CONFIG_PROVIDER_COMPONENT a GlanceWearWidget per la gestione degli intent di configurazione del fornitore di widget. (I32fa4)
  • Il parametro useSafeFallbackRendererVersion in WearWidgetPreview è stato rinominato in useBaselineHostVersion. (I07bca)

Correzioni di bug

  • Sono stati corretti gli aggiornamenti dei widget nell'emulatore del riquadro dei widget quando viene chiamato triggerUpdateAll nelle build di cui è possibile eseguire il debug. (I22d3f)
  • È stato modificato il valore predefinito di useSafeFallbackRendererVersion in WearWidgetPreview da true a false, in modo che le anteprime vengano visualizzate per impostazione predefinita con l'ultima versione del renderer. (Ied6b9)

Versione 1.0.0-alpha19

23 settembre 2026

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 sono stati rilasciati. La versione 1.0.0-alpha19 contiene questi commit.

Solo modifiche ai test interni.

Versione 1.0.0-alpha18

9 settembre 2026

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 sono stati rilasciati. 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 insieme di operazioni supportate di fallback sicuro 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 in caso di utilizzi ridondanti del parametro fontFamily nei widget Wear. (I7730c)

Versione 1.0.0-alpha17

26 agosto 2026

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 sono stati rilasciati. 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 file XML <wearwidget-provider> per i metadati del widget specifichi esplicitamente un attributo di tipo supportato e non definisca tipi duplicati. (I52c9a, b/464458215)

Versione 1.0.0-alpha16

12 agosto 2026

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 sono stati rilasciati. 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 richiesti (come container e previewImage). (Ia9983, b/464458215)
  • È stato aggiunto l'avviso di errore Lint per l'impostazione dello sfondo nero o trasparente per un widget Wear (Idedb0, b/529269573)
  • È stata attivata l'operazione CORE_TEXT Scrivi da remoto per il profilo dei widget di Wear. Ciò consente a RemoteText di utilizzare funzionalità di caratteri variabili, come assi dei caratteri, altezze delle righe e così via, sui renderer host supportati, con fallback automatico quando non è supportato.

Correzioni

  • Aggiornamento della documentazione KDocs per l'annotazione AssociateWithGlanceWearWidget in base al feedback degli sviluppatori

Versione 1.0.0-alpha15

29 luglio 2026

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 sono stati rilasciati. La versione 1.0.0-alpha15 contiene questi commit.

Nuove funzionalità

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

Versione 1.0.0-alpha14

15 luglio 2026

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 sono stati rilasciati. La versione 1.0.0-alpha14 contiene questi commit.

Modifiche alle API

  • Abbiamo aggiunto i fornitori di parametri di anteprima RoundAllWidgetPreviewParams, RoundSmallWidgetPreviewParams e RoundLargeWidgetPreviewParams per widget Glance Wear completamente arrotondati. (If5336, b/512405233)

Nuove funzionalità

  • Abbiamo configurato e aggiunto 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 widget associata utilizzando l'annotazione @AssociateWithGlanceWearWidget. (Idc575, b/477024153)
  • Abbiamo migliorato la compatibilità con le versioni precedenti per i widget in esecuzione su host meno recenti propagando le operazioni supportate tramite WearWidgetParams e aggiungendo il filtro del profilo delle operazioni consentite. (Ib0a1b, I83cb1, [b/526716195])

Versione 1.0.0-alpha13

1° luglio 2026

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 sono stati rilasciati. 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

  • Abbiamo modificato 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

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 sono stati rilasciati. La versione 1.0.0-alpha12 contiene questi commit.

Nuove funzionalità

  • È stato aggiunto AssociateWithGlanceWearWidget che deve essere utilizzato su GlanceWearWidgetService per indicare a quale implementazione di GlanceWearWidget è associato. (Ifcabb, b/514679763)

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

  • Abbiamo aggiunto il pennello image a WearWidgetBrush per supportare gli sfondi bitmap in Wear Widgets. (I9a228, b/513481558)

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

Modifiche alle API

  • androidx.glance.wear.health.DataType è stato rinominato in androidx.glance.wear.health.HealthData (I4cb0b, b/516746689)
  • isHeartRateBpmAvailable è esposto per determinare se heartRateBpm è disponibile sull'host. (I5999d, b/514641567)
  • Operatori di confronto RemoteInt esposti. (I5fe3d, b/513228889)
  • Esposta l'API captureRemoteDocument Flow e un nuovo overload captureSingleRemoteDocument (che accetta RemoteCreationDisplayInfo) come API pubbliche. (I87b0e, b/513228889)
  • Abbiamo aggiunto @CallSuper ai metodi del ciclo di vita di GlanceWearWidgetService

Versione 1.0.0-alpha11

3 giugno 2026

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 sono stati rilasciati. La versione 1.0.0-alpha11 contiene questi commit.

Modifiche alle API

  • Abbiamo aggiunto WearWidgetPreview per l'anteprima dei widget per Wear OS in Android Studio. (I36504, b/485147770)
  • Esporre 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

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

Versione 1.0.0-alpha10

19 maggio 2026

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 sono stati rilasciati. La versione 1.0.0-alpha10 contiene questi commit.

Modifiche alle API

  • Esporre le API glance.wear.health.DataType nel widget Wear. Queste API possono essere utilizzate dagli sviluppatori per accedere ai dati sullo stato del sistema.

Correzioni di bug

  • È stato corretto un ciclo di arresti anomali che si verificava nella versione alpha09 sull'emulatore Wear 7 o sui dispositivi che eseguono il 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

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

Modifiche alle API

  • Abbiamo aggiunto ExperimentalGlanceWearApi che verrà utilizzato per le funzionalità sperimentali di Glance Wear. (Id2f76, b/498179813)

Correzioni di bug

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

Versione 1.0.0-alpha08

22 aprile 2026

androidx.glance.wear:wear:1.0.0-alpha08 e androidx.glance.wear:wear-core:1.0.0-alpha08 sono state rilasciate. 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 "Updates Compose compileSdk to 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

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

Nuove funzionalità

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

Modifiche alle API

  • Modifica l'API di aggiornamento del widget in modo che accetti WidgetInstanceId e aggiungi 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)
  • Aggiungi gradiente verticale e orizzontale in WearWidgetBrush. (If70ae, b/470080675)

Versione 1.0.0-alpha06

25 marzo 2026

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

Nuove funzionalità

  • Definisci le operazioni per il profilo Wear Widgets in linea.

Modifiche alle API

  • Abbiamo rinominato CONTAINER_TYPE_FULLSCREEN in CONTAINER_TYPE_TILE_COMPAT per differenziare meglio il widget di compatibilità a schermo intero. Ciò include il ripristino del mapping del tipo FULLSCREEN precedente a LARGE nei parametri del widget.

Versione 1.0.0-alpha05

11 marzo 2026

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

Modifiche alle API

  • Abbiamo aggiunto 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

androidx.glance.wear:wear:1.0.0-alpha04 e androidx.glance.wear:wear-core:1.0.0-alpha04 sono state rilasciate. 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)
  • Abbiamo spostato le API dalla libreria glance:wear:wear-core al pacchetto androidx.glance.wear.core. (I429cf)

Correzioni di bug

  • Esposizione di tipi comuni di Remote Composable e Modifier (Id1d40)

Versione 1.0.0-alpha03

11 febbraio 2026

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

Modifiche alle API

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

Versione 1.0.0-alpha02

28 gennaio 2026

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

Nuove funzionalità

  • Esegui la re-mappatura di FULLSCREEN su LARGE nei parametri del widget (ad78d95)

Correzioni di bug

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

Versione 1.0.0-alpha01

14 gennaio 2026

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

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