Riepilogo
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.
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
diViewfinder
per riflettere meglio le implementazioni sottostanti e aggiungi le costanti fisse perTransformationInfo.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
- La versione sperimentale di
SharedTransitionScope
è ora un'interfaccia anziché una classe. (Iaf856, b/338415048, b/338414702).
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 suGlanceAppWidgetUnitTest
, comeprovideComposable
, 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'asserzioneassertHasActionRunCallbackClickAction
per testareactionRunCallack
. 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 contropartiassertHasXXX
. (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
eisIndeterminateCircularProgressIndicator
per abbinare gli indicatori di avanzamento. L'elemento aggiuntivo include il filtrohasAnyDescendants
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
perstartActivity
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
peractionStartActivity
(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 richiesteGlanceAppWidgetReceiver
(I0a100) - È stata aggiunta una nuova API per fornire
ActivityOptions
perLazyColumn
eLazyVerticalGrid
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 sessioneWorkManager
. Gli utenti di Glance perAppWidgets
ora devono sostituireGlanceAppWidget.provideGlance
anziché il metodoContent
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 perButton
,Checkbox
,RadioButton
eSwitch
. 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 perTextStyle
. (Ic19ba, b/274179837). - Nome del parametro del valore per
Enum.valueOf
modificato (Ia9b89) - Altre eccezioni generate dall'enum
valueOf
(I818fe) - È stato aggiornato
GlanceAppWidget
per utilizzareprovideGlance
come punto di ingresso principale. L'APIGlanceAppWidget.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 utilizzerannoGlanceTheme.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 diResourceColorProvider
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
aGlanceAppWidgetManager
, consentendo alle app di chiedere a un utente di aggiungere il widget basato su Riepilogo alla schermata Home. (Ic6e47). - Aggiunge
ACTION_DEBUG_UPDATE
aGlanceAppWidgetReceiver
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 utilizzare
Text/Image/Action
la progettazione a blocchi. (If0cc1) - Aggiungi un intervallo di numeri di priorità per
TextBlock
eImageBlock
. (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
inColorProvider.getColor
(Ic9dfe) - Aggiunge il metodo
copy()
aTextStyle
. (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
eGlanceCurvedModifier
. (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 unappWidgetId
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 diGlanceAppWidget
. (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 anchecurvedLine
ecurvedSpacer
, che vengono tradotti inArcLine
eArcSpacer
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 soloRunCallbackAction
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 rimossoGlanceAppWidget.updateAppWidgetState
e introdottoupdateAppWidgetState
che utilizzaPreferences
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
suSingleEntityTemplate
(I01ee0) - Aggiorna il nome della classe del modello (I3720e)
- Aggiunti
LinearProgressIndicator
eCircularProgressIndicator
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
eTimelineMode.TimeBoundEntries
. LocalTimeInterval
, la composizione locale fa riferimento a un intervallo di tempo specifico.BorderModifer
è unGlanceModifier
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
eCircularProgressIndicator
componibile. (Ie116b) - Modifica
actionStartBroadcastReceiver
inactionSendBroadcast
(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à
- Dichiara i widget delle tue app con GlanceAppWidget e GlanceAppWidgetRicevir.
- Componi la tua UI con l'insieme iniziale di elementi componibili Glance: Box, Row, Column, Text, Button, LazyColumn, Image, Spacer.
- Applica modificatori ai componibili utilizzando i metodi GlanceModifier.
- Gestisci l'interazione degli utenti con le azioni predefinite.
- Specifica i parametri per Action con ActionParameters.
- Per gestire diverse modalità di dimensione, definisci SizeMode.Single, SizeMode.Exact o SizeMode.Adattabile.
- Mantieni lo stato GlanceAppWidget fornendo GlanceStateDefinition.
- Composizioni locali come LocalContext, LocalState, LocalGlanceId, LocalSize.
- Interopera con i componenti RemoteView esistenti con il componente componibile AndroidRemoteViews.