Riepilogo

Crea layout per piattaforme remote utilizzando un'API in stile Jetpack Compose.
Ultimo aggiornamento Release stabile Candidato per la release Versione beta Versione alpha
7 maggio 2025 1.1.1 - - 1.2.0-alpha01

Dichiarazione delle dipendenze

Per aggiungere una dipendenza da Glance, devi aggiungere il repository Maven di Google al tuo progetto. Per ulteriori informazioni, consulta il repository Maven di Google.

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

Alla moda

dependencies {
    // For Glance support
    implementation "androidx.glance:glance:1.2.0-alpha01"
    // For AppWidgets support
    implementation "androidx.glance:glance-appwidget:1.2.0-alpha01"

    // For Wear-Tiles support
    implementation "androidx.glance:glance-wear-tiles:1.0.0-alpha05"
}

android {
    buildFeatures {
        compose true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Kotlin

dependencies {
    // For Glance support
    implementation("androidx.glance:glance:1.2.0-alpha01")
    
    // For AppWidgets support
    implementation("androidx.glance:glance-appwidget:1.2.0-alpha01")

    // For Wear-Tiles support
    implementation("androidx.glance:glance-wear-tiles:1.0.0-alpha05")
}

android {
    buildFeatures {
        compose = true
    }

    composeOptions {
        kotlinCompilerExtensionVersion = "1.1.0-beta03"
    }

    kotlinOptions {
        jvmTarget = "1.8"
    }
}

Per ulteriori informazioni sulle dipendenze, consulta Aggiungere dipendenze di compilazione.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di crearne uno nuovo, 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.

Creare un nuovo problema

Per ulteriori informazioni, consulta la documentazione del Tracker dei problemi.

Versione 1.2

Versione 1.2.0-alpha01

7 maggio 2025

androidx.glance:glance-*:1.2.0-alpha01 viene rilasciato. La versione 1.2.0-alpha01 contiene questi commit.

Modifiche all'API

  • currentCompositeKeyHash è stato deprecato. Utilizza invece currentCompositeKeyHashCode. L'API sostitutiva codifica lo stesso hash con più bit, il che riduce in modo esponenziale la possibilità che due gruppi indipendenti casuali nella gerarchia della composizione abbiano la stessa chiave hash.(I4cb6a, b/177562901)
  • Aggiunge una nuova API per specificare l'alpha (da 0f a 1f) per il componente componibile immagine di Riepilogo e il modificatore dell'immagine di sfondo. Se non specificato, viene mantenuto l'alpha dell'immagine di origine. (I8ad05)
  • Aggiungi API Glance per le anteprime generate. Sostituisci GlanceAppWidget.providePreview per fornire un layout di anteprima per il widget. Quindi, chiama GlanceAppWidgetManager.setWidgetPreview per impostare l'anteprima. (Iced16)
  • Aggiungi MultiProcessGlanceAppWidget per supportare le configurazioni multiprocesso (Idbb90)
  • Viene rimosso il tag sperimentale, ora supportiamo le funzioni lambda (I74d98, b/299361317)
  • Consentire di specificare il ricevitore lambda per GlanceAppWidget.runComposition (I84829)
  • Aggiungi il parametro previewSize a requestPinGlanceAppWidget (I9f8f0, b/303256067)

Correzioni di bug

  • È stato rimosso il riepilogo manuale dell'accesso alle nuove API di piattaforma, poiché avviene automaticamente tramite la definizione del modello API quando si utilizza R8 con AGP 7.3 o versioni successive (ad es. R8 versione 3.3) e per tutte le build quando si utilizza AGP 8.1 o versioni successive (ad es. D8 versione 8.1). I clienti che non utilizzano AGP sono invitati a eseguire l'aggiornamento alla versione 8.1 o successive di D8. Consulta questo articolo per ulteriori dettagli. (If6b4c, b/345472586)
  • Aggiorna le librerie glance-appwidget alla versione compileSdk 35 (I2e26b)

Versione 1.1

Versione 1.1.1

16 ottobre 2024

androidx.glance:glance-*:1.1.1 viene rilasciato. La versione 1.1.1 contiene questi commit.

Correzioni relative alla sicurezza

  • A partire da questa modifica, androidx viene compilato in base a protobuf 4.28.2 per risolvere il problema CVE-2024-7254. Esegui l'upgrade della dipendenza dalla versione 1.1.0 di androidx.glance:glance-appwidget-proto e androidx.glance:glance-appwidget-external-protobuf alla versione 1.1.1 per risolvere il rischio di vulnerabilità.

Versione 1.1.0

12 giugno 2024

androidx.glance:glance-*:1.1.0 viene rilasciato. La versione 1.1.0 contiene questi commit.

Modifiche importanti dalla versione 1.0.0

  • Passa Glance alla versione stabile 1.1.0.

Versione 1.1.0-rc01

14 maggio 2024

androidx.glance:glance-*:1.1.0-rc01 viene rilasciato. La versione 1.1.0-rc01 contiene questi commit.

Nuove funzionalità

  • Sono stati aggiunti i parametri di larghezza e altezza alle annotazioni di anteprima per la funzionalità Riepilogo. Sposta 1.1.0 in Candidato per la release.

Modifiche all'API

  • Aggiunge un parametro facoltativo a Scaffold. (If753f)
  • Aggiungi i parametri di larghezza e altezza a Riepilogo @Preview. (Ibabe8)
  • È stato rimosso il supporto delle anteprime dei riquadri di Wear OS. (I3850a)
  • È stata aggiunta l'API per l'impostazione di valori di peso personalizzati per FontStyle. (I7390a)
  • Rinomina gli enum ImplementationMode di Viewfinder per riflettere meglio le implementazioni sottostanti e aggiungi costanti fisse per TransformationInfo.sourceRotation (Ic6149)

Correzioni di bug

  • È stato corretto un bug che causava problemi di rendering per ViewGroups in modalità di compatibilità con le versioni precedenti (I8de92)

Contributo esterno

Versione 1.1.0-beta02

17 aprile 2024

androidx.glance:glance-*:1.1.0-beta02 viene rilasciato. Questa versione contiene i file JAR di origine mancanti nella release precedente.

Versione 1.1.0-beta01

3 aprile 2024

androidx.glance:glance-*:1.1.0-beta01 viene rilasciato. La versione 1.1.0-beta01 contiene questi commit.

Versione 1.1.0-alpha01

7 febbraio 2024

androidx.glance:glance-*:1.1.0-alpha01 viene rilasciato. La versione 1.1.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Libreria di test delle unità per Glance che non richiede UI Automator. Il codice di Glance può essere testato direttamente senza dover gonfiare la visualizzazione.
  • Componenti di livello superiore per layout più semplici.
  • Nuovi modificatori e opzioni di tema.
  • Nuova API per ottenere un flusso di RemoteViews da una composizione, runComposition

Modifiche all'API

  • Aggiunge un nuovo ruolo di colore widgetBackground ai temi di Riepilogo. (Ia2ab8)
  • Aggiungi GlanceAppWidget.runComposition (I6344c, b/298066147)
  • Aggiunge un nuovo componente TopBar (Ibd361)
  • Aggiunge sostituzioni al modificatore clickable. (Iacecf)
  • Aggiunge una nuova API per la colorazione dei pulsanti. Questa funzionalità dovrebbe essere sperimentale fino al rilascio della versione 1.0. (I92523)
  • Aggiunge runGlanceAppWidgetUnitTest che fornisce l'ambito per chiamare i metodi su GlanceAppWidgetUnitTest, ad esempio provideComposable per fornire un piccolo composable isolato per il test, onNode per trovare un elemento composable di Glance nei contenuti forniti. In questo modo, puoi scrivere test di unità per le singole funzioni composable nel tuo appWidget per verificare che, dati determinati input, la funzione restituisca l'insieme di elementi composable della visualizzazione rapida previsto. (I2f682)
  • Aggiunge un modificatore testTag nella semantica da utilizzare nei test di unità. (I8f62f)
  • Aggiornamento TitleBar: testo e icona colorabili singolarmente. (Ia0a60)
  • Aggiunge il componente di struttura (I8a736)
  • Aggiunge il filtro hasActionRunCallbackClickAction e l'affermazione assertHasActionRunCallbackClickAction al test actionRunCallack. Inoltre, aggiunge altre funzioni di variante abbreviata per i filtri di test relativi alle azioni: hasStartActivityClickAction<activityClass>(..), hasStartServiceAction<receiverClass>(..), hasSendBroadcastAction<receiverClass>(..). Aggiunge varianti simili per le relative controparti assertHasXXX. (Ieca63)
  • Sposta l'API non rilasciata. Modifica un modificatore da interno a pubblico, ma con limitazioni per la libreria (If2a08)
  • Aggiunge il metodo onCompositionError in cui gli sviluppatori possono eseguire codice quando si verifica un errore (I9b56f)
  • Aggiunge le API button e iconbutton a Riepilogo (I0fd6f)
  • Aggiunge i filtri isLinearProgressIndicator, isIndeterminateLinearProgressIndicator, isIndeterminateCircularProgressIndicator per abbinare gli indicatori di avanzamento. Sono inclusi ulteriori filtri hasAnyDescendants per verificare se un nodo ha un discendente nella sua gerarchia secondaria che corrisponde a un corrispettivo specifico (Ifd426)
  • Aggiunge asserzioni e filtri per consentire il test delle azioni di clic che avviano servizi / attività o trasmissioni. Sono inclusi anche i test per verificare se gli elementi di input sono selezionati. (I3041c)

Versione 1.0.0

Versione 1.0.0-alpha06

7 febbraio 2024

androidx.glance:glance-appwidget-preview:1.0.0-alpha06 e androidx.glance:glance-preview:1.0.0-alpha06 vengono rilasciati. La versione 1.0.0-alpha06 contiene questi commit.

Nuove funzionalità

  • Versione aggiornata in base al modulo Glance principale.

Versione 1.0.0

6 settembre 2023

androidx.glance:glance-*:1.0.0 viene rilasciato. La versione 1.0.0 contiene questi commit.

Funzionalità principali della versione 1.0.0

  • Spostare Riepilogo alla versione stabile 1.0.0

Versione 1.0.0-rc01

26 luglio 2023

androidx.glance:glance-*:1.0.0-rc01 viene rilasciato. La versione 1.0.0-rc01 contiene questi commit.

Sposta Glance in rc01 in vista della release stabile per 1.0.0.

Nuove funzionalità

  • Aggiunge parametri chiave ai lambda di azioni per un'invocazione delle azioni più stabile.
  • Aggiunge la possibilità di fornire azioni da ActvityOptions a startActivity.
  • Aggiunta del supporto per Android 14

Modifiche all'API

  • È stato aggiunto un parametro chiave facoltativo per tutti gli elementi che accettano lambda. (Id96c1, b/282445798)
  • Aggiunta del supporto per l'impostazione del bundle ActivityOptions per actionStartActivity (I6a08d)
  • File API pubblici ed sperimentali uniti per percorsi d,e,f,g (I03646, b/278769092)
  • N/A, le modifiche al file dell'API sono solo metodi di ordinamento (I5fa95)
  • Aggiungi l'API per l'impostazione CoroutineContext per le richieste GlanceAppWidgetReceiver (I0a100)
  • È stata aggiunta una nuova API per fornire ActivityOptions per LazyColumn e LazyVerticalGrid che verrà utilizzata per tutte le azioni nell'elenco.(Id8d71)

Correzioni di bug

  • N/A, le modifiche al file dell'API sono solo metodi di ordinamento (I5fa95)
  • Demo dello stile del componente di testo della funzionalità Riepilogo (Ie78a4)

Versione 1.0.0-beta01

10 maggio 2023

androidx.glance:glance-*:1.0.0-beta01 viene rilasciato. La versione 1.0.0-beta01 contiene questi commit.

Nuove funzionalità

  • Sposta la raccolta in versione beta.
  • Supporto per l'applicazione di temi utilizzando GlanceTheme , vengono aggiunti i moduli glance-material e glance-material3 per supportare i temi in stile Material 2 e Material 3 in Riepilogo.
  • È stato aggiunto il supporto di FontFamily alle API di testo.
  • GlanceAppWidget è stato spostato in un meccanismo di aggiornamento basato su sessione WorkManager. Gli utenti di Glance per AppWidgets ora devono eseguire l'override di GlanceAppWidget.provideGlance anziché del vecchio metodo Content. Poiché ora questo avviene in un worker, è un buon posto per caricare risorse, database o elementi di rete senza dover disporre di un worker separato.

Modifiche all'API

  • È stata aggiunta l'API *Defaults per Button, Checkbox, RadioButton e Switch. Rende la visualizzazione più in linea con i pattern di Jetpack Compose. (I94828)
  • Nuovo modulo Modelli di Riepilogo (I94459)
  • Impostazione di ResourceColorProvider come interno al modulo. Modifica che provoca un errore. Obbligatorio perché ResourceColorProvider deve essere utilizzato solo per i temi dinamici per evitare situazioni in cui alcuni colori sono risorse dinamiche e altri sono completamente risolti. (Ib0db7)
  • Aggiunge FontFamily come opzione per TextStyle. (Ic19ba, b/274179837)
  • Il nome del parametro di valore per Enum.valueOf è stato modificato (Ia9b89)
  • Altre eccezioni lanciate dall'enum valueOf (I818fe)
  • È stato aggiornato GlanceAppWidget in modo da utilizzare provideGlance come entry point principale. GlanceAppWidget.Content è stato deprecato. (I202b5)
  • Aggiunge un'opzione per fornire il colore di tinta per le immagini (I26192, b/212418562)
  • Maggiore possibilità di valori null per il tipo di ritorno delle funzioni nascoste non più supportate. (Ibf7b0)
  • Aggiunta di un'annotazione @JvmDefaultWithCompatibility (I8f206)
  • SingleEntityTemplateData.displayHeader inutilizzato rimosso. (I7f094)
  • È stato aggiunto il supporto per l'utilizzo di lambda come callback (Ia0bbd)
  • DayNightColorProvider spostato nel modulo Riepilogo (I1842c, b/256934779)
  • Rimuove LocalColorProvider da Modelli. Ora i modelli utilizzeranno GlanceTheme.colors (Ic15e2)
  • È stata rimossa la nullabilità da Text(style: TextStyle) (I7123b, b/237012816)
  • Imposta il colore del testo predefinito su nero. Rimuovi la nullabilità (I3072c, b/237012816)
  • Creare un oggetto per il tema dinamico ColorProviders. Rendi ResourceColorProvider interno al modulo. (Id0e2d, b/237012816)
  • Aggiungi la categoria Non definita a ImageSize. (I2fa39)
  • Rimuovere la funzione GlanceAppWidget.Content ritirata (Ib05f6)
  • Aggiunge il modificatore come parametro a AndroidRemoteViews. (I515d4)
  • Aggiungi GlanceAppWidget.compose per semplificare i test di unità (Ie9b28)

Correzioni di bug

  • È stato aggiunto un widget di dimostrazione per i caratteri dei testi di Glance (I5c3d7)
  • Consente di modificare le dimensioni di AndroidRemoteViews con il modificatore.
  • Problemi relativi ai colori incoerenti del tema risolti
  • A tutte le risorse è stato aggiunto un prefisso per evitare collisioni

Versione 1.0.0-alpha05

5 ottobre 2022

androidx.glance:glance:1.0.0-alpha05, androidx.glance:glance-appwidget:1.0.0-alpha05 e androidx.glance:glance-wear-tiles:1.0.0-alpha05 vengono rilasciati. La versione 1.0.0-alpha05 contiene questi commit.

Nuove funzionalità

  • Aggiunge requestPinGlanceAppWidget a GlanceAppWidgetManager, consentendo alle app di chiedere a un utente di aggiungere il proprio widget basato su Riepilogo alla schermata Home. (Ic6e47)
  • Aggiunge ACTION_DEBUG_UPDATE a GlanceAppWidgetReceiver per consentire agli sviluppatori di forzare l'aggiornamento del widget da adb su dispositivi e emulatori con root. (I94ae1)

Modifiche all'API

  • Rimuovi i pulsanti di azione dell'intestazione nei modelli di Riepilogo per semplificare il caso d'uso. (Ie4387)
  • Modello di entità singola sottoposto a refactoring per riutilizzare il design del sottosistema di blocco. (Iecd2c)
  • Modello di elenco di riepilogo sottoposto a refactoring per utilizzare il design a blocchiText/Image/Action. (If0cc1)
  • Aggiungi l'intervallo di numeri di priorità per TextBlock e ImageBlock. (I73100)

Correzioni di bug

  • È stata rimossa la dipendenza da Material3. (I28d1c)
  • Passaggio a un sistema più coerente per l'aggiunta di margini e spazi nei layout dei modelli di riepilogo. (I29773)
  • Corregge la regola Proguard con formato non corretto che impediva la compilazione delle release minimizzate.

Versione 1.0.0-alpha04

10 agosto 2022

androidx.glance:glance:1.0.0-alpha04, androidx.glance:glance-appwidget:1.0.0-alpha04 e androidx.glance:glance-wear-tiles:1.0.0-alpha04 vengono rilasciati. La versione 1.0.0-alpha04 contiene questi commit.

Nuove funzionalità

  • Aggiunge funzionalità di colorazione dei pulsanti.
  • Aggiunge l'annotazione GlanceComposable per un controllo migliore in fase di compilazione.
  • Aggiunge funzionalità di Glance specifiche per Wear.

Modifiche all'API

  • Aggiorna l'API Glance Gallery Data e la visualizzazione condensata. (Ibc7a8)
  • Aggiunge ButtonColors per la configurazione dei pulsanti. (Iea88d, b/236305351)
  • Rinomina ColorProvider.resolve in ColorProvider.getColor (Ic9dfe)
  • Aggiunge il metodo copy() a TextStyle. (I9aef6)
  • Aggiunge una classe ColorProviders che può essere utilizzata all'interno dei temi per Riepilogo. (I848b9, b/237012816)
  • Aggiunta del supporto del modello di elenco agli stili di elenco e alla visualizzazione compressa. (I50cdc)
  • Aggiungi la semantica a GlanceModiier e GlanceCurvedModifier. (Ifda7e)
  • Aggiungi l'annotazione GlanceComposable. (I5dbf0)
  • Sposta i modelli di Riepilogo nel progetto Riepilogo principale. (I9db94)
  • Aggiungi ColorProvider.resolve() (Ife532, b/214733442)
  • Nuovo metodo per ottenere GlanceId da un appWidgetId esistente o da un'intenzione da un'attività di configurazione (Icb70c, b/230391946)
  • Aggiungi l'annotazione GlanceComposable. (I2c21f)
  • È stato aggiunto GlanceRemoteViews per l'esecuzione della composizione al di fuori di GlanceAppWidget. (I18f92)
  • Rimuovi il colore in ProgressIndicatorDefaults. (I40299)
  • Rinomina il metodo onRun di ActionCallback in onAction, per coerenza con le API pubbliche, come richiesto dal feedback della revisione dell'API. (Icfa57)
  • Converti i layout dei modelli di riepilogo in modo da utilizzare una mappa (I46bfd)
  • Aggiungi il composable RadioButton (I4ecce)
  • È stato aggiunto GlanceWearTiles per comporre riquadri Wear (Ia9f65)
  • È stato aggiunto un elemento cliccabile a GlanceCurvedModifier (Iec2a0)
  • Implementa CurvedRow come ambito e crea un DSL per aggiungere elementi normali componibili e/o curvi. Sono stati aggiunti anche curvedLine e curvedSpacer, che vengono tradotti in ArcLine e ArcSpacer nei riquadri proto (Ib955b)
  • Obbligatoriorietà aggiornata in core e appcompat in modo che corrisponda a Tiramisu DP2 (I0cbb7)
  • Aggiunta del supporto per RuncallbackAction in glance-wear-tiles. Al momento è supportato solo RunCallbackAction con il parametro NO (Ide64a)

Contributo esterno

  • Aggiornamento dell'API :compose:ui:ui-test (updateApi) a causa della migrazione di test-coroutines-lib (I3366d)

Versione 1.0.0-alpha03

23 febbraio 2022

androidx.glance:glance-*:1.0.0-alpha03 viene rilasciato. La versione 1.0.0-alpha03 contiene questi commit.

Nuove funzionalità

  • Definizione dello stato semplificata per impostazione predefinita in Preferenze.

Modifiche all'API

  • Semplifica la gestione degli stati impostando PreferencesGlanceStateDefinition come gestione predefinita. È stato rimosso GlanceAppWidget.updateAppWidgetState e introdotto updateAppWidgetState che utilizza Preferences per impostazione predefinita. (I58963)
  • Aggiungere la classe GlanceTemplateText e aggiornare il design del modello (I4e146)
  • Aggiunge l'infrastruttura di sfondo per il modello A forma libera (If03d6)
  • Aggiornamenti ai layout di SingleEntityTemplate (If925d)
  • LazyVerticalGrid aggiunto (I5f442)
  • Utilizza ColorProvider su SingleEntityTemplate (I01ee0)
  • Aggiorna il nome della classe del modello (I3720e)
  • È stato aggiunto il composable LinearProgressIndicator e CircularProgressIndicator. (Ie116b)

Correzioni di bug

  • Implementazione dei modelli di panoramica iniziale, definisce i dati del "modello di singolo articolo" e il layout del modello di esempio (I35837)
  • Allineamento del contenuto del riquadro al centro per impostazione predefinita (I264be)
  • Correzione di bug con fillMaxSize/Width/Height in glance-wear-tiles (I0a39f)

Versione 1.0.0-alpha02

26 gennaio 2022

androidx.glance:glance-*:1.0.0-alpha02 viene rilasciato. La versione 1.0.0-alpha02 contiene questi commit.

Nuove funzionalità

Questa release contiene l'insieme di API per creare riquadri Wear utilizzando il runtime di Compose con composabili ottimizzati per "Riepilogo"

  • Dichiara il servizio della scheda Wear estendendo GlanceTileService, un servizio per creare la scheda nella funzione composable Content().
  • Componenti composibili di riquadri Wear OS specifici per la visualizzazione rapida: CurvedRow, CurvedText.
  • Gestisci diverse modalità della cronologia per il riquadro definendo TimelineMode.SingleEntry e TimelineMode.TimeBoundEntries.
  • LocalTimeInterval, la composizione locale si riferisce a un intervallo di tempo specifico.
  • BorderModifer è un GlanceModifier che applica un bordo intorno a un elemento.

Questa release aggiunge anche gli indicatori di avanzamento a AppWidget Glance.

Modifiche all'API

  • È stato aggiunto il composable LinearProgressIndicator e CircularProgressIndicator. (Ie116b)
  • Modifica actionStartBroadcastReceiver in actionSendBroadcast (I7d555)
  • Passare il contesto al GlanceAppWidget callback onDelete (I4c795)

Correzioni di bug

  • Gestione corretta di OPTIONS_APPWIDGET_SIZES se presente, ma vuoto. (I01f82)

Versione 1.0.0-alpha01

15 dicembre 2021

androidx.glance:glance:1.0.0-alpha01, androidx.glance:glance-appwidget:1.0.0-alpha01 e androidx.glance:glance-appwidget-proto:1.0.0-alpha01 vengono rilasciati. La versione 1.0.0-alpha01 contiene questi commit.

Funzionalità nella release iniziale

  • La prima release di Glance include il primo set di API per creare AppWidget utilizzando Compose Runtime con una serie di nuovi componenti composibili ottimizzati per i "Glanceable".

Funzionalità