Riepilogo

Crea layout per superfici remote utilizzando un'API Jetpack Compose-style.
Aggiornamento più recente Release stabile Candidato per la release Versione beta Release alpha
12 giugno 2024 1.1.0 - - -

Dichiarazione delle dipendenze

Per aggiungere una dipendenza su 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 artefatti necessari nel file build.gradle per l'app o il modulo:

Groovy

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

    // 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.1.0")
    
    // For AppWidgets support
    implementation("androidx.glance:glance-appwidget:1.1.0")

    // 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, vedi Aggiungere dipendenze build.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se rilevi nuovi problemi o hai idee per migliorare la libreria. Dai un'occhiata ai problemi esistenti in questa libreria prima di crearne una nuova. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Crea un nuovo problema

Per ulteriori informazioni, consulta la documentazione di Issue Tracker.

Versione 1.1

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

  • Sposta lo Glance alla versione 1.1.0 stabile.

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 in anteprima per Glance. Sposta la 1.1.0 in Release Candidate.

Modifiche alle API

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

Correzioni di bug

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

Contributi esterni

Versione 1.1.0-beta02

17 aprile 2024

androidx.glance:glance-*:1.1.0-beta02 viene rilasciato. Questa versione contiene jar del codice sorgente che non erano presenti 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 il campo visivo.
  • Componenti di livello superiore per layout più semplici.
  • Nuovi modificatori e opzioni per i temi.
  • Nuova API per ottenere un flusso di RemoteView da una composizione, runComposition

Modifiche alle API

  • Aggiunge un nuovo ruolo di colore widgetBackground ai temi Riepilogo. (Ia2ab8).
  • Aggiungi GlanceAppWidget.runComposition (I6344c, b/298066147)
  • Aggiunge il nuovo componente TopBar (Ibd361)
  • Aggiunge override al modificatore clickable. (Iacecf).
  • Aggiunge una nuova API per la colorazione dei pulsanti. Questa opzione dovrebbe essere sperimentale fino alla versione 1.0 della release. (I92523)
  • Aggiunge runGlanceAppWidgetUnitTest che fornisce l'ambito di applicazione dei metodi di chiamata su GlanceAppWidgetUnitTest, come provideComposable, per fornire un piccolo componibile isolato per il test, onNode per trovare un elemento componibile Glance nei contenuti forniti. Questo ti permette di scrivere test delle unità per singole funzioni componibili nel tuo appWidget, al fine di verificare che, dati determinati input, la funzione restituisca l'insieme previsto di elementi componibili colpo d'occhio. (I2f682)
  • Aggiunge un modificatore testTag in semantica da utilizzare nei test delle unità. (I8f62f)
  • update TitleBar: testo e icona possono essere impostati singolarmente. (Ia0a60)
  • Aggiunge il componente scaffold (I8a736)
  • Aggiunge il filtro hasActionRunCallbackClickAction e l'asserzione assertHasActionRunCallbackClickAction per testare actionRunCallack. Inoltre, aggiunge ulteriori funzioni per le varianti in forma abbreviata per i filtri di test correlati alle azioni: hasStartActivityClickAction<activityClass>(..), hasStartServiceAction<receiverClass>(..), hasSendBroadcastAction<receiverClass>(..). Aggiunge varianti simili per le rispettive controparti assertHasXXX. (Ieca63)
  • Sposta l'API non rilasciata. Modifica un modificatore da interno a pubblico ma con limitazioni per la biblioteca (If2a08)
  • Aggiunge il metodo onCompositionError in cui gli sviluppatori possono eseguire il codice quando si verifica un errore (I9b56f)
  • Aggiunge pulsanti e iconbutton API a colpo d'occhio (I0fd6f)
  • Aggiunge i filtri isLinearProgressIndicator, isIndeterminateLinearProgressIndicator e isIndeterminateCircularProgressIndicator per abbinare gli indicatori di avanzamento. L'elemento aggiuntivo include il filtro hasAnyDescendants per verificare se un nodo ha un discendente nella sottogerarchia che corrisponde a un matcher specifico (Ifd426)
  • Aggiunge asserzioni e filtri per consentire il test delle azioni di clic che avviano il servizio, l'attività o la trasmissione. Include anche il test per verificare se gli elementi di input sono stati controllati. (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 modo da seguire il modulo Riepilogo 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

  • Sposta Glance nella 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 lo Glance in rc01 per passare alla versione stabile per la versione 1.0.0.

Nuove funzionalità

  • Aggiunge parametri chiave ai lambda delle azioni per una chiamata di azioni più stabile.
  • Aggiunge la possibilità di specificare ActvityOptions per startActivity azioni.
  • Aggiunge il supporto per Android 14

Modifiche alle API

  • Aggiunto un parametro chiave facoltativo per tutti gli elementi che accettano le lambda. (Id96c1, b/282445798)
  • Aggiungi il supporto per l'impostazione del bundle ActivityOptions per actionStartActivity (I6a08d)
  • Sono stati uniti i file API pubblici e sperimentali per d,e,f,g-paths (I03646, b/278769092)
  • N/D, le modifiche ai file API sono solo metodi di riordinamento (I5fa95)
  • Aggiungi l'API per l'impostazione di 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/D, le modifiche ai file API sono solo metodi di riordinamento (I5fa95)
  • Demo dello stile del componente di testo di 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 libreria in versione beta.
  • Il supporto della tematizzazione tramite GlanceTheme consente di aggiungere moduli di tipo "materiale strumentale" e "materiale 3".
  • Supporto per FontFamily aggiunto all'API di testo.
  • GlanceAppWidget spostato in un meccanismo di aggiornamento basato sulla sessione WorkManager. Gli utenti di Glance per AppWidgets ora devono sostituire GlanceAppWidget.provideGlance anziché il metodo Content precedente. Dato che ora accade in un worker, questo è un buon posto per caricare risorse, database o elementi di rete senza dover avere un worker separato.

Modifiche alle API

  • API *Defaults aggiunta per Button, Checkbox, RadioButton e Switch. uno sguardo più da vicino, in linea con i pattern di Jetpack Compose. (I94828)
  • Nuovo modulo dei modelli Glance (I94459)
  • Impostazione di ResourceColorProvider come interno al modulo. Interruzione di un cambiamento. Obbligatorio perché ResourceColorProvider deve essere utilizzato solo per la tematizzazione dinamica al fine di evitare situazioni in cui alcuni colori sono risorse dinamiche e altri sono completamente risolti. (Ib0db7)
  • Aggiunge FontFamily come opzione per TextStyle. (Ic19ba, b/274179837).
  • Nome del parametro del valore per Enum.valueOf modificato (Ia9b89)
  • Altre eccezioni generate dall'enum valueOf (I818fe)
  • È stato aggiornato GlanceAppWidget per utilizzare provideGlance come punto di ingresso principale. L'API GlanceAppWidget.Content è deprecata. (I202b5).
  • Aggiunge un'opzione per fornire il colore di tinta per le immagini (I26192, b/212418562)
  • Più valore restituito per le funzioni deprecate nascoste. (Ibf7b0)
  • Aggiunta dell'annotazione @JvmDefaultWithCompatibility (I8f206)
  • È stato rimosso il campo SingleEntityTemplateData.displayHeader inutilizzato. (I7f094)
  • Aggiunto il supporto per l'utilizzo di lambda come callback (Ia0bbd)
  • DayNightColorProvider spostato nel modulo di visione (I1842c, b/256934779)
  • Rimuove LocalColorProvider da Modelli. Ora i modelli utilizzeranno GlanceTheme.colors (Ic15e2)
  • Valore nulla rimosso da Text(style: TextStyle) (I7123b, b/237012816)
  • Colore del testo predefinito sul nero. rimuovi nullability (I3072c, b/237012816)
  • Impostazione del tema dinamico ColorProviders come proprio oggetto. Attivazione di ResourceColorProvider per il modulo. (Id0e2d, b/237012816).
  • Aggiungi la categoria Non definita a ImageSize. (I2fa39).
  • Rimuovi la funzione GlanceAppWidget.Content deprecata (Ib05f6)
  • Aggiunge il modificatore come parametro a AndroidRemoteViews. (I515d4).
  • Aggiungi GlanceAppWidget.compose per semplificare il test delle unità (Ie9b28)

Correzioni di bug

  • È stato aggiunto un widget demo per i caratteri di testo Glance (I5c3d7)
  • Rende AndroidRemoteViews considerevole con il modificatore.
  • Sono stati risolti problemi relativi ai colori incoerenti del tema
  • Tutte le risorse ora hanno un prefisso per evitare conflitti

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 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 emulatori e dispositivi rooted. (I94ae1).

Modifiche alle API

  • Rimuovi i pulsanti di azione dell'intestazione nei modelli di Glance per semplificare il caso d'uso. (Ie4387)
  • È stato eseguito il refactoring del modello di entità singola per riutilizzare il design del sottosistema Blocca. (Iecd2c).
  • Modello elenco di riepilogo sottoposto a refactoring per utilizzareText/Image/Action la progettazione a blocchi. (If0cc1)
  • Aggiungi un intervallo di numeri di priorità per TextBlock e ImageBlock. (I73100)

Correzioni di bug

  • Dipendenza Material3 rimossa. (I28d1c).
  • Si sposta verso un sistema più coerente per l'aggiunta di margini e spaziatura nei layout dei modelli di visione. (I29773)
  • Corregge la regola di ProGuard non corretta che bloccava la creazione di 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 pulsanti.
  • Aggiunge l'annotazione GlanceComposable per un migliore controllo del tempo di compilazione.
  • Aggiunge funzionalità di Riepilogo specifiche per Wear.

Modifiche alle API

  • Aggiorna l'API Glance Gallery Data e la Vista ridotta. (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 come parte dei temi per Riepilogo. (I848b9, b/237012816)
  • Aggiunta del supporto dei modelli di elenco agli stili degli elenchi e alla visualizzazione compressa. (I50cdc)
  • Aggiungi la semantica a GlanceModiier e GlanceCurvedModifier. (Ifda7e).
  • Aggiungi l'annotazione GlanceComposable. (I5dbf0)
  • Sposta i modelli Glance nel progetto principale. (I9db94)
  • Aggiungi ColorProvider.resolve() (Ife532, b/214733442)
  • Nuovo metodo per ottenere GlanceId da un appWidgetId esistente o un intent da un'attività di configurazione (Icb70c, b/230391946)
  • Aggiungi l'annotazione GlanceComposable. (I2c21f).
  • GlanceRemoteViews aggiunto per l'esecuzione della composizione al di fuori di GlanceAppWidget. (I18f92).
  • Rimuovi colore in ProgressIndicatorDefaults. (I40299)
  • Rinomina il metodo onRun di ActionCallback in onAction, per coerenza con le API pubbliche, come richiesto dal feedback sulla revisione delle API. (Icfa57).
  • Converti i layout dei modelli di colpo d'occhio per utilizzare una mappa (I46bfd)
  • Aggiungi RadioButton componibile (I4ecce)
  • GlanceWearTiles aggiunto per la composizione di riquadri di Wear (Ia9f65)
  • Aggiunta cliccabile a GlanceCurvedModifier (Iec2a0)
  • Implementa CurvedRow come ambito e crea un DSL per aggiungere normali elementi componibili e/o curvi. Sono stati aggiunti anche curvedLine e curvedSpacer, che vengono tradotti in ArcLine e ArcSpacer nei riquadri di proto (Ib955b)
  • Valore nulla aggiornato nel core e nell'appcompat per corrispondere a Tiramisu DP2 (I0cbb7)
  • Aggiunta del supporto per RuncallbackAction in riquadri indossabili, al momento è supportato solo RunCallbackAction con parametro NO (Ide64a)

Contributi esterni

  • Aggiornamento di :compose:ui:ui-test api (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 impostare come predefinita le Preferenze.

Modifiche alle API

  • Semplifica la gestione dello stato impostando PreferencesGlanceStateDefinition come gestione predefinita dello stato. È stato rimosso GlanceAppWidget.updateAppWidgetState e introdotto updateAppWidgetState che utilizza Preferences per impostazione predefinita. (I58963)
  • Aggiungi la classe Glance TemplateText e aggiorna il design del modello (I4e146)
  • Aggiunge l'infrastruttura struttura per il modello in formato libero (If03d6)
  • Aggiornamenti ai layout SingleEntityTemplate (If925d)
  • Aggiunto LazyVerticalGrid (I5f442)
  • Usa ColorProvider su SingleEntityTemplate (I01ee0)
  • Aggiorna il nome della classe del modello (I3720e)
  • Aggiunti LinearProgressIndicator e CircularProgressIndicator componibile. (Ie116b)

Correzioni di bug

  • Implementazione iniziale dei modelli di colpo d'occhio, definizione dei dati del "modello di singolo elemento" e layout del modello di esempio (I35837)
  • Allinea la cotenta del riquadro al centro per impostazione predefinita (I264be)
  • Correzione di bug con riempimentoMaxSize/Larghezza/Altezza nelle piastrelle indossabili (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 il set di API per creare riquadri di Wear utilizzando il runtime di Compose con elementi componibili ottimizzati per "Glanceable"

  • Dichiara il tuo servizio Wear Tibet estendendo GlanceTileService, un servizio per creare il tuo riquadro nella funzione componibile Content().
  • Sguardo componibile specifico per i riquadri di Wear: CurvedRow, CurvedText.
  • Gestisci le diverse modalità della sequenza temporale per il riquadro definendo TimelineMode.SingleEntry e TimelineMode.TimeBoundEntries.
  • LocalTimeInterval, la composizione locale fa riferimento a un intervallo di tempo specifico.
  • BorderModifer è un GlanceModifier che applica un bordo intorno a un elemento.

In questa release vengono aggiunti anche gli indicatori di avanzamento ad AppWidget Glance.

Modifiche alle API

  • Aggiunti LinearProgressIndicator e CircularProgressIndicator componibile. (Ie116b)
  • Modifica actionStartBroadcastReceiver in actionSendBroadcast (I7d555)
  • Passa il contesto al callback GlanceAppWidget onDelete (I4c795)

Correzioni di bug

  • Gestione corretta di OPTIONS_APPWIDGET_SIZES se presente, ma vuota. (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 la prima serie di API per creare AppWidget utilizzando Compose Runtime con un insieme di nuovi componenti componibili ottimizzati per "Glanceables".

Funzionalità