Wear Compose Material 3
Letzte Aktualisierung | Stabile Version | Releasekandidat | Beta-Release | Alpha-Release |
---|---|---|---|---|
27. August 2025 | 1.5.0 | - | – | - |
Abhängigkeiten deklarieren
Wenn Sie eine Abhängigkeit von Wear hinzufügen möchten, müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.
Fügen Sie der Datei build.gradle
für Ihre App oder Ihr Modul die Abhängigkeiten für die benötigten Artefakte hinzu:
Groovy
dependencies { implementation "androidx.wear.compose:compose-foundation:1.5.0" // For Wear Material Design UX guidelines and specifications implementation "androidx.wear.compose:compose-material3:1.5.0" // For integration between Wear Compose and Androidx Navigation libraries implementation "androidx.wear.compose:compose-navigation:1.5.0" // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0") // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material // or androidx.compose.material:material. // androidx.wear.compose:compose-material3 is designed as a replacement, // not an addition, to both of these other libraries. // If there are features from that you feel are missing from // androidx.wear.compose:compose-material3, please raise a bug to let us know. }
Kotlin
dependencies { implementation("androidx.wear.compose:compose-foundation:1.5.0") // For Wear Material Design UX guidelines and specifications implementation("androidx.wear.compose:compose-material3:1.5.0") // For integration between Wear Compose and Androidx Navigation libraries implementation("androidx.wear.compose:compose-navigation:1.5.0") // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0") // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material // or androidx.compose.material:material. // androidx.wear.compose:compose-material3 is designed as a replacement, // not an addition, to both of these other libraries. // If there are features from that you feel are missing from // androidx.wear.compose:compose-material3, 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. Lassen Sie es uns wissen, wenn Sie neue Probleme entdecken oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können für ein vorhandenes Problem abstimmen, indem Sie auf die Schaltfläche mit dem Stern klicken.
Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.
Wear Compose Material3 Version 1.5
Version 1.5.0
27. August 2025
androidx.wear.compose:compose-*:1.5.0
wird veröffentlicht. Version 1.5.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.4.0
Erste Version der Wear Compose Material 3-Bibliothek, die das neue Material 3 Expressive-Designsystem unterstützt. Diese Version enthält:
- Aktualisiertes
MaterialTheme
und dynamische Farbgestaltung. - Neue Komponenten
AppScaffold, ScreenScaffold
,HorizontalPagerScaffold
undVerticalPagerScaffold
zum Festlegen der Struktur des Bildschirms und zum Koordinieren vonScrollIndicator
-,TimeText
-,HorizontalPageIndicator
- undVerticalPageIndicator
-Animationen. - Form-Morphing
IconButton
,TextButton
,IconToggleButton
undTextToggleButton
mit Variationen, die animiert werden, wenn sie gedrückt oder aktiviert werden. EdgeButton
, die eine spezielle Form für den unteren Bildschirmrand hat.ButtonGroup
implementiert eine ausdrucksstarke Gruppe von Schaltflächen in einer Reihe, deren Form sich bei Berührung ändert.AlertDialog
undConfirmationDialog
mit Variationen für zusätzliche Dialoginhalte.TimePicker
- undDatePicker
-Komponenten.- Zu den Fortschrittsindikatoren gehören
CircularProgressIndicator
(mit segmentierter Variation),ArcProgressIndicator
undLinearProgressIndicator
.
Außerdem enthält Wear Compose Foundation 1.5.0 Folgendes:
TransformingLazyColumn
: Eine vertikal scrollende Liste, die das Skalieren und Morphen von Animationen unterstützt.- Unterstützung für die Paginierung in Wear Compose Foundation mit
HorizontalPager
undVerticalPager
. - Hierarchische Fokusgruppen: Damit werden Composables in einer Anwendung annotiert, um den aktiven Teil der Komposition im Blick zu behalten und den Fokus zu koordinieren.
Weitere Informationen zu Material 3 Expressive für Wear OS
Version 1.5.0-rc02
13. August 2025
androidx.wear.compose:compose-*:1.5.0-rc02
wird veröffentlicht. Version 1.5.0-rc02 enthält diese Commits.
Fehlerkorrekturen
- Ein Fehler in
TimePicker
wurde behoben, durch den lange, internationalisierte Strings für den Zeitraum (AM/PM) das Layout beschädigen konnten. (I0fa81)
Version 1.5.0-rc01
30. Juli 2025
androidx.wear.compose:compose-*:1.5.0-rc01
wird veröffentlicht. Version 1.5.0-rc01 enthält diese Commits.
Fehlerkorrekturen
TimePicker
wird jetzt vollständig durch das Gebietsschema des Nutzers bestimmt. Die Reihenfolge und der Inhalt der Auswahlfelder und Trennzeichen werden durchDateFormat.getBestDateTimePattern
festgelegt. Dadurch wird die falsche Spaltenreihenfolge für CJK-Sprachen korrigiert, Probleme mit dem RTL-Layout in Sprachen wie Arabisch werden behoben, lokalisierte Trennzeichen werden verwendet und sowohl das 0-11- als auch das 1-12-Stundenformat werden je nach Gebietsschema unterstützt (I5d543).- In einigen Gebietsschemas, z. B. CJK, wird für
DatePicker
jetzt ein numerischer Monat angezeigt, um eine Mischung aus numerischen und sprachlichen Formaten zu vermeiden (z. B. 2025 | 07 | 02 anstelle von 2025 | 7月 | 02). Bei dieser Änderung wird eine Heuristik angewendet, mit der geprüft wird, ob für das Jahr sprachliche Suffixe verwendet werden. Wenn dies der Fall ist, wird das Monatsformat zur besseren Konsistenz von Text (MMM) zu numerisch (MM) geändert. (Ia93fe) - Der vertikale Platz für die Überschrift in der Picker-Komponente ist jetzt konstant. Dadurch wird ein sichtbares Verschieben verhindert, wenn eine Picker-Spalte ausgewählt wird, insbesondere im
Talkback
-Modus. (I7f8b7) - Es wurde ein Bedienungshilfenfehler behoben, der dadurch verursacht wurde, dass
HorizontalPageIndicator
undVerticalPageIndicator
im Vollbildmodus dargestellt wurden. Die Seitenindikatoren sind nicht mehr im Vollbildmodus und werden automatisch positioniert, wenn sie mitHorizontalPagerScaffold
oderVerticalPagerScaffold
verwendet werden. Wenn Sie kein Pager-Scaffold verwenden, geben Sie die Ausrichtung explizit mitmodifier = Modifier.align(Alignment.BottomCenter)
undHorizontalPageIndicator
sowiemodifier =Modifier.align(Alignment.CenterEnd)
undVerticalPageIndicator
an. (I3a0ad) - Die Wischrichtung in
SwipeToReveal
ist jetzt sowohl für LTR- als auch für RTL-LayoutDirections
einheitlich. (I6d427) - Die vertikale Zentrierung für Aktionen wurde wieder eingeführt.
SwipeToReveal
WennhasPartiallyRevealedState = true
, sollteRevealState
vom Aufrufer aufRevealValue.Covered
zurückgesetzt werden, wenn gescrollt wird. (I6473d) SwipeDismissableNavHost
schneidet Inhalte für API 36 und höher jetzt korrekt zu. (Ib9a44)
Version 1.5.0-beta06
16. Juli 2025
androidx.wear.compose:compose-*:1.5.0-beta06
wird veröffentlicht. Version 1.5.0-beta06 enthält diese Commits.
Fehlerkorrekturen
- Problem mit der
EdgeButton
-Animation behoben, wennLazyColumn
oderScalingLazyColumn
reverseLayout = true
haben. (I46a1a) - Es wurde ein Fehler in
ScreenScaffold
behoben, durch den die Funktion „Tippen & Entdecken“ in TalkBack nicht funktionierte, wenn einScrollIndicator/PageIndicator
angegeben wurde. (I6dcee) TransformingLazyColumn
ermöglicht jetzt benutzerdefiniertes Morphen ausTransformationSpec
, indem der vonTransformationSpec
im Hintergrund-Painter bereitgestellteitemHeight
-Wert gelesen wird. (I6a599)- Animierte Farbwechsel für
IconButton
aktiviert/deaktiviert, um mitIconToggleButton
übereinzustimmen. (Ife10a) - Die Mindestbegrenzung für Abschnitte in
CircularProgressIndicator
wurde entfernt, um einen deutlichen Sprung zur Mindestpunktgröße bei der Animation zu vermeiden. Im Rahmen dieser Änderung wird der ParametertargetProgress
indrawCircularProgressIndicator
nicht mehr verwendet. (I33309) - Die Auswahl hat jetzt die semantische Rolle
ValuePicker
, die von Screenreadern verwendet werden kann, um die Barrierefreiheit von Auswahlen zu verbessern. Die Auswahl hat auch aktualisierte Barrierefreiheitslabels für Klicks, die zwischen dem Anpassen des Werts im schreibgeschützten Modus und dem Auswählen des aktuellen Werts unterscheiden. (I33309)
Version 1.5.0-beta05
2. Juli 2025
androidx.wear.compose:compose-*:1.5.0-beta05
wird veröffentlicht. Version 1.5.0-beta05 enthält diese Commits.
Fehlerkorrekturen
- Die Dokumentation wurde aktualisiert, um die Verwendung von
Modifier.edgeSwipeToDismiss
zu verdeutlichen (I78cb5). - Es wurde ein Fehler behoben, bei dem in Lazy Lists mit
SwipeToReveal
mehrere aufgedeckte Elemente angezeigt werden konnten (I1d4f6). - Containerformen in
TransformingLazyColumn
werden jetzt skaliert, um zu verhindern, dass Inhalte abgeschnitten werden. (I9221a) - Das Label
TimePicker
undDatePicker
für Stunde/Minute/Sekunde oder Jahr/Monat/Tag hat jetzt eine Überschriftensemantik für Screenreader (I77d8b). - Die Pause zwischen Schleifen im unbestimmten
CircularProgressIndicator
(Iaf0bb) wurde entfernt. - Ein Animationsfehler in
TransformingLazyColumn
beim Entfernen von Elementen wurde behoben. (I73034) - Die Verarbeitung von Anker-Elementen in
TransformingLazyColumn
wurde korrigiert, wenn Elemente entfernt werden. (I841a8) - In
PickerGroup
werden die Auswahlfelder jetzt horizontal animiert, wenn die automatische Zentrierung aktiviert ist und das ausgewählte (zentrierte) Auswahlfeld geändert wird. (Ic82c4)
Version 1.5.0-beta04
18. Juni 2025
androidx.wear.compose:compose-*:1.5.0-beta04
wird veröffentlicht. Version 1.5.0-beta04 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Layoutfehler in
TransformingLazyColumn
behoben. Inhalte, die auf den Bildschirm passen, werden jetzt korrekt oben auf dem Bildschirm ausgerichtet (I80115). - Ein Problem mit
TransformingLazyColumn
wurde behoben. Das untere Element wurde beim Scrollen zum Ende einer Liste mit einemEdgeButton
falsch skaliert. Der Scrollfortschritt folgt jetzt einem Gradientenabstieg, wenn das Layout wiederhergestellt wird. (Iea375) TransformingLazyColumn
liest jetzt die Höhe des Elements im Hintergrund-Painter, sodass benutzerdefinierteTransformationSpecs
das Morphen implementieren können. (I022f0)SwipeToReveal
zentriert die angezeigten Aktionen jetzt vertikal. (I4419b)- Ein Fehler in
SwipeToReveal
wurde behoben, der verhinderte, dass die Funktion bei Verwendung von Ansichten und Compose auf dem Bildschirm richtig mit „Wischen zum Schließen“ funktionierte. (I5dc0e) - Ein Fehler wurde behoben, bei dem
SwipeToReveal
-Aktionen beim Scrollen mit einem vertikalen Offset gezeichnet wurden. (I29444) AlertDialog
,ConfirmationDialog
,OpenOnPhoneDialog
undSwipeToReveal
runden jetzt Abstände und Größen auf, die als Prozentsatz der Displaygröße berechnet werden. (I76367)ButtonDefaults.outlinedButtonBorder
wird jetzt nach Änderungen des aktivierten/deaktivierten Status aktualisiert size(If2ddd)- Ein Fehler in der
EdgeButton
-Höhe wurde behoben, der auf komplexen Bildschirmen mit Pager undScreenScaffold
aufgetreten ist. (I946e3) - Eine Race-Bedingung wurde behoben, die dazu führen konnte, dass Platzhalteranimationen angehalten wurden. (I53530)
- Die Leistung von
HorizontalPageIndicator
undVerticalPageIndicator
wurde durch das Zeichnen auf Canvas verbessert. (Ifae1e) - Die Form von EdgeButton wurde optimiert, um die Übergänge zwischen den Auslassungspunkten und Kreisen, aus denen der Umriss besteht, zu glätten. (I7721e)
- Ein Fehler in
LevelIndicator
wurde behoben, der dazu führte, dass Animationen aufgrund unnötiger Neuzusammenstellungen angehalten wurden. (I45d08)
Version 1.5.0-beta03
4. Juni 2025
androidx.wear.compose:compose-*:1.5.0-beta03
wird veröffentlicht. Version 1.5.0-beta03 enthält diese Commits.
API-Änderungen
OpenOnPhoneDialog
gibt jetzt nur noch den Nachrichtentext unter TalkBack aus und überspringt die Symbolsemantik. DieOpenOnPhoneDialogDefaults
wurden aktualisiert, um den ParametericonContentDescription
undcontentDescription
ausicon()
zu entfernen. Außerdem hatConfirmationDialogDefaults
jetzt Modifikatorparameter für die ComposablesSuccessIcon
undFailureIcon
. (Id2ae2)
Fehlerkorrekturen
- Die Reihenfolge, in der wir die Auswirkungen von
SurfaceTransformation
-Parametern berücksichtigen, wurde geändert. Bisher wurden die Transformationen, die auf Wear Material3-Komponenten angewendet wurden, so ausgeführt: Hintergrund-Painter, Container-Transformation, Inhalts-Transformation. Die ersten beiden werden jetzt invertiert und wir wenden den übergebenen Modifier dazwischen an. Er ist also von Containertransformationen betroffen. Damit werden Fälle behoben, in denen ein Platzhalter-Shimmereffekt mit Elementen in einem TLC mit dem Transformationsparameter verwendet wird. (I786cf) RevealState.Saver
wurde hinzugefügt, um den Status vonSwipeToReveal
wiederherzustellen, wenn die Aktivität oder der Prozess neu erstellt wird. Die FunktionrememberRevealState
verwendet diesen Saver jetzt standardmäßig. (Ie0ecb)- Die Schaltflächen für primäre und sekundäre Aktionen sollten standardmäßig
ButtonDefault.Height
sein (ein Fehler wurde behoben, bei dem diese die maximale Höhe für höhere Schaltflächen einnahmen).SwipeToReveal
(Ibfba1) SwipeToReveal
wurde geändert, um die letzte interagierte Komponente zurückzusetzen, wenn die Wischgeste nach rechts ausgeführt wird. (Ia8450)SwipeToReveal
wurde geändert, sodass der StatusRevealing
festgelegt wird, wenn sich die Endposition des Wischvorgangs zwischen den Ankern „Aufdecken“ und „Aufgedeckt“ befindet und näher am Anker „Aufdecken“ liegt. (If4458)- Der Inhalt von
ButtonGroup
wird jetzt in einem RTL-Layout (Ib378d) korrekt invertiert. AnimatedText
unterstützt jetzt die RTL-Textrichtung (I4533c).TransformingLazyColumn
– Die Größe von Elementen wird jetzt richtig angepasst, wenn das untere Element entfernt wird (Idacab).TransformingLazyColumn
führt jetzt nur noch einen Messdurchgang durch, was die Leistung verbessert, da die Frame-Zeiten verkürzt werden. (I501a1)
Version 1.5.0-beta02
20. Mai 2025
androidx.wear.compose:compose-*:1.5.0-beta02
wird veröffentlicht. Version 1.5.0-beta02 enthält diese Commits.
Fehlerkorrekturen
- Aktualisierte Baseline-Profile für Foundation-, Material- und Material3-Bibliotheken. (I53f06)
- Ein Fehler in
TransformingLazyColumn
wurde behoben, durch den die Größe von Elementen geändert wurde, wenn das untere Element entfernt wurde. (Idacab) - Ein Fehler mit
TransformingLazyColumn
wurde behoben, bei dem die Liste oben oder unten hängen blieb. (I49d00) OpenOnPhoneDialog
sollte unter TalkBack den gekrümmten Text und nicht die Beschreibung des Symbols vorlesen. (I4efe8)- Ein Fehler in
SwipeToReveal
wurde behoben, durch den der falsche Anker inRevealState.currentValue
gemeldet wurde, wennhasPartiallyRevealedState
auf „false“ gesetzt war. (I9c7cf) SwipeToReveal
-Rückgängig-Schaltflächen sind jetzt standardmäßigButtonDefaults.Height
. (I1f6c8)- Die Leistung von
BasicSwipeToDismissBox
wurde verbessert, indem die Verwendung von Canvas zum Zeichnen von Scrims eingestellt wurde. (I68f2c) - Ein Barrierefreiheitsproblem im Schieberegler wurde behoben. Die angekündigte Prozentzahl stimmte nach Aktualisierungen nicht mit dem Wert überein (I91146).
- Ein Fehler bei der Implementierung von
placeholderShimmer
wurde behoben. (Iee39b - Die Leistung von
TransformingLazyColumn
wurde verbessert, indem die Berechnung vonScrollProgress
um 30 % optimiert wurde. (I4c4cb)
Version 1.5.0-beta01
7. Mai 2025
androidx.wear.compose:compose-*:1.5.0-beta01
wird veröffentlicht. Version 1.5.0-beta01 enthält diese Commits.
Mit der Version 1.5.0-beta01 von Compose für Wear OS wird angezeigt, dass diese Version der Bibliothek alle Funktionen enthält und die API gesperrt ist (sofern nicht als experimentell gekennzeichnet).
Wear Compose 1.5.0-beta01 enthält die Wear Compose Material3-Bibliothek, die das neue UI-Designsystem namens Material 3 Expressive unterstützt. Es wird empfohlen, von Material auf Material3 zu aktualisieren, um das neue visuelle Design in Apps zu nutzen und von den neuen Komponenten zu profitieren:
MaterialTheme
für aktualisierte und erweiterte Farbschemas, Typografie und Formen, um Ihren Designs Tiefe und Vielfalt zu verleihen.- Dynamisches Farbdesign, bei dem automatisch ein Farbschema für Ihre App generiert wird, das den Farben des Zifferblatts entspricht.
- Neue Komponenten passen sich standardmäßig automatisch an größere Bildschirmgrößen an.
- Form-Morphing: Runde Schaltflächenkomponenten wie
IconButton
,TextButton
,IconToggleButton
undTextToggleButton
unterstützen Varianten, die animiert werden, wenn sie gedrückt oder aktiviert werden. EdgeButton
: Eine neue Schaltfläche, die sich an den Bildschirmrand anpasst und eine spezielle Form für den unteren Bildschirmbereich hat.- Scaffolds: Mit
AppScaffold
undScreenScaffold
wird die Struktur des Bildschirms festgelegt und die Animationen vonScrollIndicator
undTimeText
werden koordiniert. - Schaltflächen: Es werden zahlreiche stadionförmige Schaltflächen mit flexiblen Containern mit einem Slot und Varianten mit mehreren Slots für Schaltflächen mit Symbolen und Labels unterstützt.
CheckboxButton
undSwitchButton
werden bereitgestellt, wenn Ein/Aus-Schaltflächen erforderlich sind.RadioButton
ist die verfügbare Auswahl-Schaltfläche. Es gibt auch „Split“-Varianten der Ein/Aus- und Auswahl-Schaltflächen. ButtonGroup
– implementiert eine ausdrucksstarke Gruppe von Schaltflächen in einer Reihe, die sich bei Berührung morphingartig verändern.AlertDialog
-Varianten unterstützen die Schaltflächen „Ok“/„Abbrechen“ oder einEdgeButton
.- Mit
ConfirmationDialog
kann eine Nachricht mit einem Zeitlimit angezeigt werden. Dabei werden spezielle Animationen für Erfolg, Fehler und „Auf Smartphone öffnen“-Varianten unterstützt. - Auswahlfelder: Die Varianten
TimePicker
undDatePicker
werden unterstützt. Außerdem können Sie die Komponenten „Auswahlfeld“ undPickerGroup
verwenden, um eigene Auswahlbildschirme zu erstellen. ProgressIndicators
– es werden kreisförmige und lineare Fortschrittsanzeigen unterstützt (CircularProgressIndicator
hat segmentierte und unbestimmte Varianten).- Karten: Es sind verschiedene Kartenvarianten verfügbar, darunter
TitleCard
, das spezielle Layouts für Karten mit Titel, Zeit, Untertitel oder Inhalts-Slots bietet.TitleCard
kann auch einen Bildhintergrund erhalten, um die Bedeutung der Informationen auf einer Karte zu unterstreichen. - Pager: Die Komponenten
HorizontalPagerScaffold
,VerticalPagerScaffold
undAnimatedPage
koordinierenHorizontalPageIndicator
- undVerticalPagerIndicator
-Animationen.HorizontalPager
undVerticalPager
werden in der Wear Compose Foundation-Bibliothek veröffentlicht. - Platzhalter: Es wird eine Skelettform über eine Komponente gezeichnet, wenn keine vorläufigen Inhalte verfügbar sind.
- Schieberegler und Stepper: Mit beiden können Nutzer eine Auswahl aus einem Wertebereich treffen. Schieberegler sind kompakter und können segmentiert werden. Der Stepper ist eine Vollbildkomponente, die in der Regel mit einem
StepperLevelIndicator
kombiniert wird. SwipeToReveal
: Hiermit werden einem Composable zusätzliche Aktionen hinzugefügt, wenn es von rechts nach links gewischt wird.
Außerdem enthält Wear Compose Foundation 1.5.0-beta01 die folgenden neuen Komponenten:
TransformingLazyColumn
: Eine träge, vertikal scrollende Liste, die Skalierungs- und Morphing-Animationen unterstützt.- Hierarchische Fokusgruppen: Damit werden Composables in einer Anwendung annotiert, um den aktiven Teil der Komposition im Blick zu behalten und den Fokus zu koordinieren.
- Pager: Die Komponenten
HorizontalPager
undVerticalPager
basieren auf den Compose Foundation-Komponenten und wurden mit Wear-spezifischen Verbesserungen versehen, um die Leistung zu optimieren und die Wear OS-Richtlinien einzuhalten.
API-Änderungen
- Die Hierarchical Focus API wurde aktualisiert:
Modifier.hierarchicalFocus
wurde inModifier.hierarchicalFocusGroup
umbenannt und der Callback-Parameter wurde entfernt. Die Überladung vonModifier.hierarchicalFocusRequester
mit einemFocusRequester
-Parameter wurde entfernt. Es wurde ein neuesCompositionLocal
,LocalScreenIsActive
erstellt, damit Komponenten informieren und prüfen können, welcher Bildschirm der aktive ist. (I5ff7c). - Die
SwipeToReveal
-Funktion aus Wear Compose Foundation wurde zugunsten vonSwipeToReveal
-APIs in Wear Compose Material und Wear Compose Material3 eingestellt. Ersetzen Sie Wear Foundation-ImporteSwipeToReveal
durch Wear Compose Material- oder Wear Compose Material3-Importe, um die APIs weiterhin verwenden zu können. (Ia147d). - Die Wear Compose Material3-Abhängigkeiten von Foundation wurden in das Paket „material3“ verschoben, z.B.
RevealValue
,RevealDirection
,RevealActionType
,RevealState
,rememberRevealState
.SwipeToReveal
Entwickler sollten ihre Importe dieser Klassen und Funktionen vonandroidx.wear.compose.foundation
zuandroidx.wear.compose.material3
ändern. (I640e6) - Die Wear Compose Material3-API
SwipeToReveal
wurde aktualisiert: Der zusammensetzbaren FunktionSwipeToReveal
wurden die ParameterprimaryAction
,onFullSwipe
,secondaryAction
,undoPrimaryAction
,undoSecondaryAction
undhasPartiallyRevealedState
hinzugefügt. Die Möglichkeit,positionalThreshold
undanimationSpec
überRevealState
anzupassen, wurde entfernt.lastActionType
,revealThreshold
und die Breite wurden ausRevealState
entfernt. DerRevealState
-Konstruktor akzeptiert jetztRevealDirection
anstelle von Ankern. Die FunktionencreateRevealAnchors
, Anker undbidirectionalAnchors
wurden entfernt. DieSwipeToRevealScope
-FunktionenprimaryAction
,secondaryAction
,undoPrimaryAction
undundoSecondaryAction
wurden inPrimaryActionButton
,SecondaryActionButton
undUndoActionButton
umbenannt und in zusammensetzbare Funktionen umgewandelt.RevealActionType
wurde als intern gekennzeichnet. (I885d0) - Die
SwipeToReveal
API wurde weiter aktualisiert:onFullSwipe
wurde inonSwipePrimaryAction
umbenannt,SwipeToRevealNonAnchoredSample
wurde umbenannt, um die Verwendung des ParametershasPartiallyRevealedState
anzugeben,actionButtonHeight
wurde entfernt, da die Standardhöhe die Standardhöhe der Schaltfläche ist und die größere Höhe mit einem Modifikator festgelegt werden kann,SmallActionButtonHeight
wurde ausSwipeToRevealDefaults
entfernt und der Wertparameter in den KonstruktorenRevealValue
undRevealDirection
wurde privat gemacht. (I465ce)
Fehlerkorrekturen
- Die Verarbeitung von
ScreenScaffold
-EdgeButton
wurde korrigiert, sodass dieEdgeButton
nach dem Entfernen einesTransformingLazyColumn
-Elements animiert wird. (I6d366). - Die Wear Compose-Abhängigkeiten von Compose-Bibliotheken wurden auf Version 1.8.0 aktualisiert. (I2ef3f).
- Die Bewegung des unbestimmten
CircularProgressIndicator
wurde aktualisiert, sodass sie nicht mehr vorübergehend zurückgesetzt wird. (Ieddb1). - Ein
SwipeDismissableNavHost
-Fehler wurde behoben: Der Fokus wurde nach dem Zurückwischen nicht richtig gewechselt, was dazu führte, dass die Dreheingabe fehlschlug (dies betraf API 36+, die die Funktion „Vorhersagbarer Zurück-Vorgang“ verwendet). (Ieddb1). - Geänderte Dokumentation für die Hierarchical Focus API (Idf2ff).
- Die Dokumentation für Schaltflächen und Karten wurde aktualisiert, um zu verdeutlichen, wie
containerPainter
unddisabledContainerPainter
containerColor
unddisabledContainerColor
überschreiben (I4a453). - Eine Änderung an
TimeText
in der vorherigen Version, bei derBroadcastReceiver
in einen Worker-Thread verschoben wurde, wurde rückgängig gemacht, da sie Probleme für Apps verursacht hat, die ihr eigenes Threading während der Navigation verwalten. (I34d02). - Die Picker-Beispiele wurden aktualisiert, um unnötige „remember“-Aufrufe zu entfernen und stattdessen
rememberUpdatedState
in Picker zu verwenden, um sich die letztecontentDescription
-Lambda-Funktion zu merken. (Icb5b1). - Die Textstile in
TimePicker
undDatePicker
wurden aktualisiert, sodass Schriftartänderungen nicht mehr zu einer Kürzung führen. (I26194). - Bei
ListHeader
undListSubHeader
ist die Textausrichtung jetzt standardmäßig zentriert bzw. am Anfang ausgerichtet. (I78339) - Die Beispiele und Demos für Foundation und Material Swipe to Reveal wurden aktualisiert, um benutzerdefinierte Barrierefreiheitsaktionen anzukündigen. Die benutzerdefinierten Aktionen müssen als Semantik für den Inhalt und nicht für die
SwipeToReveal
-Composable-Funktion selbst hinzugefügt werden. (Ie92a3). - Der Standardwert für
MaxLines
fürEdgeButton
-Inhalte wurde entsprechend der Größe aktualisiert: Er ist jetzt 1 für sehr kleine, 2 für kleine und mittelgroße und 3 für große Inhalte. (Ie35f6) LocalReduceMotion
wurde vereinfacht, sodass der Observer nur einmal registriert wird, um die Leistung zu verbessern. (Ib1979)- Die Anzahl der Neuzeichnungen in
ScrollIndicator
wurde minimiert, um die Leistung zu verbessern. (Ia7a67). - Ein Fehler in
TransformingLazyColumn
wurde behoben, bei dem das oberste sichtbare Element in der Liste nicht richtig skaliert wurde, wenn EdgeButton seine volle Höhe erreichte. (I30580).
Wear Compose Material3 Version 1.0
Version 1.0.0-alpha37
23. April 2025
androidx.wear.compose:compose-material3:1.0.0-alpha37
wird veröffentlicht. Version 1.0.0-alpha37 enthält diese Commits.
API-Änderungen
scrollTransform
wurde aus der öffentlichen API entfernt. Verwenden Sie die Kombination der ModifizierertransformedHeight
undgraphicsLayer
, wenn Sie dieselbe Funktionalität benötigen. (Ie181d)- Die Composables
ImageButton
undImageCard
wurden durch die ÜberladungenButton
undCard/TitleCard
ersetzt.imageButtonColors
wurde inbuttonWithContainerPainterColors
undimageCardColors
incardWithContainerPainterColors
umbenannt. ÖffentlicheButtonDefaults.scrimBrush
undCardDefaults.scrimBrush
hinzugefügt. Die SchaltflächenimageBackgroundGradientStartColor
undimageBackgroundGradientEndColor
wurden inscrimGradientStartColor
undscrimGradientEndColor
umbenannt.CardDefaults.ImageContentPadding
wurde inCardDefaults.CardWithContainerPainterContentPadding
umbenannt (I7b8b6) Picker
undPickerGroup
verwenden jetztcontentDescription
als Lambda, um unnötige Neuzusammenstellungen zu vermeiden. (I002dd)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem das unbestimmte
CircularProgressIndicator
während der Animation wackelte, wenn die Breite nicht der Höhe entsprach. (I76bfe) - Ein Problem mit dem Layout von Edge-Schaltflächen bei ungültiger Größe wurde behoben. Das Aktualisieren des Layouts der Edge-Schaltfläche wird jetzt verhindert, wenn die Höhe „NaN“ ist. (I32b93)
- Der maximale Schwenkwinkel in
OpenOnPhoneDialog
wurde erhöht, damit der Standardtext „Auf dem Smartphone nachsehen“ bei der größten Schriftgröße nicht abgeschnitten wird. (I90af9)
Version 1.0.0-alpha36
9. April 2025
androidx.wear.compose:compose-material3:1.0.0-alpha36
wird veröffentlicht. Version 1.0.0-alpha36 enthält diese Commits.
API-Änderungen
ButtonDefaults.imageBackgroundButtonColors
wurde durchImageButton
,ButtonDefaults.imageButtonColors
,ButtonDefaults.containerPainter
undButtonDefaults.disabledContainerPainter
ersetzt. Ähnliche Änderungen gelten für die Karte. Die Maler werden ausButtonColors
undCardColors
entfernt. (I8c6a1)- Platzhalter wurden aktualisiert, um die API zu vereinfachen. Wir bieten jetzt zwei Modifikatoren an:
Modifier.placeholderShimmer
, um einen Schimmereffekt auf Komponentenebene anzuwenden, undModifier.placeholder
, um eine Maske auf nicht geladene Inhalte anzuwenden (Iaee7a).
Fehlerkorrekturen
- Overscroll in
ScrollIndicator
integriert. (Icfb7f) - Es wurde ein Problem mit leeren Hintergründen und fehlenden Dialogfeldern beim Starten von Material 3-Dialogfeldern behoben. (Ice597)
- Probleme in
FadingExpandingLabel
wurden behoben, wenn sich Text über mehrere Zeilen erstreckt. (I04eb7) - Der Abstand zwischen primären und sekundären Labels auf Schaltflächen wurde aktualisiert. (I99b7b)
ArcLarge
wurde von20sp
auf18sp
reduziert und die Buchstabenabstände beiArcLarge
undArcSmall
wurden aktualisiert.ConfirmationDialog
/OpenOnPhoneDialog
verwenden jetzt den StandardwertArcLarge
, anstatt ihn mit18sp
zu überschreiben. (Id39a8)
Abhängigkeitsupdates
- Diese Bibliothek ist jetzt auf das Kotlin 2.0-Sprachniveau ausgerichtet und erfordert KGP 2.0.0 oder höher. (Idb6b5)
Version 1.0.0-alpha35
26. März 2025
androidx.wear.compose:compose-material3:1.0.0-alpha35
wird veröffentlicht. Version 1.0.0-alpha35 enthält diese Commits.
API-Änderungen
- Die obere
AlertDialog
-Auffüllung wird jetzt standardmäßig reduziert, wenn ein Symbol angegeben ist. So wird die verfügbare Bildschirmgröße optimal genutzt. (Ief06c) PagerScaffoldDefaults.FadeOutAnimation
wurde inPagerScaffoldDefaults.FadeOutAnimationSpec
umbenannt. Der Seitenparameter aufAnimatedPage
wurde inpageIndex
umbenannt. (I701f2)- Die Benennung für die Aufteilung von
TransformingLazyColumn
inSurfaceTransformation
undapplyTransformation
wurde inapplyContainerTransformation
undapplyContentTransformation
geändert. Außerdem wurdecreateBackgroundPainter
increateContainerPainter
umbenannt. Weitere Namensänderungen fürTransformationSpec
undResponsiveTransformationSpec
. (I1c534) AppScaffold backgroundColor
wurde incontainerColor
umbenannt. (I4e63f)
Fehlerkorrekturen
- Ein Problem in
FadingExpandingLabel
wurde behoben, bei dem der Text nicht immer richtig erweitert wurde. (I0e773) ArcLarge
wurde von 20 sp auf 18 sp reduziert und die Buchstabenabstände beiArcLarge
undArcSmall
wurden aktualisiert. FürConfirmationDialog/OpenOnPhoneDialog
wird jetzt die StandardeinstellungArcLarge
verwendet, anstatt sie auf 18 sp zu überschreiben. (Id39a8)- Die Überschriftenanimation für
DatePicker
undTimePicker
wurde aktualisiert, sodass die Ein- und Ausblendanimation als eine federnde Animation ausgeführt wird. (I68963) PagerScaffold
optimiert, indem das Lesen voncurrentPageOffsetFraction
in der zusammensetzbaren FunktionAnimatedPage
vermieden wird. (I433ef)- Alle Typenskalen wurden so aktualisiert, dass standardmäßig proportionale Ziffern verwendet werden. Das ist der häufigste Anwendungsfall. Die Standardeinstellung für tabellarische Ziffern führte zu viel Leerraum zwischen bestimmten Zahlenpaaren.
TimePicker
undDatePicker
verwenden weiterhinFontFeatureSetting=tnum
für Tabellenziffern. (I88929) - Der anfängliche Fokus der RSB-Eingabe für
TimePicker
undDatePicker
wurde korrigiert. (I1c773) - Der Standardtext auf
OpenOnPhoneDialog
wurde zu „Smartphone prüfen“ aktualisiert. (I00a3f) - Die Gewichtungen für
ArcLarge
undArcMedium
wurden von 600 auf 599 aktualisiert, um ein Problem zu umgehen, bei dem die Gewichtung 600 als fett formatiert wird (I2a51d). - Die
SwipeToReveal
-Abstände zwischen Inhalt und Aktionsschaltflächen sowie zwischen dem Symbol und dem Text der Aktionsschaltflächen wurden aktualisiert. (Ic46cb)
Version 1.0.0-alpha34
12. März 2025
androidx.wear.compose:compose-material3:1.0.0-alpha34
wird veröffentlicht. Version 1.0.0-alpha34 enthält diese Commits.
API-Änderungen
PagerScaffold
gibt keinePager
-Komponente mehr aus. Stattdessen muss sie über diecontent
-Composable bereitgestellt werden.AnimatedPage
undsnapWithSpringFlingBehaviour
sind jetzt öffentlich und können zusammen mit Wear FoundationPager
verwendet werden, um das bisherige M3-PagerScaffold
-Verhalten zu erzielen. (Siehe aktualisierte Beispiele). (Ia4724)PagerState
wurde aktualisiert. Die Compose Foundation-KlassePagerState
wurde als Basisklasse entfernt und die AttributecurrentPage
,currentPageOffsetFraction
undpageCount
wurden hinzugefügt. DieGestureInclusion
-Schnittstelle wurde aktualisiert und die Methode wurde inignoreGestureStart
umbenannt. (I4ae07)LevelIndicator
-Parameter für den Sweep-Winkel sind jetzt mitFloatRange(0, 360)
gekennzeichnet (I7e636)- Wir haben
CurvedModifier.clearAndSetSemantics
hinzugefügt, um die Möglichkeit zu bieten, die Semantik für Kurven zu deaktivieren. BeiCurvedText
wird die Inhaltsbeschreibung weiterhin standardmäßig auf den Text festgelegt, beitimeTextCurvedText
undtimeTextSeparator
werden die Inhalte jedoch nicht mehr vorgelesen. (I4b568) AppScaffold
wurden Parameter für die Hintergrund- und Standardinhaltsfarbe hinzugefügt. (I56652)- Die Standardbehandlung von Wischbewegungen in
HorizontalPager
wurde inPagerDefaults.gestureInclusion
umbenannt. Standardmäßig werden jetzt nur Wischbewegungen ignoriert, die am linken Rand der ersten Seite beginnen, und auch nur dann, wenn Talkback deaktiviert ist. In anderen Fällen werden Wischbewegungen standardmäßig nicht vom Pager ignoriert, sodass sie für Handler vom Typ „Wischen zum Schließen“ verfügbar sind. (Iee486) - Der Parameter
SurfaceTransformation
wurde den Komponenten für Schaltflächen, Karten und Listenüberschriften hinzugefügt, damit verschiedene Hintergrund- und Inhaltstransformationen angewendet werden können, wenn sie in Containern verwendet werden, die die Darstellung von Elementen basierend auf ihrer Position ändern, z. B.TransformingLazyColumn
. (Iabe3f) - Wir haben die Eigenschaften „public const val“ in unserer Wear Compose Material3 API in „public val“ geändert, um zu vermeiden, dass die Werte inline eingefügt werden. (Ib0f32)
- Unterstützung für eine Wischzone am Rand in
SwipeToReveal
hinzugefügt. Das Standardverhalten von FoundationSwipeToReveal
besteht nun darin, das Wischen zu unterbinden, wenn die Geste am Rand beginnt. Das Standardverhalten von Material3SwipeToReveal’
besteht nun darin, das Wischen zu unterbinden, wenn die Geste am Rand beginnt undSwipeDirection
auf eine einzelne Richtung festgelegt ist. (I32ef0) - Die
FadingExpandingLabel
-Composable wurde hinzugefügt, mit der Text zeilenweise animiert eingeblendet werden kann. (Ic60fa) - Bei
TransformingLazyColumn
werden jetzt standardmäßig leerecontentPadding
verwendet, anstatt das erste und das letzte Element in die Mitte zu setzen. (I77ab7) SwipeToReveal
rememberRevealState
wurde aus der Wear Compose Material3-Bibliothek entfernt. (I8c0e0)
Fehlerkorrekturen
- Wear Compose-Bibliotheken wurden auf den Kotlin 2.0-Compiler aktualisiert. (I2de79)
- Die Unterstützung für nicht runde
ScrollIndicator
undPageIndicator
wurde aus Material3 entfernt. Die Unterstützung quadratischer Displays ist auch nicht mehr Teil der Wear OS-Anforderungen. Weitere Informationen finden Sie im Leitfaden für die ersten Schritte. (I9a852) - Die
CurvedTextStyle
inConfirmationDialogDefaults
undOpenOnPhoneDialogDefaults
wurde aktualisiert und verwendet jetzt dieArcLarge
-Typografie mit der Größe18sp
und dem Buchstabenabstand1.8sp
. (Ic9ced) Card
,ListHeader
,RadioButton
,CheckboxButton
undSwitchButton
schränken die Höhe ihrer Inhalte standardmäßig nicht mehr ein. Verwenden Sie bei BedarfModifier.height(IntrinsicSize.Min)
, um das vorherige Verhalten wiederherzustellen. (I80bb8)- Wir haben die Standardfarben
TimeText
undScrollIndicator
aktualisiert und mehr Grautöne hinzugefügt, da die direkte Verwendung vonOnBackground
(Weiß) im Vergleich zu anderen Inhalten auf dem Bildschirm, z. B. Titeln, zu viel visuelles Gewicht hatte. (I8b36f) - Wir haben das Zeitlimit für die Animation von
TimeText
undScrollIndicator
in Scaffold-Komponenten auf 2 Sekunden reduziert. (I52021) - Wir haben die Bewegung des Dialogfelds aktualisiert, sodass die Skalierung des Hintergrunds des Dialogfelds mit dem Wischen zum Schließen synchronisiert wird. (I925a9)
- Füge eine Demo von M3
SwipeToReveal
mit dem ModifikatoredgeSwipeToDismiss
hinzu. (I02b07) - Wir haben in TalkBack den Überschriften
DatePicker
undTimePicker
hinzugefügt, dass der Nutzer scrollen muss, um Datum und Uhrzeit festzulegen. (Id738d) AnimatedText
folgt jetzt der Einstellung „Bewegung reduzieren“. (Ib6578)- Die Optimierung für die Verwendung von
AppScaffold
für Dialoginhalte wurde verbessert, sodass mehrere Dialogfelder übereinander angezeigt werden können (I1209c).
Version 1.0.0-alpha33
26. Februar 2025
androidx.wear.compose:compose-material3:1.0.0-alpha33
wird veröffentlicht. Version 1.0.0-alpha33 enthält diese Commits.
API-Änderungen
- Wir haben den Parameter „label“ aus
SwipeToRevealScope
,primaryAction
undsecondaryAction
entfernt. Die Semantik für benutzerdefinierte Aktionen sollte vom Entwickler direkt dem Inhalt derSwipeToReveal
-Komponente hinzugefügt werden. (Ia67f3) - Wir haben die Präfixe „Button“ aus Größen, Textformatierungen und Farbfunktionen in
IconToggleButtonDefaults
undTextToggleButtonDefaults
entfernt (I5471d). - Wir haben die experimentelle Funktion
LocalMinimumInteractiveComponentEnforcement
(I4ad8a) entfernt. - Wir haben die
PickerGroupScope
-DSL durch eine zusammensetzbare Funktion ersetzt. Daher haben wir die MethodepickerGroupItem
ausPickerGroupScope
entfernt und stattdessen@Composable PickerGroupItem
hinzugefügt, die zum Hinzufügen einer Auswahl zuPickerGroup
verwendet werden sollte. Außerdem haben wir den Typ des ParametersPickerGroup
„content“ in@Composable PickerGroupScope.() -> Unit
geändert. (Ic6aec) - Wir haben eine
LevelIndicator
-Überladung für Bruchwerte hinzugefügt und den Überladungen, die einen Bereichsparameter enthalten (und sich daher für die Verwendung mit der Stepper-Komponente eignen), das Präfix „Stepper“ vorangestellt. (If4234) - Wir haben der API die
TransformingLazyColumn
-FunktionTransformationSpec
hinzugefügt. Damit lassen sich die genauen Transformationen definieren, die auf die Elemente angewendet werden, während sie durch die TLC gescrollt werden. (I21856) - Wir haben
IconButtonShapes
,IconToggleButtonShapes
,TextButtonShapes
undTextToggleButtonShapes
aktualisiert, um sie an die Compose-/Material3-Klassen anzupassen (I5a081). - Wir haben den Parameter
overscrollEffect
zuScalingLazyColumn
,TransformingLazyColumn
undScreenScaffold
hinzugefügt. (I0cee8) - Wir haben den Parameter
swipeDirection
inrememberRevealState
inrevealDirection
umbenannt. (I7472f) - Wear Pager hat jetzt ein eigenes
PagerScope
und verwendet nicht mehr ComposePagerScope
. (I9195b) - Wir haben die zusammensetzbare Funktion
LinearProgressIndicatorContent
entfernt. Verwenden Sie stattdessen direktLinearProgressIndicator
, damit Änderungen an Werten standardmäßig animiert werden. (I2c4ad) - Wir haben die zusammensetzbare Funktion
CircularProgressIndicatorStatic
entfernt und eine öffentliche FunktionDrawScope
drawCircularProgressIndicator
mit derselben Funktionalität hinzugefügt. Verwenden SieCircularProgressIndicator
direkt, damit Änderungen standardmäßig animiert werden. Wenn benutzerdefinierte Animationen erforderlich sind, erstellen Sie Ihr eigenes Composable ausdrawCircularProgressIndicator
. (Ie762f) - Wir haben die Parameter in
DrawScope.drawCircularProgressIndicator
neu angeordnet, um den ParametertargetProgress
nach oben zu verschieben. (I8ab92) - Die
OpenOnPhoneDialog
API wurde aktualisiert, um für mehr Klarheit und eine bessere Übereinstimmung mit anderen Dialogfeldern zu sorgen. Der Parametershow
wurde invisible
umbenannt undcurvedText
wird jetzt vom Aufrufer bereitgestellt, anstatt einen Standardwert zu haben. (Idec2d) - Wir haben
openOnPhoneCurvedText
inopenOnPhoneDialogCurvedText
umbenannt (I65bdd) - Wir haben
ScrollIndicatorColors
hinzugefügt, um benutzerdefinierte Farben fürScrollIndicator
bereitzustellen. (I9eb8c) - Ermöglicht die Konfiguration der Farbe, die zum Zeichnen eines Hintergrunds hinter
TimeText
verwendet wird. (I9f5d9) - Die Typografien für
ArcLarge
,ArcMedium
undArcSmall
wurden aufCurvedTextStyle
(Iffc41) aktualisiert. - Wir haben
ScreenScaffoldDefaults.contentPaddingWithEdgeButton
entfernt. (Ia923e) - Wir haben
errorDim
inColorScheme
für Fehler mit hoher Priorität oder Notfallmaßnahmen wie Sicherheitswarnungen, fehlgeschlagene Dialog-Overlays oder Stoppschaltflächen hinzugefügt. (I70998)
Fehlerkorrekturen
- Wir haben
wear.compose.material3
an Version 1.15.0 vonandroidx.core.core
(I132e9) angepinnt. - Wir haben die Leistung von Dialogen verbessert, indem wir
AppScaffold
verwendet haben, um Dialoge über andere Bildschirminhalte zu legen (I1b9a4). - Der interne vertikale Abstand von
EdgeButton
wurde verringert. (I1a5bb) - Wir haben Schiebereglern die Semantik von Schaltflächen hinzugefügt. (I80cc6)
Version 1.0.0-alpha32
29. Januar 2025
androidx.wear.compose:compose-material3:1.0.0-alpha32
wird veröffentlicht. Version 1.0.0-alpha32 enthält diese Commits.
API-Änderungen
- Auf
CurvedTextStyle
haben wir den Zeichenabstand in den Zeichenabstand im Uhrzeigersinn und den Zeichenabstand gegen den Uhrzeigersinn unterteilt. Das ist erforderlich, weil sich Buchstaben, die im Uhrzeigersinn geschrieben werden, von der Grundlinie aus nach außen hin ausbreiten, während sich Buchstaben, die gegen den Uhrzeigersinn geschrieben werden, nach innen hin ausbreiten. Daher ist ein größerer Buchstabenabstand erforderlich. (I4b848) - Wir haben
IconButtonShapes
,IconToggleButtonShapes
,TextButtonShapes
undTextToggleButtonShapes
aktualisiert, um die Konsistenz zwischen den Material3-Bibliotheken zu verbessern. Durch diese Änderung wird auch das Zwischenspeichern von Formen eingeführt, um die Anzahl der Zuweisungen zu reduzieren. (I049fc) - Wir haben den Parameter
pressedShapeCornerSizeFraction
aus der MethodevariantAnimatedShape
inIconToggleButton
undTextToggleButton
entfernt (I58a65). - Wir führen Verbesserungen beim Rendern von gebogenem Text ein (einschließlich
TimeText
), die mit nicht runden Displays inkompatibel sind. Die Unterstützung nicht runder Displays ist auch nicht mehr Teil der Wear OS-Anforderungen. Weitere Informationen finden Sie im Leitfaden für die ersten Schritte. (I1cc1c) - Wir haben die
ButtonGroupScope
vonButtonGroup
aktualisiert und das DSL-basierteButtonGroupItem
durchModifier.weight
,Modifier.minWidth
undModifier.enlargeOnPress
ersetzt. (I16c3c) - In der
ButtonGroup
API haben wir den neuen modifier-basiertenButtonGroupScope
aktualisiert:enlargeOnPress
heißt jetztanimateWidth
und verwendetInteractionSource
anstelle vonMutableInteractionSource
, da es nicht erforderlich ist, es zu ändern. Außerdem haben wir die öffentliche KonstanteButtonGroupDefaults.DefaultMinWidth
hinzugefügt, die die standardmäßige Mindestbreite von Schaltflächen in einemButtonGroup
angibt. (Ie27ec) - Wir haben
ListHeaderDefaults.contentColor
aktualisiert, sodass es mit einem Kleinbuchstaben beginnt, da es sich um eine zusammensetzbare Property handelt (I125a5). - Wir haben den Parametern
SliderDefaults.DecreaseIcon
undSliderDefaults.IncreaseIcon
einen Parameter für die Inhaltsbeschreibung mit passenden Standardwerten (I2e1a7) hinzugefügt. - Wir haben den Parameter
spacing
inPicker
undPickerGroup
inverticalSpacing
(Ib75cc) umbenannt. - Wir haben
ConfirmationDialogDefaults.successText
undfailureText
entfernt, da Anrufer vonConfirmationDialog
Strings mit mehr Kontext bereitstellen sollen. Außerdem wurdeconfirmationCurvedText
inconfirmationDialogCurvedText
umbenannt. Der Parameter „Dialog“show
wurde in „visible“ umbenannt, um ihn an andere aktuelle Änderungen an Dialogfeldern anzupassen. (I10074) IconButton
hatdisabledImageOpacity
inDisabledImageOpacity
umbenannt. (I5f94a)
Fehlerkorrekturen
- Wir haben einen Fehler in der
EdgeButton
-Animation behoben, sodass in jedem Frame die richtige Größe verwendet wird (Id3b58). - Ein Problem wurde behoben, durch das
animateContentSize
nicht mitButton
funktionierte. (Ib18a0) - Wir haben die Typografie „Title Large“ so geändert, dass sie die Schriftgröße
18dp
(Ic9d52) hat. - Wir haben den
AlertDialog
-Abstand und die Symbolgröße aktualisiert (Iac28c). - Wir haben Inkonsistenzen bei Breakpoints für große Bildschirme behoben (Bildschirme mit einer Breite von mindestens 225 dp gelten als große Bildschirme) (I36474).
- Ein kleiner Fehler bei der Positionierung von Schaltflächen wurde behoben (I952c2).
Version 1.0.0-alpha31
15. Januar 2025
androidx.wear.compose:compose-material3:1.0.0-alpha31
wird veröffentlicht. Version 1.0.0-alpha31 enthält diese Commits.
API-Änderungen
- Wir haben alle Wear Compose-Bibliotheken in den Modus „explizite API“ aktualisiert. (Iebf9f)
- Wir haben die APIs
ScreenScaffold
undEdgeButton
aktualisiert, damit es einfacher ist, das Content-Padding auf Bildschirmen mit einemEdgeButton
anzugeben. In der neuen API wird diesize
derEdgeButton
nur an dieEdgeButton
übergeben. DieScreenScaffold
verwendet einenedgeButtonSpacing
-Parameter für den Abstand zwischenEdgeButton
und dem Listeninhalt. (I424fd) - In
DatePicker
haben wir die ParameterminDate
inmaxDate
undminValidDate
inmaxValidDate
umbenannt. InDatePickerColors
haben wir den ParameterselectedPickerContentColor
inactivePickerContentColor
undunselectedPickerContentColor
ininactivePickerContentColor
umbenannt (Iba17b). - Wir haben die Standardwerte für
ArcProgressIndicator
aufstrokeWidth=6dp
aktualisiert und empfehlendiameter = 81.24%
der Bildschirmhöhe (I6f248). - Wir haben die Confirmation API aktualisiert, um ihre Verwendung als Dialogfeld widerzuspiegeln. Das Composable heißt jetzt
ConfirmationDialog
. Außerdem wurden die Namen von Farben und Standardklassen aktualisiert. Außerdem haben wir den Parametershow
invisible
umbenannt, um die Kompatibilität mit anderen Compose-Animations-APIs zu gewährleisten. Außerdem haben wirConfirmationDialogContent
,SuccessConfirmationDialogContent
undFailureConfirmationDialogContent
für Situationen eingeführt, in denen Entwickler die Animationen für Intro-/Outro-Dialogfelder anpassen müssen. (Iaeb33) - Wir haben
CircularProgressIndicatorContent
aufCircularProgressIndicatorStatic
(die nicht animierte Variante vonCircularProgressIndicator
) aktualisiert, damit es jetzt zum Erstellen vonCircularProgressIndicator
mit benutzerdefinierten Animationen verwendet werden kann. (I1346f) - Wir haben die Reihenfolge der Parameter im
ArcProgressIndicator
korrigiert und den Modifikatorparameter (I4656a) an den Anfang gestellt. - Die
SwipeToReveal
API wurde verbessert, um einen Text-Slot-Parameter für die Labels der Aktionen (außer der sekundären Aktion) zu empfangen und Label-Parameter aus der Rückgängig-Aktion zu entfernen (I5b3db).
Fehlerkorrekturen
- Wir haben einen Fehler behoben, bei dem die Haptik von
LongPress
inButton
,Card
,IconButton
undTextButton
mehr als einmal ausgelöst wurde (Ia8b0f). - Änderungen an der Benutzeroberfläche von
AlertDialog
: Auf großen Bildschirmen sind die Schaltflächen zum Bestätigen und Schließen jetzt kleiner. Außerdem ist der Abstand unter den Schaltflächen „Bestätigen“ und „Schließen“ größer. (I4f066) - Wir haben die Animationsspezifikationen des Labels der Aktionsschaltfläche der Komponente
SwipeToReveal
geändert. (Ib87fb) SwipeToReveal
wurde geändert, damit der Container gleichzeitig mit dem Text maximiert wird. (I44cf8)SwipeToReveal
wurde verbessert, um haptisches Feedback zu geben, wenn der Wischvorgang den Grenzwert überschreitet, bei dem die primäre Aktion ausgeführt wird. (I23efe)- Wir haben
SwipeToReveal
aktualisiert, sodass bei primären Aktionen und Rückgängig-Aktionen standardmäßig Auslassungspunkte angezeigt werden, wenn Text überläuft. (I71f5a) - Wir haben ein Problem behoben, das zu Ruckeln bei
ButtonGroup
-Animationen geführt hat. (I63f8f) - Wir haben
AnimatedText
(I6063c) Textsemantik hinzugefügt. - Das Dialogfeld setzt jetzt die Hintergrundskalierung zurück, wenn es aus der Komposition entfernt wird. Ohne diesen Fix wäre der Startbildschirm möglicherweise in einem verkleinerten Zustand geblieben. (Id24ac)
- Wir haben den Schaltflächen in der Stepper-Komponente (Id6ed3) eine Form-Morphing-Animation hinzugefügt.
Version 1.0.0-alpha30
11. Dezember 2024
androidx.wear.compose:compose-material3:1.0.0-alpha30
wird veröffentlicht. Version 1.0.0-alpha30 enthält diese Commits.
API-Änderungen
- Der Modifikator
scrollTransform
fürTransformingLazyColumn
wurde umgestaltet, was eine API-Änderung zur Folge hatte. (I0c6dc) - Wir haben
IconToggleButtonShapes
undTextToggleButtonShapes
aktualisiert und verwenden jetzt zwei verschiedene FormparameteruncheckedPressed
undcheckedPressed
(I85dbd). - Ungültige Optionen für Monat/Tag sind jetzt in
DatePicker
mit einem neueninvalidPickerContentColor
sichtbar, wennminDate
odermaxDate
verwendet wird. (If4541) - Wir haben die
Stepper
API aktualisiert, umincreaseIcon
- unddecreaseIcon
-Slots bereitzustellen. Der Inhalt für diese kann wie gewohnt aus der Icon-Composable erstellt werden. (Id35da) - Wir haben
dynamicColorScheme
aktualisiert, indem wir den optionalen ParameterdefaultColorScheme
entfernt und jetzt nullableColorScheme
zurückgegeben haben. Das bedeutet, dass der Aufrufer den Fallback-Fall explizit behandeln muss, wenn kein dynamisches Farbschema angegeben wird. (I6d62e) - Wir haben die Symbolgrößen in
ButtonDefaults
für die Verwendung mitCompactButton
aktualisiert. Für einCompactButton
, das nur ein Symbol enthält, sollteButtonDefaults.SmallIconSize = 24.dp
verwendet werden. Für einCompactButton
, das sowohl ein Symbol als auch Text enthält, sollteButtonDefaults.ExtraSmallIconSize = 20.dp
verwendet werden. Es wird empfohlen, dassCompactButton
seinen Inhalt umschließt (anstatt die maximale Breite auszufüllen). Die Beispiele wurden entsprechend aktualisiert. (I0582c) - Wir haben
EdgeButtonDefaults
mit empfohlenen Symbolgrößen für die vier verschiedenenEdgeButtonSizes
hinzugefügt. Außerdem wurde dasEdgeButton
-Layout aktualisiert, sodass es unten etwas mehr Padding als oben hat. Dadurch wird die Darstellung von Symbol- und Textinhalten verbessert. (Id772a) - Wir haben
LinearProgressIndicator
Bewegung hinzugefügt undLinearProgressIndicatorContent
verfügbar gemacht, um die visuellen Inhalte ohne Animationen bereitzustellen. (Idee99) - Wir haben eine neue
CircularProgressIndicatorContent
-Composable-Funktion hinzugefügt, mit der die visuellen Inhalte vonCircularProgressIndicator
ohne Animationen angezeigt werden können. (Ie33d4) TransformingLazyColumn
bietet jetzt die Komposition „lokal“LocalTransformingLazyColumnItemScope
, die vonCard
s,Button
s undListHeader
s verwendet wird, um sich automatisch zu transformieren, wenn sie in einemTransformingLazyColumn
platziert werden. Anrufer können das automatische Morphen mit dem neuenTransformExclusion
-Wrapper deaktivieren. (I1652f)- Wir haben den Typ von
ButtonDefaults.shape
aufRoundedCornerShape
(Iccdf2) aktualisiert.
Fehlerkorrekturen
- Wir haben einen Fehler behoben, damit der vorhandene Alphawert für den Hintergrund von
TimeText
(I1eb60) berücksichtigt wird. - Wir haben
TextMotion
standardmäßig aufAnimated
gesetzt, um zu vermeiden, dass Text aufgrund des Ausrichtens von Buchstaben-Glyphen an Pixelgrenzen bei Skalierungsvorgängen flackert. (I626fa) - Wir haben das Erscheinungsbild von
ScrollIndicator
aktualisiert, indem wir die Breite und die Größe des Abstands vergrößert haben, um die Sichtbarkeit zu verbessern. (Ied7cb) - Wir haben einen Fehler auf
Modifier.scrollTransform
behoben, der beim Hinzufügen, Entfernen oder Verschieben von Elementen auftrat. (I6830f) - Wir haben ein Problem mit der Animation runder Schaltflächen bei kurzen Tippvorgängen behoben. Bisher wurde die Mindestdauer der Animation nicht immer eingehalten. (I757a7)
- Wir haben den Schwenkwinkel für
LevelIndicator
auf 20% (72 Grad) aktualisiert. (Idde5c) - Wir haben die Positionierung von
ScrollIndicator
korrigiert, wennScalingLazyColumn
mitAutoCenteringParams
verwendet wurde. (I387dd) - Wir haben die Farben und die Typografie für
ListHeader
undListSubHeader
aktualisiert. Außerdem die Farben für die Ein/Aus-Schaltflächen aufCheckboxButton
undSwitchButton
. (I39817) - Wir haben die Positionierung von
ScrollIndicator
inLazyColumn
undScalingLazyColumn
mitContentPadding
korrigiert. (I2bc51) - Wir haben einen Fehler in der Fortschrittsanimation von
OpenOnPhoneDialog
behoben, indem wir die neueCircularProgressIndicatorContent
verwendet haben. (I3e443) - Wir haben
HorizontalPagerScaffold
undVerticalPagerScaffold
aktualisiert, um Animationen zu deaktivieren, wenn die Option „Bewegung reduzieren“ aktiviert ist (Iaaf68). - Wir haben eine separate Animation für kreisförmige Fortschrittsanzeigen implementiert, wenn der Fortschritt über 100 % liegt. (I47135)
- Wir haben einen Fehler behoben, durch den
EdgeButton
in Pager-Komponenten (I91db9) mit einer falschen Form gezeichnet werden konnte.
Version 1.0.0-alpha29
13. November 2024
androidx.wear.compose:compose-material3:1.0.0-alpha29
wird veröffentlicht. Version 1.0.0-alpha29 enthält diese Commits.
API-Änderungen
- Wir haben
TimeText
aktualisiert und bieten jetzt Standardinhalte an, die die Uhrzeit anzeigen. (Id23b3) - Wir haben die
ScrollInfoProvider
fürPagerState
vereinfacht, indem wir den Parameterorientation
entfernt haben, der nicht mehr benötigt wird. Das neue Verhalten ist, dassTimeText
sowohl beim horizontalen als auch beim vertikalen Paging an Ort und Stelle bleibt. (I71767) LocalHapticFeedback
bietet jetzt eine Standardimplementierung vonHapticFeedback
, wenn die Vibrator API angibt, dass Haptik unterstützt wird. Die folgenden Elemente wurden derHapticFeedbackType
hinzugefügt:Confirm
,ContextClick
,GestureEnd
,GestureThresholdActivate
,Reject
,SegmentFrequentTick
,SegmentTick
,ToggleOn
,ToggleOff
,VirtualKey
. Bei Wear Compose-Komponenten, die lange angeklickt werden können, z. B.Button
,IconButton
,TextButton
undCard
, wird jetzt dasLONG_PRESS
-Haptiksignal ausgegeben, wenn ein Handler für langes Klicken angegeben wurde. (I5083d)
Fehlerkorrekturen
- Wir haben die Bewegung für Bestätigungen aktualisiert. (I04bff)
- Wir haben die Mindest-API-Abhängigkeit für Compose-Bibliotheken auf 1.7.4 aktualisiert. (I88b46)
- Dem Dialogfeld
OpenOnPhone
wurde eine neue Bewegung hinzugefügt. (I1e10a) - Wir haben einen Fehler in
LevelIndicator
behoben, sodass sie jetzt korrekt angezeigt wird, wenn der Wert null ist. (Ie95a4) - Wir haben die Animationen
HorizontalPageIndicator
undVerticalPageIndicator
aktualisiert. (I5c8f3) - Dem unbestimmten
ArcProgressIndicator
wurde eine Animation hinzugefügt, bei der das Element zu einem Punkt schrumpft. (I9fd51)
Version 1.0.0-alpha28
30. Oktober 2024
androidx.wear.compose:compose-material3:1.0.0-alpha28
wird veröffentlicht. Version 1.0.0-alpha28 enthält diese Commits.
API-Änderungen
- Wir haben eine Bogenvariante für die unbestimmte kreisförmige Fortschrittsanzeige (I2efc1) hinzugefügt.
- Wir haben die Composables
AlertDialogContent
undDialog
, aus denen dieAlertDialog
API besteht, öffentlich gemacht, damit Sie bei Bedarf Anpassungen vornehmen können, z. B. dieAlertDialog
-Animation anpassen und gleichzeitig das empfohlene Inhaltslayout beibehalten. Außerdem haben wir denEdgeButton
-,ConfirmButton
- undDismissButton
-Elementen vonAlertDialogDefaults
die ParameterModifier
undColor
hinzugefügt. (I4eb71) - Wir haben die
Placeholder
API aktualisiert:PlaceholderState.startPlaceholderAnimation
wurde inPlaceholderState.animatePlaceholder
,PlaceholderState.isShowContent
inPlaceholderState.isHidden
undPlaceholderDefaults.shape
inPlaceholderDefaults.Shape
umbenannt. Der Parameterpainter
inpainterWithPlaceholderOverlayBackgroundBrush
wurde inoriginalPainter
umbenannt. Die Sichtbarkeit vonPlaceholderState.placeholderProgression
wurde von „öffentlich“ in „intern“ geändert und inplaceholderShimmerProgression
umbenannt. Der KlassePlaceholderDefaults
wurden Konstanten für die Dauer der Platzhalteranimation hinzugefügt. (Ie5a59) - Wir haben die
EdgeButton
API aktualisiert: Der Parameter fürScreenScaffold
wurde vonbottomButton
inedgeButton
umbenannt undEdgeButtonSize
ist jetzt eine Wertklasse. (Ieef15) - Wir haben die Sichtbarkeit von
copy()
in den Klassen „wear material3 Colors“ (I0287f) auf „öffentlich“ geändert.
Fehlerkorrekturen
- Mindestdauer für Animationen für
IconToggleButton
undTextToggleButton
bei Klick hinzugefügt (Ieb333) - Mindestdauer für die Animation von Formen
IconButton
undTextButton
hinzugefügt (Iebcee) - Der Status der Wiederholungsoption von
DatePicker
wurde korrigiert. (I3587c) - Bewegung für Warn- und Bestätigungsdialogfelder 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
ScreenScaffold
undScrollIndicator
nach der Umbenennung von Wear Compose FoundationLazyColumn
inTransformingLazyColumn
aktualisiert. (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 den Namen 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 Koordination zwischen Zeittext- und Seitenindikator-Komponenten ermöglichen. (Iff7d0) - Wir haben die Unterstützung für Drehregler in
HorizontalPagerScaffold
undVerticalPagerScaffold
hinzugefügt. Nutzer können jetzt Pager mit Drehreglern bedienen. (I9770d) - Wir haben Änderungen an der
MotionScheme
API vorgenommen, um die Verwendung zu vereinfachen und die Konsistenz zu verbessern. Inline-Funktionen vom Typ „remember“ wurden entfernt und die integrierten MotionSchemes in ein eigenes MotionScheme-Begleitobjekt verschoben. DiestandardMotionScheme
und dieexpressiveMotionScheme
wurden in „Standard“ und „Expressiv“ umbenannt. (I5fd45) - Wir haben Unterstützung für ein dynamisches Farbschema basierend auf Systemfarben hinzugefügt. (I073e9)
- Wir haben den Stepper an die neuesten UX-Spezifikationen angepasst. (I622bb)
Fehlerkorrekturen
- Wir haben die Typografie und die Abstände für Kartenkomponenten aktualisiert. (I3ae48)
- Wir haben den Abstand in
AlertDialog
zwischen den Schaltflächen „Bestätigen“/„Schließen“ und dem restlichen Inhalt 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). AlertDialog
unterstützt jetzt die Möglichkeit, die untere Standardschaltfläche aus der Schaltflächenstapel-Variante für benutzerdefinierte Layouts auszulassen, in denen EdgeButton nicht erforderlich ist. (I34fa9)- Wir haben eine
SwipeToReveal
-Komponente für Wear Material 3 (Ic38b2) hinzugefügt. - Wir haben die Unterstützung für bidirektionales Wischen in
SwipeToReveal
hinzugefügt, für seltene Fälle, in denen der aktuelle Bildschirm das Schließen durch Wischen nicht unterstützt. Standardmäßig wird die Funktion „Wischen zum Aufdecken“ nur bei Wischbewegungen von rechts nach links ausgelöst. Es wird dringend empfohlen, das Standardverhalten beizubehalten, um Konflikte mit der Funktion „Wischen zum Schließen“ zu vermeiden. (Ifac04) - Der Parameter
buttonHeight
vonEdgeButton
wurde inpreferredHeight
umbenannt. (I4fab3) - Die Kotlin-Version wurde auf 1.9 (I1a14c) aktualisiert.
- Wir haben
OpenOnPhoneDialogDefaults.Icon
inOpenOnPhoneDialogDefaults.OpenOnPhoneIcon
umbenannt, um Konflikte mitIcon
zu vermeiden(I0f391). - Wir haben Unterstützung für
ScrollIndicator
inLazyColumn
hinzugefügt. (Ia546a) - Wir haben die Standardwerte für
TextToggleButton
undIconToggleButton
aktualisiert. (I7aaa9) - Wir haben die APIs
Picker
undPickerGroup
vereinfacht. (Id0653) - Wir haben
CardDefaults.Shape
undCardDefaults.Height
hinzugefügt. Da es sich um Tokens handelt, waren sie bisher nur für Entwickler verfügbar, die die Bibliothek verwenden. (I1594a, b/347649765) - Wir haben den Fortschrittsparameter für die binär segmentierte kreisförmige Fortschrittsanzeige in
segmentValue
umbenannt. (Ib72d9) - Wir haben die Farben und das Layout für den Schieberegler aktualisiert. (Ic3eec)
Fehlerkorrekturen
- Wir haben die Animation des Symbols
openOnPhone
(I66f85) aktualisiert. - Wir verwenden jetzt Google-Symbole in
Slider
,TimePicker
undDatePicker
. (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 Unterstützung für den Fortschrittsüberlauf (> 100% Fortschritt) für
CircularProgressIndicator
undSegmentedCircularProgressIndicator
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 Formanimationsvariante, in der verschiedene Formen die Zustände „Aktiviert“, „Deaktiviert“ und „Gedrückt“ darstellen. Die bisherige animierte Formvariante für den Status „Gerade gedrückt“ wird weiterhin unterstützt. (I29f03) - Wir haben die Unterstützung für die Verwendung von
EdgeButton
mitColumn
entfernt, da die Höhe vonEdgeButton
explizit inScreenScaffold
angegeben werden muss. (Ie353d) - Wir haben Unterstützung für die Wear Compose-
LazyColumn
mit unseremScreenScaffold
hinzugefügt und eine Implementierung vonScrollInfoProvider
fürLazyColumnState
hinzugefügt. (Ib8d29) - Wir haben
LocalTextMaxLines
,LocalTextAlign
undLocalTextOverflow
in einer einzelnen lokalenLocalTextConfiguration
-Komposition zusammengefasst, um eine skalierbarere Lösung zu schaffen. (I5edbc) - Wir haben „arc-large“ als zusätzliche Typskala hinzugefügt, die für kurze Überschriften ganz oben oder unten auf dem Bildschirm reserviert ist, z. B. in Bestätigungs-Overlays. (I60e3e)
- Wir haben Standardwerte für die empfohlenen großen und extragroßen Symbolgrößen und das Content-Padding für die Schaltfläche hinzugefügt. (I84675)
Fehlerkorrekturen
- Wir haben die Farben für
IconButton
undTextButton
aktualisiert. (I48324) - Wir haben die Basis-Button-Überladungen geändert, sodass sie vertikal zentriert ausgerichtet sind, um die Konsistenz mit anderen Überladungen zu gewährleisten. Um das vorherige Verhalten wiederherzustellen, verwenden Sie
Modifier.align
ausRowScope
. (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
- Dem Material3-Design wurde 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 die Komponenten
AppScaffold
undScreenScaffold
hinzugefügt, die Funktionen zum Koordinieren von Ebenen und Übergängen vonTimeText
undScrollIndicator
enthalten.AppScaffold
bietet eine oberste Ebene von Scaffold-Komponenten, die über allen Bildschirmen liegen. Wenn SieTimeText
zuAppScaffold
hinzufügen, bleibt es an seinem Platz, während Sie zwischen Bildschirmen wischen. Auf Zifferblättern kann der Zeittext überschrieben oder ausgeblendet werden.ScreenScaffold
bietet einen Slot fürScrollIndicator
und animiert die Scrollanzeige automatisch beim Scrollen. Außerdem wird die Scrollanzeige nach einer bestimmten Zeit der Inaktivität ausgeblendet. (I047d6) - Wir haben
ScrollIndicator
mit dem neuen Material3-Design hinzugefügt. Die Größe des Thumbnails ist basierend auf dem ursprünglichen Listeninhalt festgelegt, um Größenabweichungen zu vermeiden, wenn verzögert geladene Inhalte in die Liste eingefügt werden. (Ic228d) - Wir haben die
ScrollAway
API so geändert, dassScreenStage
eine Wertklasse anstelle einer Enum-Klasse ist. So können bei Bedarf zusätzliche Phasen hinzugefügt werden. (I48c93) - Wir haben
EdgeButton
hinzugefügt, eine unverwechselbare Wear-spezifische Schaltfläche, deren Form der Krümmung des unteren Bildschirmrands folgt (I16369). - Wir haben dem
ScreenScaffold
einen neuen Slot für eine untere Schaltfläche (z. B.EdgeButton
) hinzugefügt, die je nach Scrollinhalt angezeigt und in der Größe angepasst wird (I032eb). - Wir haben
Modifier.scrollTransform
undModifier.targetMorphingHeight
hinzugefügt, um Material3-Bewegungseffekte auf Elemente inLazyColumn
anzuwenden. (Ie229a) - Wir haben
SegmentedCircularProgressIndicator
als Variante vonCircularProgressIndicator
hinzugefügt. Die segmentierte Variante zeigt entweder einen einzelnen Fortschrittswert für alle Segmente oder jedes Segment als „Ein“ oder „Aus“ an. (I6e059) - Wir haben
LinearProgressIndicator
als Alternative zum vorhandenenCircularProgressIndicator
hinzugefügt. (I89182) - Wir haben
AlertDialog
hinzugefügt, um Layouts für die Darstellung wichtiger Aufforderungen für den Nutzer bereitzustellen. Variationen sind entweder für ein Paar von Schaltflächen zum Bestätigen/Schließen oder für eine einzelne Schaltfläche unten (in der Regel eine EdgeButton) unter einem Stapel von Optionen enthalten. Beide Varianten haben Felder für Symbol, Titel und zusätzlichen Text, um weitere Details anzugeben. (Ieb873) - Wir haben
OpenOnPhoneDialog
hinzugefügt, das verwendet werden sollte, um eine Aktion anzugeben, die auf dem Smartphone des Nutzers fortgesetzt wird.OpenOnPhoneDialog
wird nach einem bestimmten Zeitlimit geschlossen. (I978fd) - Wir haben
Confirmation
hinzugefügt, eine Dialogkomponente mit Slots für ein Symbol und entweder gekrümmten oder linearen Text. Es gibt bestimmte Varianten für Erfolgs- und Fehlermeldungen. Bestätigungen werden nach einem Timeout automatisch geschlossen. (Ib43e8) - Wir haben
TimeText
einen Hintergrund hinzugefügt, um Probleme zu beheben, bei denen sich die zugrunde liegenden Inhalte undTimeText
überschnitten und die Uhrzeit verdeckten. (Ia11fd) - Wir haben
LevelIndicator
hinzugefügt. Damit wird der Wert einer Einstellung wie „Lautstärke“ angezeigt. Die Komponente kann mit der vorhandenen KomponenteStepper
verwendet werden, um einen Lautstärkebildschirm zu erstellen.LevelIndicator
ist ähnlich wieScrollIndicator
, wird jedoch auf der gegenüberliegenden Seite des Bildschirms angezeigt und hat standardmäßig eine größere Strichstärke und eine andere Indikatorfarbe. (I8a4ac) - Wir haben
TimePicker
hinzugefügt. Es gibt Layouts für die 24-Stunden-Zeit (mit oder ohne Sekunden) oder die 12-Stunden-Zeit mit Auswahl von „am“/„pm“. (Ia5124) - Wir haben
DatePicker
hinzugefügt. Hier können Sie die Reihenfolge der Spalten (z. B. Tag-Monat-Jahr, Monat-Tag-Jahr oder Jahr-Monat-Tag) und optional Mindest- und Höchstdaten konfigurieren. (Ibf13b) - Wir haben der Funktion
text
vonTimeText
einen Gewichtungsparameter hinzugefügt. Wenn TimeText aus mehreren Textelementen besteht, können Sie damit steuern, wie der Leerraum verteilt wird. (I36700) - Wir haben
RadioButton
undSplitRadioButton
hinzugefügt. Diese Komponenten vereinfachen die bisherige API, da sie sowohl die (Split)SelectableButton
- als auch die untergeordnete Funksteuerung (If7ae8) kombinieren. - Wir haben
CheckboxButton
undSplitCheckboxButton
hinzugefügt. Diese Komponenten vereinfachen die bisherige API, indem sie sowohl das (Split)ToggleButton
als auch das untergeordnete Checkbox-Steuerelement (Ia8f70) kombinieren. - Wir haben
SwitchButton
undSplitSwitchButton
hinzugefügt. Diese Komponenten vereinfachen die bisherige API, da sie sowohl die(Split)ToggleButton
als auch das untergeordnete Switch-Steuerelement (I0d349) kombinieren. - Wir haben die
AnimatedText
-Dokumentation aktualisiert, um das Überschwingen zu erläutern. (Iff30a) - Wir haben
ButtonGroup
hinzugefügt, um 2 oder 3 Schaltflächen zu kombinieren, sodass durch Drücken der Schaltflächen eine koordinierte Animation ausgelöst wird. (Ie27db) - Wir haben eine optionale Formanimation für
IconButton
undTextButton
hinzugefügt, die beim Drücken abgespielt wird. (Iffca5) - Wir haben
Button
,IconButton
,TextButton
,CompactButton
undEdgeButton
(I65fc3) eine zusätzliche Farbvariante hinzugefügt:FilledVariant
. - Wir haben den Parameter
forcedSize
zuImageWithScrimPainter
hinzugefügt, sodass die Hintergründe von Schaltflächenbildern jetzt standardmäßig ihre Komponentengröße beibehalten. Wenn SieforcedSize = null
festlegen, wird stattdessenPainter.instrinsicSize
übernommen. (Ic57af) - Wir haben Schaltflächen die Funktion „Lange drücken“ hinzugefügt (Ib613d).
- Außerdem wurde Unterstützung für langes Klicken in
IconButton
undTextButton
hinzugefügt. (I38891) - Karten unterstützen jetzt langes Klicken. (I305d5)
- Wir haben
LocalTextMaxLines
,LocalTextAlign
undLocalTextOverflow
alsCompositionLocals
hinzugefügt und als Parameterstandardwerte fürText
verwendet. Die Kompositions-Locals können jetzt von Komponenten wieCheckboxButton
,SwitchButton
undRadioButton
verwendet werden, um UX-Anleitungen zu implementieren. Die Parameter können jedoch bei Bedarf von Entwicklern überschrieben werden. (Iab841) - Wir haben
Placeholder
hinzugefügt, um das Maskieren des Inhalts von Komponenten wie Schaltflächen und Karten zu erleichtern, bis die Daten geladen sind. (I1a532) - Wir haben
IconToggleButtonColors
undTextToggleButtonColors
hinzugefügt, um das jetzt entfernteToggleButtonColors
zu ersetzen. (Ie0bf1)
Fehlerkorrekturen
- Wir haben
Button
,FilledTonalButton
,OutlinedButton
,ChildButton
,CompactButton
aktualisiert, um die neuenCompositionLocals
LocalTextMaxLines
,LocalTextAlign
,LocalTextOverflow
zur Implementierung von UX-Richtlinien zu verwenden. Diese Parameter können bei Bedarf direkt von Entwicklern im Text überschrieben werden (Ie51f7). - Wir haben die Standardstrichstärke des
LevelIndicator
in6dp
geändert, um es vomScrollIndicator
mit einer Strichstärke von4dp
zu unterscheiden. (If6f63) - Wir haben ein Problem in
TimeText
behoben, sodass jetzt größere Sweep-Winkel unterstützt werden. (Ie489f) - Ein Problem bei der
EdgeButton
-Neukomposition wurde behoben. (I4cdca) - Die Layouts von geteilten Ein/Aus-Schaltflächen wurden korrigiert, wenn benutzerdefinierte Inhaltsabstände angegeben wurden. (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 APIs
ToggleButton
undRadioButton
aktualisiert, sodass deaktivierte Farben konfiguriert werden können. (If13a7) - Wir haben ein neues
CircularProgressIndicator
für Material3 hinzugefügt. (Ib3bd7)
Fehlerkorrekturen
- Wir haben einen Fehler behoben, bei dem für auswählbare Schaltflächen „Doppeltippen, um umzuschalten“ angesagt 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 die Material3-
ColorScheme
aktualisiert. (I7b2b8) - Wir haben den Material3-Schalter aktualisiert. Neben einigen Farbänderungen entspricht das Häkchen jetzt dem, das für das Kontrollkästchen verwendet wird. (Icac7b)
Fehlerkorrekturen
- Alle Integrationsdemos so aktualisieren, dass sie den neuen
rotaryScrollable
-Modifikator verwenden. (I25090)
Version 1.0.0-alpha21
17. April 2024
androidx.wear.compose:compose-material3:1.0.0-alpha21
wird veröffentlicht. Version 1.0.0-alpha21 enthält diese Commits.
- Dieses Release wurde aufgrund eines technischen Problems im vorherigen Release ausgelöst, das zu fehlenden Quell-Jars geführt hat. In diesem Release 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 den fokussierten Zustand des Ripples für den Kontrast angepasst. (I59f0a)
- Wir haben in
Button
,ToggleButton
undRadioButton
den Abstand zwischen primären und sekundären Labels angepasst, um den neuesten Änderungen an Typografiestilen und Zeilenhöhen Rechnung zu tragen. (I2c0ba)
Version 1.0.0-alpha19
6. März 2024
androidx.wear.compose:compose-material3:1.0.0-alpha19
wird 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 oben auf dem Bildschirm die aktuelle Uhrzeit und zusätzlichen Status an. Die neue, prägnante Material3-API vermeidet Duplikate zwischen linearen und gekrümmten Inhalten. (I4d7c3) - Wir haben die Parameternamen für
RadioButton
vononSelected
zuonSelect
aktualisiert. (I1a971) - Tokenisiere
RadioButton
undSplitRadioButton
und refaktoriere die vorhandenen Methoden, um die Anzahl derCompositionLocal
-Suchvorgänge zu reduzieren. Füge dazu zwischengespeicherte Instanzen von Farben hinzu und mache 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
umgestaltet, indem wir intern zwischengespeicherte Instanzen erstellt und die Verwendung 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. Außerdem haben wir das doppeltefilledButtonColors
entfernt. (I4fe3b) - Wir haben die Standardmuster für
ButtonColors
,IconButtonColors
undTextButtonColors
umgestaltet, indem wir intern eine Instanz im Cache erstellt und die Verwendung vonCompositionLocal
reduziert haben. (I5f51c) - Wir haben den Overhead von
rememberUpdatedState
in komponentenspezifischen Farbklassen entfernt und Accessormethoden in Farbklassen als intern markiert. (If6571)
Fehlerkorrekturen
- Wir haben
Modifier.minimumInteractiveComponentSize
aktualisiert, sodassModifier.node
verwendet wird. (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, das dieselben gefüllten, gefüllten tonalen und umrissenen Farben wie „Button“ verwenden kann.(I05df0)
API-Änderungen
- Wir haben
RadioButton
/SplitRadioButton
als Container für Auswahlsteuerelemente wie das Optionsfeld hinzugefügt. Das unterscheidet sich vom vorhandenenToggleButton
, daRadioButton
auswählbar ist (und innerhalb einer Auswahlgruppe funktioniert), währendToggleButton
ein-/ausschaltbar ist (und unabhängig ist). (I61275) - Wir entfernen
LocalContentAlpha
aus der Wear Compose Material3-Bibliothek, um sie an die Compose Material3-Bibliothek anzugleichen. (I49a0a) - Wear-Material- und Wear-Material3-Komponenten, die in ihrer API ein
MutableInteractionSource
verfügbar machen, wurden aktualisiert und machen jetzt ein nullableMutableInteractionSource
verfügbar, das standardmäßig auf „null“ gesetzt ist. Es gibt hier keine semantischen Änderungen: Wenn Sie „null“ übergeben, möchten Sie dasMutableInteractionSource
nicht verschieben. Es wird bei Bedarf innerhalb der Komponente erstellt. Wenn Sie den Wert auf „null“ ändern, kann es sein, dass für einige Komponenten nie einMutableInteractionSource
zugewiesen wird. Außerdem kann es sein, dass für andere Komponenten nur dann eine Instanz erstellt wird, wenn sie benötigt wird. Das verbessert die Leistung dieser Komponenten. Wenn Sie dieMutableInteractionSource
, die Sie an diese Komponenten übergeben, nicht verwenden, sollten Sie stattdessen „null“ übergeben. Es wird auch empfohlen, ähnliche Änderungen in Ihren eigenen Komponenten vorzunehmen. (Ib90fc, b/298048146) - Es wird eine neue Ripple-API in den Bibliotheken
wear:compose-material
undwear:compose-material3
hinzugefügt, die die eingestellterememberRipple
ersetzt. Außerdem wird ein temporäresCompositionLocal
,LocalUseFallbackRippleImplementation
hinzugefügt, um die Material-Komponenten auf die Verwendung der verworfenenrememberRipple/RippleTheme
-APIs zurückzusetzen. Diese wird in der nächsten stabilen Version entfernt und ist nur als vorübergehende Migrationshilfe für Fälle gedacht, in denen Sie eine benutzerdefinierteRippleTheme
angeben. Weitere Informationen zur Migration und Hintergrundinformationen zu dieser Änderung finden Sie unter developer.android.com. (af92b21) - Wir haben kleinere Verbesserungen an der
HorizontalPageIndicator
API und der zugehörigen Dokumentation vorgenommen. (I60efc) - Wir haben
ColorScheme
so aktualisiert, dass es unveränderlich ist. Dadurch sind einzelne Farbaktualisierungen weniger effizient, die häufigere Verwendung von Farben jedoch effizienter. Der Grund für diese Änderung ist, dass das Aktualisieren einzelner Farben für die meisten Apps kein Hauptanwendungsfall ist. Das ist weiterhin möglich, aber es wird häufiger neu zusammengesetzt als zuvor. Dadurch wird die Anzahl der Statusabos im gesamten Materialcode deutlich verringert, was sich auf die Initialisierungs- und Laufzeitkosten von Standardanwendungsfällen auswirkt. (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, damit Material Design-Tokens verwendet werden. (Iba215)
- Wir haben die Komponenten
Checkbox
,Switch
undRadioButton
so geändert, dass sie nur angezeigt werden. Die Klickbehandlung wurde entfernt. Diese Komponenten sollen in(Split)ToggleButton
verwendet werden, das den Klick verarbeitet. Daher werden die Komponenten jetzt deutlicher als reine Displaykomponenten gekennzeichnet und sind nicht für die eigenständige Verwendung auf Wear vorgesehen. (I2322e)
Fehlerkorrekturen
- Wir haben in Wear Compose Material 3 Tokens für Bewegungs- und Dämpfungswerte für Zeiträume hinzugefügt. (I437cd)
- Wir haben einen Fehler in den
ToggleButton
,SplitToggleButton
,Checkbox
,Switch
undRadioButton
behoben, sodass Ankündigungen zur Barrierefreiheit nicht wiederholt werden. Zuvor wurden semantische Rollen dupliziert. (Ica281) - Wir haben die Ebene „materialcore“ 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 Foundation-Stufe
SwipeToDismissBox
inBasicSwipeToDismissBox
umbenannt. So wird die Unterscheidung zwischen der Komponente auf Foundation-Ebene und derSwipeToDismissBox
auf Material3-Ebene deutlicher. Letztere ruft Farben ausMaterialTheme
ab, die in Scrims verwendet werden sollen, und delegiert die verbleibende Implementierung anBasicSwipeToDismissBox
. (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 dem Material3-HorizontalPageIndicator
entfernt. Stattdessen wird die Form des Gerätebildschirms (linear oder rund) verwendet. (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 Untertitelfeld hinzugefügt. (Ifc45a) - Wir haben Material Design-Farb-Tokens 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. (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
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 der Wear Material3-Bibliothek hinzu. (Ifee99)
API-Änderungen
- Buttons-Code für die Verwendung von Material 3-Design-Tokens aktualisieren (I92fe4)
- Die Wear Material 3-Stepper- und ‑Slider-APIs werden als experimentell deklariert, da die Details der Benutzeroberfläche noch nicht endgültig festgelegt sind. (I84d54)
- Wir haben die Größen
ExtraSmall
aus den rundenTextButton
undTextToggleButton
entfernt, da diese Größe nur für dieIconButton
gilt. (Ibc7d5)
Fehlerkorrekturen
- Wir haben die Anleitung zur Typografie für TextToggleButton aktualisiert, sodass LabelLarge für LargeButtonSize verwendet wird (Ib10fa).
- Wir haben die Anleitung zur Typografie für TextButton aktualisiert, sodass für LargeButtonSize nun LabelLarge verwendet wird (I8f3a7).
- Wir haben den Mindestberührungszielbereich der Karte aus Gründen der Barrierefreiheit auf 48 dp festgelegt. (Ieb9b1)
- AppCard mit Bild-Demo hinzugefügt, AppCard mit Hintergrund-Demo entfernt (Id735f)
- Ein Fehler wurde behoben, bei dem Modifikatoren in runden Schaltflächen 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 Material 3 (I6bed6) hinzugefügt.
API-Änderungen
- Wir haben die Annotation
FloatRange
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äß Material3-Design aktualisiert. (Ib2495) - Wir haben die Sichtbarkeit von Häkchen in deaktivierten Status behoben. (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 Material3 hinzugefügt:
Switch
,Checkbox
,RadioButton
. (Ib918c) - Wir haben Material3
IconToggleButton
undTextToggleButton
hinzugefügt, eine kreisförmige Ein-/Aus-Schaltfläche mit einem einzelnen Slot für Symbol und Text. Für verschiedene Größen vonToggleButton
empfehlen wir die Verwendung vonModifier.touchTargetAwareSize
mit den Größen, 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 zugehörigen Theme bereitstellt. (I275fb) - Wir haben Wear Compose die Material3-
InlineSlider
hinzugefügt. Damit können Nutzer einen Wert aus einem bestimmten Bereich 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 so aktualisiert, dass sie auf
RoundedCornerShape
basieren und nicht auf „Shape“. (Idb133) - Wir haben die Höhenkonstanten für Schaltflächen öffentlich gemacht (Idbfde).
- Aktualisierte API-Dateien zum Annotieren der Kompatibilitätsunterdrückung (I8e87a, b/287516207)
- Wir haben
InlineSliderColors
in Wear Compose Material 3 so aktualisiert, dass 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 haben. (I17702)
- Wir haben Konstanten für das horizontale und vertikale Padding von Schaltflächen öffentlich gemacht. (Ieeaf7)
Fehlerkorrekturen
- Die Höhe der Schaltfläche wird jetzt bei Bedarf an Inhalte angepasst, die aufgrund großer Schriftarten für die Barrierefreiheit größer geworden sind (Iaf302).
- Wir haben eine Reihe von Schaltflächendemos aktualisiert, um Barrierefreiheitsprobleme zu beheben. (I61ce9)
Stepper
undInlineSlider
unterstützen jetzt wiederholte Klicks bei langem Drücken, sodass Sie den Wert vonStepper
undInlineSlider
schnell erhöhen/verringern können, indem Sie die Schaltflächen „+“ oder „–“ (I27359) gedrückt halten.
Version 1.0.0-alpha07
21. Juni 2023
androidx.wear.compose:compose-material3:1.0.0-alpha07
wird 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-Version, lässt aber standardmäßig Bereichssemantiken weg, was auf Entwicklerfeedback zurückzuführen ist. Wir stellenModifier.rangeSemantics
für die Fälle bereit, in denen Bereichssemantik erforderlich ist. (Ic39fd) - Wir haben
curvedText
in unsere Compose for Wear OS Material 3-Bibliothek aufgenommen. (Ia8ae3)
Fehlerkorrekturen
- Wir haben
wear.compose.foundation
als API-Abhängigkeit vonwear.compose.material3
aktualisiert (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, damit die ErweiterungsfunktiontoDisabledColor
für korrekte deaktivierte Alphawerte verwendet wird. (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
TextButton
hinzugefügt, eine runde Schaltfläche mit einem einzelnen Textfeld. Für verschiedene Größen vonTextButton
empfehlen wir die Verwendung vonModifier.touchTargetAwareSize
undExtraSmallButtonSize
,SmallButtonSize
,DefaultButtonSize
undLargeButtonSizeIcon
, die inTextButtonDefaults
bereitgestellt werden. Die Standard-TextButton
hat keinen Rahmen und einen transparenten Hintergrund für Aktionen mit geringer Gewichtung. Für Aktionen, die stark betont werden müssen, verwenden SiefilledTextButtonColors
. Für eine mittlere Betonung mit UmrissTextButton
legen Sie den Rahmen aufButtonDefaults.outlinedButtonBorder
fest. Für eine Mischung aus Umriss und Füllung 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
als Umriss dargestellt werden(I80e72).
API-Änderungen
- Wir haben den Parameter „Button label“ (Schaltflächenlabel) an das Ende verschoben, um die nachgestellte Lambda-Syntax zu unterstützen, und den Parameter „role“ (Rolle) 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
wird veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
Neue Funktionen
- Wir haben
IconButton
zu Material3 hinzugefügt, eine kreisförmige Schaltfläche mit einem einzelnen Slot für ein Symbol oder 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
, die inIconButtonDefaults
bereitgestellt werden. Wir stellen auchIconButtonDefaults.iconSizeFor
zur Verfügung, 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ächenkomponente hinzugefügt. Das ist unsere stadionförmige Schaltfläche, die in der Wear Compose-Materialbibliothek früher „Chip“ hieß. Sie wurde in „Button“ umbenannt, um sie an die Compose Material 3-Bibliothek anzugleichen. Die Standardschaltfläche hat einen gefüllten Hintergrund. Es gibt Schaltflächenvarianten für
FilledTonal
(gedämpfter Hintergrund), „Outlined“ (transparent mit dünnem Rahmen) und „Child“ (transparenter Hintergrund und kein Rahmen, für zusätzliche Aktionen mit der geringsten Hervorhebung). Runde Schaltflächen für einfache Symbole und Textinhalte folgen in einer zukünftigen Version.(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 Wear Compose Material 3 ein
DefaultTextStyle
hinzugefügt, dasPlatformTextStyle.includeFontPadding
standardmäßig auf „true“ setzt (die aktuelle Einstellung). So können wir das standardmäßige Deaktivieren des Schriftarten-Paddings in Zukunft mit den Compose-Bibliotheken synchronisieren (siehe Fix font padding in Compose for background). (I7e461)
Version 1.0.0-alpha01
22. März 2023
androidx.wear.compose:compose-material3:1.0.0-alpha01
wird veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.
Neue Funktionen
Material 3 ist die nächste Generation von Material Design und umfasst aktualisierte Designs und neu gestaltete Komponenten. Material 3 für Wear Compose ist so konzipiert, dass es mit der Material 3 Compose-Bibliothek für Android kompatibel ist. Diese erste Alphaversion enthält frühe, funktionale Implementierungen der folgenden Elemente:
Wir werden Wear Material (
androidx.wear.compose:compose-material
) und Wear Material 3 (androidx.wear.compose:compose-material3
) parallel weiterentwickeln. In zukünftigen Material3-Releases wird das Widget-Set um andere bekannte Komponenten aus Compose for Wear OS erweitert, z. B. Schaltflächen, Auswahlfelder und Schieberegler.Die Bibliotheken „Wear Material“ und „Wear Material 3“ schließen sich gegenseitig aus und sollten nicht in derselben App verwendet werden, da sie auf unterschiedliche Designs verweisen, was zu unerwarteten Inkonsistenzen führen würde.