Letzte Aktualisierung | Stabile Version | Release Candidate | Beta-Ausgabe | Alpha-Release |
---|---|---|---|---|
30. Oktober 2024 | 1.4.0 | - | - | 1.5.0-alpha05 |
Abhängigkeiten deklarieren
Wenn du eine Wear-Abhängigkeit hinzufügen möchtest, musst du deinem 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 Artefakte hinzu, die Sie benötigen:
Cool
dependencies { implementation "androidx.wear.compose:compose-foundation:1.4.0" // For Wear Material Design UX guidelines and specifications implementation "androidx.wear.compose:compose-material:1.4.0" // For integration between Wear Compose and Androidx Navigation libraries implementation "androidx.wear.compose:compose-navigation:1.4.0" // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.4.0") // NOTE: DO NOT INCLUDE a dependency on androidx.compose.material:material. // androidx.wear.compose:compose-material is designed as a replacement // not an addition to androidx.compose.material:material. // If there are features from that you feel are missing from // androidx.wear.compose:compose-material please raise a bug to let us know. }
Kotlin
dependencies { implementation("androidx.wear.compose:compose-foundation:1.4.0") // For Wear Material Design UX guidelines and specifications implementation("androidx.wear.compose:compose-material:1.4.0") // For integration between Wear Compose and Androidx Navigation libraries implementation("androidx.wear.compose:compose-navigation:1.4.0") // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.4.0") // NOTE: DO NOT INCLUDE a dependency on androidx.compose.material:material. // androidx.wear.compose:compose-material is designed as a replacement // not an addition to androidx.compose.material:material. // If there are features from that you feel are missing from // androidx.wear.compose:compose-material please raise a bug to let us know. }
Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.
Feedback
Ihr Feedback hilft uns, Jetpack zu verbessern. Bitte teilen Sie uns mit, wenn Sie neue Probleme feststellen oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können einem vorhandenen Problem Ihre Stimme geben, indem Sie auf die Schaltfläche mit dem Stern klicken.
Weitere Informationen finden Sie in der Dokumentation zur Problemverfolgung.
Wear Compose Material3 Version 1.0
Version 1.0.0-alpha28
30. Oktober 2024
androidx.wear.compose:compose-material3:1.0.0-alpha28
wurde veröffentlicht. Version 1.0.0-alpha28 enthält diese Commits.
API-Änderungen
- Wir haben der unbestimmten kreisförmigen Fortschrittsanzeige (I2efc1) eine Bogenvariante hinzugefügt.
- Wir haben die
AlertDialogContent
- undDialog
-Kompositen, aus denen dieAlertDialog
API besteht, veröffentlicht, damit sie bei Bedarf angepasst werden können. So lässt sich beispielsweise dieAlertDialog
-Animation anpassen, während das empfohlene Inhaltslayout beibehalten wird. Außerdem haben wir den MitgliedernEdgeButton
,ConfirmButton
undDismissButton
vonAlertDialogDefaults
die ParameterModifier
undColor
hinzugefügt. (I4eb71) - Wir haben die
Placeholder
API wie folgt aktualisiert:PlaceholderState.startPlaceholderAnimation
inPlaceholderState.animatePlaceholder
,PlaceholderState.isShowContent
inPlaceholderState.isHidden
undPlaceholderDefaults.shape
inPlaceholderDefaults.Shape
umbenannt, denpainter
-Parameter inpainterWithPlaceholderOverlayBackgroundBrush
inoriginalPainter
umbenannt, die Sichtbarkeit vonPlaceholderState.placeholderProgression
von öffentlich in intern geändert und inplaceholderShimmerProgression
umbenannt; Konstanten für die Dauer der Platzhalteranimation wurden inPlaceholderDefaults
hinzugefügt. (Ie5a59) - Wir haben die
EdgeButton
API wie folgt aktualisiert: Der Parameter aufScreenScaffold
wurde vonbottomButton
inedgeButton
umbenannt undEdgeButtonSize
wurde zu einer Werteklasse. (Ieef15) - Wir haben die Sichtbarkeit von
copy()
in den Wear OS-Material 3-Farbklassen (I0287f) in „öffentlich“ geändert.
Fehlerkorrekturen
- Mindestdauer für die Animation von
IconToggleButton
undTextToggleButton
beim Klicken hinzugefügt (Ieb333) - Mindestdauer für die
IconButton
- undTextButton
-Formanimation hinzugefügt (Iebcee) - Der Status der Wiederholungsoption von
DatePicker
wurde korrigiert. (I3587c) - Für Benachrichtigungs- und Bestätigungsdialogfelder wurde eine Animation hinzugefügt. (I173b1)
Version 1.0.0-alpha27
16. Oktober 2024
androidx.wear.compose:compose-material3:1.0.0-alpha27
wird veröffentlicht. Version 1.0.0-alpha27 enthält diese Commits.
API-Änderungen
- Wir haben die
ScreenScaffold
undScrollIndicator
aktualisiert, nachdem die Wear Compose FoundationLazyColumn
inTransformingLazyColumn
umbenannt wurde. (I0608b) - Der Parameter
preferredHeight
vonEdgeButton
wurde inbuttonSize
umbenannt und sein Wert kann nur aus vier Konstanten in der neu eingeführten WertklasseEdgeButtonSize
ausgewählt werden. (Icdd70) - Wir haben die Benennung von
ListSubheader
inListSubHeader
geändert und öffentlich zugängliche Standardwerte fürListHeader
undListSubHeader
hinzugefügt. (I96730) - Wir haben neue
HorizontalPagerScaffold
- undVerticalPagerScaffold
-Komponenten für Wear hinzugefügt, die neue Animationen und eine bessere Abstimmung zwischen dem Zeittext und den Seitenindikatoren bieten. (Iff7d0) - Wir haben
HorizontalPagerScaffold
undVerticalPagerScaffold
jetzt mit Drehknopf unterstützt, sodass Nutzer auf Pager mit Drehknopfen navigieren können. (I9770d) - Wir haben
MotionScheme
API-Änderungen vorgenommen, um die Nutzung zu vereinfachen und die Konsistenz zu verbessern. Inline-Memory-Funktionen wurden entfernt und die integrierten Motion Schemes wurden in ein dediziertes MotionScheme-Begleitobjekt verschoben.standardMotionScheme
undexpressiveMotionScheme
wurden in „Standard und ausdrucksstark“ umbenannt. (I5fd45) - Wir unterstützen jetzt ein dynamisches Farbschema, das auf Systemfarben basiert. (I073e9)
- Wir haben den Schieberegler an die neuesten UX-Spezifikationen angepasst. (I622bb)
Fehlerkorrekturen
- Wir haben die Typografie und Abstände für Kartenkomponenten aktualisiert. (I3ae48)
- Wir haben den Abstand in
AlertDialog
zwischen den Schaltflächen „Bestätigen“/„Schließen“ und dem Rest des Inhalts gemäß den UX-Spezifikationen (Ie55f0) von 8 dp auf 12 dp geändert. - Wir haben die Farbdeckkraft für die Komponente „Schieberegler“ aktualisiert. (Idb383)
Version 1.0.0-alpha26
2. Oktober 2024
androidx.wear.compose:compose-material3:1.0.0-alpha26
wird veröffentlicht. Version 1.0.0-alpha26 enthält diese Commits.
API-Änderungen
- Wir haben die API und das Erscheinungsbild von
HorizontalPageIndicator
aktualisiert undVerticalPageIndicator
für die Verwendung mitVerticalPager
hinzugefügt (Ic9309). - Bei benutzerdefinierten Layouts, in denen EdgeButton nicht erforderlich ist, kann die standardmäßige untere Schaltfläche jetzt aus der Variante des Schaltflächen-Stacks weggelassen werden.
AlertDialog
(I34fa9) - Wir haben eine
SwipeToReveal
-Komponente für Wear Material 3 (Ic38b2) hinzugefügt - In
SwipeToReveal
wird das bidirektionale Wischen jetzt unterstützt, und zwar in seltenen Fällen, in denen der aktuelle Bildschirm das Wischen zum Schließen nicht unterstützt. Standardmäßig wird die Funktion „Wischen, um zu enthüllen“ weiterhin nur bei Wischen von rechts nach links aktiviert. Wir empfehlen dringend, das Standardverhalten beizubehalten, um Konflikte mit der Funktion „Wischen, um zu schließen“ zu vermeiden. (Ifac04) - Der
buttonHeight
-Parameter vonEdgeButton
wurde inpreferredHeight
umbenannt. (I4fab3) - Die Kotlin-Version wurde auf Version 1.9 (I1a14c) aktualisiert.
- Wir haben
OpenOnPhoneDialogDefaults.Icon
inOpenOnPhoneDialogDefaults.OpenOnPhoneIcon
umbenannt, um einen Konflikt mitIcon
zu vermeiden(I0f391). - In
LazyColumn
wird jetztScrollIndicator
unterstützt. (Ia546a) - Wir haben die Standardwerte für
TextToggleButton
undIconToggleButton
aktualisiert. (I7aaa9) - Wir haben die
Picker
- undPickerGroup
-API vereinfacht. (ID0653) - Wir haben
CardDefaults.Shape
undCardDefaults.Height
hinzugefügt. Diese Tokens waren sonst für Entwickler, die die Bibliothek verwenden, privat. (I1594a, b/347649765) - Der Fortschrittsparameter für die binär segmentierte kreisförmige Fortschrittsanzeige wurde in
segmentValue
umbenannt. (Ib72d9) - Wir haben die Farben und das Layout für den Schieberegler aktualisiert. (Ic3eec)
Fehlerkorrekturen
- Wir haben die
openOnPhone
-Symbolanimation aktualisiert (I66f85). - In
Slider
,TimePicker
undDatePicker
werden jetzt Google Symbols-Symbole verwendet. (I46c7c) - Wir haben die Abstände in
Confirmation
undOpenOnPhoneDialog
aktualisiert. (Iaa82e)
Version 1.0.0-alpha25
18. September 2024
androidx.wear.compose:compose-material3:1.0.0-alpha25
wird veröffentlicht. Version 1.0.0-alpha25 enthält diese Commits.
API-Änderungen
- Wir haben eine unbestimmte kreisförmige Fortschrittsanzeige hinzugefügt. (I427a7)
- Wir haben die Unterstützung für einen Fortschrittsüberlauf (> 100 %) sowohl für die
CircularProgressIndicator
als auch für dieSegmentedCircularProgressIndicator
hinzugefügt. Wenn der Fortschritt 1,0 überschreitet, wird dies durch die neue FarbeoverflowTrack
angezeigt. (Iaaa3d) - Die runden
IconToggleButton
undTextToggleButton
unterstützen jetzt eine neue Formanimation, bei der verschiedene Formen den angeklickten, nicht angeklickten und gedrückten Zustand darstellen. Die vorherige animierte Formvariante für den Zustand „Gerade gedrückt“ wird weiterhin unterstützt. (I29f03) - Die Unterstützung für die Verwendung von
EdgeButton
mitColumn
wurde entfernt, da dieEdgeButton
-Höhe inScreenScaffold
explizit angegeben werden muss. (Ie353d) - Wir haben die Unterstützung für die Wear OS-Funktion „Compose“
LazyColumn
mit unsererScreenScaffold
hinzugefügt und eine Implementierung vonScrollInfoProvider
fürLazyColumnState
hinzugefügt. (Ib8d29) - Wir haben
LocalTextMaxLines
,LocalTextAlign
undLocalTextOverflow
zu einer einzigen lokalenLocalTextConfiguration
-Komposition zusammengefasst, um eine skalierbarere Lösung zu bieten. (I5edbc) - Wir haben „arc-large“ als zusätzliche Schriftgröße hinzugefügt, die für kurze Textzeilen in der Kopfzeile ganz oben oder unten auf dem Bildschirm reserviert ist, z. B. in Bestätigungs-Overlays. (I60e3e)
- Wir haben der Schaltfläche Standardwerte für die empfohlenen großen und extragroßen Symbolgrößen und den Inhaltsabstand hinzugefügt. (I84675)
Fehlerkorrekturen
- Wir haben die Farben für
IconButton
undTextButton
aktualisiert. (I48324) - Wir haben die Basisüberladungen für Schaltflächen so geändert, dass sie vertikal zentriert sind, um für Einheitlichkeit mit anderen Überladungen zu sorgen. Wenn Sie das vorherige Verhalten wiederherstellen möchten, verwenden Sie
Modifier.align
aus demRowScope
. (I66e57)
Version 1.0.0-alpha24
4. September 2024
androidx.wear.compose:compose-material3:1.0.0-alpha24
wird veröffentlicht. Version 1.0.0-alpha24 enthält diese Commits.
API-Änderungen
- Wir haben dem Material3-Design ein Bewegungsschema hinzugefügt. Sie wird von Komponenten in der Bibliothek verwendet, um Animationsspezifikationen wie Federn für ausdrucksstarke Bewegungen anzuwenden. (I54ff3)
- Wir haben der Material3-Bibliothek
AppScaffold
- undScreenScaffold
-Komponenten hinzugefügt, die Funktionen zur Koordinierung von Ebenen und Übergängen vonTimeText
undScrollIndicator
enthalten.AppScaffold
stellt eine oberste Ebene von Scaffold-Komponenten bereit, die auf allen Bildschirmen platziert werden. Wenn Sie alsoTimeText
zuAppScaffold
hinzufügen, bleibt es an seinem Platz, während Sie zwischen den Bildschirmen wischen. Bildschirme können den Zeittext überschreiben oder ausblenden.ScreenScaffold
stellt einen Slot fürScrollIndicator
bereit und animiert beim Scrollen automatisch die Scroll-Anzeige, einschließlich eines Zeitlimits, um die Scroll-Anzeige nach Inaktivität auszublenden. (I047d6) - Wir haben
ScrollIndicator
mit dem neuen Material3-Design hinzugefügt. Die Thumbnail-Größe richtet sich nach dem ursprünglichen Listeninhalt. So lassen sich Größenschwankungen vermeiden, wenn Lazy Content in die Liste geladen wird. (IC228d) - Wir haben die
ScrollAway
API so geändert, dassScreenStage
eine Werteklasse anstelle einer Enum-Klasse ist, damit nach Bedarf weitere Phasen hinzugefügt werden können. (I48c93) - Wir haben
EdgeButton
hinzugefügt, eine charakteristische Wear-spezifische Schaltfläche, deren Form der Krümmung des unteren Displayrandes folgt (I16369). - Wir haben der
ScreenScaffold
einen neuen Slot für eine untere Schaltfläche (z. B.EdgeButton
) hinzugefügt, die je nach scrollbaren Inhalten angezeigt und deren Größe angepasst wird (I032eb). - Wir haben
Modifier.scrollTransform
undModifier.targetMorphingHeight
hinzugefügt, um Elementen inLazyColumn
Material3-Bewegungseffekte hinzuzufügen. (Ie229a) - Wir haben
SegmentedCircularProgressIndicator
als Variante vonCircularProgressIndicator
hinzugefügt. Bei der segmentierten Variante wird entweder ein einzelner Fortschrittswert für alle Segmente angezeigt oder jedes Segment wird als aktiviert oder deaktiviert angezeigt (I6e059). - Wir haben
LinearProgressIndicator
als Alternative zur vorhandenenCircularProgressIndicator
hinzugefügt. (I89182) - Wir haben
AlertDialog
hinzugefügt. Mit diesen Layouts können Nutzer wichtige Aufforderungen präsentieren. Variationen werden entweder für ein Paar Bestätigungs-/Schließen-Schaltflächen oder für eine einzelne untere Schaltfläche (in der Regel eine EdgeButton) unter einem Stapel von Optionen enthalten. Beide Varianten haben Slots für Symbol, Titel und zusätzlichen Text, um weitere Details anzugeben. (Ieb873) - Wir haben
OpenOnPhoneDialog
hinzugefügt, das für eine Aktion verwendet werden sollte, die auf dem Smartphone des Nutzers fortgesetzt wird.OpenOnPhoneDialog
wird nach einem bestimmten Zeitlimit geschlossen. (I978fd) - Wir haben
Confirmation
hinzugefügt, eine Dialogfeldkomponente mit Slots für ein Symbol und entweder gebogenen oder geraden Text. Für Erfolgs-/Misserfolgsmeldungen werden spezielle Variationen angegeben. Bestätigungen werden nach einer bestimmten Zeit automatisch geschlossen. (Ib43e8) - Wir haben
TimeText
einen Hintergrund hinzugefügt, um Probleme zu vermeiden, bei denen sich die zugrunde liegenden Inhalte undTimeText
überschneiden und die Uhrzeit verdecken. (Ia11fd) - Wir haben
LevelIndicator
hinzugefügt. Es zeigt den Wert einer Einstellung wie z. B. der Lautstärke an und kann mit der vorhandenenStepper
-Komponente zum Erstellen eines Lautstärkebildschirms verwendet werden.LevelIndicator
ähneltScrollIndicator
, wird aber auf der gegenüberliegenden Seite des Bildschirms angezeigt und hat standardmäßig eine breitere Strichbreite und eine andere Indikatorfarbe. (I8a4ac) - Wir haben
TimePicker
hinzugefügt, mit Layouts für die 24-Stunden-Zeit (mit oder ohne Sekunden) oder die 12-Stunden-Zeit mit der Wahl zwischen AM/PM. (Ia5124) - Wir haben
DatePicker
mit einer Konfiguration für die Spaltensortierung (d.h. Tag-Monat-Jahr, Monat-Tag-Jahr oder Jahr-Monat-Tag) und optionalen Mindest-/Maximaldaten hinzugefügt. (Ibf13b) - Wir haben der Funktion
text
vonTimeText
einen Gewichtsparameter hinzugefügt. Wenn „ZeitText“ aus mehreren Textelementen besteht, kannst du so festlegen, wie das Leerzeichen verteilt wird. (I36700) - Wir haben
RadioButton
undSplitRadioButton
hinzugefügt. Diese Komponenten vereinfachen die vorherige API, da sie sowohl (Split)SelectableButton
als auch die untergeordnete Optionsschaltfläche (If7ae8) kombinieren. - Wir haben
CheckboxButton
undSplitCheckboxButton
hinzugefügt. Diese Komponenten vereinfachen die vorherige API, da sie sowohl das (Split)ToggleButton
-Element als auch das untergeordnete Kästchen-Steuerelement (Ia8f70) kombinieren. - Wir haben
SwitchButton
undSplitSwitchButton
hinzugefügt. Diese Komponenten vereinfachen die vorherige API, da sie sowohl die(Split)ToggleButton
als auch die untergeordnete Schaltersteuerung kombinieren (I0d349). - Wir haben die Dokumentation zu
AnimatedText
aktualisiert, um das Überschwingen zu erläutern. (Iff30a) - Wir haben
ButtonGroup
hinzugefügt, um zwei oder drei Schaltflächen zu kombinieren, sodass die Betätigung der Schaltflächen eine koordinierte Animation auslöst. (Ie27db) - Beim Drücken wurde eine optionale Formanimation für
IconButton
undTextButton
hinzugefügt. (Iffca5) - Wir haben
Button
,IconButton
,TextButton
,CompactButton
undEdgeButton
(I65fc3) eine zusätzliche Farbvariante hinzugefügt:FilledVariant
. - Wir haben
ImageWithScrimPainter
den ParameterforcedSize
hinzugefügt, damit die Bildhintergründe von Schaltflächen jetzt standardmäßig ihre Komponentengröße beibehalten. Wenn Sie fürforcedSize = null
festlegen, wird stattdessen dasPainter.instrinsicSize
verwendet. (Ic57af) - Wir haben den Schaltflächen (Ib613d) die Langklick-Funktion hinzugefügt.
- Außerdem wurde die Unterstützung für langes Drücken auf
IconButton
undTextButton
hinzugefügt. (I38891) - Für Google Pixel Tablet wurde die Unterstützung für langes Drücken auf Karten hinzugefügt. (I305d5)
- Wir haben
LocalTextMaxLines
,LocalTextAlign
undLocalTextOverflow
alsCompositionLocals
hinzugefügt und als Standardparameter fürText
verwendet. Die lokalen Kompositionen können jetzt von Komponenten wieCheckboxButton
,SwitchButton
undRadioButton
verwendet werden, um UX-Richtlinien zu implementieren. Die Parameter können jedoch bei Bedarf von Entwicklern überschrieben werden. (Iab841) - Wir haben
Placeholder
hinzugefügt, um den Inhalt von Komponenten wie Schaltflächen und Karten zu maskieren, bis die Daten geladen sind. (I1a532) - Wir haben
IconToggleButtonColors
undTextToggleButtonColors
hinzugefügt, um die jetzt entfernteToggleButtonColors
zu ersetzen. (Ie0bf1)
Fehlerkorrekturen
- Wir haben
Button
,FilledTonalButton
,OutlinedButton
,ChildButton
undCompactButton
aktualisiert, um die neuenCompositionLocals
-ParameterLocalTextMaxLines
,LocalTextAlign
undLocalTextOverflow
zur Implementierung von UX-Richtlinien zu verwenden. Diese Parameter können von Entwicklern bei Bedarf direkt in Text überschrieben werden (Ie51f7) - Die Standard-Strichstärke des
LevelIndicator
wurde in6dp
geändert, um es von demScrollIndicator
mit einer Strichstärke von4dp
zu unterscheiden. (If6f63) - Wir haben ein Problem in
TimeText
behoben, sodass größere Erledigungswinkel unterstützt werden. (Ie489f) - Ein Problem bei der Neuzusammensetzung von
EdgeButton
wurde behoben. (I4cdca) - Das Layout von geteilten Ein-/Aus-Schaltflächen wurde korrigiert, wenn benutzerdefinierte Abstände für den Inhalt angegeben sind. (Ia33d3)
- Kleine Fortschrittswerte werden auf mindestens die Linienbreite der Fortschrittsanzeige aufgerundet. (I3bd84)
Version 1.0.0-alpha23
14. Mai 2024
androidx.wear.compose:compose-material3:1.0.0-alpha23
wird veröffentlicht. Version 1.0.0-alpha23 enthält diese Commits.
API-Änderungen
- Wir haben die
ToggleButton
- undRadioButton
-APIs so aktualisiert, dass deaktivierte Farben konfiguriert werden können. (If13a7) - Wir haben eine neue
CircularProgressIndicator
für Material3 hinzugefügt. (Ib3bd7)
Fehlerkorrekturen
- Wir haben einen Fehler behoben, bei dem für auswählbare Schaltflächen ein Doppeltippen zum Umschalten angekündigt wurde, wenn sie bereits ausgewählt waren. (I7ed88)
Version 1.0.0-alpha22
1. Mai 2024
androidx.wear.compose:compose-material3:1.0.0-alpha22
wird veröffentlicht. Version 1.0.0-alpha22 enthält diese Commits.
API-Änderungen
- Wir haben das Material3-
ColorScheme
aktualisiert. (I7b2b8) - Wir haben den Material3 Switch aktualisiert. Neben einigen Farbänderungen ist das Häkchen nun mit dem des Kästchens identisch. (Icac7b)
Fehlerkorrekturen
- Alle Integrationsdemos auf den neuen Modifikator
rotaryScrollable
aktualisieren (I25090)
Version 1.0.0-alpha21
17. April 2024
androidx.wear.compose:compose-material3:1.0.0-alpha21
wurde veröffentlicht. Version 1.0.0-alpha21 enthält diese Commits.
- Dieser Release wurde aufgrund eines technischen Problems in der vorherigen Version ausgelöst, das zu fehlenden Quell-JAR-Dateien führte. In dieser Version gibt es keine neuen Commits.
Version 1.0.0-alpha20
3. April 2024
androidx.wear.compose:compose-material3:1.0.0-alpha20
wird veröffentlicht. Version 1.0.0-alpha20 enthält diese Commits.
Fehlerkorrekturen
- Wir haben die Alphas für den gedrückten und fokussierten Zustand von „Ripple“ für den Kontrast angepasst. (I59f0a)
- Wir haben den Abstand zwischen primären und sekundären Labels in
Button
,ToggleButton
undRadioButton
gemäß den neuesten Änderungen bei Typografie und Zeilenhöhe hinzugefügt. (I2c0ba)
Version 1.0.0-alpha19
6. März 2024
androidx.wear.compose:compose-material3:1.0.0-alpha19
wurde veröffentlicht. Version 1.0.0-alpha19 enthält diese Commits.
API-Änderungen
- Wir haben
TimeText
der Wear Compose Material3-Bibliothek hinzugefügt. Diese Komponente zeigt die aktuelle Uhrzeit und den zusätzlichen Status oben auf dem Bildschirm an. Die neue, kompakte Material3 API verhindert Duplikate zwischen linearen und gebogenen Inhalten. (I4d7c3) - Die Parameternamen für
RadioButton
wurden vononSelected
aufonSelect
geändert. (I1a971) - Tokenisieren Sie
RadioButton
undSplitRadioButton
und überarbeiten Sie die vorhandenen Methoden, um die Anzahl derCompositionLocal
-Suchanfragen zu reduzieren. Dazu fügen Sie zwischengespeicherte Instanzen von Farben hinzu und machen die Methoden vonRadioButtonColors
undSplitRadioButtonColors
intern. (I02b33)
Version 1.0.0-alpha18
21. Februar 2024
androidx.wear.compose:compose-material3:1.0.0-alpha18
wird veröffentlicht. Version 1.0.0-alpha18 enthält diese Commits.
API-Änderungen
- Wir haben das Standardmuster für
CardColors
,ToggleButtonColors
undSplitToggleButtonColors
neu strukturiert, indem wir intern zwischengespeicherte Instanzen erstellt und die Nutzung vonCompositionLocal
reduziert haben. (If3fec)
Version 1.0.0-alpha17
7. Februar 2024
androidx.wear.compose:compose-material3:1.0.0-alpha17
wird veröffentlicht. Version 1.0.0-alpha17 enthält diese Commits.
API-Änderungen
- Wir haben die Button API aktualisiert, sodass standardmäßig
buttonColors
verwendet wird. Die doppelte Definition vonfilledButtonColors
wurde entfernt. (I4fe3b) - Wir haben die Standardmuster für
ButtonColors
,IconButtonColors
undTextButtonColors
neu strukturiert, indem wir intern eine zwischengespeicherte Instanz erstellt und die Nutzung vonCompositionLocal
reduziert haben. (I5f51c) - Wir haben den Overhead von
rememberUpdatedState
in komponentenspezifischen Farbklassen entfernt und Zugriffsmethoden in Farbklassen als intern gekennzeichnet. (If6571)
Fehlerkorrekturen
- Wir haben
Modifier.minimumInteractiveComponentSize
aufModifier.node
umgestellt. (Iba6b7)
Version 1.0.0-alpha16
24. Januar 2024
androidx.wear.compose:compose-material3:1.0.0-alpha16
wird veröffentlicht. Version 1.0.0-alpha16 enthält diese Commits.
Neue Funktionen
- Wir haben
CompactButton
hinzugefügt, für das dieselben Farben wie für „Schaltfläche“ verwendet werden können (I05df0).
API-Änderungen
- Wir haben
RadioButton
/SplitRadioButton
als Container für Auswahlsteuerelemente wie das Optionsfeld hinzugefügt. Dies unterscheidet sich von der vorhandenenToggleButton
insofern, alsRadioButton
auswählbar ist (und innerhalb einer Auswahlgruppe ausgeführt wird), währendToggleButton
umschaltbar ist (und unabhängig ist). (I61275) - Wir entfernen
LocalContentAlpha
aus der Wear Compose Material3-Bibliothek, um für Einheitlichkeit mit der Compose Material3-Bibliothek zu sorgen. (I49a0a) - Wear-Material und Wear Material3-Komponenten, für die eine
MutableInteractionSource
in ihrer API offengelegt wird, wurden aktualisiert. Jetzt ist eineMutableInteractionSource
verfügbar, für die Nullwerte zulässig sind, die standardmäßig auf null gesetzt ist. Hier gibt es keine semantischen Änderungen: Wenn Sie „null“ übergeben, möchten Sie dieMutableInteractionSource
nicht hochladen. Sie wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie zu „null“ wechseln, wird für einige Komponenten nie eineMutableInteractionSource
zugewiesen. Andere Komponenten können dann nur bei Bedarf eine Instanz erstellen, was die Leistung dieser Komponenten insgesamt verbessert. Wenn du denMutableInteractionSource
, den du an diese Komponenten weitergibst, nicht verwendest, solltest du stattdessen „null“ übergeben. Es wird auch empfohlen, ähnliche Änderungen an Ihren eigenen Komponenten vorzunehmen. (Ib90fc, b/298048146) - Es wird eine neue Ripple API in den
wear:compose-material
- undwear:compose-material3
-Bibliotheken hinzugefügt, die die eingestellterememberRipple
ersetzt. Außerdem wird ein temporärerCompositionLocal
,LocalUseFallbackRippleImplementation
hinzugefügt, um Materialkomponenten wieder auf die veraltetenrememberRipple/RippleTheme
APIs umzustellen. Diese Funktion wird in der nächsten stabilen Version entfernt. Sie dient nur als vorübergehende Migrationshilfe für Fälle, in denen Sie eine benutzerdefinierteRippleTheme
bereitstellen. Informationen zur Migration und weitere Hintergrundinformationen zu dieser Änderung finden Sie unter developer.android.com. (af92b21) - Wir haben die
HorizontalPageIndicator
API und die zugehörige Dokumentation geringfügig verbessert. (I60efc) - Wir haben
ColorScheme
so aktualisiert, dass sie unveränderlich ist. Dadurch sind einzelne Farbänderungen weniger effizient, aber die gängige Verwendung von Farben ist effizienter. Der Grund für diese Änderung ist, dass in den meisten Apps das Aktualisieren einzelner Farben nicht der Hauptanwendungsfall ist. Das ist zwar weiterhin möglich, aber es wird mehr als zuvor neu zusammengesetzt. Dadurch reduzieren wir die Anzahl der Statusabos im gesamten Materialcode erheblich und wirken sich auf die Initialisierungs- und Laufzeitkosten bei Standardanwendungsfällen aus. (Ibc2d6) - Die APIs
ToggleButton
undSplitToggleButton
wurden aktualisiert, damit deaktivierte Farben angepasst werden können. Außerdem werden jetzt Material Design-Tokens für Farb- und Typografiewerte verwendet. (If087c) - Die Hintergrundfarben von Schaltflächenbildern wurden aktualisiert, um Material Design-Tokens zu verwenden. (Iba215)
- Wir haben die Komponenten
Checkbox
,Switch
undRadioButton
so geändert, dass sie schreibgeschützt sind, indem die Klickbehandlung entfernt wurde. Diese Komponenten werden in(Split)ToggleButton
verwendet, das den Klick verarbeitet. Daher sind sie jetzt deutlicher als nur für die Anzeige gekennzeichnet und nicht für die eigenständige Verwendung auf Wear-Geräten vorgesehen. (I2322e)
Fehlerkorrekturen
- Wir haben Tokens für Bewegungswerte für Dauer und Easing in Wear Compose Material 3 hinzugefügt. (I437cd)
- Wir haben einen Fehler in
ToggleButton
,SplitToggleButton
,Checkbox
,Switch
undRadioButton
behoben, sodass Ankündigungen zur Barrierefreiheit nicht wiederholt werden (bisher wurden semantische Rollen dupliziert). (Ica281) - Wir haben die Materialcore-Ebene für
CompactButton
entfernt, um die Leistung zu verbessern. (7902858)
Version 1.0.0-alpha15
15. November 2023
androidx.wear.compose:compose-material3:1.0.0-alpha15
wird veröffentlicht. Version 1.0.0-alpha15 enthält diese Commits.
API-Änderungen
- Wir haben die Grundlagenebene
SwipeToDismissBox
inBasicSwipeToDismissBox
umbenannt. So wird die Unterscheidung zwischen der Komponente auf Foundation-Ebene und der Material3-EbeneSwipeToDismissBox
klarer. Letztere ruft Farben aus derMaterialTheme
ab, die in den Scrims verwendet werden sollen, und delegiert die restliche Implementierung an dieBasicSwipeToDismissBox
. (Ibecfc)
Fehlerkorrekturen
- Wir haben die Material-Core-Ebene für Material3-Schaltflächen entfernt, um die Leistung zu verbessern. (I55555)
Version 1.0.0-alpha14
18. Oktober 2023
androidx.wear.compose:compose-material3:1.0.0-alpha14
wird veröffentlicht. Version 1.0.0-alpha14 enthält diese Commits.
API-Änderungen
- Wir haben den Parameter
indicatorStyle
aus Material3HorizontalPageIndicator
entfernt. Stattdessen folgt er der Form des Gerätedisplays (linear oder rund). (I83728) - Wir haben die Farben für
SplitToggleButton
von denen fürToggleButton
getrennt, indem wir eine neueSplitToggleButtonColors
-Klasse hinzugefügt haben. (I78bee)
Version 1.0.0-alpha13
4. Oktober 2023
androidx.wear.compose:compose-material3:1.0.0-alpha13
wird veröffentlicht. Version 1.0.0-alpha13 enthält diese Commits.
API-Änderungen
- Wir haben
TitleCard
ein optionales Untertitel-Feld hinzugefügt. (Ifc45a) - Wir haben Material Design-Farbtokens für
TextButton
hinzugefügt. (I769dc)
Version 1.0.0-alpha12
20. September 2023
androidx.wear.compose:compose-material3:1.0.0-alpha12
wird veröffentlicht. Version 1.0.0-alpha12 enthält diese Commits.
API-Änderungen
- Wir haben
IconButton
aktualisiert, damit Material Design-Tokens verwendet werden. (I3f137) - Wir haben
IconToggleButton
aktualisiert, damit Material Design-Tokens verwendet werden. (I7d263) - Die Konstruktoren von
CheckboxColors
,RadioButtonColors
undSwitchColors
sind jetzt öffentlich zugänglich. (I82b73)
Version 1.0.0-alpha11
6. September 2023
androidx.wear.compose:compose-material3:1.0.0-alpha11
wird veröffentlicht. Version 1.0.0-alpha11 enthält diese Commits.
Fehlerkorrekturen
- Wir haben die Typografie für Material3-Karten auf
TitleMedium
aktualisiert. (I597bd) - Wir haben die Typografie und Ausrichtung für unsere Material3-
ListHeader
undListSubheader
-Schriftarten aktualisiert. (Ib5ceb)
Version 1.0.0-alpha10
23. August 2023
androidx.wear.compose:compose-material3:1.0.0-alpha10
wird veröffentlicht. Version 1.0.0-alpha10 enthält diese Commits.
Neue Funktionen
- Fügen Sie
HorizontalPageIndicator
in die Wear Material3-Bibliothek ein. (Ifee99)
API-Änderungen
- Aktualisieren Sie den Code für Schaltflächen, damit Material3-Design-Tokens verwendet werden. (I92fe4)
- Die APIs für Wear 3-Stufenschalter und -Schieberegler werden als experimentell deklariert, da die Details der Benutzeroberfläche noch finalisiert werden. (I84d54)
- Die
ExtraSmall
-Größen wurden aus den rundenTextButton
undTextToggleButton
entfernt, da diese Größe nur für dieIconButton
gilt. (Ibc7d5)
Fehlerkorrekturen
- Wir haben die Typografierichtlinien für TextToggleButton aktualisiert, um LabelLarge für LargeButtonSize zu verwenden (Ib10fa).
- Wir haben die Typografie-Richtlinien für TextButton aktualisiert, um LabelLarge für LargeButtonSize zu verwenden (I8f3a7).
- Wir haben den Mindestberührungszielbereich der Karte aus Gründen der Barrierefreiheit auf 48 dp festgelegt. (Ieb9b1)
- Demo für App-Karte mit Bild hinzufügen, Demo für App-Karte mit Hintergrund entfernen (Id735f)
- Ein Fehler wurde behoben, bei dem bei runden Schaltflächen die Modifikatoren nicht richtig verkettet wurden. (I5e162)
Version 1.0.0-alpha09
9. August 2023
androidx.wear.compose:compose-material3:1.0.0-alpha09
wird veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.
Neue Funktionen
- Wir haben
ToggleButton
für „material3“ (I6bed6) hinzugefügt.
API-Änderungen
- Wir haben die
FloatRange
-Anmerkung als API-Einschränkungen aktiviert , die zuvor in Kommentaren angegeben wurden. (Icb401) - Wir haben die Typografie für Wear Material3 aktualisiert, damit sie den neuesten Material3-Richtlinien entspricht. (I1bad6)
Fehlerkorrekturen
- Wir haben die Farben für
Button
,IconButton
undTextButton
gemäß dem Material3-Design aktualisiert. (Ib2495) - Die Sichtbarkeit von Kästchenmarkierungen im deaktivierten Status wurde korrigiert. (Ib25bf)
Version 1.0.0-alpha08
26. Juli 2023
androidx.wear.compose:compose-material3:1.0.0-alpha08
wird veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.
Neue Funktionen
- Wir haben die folgenden Auswahlsteuerelemente für Material 3 hinzugefügt:
Switch
,Checkbox
undRadioButton
. (Ib918c) - Wir haben Material 3 die kreisförmigen Ein-/Aus-Schaltflächen
IconToggleButton
undTextToggleButton
hinzugefügt, die jeweils einen einzelnen Steckplatz für Symbol und Text haben. Für unterschiedliche Größen vonToggleButton
empfehlen wir,Modifier.touchTargetAwareSize
mit den Größen zu verwenden, die in den entsprechenden Ein-/Aus-Schaltflächen angegeben sind. (I9f015) - Wir haben unseren Material3-Komponenten
ListHeader
undListSubheader
hinzugefügt. (Ibaefe) - Wir haben Material3
SwipeToDismissBox
hinzugefügt, das die neue FoundationSwipeToDismissBox
aufruft und Standardfarbwerte aus dem jeweiligen Design liefert. (I275fb) - Wir haben das Material3-
InlineSlider
zu Wear Compose hinzugefügt. Nutzende können einen Wertebereich auswählen. Der Auswahlbereich wird als Balken zwischen dem Mindest- und Höchstwert des Bereichs dargestellt, aus dem Nutzer einen einzelnen Wert auswählen können.InlineSlider
eignet sich ideal zum Anpassen von Einstellungen wie Lautstärke oder Helligkeit. (I7085f)
API-Änderungen
- Wir haben die Formen im Wear Material 3-Design aktualisiert, sodass jetzt
RoundedCornerShape
statt „Form“ verwendet wird. (Idb133) - Wir haben die Höhenkonstanten für die Schaltfläche veröffentlicht (Idbfde).
- API-Dateien wurden aktualisiert, um mit Anmerkungen zur Unterdrückung der Kompatibilität zu versehen (I8e87a, b/287516207)
- Wir haben
InlineSliderColors
in Wear Compose Material 3 aktualisiert, damit es einen öffentlichen Konstruktor und öffentliche Eigenschaften hat. (I6b632) - Wir haben alle Farbklassen in Wear Compose Material 3 so aktualisiert, dass sie öffentliche Konstruktoren und öffentliche Eigenschaften enthalten. (I17702)
- Wir haben die Konstanten für horizontale und vertikale Ränder von Schaltflächen veröffentlicht. (Ieeaf7)
Fehlerkorrekturen
- Die Höhe der Schaltfläche wird jetzt bei Bedarf an Inhalte angepasst, die aufgrund großer Schriftgrößen größer geworden sind (Iaf302).
- Wir haben einige Schaltflächen-Demos aktualisiert, um Probleme mit der Barrierefreiheit zu beheben. (I61ce9)
Stepper
undInlineSlider
unterstützen jetzt wiederholte Klicks bei langem Drücken. Sie können den Wert vonStepper
undInlineSlider
jetzt schnell erhöhen oder verringern, indem Sie die Plus- oder Minusschaltflächen (I27359) gedrückt halten.
Version 1.0.0-alpha07
21. Juni 2023
androidx.wear.compose:compose-material3:1.0.0-alpha07
wurde veröffentlicht. Version 1.0.0-alpha07 enthält diese Commits.
Neue Funktionen
- Wir haben die Komponente
Stepper
in unsere Compose for Wear OS Material 3-Bibliothek aufgenommen. Diese Version ähnelt der vorherigen Material Design-Version, aber die Bereichssemantik wird standardmäßig gemäß dem Feedback von Entwicklern weggelassen.Modifier.rangeSemantics
enthält die Fälle, in denen Bereichssemantik erforderlich ist. (Ic39fd) - Wir haben der Bibliothek „Compose for Wear OS Material 3“
curvedText
hinzugefügt. (Ia8ae3)
Fehlerkorrekturen
- Wir haben
wear.compose.foundation
zu einer API-Abhängigkeit vonwear.compose.material3
gemacht (I72004, b/285404743)
Version 1.0.0-alpha06
7. Juni 2023
androidx.wear.compose:compose-material3:1.0.0-alpha06
wird veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
Fehlerkorrekturen
- Wir haben
TextButton
aktualisiert, um die ErweiterungsfunktiontoDisabledColor
für korrekte deaktivierte Alphawerte zu verwenden. (I814c8)
Version 1.0.0-alpha05
24. Mai 2023
androidx.wear.compose:compose-material3:1.0.0-alpha05
wird veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
Neue Funktionen
- Wir haben Material3 die Schaltfläche
TextButton
hinzugefügt, eine kreisförmige Schaltfläche mit einem einzigen Steckplatz für Text. Für verschiedene Größen vonTextButton
empfehlen wir die Verwendung vonModifier.touchTargetAwareSize
undExtraSmallButtonSize
,SmallButtonSize
,DefaultButtonSize
undLargeButtonSizeIcon
inTextButtonDefaults
. Die StandardeinstellungTextButton
hat keinen Rahmen und einen transparenten Hintergrund für Aktionen mit geringer Betonung. Verwenden SiefilledTextButtonColors
für Aktionen, die besonders hervorgehoben werden sollen. Für eine mittlere Betonung verwenden Sie ein umrandetesTextButton
und legen Sie den Rahmen aufButtonDefaults.outlinedButtonBorder
fest. Für einen Mittelweg zwischen umrandet und gefüllt verwenden SiefilledTonalTextButtonColors
. (I667e4) - Wir haben
Card
,OutlinedCard
,AppCard
undTitleCard
in die Wear Compose Material3-Bibliothek aufgenommen.AppCard
undTitleCard
können auch mitCardDefaults.outlinedCardColors
undCardDefaults.outlinedCardBorder
(I80e72) umrandet werden.
API-Änderungen
- Wir haben den Parameter „Label der Schaltfläche“ ans Ende verschoben, um die abschließende Lambda-Syntax zu unterstützen. Der Parameter „Rolle“ wurde entfernt, da er mit
Modifier.semantics
überschrieben werden kann.ButtonColors
-Konstruktoren sind jetzt öffentlich. (Ie1b6d)
Version 1.0.0-alpha04
10. Mai 2023
androidx.wear.compose:compose-material3:1.0.0-alpha04
wurde veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
Neue Funktionen
- Wir haben
IconButton
zu Material3 hinzugefügt, einer runden Schaltfläche mit einem einzelnen Slot für Symbol/Bild. Es gibt vier Varianten:IconButton
,FilledIconButton
,FilledTonalIconButton
undOutlinedIconButton
. Für verschiedene Größen vonIconButton
empfehlen wir die Verwendung vonModifier.touchTargetAwareSize
undExtraSmallButtonSize
,SmallButtonSize
,DefaultButtonSize
undLargeButtonSizeIcon
inIconButtonDefaults
. Außerdem gibt esIconButtonDefaults.iconSizeFor
, um die empfohlene Symbolgröße für eine bestimmte Schaltflächengröße zu ermitteln. (I721d4)
Version 1.0.0-alpha03
19. April 2023
androidx.wear.compose:compose-material3:1.0.0-alpha03
wird veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.
API-Änderungen
- Wir haben die Material 3-Schaltfläche hinzugefügt. Das ist unsere stadionförmige Schaltfläche, die in der Wear Compose Material-Bibliothek früher den Namen „Chip“ hatte. Sie wurde umbenannt, um für Einheitlichkeit mit der Compose Material 3-Bibliothek zu sorgen. Die Standardschaltfläche hat einen gefüllten Hintergrund. Es gibt auch Varianten für
FilledTonal
(gedeckter Hintergrund), „Outlined“ (transparent mit dünnem Rahmen) und „Child“ (transparenter Hintergrund und kein Rahmen, für zusätzliche Aktionen mit der geringsten Betonung). Die runden Schaltflächen für einfache Symbol- und Textinhalte werden in einer zukünftigen Version folgen (Ia6942).
Version 1.0.0-alpha02
5. April 2023
androidx.wear.compose:compose-material3:1.0.0-alpha02
wird veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.
Fehlerkorrekturen
- Wir haben eine
DefaultTextStyle
zu Wear Compose Material 3 hinzugefügt, wodurchPlatformTextStyle.includeFontPadding
standardmäßig auf „true“ gesetzt ist (die aktuelle Einstellung). So können wir das Deaktivieren des Schriftabstands standardmäßig mit den Compose-Bibliotheken synchronisieren (siehe Schriftabstand in Compose für Hintergrund beheben). (I7e461)
Version 1.0.0-alpha01
22. März 2023
androidx.wear.compose:compose-material3:1.0.0-alpha01
wurde veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Material 3 ist die nächste Weiterentwicklung von Material Design und umfasst aktualisierte Themen und neu gestaltete Komponenten. Material 3 in Wear Compose ist so konzipiert, dass es mit der Material 3 Compose-Bibliothek auf Android harmoniert. Diese erste Alphaversion enthält erste funktionale Implementierungen der folgenden Funktionen:
- Material-Design-Designvorlage: Hiermit werden das Farbschema, die Typografie und die Formen für alle Komponenten in der Bibliothek einheitlich konfiguriert. Das Material3-Design hat überarbeitete Farben, die einen barrierefreien Kontrast unterstützen. (I84005)
- Text/Symbol – Bausteine für Wear Compose-Apps (I8e06a)
Wir werden Wear Material (
androidx.wear.compose:compose-material
) und Wear Material 3 (androidx.wear.compose:compose-material3
) parallel weiter entwickeln. In zukünftigen Material 3-Releases wird der Widget-Katalog um weitere bekannte Komponenten aus Compose für Wear OS erweitert, z. B. Schaltflächen, Auswahlfelder und Schieberegler.Die Wear Material- und Wear Material 3-Bibliotheken schließen sich gegenseitig aus und sollten nicht in derselben App gemischt werden, hauptsächlich, weil sie auf unterschiedliche Themen verweisen, was zu unerwarteten Inkonsistenzen führen würde.
Wear Compose Version 1.5
Version 1.5.0-alpha05
30. Oktober 2024
androidx.wear.compose:compose-*:1.5.0-alpha05
wird veröffentlicht. Version 1.5.0-alpha05 enthält diese Commits.
API-Änderungen
- Wir haben die Unterstützung für
animateScrollTo
aufTransformingLazyColumnState
hinzugefügt, damit das Scrollen zu einem Element animiert werden kann. (I4097d) - Wir haben
requestScrollTo
aufTransformingLazyColumnState
hinzugefügt, um das Scrollen bis zur nächsten Messung zu verzögern. (I20a5e) - In
TransformingLazyColumn
wird jetztcontentPadding
unterstützt. (I3a69c)
Fehlerkorrekturen
- Wir haben einen Fehler beim Rendern des
TransformingLazyColumn
behoben, wenn die Inhaltshöhe kürzer als die Bildschirmhöhe ist. (I6c3e1) ScrollInfoProvder
fürTransformingLazyColumn
verfolgt jetzt das erste Element korrekt. (I1e4a3)TransformingLazyColumnState
speichert jetzt den Status (anchorItemIndex
undanchorItemScrollOffset
). (I3d265)
Version 1.5.0-alpha04
16. Oktober 2024
androidx.wear.compose:compose-*:1.5.0-alpha04
wird veröffentlicht. Version 1.5.0-alpha04 enthält diese Commits.
API-Änderungen
- Wir haben die Wear Compose Foundation
LazyColumn
inTransformingLazyColumn
umbenannt, damit sie sich leichter von der Compose FoundationLazyColumn
unterscheiden lässt. (I0608b) - Unterstützung für Drehknöpfe für horizontale/vertikale Pager hinzugefügt, damit Nutzer Pager mit Drehknöpfen bedienen können. (I9770d)
- Wir haben das neue Symbol
PagerDefaults
aktualisiert, um deutlich zu machen, dass der Bildlauf automatisch an die Seite springt. (Iff7d0) TransformingLazyColumnItemScrollProgress
ist jetzt eine Wertklasse, was die Leistung verbessern sollte. (Ic399e)TransformingLazyColumn
unterstützt jetzt standardmäßig Drehbewegungen. (I05206)TransformingLazyColumnState
unterstützt jetztscrollToItem
. (I507b3)@ExperimentalWearFoundationApi
aus derSwipeToReveal
API entfernt (I34a66)
Version 1.5.0-alpha03
2. Oktober 2024
androidx.wear.compose:compose-*:1.5.0-alpha03
wird veröffentlicht. Version 1.5.0-alpha03 enthält diese Commits.
API-Änderungen
- Wir haben die Unterstützung für das bidirektionale Wischen in
SwipeToReveal
hinzugefügt, für den seltenen Fall, dass das aktuelle Display das Wischen zum Schließen nicht unterstützt. . Standardmäßig wird die Funktion „Wischen, um zu enthüllen“ weiterhin nur bei Wischen von rechts nach links aktiviert. Wir empfehlen dringend, das Standardverhalten beizubehalten, um Konflikte mit der Funktion „Wischen, um zu schließen“ zu vermeiden. (Ifac04) - Wir haben
LazyColumnState
aktualisiert, umcanScrollForward
undcanScrollBackward
zu überschreiben. Das Scrollen wird jetzt beendet, wenn sich das erste oder letzte Element genau in der Mitte des Bildschirms befindet. (Ia77d7) - Wir haben neue
HorizontalPager
- undVerticalPager
-Komponenten hinzugefügt, die häufige Probleme beheben, z. B. die Fokusbehandlung und die Interaktion mit dem System durch Wischen zum Schließen, die bei Wear auftreten können. (I2902b) - Wir haben die Unterstützung für
LazyColumn
hinzugefügt, um diekey
undcontentType
des Clients überlayoutItems
freizugeben. (I1bd9c)
Fehlerkorrekturen
- Wir haben die Animationen mit gekrümmtem Text aktualisiert, damit sie flüssiger wiedergegeben werden. Dabei wurden Farbmarkierungen verwendet. (I73a15)
- Wir haben die Dokumentation „Material Dialog“ aktualisiert, um zu verdeutlichen, dass
onDismissRequest
nicht aufgerufen wird, nachdem das Flag „show“ auf „false“ gesetzt ist. (Ifd8d6) - Wir haben einen Fehler bei der Vignettenanimation im Materialdialogfeld behoben (I126bf).
Version 1.5.0-alpha02
18. September 2024
androidx.wear.compose:compose-*:1.5.0-alpha02
wird veröffentlicht. Version 1.5.0-alpha02 enthält diese Commits.
API-Änderungen
- Wir haben die Unterstützung für die Wear OS-Funktion „Compose“
LazyColumn
mit unsererScreenScaffold
hinzugefügt und eine Implementierung vonScrollInfoProvider
fürLazyColumnState
hinzugefügt. (Ib8d29) viewportSize
wurde zuLazyColumnLayoutInfo
hinzugefügt. (I4187f)
Fehlerkorrekturen
- Wir haben einen Fehler behoben, durch den das Drehen des Rades zum Scrollen in
ScalingLazyColumn
deaktiviert wurde, wenn dasuserScrollEnabled
-Flag auffalse
gesetzt war. (I490ab, b/360295825) - Wir haben einen Fehler behoben, der zu unerwartetem vertikalen Abstand bei gekrümmtem Text führte. Die Höhe des gekrümmten Texts entspricht jetzt besser dem tatsächlichen Platz, den der Text einnimmt. Hinweis: Dadurch werden wahrscheinlich Screenshot-Tests unterbrochen, die gekrümmten Text enthalten (Iaa6ef).
- Wir haben eine Fehlerkorrektur für
Dialog
rückgängig gemacht, bei der der RückrufonDismissRequest
aufgerufen wurde, wennshowDialog
auf „falsch“ gesetzt war. In einigen Fällen wurdeonDismissRequest
dadurch mehrmals aufgerufen. (I64656)
Version 1.5.0-alpha01
4. September 2024
androidx.wear.compose:compose-*:1.5.0-alpha01
wird veröffentlicht. Version 1.5.0-alpha01 enthält diese Commits.
API-Änderungen
- Wir haben der Wear Compose Foundation-Bibliothek eine neue
LazyColumn
mit den zugehörigenLazyColumnState
- undLazyColumnScope
-APIs hinzugefügt. Dies bildet die Grundlage für die Erstellung anpassbarer Skalierungs- und Morphing-Effekte mit Wear Compose. (Ib3b22) - Wir haben im Rahmen der neuen
LazyColumn
API eine indexierte Version vonitemsIndexed
zuLazyColumnScope
hinzugefügt. (Ib4a57) - Wir haben
LazyColumn
-Modifikatoren hinzugefügt, um Skalierungs- und Morphing-Verhaltensweisen zu unterstützen. (Ie229a) HierarchicalFocusCoordinator
wurde zur stabilen Version hochgestuft. (I31035)- Für gebogenen Text wird jetzt der Zeichenabstand unterstützt. (I3c740)
CurvedLayout.curvedComposable
wurde der ParameterrotationLocked
hinzugefügt, um die Drehung von Komponenten zu verhindern. (I66898)- Die temporäre
LocalUseFallbackRippleImplementation
API aus Verschleißmaterial und Verschleißmaterial3 wurde entfernt (I62282). WearDevices.SQUARE
aus der Multiview-Vorschau von@WearPreviewDevices
entfernt (I11c02)
Fehlerkorrekturen
SwipeToReveal
platziert die angezeigten Elemente jetzt im sichtbaren Bereich des Bildschirms. Das ist hilfreich, wennSwipeToReveal
in einer Liste verwendet wird, da die Elemente immer interaktiv sind und nie außerhalb des Bildschirms erscheinen. (I38929)SwipeToReveal
setztlastActionType
jetzt auf „None“, wennanimatedTo
abgeschlossen ist. (I59b03)- Die Dokumentation für den neuen
rotationLocked
-Parameter incurvedComposable
wurde verbessert. (Ifbd57) - Ein Absturz bei der Übergabe von
NaN
an dieperformFling
vonScalingLazyColumnSnapFlingBehavior
wurde behoben. (Ic13da) - Fehler beim Modifizierer für die Größe des gebogenen Layouts behoben (I0fedf)
- Wir unterstützen jetzt den mit "sp" angegebenen Buchstabenabstand. (I9f6e3)
- Wir haben einen Fehler im Material2-Dialog behoben, durch den der
onDismissRequest
-Callback nicht aufgerufen wurde, wenn das Dialogfeld unsichtbar wurde (I64656). LayoutCoordinates.introducesFrameOfReference
inLayoutCoordinates.introducesMotionFrameOfReference
umbenannt, um den Zweck besser zu verdeutlichen. Die zugehörige Funktion wurde umbenannt, um Koordinaten anhand dieses Flags zu berechnen. (I3a330)
Version 1.4
Version 1.4.0
4. September 2024
androidx.wear.compose:compose-*:1.4.0
wird veröffentlicht. Version 1.4.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.3.0
ScalingLazyColumn
undPicker
unterstützen jetzt standardmäßig die Eingabe über einen Drehknopf. Es wird empfohlen, die explizite Drehknopf-Behandlung zu entfernen und das Standardsystemverhalten zu verwenden. Verwenden Sie bei Bedarf den ParameterrotaryScrollableBehavior
, um entweder das Scroll- oder das Snap-Verhalten zu konfigurieren. Für das Snap-Verhalten wird empfohlen, das Snap-Verhalten und die Touch-Scrollfunktionen mit dem ParameterflingBehavior
anzugeben.Modifier.rotaryScrollable
ist ein neuer Modifikator, der drehbare Ereignisse mit scrollbaren Containern verbindet. So können Nutzer auf ihrem Wear OS-Gerät über eine Krone oder einen drehbaren Rand scrollen.SwipeDismissableNavHost
bietet jetzt eine Eintrittsanimation für In-App-Übergänge.PositionIndicator
wird jetzt standardmäßig angezeigt, wenn ein Bildschirm zum ersten Mal angezeigt wird.
Weitere Änderungen
- Eine vollständige Liste der Änderungen in Version 1.3.0 finden Sie in den Versionshinweisen zur Betaversion 01.
Version 1.4.0-rc01
21. August 2024
androidx.wear.compose:compose-*:1.4.0-rc01
wird veröffentlicht. Version 1.4.0-rc01 enthält diese Commits.
- Wir haben die Compose-Abhängigkeiten auf 1.7.0-rc01 aktualisiert und die Wear Compose-Navigation an androidx.lifecycle 2.8.3 angepinnt.
Version 1.4.0-beta03
12. Juni 2024
androidx.wear.compose:compose-*:1.4.0-beta03
wird veröffentlicht. Version 1.4.0-beta03 enthält diese Commits.
Fehlerkorrekturen
- Wir haben
Modifier.rotaryScrollable
aktualisiert, um die Verwendung von „focusable“ durch „focusTarget“ zu ersetzen. (ID294b) - Wir haben ein Problem behoben, durch das die
ProgressIndicator
ihre Ansage unterTalkBack
wiederholt hat. (I94563) - Die Baseline-Profile der Wear Compose-Bibliothek wurden aktualisiert. (I3cbc3)
Version 1.4.0-beta02
29. Mai 2024
androidx.wear.compose:compose-*:1.4.0-beta02
wird veröffentlicht. Version 1.4.0-beta02 enthält diese Commits.
Fehlerkorrekturen
- Wir haben die Breite der Begrenzung für gebogenen Text erhöht, der an Screenreader übergeben wird, um Probleme mit Kürzungen zu beheben (Id865f).
- Wir haben die Begrenzung des
HorizontalPageIndicator
, das an Screenreader übergeben wurde, eingeschränkt. Bisher nahm der Indikator den gesamten Bildschirm ein (Id8d7a).
Version 1.4.0-beta01
14. Mai 2024
androidx.wear.compose:compose-*:1.4.0-beta01
wird veröffentlicht. Version 1.4.0-beta01 enthält diese Commits.
1.4-beta01 von Compose für Wear OS bedeutet, dass der Release der Bibliothek vollständig und die API gesperrt ist (sofern nicht als experimentell gekennzeichnet). Wear Compose 1.4 enthält die folgenden neuen Funktionen:
- Wir haben
Modifier.rotaryScrollable
hinzugefügt, einen neuen Modifikator, der drehbare Ereignisse mit scrollbaren Containern verbindet. So können Nutzer auf ihrem Wear OS-Gerät über eine Krone oder einen drehbaren Rand scrollen. Außerdem wird die Drehrad-Eingabe jetzt standardmäßig vonScalingLazyColumn
undPicker
unterstützt. Verwenden Sie den ParameterrotaryScrollableBehavior
, um entweder das Scroll- oder das Snap-Verhalten zu konfigurieren. Für das Andocken wird empfohlen, das Andocken über den ParameterflingBehavior
sowie für das Scrollen durch Berührung bereitzustellen. SwipeDismissableNavHost
bietet jetzt eine Einstiegsanimation für In-App-Übergänge.PositionIndicator
wird jetzt standardmäßig angezeigt, wenn ein Bildschirm zum ersten Mal angezeigt wird.SelectableChip
undSplitSelectableChip
wurden als Variante zuToggleChip
hinzugefügt – verwenden Sie dies mitRadioButton
, um eine auswählbare Semantik anstelle einer ein-/ausschaltbaren Semantik für die Barrierefreiheit bereitzustellenListHeader
unterstützt jetzt Höhenanpassungen, wenn Inhalte für große Schriftgrößen zusätzliche Höhe benötigen.
Fehlerkorrekturen
- Wir haben einen Fehler behoben, durch den bei auswählbaren Chips die Aufforderung zum Doppeltippen zum Umschalten angezeigt wurde, wenn sie bereits ausgewählt waren. (I7ed88)
Version 1.4.0-alpha08
1. Mai 2024
androidx.wear.compose:compose-*:1.4.0-alpha08
wird veröffentlicht. Version 1.4.0-alpha08 enthält diese Commits.
API-Änderungen
- Wir haben die folgenden Änderungen an der neuen Drehknopf-API vorgenommen:
Modifier.rotary
inModifier.rotaryScrollable
umbenannt, dieRotaryBehavior
-Benutzeroberfläche inRotaryScrollableBehavior
und die FunktionhandleScrollEvent
inperformScroll
,RotaryScrollableAdapter
inRotaryScrollableLayoutInfoProvider
umbenannt und das AttributscrollableState
entfernt. (I0c8a6) - Wir haben weitere Änderungen an der Drehknopf-API vorgenommen:
RotaryScrollableLayoutInfoProvider
inRotarySnapLayoutInfoProvider
umbenannt (da dieser Anbieter nur für Drehknöpfe mit Snap benötigt wird) und den Typ dessnapOffset
-Parameters inRotaryScrollableDefaults.snapBehavior snapOffset
von „Int“ zu „Dp“ geändert. (Iddebe) - Der Parameter
clickInteractionSource
aufSplitSelectableChip
wurde incontainerInteractionSource
umbenannt. (Ia8f84) - Wir haben die Namen der Callback-Parameter für Klicks für
SplitSelectableChip
vononClick
zuonSelectionClick
und vononBodyClick
inonContainerClick
geändert. (I32237)
Fehlerkorrekturen
- Wir haben den horizontalen Abstand für
PositionIndicator
auf 2 dp (vorher 5 dp) aktualisiert, um einen Fehler zu beheben, bei dem diePositionIndicator
(Bildlaufleiste) über scrollbare Inhalte hinwegragte. Hinweis: Durch den geänderten Abstand werden vorhandene Screenshots, die dasPositionIndicator
enthalten, voraussichtlich nicht mehr funktionieren. (I57472) - Wir haben die Dokumentation für das neue Dreh-API verbessert, indem die Unterschiede zwischen hochauflösenden Drehgeräten beschrieben werden. (I63abe)
- Wir haben eine Ausnahme bei
SwipeDismissableNavHost
behoben, die ausgelöst werden konnte, wenn interpolierte Alphawerte kleiner als null waren. (Ib75a1, b/335782510)
Version 1.4.0-alpha07
17. April 2024
androidx.wear.compose:compose-*:1.4.0-alpha07
wurde veröffentlicht. Version 1.4.0-alpha07 enthält diese Commits.
API-Änderungen
- Wir haben
Modifier.rotary
hinzugefügt, einen neuen Modifikator, der drehbare Ereignisse mit scrollbaren Containern verbindet. So können Nutzer auf ihrem Wear OS-Gerät über eine Krone oder einen drehbaren Rand scrollen. Außerdem unterstützenScalingLazyColumn
und Picker jetzt standardmäßig die Dreheingabe. Es gibt neue Überladungen mit dem ParameterrotaryBehavior
, mit dem die Konfiguration von Scrollen oder Snap festgelegt werden kann. Wenn der ParameterrotaryBehavior
auf „Snap“ gesetzt ist, wird empfohlen, für das Scrollen per Touch auch „Snap“ über den ParameterflingBehavior
anzugeben. (I2ef6f) - Die
NestedScroll
-Quellen „Ziehen“ und „Wischen“ werden durchUserInput
undSideEffect
ersetzt, um der erweiterten Definition dieser Quellen Rechnung zu tragen. Dazu gehören jetzt auch Animationen (Nebeneffekt) sowie Mausrad und Tastatur (Nutzereingaben). (I40579) - Wir haben
SelectableChip
undSplitSelectableChip
hinzugefügt, um die Unterscheidung zwischen Ein-/Aus-Schaltflächen wieSwitch/Checkbox
und auswählbaren Steuerelementen wieRadioButton
klarer zu machen. Dadurch werden die zuvor hinzugefügten Überladungen vonToggleChip/SplitToggleChip
durchselectionControl
-Parameter ersetzt. (Ia0217) - Der Sichtbarkeitsmodifikator von „
IndeterminateStrokeWidth
“ in „ProgressIndicatorDefaults
“ wurde zu „Öffentlich“ geändert. (I5b5a4)
Version 1.4.0-alpha06
3. April 2024
androidx.wear.compose:compose-*:1.4.0-alpha06
wird veröffentlicht. Version 1.4.0-alpha06 enthält diese Commits.
Fehlerkorrekturen
- Im Rahmen der größeren Bemühungen, das Verhalten von Rotary von Horologist zu AndroidX zu migrieren, haben wir einen internen Entwurf für die Rotary-Unterstützung hinzugefügt. (I617d1)
- Im Rahmen der größeren Bemühungen, das Verhalten von Rotary von Horologist zu AndroidX zu migrieren, haben wir einen internen Entwurf für die haptische Unterstützung hinzugefügt. (I5568a)
Version 1.4.0-alpha05
20. März 2024
androidx.wear.compose:compose-*:1.4.0-alpha05
wird veröffentlicht. Version 1.4.0-alpha05 enthält diese Commits.
API-Änderungen
- Wir haben die Properties
initialCenterItemIndex
undinitialCenterItemScrollOffset
vonScalingLazyListState
öffentlich gemacht. (I0c616) - Wir haben die
FullScreenStrokeWidth
vonProgressIndicatorDefaults
öffentlich gemacht. (Ibea23)
Fehlerkorrekturen
- Wir haben die Leistung von
PositionIndicator
verbessert, indem die Anzahl der Aufrufe vonlayoutInfo
vonScalingLazyColumn
reduziert wird. (Idc83d)
Version 1.4.0-alpha04
6. März 2024
androidx.wear.compose:compose-*:1.4.0-alpha04
wurde veröffentlicht. Version 1.4.0-alpha04 enthält diese Commits.
API-Änderungen
- Wir haben eine neue Überladung für
ToggleChip
undSplitToggleChip
hinzugefügt, die anstelle des ParameterstoggleControl
den ParameterselectionControl
verwendet. Dieser sollte mit dem SteuerelementRadioButton
verwendet werden, um auswählbare statt umschaltbare Semantik für die Barrierefreiheit bereitzustellen (I1d6d9). - Die Parameternamen für die neue
selectionControl
-Überladung wurden vononSelected
zuonSelect
fürToggleChip
undSplitToggleChip
geändert (I1a971)
Version 1.4.0-alpha03
21. Februar 2024
androidx.wear.compose:compose-*:1.4.0-alpha03
wird veröffentlicht. Version 1.4.0-alpha03 enthält diese Commits.
API-Änderungen
- Der
Modifier.inspectable
-Wrapper wurde eingestellt. Diese API führt zu mehr Ungültigstellungen des Modifiers als nötig. Daher wird ihre Verwendung nicht mehr empfohlen. Entwickler sollten dieinspectableProperties()
-Methode fürModifierNodeElement
implementieren, wenn sie Modifikatoreigenschaften für Tools freigeben möchten. (Ib3236)
Fehlerkorrekturen
- Wir haben einen Dokumentationsfehler für
WearPreview*
-Annotationen behoben. (Id526d)
Version 1.4.0-alpha02
7. Februar 2024
androidx.wear.compose:compose-*:1.4.0-alpha02
wurde veröffentlicht. Version 1.4.0-alpha02 enthält diese Commits.
Fehlerkorrekturen
- Wir haben einen Fehler bei der Funktion „Wischen, um zu enthüllen“ behoben, bei dem es möglich war, mit einer ausgeführten Aktion auf einem Element zu interagieren und sie abzubrechen, indem man mit dem Wischen auf ein anderes Element begann.(Ide059)
- Wir haben die
ListHeader
aktualisiert, damit die Höhe angepasst werden kann, wenn für Inhalte eine größere Höhe erforderlich ist, um große Schriftgrößen zu berücksichtigen. (I7290c, b/251166127)
Version 1.4.0-alpha01
24. Januar 2024
androidx.wear.compose:compose-*:1.4.0-alpha01
wird veröffentlicht. Version 1.4.0-alpha01 enthält diese Commits.
Neue Funktionen
- Wir haben
SwipeDismissableNavHost
eine Eintrittsanimation für In-App-Übergänge hinzugefügt.(cfeb79a) PositionIndicator
wird jetzt standardmäßig angezeigt, wenn ein Bildschirm zum ersten Mal angezeigt wird. Diese Änderung wurde eingeführt, um die Qualitätsrichtlinien für Wear-Apps einzuhalten. Das bedeutet leider, dass Screenshottests auf Bildschirmen mitPositionIndicator
aktualisiert werden müssen, daPositionIndicator
zuvor nicht angezeigt wurde. (419cef7)
API-Änderungen
- Wir haben in den
wear:compose-material
- undwear:compose-material3
-Bibliotheken eine neue Ripple API hinzugefügt, die die eingestellterememberRipple
ersetzt. Außerdem wird ein temporärerCompositionLocal
,LocalUseFallbackRippleImplementation
hinzugefügt, um Materialkomponenten wieder auf die veraltetenrememberRipple/RippleTheme
APIs umzustellen. Diese Funktion wird in der nächsten stabilen Version entfernt. Sie dient nur als vorübergehende Migrationshilfe für Fälle, in denen Sie eine benutzerdefinierteRippleTheme
bereitstellen. Informationen zur Migration und weitere Hintergrundinformationen zu dieser Änderung finden Sie unter developer.android.com. (af92b21) - Wir haben
ColorScheme
so aktualisiert, dass sie unveränderlich ist. Dadurch sind einzelne Farbänderungen weniger effizient, aber die gängige Verwendung von Farben ist effizienter. Der Grund für diese Änderung ist, dass in den meisten Apps das Aktualisieren einzelner Farben nicht der Hauptanwendungsfall ist. Das ist zwar weiterhin möglich, aber es wird mehr als zuvor neu zusammengesetzt. Dadurch reduzieren wir die Anzahl der Statusabos im gesamten Materialcode erheblich und wirken sich auf die Initialisierungs- und Laufzeitkosten bei Standardanwendungsfällen aus. (f5c48b7) - Wear OS-Material- und Wear OS-Material3-Komponenten, die eine
MutableInteractionSource
in ihrer API bereitstellen, wurden aktualisiert. Sie geben jetzt eine nullableMutableInteractionSource
zurück, die standardmäßig null ist. Hier gibt es keine semantischen Änderungen: Wenn Sie „null“ übergeben, möchten Sie dieMutableInteractionSource
nicht hochladen. Sie wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie den Wert auf null ändern, können einige Komponenten niemals einMutableInteractionSource
zuweisen, und andere Komponenten können eine Instanz nur bei Bedarf langsam erstellen. Dadurch wird die Leistung dieser Komponenten verbessert. Wenn du denMutableInteractionSource
, den du an diese Komponenten weitergibst, nicht verwendest, solltest du stattdessen „null“ übergeben. Wir empfehlen Ihnen außerdem, ähnliche Änderungen an Ihren eigenen Komponenten vorzunehmen. (f8fa920) - Wir haben
rememberExpandableState
aktualisiert, um den maximierten Zustand zu speichern. So werden Daten gespeichert, wenn Sie zu einem anderen Bildschirm wechseln, und wiederhergestellt, wenn Sie zum ursprünglichen Bildschirm zurückkehren. (5c80095)
Fehlerkorrekturen
- Wir haben die
ReduceMotion
-Einstellung aktualisiert, um einen Lebenszyklus-bewussten Listener zu verwenden. (7c6b122) - Wir haben den Listener von
TouchExplorationStateProvider
so aktualisiert, dass er laufzeitabhängig ist (be28b01). - Wir haben die Materialcore-Ebene für
CompactButton
entfernt, um die Leistung zu verbessern (25db8e9) BasicSwipeToDismissBox
ist jetzt robuster gegen NaN-Abweichungen, um Ausnahmen zu vermeiden (b983739)- Wir haben
BasicSwipeToDismissBox
aktualisiert, damit die Alphawerte im Bereich 0,1 liegen. - Wir haben einen Fehler in den Rollen
ToggleButton
,SplitToggleButton
,Checkbox
,Switch
undRadioButton
behoben, sodass Ansagen zur Barrierefreiheit nicht wiederholt werden. Zuvor wurden semantische Rollen dupliziert. (d11eeb7)
Version 1.3
Version 1.3.1
3. April 2024
androidx.wear.compose:compose-*:1.3.1
wird veröffentlicht. Version 1.3.1 enthält diese Commits.
Fehlerkorrekturen
- Wir haben einen Fehler in der Funktion zum Anzeigen durch Wischen behoben, bei der es möglich war, mit einer Aktion, für die ein Commit durchgeführt wurde, zu interagieren und diese abzubrechen, indem mit dem Wischen über ein anderes Element begonnen wurde. (Ide059)
Version 1.3.0
24. Januar 2024
androidx.wear.compose:compose-*:1.3.0
wird veröffentlicht. Version 1.3.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.2.0
- Die Klasse
SwipeToDismissBoxState
, die AufzählungSwipeToDismissValue
und die ErweiterungsfunktionModifier.edgeSwipeToDismiss
sind jetzt Teil desandroidx.wear.compose.foundation
-Pakets und nicht mehr desandroidx.wear.compose.material
-Pakets. Mit dieser aktualisierten Architektur können Sie die Gestenbedienung unabhängig von anderen Designüberlegungen implementieren. Material Design-Workflows wie das Anwenden von Farben aus einem konfigurierten Design werden separat verarbeitet. - Mit den Klassen
SwipeToRevealCard
undSwipeToRevealChip
können Sierecommended swipe-to-reveal guidance
implementieren. Die KlasseSwipeToRevealSample
zeigt, wie diese Komponenten verwendet werden. Mit der Version 1.3.0-alpha02 wurde eine Änderung eingeführt, durch die die Objekte
Chip
undToggleChip
in der Höhe wachsen, um die vom Nutzer ausgewählte Schriftskalierung besser zu unterstützen. Dies kann dazu führen, dass einige Clips abgeschnitten werden. Um dieses Problem zu beheben, verwendet die Formlarge
fürMaterialTheme
jetzt einen größeren Eckenradius (26 dp statt 24 dp). BeiChip
- undToggleChip
-Objekten wird dieser neue Eckenradius verwendet, um das Zuschneiden von Inhalten an den Ecken von Chip undToggleChip
zu vermeiden.- Die meisten
Chips
undToggleChips
bleiben unverändert, da sie standardmäßig eine Höhe von 52 dp haben.Chip
- undToggleChip
-Objekte, die mehrere Zeilen primären oder sekundären Labeltexts enthalten oder deren Höhe überschrieben wurde, können jedoch dazu führen, dass Screenshottests fehlschlagen.
- Die meisten
Weitere Änderungen
Eine vollständige Liste der Änderungen in Version 1.3.0 finden Sie in den Versionshinweisen zur Betaversion 01.
Empfehlungen für die Implementierung
- Wenn Nutzer in Ihrer App den Inhalt des Bildschirms schwenken können, z. B. in einer kartenbasierten App, deaktivieren Sie die Wischfunktion, indem Sie im
SwipeDismissableNavHost
-KomposituserSwipeEnabled
auffalse
festlegen. Fügen Sie außerdem eine Schaltfläche hinzu, mit der Nutzer zum vorherigen Bildschirm wechseln können. - Wenn Sie Animationen für eine Positionsanzeige während der Einblend- und Positionsänderungsanimationen in einer scrollbaren Liste deaktivieren möchten, verwenden Sie ein
SnapSpec
-Objekt. - Während eine Medien-App Inhalte für die Wiedergabe lädt, wird ein leeres
Placeholder
-Komposit angezeigt. - Wenn Sie eine Sammlung von aufklappbaren Elementen auf Abruf erstellen möchten, können Sie die experimentelle Klasse
ExpandableStateMapping
verwenden.
Version 1.3.0-rc01
10. Januar 2024
androidx.wear.compose:compose-*:1.3.0-rc01
wird veröffentlicht. Version 1.3.0-rc01 enthält diese Commits.
Fehlerkorrekturen
-
Wir haben die große
MaterialTheme
-Form aktualisiert, sodass sie jetzt einen Radius von 26 dp hat. Dieser wird jetzt für Chip undToggleChip
verwendet. Diese Änderung ist erforderlich, um Höhenanpassungen zu unterstützen, wenn Inhalte eine zusätzliche Höhe benötigen, um große Schriftgrößen zu berücksichtigen. Andernfalls wird durch die vorhandene Stadionform ein Teil des Textinhalts abgeschnitten.Diese Änderung kann zu Fehlern bei Screenshot-Tests führen. (I2e6ae)
Version 1.3.0-beta02
13. Dezember 2023
androidx.wear.compose:compose-*:1.3.0-beta02
wird veröffentlicht. Version 1.3.0-beta02 enthält diese Commits.
Fehlerkorrekturen
- Wir haben die ursprüngliche Wischbewegung in
BasicSwipeToDismissBox
wiederhergestellt. Dies wurde in einer früheren Version so geändert, dass der gleitende Teil des Übergangs erfolgte, während der Finger den Bildschirm berührte. (Id8e76)
Version 1.3.0-beta01
15. November 2023
androidx.wear.compose:compose-*:1.3.0-beta01
wird veröffentlicht. Version 1.3.0-beta01 enthält diese Commits.
Die Version 1.3-beta01 von Compose für Wear OS gibt an, dass diese Version der Bibliothek funktionsfähig ist und die API gesperrt ist (außer bei Funktionen, die als experimentell gekennzeichnet sind). Wear Compose 1.3 bietet die folgenden neuen Funktionen:
SwipeToDismissBoxState
,SwipeToDismissValue
undModifier.edgeSwipeToDismiss
wurden zusammen mit der zugrunde liegenden Implementierung von „Wischen zum Schließen“ inBasicSwipeToDismissBox
vonandroidx.wear.compose.material
zuandroidx.wear.compose.foundation
migriert. So kann die Touch-Geste zum Schließen unabhängig von Material Design verwendet werden, z. B. über dieSwipeDismissableNavHost
inandroidx.wear.compose.navigation
.SwipeToDismissBox
vonandroidx.wear.compose.material
wird weiterhin für die Verwendung mit Material Design empfohlen, da es Farben ausMaterialTheme
abruft und dann die verbleibende Implementierung anBasicSwipeToDismissBox
delegiert.SwipeDismissableNavHost
unterstützt jetzt einen neuenuserSwipeEnabled
-Parameter, mit dem die Wischbedienung für Bildschirme deaktiviert werden kann, auf denen sie nicht erforderlich ist.BasicSwipeToDismissBox
hat die Fokussierung mithilfe vonHierarchicalFocusCoordinator
verbessert.SwipeToReveal
hat neueSwipeToRevealCard
- undSwipeToRevealChip
-Kompositen in Material, die den empfohlenen UX-Richtlinien fürCard
undChip
entsprechen. Außerdem wird die Undo-Funktion für die sekundäre Aktion unterstützt.DefaultTextStyle
deaktiviert jetzt den Abstand zwischen Schriftarten, damit er auf der gesamten Android-Plattform einheitlich ist.- Die Höhe von
Chip
undToggleChip
wird jetzt an Inhalte angepasst, die aufgrund von großen Schriftarten für die Barrierefreiheit größer geworden sind. PositionIndicator
hat jetzt individuelle Animationsspezifikationen für die Einblend-, Ausblend- und Positionsänderungsanimationen. Aus Leistungsgründen empfehlen wir, das Einblenden und die Positionsänderung zu deaktivieren, wenn sie mit scrollbaren Listen verwendet werden.ExpandableStateMapping
bietet eine neue Möglichkeit,ExpandableStates
zu generieren, wenn sie bei Bedarf und nicht unbedingt mit einem@Composable
-Bereich erstellt werden müssen.Placeholder
ermöglicht jetzt das Zurücksetzen, wenn der Inhalt nicht mehr bereit ist. Außerdem gilt die Einstellung „Bewegung reduzieren“ jetzt auch für den Schimmereffekt und das Wisch-Weg-Effekt beiPlaceholder
.
Bekannte Probleme
PositionIndicator
wird nicht angezeigt, wenn ein Bildschirm zum ersten Mal angezeigt wird. Wir beabsichtigen, eine Änderung in einer frühen Alphaversion der Version 1.4 vorzunehmen, damit sie anfangs, jedoch ohne Animation angezeigt wird.
API-Änderungen
- Die Stufe „Grundlagen“
SwipeToDismissBox
wurde inBasicSwipeToDismissBox
umbenannt. Dadurch wird der Unterschied zwischen der Komponente „Basisebene“ und der „Materialebene“SwipeToDismissBox
deutlicher. Letztere ruft Farben aus derMaterialTheme
ab, die in den Scrims verwendet werden sollen, und delegiert die restliche Implementierung an dieBasicSwipeToDismissBox
. (Ibecfc) - Wir haben
rememberExpandableStateMapping
als experimentell gekennzeichnet und die Leistung vonexpandableItem
verbessert. (I5f6bc) - Wir haben die Klasse
SwipeToRevealAction
in den MaterialSwipeToReveal
Card und Chip APIs durch eine Slot-basierte API mit zusammensetzbaren FunktionenSwipeToRevealPrimaryAction
,SwipeToRevealSecondaryAction
undSwipeToRevealUndoAction
ersetzt. Im Beispielcode finden Sie Beispiele für die Verwendung der neuen API. (Ia8943) - Die Animations-Flags
PositionIndicator
wurden durchAnimationSpec
-Parameter ersetzt. Die einzelnen Animationen können deaktiviert werden, indemsnap
alsAnimationSpec
übergeben wird. (I6c523)
Fehlerkorrekturen
- Ein Fehler wurde behoben, der durch begrenzten gekrümmten Text bei begrenzter Größe ausgelöst wurde (I50efe)
- Wir haben einen potenziellen NaN-Absturz im Zusammenhang mit
curvedComposable
(I970eb) behoben. - Wir haben die Entfernung der Hervorhebungsanimation zur Positionsänderung am
PositionIndicator
rückgängig gemacht. (Ieb424) - Wir haben die „Material-Kernschicht“ für „Material Chip“ entfernt, um seine Leistung zu verbessern. (If2dcb)
Version 1.3.0-alpha08
18. Oktober 2023
androidx.wear.compose:compose-*:1.3.0-alpha08
wurde veröffentlicht. Version 1.3.0-alpha08 enthält diese Commits.
API-Änderungen
- Wir haben den
PositionIndicator
-Überladungen einzelne Flags hinzugefügt, um verschiedene Animationen zu steuern:showFadeInAnimation
,showFadeOutAnimation
undshowPositionAnimation
. Die vorherige API wird nicht mehr unterstützt und leitet Aufrufe an die neue API weiter. Aus Leistungsgründen und für eine einheitliche UX empfehlen wir, die FlagsshowFadeInAnimation
undshowPositionAnimation
zu deaktivieren, wenn diePositionIndicator
mit einer scrollbaren Liste verwendet wird. WennPositionIndicator
als eigenständige Anzeige verwendet wird, z. B. zur Lautstärkeänderung, empfehlen wir, alle drei Animationen zu aktivieren. (I44294) - Wir haben die Material-
SwipeToDismissBoxState
-,SwipeToDismissValue
- undedgeSwipeToDismiss
-Komponenten eingestellt, nachdem die Wisch-zum-Schließen-Funktion zuwear.compose.foundation
migriert wurde. Bitte ersetzen Sie sie durch diewear.compose.foundation
-Äquivalente. (Iee8c9)
Fehlerkorrekturen
- Wir haben die Baseline-Profile für die Wear Compose-Grundlage, die Material- und Navigationsbibliotheken aktualisiert. (Idb060)
- Wir haben eine Verhaltensänderung für
PositionIndicator
rückgängig gemacht, die in einer früheren CL eingeführt wurde. Dabei wurdePositionIndicator
animiert, wenn ein Bildschirm zum ersten Mal angezeigt wurde. Wir planen eine ähnliche Änderung in einer frühen Alphaversion von 1.4, sodass dasPositionIndicator
anfangs angezeigt wird, aber ohne Animation. (I41843) - Wir haben einige Leistungsprobleme in
PositionIndicator
behoben. (I1c654, b/302399827) - Wir haben die Leistung der Standardimplementierung des Anbieters für die Touchscreen-Erkundung so optimiert, dass auf dem
State<Boolean>
statt auf dem abgeleiteten Status beruhen. (Ieec4d) - Für Android 13 und höher haben wir Rechtecke mit
systemGestureExclusion
Pixeln festgelegt. (Ib1f4b)
Version 1.3.0-alpha07
4. Oktober 2023
androidx.wear.compose:compose-*:1.3.0-alpha07
wird veröffentlicht. Version 1.3.0-alpha07 enthält diese Commits.
API-Änderungen
- Wir haben
PositionIndicator
individuelle Flags hinzugefügt, um verschiedene Animationen zu steuern:showFadeInAnimation
,showFadeOutAnimation
undshowPositionAnimation
. Die vorherige API wird nicht mehr unterstützt und leitet Aufrufe an die neue API weiter. Aus Leistungsgründen und aus Gründen der UX-Konsistenz empfehlen wir, die FlagsshowFadeInAnimation
undshowPositionAnimation
zu deaktivieren, wennPositionIndicator
mit einer scrollbaren Liste verwendet wird. WennPositionIndicator
als eigenständiger Indikator verwendet wird, z. B. für die Lautstärkeänderung, empfehlen wir, alle drei Animationen zu aktivieren. (Ia2d63)
Fehlerkorrekturen
- Wir haben die Wischbewegung zur Anzeige von Inhalten verbessert. Dazu haben wir dem Text der primären Aktion eine Ausblendungsanimation hinzugefügt und die sekundäre Aktion ausgeblendet bzw. die Symbolgröße bei vollständiger Wischbewegung geändert. (Ib7223)
- Wir empfehlen, Aktionen vom Typ „Wischen, um zu enthüllen“ barrierefrei zu gestalten. Daher haben wir unseren Samples für „Wischen, um zu enthüllen“ benutzerdefinierte Bedienungshilfen hinzugefügt. (I42224)
- Wir haben die Leistung von
SwipeToDismissBox
verbessert, einschließlich einer Refaktorierung, damit die ursprüngliche Logik keine Neuzusammensetzung auslöst. DasSwipeToDismissBox
wird jetzt in voller Bildschirmgröße dargestellt. (Ie0aa2) - Wir haben einen Fehler behoben, durch den das Symbol
PositionIndicator
fälschlicherweise nicht angezeigt wurde. (I2091a) - Die Leistung von
PositionIndicator
wurde durch die Optimierung der Neuzusammensetzung verbessert. Es wurden neue Flags zur Steuerung der Animationen (fadeIn
,fadeOut
undpositionChange
) hinzugefügt (siehe API-Änderungen) (Ifac7d) - Wir haben Microbenchmark-Tests für
PositionIndicator
(Idf875) hinzugefügt.
Version 1.3.0-alpha06
20. September 2023
androidx.wear.compose:compose-*:1.3.0-alpha06
wird veröffentlicht. Version 1.3.0-alpha06 enthält diese Commits.
Fehlerkorrekturen
- Wir haben die Unterstützung für
Modifier.edgeSwipeToDismiss
mitSwipeToReveal
hinzugefügt. (I95774, b/293444286) - Wir haben Beispiele für die Materialien
SwipeToRevealChip
undSwipeToRevealCard
hinzugefügt. (Ieb974) - Wir haben die Baseline-Profile für Wear Compose Foundation und Material-Bibliotheken aktualisiert. (I1dd1f)
Version 1.3.0-alpha05
6. September 2023
androidx.wear.compose:compose-*:1.3.0-alpha05
wird veröffentlicht. Version 1.3.0-alpha05 enthält diese Commits.
Fehlerkorrekturen
- Wir haben unter „Zum Einblenden wischen“ eine Funktion hinzugefügt, mit der jeweils nur ein Element gewischt werden kann. (I3cd7a)
- Die Dokumentation von
ScalingLazyColumnDefaults
wurde verbessert, um dem tatsächlichen Verhalten besser zu entsprechen. (I886d3)
Version 1.3.0-alpha04
23. August 2023
androidx.wear.compose:compose-*:1.3.0-alpha04
wird veröffentlicht. Version 1.3.0-alpha04 enthält diese Commits.
Neue Funktionen
- Die sekundäre Aktion
SwipeToReveal
wird jetzt rückgängig gemacht. (I7a22d)
API-Änderungen
- Fügen Sie
HorizontalPageIndicator
in die Wear Material3-Bibliothek ein. (Ifee99) - Die Vorschautools für Wear Compose wurden aktualisiert, um die
androidx.wear.tooling.preview
-Bibliothek zu verwenden. (Ib036e)
Fehlerkorrekturen
- Ein Fehler bei runden Schaltflächen wurde behoben, bei denen Modifikatoren nicht richtig verkettet wurden. (I5e162)
Version 1.3.0-alpha03
9. August 2023
androidx.wear.compose:compose-*:1.3.0-alpha03
wird veröffentlicht. Version 1.3.0-alpha03 enthält diese Commits.
API-Änderungen
- Wir haben zwei neue Composeables in Material hinzugefügt, um
SwipeToReveal
mit Karten und Chips zu implementieren. Diese Composeables entsprechen den empfohlenen UX-Richtlinien für die Komponente und erleichtern Entwicklern die Implementierung vonSwipeToReveal
mit den vorhandenen Komponenten in Wear Material. (I7ec65) - Wir haben die
FloatRange
-Anmerkungen als API-Einschränkungen aktiviert, die zuvor in Kommentaren angegeben wurden. (Icb401)
Fehlerkorrekturen
- Wir haben die ursprüngliche Scrolllogik von
ScalingLazyColumn
inonGloballyPositioned()
verschoben. (Ic90f1) - Wir verwenden jetzt
drawWithCache
inPositionIndicator
,ProgressIndicator
undSelectionControls
, um die Strichzuweisungen zu optimieren. (I5f225, b/288234617) - Die Sichtbarkeit des Häkchens in deaktivierten Status wurde korrigiert. (Ib25bf)
- Wir haben
Placeholder
aktualisiert, damit der Platzhalter wieder angezeigt wird, wenn die Inhalte nicht mehr den Status „Bereit“ haben. (Ibd820) - Wir haben einige Fehler bei
Placeholder
-Tests behoben (Idb560).
Version 1.3.0-alpha02
26. Juli 2023
androidx.wear.compose:compose-*:1.3.0-alpha02
wird veröffentlicht. Version 1.3.0-alpha02 enthält diese Commits.
API-Änderungen
- Wir haben
ExpandableStateMapping
eingeführt, eine neue Möglichkeit,ExpandableStates
zu generieren, wenn sie auf Anfrage erstellt werden müssen, nicht unbedingt im@Composable
-Bereich (Iff9e0). SwipeToDismissBox
wurde aus dem Paketandroidx.wear.compose.material
in das Paketandroidx.wear.compose.foundation
migriert. (I275fb)- API-Dateien wurden aktualisiert, um die Unterdrückung der Kompatibilität zu kennzeichnen. (I8e87a, b/287516207)
- Wir haben die Höhenkonstanten für
Chip
,CompactChip
undToggleChip
veröffentlicht (Idbfde). - Die horizontalen und vertikalen Abstände für
Chip
undCompactChip
wurden auf „Öffentlich“ gesetzt. (Ieeaf7) - Es wurde eine Funktion hinzugefügt, mit der sich die Wischfunktion in
SwipeDismissableNavHost
über den neuen ParameteruserSwipeEnabled
deaktivieren lässt. (Id2a0b, b/230865655) - Wir haben die Wear Compose Navigation Library aktualisiert, damit die neue
SwipeToDismissBox
von Wear Compose Foundation verwendet wird. (I4ff8e)
Fehlerkorrekturen
- Wir haben einen Fehler in der Z-Reihenfolge behoben, bei dem
expandedItem
nicht den richtigen Inhalt anzeigte, nachdem auf eine Schaltfläche geklickt wurde, wenn sie Schaltflächen enthielt. (I1899d, b/289991514) - Verbesserte Fokusbehandlung von
SwipeToDismissBox
(und damitSwipeDismissableNavHost
) mithilfe vonHierarchicalFocusCoordinator
(I45362, b/277852486) - Wir haben die Gestensteuerung in
SwipeableV2
verbessert . (I89737) - Wir haben die Baseline-Profile für die Version 1.2 fertiggestellt. (Id5740)
- Nach der Migration von
SwipeToDismissBox
zu „Foundation“ wird dieSwipeToDismissBox
-Implementierung von Material zu „Foundation“ weitergeleitet und liefert Standardfarbwerte aus dem Design.(If8451) - Wir haben
ListHeader
eine Überschriftensemantik hinzugefügt. (Ic5420) Chip
undToggleChip
passen ihre Höhe jetzt an Inhalte an, die aufgrund von großen Schriftarten für Barrierefreiheit gewachsen sind, falls erforderlich. (Iaf302)- Ein Fehler in der semantischen Rolle des berührbaren Bereichs von
SplitToggleChip
wurde behoben. (Ieed3a) - Wenn Sie die Einstellung „Bewegung reduzieren“ aktivieren, werden der Schimmereffekt und die Wischbewegung bei Platzhaltern deaktiviert. (I91046)
- Bei
Stepper
undInlineSlider
können Sie jetzt wiederholt auf die Tasten gedrückt halten, um den Wert schnell zu erhöhen oder zu verringern.Stepper
InlineSlider
(I27359)
Version 1.3.0-alpha01
21. Juni 2023
androidx.wear.compose:compose-*:1.3.0-alpha01
wird veröffentlicht. Version 1.3.0-alpha01 enthält diese Commits.
Fehlerkorrekturen
- Wie in
1.2.0-alpha07
und1.2.0-alpha10
angekündigt, ändern wir jetzt dieDefaultTextStyle
, um das Schriftabstand-Anzeigeelement zu deaktivieren und für Einheitlichkeit auf der Android-Plattform zu sorgen. Dadurch werden einige Fälle von Textbeschnitt mit großen Schriftgrößen beseitigt und können sich auch auf Bildschirmlayouts auswirken, sodass die Screenshot-Tests aktualisiert werden müssen. Beispielsweise sehen wir hier Textbeschnitt (Ic6a86).
- Wenn das Schriftfeld-Padding deaktiviert ist, ist es nicht mehr vorhanden:
- Wir haben
wear.compose.foundation
zu einer API-Abhängigkeit vonwear.compose.material
gemacht (I72004, b/285404743) - Wir haben einen Fehler in
SwipeToDismissBox
behoben. Hintergrund- und Inhaltsschlüssel werden jetzt an den Block „remember“ übergeben, damit bei Änderungen am Inhalt oder Hintergrund neue Modifikatoren erstellt werden. (Ib876c, b/280392104) - Wir haben
TimeText
aktualisiert, sodass das Gebietsschema bei der Auswahl des Formats für das 12- oder 24-Stunden-Format verwendet wird. (If4a3d) - Wir haben eine Inkonsistenz in den Standardparametern von
SwipeToDismissBox
contentScrimColor
behoben. (I2d70f) - Die Bewegungserkennung in
SwipeToReveal
wurde verbessert. (I28fb7)
Bekannte Probleme
- Die Unterstützung von vom Nutzer konfigurierten Schriftgrößen ist eine Anforderung für die Barrierefreiheit. Wir wissen, dass mehrzeilige Chips bei der Anzeige mit großen Schriftgrößen zu Textausschneiden führen können. Deshalb aktualisieren wir Chip in einer frühen 1.3-Alphaversion, um in diesen Fällen die Höhe anzupassen.
Version 1.2
Version 1.2.1
18. Oktober 2023
androidx.wear.compose:compose-*:1.2.1
wird veröffentlicht. Version 1.2.1 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Fehler behoben, bei dem
PositionIndicator
fälschlicherweise verschwunden war. (7a167f)
Version 1.2.0
9. August 2023
androidx.wear.compose:compose-*:1.2.0
wird veröffentlicht. Version 1.2.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.1.0
- Stabile Version von Compose für Wear OS 1.2.0 (weitere Informationen)
- Eine Liste der wichtigsten Änderungen in Wear Compose 1.2 finden Sie in den Versionshinweisen für Compose für Wear OS 1.2 Beta01.
Version 1.2.0-rc01
26. Juli 2023
androidx.wear.compose:compose-*:1.2.0-rc01
wird veröffentlicht. Version 1.2.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Wir haben die Baseline-Profile für unsere Version 1.2 (Id5740) fertiggestellt.
Version 1.2.0-beta02
7. Juni 2023
androidx.wear.compose:compose-*:1.2.0-beta02
wird veröffentlicht. Version 1.2.0-beta02 enthält diese Commits.
Neue Funktionen
- Wir haben die neue experimentelle Variable
LocalReduceMotion
CompositionLocal
hinzugefügt, mit der Skalierung und Ausblenden beiScalingLazyColumn
deaktiviert werden. (I58024)
Fehlerkorrekturen
- Wir haben die Baseline-Profile für die Wear Compose-Grundlage und die Materialbibliotheken aktualisiert(I4725d).
- Wir haben eine Inkonsistenz in den Standardwerten für
SwipeToDismissBox
-contentScrimColor
-Parameter behoben (I2d70f). - Der Standardwert für
DefaultTextStyle
, der für die EinstellungIncludeFontPadding
verwendet wird, wurde korrigiert (I737ed)
Version 1.2.0-beta01
24. Mai 2023
androidx.wear.compose:compose-*:1.2.0-beta01
wird veröffentlicht. Version 1.2.0-beta01 enthält diese Commits.
Neue Funktionen in Compose für Wear OS 1.2
Die Version 1.2-beta01 von Compose für Wear OS gibt an, dass diese Version der Bibliothek funktionsfähig ist und die API gesperrt ist (außer bei Funktionen, die als experimentell gekennzeichnet sind). Wear Compose 1.2 enthält die folgenden neuen Funktionen:
expandableItem
undexpandableItems
sind zwei neueFoundation
-Komponenten, mit denen sich Elemente in einemScalingLazyColumn
maximieren lassen. Verwenden SieexpandableItem
für ein einzelnes ausblendbares Element, z. B. Text, bei dem die Anzahl der Zeilen variiert. Verwenden SieexpandableItems
für eine Gruppe von ausblendbaren Elementen undexpandableButton
, um das Erstellen einer Schaltfläche zu vereinfachen, die nach dem Maximieren der Inhalte minimiert wird.HierarchicalFocusCoordinator
– mit diesem experimentellen Composeable können Unterbäume der Komposition als „Mit Fokus“ oder „Ohne Fokus“ markiert werden.Picker
: Die API enthält jetztuserScrollEnabled
, um festzulegen, ob die Auswahl beim Scrollen des Nutzers aktiv ist.PickerGroup
: Eine neue Komponente zum gleichzeitigen Verwalten mehrerer Auswahltools. Er kümmert sich mithilfe derHierarchicalFocusCoordinator
API um den Fokus zwischen den Auswahltools und ermöglicht die automatische Zentrierung der Auswahlelemente.Placeholder
: Wir haben Änderungen an den Schimmern und den Animationen vom Typ „Wipe Off“ vorgenommen. Der Löscheffekt wird jetzt sofort angewendet, wenn der Inhalt fertig ist.ScalingLazyColumn
: Wir habenScalingLazyColumn
und die zugehörigen Kurse vonandroidx.wear.compose.material.ScalingLazyColumn
nachandroidx.wear.compose.foundation.lazy.ScalingLazyColumn
migriert. Bitte führen Sie ein Update durch, um dieFoundation.Lazy
-Version zu verwenden.SwipeToReveal
: Wir haben die experimentelle Unterstützung für „Wischen, um zu enthüllen“ als Mittel zum Aufrufen sekundärer Aktionen hinzugefügt, um das vorhandene Muster „Lang drücken“ zu ergänzen.Stepper
– jetzt mit einer Überladung mit einem zusätzlichenenableRangeSemantics
-Parameter, um die Standardbereichssemantik zu deaktivieren.Previews
: Wir haben die folgenden benutzerdefinierten Anmerkungen für die Vorschau von Composeables auf Wear-Displays hinzugefügt:WearPreviewSmallRound
– Vorschau des Composeables auf einem kleinen, runden Gerät;WearPreviewLargeRound
– Vorschau des Composeables auf einem großen, runden Gerät;WearPreviewSquare
– Vorschau des Composeables auf einem quadratischen Gerät. Außerdem die folgenden Anmerkungen für die Mehrfachvorschau:WearPreviewFontScales
zeigt die Vorschau der Composeables auf einem Wear-Gerät mit mehreren Schriftgrößen an, währendWearPreviewDevices
die Vorschau der Composeables auf verschiedenen Wear-Geräten anzeigt.- Wir haben Wear Compose einen
DefaultTextStyle
hinzugefügt, der die PropertyPlatformTextStyle.includeFontPadding
standardmäßig auf „wahr“ setzt (dies ist die aktuelle Einstellung). So können wir das standardmäßige Deaktivieren des Schriftabstands mit den Compose-Bibliotheken in einer frühen Alphaversion von 1.3 synchronisieren. Weitere Informationen finden Sie unter 1.2.0-alpha10.
Neue Funktionen
- Wir haben experimentellen Support für deaktivierte Skalierungs- und Ausblendungsanimationen hinzugefügt, wenn die Einstellung „reduce_motion“ aktiviert ist. (I58024)
Fehlerkorrekturen
- Verbesserte Dokumentation für
angularWidthDp
inCurvedSize.kt
(Iab75c) SwipeDismissableNavHost
protokolliert jetzt eine Warnung mit möglichen Ursachen für einen leeren Backstack. So werden unerwartete Abstürze durchIllegalArgumentException
verhindert, die auftreten, wenn der Backstack leer ist. (I04a81, b/277700155)
Version 1.2.0-alpha10
10. Mai 2023
androidx.wear.compose:compose-*:1.2.0-alpha10
wird veröffentlicht. Version 1.2.0-alpha10 enthält diese Commits.
Neue Funktionen
- Wir haben die Unterstützung für „Wischen, um zu enthüllen“ hinzugefügt, um auf sekundäre Aktionen zuzugreifen. Dieses Muster ergänzt das Muster „Langes Drücken“, mit dem Nutzer bereits (andere) sekundäre Aktionen aufrufen konnten. (I60862)
API-Änderungen
- Wir haben
RevealScope
zu den zusammensetzbaren Funktionen für Aktionen inSwipeToReveal
hinzugefügt, die Zugriff auf den Offset bieten, mit dem zusätzliche Aktionen angezeigt werden. (I3fd56)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem
ScalingLazyColumn
nach dem Fling bei der Wear API 33 hängen blieb (Ic4599) - Wir haben einige Leistungsverbesserungen an
PositionIndicator
vorgenommen, um Ruckler zu reduzieren. (I35e92) - Wir haben einen Fehler in Chip und
CompactChip
behoben, bei dem die semantische Rolle nicht mehr aufRole.Button
gesetzt wurde. (I93f91, b/277326264)
Bekannte Probleme
Wir haben einen Fehler in Android Studio gefunden, der beim Rendern der Vorschau bei Anmerkungen mit @WearPreviewDevices und @WearPreviewFontScales zu einem Fehler führt. Eine Lösung wird bald veröffentlicht. Die anderen Anmerkungen zur Wear-Vorabversion funktionieren in Android Studio Giraffe 2022.3.1 und höher wie vorgesehen.
In Version 1.2.0-alpha07 wurde der StandardtextStyle zu Wear Compose hinzugefügt und der vorhandene Wert von PlatformTextStyle.includeFontPadding auf "true" beibehalten. Informationen für den Hintergrund finden Sie unter Schriftabstand korrigieren in Compose. In einer frühen Alphaversion von 1.3 werden wir den StandardTextStyle ändern, um das Schriftfeld in Android einheitlich zu deaktivieren. Dadurch wird bei großen Schriftgrößen in einigen Fällen verhindert, dass Text abgeschnitten wird. Außerdem kann sich dies auf Bildschirmlayouts auswirken, sodass Screenshottests aktualisiert werden müssen. Bei großen Schriftgrößen sehen wir hier zum Beispiel Textbeschnitt:
- Sie ist nicht mehr vorhanden, wenn der Schriftabstand deaktiviert ist:
Sie können die neue Einstellung jetzt übernehmen, indem Sie die Typografie in Ihrem Design überschreiben. Weitere Informationen finden Sie im Beispielcode.
Version 1.2.0-alpha09
19. April 2023
androidx.wear.compose:compose-*:1.2.0-alpha09
wird veröffentlicht. Version 1.2.0-alpha09 enthält diese Commits.
API-Änderungen
angularSizeDp
zurCurvedModifier
API hinzufügen, um den Winkel in DP festzulegen (I89a52)
Fehlerkorrekturen
- Wir haben Probleme mit der Barrierefreiheit in unseren Zeitauswahl-Demos(Id0eb7) behoben.
Version 1.2.0-alpha08
5. April 2023
androidx.wear.compose:compose-*:1.2.0-alpha08
wurde veröffentlicht. Version 1.2.0-alpha08 enthält diese Commits.
API-Änderungen
- Wir haben
ExpandableItemsState
inExpandableState
umbenannt. (If85ea) - Wir haben
expandableButton
hinzugefügt, um das Erstellen einer Schaltfläche zu vereinfachen, die minimiert wird, wenn der Inhalt maximiert wird. Außerdem wurden die Beispiele für erweiterbare Anzeigen aktualisiert. (Iae309)
Fehlerkorrekturen
- Verbesserte auswählbare Beispiele, um mehr Möglichkeiten zu zeigen. Die Animation von
expandableItem
wurde so geändert, dass die Inhalte während der Animation immer zentriert sind. (I2f637) ToggleControls
wurde aktualisiert, um zusätzliche Neuzusammensetzungen zu vermeiden, wenn die Farben manuell mithilfe von „State“ animiert werden. (I5d319)
Version 1.2.0-alpha07
22. März 2023
androidx.wear.compose:compose-*:1.2.0-alpha07
wird veröffentlicht. Version 1.2.0-alpha07 enthält diese Commits.
API-Änderungen
- Wir haben die Komponenten „Expandable Item“ (in 1.2.0-alpha06 hinzugefügt) aus dem Bereich „Material“ in den Bereich „Foundation“ verschoben, da sie keinen sinnvollen Bezug zur
MaterialTheme
hatten. (Ib0525)
Fehlerkorrekturen
- Wir haben einen Absturz auf einem Bildschirm mit
PickerGroup
behoben.PickerGroup
wird jetzt richtig verarbeitet, wenn keine Auswahl den Fokus hat. Außerdem wurde die Unterstützung für das Scrollen mit der rechten Maustaste in unseren Picker-Demos hinzugefügt. (If8c19) - Wir haben die Dialogfeldübergänge verbessert: Der Intro-Übergang ist jetzt flüssiger und passt zum Outro-Übergang. (Ib5af9)
- Wir haben eine
DefaultTextStyle
zu Wear Compose hinzugefügt, mit der diePlatformTextStyle.includeFontPadding
-Eigenschaft standardmäßig auf „true“ gesetzt ist (dies ist die aktuelle Einstellung). So können wir das Deaktivieren des Schriftabstands standardmäßig mit den Compose-Bibliotheken synchronisieren. Weitere Informationen finden Sie unter Schriftabstand in Compose korrigieren. (I2aee8) - Wir haben eine
UpsideDownCake
-Vorschauabhängigkeit über „activity-compose“ rückgängig gemacht, die die Veröffentlichung von Apps im Google Play Store verhindert hat. (I6443d)
Version 1.2.0-alpha06
8. März 2023
androidx.wear.compose:compose-*:1.2.0-alpha06
wird veröffentlicht. Version 1.2.0-alpha06 enthält diese Commits.
API-Änderungen
- Fügen Sie die Komponente
CurvedBox
hinzu, die Komponenten in einer gekrümmten Welt übereinander platziert. (I29200) - Maximierbare Elemente hinzugefügt: Zwei neue Komponenten, mit denen entweder eine Gruppe von maximierbaren Elementen in einer
ScalingLazyColumn
oder ein einzelnes maximierbares Element unterstützt werden kann, z. B. Text, bei dem sich die Anzahl der Zeilen maximiert. (I95dd5) - Wir haben die folgenden benutzerdefinierten Anmerkungen für die Vorschau von Composeables auf Wear-Displays hinzugefügt:
WearPreviewSmallRound
zeigt die Vorschau des Composeables auf einem kleinen, runden Gerät an;WearPreviewLargeRound
zeigt die Vorschau des Composeables auf einem großen, runden Gerät an;WearPreviewSquare
zeigt die Vorschau des Composeables auf einem quadratischen Gerät an. Außerdem die folgenden Anmerkungen für die Mehrfachvorschau:WearPreviewFontScales
zeigt die Vorschau der Composeables auf einem Wear-Gerät mit mehreren Schriftgrößen an, währendWearPreviewDevices
die Vorschau der Composeables auf verschiedenen Wear-Geräten anzeigt. Um diese Vorabversionen verwenden zu können, benötigen Sie die neueste Version von Android Studio (Giraffe Canary 6) oder höher. Wenn diese Anmerkungen nicht Ihren Anforderungen entsprechen, können Sie die Vorschau weiterhin verwenden. Sie unterstützt auch weitere Anpassungen über Parameter. (I397ff) - Wir haben
HierarchicalFocusCoordinator
als experimentell gekennzeichnet, da es aufgrund seiner breiten Anwendbarkeit als Kandidat für die Aufnahme in die Hauptbibliotheken von Compose infrage kommt. (I3a768)
Fehlerkorrekturen
- Ein Fehler bei
HierarchicalFocusCoordinator
wurde behoben. Wenn der für den ParameterfocusEnabled
übergebene Lambda-Wert geändert wird, wird jetzt der neue Wert verwendet. (Icb353) - Wir haben die standardmäßig deaktivierte Inhaltsfarbe zu „Hintergrund“ geändert, wenn in
Button
,CompactButton
,Chip
,CompactChip
undToggleButton
Primärfarben als Hintergrund verwendet werden. Dadurch wird der Kontrast für die Barrierefreiheit verbessert. (I527cc)
Version 1.2.0-alpha05
22. Februar 2023
androidx.wear.compose:compose-*:1.2.0-alpha05
wird veröffentlicht. Version 1.2.0-alpha05 enthält diese Commits.
API-Änderungen
- Die
PickerGroup
API wurde aktualisiert, damit die Mindesteinschränkungen optional an die zusammensetzbare Funktion weitergegeben werden können. Wenn diese Option auf „wahr“ gesetzt ist, sind die vom übergeordneten zusammensetzbaren Element übergebenen Mindesteinschränkungen für diePickerGroup
zulässig. Wenn diese Option auf „false“ gesetzt ist, werden die Mindesteinschränkungen vonPickerGroup
zurückgesetzt. (I3e046) - Wir haben der Picker API
animateScrollToOption
hinzugefügt, um die programmatische Animation einer bestimmten Picker-Option zu unterstützen (I6fe67).
Fehlerkorrekturen
- Wir haben
HorizontalPageIndicator
aktualisiert, damit es jetzt auch linksläufige Layouts unterstützt. (Ia4359) - In
HorizontalPageIndicator
(I6fbb8) wurden Screenshot-Tests für das Layout von rechts nach links hinzugefügt. SwipeDismissableNavHostTest
wurden weitere Tests hinzugefügt, dieTestNavHostController
verwenden (I61d54)
Version 1.2.0-alpha04
8. Februar 2023
androidx.wear.compose:compose-*:1.2.0-alpha04
wird veröffentlicht. Version 1.2.0-alpha04 enthält diese Commits.
Neue Funktionen
PickerGroup
für die gemeinsame Verarbeitung mehrerer Auswahltools mit der Focus API. Sie verwaltet den Fokus zwischen den verschiedenen Auswahlen, ermöglicht die automatische Zentrierung der Auswahlen basierend auf Parametern und ermöglicht es Entwicklern, den Fokus zwischen verschiedenen Auswahlen zu ändern, während sie die Ereignisse aus der Gruppe verarbeiten. Im TalkBack-Modus steuert diePickerGroup
den TalkBack-Fokus, indem der Fokus auf die ausgewählte Auswahl aus der Gruppe verschoben wird. (I60840)
API-Änderungen
- Wir haben dem Stepper eine Überladung mit einem zusätzlichen Parameter
enableRangeSemantics
hinzugefügt, um das Deaktivieren der Standardbereichssemantik zu erleichtern (Ia61d4)
Fehlerkorrekturen
ScalingLazyColumn
darf in eine horizontal scrollbare Seite verschachtelt sein (Iec3f8, b/266555016)- Verbesserung der KDocs für den Stepper und Bereinigung von
StepperTest
-Tests. (IC118e) - Die Abhängigkeit von
androidx.navigation
wurde auf Version 2.5.3 (If58ed) aktualisiert.
Version 1.2.0-alpha03
25. Januar 2023
androidx.wear.compose:compose-*:1.2.0-alpha03
wurde veröffentlicht. Version 1.2.0-alpha03 enthält diese Commits.
API-Änderungen
- Wir haben
ScalingLazyColumn
und die zugehörigen Klassen vonandroidx.wear.compose.material.ScalingLazyColumn
zuandrdoidx.wear.compose.foundation.lazy.ScalingLazyColumn
migriert (siehe dieses Beispiel). Dieser neue Standort entspricht eher dem voncompose.foundation.lazy.LazyColumn
und ist natürlicher, da er keine gesonderte Material-Komponente ist. Die Änderung erfolgt jetzt in Vorbereitung auf eine neue Material3-Bibliothek, an der wir parallel zur vorhandenen Material-Bibliothek arbeiten werden. (I060e7)
Die folgenden Änderungen sind Teil der ScalingLazyColumn
-Migration von Material zu Foundation.Lazy
:
PositionIndicator
APIs, die auf MaterialScalingLazyColumn
ausgerichtet sind, wurden eingestellt. Bitte aktualisieren Sie aufFoundation.Lazy ScalingLazyColumn
. Außerdem wurdeScalingLazyListLayoutInfo
das FeldanchorType
hinzugefügt. (I29d95)ScalingLazyColumn
wurde im Wear Compose Material-Paket (I16d34) als veraltet gekennzeichnet.- Wir haben den Modifikator
ScrollAway
aktualisiert, damit erScalingLazyListState
aus Wear ComposeFoundation.Lazy
verwendet. Die Überladung, bei derScalingLazyListState
aus Wear Compose Material verwendet wurde, wurde eingestellt. (Ifc42c) - Wir haben die Dialog APIs aktualisiert, um
ScalingLazyListState
vonFoundation.Lazy
zu verwenden, und die Überlastungen eingestellt, die MaterialScalingLazyListState
verwendet haben (Ic8960). - Wir haben die Picker APIs aktualisiert, um
ScalingParams
anstelle vonFoundation.Lazy
zu verwenden, und die Überladungen eingestellt, die MaterialScalingParams
verwendeten. (Idc3d8)
Fehlerkorrekturen
- Wir haben einen Fehler behoben, der zu unnötigen Neuzusammensetzungen in
ScalingLazyListState.centerItemIndex
führte. Dabei wurde sichergestellt, dass Updates nur dann gesendet werden, wenn sich der Wert tatsächlich ändert (Ia9f38). - Wir haben die Leistung von
SwipeToDismissBox
(I3933b) verbessert - Benchmark-Tests für
ScalingLazyColumn
in Wear Compose Foundation (Ie00f9) hinzugefügt - Wir haben einige interne Methoden von
ScalingLazyColumn
-Klassen in Material aktualisiert, um die entsprechenden Methoden ausFoundation.Lazy
(I38aab) zu verwenden. - Wir haben einige Probleme in den Auswahltests behoben und weitere Tests zum Prüfen des Scrollens mit Offset hinzugefügt (I6ac34).
- Wir haben die
ScalingLazyColumn
-Integrationsdemos migriert, sodass sie vonFoundation.Lazy
anstelle von MaterialScalingLazyColumn
abhängig sind (Ic6caa). - Wir haben der
DatePicker
-Demo (I961cd) optionalefromDate/toDate
-Parameter hinzugefügt.
Version 1.2.0-alpha02
11. Januar 2023
androidx.wear.compose:compose-*:1.2.0-alpha02
wurde veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.
API-Änderungen
- Bei Android Compose UI-Tests werden jetzt Layoutdurchläufe für jeden Frame ausgeführt, wenn Frames ausgeführt werden, um in den Inaktivitätsstatus zu gelangen (z.B. über
waitForIdle
). Dies kann sich auf Tests auswirken, die für einzelne Frames von Layoutanimationen gelten. (I8ea08, b/222093277) - Der Parameter
minLines
wird Wear Text hinzugefügt, um ein einheitliches Verhalten mitBasicText
zu ermöglichen (I24874) CompactChipTapTargetPadding
wurde veröffentlicht und ist in der Dokumentation zu sehen (If1e70, b/234119038).
Fehlerkorrekturen
- Deaktivierung von Multiplattform-Builds für
wear.compose
-Pakete (Iad3d7) - Kdocs für
scrollToOption
(I6f9a0) korrigieren PlaceholderState.rememberPlaceholderState()
wurde aktualisiert, umrememberUpdatedState
zu verwenden, damit der Status aktualisiert wird, wenn dieonContentReady
-Lambda-Funktion ausgeführt wird. (I02635, b/260343754)- Wir haben ein Problem mit dem Ruckeln von Text in der
Picker
-Komponente behoben. Dazu haben wir die neue Kompositionierungsstrategie verwendet, dieModifier.graphicsLayer
hinzugefügt wurde. (I99302) - Wir haben einen Fehler behoben, der zu Flimmern in unserer
DatePicker
-Demo (I660bd) geführt hat. - Die Barrierefreiheit der Demos für die 12-Stunden-Zeit- und Datumsauswahl wurde verbessert (I05e12).
- Wir haben unsere Demos für die Uhrzeit- und Datumsauswahl aktualisiert, sodass die Auswahl nicht von RSB-Änderungen betroffen ist, wenn sie nicht ausgewählt sind (I4aecb).
Version 1.2.0-alpha01
7. Dezember 2022
androidx.wear.compose:compose-*:1.2.0-alpha01
wird veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.
Neue Funktionen
- Wir haben die experimentelle Funktion für Platzhalter aktualisiert, sodass der Effekt „Wegwischen“ sofort angewendet wird, wenn die Inhalte bereit sind, anstatt auf den Beginn der nächsten Animationsschleife zu warten. Außerdem haben wir einige Änderungen an den Schimmer- und Wisch-Animationen vorgenommen. (I5a7f4)
API-Änderungen
- Wir haben eine
HierarchicalFocusCoordinator
zusammensetzbare Funktion hinzugefügt, mit der Unterstrukturen der Komposition als Fokus aktiviert oder deaktiviert werden können (I827cb). - Wir haben ein neues Attribut hinzugefügt, um die semantische Rolle für
ToggleButton
zu überschreiben (I67132) - Wir haben
TimeTextDefaults.TimeFormat12Hours
aktualisiert und die Angabe von „Vormittags“ und „Nachmittags“ inTimeText
entfernt. Dadurch wird der Standardwert dertimeSource
-Parameter in derTimeText
API geändert. (I1eb7f) - Wir haben die Picker API erweitert, um die Barrierefreiheit für Bildschirme mit Mehrfachauswahl zu verbessern. Mit der neuen Eigenschaft
userScrollEnabled
lässt sich festlegen, ob die Bildauswahl beim Scrollen des Nutzers aktiv ist. (I3c3aa)
Fehlerkorrekturen
- Wir haben die Standardrahmenbreite für
OutlinedButton/OutlinedCompactButton
von 2 dp zu 1 dp geändert, damit sie den endgültigen UX-Spezifikationen entspricht. (Icf84d) - Um die Wirkung des ersten Elements, das einem leeren
ScalingLazyColumn
hinzugefügt wird, beim Scrollen zu verringern, haben wir geschätztautoCentering topPadding
hinzugefügt, wenn der Inhalt leer ist. Bei dieser Änderung wird die erforderliche Oberabstand berechnet, indem ein Anfangselement mit einer Höhe von 0,0 dp angenommen wird. FürScalingLazyListAnchorType.ItemStart
wird dadurch der richtige Abstand oben berechnet, fürScalingLazyListAnchorType.ItemCenter
ist diese Berechnung falsch, da die Höhe der Elemente erforderlich ist, um die Größe der Inhalte korrekt festzulegen. Dies führt zu einem kleinen Scrollen an die richtige Position, das auf der tatsächlichen Höhe der Elemente basiert.(I239a4) - Wir haben das auf die
SwipeToDismiss
-Animation angewendete Hintergrundgitter aktualisiert, damit es der Wear-Plattform entspricht. (I9003e) - Wir haben die
PositionIndicator
-Verarbeitung vonLazyListState
undScalingLazyListState
für Listenelemente der Größe 0 korrigiert, um Fehler durch eine Division durch null zu vermeiden.(Ic28dd)
Version 1.1
Version 1.1.2
8. Februar 2023
androidx.wear.compose:compose-foundation:1.1.2
, androidx.wear.compose:compose-material:1.1.2
und androidx.wear.compose:compose-navigation:1.1.2
werden losgelassen. Version 1.1.2 enthält diese Commits.
Fehlerkorrekturen
- Wir haben einen Fehler behoben, der zu unnötigen Neuzusammensetzungen in
ScalingLazyListState.centerItemIndex
führte. Dabei wurde sichergestellt, dass Updates nur dann gesendet werden, wenn sich der Wert tatsächlich ändert (Ia9f38).
Version 1.1.1
11. Januar 2023
androidx.wear.compose:compose-foundation:1.1.1
, androidx.wear.compose:compose-material:1.1.1
und androidx.wear.compose:compose-navigation:1.1.1
werden losgelassen. Version 1.1.1 enthält diese Commits.
Fehlerkorrekturen
PlaceholderState.rememberPlaceholderState()
wurde aktualisiert, umrememberUpdatedState
so zu verwenden, dass der Status aktualisiert wird, wennonContentReady
Lambda ist. (I02635, b/260343754)
Version 1.1.0
7. Dezember 2022
androidx.wear.compose:compose-foundation:1.1.0
, androidx.wear.compose:compose-material:1.1.0
und androidx.wear.compose:compose-navigation:1.1.0
wurden veröffentlicht. Version 1.1.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.0.0
- Stabile Version von Compose für Wear OS 1.1.0 (weitere Informationen)
- Eine Liste der wichtigsten Änderungen in Wear Compose 1.1 findest du in den Versionshinweisen für Compose for Wear OS 1.1 Beta01.
Neue Funktionen
- Wir haben die experimentelle Funktion für Platzhalter aktualisiert, sodass der Effekt „Wegwischen“ sofort angewendet wird, wenn die Inhalte bereit sind, anstatt auf den Beginn der nächsten Animationsschleife zu warten. Außerdem haben wir einige Änderungen an den Schimmer- und Wisch-Animationen vorgenommen. (I5a7f4)
Fehlerkorrekturen
- Wir haben die Standardrahmenbreite für eine
OutlinedButton/OutlinedCompactButton
von 2.dp auf 1.dp geändert, um den endgültigen UX-Spezifikationen zu entsprechen. (Icf84d) - Um die Wirkung des ersten Elements, das einem leeren
ScalingLazyColumn
hinzugefügt wird, beim Scrollen zu verringern, haben wir geschätztautoCentering topPadding
hinzugefügt, wenn der Inhalt leer ist. Bei dieser Änderung wird die erforderliche Oberabstand berechnet, indem ein Anfangselement mit einer Höhe von 0,0 dp angenommen wird. FürScalingLazyListAnchorType.ItemStart
wird dadurch der richtige Abstand oben berechnet, fürScalingLazyListAnchorType.ItemCenter
ist diese Berechnung falsch, da die Höhe der Elemente erforderlich ist, um die Größe der Inhalte korrekt festzulegen. Dies führt zu einem kleinen Scrollen an die richtige Position, das auf der tatsächlichen Höhe der Elemente basiert.(I239a4) - Wir haben das auf die
SwipeToDismiss
-Animation angewendete Hintergrundgitter aktualisiert, damit es der Wear-Plattform entspricht.(I9003e) - Wir haben die
PositionIndicator
-Verarbeitung vonLazyListState
undScalingLazyListState
für Listenelemente der Größe 0 korrigiert, um Fehler durch eine Division durch null zu vermeiden.(Ic28dd)
Version 1.1.0-rc01
9. November 2022
androidx.wear.compose:compose-foundation:1.1.0-rc01
, androidx.wear.compose:compose-material:1.1.0-rc01
und androidx.wear.compose:compose-navigation:1.1.0-rc01
wurden veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.
Fehlerkorrekturen
- Wir haben Grundprofilregeln für
Placeholders
,ScrollAway
,RadioButton
,Switch
,Checkbox
,OutlinedButton
,OutlinedCompactButton
,OutlinedChip
undOutlinedCompactChip
hinzugefügt. (I8249c) - Wir haben einen Fehler in
Modifier.scrollAway
behoben. Wenn die angegebeneitemIndex
ungültig ist (z. B. wenn der Artikelindex außerhalb des zulässigen Bereichs liegt), wird dieTimeText
jetzt trotzdem angezeigt. (I2137a) - Wir haben die
SwipeToDismissBox
-Animation aktualisiert, damit sie der Plattformimplementierung entspricht. Nach der ersten Animation beim Zusammendrücken gleitet der Bildschirm jetzt nach rechts, sobald die Anzeige geschlossen wurde. (I41d34) - Zur Optimierung haben wir
Modifier.scrollAway
so aktualisiert, dass nur diescrollState
im Messblock gelesen wird, um zu vermeiden, dass der Modifikator nach jeder Neumessung neu erstellt werden muss. (I4c6f1) - Wir haben eine Dokumentation und ein Beispiel zu Platzhaltern hinzugefügt, um die korrekte Reihenfolge für
Modifier.placeholder
undModifier.placeholderShimmer
anzuzeigen, wenn sie auf dieselbe zusammensetzbare Funktion angewendet werden. (Ie96f4, b/256583229) - Wir haben die Standardrahmenbreite für eine
OutlinedCompactChip/OutlinedChip
von 2.dp auf 1.dp geändert, um den endgültigen UX-Spezifikationen zu entsprechen. (Ib3d8e) - Wir haben einen Fehler in
rememberPickerState
behoben, bei dem aktualisierte Eingaben nicht gespeichert wurden, sodass Elemente nach Änderungen an den Eingaben nicht aktualisiert wurden. (I49ff6, b/255323197) - Wir haben einige Aktualisierungen der Benutzeroberfläche an den Platzhaltern vorgenommen, 1) den Schimmerverlauf auf das 1,5-Fache der Bildschirmgröße geändert, 2) das Easing (kubische Bézierkurve) des Schimmerfortschritts hinzugefügt und 3) die Wisch-Animation (250 ms) beschleunigen. (Id29c1)
- Wir haben einen UI-Fehler im Platzhalter-Effekt „wipeOff“ korrigiert, bei dem die Hintergründe von Chips und Karten etwas zu früh ausgeblendet wurden, da die Position der Komponente auf dem Bildschirm nicht berücksichtigt wurde. (I2c7cb)
- Wir haben die Hintergrundzeichnung des Platzhalters aktualisiert, um Farben nach Möglichkeit zu verschmelzen, anstatt sie zu überlagern. So wird das Risiko verringert, dass bei der Alpha-Mischung der verschiedenen zugeschnittenen Ebenen die darunter liegenden Farben an den Rändern des Platzhalterhintergrunds durchscheinen. (I2ea26)
- Wir haben die Berechnung von
ScalingLazyListState.centerItemIndex/centerItemOffset
korrigiert. Wenn sich zwei Elemente auf beiden Seiten der Mitte des Darstellungsbereichs befinden, wird das am nächsten gelegene alscenterItem
betrachtet. (I30709, b/254257769) - Wir haben einen Fehler in
ScalingLazyListState.layoutInfo.visibleItemsInfo
behoben, der während der Initialisierung vonScalingLazyColumn
falsche Offsets gemeldet hat. Jetzt wird eine leere Liste zurückgegeben, bis alle Listenelemente sichtbar sind und die richtigen Abweichungen haben. Wenn Sie nachScalingLazyListState.layoutInfo.visibleItemsInfo.isNotEmpty()
suchen, wird bestätigt, dass dieScalingLazyColumn
-Initialisierung abgeschlossen ist und die Elemente sichtbar sind. (I3a3b8)
Version 1.1.0-beta01
24. Oktober 2022
androidx.wear.compose:compose-foundation:1.1.0-beta01
, androidx.wear.compose:compose-material:1.1.0-beta01
und androidx.wear.compose:compose-navigation:1.1.0-beta01
werden losgelassen. Version 1.1.0-beta01 enthält diese Commits.
Funktionen der Funktion „Compose“ für Wear OS 1.1
Die Version 1.1.0-beta01 von Compose für Wear OS weist darauf hin, dass diese Version der Bibliothek funktionsfähig ist und die API gesperrt ist.
- Die Version 1.1 von Wear Compose enthält die folgenden neuen Funktionen:
- Auswahl: Verbesserungen bei der Barrierefreiheit der Auswahl, damit Bildschirme mit mehreren Auswahloptionen mit Screenreadern navigiert werden können und die Inhaltsbeschreibung barrierefrei ist
- Der Parameter „Picker“
contentDescription
wird jetzt nur für die ausgewählte Auswahloption verwendet und nimmt einen typfremden String an. Im vorherigen Commit musste eine Zuordnung von der Option zur Inhaltsbeschreibung übergeben werden, es wurde jedoch nur die ausgewählte Option verwendet. - Auswahlelemente sind jetzt immer zentriert ausgerichtet. Dadurch wurde ein Fehler behoben, bei dem die Ausrichtung geändert wurde, wenn
gradientRatio
auf null gesetzt wurde. Chip/ToggleChip
: Wir haben die Standardverläufe fürChip/ToggleChip
aktualisiert, damit sie den neuesten UX-Spezifikationen entsprechen.ChipDefaults.gradientBackgroundChipColors
beginnt jetzt bei 50% des Primärfarbtons statt bei 32,5%.Chip/ToggleChip
– Überladungen zum Ändern von Chipformen hinzugefügtChip/Button/ToggleButton
: Es wurde ein neuer Umrissstil für Chips und Schaltflächen sowie neueOutlinedChip
- undOutlinedButton
-Kompositen hinzugefügt, die einen transparentenChip/Button
mit einem dünnen Rahmen bieten.- Karte: Die Standardverläufe für Karten wurden aktualisiert, um sie an die neuesten UX-Spezifikationen anzupassen.
CardDefaults.cardBackgroundPainter
beginnt jetzt bei 30% des Primärfarbtons und endet bei 20% vononSurfaceVariant
(zuvor 20% bis 10%onSurfaceVariant
).ToggleChip.toggleChipColors
ändert sich von einem linearen Farbverlauf von 75% Oberfläche zu 32,5% Primärfarbe zu 0% Oberfläche zu 50% Primärfarbe. Button/ToggleButton
: Es wurden Eigenschaften zum Ändern der Schaltflächenform hinzugefügt.- Design: Einige der Standardfarben in der
MaterialTheme
wurden aktualisiert, um die Barrierefreiheit zu verbessern. Die ursprünglichen Farben hatten keinen ausreichenden Kontrast, was es Nutzern erschwert hat, die Hintergründe von Chips, Karten und Schaltflächen von der Hintergrundfarbe des Designs zu unterscheiden. InlineSlider/Stepper
: Schaltflächenrollen wurden hinzugefügt, damitTalkback
sie als Schaltflächen erkennt.- Das Gerüst – „
PositionIndicator
“ ist jetzt so positioniert und dimensioniert, dass es nur den benötigten Platz einnimmt. Das ist beispielsweise nützlich, wenn semantische Informationen hinzugefügt werden. TalkBack erhält dann die korrekten Begrenzungen desPositionIndicator
auf dem Bildschirm. CurvedText/TimeText
: Es wurdeModifier.scrollAway
hinzugefügt, mit dem ein Element je nach Scrollstatus vertikal sichtbar oder ausgeblendet wird (mit Überladungen für die Verwendung mitColumn
,LazyColumn
undScalingLazyColumn
).ScrollAway
wird in der Regel verwendet, um einTimeText
auszublenden, wenn der Nutzer beginnt, eine Liste von Elementen nach oben zu scrollen.CurvedText/TimeText
– Unterstützung fürfontFamily
,fontStyle
undfontSynthesis
inCurvedTextStyle
hinzugefügt, nutzbar untercurvedText
undbasicCurvedText
CurvedText/TimeText
–fontWeight
wurde dem Konstruktor und der Kopiermethode fürCurvedTextStyle
hinzugefügtToggleControls
: Es wurden animierte Ein-/Aus-Schaltflächen fürCheckbox
,Switch
undRadioButton
hinzugefügt, die mitToggleChip
undSplitToggleChip
verwendet werden können. Sie können anstelle der statischen Symbole vonToggleChipDefaults
(switchIcon
,checkboxIcon
undradioIcon
) verwendet werden.- Platzhalter: Es wurde eine experimentelle Unterstützung für Platzhalter hinzugefügt. Hier werden drei verschiedene visuelle Effekte verwendet, die zusammenwirken.
- Erstens: Ein Platzhalter-Hintergrund-Pinseleffekt, der in Containern wie Chips und Karten verwendet wird, um den normalen Hintergrund zu übermalen, während Inhalte geladen werden.
- Zweitens eine Modifikation (
Modifier.placeholder()
), um ein platzhalterförmiges Widget in Form eines Stadions über den geladenen Inhalten zu zeichnen. - Drittens: Ein Modifikator-Gradienten-/Shimmer-Effekt (
Modifier.placeholderShimmer()
), der über den anderen Effekten gezeichnet wird, um Nutzern zu signalisieren, dass wir auf das Laden der Daten warten.- Alle diese Effekte sind aufeinander abgestimmt und schimmern und verschwinden auf harmonische Weise.
- Abhängigkeiten von Compose Core von 1.2 auf 1.3 aktualisiert
API-Änderungen
- Schriftparameter (
fontFamily
,fontWeight
,fontStyle
undfontSynthesis
) können jetzt direkt als Parameter voncurvedText
angegeben werden (Idc422).
Fehlerkorrekturen
curveText
undbasicCurvedText
funktionieren jetzt richtig mit TalkBack. Sie sind mit einem korrekt dimensionierten und platzierten (aber leeren) compose-ui-Knoten verknüpft, der den Text als Inhaltsbeschreibung verwendet. (I7af7c, b/210721259)- Fehlerkorrektur für
Picker
whenPickerState.repeatedItems = false
, um eine explizite Einstellung der Parameter für die automatische Zentrierung in der internenScalingLazyColumn
des Pickers hinzuzufügen, damit die Null-Option in die Mitte der Ansicht gescrollt werden kann. (I8a4d7)
Version 1.1.0-alpha07
5. Oktober 2022
androidx.wear.compose:compose-foundation:1.1.0-alpha07
, androidx.wear.compose:compose-material:1.1.0-alpha07
und androidx.wear.compose:compose-navigation:1.1.0-alpha07
werden losgelassen. Version 1.1.0-alpha07 enthält diese Commits.
Neue Funktionen
- Wir haben eine experimentelle Unterstützung für Platzhalter hinzugefügt. Hier werden drei verschiedene visuelle Effekte verwendet, die zusammenwirken. Erstens ein Platzhalter-Pinseleffekt für den Hintergrund, der in Containern wie Chips und Kacheln verwendet wird, um beim Laden von Inhalten über den normalen Hintergrund zu zeichnen. Zweitens:
Modifier.placeholder()
, mit dem ein stadionförmiges Platzhalter-Widget über dem geladenen Inhalt gezeichnet wird. Drittens: Ein Modifikator-Gradienten-/Shimmer-Effekt (Modifier.placeholderShimmer()
), der über den anderen Effekten gezeichnet wird, um Nutzern zu signalisieren, dass wir auf das Laden der Daten warten. Alle diese Effekte sind aufeinander abgestimmt und schimmern und verschwinden auf harmonische Weise. (I3c339)
API-Änderungen
- Unterstützung für
fontWeight
,fontFamily
,fontStyle
undfontSynthesis
inCurvedTextStyle
hinzugefügt, verwendbar untercurvedText
undbasicCurvedText
. Mit diesen Parametern können Sie die Schriftart und den Stil für den gekrümmten Text festlegen.(Iaa1a8),(I72759) - Der Offset-Parameter von
Modifier.scrollAway
wurde zu Dp geändert, um für Einheitlichkeit mitModifier.offset
zu sorgen. Bisher wurde er in Pixeln angegeben. Außerdem wurde es aus Effizienzgründen in eineLayoutModifier
umstrukturiert. (I9f94b) - Im Rahmen der neuen API für Ein-/Aus-Schaltflächen haben wir
RadioButton’s circleColor
inringColor
umbenannt. (I28fa9) - Wir haben animierte
Checkbox
-,Switch
- undRadioButton
-Ein-/Aus-Schaltflächen fürToggleChip
undSplitToggleChip
hinzugefügt. Sie können anstelle der statischen Symbole vonToggleChipDefaults
(switchIcon
,checkboxIcon
undradioIcon
) verwendet werden. (I8a8c4)
Version 1.1.0-alpha06
21. September 2022
androidx.wear.compose:compose-foundation:1.1.0-alpha06
, androidx.wear.compose:compose-material:1.1.0-alpha06
und androidx.wear.compose:compose-navigation:1.1.0-alpha06
wurden veröffentlicht. Version 1.1.0-alpha06 enthält diese Commits.
Neue Funktionen
- Wir haben
Modifier.scrollAway
hinzugefügt, mit dem ein Element je nach Scrollstatus vertikal sichtbar oder ausgeblendet wird (mit Überladungen für die Verwendung mitColumn
,LazyColumn
undScalingLazyColumn
).ScrollAway
wird in der Regel verwendet, um einTimeText
auszublenden, wenn der Nutzer beginnt, eine Liste von Elementen nach oben zu scrollen. (I61766)
Fehlerkorrekturen
- Die
PositionIndicator
ist jetzt so positioniert und hat eine Größe, dass sie nur den benötigten Platz einnimmt. Das ist zum Beispiel nützlich, wenn semantische Informationen hinzugefügt werden, sodass TalkBack jetzt die korrekten Grenzen desPositionIndicator
auf dem Bildschirm erhält. (Ie6106, b/244409133)
Version 1.1.0-alpha05
7. September 2022
androidx.wear.compose:compose-foundation:1.1.0-alpha05
, androidx.wear.compose:compose-material:1.1.0-alpha05
und androidx.wear.compose:compose-navigation:1.1.0-alpha05
werden losgelassen. Version 1.1.0-alpha05 enthält diese Commits.
Fehlerkorrekturen
InlineSlider
undStepper
wurden Schaltflächenrollen hinzugefügt, damit Talkback sie als Schaltflächen erkennen kann. (Icb46c, b/244260275)- Wir haben die Z-Reihenfolge der Positionierungs- und Seitenindikatoren im Scaffold korrigiert. Die Anzeigen werden jetzt über der Vignette angezeigt und sind dadurch nicht mehr von der Vignette verdeckt, falls diese vorhanden ist. (Ib988f, b/244207528)
Version 1.1.0-alpha04
24. August 2022
androidx.wear.compose:compose-foundation:1.1.0-alpha04
, androidx.wear.compose:compose-material:1.1.0-alpha04
und androidx.wear.compose:compose-navigation:1.1.0-alpha04
werden losgelassen. Version 1.1.0-alpha04 enthält diese Commits.
API-Änderungen
- Wir haben einige der Standardfarben im MaterialTheme aktualisiert, um die Barrierefreiheit zu verbessern. Die ursprünglichen Farben hatten keinen ausreichenden Kontrast, was es Nutzern erschwert hat, Chip-/Karten-/Schaltflächen-Hintergründe von der Hintergrundfarbe des Designs zu unterscheiden. Die aktualisierten Farben sind „surface“ (von #FF202124 zu #FF303133), „onPrimary“ (von #FF202124 zu #FF303133), „onSecondary“ (von #FF202124 zu #FF303133), „primaryVariant“ (von #FF669DF6 zu #FF8AB4F8) und „onError“ (von #FF202124 zu #FF000000). Die Farbänderungen sind zwar relativ subtil, können sich aber auf vorhandene Screenshottests auswirken. (81ab09)
Fehlerkorrekturen
- Behebung eines Logikfehlers in
ScalingLazyColumn
, der dazu führen konnte, dass Listen mit einer kleinen Anzahl von Listenelementen (in der Regel genau zwei) nicht vollständig initialisiert wurden und daher transparent waren. (504347)
Version 1.1.0-alpha03
10. August 2022
androidx.wear.compose:compose-foundation:1.1.0-alpha03
, androidx.wear.compose:compose-material:1.1.0-alpha03
und androidx.wear.compose:compose-navigation:1.1.0-alpha03
werden losgelassen. Version 1.1.0-alpha03 enthält diese Commits.
Neue Funktionen
- Wir haben einen neuen umrissenen Stil für
Chips
undButtons
sowie die neuen zusammensetzbaren FunktionenOutlinedChip
undOutlinedButton
hinzugefügt, die eine transparenteChip/Button
mit dünnem Rahmen bieten. (Id5972)
API-Änderungen
- Überladungen zum Ändern der Schaltflächenform hinzugefügt (Icccde)
Fehlerkorrekturen
- Wir haben die Größe des Bereichs für die Ein-/Aus-Schaltfläche der
ToggleChip
korrigiert, da sie nicht den UX-Spezifikationen entsprach. Die UX-Spezifikation sieht einen Abstand von 4 dp zwischen dem Label und einem Symbolbereich für die Ein-/Aus-Schaltfläche von 24 × 24 dp vor, was einer Gesamtbreite von 28 dp entspricht. Die Implementierung gibt jedoch fälschlicherweise 36 × 24 dp für den Bereich des Ein-/Aus-Steuerelements an. Dadurch gehen 8 dp nutzbarer Textlabelfläche verloren. HINWEIS: Durch diese Fehlerkorrektur wird zusätzlicher Platz für das Textlabel geschaffen, was sich positiv auf das Textlayout für Textauslauf auswirken kann. Wenn Sie Screenshottests mitToggleChips
haben, müssen diese möglicherweise aktualisiert werden. (I514c8, b/240548670)
Version 1.1.0-alpha02
27. Juli 2022
androidx.wear.compose:compose-foundation:1.1.0-alpha02
, androidx.wear.compose:compose-material:1.1.0-alpha02
und androidx.wear.compose:compose-navigation:1.1.0-alpha02
werden losgelassen. Version 1.1.0-alpha02 enthält diese Commits.
Neue Funktionen
- Wir haben die Abhängigkeiten von Compose for Wear OS von den Compose-Kernbibliotheken 1.2.0 auf 1.3.0-alpha0X umgestellt.
API-Änderungen
- Überladungen zum Ändern von Chipformen hinzugefügt (I02e87)
Fehlerkorrekturen
- Wir haben die Sichtbarkeit der Vignette beim Ein- und Ausblenden des Dialogfelds animiert, damit sie mit der vorhandenen Skalierungsanimation übereinstimmt. (Ida33e)
- Wir haben einen Fehler behoben, bei dem beim Scrollen bei bestimmten Wischaktionen eine Division durch Null auftreten konnte. (I86cb6)
- Ein Fehler in der
ChipDefaults.childChipColor()
wurde behoben, damit die deaktivierte Hintergrundfarbe vollständig transparent ist. (I2b3c3, b/238057342)
Version 1.1.0-alpha01
29. Juni 2022
androidx.wear.compose:compose-foundation:1.1.0-alpha01
, androidx.wear.compose:compose-material:1.1.0-alpha01
und androidx.wear.compose:compose-navigation:1.1.0-alpha01
wurden veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.
API-Änderungen
- Der Parameter
contentDescription
von Picker wird jetzt nur für die ausgewählte Picker-Option verwendet und nimmt einen typfremden String an. Bisher war es erforderlich, eine Zuordnung von der Option zur Inhaltsbeschreibung zu übergeben, aber es wurde nur die ausgewählte Option verwendet. (Ife6a7) - Wir haben die Barrierefreiheit der Auswahl verbessert, damit Bildschirme mit mehreren Auswahloptionen mit Screenreadern navigiert werden können und die Inhaltsbeschreibung barrierefrei ist (I64edb).
Fehlerkorrekturen
- Wir haben die Regeln für das Baseline-Profil aktualisiert, die in der Wear Compose-Bibliothek (I9c694) enthalten sind.
- Wir haben die Richtung des Farbverlaufs für Chips im Rechts-Links-Modus korrigiert. War oben links -> unten rechts, ist jetzt oben rechts -> unten links. (Ic2e77)
- Wir haben die Standardverläufe für
Chip/ToggleChip/Card
aktualisiert, um sie an die neuesten UX-Spezifikationen anzupassen.ChipDefaults.gradientBackgroundChipColors
beginnt jetzt bei 50% des primären Farbtons statt bei 32,5%.CardDefaults.cardBackgroundPainter
wurde so aktualisiert, dass es von 30% des Primärbereichs beginnt und bei 20% vononSurfaceVariant
endet (zuvor 20% zu 10%onSurfaceVariant
).ToggleChip.toggleChipColors
ändert sich von einem linearen Farbverlauf von 75% auf 32,5% primäre zu 0% Primärfläche zu 50% Primärfläche. (I43bbd) - Wir haben hinter
Chip/ToggleChips
eine Hintergrundfarbe (MaterialTheme.color.surface
) mit Farbverlauf hinzugefügt, damit sie auch in dem unwahrscheinlichen Fall, dass eine helle Farbe verwendet wird, gut sichtbar sind. (Ibe1a4, b/235937657) - Auswahlelemente sind jetzt immer zentriert ausgerichtet. Dadurch wurde ein Fehler behoben, bei dem die Ausrichtung geändert wurde, wenn
gradientRatio
auf null gesetzt wurde. (I712b8)
Version 1.0
Version 1.0.2
7. September 2022
androidx.wear.compose:compose-foundation:1.0.2
, androidx.wear.compose:compose-material:1.0.2
und androidx.wear.compose:compose-navigation:1.0.2
wurden veröffentlicht. Version 1.0.2 enthält diese Commits.
Fehlerkorrekturen
- Wir haben die Z-Reihenfolge der Positions- und Seitenindikatoren im Gerüst korrigiert. Die Indikatoren befinden sich jetzt über der Vignettierung und werden daher nicht von der Vignette verdeckt, sofern sie vorhanden ist. (Ib988f, b/244207528)
Version 1.0.1
24. August 2022
androidx.wear.compose:compose-foundation:1.0.1
, androidx.wear.compose:compose-material:1.0.1
und androidx.wear.compose:compose-navigation:1.0.1
wurden veröffentlicht. Version 1.0.1 enthält diese Commits.
Fehlerkorrekturen
- Behebung eines Logikfehlers in
ScalingLazyColumn
, der dazu führen konnte, dass Listen mit einer kleinen Anzahl von Listenelementen (in der Regel genau zwei) nicht vollständig initialisiert wurden und daher transparent waren. (076c61)
Version 1.0.0
27. Juli 2022
androidx.wear.compose:compose-foundation:1.0.0
, androidx.wear.compose:compose-material:1.0.0
und androidx.wear.compose:compose-navigation:1.0.0
werden losgelassen. Version 1.0.0 enthält diese Commits.
Wichtige Funktionen von 1.0.0
- Dies ist die erste stabile Version von Compose für Wear OS (weitere Informationen).
- Compose for Wear OS baut auf den Compose-Kernbibliotheken auf und bietet zusätzliche Wear-spezifische Komponenten und gegebenenfalls alternative Implementierungen der Compose-Kernkomponenten, die auf Wear-Geräte zugeschnitten sind.
- Eine Liste der wichtigsten Komponenten in Wear Compose finden Sie in den Release Notes für Compose for Wear OS Beta01.
Fehlerkorrekturen
- Wir haben die Sichtbarkeit der Vignette beim Ein- und Ausblenden des Dialogfelds animiert, damit sie mit der vorhandenen Skalierungsanimation übereinstimmt. (Ida33e)
- Wir haben einen Fehler behoben, bei dem beim Scrollen bei bestimmten Wischaktionen eine Division durch Null auftreten konnte. (I86cb6)
- Ein Fehler in
ChipDefaults.childChipColor()
wurde behoben, durch den die deaktivierte Hintergrundfarbe vollständig transparent war. (I2b3c3, b/238057342)
Version 1.0.0-rc02
22. Juni 2022
androidx.wear.compose:compose-foundation:1.0.0-rc02
, androidx.wear.compose:compose-material:1.0.0-rc02
und androidx.wear.compose:compose-navigation:1.0.0-rc02
werden losgelassen. Version 1.0.0-rc02 enthält diese Commits.
Fehlerkorrekturen
- Wir haben die Richtung des Farbverlaufs für Karten im Rechts-nach-Links-Modus korrigiert. Bisher war die Reihenfolge „oben links -> unten rechts“, jetzt ist sie „oben rechts -> unten links“. (Ic2e77)
- Wir haben die Standardverläufe für
Chip/ToggleChip/Card
aktualisiert, damit sie den neuesten UX-Spezifikationen entsprechen.ChipDefaults.gradientBackgroundChipColors
beginnt jetzt bei 50% des primären Farbtons statt bei 32,5%.CardDefaults.cardBackgroundPainter
wurde aktualisiert, sodass sie bei 30% des Primärelements beginnt und bei 20% vononSurfaceVariant
endet (zuvor 20% bis 10% aufSurfaceVariant).ToggleChip.toggleChipColors
ändert sich von einem linearen Farbverlauf von 75% Oberfläche zu 32,5% Primärfarbe zu 0% Oberfläche zu 50% Primärfarbe. (I43bbd) - Wir haben hinter
Chip/ToggleChips
eine Hintergrundfarbe (MaterialTheme.color.surface
) mit Farbverlauf hinzugefügt, damit sie auch dann gut sichtbar sind, wenn hinter ihnen eine helle Farbe verwendet wird. (Ibe1a4, b/235937657) - Wir haben die Regeln für das Baseline-Profil aktualisiert, die in der Wear Compose-Bibliothek (I9c694) enthalten sind.
Version 1.0.0-rc01
15. Juni 2022
androidx.wear.compose:compose-foundation:1.0.0-rc01
, androidx.wear.compose:compose-material:1.0.0-rc01
und androidx.wear.compose:compose-navigation:1.0.0-rc01
wurden veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.
API-Änderungen
- Schnittstellen in Compose-Bibliotheken werden jetzt mit den Standardschnittstellenmethoden von JDK 8 erstellt (I5bcf1)
Fehlerkorrekturen
- Der explizite Aufruf von
fillMaxWidth()
im Listenheader wurde entfernt, da er nicht erforderlich ist und zu Problemen führen kann, wenn eineScalinglazyColumn
eine Mischung ausListHeader()
- undChip()
-Komponenten enthält. Die Breite wird dann tendenziell größer oder kleiner, wennListHeader
-Elemente in den Blick oder aus dem Blickfeld gescrollt werden. (I37144, b/235074035) - Wir haben einen Fehler in der
ScalingLazyColumn
behoben, der dazu führen konnte, dass die Listenelemente erst nach dem Scrollen korrekt dargestellt wurden, wenn das Null-Listenelement groß genug war (einschließlich Padding) (Ic6159, b/234328517) - Wir haben die
ScalingLazyColumn
-Glättung leicht angepasst, wenn Elemente den Bildschirmrand erreichen, um den aktualisierten UX-Spezifikationen zu entsprechen. Alte WerteCubicBezierEasing(0.25f, 0.00f, 0.75f, 1.00f)
-> neue WerteCubicBezierEasing(0.3f, 0f, 0.7f, 1f)
Wenn Sie das alte Verhalten beibehalten möchten, können Sie diescalingParams
vonScalingLazyColumn
(Ie375c) überschreiben. - Wir haben für das Element „
CompactChip
“ einen Abstand hinzugefügt, damit die Größe des Berührungszielbereichs von mindestens 48 dp gemäß den Richtlinien für Bedienungshilfen von Material erfüllt ist. Dies kann sich auf Layouts auswirken, in denenCompactChips
verwendet wird, da sie zusätzlichen Platz belegen. (I3d57c)
Version 1.0.0-beta03
1. Juni 2022
androidx.wear.compose:compose-foundation:1.0.0-beta03
, androidx.wear.compose:compose-material:1.0.0-beta03
und androidx.wear.compose:compose-navigation:1.0.0-beta03
werden losgelassen. Version 1.0.0-beta03 enthält diese Commits.
Neue Funktionen
ScalingLazyColumn
funktioniert jetzt auch im Modus „Compose“@Preview
. (I3b3b6, b/232947354)
API-Änderungen
- Wir haben den Standardwert für die Eigenschaft
ScalingLazyColumn.horizontalAlignment
von „Start“ in „CenterHorizontally
“ geändert, damit Listenelemente, die nicht die gesamte Breite der Spalte ausfüllen, für maximale Sichtbarkeit ausgerichtet werden. Wenn Sie zum vorherigen Verhalten zurückkehren möchten, legen SiehorizontalAlignment = Alignment.Start
fest.(I9ed4b)
Bekannte Probleme
- Die Tipp-/Berührungshöhe von CompactChip ist kleiner als die Vorgaben für Bedienungshilfen (Material). Dieser Fehler wird in der nächsten Version (15. Juni) behoben. Wenn Sie CompactChips verwenden, hat das Auswirkungen auf Ihre Layouts, da CompactChips jetzt oben und unten zusätzliche Abstände haben. Bitte passen Sie Ihre Layouts an und testen Sie sie oder sehen Sie sich die Kommentare zum Fehler an, um eine Lösung für das bisherige Verhalten zu finden. (b/234332135)
Fehlerkorrekturen
- Neue Demo zum Animieren des Hinzufügens oder Entfernens von Starttext auf einer
TimeText
. (I16d75) - Tests für
HorizontalPageIndicator.PagesState
(I64ed0) hinzufügen TimeText
näher an den UX-Spezifikationen (Ib7ea1)
Version 1.0.0-beta02
18. Mai 2022
androidx.wear.compose:compose-foundation:1.0.0-beta02
, androidx.wear.compose:compose-material:1.0.0-beta02
und androidx.wear.compose:compose-navigation:1.0.0-beta02
wurden veröffentlicht. Version 1.0.0-beta02 enthält diese Commits.
Neue Funktionen
- Die Auswahl reagiert jetzt immer auf Scroll-Ereignisse, auch im Lesemodus. So müssen Nutzer nicht erst durch Tippen eine Auswahl treffen, bevor sie scrollen können. Im Lesemodus werden Optionen, die nicht die aktuell ausgewählte sind, in
gradientColor
durch einen Shim verdeckt. (I72925) - Wir haben das UX-Verhalten von
Chip/ToggleChip/CompactChip/SplitToggleChip
geändert, damitfillMaxWidth
standardmäßig nicht mehr ausgeführt wird. Stattdessen passen sie sich an ihre Inhalte an. Wenn Sie das bisherige Verhalten beibehalten möchten, fügen Sie einfachmodifier = Modifier.fillMaxWidth()
(I60a2c, b/232206371) hinzu.
Fehlerkorrekturen
- Der
CurvedTextStyle
-Konstruktor, der einenTextStyle
annimmt, berücksichtigt jetzt auch diefontWeight
. Dieser Parameter kann in zukünftigen Versionen der API dem Konstruktor und den Kopiermethoden hinzugefügt werden. (Ieebb9) - Verbesserungen beim Wischen am Rand. Wenn
Modifier.edgeSwipeToDismiss
verwendet wird und ein Wischen nach links vom Randbereich aus ausgelöst wird, wird das Wischen zum Schließen nicht mehr ausgelöst, wenn sich die Wischrichtung nach rechts ändert. Bisher war es möglich, das Wischen zum Schließen durch Wischen nach links und dann nach rechts auszulösen.(I916ea) HorizontalPageIndicator
zeigt jetzt bis zu sechs Seiten auf dem Bildschirm an. Wenn es insgesamt mehr als sechs Seiten gibt, wird links oder rechts ein Indikator in halber Größe angezeigt, mit einem fließenden Übergang zwischen den Seiten.(I2ac29)- Verbessertes Standard-Snap-Verhalten auf
ScalingLazyColumn
undPicker
(I49539) - Verbesserungen beim Wischen am Rand Wenn
Modifier.edgeSwipeToDismiss
verwendet wird, wird das Wischen zum Schließen nur ausgelöst, wenn die erste Berührung am Rand erfolgt und nach rechts gewischt wird. Bisher war es möglich, das Wischen zum Schließen durch Wischen von einem beliebigen Punkt auf dem Bildschirm auszulösen, wenn ein Scrollen den Anfang erreicht.(I8ca2a)
Version 1.0.0-beta01
11. Mai 2022
androidx.wear.compose:compose-foundation:1.0.0-beta01
, androidx.wear.compose:compose-material:1.0.0-beta01
und androidx.wear.compose:compose-navigation:1.0.0-beta01
werden losgelassen. Version 1.0.0-beta01 enthält diese Commits.
Funktionen der Funktion „Compose“ für Wear OS 1.0
Die Version 1.0.0-beta01
von Compose für Wear OS ist ein wichtiger Meilenstein, da die Bibliothek jetzt funktionsfähig ist und die API gesperrt wurde.
Zu den Wear Compose-Materialkomponenten in der Version 1.0 gehören:
- Material Theme: Ersetzt Compose for Mobile
MaterialTheme
und bietet Farben, Formen und Typografie für die Erstellung von Wearables-Komponenten, die die UX-Richtlinien für Wear Material Design bereits implementieren. Button
,CompactButton
undToggleButton
: Die Schaltfläche bietet einen einzelnen Steckplatz für ein Symbol, ein Bild oder einen kurzen Text (maximal 3 Zeichen). Kreisförmig mit den empfohlenen Größen für Standard-, große oder kleine Schaltflächen.CompactButton
bietet einen einzelnen Slot für beliebige Inhalte (Symbol, Bild oder Text) und ist kreisförmig mit einer sehr kleinen Hintergrundgröße.CompactButton
hat optionale transparente Ränder um den Hintergrund, die den anklickbaren Bereich vergrößern.ToggleButton
ist eine Schaltfläche mit einem einzigen Steckplatz für beliebige Inhalte (kurzer Text, Symbol oder Bild) und den Status „An/Aus“ (angeklickt/nicht angeklickt) mit Farbgebung und verschiedenen Symbolen, die anzeigen, ob die Option aktiviert ist oder nicht.- Karten: Hier werden Informationen zu Apps wie Benachrichtigungen angezeigt. Flexibles Design für verschiedene Anwendungsfälle:
AppCard
undTitleCard
bieten unterschiedliche Layouts und unterstützen Bilder als Karteninhalte oder Hintergründe. - Chips - stadionförmige Komponenten ähnlich wie Schaltflächen, aber mit einem größeren Bereich und mehreren Schlitzen für Beschriftungen, sekundäre Beschriftungen und Symbole. In verschiedenen Größen und mit Unterstützung von Bildern als Hintergründe
- ToggleChips und SplitToggleChips: Ein Chip mit einem angeklickten/nicht angeklickten Status und einem zusätzlichen
ToggleControl
-Slot, um ein Symbol wie einen Schalter oder eine Optionsschaltfläche für den angeklickten Status der Komponente anzuzeigen. Außerdem hat dasSplitToggleChip
zwei berührbare Bereiche, einen anklickbaren und einen aus-/einschaltbaren. - CircularProgressIndicator – Wear OS-Fortschrittsanzeige mit zwei Varianten Die erste drückt den Anteil des Abschlusses einer laufenden Aufgabe aus und unterstützt eine Lücke in der kreisförmigen Spur zwischen Start- und Endwinkel. Die zweite gibt einen unbestimmten Fortschritt für eine nicht angegebene Wartezeit an.
- curvedText: Dieser Parameter ist Teil der DSL zur Beschreibung von
CurvedLayouts
und wird zusammen mitcurvedRow
undcurvedColumn
verwendet, um Komponenten um kreisförmige Geräte herum anzuordnen. Weitere Informationen zuCurvedLayout
undCurvedModifier
finden Sie unten unter „Wear Component Foundation“. Diese spielen eine ähnliche Rolle wie Modifikatoren in der nicht gebogenen Welt und ermöglichen die Konfiguration verschiedener Aspekte wie Layout, Abstände und Farbverläufe. - Dialogfeld, Benachrichtigung und Bestätigung: Ein Dialogfeld wird im Vollbildmodus angezeigt, überlagert alle anderen Inhalte und kann durch Wischen geschlossen werden. Er nimmt einen einzelnen Slot ein, der voraussichtlich Wear OS-Dialoginhalte wie Benachrichtigungen oder Bestätigungen enthalten wird. Die Benachrichtigung ist ein vorgegebener Dialoginhalt mit Platz für Symbol, Titel und Nachricht. Es gibt Überlastungen für entweder zwei negative und positive Schaltflächen, die nebeneinander angezeigt werden, oder einen Steckplatz für einen oder mehrere vertikal gestapelte Chips. Eine Bestätigung ist ein dialogorientierter Inhalt, bei dem eine Nachricht für eine bestimmte Dauer angezeigt wird. Sie hat eine Fläche für ein Symbol oder Bild (das könnte animiert sein).
- HorizontalPageIndicator: Zeigt die horizontale Seitenposition in einer Form, die dem Wearable-Formfaktor entspricht. Erfüllt den Vollbildmodus und zeigt auf runden Geräten einen gebogenen Indikator an. Kann mit dem Seitenbetrachter für Begleiter verwendet werden.
- Symbol: Eine Wear-Implementierung des Symbols, bei der Farbe und Alphakanal aus dem Wear-Material-Design übernommen werden. Informationen zu einem anklickbaren Symbol finden Sie unter Schaltfläche oder Chip.
- Auswahl: zeigt eine scrollbare Liste von Elementen an, aus der eine Auswahl getroffen werden kann. Standardmäßig werden Elemente in beiden Richtungen „unendlich“ wiederholt. Kann im Lesemodus angezeigt werden, um nicht ausgewählte Optionen auszublenden.
- PositionIndicator - zeigt die Scroll-Position oder andere Positionshinweise in einer Form, die dem Wearable-Formfaktor entspricht. Erfüllt den Vollbildmodus und zeigt auf runden Geräten einen gebogenen Indikator an.
- Scaffold: Hier wird die grundlegende visuelle Layoutstruktur von Wear Material Design implementiert. Diese Komponente bietet eine API, mit der mehrere Wear Material-Komponenten (z. B.
TimeText
,PositionIndicator
undVignette
) für die Bildschirmkonstruktion zusammengestellt werden. Dabei wird eine geeignete Layoutstrategie gewährleistet und die erforderlichen Daten erfasst, damit diese Komponenten einwandfrei zusammenwirken. - ScalingLazyColumn: eine scrollbare Listenkomponente mit Skalierung/Fischaugeneffekt, die einen wichtigen Teil der Wear OS-Material Design-Sprache bildet. Hiermit können Sie die Inhaltselemente skalieren und Transparenzeffekte hinzufügen.
ScalingLazyColumn
ist für die Verarbeitung einer potenziell großen Anzahl von Inhaltselementen konzipiert, die nur bei Bedarf materialisiert und zusammengesetzt werden. - Schieberegler: Nutzer können aus einem Wertebereich auswählen. Die Auswahlmöglichkeiten werden als Balken dargestellt, der optional mit Trennlinien versehen werden kann.
- Einstellbarer Schieberegler: Eine Vollbildkomponente, mit der Nutzer über die Schaltflächen „Höher“ und „Niedriger“ oben und unten auf dem Bildschirm eine Auswahl aus einem Wertebereich treffen können. In der Mitte befindet sich ein Bereich für Text oder einen Chip.
- SwipeToDismissBox - steuert die Wischgeste zum Schließen. Für den Hintergrund, der nur während der Wischgeste angezeigt wird, und für den Inhalt im Vordergrund wird ein einziger Bereich benötigt. Kann optional mit der androidx-Navigationsbibliothek kombiniert werden, indem
SwipeDismissableNavHost
verwendet wird (siehe Wear Compose-Navigationsbibliothek unten). - Text: Eine Wear-Implementierung der Compose Material Text-Komponente, die Farbe und Alphakanal aus dem Wear Material-Design übernimmt
- TimeText: Eine Komponente, mit der die Uhrzeit und der Anwendungsstatus oben auf dem Bildschirm angezeigt werden. Passt sich durch Verwendung von gebogenem Text auf runden Displays an die Bildschirmform an.
Vignette: Eine Bildschirmbehandlung für die Verwendung im Scaffolding, bei der der obere und untere Bereich des Bildschirms unscharf wird, wenn scrollbare Inhalte verwendet werden.
Außerdem sind die folgenden Komponenten aus Wear Compose Foundation enthalten:
CurvedLayout – Wear Foundation
CurvedLayout
ist ein Layout-Komposit, das seine untergeordneten Elemente in einem Bogen anordnet und bei Bedarf dreht. Das ähnelt einem Zeilenlayout, das in ein Segment eines Ringes gebogen ist. Der Inhalt einerCurvedLayout
ist kein kompostierbares Lambda, sondern eine DSL (domainspezifische Sprache). Alle Elemente in der DSL von CurvedLayout unterstützen einen optionalen Modifikatorparameter, der ausCurvedModifier
erstellt wird.basicCurvedText: Ein Element in der
CurvedLayout
-DSL,basicCurvedText
, mit dem Entwickler ganz einfach gekrümmten Text schreiben können, der der Krümmung eines Kreises folgt (normalerweise am Rand eines kreisförmigen Bildschirms).basicCurvedText
kann nur innerhalb vonCurvedLayout
erstellt werden, um die beste Leistung zu erzielen. So können Sie beispielsweise die Positionierung angeben undCurvedModifiers
verwenden. In den meisten Fällen sollte stattdessen „kurventext“ verwendet werden, da hier Material-Design verwendet wird.curvedComposable: Normale zusammensetzbare Inhalte werden umgebrochen, damit sie mit
CurvedLayout
verwendet werden können. WenncurvedComposable
mehrere Elemente enthält, werden sie übereinander gezeichnet (wie bei einem Frame). Wenn Sie mehrere zusammensetzbare Funktionen entlang einer Kurve platzieren möchten, umschließen Sie diese jeweils mitcurvedComposable
.CurdRow und CurdColumn – ähnlich wie Zeile und Spalte können
curvedRow
undcurvedColumn
in einemCurvedLayout
verschachtelt werden, um Elemente nach Bedarf anzuordnen. Für eincurvedRow
können die Richtung des schiefwinkligen Layouts und die radiale Ausrichtung angegeben werden. Für eincurvedColumn
können die Winkelausrichtung und die Radialrichtung angegeben werden.CurvedModifier: Alle gekrümmten Komponenten akzeptieren einen Modifiziererparameter, der mit
CurvedModifier
erstellt werden kann: Hintergrund, Größe, Gewicht und Abstand werden unterstützt.Die folgende Komponente ist auch in der Navigation von Wear Compose enthalten:
SwipeDismissableNavHost: Bietet in der Compose-Hierarchie einen Ort für eine eigenständige Navigation, bei der die Rückwärtsnavigation durch Wischen erfolgt. Inhalte werden in einem
SwipeToDismissBox
mit der aktuellen Navigationsebene angezeigt. Während einer Wischgeste zum Schließen wird die vorherige Navigationsebene (falls vorhanden) im Hintergrund angezeigt.In den vorherigen Versionshinweisen für die verschiedenen Alphaversionen finden Sie weitere Informationen dazu.
API-Änderungen
CurvedModifier.padding*
-Funktionen hinzugefügt Sie werden verwendet, um zusätzlichen Abstand um eine gebogene Komponente herum anzugeben. (I4dbb4)CompositionLocal
interne Klasse wurde entfernt (I42490)- Wir haben als Orientierungshilfe konstante Werte für die Symbolgrößen
Button
,CompactButton
undToggleButton
hinzugefügt. I57cab - Fügen Sie
AppCard
undTitleCard
den Parameter „enabled“ hinzu. Jetzt haben sie eine ähnliche API wieandroidx.compose.material
-Karten. Ist der Parameter auf „false“ gesetzt, ist die Karte nicht anklickbar. (Idc48d, b/228869805)
Fehlerkorrekturen
- Der Stepper deaktiviert jetzt die Schaltflächen zum Verringern und Erhöhen, wenn die Unter-/Obergrenzen erreicht wurden, und wendet ContentAlpha.disabled auf die iconColor an. (I4be9f)
- Wir haben einen Abstand von 1 dp um Picker-Inhalte hinzugefügt, wenn sie mit einem Farbverlauf gezeichnet werden, um Bildsprünge beim Wischen zu vermeiden. (I0b7b9)
- Screenshottests für
PositionIndicator
(I5e8bc) hinzufügen - Weitere Tests für
AppCard
undTitleCard
hinzufügen (I85391, b/228869805)
Version 1.0.0-alpha21
20. April 2022
androidx.wear.compose:compose-foundation:1.0.0-alpha21
, androidx.wear.compose:compose-material:1.0.0-alpha21
und androidx.wear.compose:compose-navigation:1.0.0-alpha21
werden losgelassen. Version 1.0.0-alpha21 enthält diese Commits.
Neue Funktionen
- Es wurden neue Kurvenmodifikatoren hinzugefügt, um den Hintergrund eines gekrümmten Elements anzugeben:
CurvedModifier.background
,.radialGradientBackground
und.angularGradientBackground
(I8f392) - Es soll möglich sein, den Überlaufmodus für gekrümmten Text (abgeschnitten/Dreipunkt-Elipsis/sichtbar) anzugeben. (I8e7aa)
- Wir haben einen
CurvedModifier.weight
-Modifikator hinzugefügt, der dem in „Schreiben“ ähnelt. Dieser Wert kann für untergeordnete Elemente von „curvedRow“ und „CurvedLayout“ (für die Breite) und für untergeordnete Elemente von „curvedColumn“ (für die Höhe) verwendet werden. (I8abbd) - Die Modifikatoren
CurvedModifier.size
,.angularSize
und.radialSize
wurden hinzugefügt, um die Größe eines gekrümmten Elements anzugeben. (I623c7)
API-Änderungen
- Ordnen Sie die Parameter in der Wear Compose API neu an, damit der Hintergrund und die Farbe einheitlich sind (I43208).
- Die Parameter "im Uhrzeigersinn" und "
insideOut
" wurden entfernt und in neuen Klassen durch ausdrucksstärkere Konstanten ersetzt. Die Ausrichtungsrichtung für das gebogene Layout kann jetztLayoutDirection
erkannt und übernommen werden, wenn keine Angabe erfolgt (If0e6a). - Wir haben
autoCenter: Boolean
durchautoCenter: AutoCentringParams
ersetzt, um ein API-Problem mit derScalingLazyColumn
zu beheben. (Ia9c90) - Wir haben
iconTintColor
undtoggleControlTintColor
in der gesamten API iniconColor
undtoggleControlColor
umbenannt (Chip/ToggleChip/Dialog/Slider/Stepper/…). Die Farbe wird jetzt auf den Slot „icon/toggleControl“ angewendet. (Ied238) PageIndicatorStyle
-Enum in Wertklasse umschreiben (I2dc72)- Wir haben einigen Plätzen in unseren Composables
RowScope/ColumnScope/BoxScope
hinzugefügt, um Entwicklern zu zeigen, von welchen Annahmen das Layout ausgegangen wird. So können Entwickler zusätzliche Modifikatoren für einige Slot-Inhalte verwenden und müssen keine zusätzlichen Layoutelemente bereitstellen. Außerdem haben wir einige kleinere Änderungen an den Farben der AppCard bzw. der Titelkarte vorgenommen, sodasstimeColor
undappColor
standardmäßig aufcontentColor
festgelegt sind. Diese Eigenschaften können bei Bedarf trotzdem alle einzeln überschrieben werden. (I26b59) - Das Objekt
SwipeToDismissBoxState.Companion
wurde zu einem privaten Objekt (I39e84) - Korrigieren Sie die Reihenfolge der Parameter für
InlineSlider
undStepper
. Eine einfache Änderung, um die API-Richtlinien einzuhalten (I11fec) - Wir haben das Energiesparobjekt für
SwipeToDismissBoxState
entfernt, da es nicht verwendet wurde. (Ifb54e) - Wir haben
CompactChip
aktualisiert, um sie an die neueste UX-Spezifikation anzupassen. Der Abstand wurde auf horizontal = 12.dp und vertikal = 0.dp reduziert. Die Schriftart für das Label wurde von "Schaltfläche" zu "Untertitel1" geändert. Die empfohlene Größe für Symbole beträgt 20 × 20 Pixel, wenn sowohl ein Symbol als auch ein Label vorhanden sind, und 24 × 24 Pixel für einen kompakten Chip mit nur einem Symbol. Bei nur einem Symbol haben wir außerdem darauf geachtet, dass es zentriert ist. (Iea2be) - Wir haben
ScalingLazyListLayoutInfo
einige neue Felder hinzugefügt, damit Entwickler die Höhe der angewendetencontentPadding
undautoCenteringPadding
sehen können. Diese können für Entwickler bei der Berechnung von Fling/Scrollen nützlich sein (I7577b). - Wir haben Ein-/Ausgangsübergänge für Dialog implementiert. Der Parameter
showDialog
wurde hinzugefügt und das Dialogfeld steuert jetzt seine eigene Sichtbarkeit. So kann Dialog die Intro- und Outro-Animationen ausführen, wenn das Dialogfeld angezeigt/ausgeblendet wird. Die Outro-Animation wird nicht ausgeführt, wenn der Nutzer das Dialogfeld durch Wischen zum Schließen verlässt. Außerdem haben wir der kürzlich hinzugefügtenSwipeToDismissBox
-Überladung einen Standardwert für den Status hinzugefügt. (I682a0) - Um die Unterstützung von i18n und a11y zu verbessern, haben wir
ToggleChip
undSplitToggleChip
so geändert, dass sie keinen Standardwert mehr für dentoggleControl
-Slot haben. Außerdem haben wirToggleChipDefaults
geändert, sodass die folgenden Methoden jetzt ImageVector anstelle von Symbol zurückgeben (beachten Sie, dass sie nicht mehr @Composables zurückgeben, sondern mit Kleinbuchstaben beginnen),SwitchIcon()->switchIcon()
,CheckboxIcon->checkboxIcon()
undRadioIcon()->radioIcon()
. Dies ermöglicht und ermutigt Entwickler, ihre eigenenIcon()
-Komponierbaren mit einem geeignetencontentDescription
-Satz zu erstellen. (I5bb5b) SwipeDismissableNavHost
wurde einSwipeDismissableNavHostState
-Parameter hinzugefügt. Dadurch wird die Verwendung von Wischen am Bildschirmrand auf Bildschirmen unterstützt, die als Navigationsziele verwendet werden, daSwipeToDismissBoxState
jetzt gehoistet und verwendet werden kann, um sowohlSwipeDismissableNavHostState
als auchModifier.edgeSwipeToDismiss
auf Bildschirmen zu initialisieren, für die Wischen am Bildschirmrand erforderlich ist. (I819f5, b/228336555)
Fehlerkorrekturen
- Achten Sie darauf, dass die gebogenen Layouts bei Bedarf aktualisiert werden. (Ie8bfa, b/229079150)
- Fehlerkorrektur für https://issuetracker.google.com/issues/226648931 (Ia0a0a, b/226648931)
- Unnötige experimentelle Anmerkungen entfernt (I88d7e)
Version 1.0.0-alpha20
6. April 2022
androidx.wear.compose:compose-foundation:1.0.0-alpha20
, androidx.wear.compose:compose-material:1.0.0-alpha20
und androidx.wear.compose:compose-navigation:1.0.0-alpha20
wurden veröffentlicht. Version 1.0.0-alpha20 enthält diese Commits.
Neue Funktionen
- Fügen Sie den
edgeSwipeToDismiss
-Modifikator fürSwipeToDismiss
hinzu. Hiermit kannswipeToDismiss
nur am linken Rand des Darstellungsbereichs aktiv sein. Wird verwendet, wenn die Mitte des Bildschirms horizontales Paging unterstützen muss, z. B. das 2D-Scrollen einer Karte oder horizontales Wischen zwischen Seiten.(I3fcec, b/200699800)
API-Änderungen
- Basisimplementierung von
CurvedModifiers
. Dies eröffnet Möglichkeiten zur Anpassung gekrümmter Inhalte. Es sind jedoch noch keineCurvedModifiers
verfügbar und die Möglichkeit zum Erstellen benutzerdefinierter Modifikatoren wird möglicherweise erst später eingeführt. (I9b8df) - Die Dokumentation zu
EdgeSwipe
-Modifizierern und die Standardwerte wurden aktualisiert, um für mehr Klarheit zu sorgen .(I6d00d) - Fügen Sie dem Scaffold den Steckplatz
PageIndicator
hinzu. Wenn SiePageIndicator
direkt zu Scaffold hinzufügen, können wir dafür sorgen, dass es auf kreisförmigen Geräten korrekt angezeigt wird. (Ia6042) - Entfernen Sie die Standardsymbole aus den Parametern
InlineSlider
und Stepper. So können Entwickler die Anforderungen an die Lokalisierung und Barrierefreiheit besser berücksichtigen. Die Verwendung von Standardsymbolen wurde in Demos und Beispielen gezeigt. (I7e6fd) - End- und Anfangsparameternamen in „TimeText“ durch „Start“ und „End“ ersetzen (Iaac32)
- Wir haben eine
SwipeToDismissBox
-Überladung mit einemonDismissed
-Parameter hinzugefügt, um die gängige Verwendung zu unterstützen, bei der ein Navigationsereignis ausgelöst wird, wenn die Wischgeste abgeschlossen ist. (I50353, b/226565726) ExperimentalWearMaterialApi
-Hinweise zur Verwendung vonTimeText
entfernt (Ide520)- Wir haben
ScalingLazyList/Column
Bereichs- und Informationsschnittstellen als versiegelt gekennzeichnet, da sie nicht für externe Entwickler gedacht sind. So können wir in Zukunft neue Mitglieder hinzufügen, ohne Änderungen an Binärprogrammen vornehmen zu müssen. (I7d99f) - Wir haben der Auswahl eine neue
flingBehaviour
-Eigenschaft und einePickerDefaults.flingBehaviour()
-Methode hinzugefügt, um die Konfiguration des Suchverhaltens zu ermöglichen, z. B. die RSB-Unterstützung.PickerState
implementiert jetzt dieScrollableState
-Schnittstelle. (Ib89c7)
Fehlerkorrekturen
- Aktualisieren Sie die Regeln für das Baseline-Profil der Android Runtime (ART) für Wear Compose-Bibliotheken. ART kann Profilregeln auf Geräten nutzen, um einen bestimmten Teil der Anwendung vorab zu kompilieren und so die Leistung der Anwendung zu verbessern. Hinweis: Dies hat keine Auswirkungen auf debuggbare Anwendungen. (Iaa8ef)
- Dokumentation verbessern (I2c051)
Version 1.0.0-alpha19
23. März 2022
androidx.wear.compose:compose-foundation:1.0.0-alpha19
, androidx.wear.compose:compose-material:1.0.0-alpha19
und androidx.wear.compose:compose-navigation:1.0.0-alpha19
wurden veröffentlicht. Version 1.0.0-alpha19 enthält diese Commits.
API-Änderungen
CurvedRow
wurde inCurvedLayout
umbenannt und in einen Bereich mit einer DSL umgewandelt. Mit dieser DSL können komplexere gekrümmte Layouts mit einer Reihe verschachteltercurvedRow
undcurvedColumn
(entsprechend „Zeile“ und „Spalte“ im gekrümmten Layout) angegeben werden. Innerhalb dieser Layoutelemente können drei Elemente verwendet werden:curvedComposable
(um @Composable hinzuzufügen),basicCurvedText
(gebogener Text der Foundation) undcurvedText
(gebogener Text für Wear OS-Material). (Ib776a)- Machen Sie die Seite für das
PositionIndicator
konfigurierbar. Die Position des einfachen PositionIndicator kann jetzt auf „End“ (layoutrichtungsabhängig), „OppositeRsb“ (berücksichtigt die Bildschirmdrehung, um sich gegenüber dem physischen RSB zu positionieren) oder auf die absoluten Positionen „Left“ und „Right“ konfiguriert werden. (I2f1f3) - Bei
SwipeToDismissBox
haben wirSwipeDismissTarget
.Original inSwipeToDismissValue.Default
undSwipeDismissTarget.Dismissal
inSwipeToDismissValue.Dismissed
umbenannt. Außerdem wurdenSwipeToDismissBoxDefaults.BackgroundKey
undSwipeToDismissBoxDefaults.ContentKey
inSwipeToDismissKeys.Background
undSwipeToDismissKeys.Content
umbenannt. (I47a36) - Wir haben der Auswahl einen schreibgeschützten Modus hinzugefügt. Dieser Modus ist für Bildschirme mit mehreren Auswahlen geeignet, bei denen jeweils nur eine Auswahl bearbeitbar ist. Wenn die Auswahl schreibgeschützt ist, werden die aktuell ausgewählte Option und gegebenenfalls ein Label angezeigt. (I879de)
SwipeToDismissBoxState
wurde umstrukturiert, um den Umfang vonExperimentalWearMaterialApi
aufModifier.swipeable
undSwipeableState
zu beschränken, die jetzt intern verwendet werden.SwipeToDismissBoxState
hat jetzt die MitgliedercurrentValue
,targetValue
,isAnimationRunning
undsnapTo
, um gängige Anwendungsfälle zu unterstützen. Bitte lassen Sie uns wissen, ob weitere Properties verfügbar gemacht werden sollen. Außerdem wurde das Verhalten vonSwipeableState
für den Fall behoben, dass der Versatz beim Wischen innerhalb eines Rundungsfehlers eines Ankers lag. (I58302)
Fehlerkorrekturen
- Der Code wurde vereinfacht und korrigiert, um zu erkennen, ob der Inhalt eines
ScalingLazyColumn
gescrollt werden kann. So wird entschieden, ob ein Bildlaufbalken angezeigt wird oder nicht. (I7bce0) - Ein Fehler in der Positionsanzeige wurde behoben, der bei Verwendung mit mehr als einem Status und beim Wechseln zwischen diesen Statusangaben bestand (I320b5).
- Wir haben die Typografie/Schriftarten des Standard-Compose for Wear OS-Designs an unsere aktuellen UX-Richtlinien angepasst. Dabei sind die Werte display1 (40.sp) und display2 (34.sp) jetzt kleiner als die vorherigen Werte. Außerdem wurden verschiedene kleinere Aktualisierungen der Zeilenhöhe und des Zeilenabstands vorgenommen. (Ie3077)
- Wir haben
SwipeToDismissBox
einen Widerstand hinzugefügt, damit die Bewegung nur beim Wischen zum Schließen erfolgt und nicht in die entgegengesetzte Richtung. (Ifdfb9) - Wir haben einige der Standardparameterwerte für die
CircularProgressIndicator
-Funktionen geändert, damit sie den UX-Richtlinien für Wear OS-Material Design entsprechen. Für die Spinner-/Indeterminant-Version wurden Größe (40->24.dp), AnzeigeColor (primär->onBackground), transparente TrackColor (30%->10%) und Strichbreite (4->3dp) aktualisiert. Bei der Fortschritts-/Determinismusversion wurde die Transparenz von trackColor (30%-> 10%) aktualisiert. (I659cc) - Wir haben die Standard-Skalierungsparameter von
ScalingLazyColumn
entsprechend den neuesten UX-Spezifikationen von Wear Material Design aktualisiert. Dies führt dazu, dass Listenelemente beginnend näher an der Listenmitte skaliert werden, aber am Listenrand weniger skaliert werden als zuvor. (Ica8f3) - Einige Anpassungen an
ScalingLazyColumnDefaults.snapFlingBehavior
, um das Ende der Animation zu verbessern (If3260)
Version 1.0.0-alpha18
9. März 2022
androidx.wear.compose:compose-foundation:1.0.0-alpha18
, androidx.wear.compose:compose-material:1.0.0-alpha18
und androidx.wear.compose:compose-navigation:1.0.0-alpha18
werden losgelassen. Version 1.0.0-alpha18 enthält diese Commits.
API-Änderungen
- Bei PositionIndicator wurden mehrere Verbesserungen vorgenommen: „ShowResult“ wurde in „PositionIndicatorVisibility“ umbenannt. Einige Leistungsverbesserungen, um unnötige Neuberechnungen zu vermeiden (Iaed9d)
- Die empfohlene Färbung für die
SplitToggleChip
wurde aktualisiert. SplitToggleChips haben jetzt einen einfarbigen Hintergrund, wenn sie aktiviert oder deaktiviert sind. Die Einfärbung des Umschaltsteuerelements gibt an, ob die Komponente aktiviert ist oder nicht. Wir haben eine neueToggleDefaults.splitToggleChipColors()
hinzugefügt, um das neue Farbschema zu unterstützen. Außerdem haben wir dietoggleChipColors()
-Methoden vereinfacht und die Option „splitBackgroundOverlayColor“ entfernt (I7e66e). - Wir haben der
ScalingLazyListItemInfo
die unadjustedSize hinzugefügt, da es aufgrund der Genauigkeit von Gleitkommarechnungen nicht sicher ist, die ursprüngliche Artikelgröße anhand der skalierten Größe und des Skalierungsfaktors zu berechnen. (I54657, b/221079441) - Fügen Sie
HorizontalPageIndicator
hinzu. Er steht für die Gesamtzahl der Seiten und eine ausgewählte Seite. Kann je nach Form des Geräts linear oder gekrümmt sein. Außerdem wird eine benutzerdefinierte Form für den Indikator unterstützt, die festlegt, wie jeder Indikator visuell dargestellt wird. (Iac898) - Wir haben
PickerState
aktualisiert, damit die Anzahl der Optionen aktualisiert werden kann. Dies unterstützt Anwendungsfälle wie einenDatePicker
, bei dem sich die Anzahl der Tage im Monat abhängig vom ausgewählten Monat ändert. Der Konstruktorparameter für PickerState wurde entsprechend in „initialNumberOfOptions“ geändert. (Iad066) - Blenden Sie das
PositionIndicator
aus, wenn eine Bildlaufleiste vorhanden ist, aber nicht gescrollt werden kann. (Id0a7f) - Zur besseren Einheitlichkeit mit Scaffold wird in der Vollbild-Dialogkomponente jetzt ein
PositionIndicator
und einVignette
angezeigt. Außerdem wird jetztScalingLazyColumn
anstelle vonColumn
verwendet. Das bedeutet, dass sich der Dialoginhalt jetzt inScalingLazyListScope
befindet und in der Regel von „item { /* content */ }“ umschlossen werden muss. „Dialog“ unterstützt den Parameter „verticalArrangement“ entsprechend. (Idea13) - Wir haben den Namen der Eigenschaft „toggleIcon“ von
ToggleChip
undSplitToggleChip
in „toggleControl“ geändert, um sie besser an Material Design anzupassen und Designern und Entwicklern die Navigation in der API zu erleichtern. (If5921, b/220129803) - Wir haben der Funktion „Wear-Material“-Designtypologie den neuen Eintrag „caption3“ hinzugefügt.Caption3 ist eine kleine Schriftart, die zum Schreiben von zusätzlichen Texten im Langformat wie rechtlichen Texten verwendet wird. (I74b13, b/220128356)
Fehlerkorrekturen
- Beenden Sie das Andocken der Animation, wenn wir dort sind. (Idb69d)
- Animieren Sie Änderungen in PositionIndicator. (I94cb9)
- Aufgrund von UI/UX-Feedback haben wir die automatische Zentrierung von
ScalingLazyColumn
so geändert, dass nur so viel Platz vorhanden ist, dass die Elemente mit dem IndexScalingLazyListState.initialCenterItemIndex
oder höher vollständig in die Mitte des Ansichtsbereichs gescrollt werden können. So können Entwickler ein oder zwei Elemente um das ursprünglich in der Mitte platzierte Element herum platzieren, die nicht in die Mitte gescrollt werden können. Das bedeutet, dass ein automatisch zentrierterScalingLazyColumn
nicht über deninitialCenterItemIndex/initialCenterItemScrollOffset
scrollen kann (I22ee2). - Wir haben eine Demo für eine Datumsauswahl hinzugefügt und einen Fehler in
PickerState
behoben, bei dem die initiallySelectedOption erst angewendet wurde, nachdem die Auswahl angezeigt wurde. (Id0d7e) - Um das Zuschneiden breiterer
ScalingLazyColumn
-Elemente auf runden Bildschirmen zu reduzieren, haben wir den standardmäßigen horizontalen Inhaltsabstand von 8 auf 10 dp erhöht. (I0d609) - Achten Sie darauf, dass das
PositionIndicator
beim Scrollen angezeigt wird. (Ied9a2)
Version 1.0.0-alpha17
23. Februar 2022
androidx.wear.compose:compose-foundation:1.0.0-alpha17
, androidx.wear.compose:compose-material:1.0.0-alpha17
und androidx.wear.compose:compose-navigation:1.0.0-alpha17
werden losgelassen. Version 1.0.0-alpha17 enthält diese Commits.
Neue Funktionen
- Wir haben die Unterstützung für Snaps hinzugefügt, die mit
ScalingLazyColumn
verwendet werden können. Legen SieflingBehavior = ScalingLazyColumnDefaults.flingWithSnapBehavior(state)
fest, um die Snap-Unterstützung zu aktivieren. (I068d3, b/217377069) - Wir haben Demos für Picker hinzugefügt, mit denen eine Zeit im 24- oder 12-Stunden-Format ausgewählt werden konnte. (Ie5552)
API-Änderungen
- Problem mit
TimeText
benutzerdefinierten Schriftarten und -stilen auf einem Gerät im Quadratformat beheben (Iea76e) ScalingLazyListLayoutInfo
hat jetzt diereverseLayout
-,viewportSize
- und Ausrichtungseigenschaften, die mit denen vonLazyListLayoutInfo
übereinstimmen (I4f258, b/217917020)ScalingLazyColumn
hat jetzt eineuserScrollEnabled
-Property, die der PropertyLazyList
entspricht (I164d0, b/217912513).- Auswahlfelder haben jetzt standardmäßig einen Farbverlauf oben und unten (Iab92a)
Fehlerkorrekturen
- Wir haben
ScalingLazyColumn
so geändert, dass es nicht mehr den gesamten Platz in seinem übergeordneten Element füllt. Stattdessen wird seine Größe von der Größe seines Inhalts genommen. Das entspricht dem Verhalten vonLazyColumn
. Wenn du das alte Verhalten wiederherstellen möchtest, übergebeModifier.fillMaxWidth()/width()/widthIn()
anScalingLazyColumn
(I51bf8). - Wir haben die Ausnahmemeldung in
SwipeDismissableNavHost.kt
verbessert, die ausgelöst wurde, wenn der Navigations-Backstack leer war. (I1b1dc)
Version 1.0.0-alpha16
9. Februar 2022
androidx.wear.compose:compose-foundation:1.0.0-alpha16
, androidx.wear.compose:compose-material:1.0.0-alpha16
und androidx.wear.compose:compose-navigation:1.0.0-alpha16
wurden veröffentlicht. Version 1.0.0-alpha16 enthält diese Commits.
Neue Funktionen
- Fügen Sie
CircularProgressIndicator
hinzu. Fortschrittsanzeigen geben die Dauer eines Prozesses oder eine nicht angegebene Wartezeit an. Unterstützt im Vollbildmodus eine Lücke (Aussparung) für TimeText oder andere Komponenten. (Iab8da)
API-Änderungen
- Auswahlfelder haben jetzt einen Parameter
flingBehavior
. Mit dem Standardwert werden sie beim Scrollen oder Wischen auf die nächstgelegene Option ausgerichtet. (I09000) - Zusätzliche Ganzzahl-API für Inline-Schieberegler und -Schrittschalter (I1b5d6)
Fehlerkorrekturen
- Der Standardwert für „initialCenterItemIndex“ für die
ScalingLazyListState
wurde von 0 auf 1 geändert. Das bedeutet, dass das zweite Listenelement (Index = 1) bei der Initialisierung in der Mitte des Viewports platziert wird, sofern es nicht bei der Statuserstellung mitScalingLazyListState.rememberScalingLazyListState(initialCenterItemIndex =
)
überschrieben wird. Das erste Element (Index = 0) wird davor platziert. Dies ermöglicht einen besseren standardmäßigen visuellen Effekt, da der Großteil des Darstellungsbereichs mit Listenelementen gefüllt wird. (I0c623, b/217344252) - Wir haben den
ScalingLazyColumn
-StandardwertextraPadding
von 10% auf 5 % reduziert, damit es genügend Listenelemente zum Zeichnen gibt, auch wenn einige davon verkleinert werden. So werden zusätzliche Listenelemente vermieden, die möglicherweise nicht im Darstellungsbereich angezeigt werden. Wenn nicht standardmäßige scalingParams verwendet werden (z. B. eine extremere Skalierung), kann der Entwickler mitviewportVerticalOffsetResolver
zusätzliches Padding anpassen. (I76be4) - Problem mit TimeText in mehreren Zeilen auf einem quadratischen Gerät beheben (Ibd3fb)
- Wir haben
ScalingLazyColumn
so geändert, dass es nicht mehr den gesamten Platz in seinem übergeordneten Element füllt. Stattdessen wird die Größe anhand der Größe des Inhalts ermittelt. Das entspricht dem Verhalten vonLazyColumn
. Wenn Sie das alte Verhalten wiederherstellen möchten, übergeben SieModifier.fillMaxSize()
anScalingLazyColumn
. HINWEIS: Diese Änderung ist unvollständig und wird in einer Folgeänderung im nächsten Alpha-Release behoben. (I3cbfa)
Version 1.0.0-alpha15
26. Januar 2022
androidx.wear.compose:compose-foundation:1.0.0-alpha15
, androidx.wear.compose:compose-material:1.0.0-alpha15
und androidx.wear.compose:compose-navigation:1.0.0-alpha15
werden losgelassen. Version 1.0.0-alpha15 enthält diese Commits.
API-Änderungen
- Wir haben die neue Property
autoCentering
zuScalingLazyColumn
hinzugefügt. Wenn „true“ festgelegt ist (Standardeinstellung), können alle Elemente, einschließlich des ersten und des letzten, so gescrollt werden, dass sie in der Mitte des Listen-Viewports sichtbar sind. Wenn Sie die automatische Zentrierung verwenden, sollten Sie den vertikalen Inhaltsabstand wahrscheinlich auf 0.dp festlegen. Wenn sowohl die automatische Zentrierung als auch vertikale Textabstände vorhanden sind, wird vor dem ersten und nach dem letzten Listenelement zusätzlicher Platz freigegeben, sodass sie noch weiter gescrollt werden können. (I2a282, b/214922490) - Wir haben die Komponente
Dialog
hinzugefügt, mit der jedes Composed-Element ein Vollbilddialogfeld auslösen kann, das über anderen Inhalten angezeigt wird. Wenn das Dialogfeld angezeigt wird, kann es durch Wischen geschlossen werden. Während des Wischens werden die Inhalte des übergeordneten Elements im Hintergrund angezeigt. Der Dialoginhalt mussAlert
oderConfirmation
sein (aus den früheren KomponentenAlertDialog
undConfirmationDialog
umbenannt) –Alert
,Confirmation
undDialog
sind alle imandroidx.wear.compose.material.dialog
-Paket. „Benachrichtigung“ und „Bestätigung“ können als Navigationsziele verwendet werden. Außerdem wurde ColumnScope nach Bedarf den Parametern für Benachrichtigungen und Bestätigungen hinzugefügt. (Ia9014) - Wir haben
onSurfaceVariant2
aus den Material-Designfarben für Compose für Wear OS entfernt und die Verwendungen in der Bibliothek durchonSurfaceVariant
ersetzt. (Icd592) - Es wurde eine Methode hinzugefügt, mit der eine Option im
PickerState
programmatisch ausgewählt werden kann. Die ursprünglich ausgewählte Option kann jetzt auch beim Erstellen einesPickerState
angegeben werden. (I92bdf) - Es ist jetzt möglich, das Wischverhalten der
ScalingLazyColumn
anzupassen. (I1ad2e, b/208842968) - Wir haben
NavController.currentBackStackEntryAsState()
derWear.Compose.Navigation
-Mediathek hinzugefügt. (If9028, b/212739653) Modifier.onRotaryScrollEvent()
undModifier.onPreRotaryScrollEvent()
für Wear-Geräte mit einer drehbaren seitlichen Taste hinzugefügt (I18bf5, b/210748686)
Version 1.0.0-alpha14
12. Januar 2022
androidx.wear.compose:compose-foundation:1.0.0-alpha14
, androidx.wear.compose:compose-material:1.0.0-alpha14
und androidx.wear.compose:compose-navigation:1.0.0-alpha14
werden losgelassen. Version 1.0.0-alpha14 enthält diese Commits.
Neue Funktionen
Wir haben
ScalingLazyListState
eine Reihe von Methoden hinzugefügt, mit denen Entwickler das Scrollen zu bestimmten Listenelementen steuern und das erste Listenelement sowie den Offset festlegen können.Im Rahmen dieser Änderung haben wir auch die ScalingLazyList so geändert, dass sie um den Mittelpunkt des Darstellungsbereichs der ScalingLazyList und nicht um den Anfang des Darstellungsbereichs herum ausgerichtet ist.
Der
ScalingLazyList
-Property wurde die neue PropertyanchorType: ScalingLazyListAnchorType = ScalingLazyListAnchorType.ItemCenter
hinzugefügt, mit der festgelegt werden kann, ob der Mittelpunkt (ScalingLazyListAnchorType.ItemCenter
) oder dieEdge
(ScalingLazyListAnchorType.ItemStart
) an der Mittellinie des Darstellungsbereichs ausgerichtet werden soll.Daher haben sich
ScalingLazyListItemInfo.offset
undScalingLazyListItemInfo.adjustedOffset
geändert und spiegeln jetzt den Versatz des Elements sowohl in Bezug auf die Position des Listenelements als auch auf dieanchorType
der Liste wider. Bei einemScalingLazyColumn
mit eineranchorType
vonItemCenter
und einem Listenelement, das mittig auf der Mittellinie des Darstellungsbereichs positioniert ist, würde der Versatz0
betragen.Die neuen Methoden sind
scrollTo
,animatedScrollTo
,centerItemIndex
undcenterItemOffset
. (I61b61)Wir haben
SwipeDismissableNavHost
einen Handler für die Schaltfläche „Zurück“ hinzugefügt, damit durch Drücken der Rücktaste zur vorherigen Ebene in der Navigationshierarchie gewechselt wird. (I5b086, b/210205624)
Version 1.0.0-alpha13
15. Dezember 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha13
, androidx.wear.compose:compose-material:1.0.0-alpha13
und androidx.wear.compose:compose-navigation:1.0.0-alpha13
wurden veröffentlicht. Version 1.0.0-alpha13 enthält diese Commits.
API-Änderungen
- Wir haben
RangeIcons
intern gemacht (interne Verweise aufInlineSlider
undStepper
). (I927ec)
Fehlerkorrekturen
Es wurde ein Problem behoben, bei dem
SwipeDismissableNavHost
der Erstellungshierarchie ein Ziel hinzugefügt hat, bevor es den LebenszyklusstatusCREATED
erreicht hat, was zu einerIllegalStateException
führte. Diese Korrektur war eine Voraussetzung für die Aktualisierung der Abhängigkeit vonnavigation-compose
auf2.4.0-beta02
und darüber hinaus. (I40a2b, b/207328687)Es wurde eine enum-Klasse „Drawables“ hinzugefügt, um in der Wear Compose-Bibliothek Zeichnen-Ressourcen abzurufen. Die Reflection ist also nicht mehr erforderlich. Dadurch wird ein Fehler behoben, bei dem Bibliothek-Drawables mit
minifyEnabled=true
odershrinkResources=true
entfernt wurden. (Ib2a98)Tests für
Stepper
in Wear Compose hinzugefügt (I2d03a)In der Wear OS-Eingabeleiste wurden Beispiele für
SwipeDismissableNavHost
hinzugefügt. (I85f06)
Version 1.0.0-alpha12
1. Dezember 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha12
, androidx.wear.compose:compose-material:1.0.0-alpha12
und androidx.wear.compose:compose-navigation:1.0.0-alpha12
wurden veröffentlicht. Version 1.0.0-alpha12 enthält diese Commits.
Neue Funktionen
Wir haben die Komponente „Steuerfeld“ hinzugefügt, mit der Nutzer eine Auswahl aus einem Wertebereich treffen können. Stepper ist ein Vollbild-Steuerelement mit Schaltflächen zum Erhöhen und Verringern oben und unten sowie einem Slot in der Mitte (erwartet, dass entweder ein Chip oder ein Text angezeigt wird). Die Schaltflächensymbole können bei Bedarf angepasst werden. (I625fe)
Wir haben zwei neue Composeables zum Anzeigen von Dialogen hinzugefügt: AlertDialog wartet auf eine Antwort des Nutzers und zeigt einen Titel, ein Symbol, eine Nachricht und entweder a) zwei Schaltflächen für einfache positive/negative Auswahlmöglichkeiten oder b) vertikal gestapelte Chips oder Toggle-Chips für flexiblere Auswahlmöglichkeiten an. ConfirmationDialog zeigt eine Bestätigung mit einem Zeitlimit an. Dieses einfache Dialogfeld hat Felder für einen Titel und ein (animiertes) Symbol. (Ic2cf8)
API-Änderungen
- Fügen Sie den vorgeschlagenen Werten für die Dialogdauer Einheiten (Millisekunden) hinzu. (I09b48)
Version 1.0.0-alpha11
17. November 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha11
, androidx.wear.compose:compose-material:1.0.0-alpha11
und androidx.wear.compose:compose-navigation:1.0.0-alpha11
werden losgelassen. Version 1.0.0-alpha11 enthält diese Commits.
Neue Funktionen
- Wir haben eine Auswahlkomponente hinzugefügt, mit der Nutzer ein Element aus einer scrollbaren Liste auswählen können. Standardmäßig wird die Liste der auswählbaren Elemente in beiden Richtungen „unendlich“ wiederholt, um den Eindruck eines von der Seite gesehenen rotierenden Zylinders zu erwecken. In späteren Releases werden zwei Funktionen hinzugefügt: das Anspringen auf einen Wert nach Wischen/Ziehen sowie eine Funktion für PickerState, um den aktuellen Wert festzulegen oder zu scrollen. (I6461b)
API-Änderungen
- Es wurde ein ScalingLazyItemScope und einige neue Modifikatoren (fillParentMaxSize/fillParentMaxWidth/fillParentMaxHeight) hinzugefügt, damit Listenelemente anhand der Größe des übergeordneten Containers skaliert werden können. Elemente können so eingestellt werden, dass sie die gesamte oder einen Teil der Größe des übergeordneten Elements einnehmen. Dadurch werden Funktionen freigeschaltet, die bereits in LazyRow/Column (I4612f) verfügbar sind.
- Unterstützung für ScalingLazyColumn hinzugefügt, damit Elemente einen Schlüssel haben können. Außerdem wurden Convenience-Methoden hinzugefügt, mit denen Elemente aus Arrays und Listen hinzugefügt werden können. (IC1f89)
Fehlerkorrekturen
- Weitere Beispiele für „ZeitText“ (I8cb64)
Version 1.0.0-alpha10
3. November 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha10
, androidx.wear.compose:compose-material:1.0.0-alpha10
und androidx.wear.compose:compose-navigation:1.0.0-alpha10
werden losgelassen. Version 1.0.0-alpha10 enthält diese Commits.
Neue Funktionen
Inline-Schieberegler für Wear Compose hinzugefügt Mit InlineSlider können Nutzer aus einem Wertebereich eine Auswahl treffen. Der Auswahlbereich wird als Balken zwischen dem Mindest- und Höchstwert des Bereichs dargestellt, aus dem Nutzer einen einzelnen Wert auswählen können. (If0148)
Sehen Sie sich das neue Compose for WearOS Codelab an.
API-Änderungen
- Der Makro-Benchmark hat jetzt eine
minSdkVersion
von23
. (If2655)
Fehlerkorrekturen
- Aktualisierung der Übergangsbehandlung in SwipeDismissableNavHost in einem SideEffect (I04994, b/202863359)
- Aktualisierung der Übergangsbehandlung in SwipeDismissableNavHost (I1cbe0, b/202863359)
Version 1.0.0-alpha09
27. Oktober 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha09
, androidx.wear.compose:compose-material:1.0.0-alpha09
und androidx.wear.compose:compose-navigation:1.0.0-alpha09
wurden veröffentlicht. Version 1.0.0-alpha09 enthält diese Commits.
Neue Funktionen
- Wir haben die Entwicklervorschau von Compose für Wear OS veröffentlicht. In unserem Blogpost finden Sie Informationen zu den wichtigsten Compose-Elementen und Links zu weiteren Ressourcen, mit denen Sie sie verwenden können.
API-Änderungen
- Entwickler können jetzt alle Farben im Farbschema des Wear OS-Material Design-Designs anpassen. (I4759b, b/199754668)
Fehlerkorrekturen
- Beispiele für SwipeToDismissBox hinzugefügt, die den Status beibehalten (Ibaffe)
- Es wurden Links zu developer.android.com-Leitfäden von KDocs für CurvedText, TimeText und SwipeToDismissBox hinzugefügt. (I399d4)
- SwipeDismissableNavHost wird jetzt ausgelöst, wenn kein aktuelles Ziel vorhanden ist. Dies bedeutet, dass der NavGraph nicht mit der Dienstprogrammfunktion „wear.compose.navigation.composable“ erstellt wurde. (I91403)
- Zusätzliche Dokumentation und Beispiele für die Verwendung von Zeitquellen in „TimeText“ hinzugefügt (I4f6f0)
Version 1.0.0-alpha08
13. Oktober 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha08
, androidx.wear.compose:compose-material:1.0.0-alpha08
und androidx.wear.compose:compose-navigation:1.0.0-alpha08
wurden veröffentlicht. Version 1.0.0-alpha08 enthält diese Commits.
API-Änderungen
- Die
body
-Attribute „AppCard“ und „TitleCard“ wurden in „content
“ umbenannt und ans Ende der Attributliste verschoben, damit sie als abschließendes Lambda angegeben werden können. Außerdem wurdebodyColor
incontentColor
umbenannt, um mit den neuen Steckplatznamen übereinzustimmen. (I57e78)
Fehlerkorrekturen
- Es wurden Links zu Entwicklerhandbüchern von KDocs für Schaltflächen, Karten, Chips, Themen, Positionsanzeigen und skalierende Lazy Column-Komponenten hinzugefügt. (I22428)
- Problem behoben, bei dem das WearOS-SwipeToDismissBox manchmal Wischbewegungen nicht verarbeitete. (I9387e)
- Es wurden Beispiele für Schaltflächen, kompakte Schaltflächen, Chips, kompakte Chips, App-Karten, Titelkarten, Ein-/Aus-Schaltflächen, Ein-/Aus-Chips und Split-Ein-/Aus-Chips hinzugefügt (Iddc15)
- Es wurden MicroBenchmark-Leistungstests für Karte, Chip, SwitchChip, TimeText und ScalingLazyColumn hinzugefügt. (If2fe9)
Version 1.0.0-alpha07
29. September 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha07
, androidx.wear.compose:compose-material:1.0.0-alpha07
und androidx.wear.compose:compose-navigation:1.0.0-alpha07
werden losgelassen. Version 1.0.0-alpha07 enthält diese Commits.
Neue Funktionen
- In Material wurde eine CurvedText-Komponente hinzugefügt, mit der Entwickler auf einfache Weise gekrümmten Text schreiben können, der der Krümmung eines Kreises folgt (normalerweise am Rand eines runden Bildschirms). (I19593)
API-Änderungen
- Tests für „TimeText“ (Idfead) hinzugefügt
- ArcPaddingValues in eine Benutzeroberfläche umwandeln (Iecd4c)
- Animation für SwipeToDismissBox hinzugefügt (I9ad1b)
- Der SwipeToDismissBox API wurde der Parameter „hasBackground“ hinzugefügt, damit die Wischgeste deaktiviert werden kann, wenn keine Hintergrundinhalte angezeigt werden sollen. (I313d8)
- Für
rememberNavController()
wird jetzt ein optionaler Satz vonNavigator
-Instanzen verwendet, der der zurückgegebenenNavController
hinzugefügt wird, um optionale Navigationselemente wie die aus dem Material zur Navigation für Begleiter besser zu unterstützen. (I4619e) - Verweisen Sie auf „NamedNavArgument“ aus „navigation-common“ und entfernen Sie die Kopie aus „wear.compose.navigation“. (I43af6)
Fehlerkorrekturen
- Das CurvedRow-Testing auf kleineren Geräten wurde korrigiert. (If7941)
- Behoben wurde ein mögliches Flimmern bei „CurvedRow“, wenn sich die Inhalte aktualisieren. Außerdem wird jetzt sichergestellt, dass die gekrümmte Zeile neu vermessen wird (Ie4e06).
- ChipDefaults.gradientBackgroundChipColors() wurde entsprechend den Änderungen an den UX-Spezifikationen aktualisiert. Der Farbverlauf beginnt jetzt mit MaterialTheme.colors.primary mit einem Alphawert von 32,5% und endet mit MaterialTheme.colors.surface mit einem Alphawert von 0% auf einem Hintergrund von MaterialTheme.colors.surface mit einem Alphawert von 75 %. (ID1548)
- Wir haben die Farben für SwitchChips im ausgewählten Zustand aktualisiert, damit sie den neuesten UX-Spezifikationen für Wear Material Design entsprechen. Ausgewählte ToggleChips haben jetzt einen Farbverlauf von MaterialTheme.color.surface mit 0% Alpha oben links zu MaterialTheme.color.primary mit 32% Alpha unten rechts über einem Hintergrund von MaterialTheme.color.surface mit 75% Alpha. Dadurch ist der Unterschied zwischen aktiviert und deaktiviert für den ToggleChip subtiler. (Idd40b)
Version 1.0.0-alpha06
15. September 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha06
, androidx.wear.compose:compose-material:1.0.0-alpha06
und androidx.wear.compose:compose-navigation:1.0.0-alpha06
wurden veröffentlicht. Version 1.0.0-alpha06 enthält diese Commits.
Neue Funktionen
- Wir haben Scaffold als App-Kompositelement der obersten Ebene hinzugefügt. Es bietet eine Struktur für die Positionierung von PositionIndicators (z. B. Scroll- oder Lautstärkesymbole), einen Bereich oben auf dem Bildschirm zum Anzeigen der Uhrzeit und des App-Status und unterstützt auch eine Vignette, um den oberen und unteren Bildschirmrand für scrollbare Inhalte zu verwischen. Der Hauptbereich des Scaffolds ist der Bereich, in dem die Anwendungsinhalte platziert werden. (I5e0bf)
- Implementierung von ZeitText für Wear Compose hinzugefügt (I5654c)
Wear Compose Navigation Library
Wir haben die erste Version der Wear Compose-Navigationsbibliothek hinzugefügt, die eine Integration zwischen den Wear Compose- und AndroidX-Navigationsbibliotheken bietet. Sie bietet eine einfache Möglichkeit, zwischen @Composable-Funktionen als Ziele in Ihrer Anwendung zu wechseln.
Diese erste Version bietet Folgendes:
- Eine
SwipeDismissableNavHost
-Komposition, die einen Navigationsgraphen enthält und die Rückwärtsnavigation über Wischgesten ermöglicht NavGraphBuilder.composable
-Erweiterung zum Erstellen von NavigationsdiagrammenrememberSwipeDismissableNavController()
, um den Status des Hoisting zuzulassen
- Eine
Beispielanwendung, bei der wir zwei Bildschirme erstellen und zwischen ihnen wechseln:
val navController = rememberSwipeDismissableNavController() SwipeDismissableNavHost( navController = navController, startDestination = "start" ) { composable("start") { Column( horizontalAlignment = Alignment.CenterHorizontally, verticalArrangement = Arrangement.Center, modifier = Modifier.fillMaxSize(), ) { Button( navController.navigate("next") }) { Text("Go") } } } composable("next") { Column( horizontalAlignment = Alignment.CenterHorizontally, verticalArrangement = Arrangement.Center, modifier = Modifier.fillMaxSize(), ) { Text("Swipe to go back") } } }
Die Wear Compose-Navigation ist als separate Bibliothek verpackt, damit einfache Wear Compose-Anwendungen, die ihre eigene Navigation implementieren, nicht von der AndroidX Navigation-Bibliothek abhängig sind.
API-Änderungen
SwipeDismissableNavHost
wurde aktualisiert, umrememberSaveable
zu unterstützen. Dazu wurde die Schlüsselidentität für Hintergrund und Inhalt festgelegt (I746fd).- Wir haben einen PositionIndicator-Adapter hinzugefügt, der LazyListState verarbeiten kann (I21b88)
- SwipeToDismissBox wurde aktualisiert, um „rememberSaveable“ zu unterstützen (Ie728b)
- Wir haben der ScalingLazyColumn-Komponente die Unterstützung für reverseLayout hinzugefügt. So können Sie die Scrollrichtung und das Layout umkehren (I9e2fc).
- Verworfene
performGesture
undGestureScope
, die durchperformTouchInput
undTouchInjectionScope
ersetzt wurden. (Ia5f3f, b/190493367) - Wir haben VignetteValue in VignettePosition umbenannt und VignetteValue.Beide in VignettePosition.TopAndBottom umbenannt. (I57ad7)
- Wir haben ScalingLazyColumnState in ScalingLazyListState, ScalingLazyColumnItemInfo in ScalingLazyListItemInfo, ScalingLazyColumnLayoutInfo in ScalingLazyListLayoutInfo und ScalingLazyColumnScope in ScalingLazyListScope umbenannt, für den Fall, dass wir in Zukunft eine ScalingLazyRow-Implementierung hinzufügen. (I22734)
Fehlerkorrekturen
- Die CompactChip-Dokumentation wurde aktualisiert, um zu beschreiben, was passiert, wenn weder ein Symbol noch ein Label angegeben wurde. (I4ba88)
- Wir haben einige Anpassungen an den Wear-Kartenkomponenten vorgenommen. (I6b3d0)
- Der Abstand zwischen Titel und Text wurde von 8 dp auf 2 dp reduziert.
- Die Schriftart der Kopfzeile der Titelkarte wurde von "body" in "title3" geändert.
- Der Farbverlauf des Kartenhintergrunds wurde geändert, damit der Hintergrund dunkler erscheint.
Version 1.0.0-alpha05
1. September 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha05
und androidx.wear.compose:compose-material:1.0.0-alpha05
wurden veröffentlicht. Version 1.0.0-alpha05 enthält diese Commits.
API-Änderungen
- ArcPaddingValues als @Stable kennzeichnen (I57deb)
- ScalingLazyColumnState implementiert jetzt die ScrollableState-Schnittstelle, die Entwicklern programmatischen Zugriff zum Scrollen der Komponente bietet. (I47dbc)
Fehlerkorrekturen
- Wir haben den Abstand zwischen Symbol und Text in Chip und ToggleChip verringert, um sie an die aktualisierten UX-Spezifikationen anzupassen. (I83802)
Version 1.0.0-alpha04
18. August 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha04
und androidx.wear.compose:compose-material:1.0.0-alpha04
wurden veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
Neue Funktionen
- Es wurde eine SwipeToDismissBox und ein wischbarer Modifier hinzugefügt, mit denen eine Wischgeste von links nach rechts unterstützt werden kann. Diese Schaltfläche ist unabhängig von Navigationskomponenten und wird voraussichtlich verwendet, um einen Bildschirm zu verlassen und zu einem anderen zu wechseln. Für die Demo zum Schließen durch Wischen wurden Integrationstests hinzugefügt. (I7bbaa)
- Wir haben der Klasse „ScalingLazyColumnState“ die Schnittstellen „ScalingLazyColumnItemInfo“ und „ScalingLazyColumnLayoutInfo“ hinzugefügt, damit Entwickler die tatsächlichen Positionen und Größen der Elemente in der ScalingLazyColumn nach der Skalierung kennen. Wir haben auch einen Fehler bei der Berechnung der Skalierung bei Anwendung des Inhalts-Paddings „oben“ auf die ScalingLazyColumn behoben. (I27c07)
API-Änderungen
- Fügen Sie die Klasse „CurvedTextStyle“ hinzu, um Optionen für den gebogenen Textstil anzugeben. Ähnlich wie „TextStyle“, unterstützt aber nur „color“, „fontSize“ und „background“. In Zukunft werden weitere Stiloptionen hinzugefügt. (I96ac3)
- Wir haben die Oberflächen ScalingLazyColumnItemInfo und ScalingLazyColumnLayoutInfo zur Klasse „ScalingLazyColumnState“ hinzugefügt, damit Entwickler die tatsächlichen Positionen und Größen von Elementen in der ScalingLazyColumn sehen können, nachdem die Skalierung angewendet wurde. Außerdem wurde ein Fehler bei der Berechnung der Skalierung behoben, wenn auf die ScalingLazyColumn ein Inhaltsabstand „oben“ angewendet wird. (I27c07)
@ExperimentalWearMaterialApi
wurde derSwipeDismissTarget
-Enumeration hinzugefügt, die Teil derSwipeToDismissBox
API ist. (I48b5e)
Fehlerkorrekturen
- Testmaterial für SwipeToDismissBox (I9febc) hinzugefügt
Version 1.0.0-alpha03
4. August 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha03
und androidx.wear.compose:compose-material:1.0.0-alpha03
wurden veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.
API-Änderungen
- Die Komponente „CurvedText“ wurde hinzugefügt, mit der Entwickler ganz einfach Text schreiben können, der der Krümmung eines Kreises folgt (normalerweise am Rand eines kreisförmigen Bildschirms) (Id1267)
- Wir haben
CardDefaults.imageBackgroundPainter()
inCardDefaults.imageWithScrimBackgroundPainter()
umbenannt, um deutlich zu machen, dass über dem Hintergrundbild ein Scrim gezeichnet wird. (I53206) - Die Komponente „ScalingLazyColumn“ wurde hinzugefügt. Sie bietet eine Listenkomponente für Wear OS-Material, die eine Fischaugenansicht bietet, bei der der Listeninhalt in Richtung zum Rand der Komponente hin kleiner und transparenter wird. (I7070c)
Fehlerkorrekturen
- Wir haben die Standardfarbe der appName-Inhalte auf der AppCard als Reaktion auf ein Update der UX-Spezifikationen geändert. Die Standardfarbe für den appName ist jetzt
MaterialTheme.colors.onSurfaceVariant
. Außerdem wurde eine fehlende Parameterbeschreibung für den Titel-Slot hinzugefügt. (Ic4ad1)
Version 1.0.0-alpha02
21. Juli 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha02
und androidx.wear.compose:compose-material:1.0.0-alpha02
werden freigegeben. Version 1.0.0-alpha02 enthält diese Commits.
Neue Funktionen
- Die neue Klasse „CurvedRow“ wurde hinzugefügt, um Elemente in einem Bogen anzuordnen (I29941)
- Es wurde ein neuer Kartentyp für die Verwendung in Anwendungen hinzugefügt (TitleCard). Außerdem wird jetzt unterstützt, dass Karten einen Bildhintergrund haben, um ihren Inhalt hervorzuheben (I53b0f).
API-Änderungen
- Unterstützung für die radiale Ausrichtung für CurvedRow hinzufügen (ähnlich der vertikalen Ausrichtung in einer Zeile) (Id9de5)
- Neue Klasse „CurvedRow“ zum Anordnen von Composeables in einem Bogen hinzufügen (I29941)
- Es wurde ein neuer Kartentyp zur Verwendung in Apps hinzugefügt (TitleCard). Außerdem können Karten als Hintergrund verwendet werden, um den Inhalt von Karten hervorzuheben (I53b0f).
- Wir haben Ein/Aus-Symbole (Kästchen, Schalter und Optionsfelder) zu „SwitchChipDefaults“ hinzugefügt, um Entwicklern die Konfiguration von „UmschaltChip“ und „SplitToggleChips“ zu erleichtern (I7b639).
- Der Abstand für Start- und Endinhalte für Chips wurde aktualisiert: Dieser Wert beträgt konstant 14 dp, unabhängig davon, ob auf dem Chip ein Symbol vorhanden ist oder nicht (zuvor 12 dp, wenn ein Symbol vorhanden war, und 14 dp, wenn nicht). (I34c86)
Fehlerkorrekturen
- Tests für CurvedRow (I93cdb) hinzufügen
- Verknüpfung von Wear Compose-Abhängigkeiten mit Compose 1.0.0-rc01 (Ie6bc9)
- Die Übergabe von Hintergrundbildern in „Karten und Chips“ wurde so geändert, dass das Bild zugeschnitten und nicht gestreckt wird, um die Proportionen des Bildes beizubehalten. (I29b41)
- Es wurden weitere Demos und Integrationstests für Schaltflächen und Ein-/Aus-Schaltflächen hinzugefügt. (5e27ed2)
- Es wurden weitere Chiptests hinzugefügt, um die Inhaltsfarben für „imageBackgroundChips“ abzudecken (Ia9183).
Version 1.0.0-alpha01
1. Juli 2021
androidx.wear.compose:compose-foundation:1.0.0-alpha01
und androidx.wear.compose:compose-material:1.0.0-alpha01
wurden veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Wear Compose ist eine Kotlin-basierte Compose-Bibliothek, die Wear Material Design unterstützt, eine Erweiterung von Material Design für WearOS-Wearables. Diese erste Alphaversion enthält erste funktionale Implementierungen der folgenden Funktionen:
- Materialdesign: Konfiguriert die Farben, Typografie und Formen in den Komponenten dieser Bibliothek einheitlich.
- Chip, CompactChip: Chips sind stadionförmig und es sind Varianten verfügbar, die Symbol-, Label- und sekundäre Labelinhalte aufnehmen.
- – SwitchChip, SplitToggleChip – eine spezielle Art von Chip mit einem Slot für ein zweistufiges Ein/Aus-Symbol, z. B. ein Optionsfeld oder Kästchen. Außerdem hat der SplitToggleChip zwei anklickbare Bereiche, einen anklickbaren und einen auswählbaren.
- Button, CompactButton: Schaltflächen sind kreisförmig und haben einen einzelnen Inhaltsspalt für ein Symbol oder einen minimalen Text (maximal 3 Zeichen).
- ToggleButton: Eine Schaltfläche, mit der eine Aktion aktiviert oder deaktiviert wird, mit einem einzigen Slot für ein Symbol oder einen minimalen Text (maximal 3 Zeichen).
- Karte, App-Karte: Rechteckige Form mit abgerundeten Ecken, mit Slots für Inhalte wie App-Symbol, Uhrzeit, Titel und Text.
In zukünftigen Versionen wird das Widget-Set um Unterstützung für Auswahlelemente, Schieberegler, Listen, Seitenindikatoren, Dialogfelder, Scroll-RSB-Indikatoren, Toasts und mehr von Wear Material Design erweitert.
Darüber hinaus werden andere Wearable-spezifische Funktionen wie gebogene Layouts und Texte sowie ein Gerüst unterstützt, um Entwicklern die Erstellung von Wearable-Apps/-Overlays zu erleichtern.
Wear Compose Material wurde nach den gleichen Prinzipien entwickelt wie das Compose-Material, ist jedoch auf Wearables ausgerichtet. Die Wear Compose Material-Bibliothek sollte anstelle der Compose Material-Bibliothek verwendet werden, wenn Sie eine App für ein Wearable entwickeln.
Die beiden „Material“-Bibliotheken sollten als sich gegenseitig ausschließend betrachtet und nicht in derselben App verwendet werden. Wenn Entwickler die Compose Material Library in ihre Abhängigkeiten aufnehmen, bedeutet das entweder, dass a) in der Wear Compose Material Library Komponenten fehlen. Bitte teilen Sie uns mit, was Sie benötigen, oder b) Sie verwenden eine Komponente, die wir für die Verwendung auf einem Wearable nicht empfehlen.