Anzeige
Letzte Aktualisierung | Stabile Version | Releasekandidat | Beta-Ausgabe | Alpharelease |
---|---|---|---|---|
12. Juni 2024 | 1.1.0 | - | - | - |
Abhängigkeiten deklarieren
Zum Hinzufügen einer Abhängigkeit von Glance müssen Sie Ihrem Projekt das Maven-Repository von Google hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.
Fügen Sie der Datei build.gradle
für Ihre Anwendung oder Ihr Modul die Abhängigkeiten für die benötigten Artefakte hinzu:
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" } }
Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.
Feedback
Dein Feedback hilft uns, Jetpack zu verbessern. Lassen Sie uns wissen, wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie eine neue erstellen. Durch Klicken auf die Stern-Schaltfläche können Sie zu einem vorhandenen Problem abstimmen.
Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.
Version 1.1
Version 1.1.0
12. Juni 2024
androidx.glance:glance-*:1.1.0
wird freigegeben. Version 1.1.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.0.0
- Verschiebt Glance auf die stabile Version 1.1.0.
Version 1.1.0-rc01
14. Mai 2024
androidx.glance:glance-*:1.1.0-rc01
wird freigegeben. Version 1.1.0-rc01 enthält diese Commits.
Neue Funktionen
- Den Vorschauanmerkungen für Glance wurden Parameter für Breite und Höhe hinzugefügt. Verschiebt 1.1.0 zum Release-Kandidaten.
API-Änderungen
- Fügt dem Scaffold einen optionalen Parameter hinzu. (If753f)
- Füge „Glance“-
@Preview
Parameter für Breite und Höhe hinzu. (Ibabe8) - Die Unterstützung für die Vorschau der Glanz Wear-Kacheln wurde entfernt. (I3850a)
- Es wurde eine API zum Festlegen benutzerdefinierter Gewichtungswerte für
FontStyle
hinzugefügt. (I7390a) - Benennen Sie die
ImplementationMode
-Enums vonViewfinder
um, um die zugrunde liegenden Implementierungen besser widerzuspiegeln, und fügen Sie feste Konstanten fürTransformationInfo.sourceRotation
(Ic6149) hinzu
Fehlerkorrekturen
- Es wurde ein Fehler behoben, der Rendering-Probleme für
ViewGroups
im Abwärtskompatibilitätsmodus verursachte (I8de92).
Externer Beitrag
- Das experimentelle
SharedTransitionScope
ist jetzt eine Benutzeroberfläche und keine Klasse. (Iaf856, b/338415048, b/338414702)
Version 1.1.0-beta02
17. April 2024
androidx.glance:glance-*:1.1.0-beta02
wird freigegeben. Diese Version enthält Quelldateien, die in der vorherigen Version fehlten.
Version 1.1.0-beta01
3. April 2024
androidx.glance:glance-*:1.1.0-beta01
wird freigegeben. Version 1.1.0-beta01 enthält diese Commits.
Version 1.1.0-alpha01
7. Februar 2024
androidx.glance:glance-*:1.1.0-alpha01
wird freigegeben. Version 1.1.0-alpha01 enthält diese Commits.
Neue Funktionen
- Komponententestbibliothek für Glance, für die UI Automator nicht erforderlich ist. Der Glance-Code kann direkt getestet werden, ohne die Ansicht zu erhöhen.
- Höhere Komponenten für einfachere Layouts.
- Neue Modifikatoren und Designoptionen.
- Neue API zum Abrufen eines Ablaufs von RemoteViews aus einer Komposition,
runComposition
API-Änderungen
- Dadurch wird den Glance-Designs die neue Farbrolle
widgetBackground
hinzugefügt. (Ia2ab8) GlanceAppWidget.runComposition
(I6344c, b/298066147) hinzufügen- Fügt eine neue
TopBar
-Komponente hinzu (Ibd361) - Fügt dem
clickable
-Modifikator Überschreibungen hinzu. (Iacecf) - Fügt eine neue API zum Abfärben von Schaltflächen hinzu. Dies sollte bis zur Auslieferung von Version 1.0 experimentell sein. (I92523)
- Fügt
runGlanceAppWidgetUnitTest
hinzu, das einen Bereich für den Aufruf von Methoden aufGlanceAppWidgetUnitTest
enthält, z. B.provideComposable
, um eine kleine isolierte zusammensetzbare Funktion für Testzwecke undonNode
bereitzustellen, um im bereitgestellten Inhalt ein zusammensetzbares Element der Funktion „Live-Anzeige“ zu finden. Auf diese Weise können Sie Einheitentests für einzelne zusammensetzbare Funktionen in „appWidget“ schreiben, um zu überprüfen, ob die Funktion bei bestimmten Eingaben den gewünschten Satz zusammensetzbarer Übersichtselemente ausgibt. (I2f682) - Fügt in der Semantik einen
testTag
-Modifikator zur Verwendung in Einheitentests hinzu. (I8f62f) - Aktualisierung
TitleBar
– Text und Symbol können einzeln abfärbt werden. (Ia0a60) - Scaffold-Komponente wird hinzugefügt (I8a736)
- Fügt den
hasActionRunCallbackClickAction
-Filter und dieassertHasActionRunCallbackClickAction
-Assertion zum Testen vonactionRunCallack
hinzu. Außerdem werden zusätzliche Kurzformfunktionen für aktionsbezogene Testfilter hinzugefügt:hasStartActivityClickAction<activityClass>(..)
,hasStartServiceAction<receiverClass>(..)
undhasSendBroadcastAction<receiverClass>(..)
. Fügt ähnliche Varianten für ihreassertHasXXX
-Gegenstücke hinzu. (Ieca63) - Verschiebt die unveröffentlichte API Ändert einen Modifikator von „intern“ in „öffentlich“, aber in einer Mediathek eingeschränkt (If2a08)
- Fügt die Methode
onCompositionError
hinzu, mit der Entwickler Code ausführen können, wenn ein Fehler auftritt (I9b56f) - Fügt Schaltflächen- und iconbutton-APIs zu Blick hinzu (I0fd6f)
- Fügt
isLinearProgressIndicator
-,isIndeterminateLinearProgressIndicator
- undisIndeterminateCircularProgressIndicator
-Filter hinzu, um den Fortschrittsanzeigen zu entsprechen. Zusätzlich enthält derhasAnyDescendants
-Filter, mit dem getestet werden kann, ob ein Knoten in seiner untergeordneten Hierarchie einen Nachfolger hat, der mit einem bestimmten Matcher übereinstimmt (Ifd426) - Fügt Assertions und Filter hinzu, um das Testen von Klickaktionen zu ermöglichen, die Dienst / Aktivität oder Broadcasts starten. Umfasst auch das Testen, ob Eingabeelemente überprüft werden. (I3041c)
Version 1.0.0
Version 1.0.0-alpha06
7. Februar 2024
androidx.glance:glance-appwidget-preview:1.0.0-alpha06
und androidx.glance:glance-preview:1.0.0-alpha06
werden veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
Neue Funktionen
- Die Version wurde aktualisiert, um dem Glance-Hauptmodul zu entsprechen.
Version 1.0.0
6. September 2023
androidx.glance:glance-*:1.0.0
wird freigegeben. Version 1.0.0 enthält diese Commits.
Hauptfunktionen von Version 1.0.0
- Glance auf die stabile Version 1.0.0 umstellen
Version 1.0.0-rc01
26. Juli 2023
androidx.glance:glance-*:1.0.0-rc01
wird freigegeben. Version 1.0.0-rc01 enthält diese Commits.
Verschiebt Glance zu rc01 auf dem Weg zur stabilen Version für 1.0.0.
Neue Funktionen
- Fügt wichtige Parameter zu Aktions-Lambdas für einen stabileren Aktionsaufruf hinzu.
- Bietet die Möglichkeit,
ActvityOptions
fürstartActivity
-Aktionen bereitzustellen. - Android 14 wird unterstützt
API-Änderungen
- Ein optionaler Schlüsselparameter wurde für alle Elemente hinzugefügt, die Lambdas akzeptieren. (Id96c1, b/282445798)
- Unterstützung für das Festlegen des Pakets „
ActivityOptions
“ füractionStartActivity
(I6a08d) - Zusammengeführte öffentliche und experimentelle API-Dateien für d,e,f,g-paths (I03646, b/278769092)
- Nicht zutreffend, API-Dateiänderungen sind nur Neuanordnungsmethoden (I5fa95)
- API hinzufügen, um
CoroutineContext
fürGlanceAppWidgetReceiver
-Anfragen festzulegen (I0a100) - Eine neue API wurde hinzugefügt, um
ActivityOptions
fürLazyColumn
undLazyVerticalGrid
bereitzustellen, die für alle Aktionen in der Liste verwendet wird.(Id8d71)
Fehlerkorrekturen
- Nicht zutreffend, API-Dateiänderungen sind nur Neuanordnungsmethoden (I5fa95)
- Demo für den Stil der Glance-Textkomponente (Ie78a4)
Version 1.0.0-beta01
10. Mai 2023
androidx.glance:glance-*:1.0.0-beta01
wird freigegeben. Version 1.0.0-beta01 enthält diese Commits.
Neue Funktionen
- Versetzt die Bibliothek in die Betaversion.
- Unterstützung für Designs mithilfe von
GlanceTheme
, ergänzt die Module „look-material“ und „look-material3“ für Designs von Material 2 und Material 3 in Glance. - Unterstützung für
FontFamily
wurde zu Text-APIs hinzugefügt. GlanceAppWidget
wurde in einen aufWorkManager
-Sitzungen basierenden Aktualisierungsmechanismus verschoben. Nutzer von Glance fürAppWidgets
sollten jetztGlanceAppWidget.provideGlance
anstelle der altenContent
-Methode überschreiben. Da dies bei einem Worker der Fall ist, können Sie hier Ressourcen, Datenbanken oder Netzwerkelemente laden, ohne einen separaten Worker verwenden zu müssen.
API-Änderungen
*Defaults
API fürButton
,Checkbox
,RadioButton
undSwitch
hinzugefügt. Sie gleicht den Mustern von Jetpack Compose und schont den Blick näher. (I94828)- Neues Vorlagenmodul für Glance (I94459)
ResourceColorProvider
wird intern für das Modul erstellt. Funktionsgefährdende Änderung Erforderlich, daResourceColorProvider
nur für dynamische Designs verwendet werden sollte, um Situationen zu vermeiden, in denen einige Farben dynamische Ressourcen sind und andere vollständig aufgelöst werden. (Ib0db7)- Fügt
FontFamily
als Option fürTextStyle
hinzu. (Ic19ba, b/274179837) - Name des Wertparameters für
Enum.valueOf
geändert (Ia9b89) - Mehr ausgelöste Ausnahmen von Aufzählung
valueOf
(I818fe) GlanceAppWidget
wurde aktualisiert, umprovideGlance
als Haupteinstiegspunkt zu verwenden.GlanceAppWidget.Content
wurde eingestellt. (I202b5)- Option zum Bereitstellen einer Farbtonfarbe für Bilder (I26192, b/212418562)
- Höhere Null-Zulässigkeit von Rückgabetypen für verworfene Funktionen, die ausgeblendet wurden. (Ibf7b0)
- Anmerkung
@JvmDefaultWithCompatibility
hinzufügen (I8f206) - Die nicht verwendete
SingleEntityTemplateData.displayHeader
wurde entfernt. (I7f094) - Die Verwendung von Lambdas als Callbacks wird jetzt unterstützt (Ia0bbd).
DayNightColorProvider
zum Glanz-Modul verschoben (I1842c, b/256934779)- Entfernt
LocalColorProvider
aus Vorlagen. Für Vorlagen wird jetztGlanceTheme.colors
(Ic15e2) verwendet - Null-Zulässigkeit aus
Text(style: TextStyle)
entfernt (I7123b, b/237012816) - Schwarz als Standardtextfarbe. Null-Zulässigkeit entfernen (I3072c, b/237012816)
- Das dynamische Design
ColorProviders
wird als eigenes Objekt konfiguriert.ResourceColorProvider
wird intern für das Modul erstellt. (Id0e2d, b/237012816) - Fügen Sie
ImageSize
die nicht definierte Kategorie hinzu. (I2fa39) - Verworfene
GlanceAppWidget.Content
-Funktion entfernen (Ib05f6) - Fügt
AndroidRemoteViews
einen Modifikator als Parameter hinzu. (I515d4) - Fügen Sie
GlanceAppWidget.compose
hinzu, um Unittests zu vereinfachen (Ie9b28)
Fehlerkorrekturen
- Demo-Widget für Glance-Textschriftarten hinzugefügt (I5c3d7)
- Vergrößert
AndroidRemoteViews
mit dem Modifikator - Probleme mit uneinheitlichen Designfarben behoben
- Alle Ressourcen werden jetzt vorangestellt, um Konflikte zu vermeiden
Version 1.0.0-alpha05
5. Oktober 2022
androidx.glance:glance:1.0.0-alpha05
, androidx.glance:glance-appwidget:1.0.0-alpha05
und androidx.glance:glance-wear-tiles:1.0.0-alpha05
wurden veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
Neue Funktionen
- Fügt
requestPinGlanceAppWidget
zuGlanceAppWidgetManager
hinzu, damit Apps Nutzer dazu auffordern können, ihr auf einen Blick basiertes Widget zum Startbildschirm hinzuzufügen. (Ic6e47) - Dadurch wird
ACTION_DEBUG_UPDATE
zuGlanceAppWidgetReceiver
hinzugefügt, damit Entwickler ein Update von ADB auf gerooteten Geräten und Emulatoren erzwingen können. (I94ae1)
API-Änderungen
- Entfernen Sie Aktionsschaltflächen in der Kopfzeile aus Glance-Vorlagen, um den Anwendungsfall zu vereinfachen. (Ie4387)
- Überarbeitete Vorlage für eine einzelne Entität zur Wiederverwendung des Block-Subsystemdesigns. (Iecd2c)
- Überarbeitete Vorlage für Liste der Übersichten zur Verwendung des
Text/Image/Action
-Blockdesigns. (If0cc1) - Fügen Sie einen Prioritätsnummernbereich für
TextBlock
undImageBlock
hinzu. (I73100)
Fehlerkorrekturen
- Material3-Abhängigkeit entfernt. (I28d1c)
- Bewegt sich in Richtung eines einheitlicheren Systems für das Hinzufügen von Rändern und Abständen in Layouts für Blickvorlagen. (I29773)
- Es wurde eine fehlerhafte Proguard-Regel behoben, durch die das Erstellen minimierter Releases blockiert wurde.
Version 1.0.0-alpha04
10. August 2022
androidx.glance:glance:1.0.0-alpha04
, androidx.glance:glance-appwidget:1.0.0-alpha04
und androidx.glance:glance-wear-tiles:1.0.0-alpha04
wurden veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
Neue Funktionen
- Fügt Funktionen zum Einfärben von Schaltflächen hinzu.
- Zur besseren Überprüfung der Kompilierungszeit wird die Anmerkung
GlanceComposable
hinzugefügt. - Dadurch werden Wear-spezifische Funktionen von „Glance“ hinzugefügt.
API-Änderungen
- Glance Gallery Data API und komprimierte Ansicht aktualisieren. (Ibc7a8)
- Fügt
ButtonColors
zum Konfigurieren von Schaltflächen hinzu. (Iea88d, b/236305351) ColorProvider.resolve
umbenennen inColorProvider.getColor
(Ic9dfe)- Fügt die Methode
copy()
zuTextStyle
hinzu. (I9aef6) - Fügt eine
ColorProviders
-Klasse hinzu, die als Teil von Designs für Glance verwendet werden kann. (I848b9, b/237012816) - Unterstützung für Listenvorlagen zu Listenstilen und minimierter Ansicht hinzufügen. (I50cdc)
- Fügen Sie
GlanceModiier
undGlanceCurvedModifier
eine Semantik hinzu. (Ifda7e) - Füge die Anmerkung
GlanceComposable
hinzu. I5dbf0. - Verschiebt Glance-Vorlagen in das Glance-Hauptprojekt. (I9db94)
ColorProvider.resolve()
hinzufügen (Ife532, b/214733442)- Neue Methode zum Abrufen von
GlanceId
aus einer vorhandenenappWidgetId
oder einem Intent aus einer Konfigurationsaktivität (Icb70c, b/230391946) - Füge die Anmerkung
GlanceComposable
hinzu. (I2c21f) GlanceRemoteViews
zum Ausführen der Komposition außerhalb vonGlanceAppWidget
hinzugefügt. (I18f92)- Farbe in
ProgressIndicatorDefaults
entfernen. (I40299) - Benennen Sie die onRun-Methode von
ActionCallback
entsprechend dem Feedback zur API-Überprüfung aus Gründen der Konsistenz mit den öffentlichen APIs in onAction um. (ICFa57) - Layouts mit Blickvorlagen in eine Karte umwandeln (I46bfd)
- Zusammensetzbare Funktion
RadioButton
hinzufügen (I4ecce) GlanceWearTiles
zum Erstellen von Bekleidungskacheln hinzugefügt (Ia9f65)- Anklickbar zu
GlanceCurvedModifier
hinzugefügt (Iec2a0) - Implementieren Sie
CurvedRow
als Bereich und erstellen Sie eine DSL, um normale zusammensetzbare und/oder gebogene Elemente hinzuzufügen. Außerdem wurdencurvedLine
undcurvedSpacer
hinzugefügt, die in Proto-Kacheln inArcLine
undArcSpacer
übersetzt werden (Ib955b). - Null-Zulässigkeit in Core und Appcompat für Tiramisu DP2 (I0cbb7) aktualisiert
- Unterstützung für
RuncallbackAction
in Glanz-Wear-Kacheln hinzugefügt, derzeit wird nurRunCallbackAction
mit NO-Parameter unterstützt (Ide64a)
Externer Beitrag
- :compose:ui:ui-test api (updateApi) aufgrund der Migration von test-coroutines-lib aktualisiert (I3366d)
Version 1.0.0-alpha03
23. Februar 2022
androidx.glance:glance-*:1.0.0-alpha03
wird freigegeben. Version 1.0.0-alpha03 enthält diese Commits.
Neue Funktionen
- Vereinfachte Statusdefinition zur Standardeinstellung „Einstellungen“.
API-Änderungen
- Vereinfachen Sie die Statusverarbeitung, indem Sie
PreferencesGlanceStateDefinition
als Standardverarbeitung festlegen.GlanceAppWidget.updateAppWidgetState
wurde entfernt undupdateAppWidgetState
eingeführt, das standardmäßigPreferences
verwendet. (I58963) - „Glance TemplateText“-Klasse hinzufügen und Vorlagendesign aktualisieren (I4e146)
- Damit wird die Umrissinfrastruktur für die Vorlage „Freies Format“ hinzugefügt (If03d6).
- Aktualisierungen von
SingleEntityTemplate
-Layouts (If925d) LazyVerticalGrid
(I5f442) hinzugefügtColorProvider
aufSingleEntityTemplate
(I01ee0) verwenden- Name der Vorlagenklasse aktualisieren (I3720e)
- Die zusammensetzbaren Funktionen
LinearProgressIndicator
undCircularProgressIndicator
wurden hinzugefügt. (Ie116b)
Fehlerkorrekturen
- Implementierung von Vorlagen auf dem ersten Blick, definiert Daten aus „Vorlage für einzelne Artikel“ und Beispiellayout (I35837)
- Kachelraster standardmäßig zentrieren (I264be)
- Fehlerkorrektur für „fillMaxSize/Width/Height“ in „look-wear-tiles“-Kacheln (I0a39f)
Version 1.0.0-alpha02
26. Januar 2022
androidx.glance:glance-*:1.0.0-alpha02
wird freigegeben. Version 1.0.0-alpha02 enthält diese Commits.
Neue Funktionen
Dieser Release enthält die APIs zum Erstellen von Wear-Kacheln mithilfe der Compose-Laufzeit mit zusammensetzbaren Funktionen, die für „Glanceable“ optimiert sind
- Deklarieren Sie Ihren Kacheldienst, indem Sie
GlanceTileService
erweitern, einen Dienst zum Erstellen der Kachel in der Funktion „Zusammensetzbare Content()“. - Mit diesen zusammensetzbaren Funktionen kannst du Kacheln auf einen Blick erstellen:
CurvedRow
,CurvedText
. - Definiere
TimelineMode.SingleEntry
undTimelineMode.TimeBoundEntries
, um verschiedene Zeitachsenmodi für Kacheln zu verwalten. LocalTimeInterval
bezieht sich die lokale Zusammensetzung auf ein bestimmtes Zeitintervall.BorderModifer
ist einGlanceModifier
, mit dem ein Rahmen um ein Element angewendet wird.
In dieser Version werden auch Fortschrittsanzeigen zu AppWidget Glance hinzugefügt.
API-Änderungen
- Die zusammensetzbaren Funktionen
LinearProgressIndicator
undCircularProgressIndicator
wurden hinzugefügt. (Ie116b) actionStartBroadcastReceiver
zuactionSendBroadcast
(I7d555) ändern- Kontext an den onDelete-Callback
GlanceAppWidget
übergeben (I4c795)
Fehlerkorrekturen
- OPTIONS_APPWIDGET_SIZES wird korrekt verarbeitet, wenn es vorhanden, aber leer ist. (I01f82)
Version 1.0.0-alpha01
15. Dezember 2021
androidx.glance:glance:1.0.0-alpha01
, androidx.glance:glance-appwidget:1.0.0-alpha01
und androidx.glance:glance-appwidget-proto:1.0.0-alpha01
wurden veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Funktionen in der ersten Version
- Die erste Version von Glance enthält die ersten APIs zum Erstellen von AppWidget unter Verwendung von Compose Runtime mit einer Reihe neuer zusammensetzbarer Funktionen, die für „Glanceables“ optimiert sind.
Funktionen
- Deklarieren Sie Ihre App-Widgets mit GlanceAppWidget und GlanceAppWidgetReceiver.
- Erstellen Sie Ihre Benutzeroberfläche mit den ersten zusammensetzbaren Funktionen von Glance: Box, Row, Column, Text, Button, LazyColumn, Bild, Spacer.
- Wenden Sie Modifikatoren mithilfe von GlanceModifier-Methoden auf die zusammensetzbaren Funktionen an.
- Nutzerinteraktionen mit vordefinierten Actions verarbeiten
- Geben Sie mit ActionParameters Parameter für Action an.
- Sie können verschiedene Größenmodi bearbeiten, indem Sie SizeMode.Single, SizeMode.Exact oder SizeMode.Responsive definieren.
- GlanceAppWidget-Status durch Angabe einer GlanceStateDefinition beibehalten.
- Lokale Zusammensetzungen wie LocalContext, LocalState, LocalGlanceId, LocalSize.
- Interoperabilität mit Ihren vorhandenen RemoteViews mit der zusammensetzbaren Funktion AndroidRemoteViews