Glance Wear

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:

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

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-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 codice standard richiesto per le anteprime IDE.

Modifiche alle API

• androidx.glance.wear.health.DataType 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)
• Esposizione dell'API captureRemoteDocument Flow e di un nuovo overload captureSingleRemoteDocument (che accetta RemoteCreationDisplayInfo) come API pubbliche. (I87b0e, b/513228889)
• Abbiamo aggiunto @CallSuper ai metodi del ciclo di vita 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 Wear 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 in 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 dei 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 dei widget per Wear inline.

Modifiche alle API

• Abbiamo rinominato CONTAINER_TYPE_FULLSCREEN in CONTAINER_TYPE_TILE_COMPAT per distinguere meglio il widget di compatibilità a schermo intero. Ciò include il ripristino della mappatura 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 nuovamente la 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.