Wear Compose Material 3
Letzte Aktualisierung | Stabile Version | Releasekandidat | Beta-Ausgabe | Alphaversion |
---|---|---|---|---|
4. Juni 2025 | - | - | 1.5.0-beta03 | - |
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 erforderlichen Artefakte hinzu:
Cool
dependencies { implementation "androidx.wear.compose:compose-foundation:1.5.0-beta03" // For Wear Material Design UX guidelines and specifications implementation "androidx.wear.compose:compose-material3:1.5.0-beta03" // For integration between Wear Compose and Androidx Navigation libraries implementation "androidx.wear.compose:compose-navigation:1.5.0-beta03" // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-beta03") // 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-beta03") // For Wear Material Design UX guidelines and specifications implementation("androidx.wear.compose:compose-material3:1.5.0-beta03") // For integration between Wear Compose and Androidx Navigation libraries implementation("androidx.wear.compose:compose-navigation:1.5.0-beta03") // For Wear preview annotations implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-beta03") // 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. 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 einer vorhandenen Anfrage Ihre Stimme geben, 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-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
liest jetzt nur den Nachrichtentext unter TalkBack vor und überspringt die Symbolsemantik. DieOpenOnPhoneDialogDefaults
wurden aktualisiert, um die ParametericonContentDescription
undcontentDescription
ausicon()
zu entfernen. Außerdem gibt es jetzt fürConfirmationDialogDefaults
-Kompositionen Modifikatorparameter fürSuccessIcon
- undFailureIcon
-Kompositionen. (Id2ae2)
Fehlerkorrekturen
- Die Reihenfolge, in der die Auswirkungen von
SurfaceTransformation
-Parametern angewendet werden, wurde geändert. Bisher wurden die Transformationen auf Wear OS-Material 3-Komponenten in der folgenden Reihenfolge angewendet: Hintergrundmaler, Containertransformation, Inhaltstransformation. Jetzt sind die ersten beiden invertiert und wir wenden einen übergebenen Modifikator dazwischen an, sodass er von Containertransformationen betroffen ist. So werden Probleme behoben, z. B. wenn ein Platzhalter-Shimmer-Effekt 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. Für die FunktionrememberRevealState
wird jetzt standardmäßig dieser Energiesparmodus verwendet. (Ie0ecb)- Die Schaltflächen für primäre und sekundäre Aktionen sollten standardmäßig
SwipeToReveal
sein. Der Fehler wurde behoben, durch den sie bei höheren Schaltflächen die maximale Höhe eingenommen haben.ButtonDefault.Height
(Ibfba1) SwipeToReveal
wurde geändert, damit die letzte Komponente, mit der interagiert wurde, zurückgesetzt wird, wenn nach rechts gewischt wird. (Ia8450)SwipeToReveal
wurde so geändert, dass der StatusRevealing
festgelegt wird, wenn sich die Endposition des Wischens zwischen den Ankern für das Enthüllen und das Enthüllte befindet und näher am Anker für das Enthüllen liegt. (If4458)- Jetzt werden die Inhalte von
ButtonGroup
in einem Layout mit Rechtsschreibrichtung korrekt invertiert (Ib378d). AnimatedText
unterstützt jetzt die Ausrichtung von Text in Richtung Rechts nach Links (I4533c)TransformingLazyColumn
Die Größe von Elementen wird jetzt richtig angepasst, wenn das unterste Element entfernt wird (Idacab)TransformingLazyColumn
führt jetzt nur noch einen Messdurchlauf durch, was die Leistung durch Verringerung der Framezeiten verbessert. (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
- Die Referenzprofile für die Bibliotheken „foundation“, „material“ und „material3“ wurden aktualisiert. (I53f06)
- Ein Fehler in
TransformingLazyColumn
wurde behoben, durch den die Größe von Elementen geändert wurde, wenn das unterste Element entfernt wurde. (Idacab) - Ein Fehler bei
TransformingLazyColumn
wurde behoben, bei dem die Liste oben oder unten in der Liste hängen blieb. (I49d00) OpenOnPhoneDialog
Unter TalkBack sollte der gekrümmte Text angesagt werden, nicht die Beschreibung des Symbolinhalts. (I4efe8)- Ein Fehler in
SwipeToReveal
wurde behoben, durch den inRevealState.currentValue
der falsche Anker gemeldet wurde, wennhasPartiallyRevealedState
auf „falsch“ gesetzt war. (I9c7cf) SwipeToReveal
-Schaltflächen zum Rückgängigmachen sind jetzt standardmäßigButtonDefaults.Height
. (I1f6c8)- Die Leistung von
BasicSwipeToDismissBox
wurde verbessert, da Canvas nicht mehr zum Zeichnen von Scrims verwendet wird. (I68f2c) - Ein Fehler bei der Barrierefreiheit im Schieberegler wurde behoben, durch den der angegebene Prozentsatz nach Updates nicht mit dem Wert übereinstimmte (I91146)
- Ein Fehler bei der
placeholderShimmer
-Implementierung 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.
Die Version 1.5.0-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.5.0-beta01 enthält die Wear Compose Material3-Bibliothek, die das neue UI-Designsystem namens Material 3 Expressive unterstützt. Wir empfehlen, von Material auf Material 3 umzustellen, um das neue visuelle Design in Apps zu nutzen und von den folgenden neuen Komponenten zu profitieren:
MaterialTheme
für aktualisierte und erweiterte Farbschemata, Typografie und Formen, die Ihren Designs sowohl Tiefe als auch Vielfalt verleihen.- Dynamische Farbthemen, mit denen automatisch ein Farbschema für Ihre App generiert wird, das zu den Farben des Zifferblatts passt.
- Neue Komponenten passen sich standardmäßig automatisch an größere Bildschirmgrößen an
- Formänderung: Runde Schaltflächenkomponenten wie
IconButton
,TextButton
,IconToggleButton
undTextToggleButton
unterstützen Variationen, die beim Drücken oder Anklicken animiert werden. EdgeButton
: Eine neue Schaltfläche mit abgerundeten Ecken und einer speziellen Form, die für die Position unten auf dem Display optimiert ist.- Scaffolds: Einführung von
AppScaffold
undScreenScaffold
zum Anlegen der Bildschirmstruktur und Koordinieren vonScrollIndicator
- undTimeText
-Animationen. - Schaltflächen: Es werden zahlreiche stadionförmige Schaltflächen mit flexiblen Ein-Slot-Containern und Mehrfach-Slot-Varianten für Schaltflächen mit Symbolen und Labels unterstützt.
CheckboxButton
undSwitchButton
werden verwendet, wenn Ein-/Aus-Schaltflächen erforderlich sind, währendRadioButton
die Auswahlschaltfläche ist. Es sind auch „geteilte“ Varianten der Ein-/Aus- und Auswahlschaltflächen verfügbar. ButtonGroup
: Hier wird eine ausdrucksstarke Gruppe von Schaltflächen in einer Zeile implementiert, die sich beim Berühren verformen.AlertDialog
-Varianten unterstützen die Schaltflächen „Ok“/„Abbrechen“ oder einEdgeButton
.ConfirmationDialog
ist verfügbar, um eine Nachricht mit einem Zeitlimit anzuzeigen. Dabei werden spezielle Animationen für den Erfolg, den Fehler und die Option „Auf dem Smartphone öffnen“ unterstützt.- Auswahlfelder: Es werden die Varianten
TimePicker
undDatePicker
sowie die Komponenten „Picker“ undPickerGroup
unterstützt, mit denen Sie eigene Auswahlbildschirme erstellen können. ProgressIndicators
– kreisförmige und lineare Fortschrittsanzeigen werden unterstützt (CircularProgressIndicator
hat segmentierte und unbestimmte Varianten).- Karten: Es stehen verschiedene Kartenvarianten zur Verfügung, darunter
TitleCard
, das spezielle Layouts für Karten mit Titel, Zeit, Untertitel oder Inhaltsfeldern bietet.TitleCard
kann auch einen Bildhintergrund haben, um die Bedeutung der Informationen auf einer Karte zu unterstreichen. - Seitenleisten: Die Komponenten
HorizontalPagerScaffold
,VerticalPagerScaffold
undAnimatedPage
koordinierenHorizontalPageIndicator
- undVerticalPagerIndicator
-Animationen.HorizontalPager
undVerticalPager
werden in der Wear Compose Foundation-Bibliothek veröffentlicht. - Platzhalter: Hier wird eine Skelettform über einer Komponente gezeichnet, wenn keine vorläufigen Inhalte verfügbar sind.
- Schieberegler und Schrittschalter: Sowohl Schieberegler als auch Schrittschalter ermöglichen es Nutzern, eine Auswahl aus einem Wertebereich zu treffen. Schieberegler sind kompakter und können segmentiert werden, während der Schrittschalter eine Vollbildkomponente ist, die in der Regel mit einer
StepperLevelIndicator
kombiniert wird. SwipeToReveal
: Damit kannst du einem Kompositionenelement zusätzliche Aktionen hinzufügen, wenn es von rechts nach links wischt.
Außerdem enthält Wear Compose Foundation 1.5.0-beta01 die folgenden neuen Komponenten:
TransformingLazyColumn
– eine Lazy-Liste, die vertikal scrollt und Skalierungs- und Morphing-Animationen unterstützt- Hierarchische Fokusgruppen: Mit diesen können Sie Kompositionen in einer Anwendung annotieren, um den aktiven Teil der Komposition im Blick zu behalten und den Fokus zu koordinieren.
- Pager:
HorizontalPager
- undVerticalPager
-Komponenten, die auf den Compose Foundation-Komponenten basieren und Wear-spezifische Verbesserungen enthalten, um die Leistung zu verbessern und die Einhaltung der Wear OS-Richtlinien zu gewährleisten.
API-Änderungen
- Die Hierarchical Focus API wurde aktualisiert:
Modifier.hierarchicalFocus
wurde inModifier.hierarchicalFocusGroup
umbenannt und der Rückrufparameter entfernt. Die Überladung vonModifier.hierarchicalFocusRequester
mit einemFocusRequester
-Parameter wurde entfernt. Es wurde eine neueCompositionLocal
,LocalScreenIsActive
, erstellt, damit Komponenten prüfen und mitteilen können, welcher Bildschirm aktiv ist. (I5ff7c). SwipeToReveal
wurde aus Wear Compose Foundation eingestellt und durchSwipeToReveal
APIs in Wear Compose Material und Wear Compose Material3 ersetzt. Ersetzen Sie Wear FoundationSwipeToReveal
-Importe durch Wear Compose Material-/Wear Compose Material3-Importe, um die APIs weiterhin verwenden zu können. (Ia147d).- Wear Compose Material3-
SwipeToReveal
-Abhängigkeiten von Foundation wurden in das Material3-Paket verschoben, z.B.RevealValue
,RevealDirection
,RevealActionType
,RevealState
undrememberRevealState
. Entwickler sollten die Importe dieser Klassen und Funktionen vonandroidx.wear.compose.foundation
zuandroidx.wear.compose.material3
ändern. (I640e6). - Die Wear Compose Material3
SwipeToReveal
API wurde so aktualisiert: Die ParameterprimaryAction
,onFullSwipe
,secondaryAction
,undoPrimaryAction
,undoSecondaryAction
undhasPartiallyRevealedState
wurden derSwipeToReveal
-Komposition hinzugefügt. Die Möglichkeit,positionalThreshold
undanimationSpec
inRevealState
anzupassen, wurde entfernt.lastActionType
,revealThreshold
und „width“ wurden ausRevealState
entfernt. Der Konstruktor vonRevealState
wurde so geändert, dass er eineRevealDirection
anstelle von Ankern akzeptiert. Die FunktionencreateRevealAnchors
, Anker undbidirectionalAnchors
wurden entfernt. DieSwipeToRevealScope
-FunktionenprimaryAction
,secondaryAction
,undoPrimaryAction
undundoSecondaryAction
wurden in Composable-Funktionen umbenannt und inPrimaryActionButton
,SecondaryActionButton
undUndoActionButton
geändert.RevealActionType
wurde als intern gekennzeichnet. (I885d0). - Die
SwipeToReveal
API wurde wie unten beschrieben aktualisiert:onFullSwipe
inonSwipePrimaryAction
umbenannt;SwipeToRevealNonAnchoredSample
inhasPartiallyRevealedState
umbenannt, um die Verwendung des Parameters anzuzeigen;actionButtonHeight
entfernt, da die Standardhöhe der Schaltfläche standardmäßig verwendet wird und eine größere Höhe mit einem Modifikator festgelegt werden kann;SmallActionButtonHeight
ausSwipeToRevealDefaults
entfernt; der Wertparameter in den Konstruktoren vonRevealValue
undRevealDirection
auf „privat“ gesetzt. (I465ce).
Fehlerkorrekturen
- Die
EdgeButton
-Verarbeitung vonScreenScaffold
wurde korrigiert, sodass nach dem Entfernen einesTransformingLazyColumn
-Elements dieEdgeButton
animiert wird. (I6d366). - Die Abhängigkeiten von Wear Compose von Compose-Bibliotheken wurden auf Version 1.8.0 aktualisiert. (I2ef3f).
- Die Bewegung des unbestimmten
CircularProgressIndicator
wurde aktualisiert, sodass es nicht mehr vorübergehend zurückgeht. (Ieddb1). - Ein
SwipeDismissableNavHost
-Fehler wurde behoben: Der Fokus wurde nach dem Wischen nach hinten nicht richtig umgeschaltet, was zu einem Fehler bei der Eingabe über die Drehscheibe führte. Dies betraf API 36 und höher, bei denen die Vorhersagefunktion für die Rückwärtsnavigation verwendet wird. (Ieddb1). - Die Dokumentation für die Hierarchical Focus API (Idf2ff) wurde geändert.
- Die Dokumentation für Schaltflächen und Karten wurde aktualisiert. Darin wird nun erläutert, wie
containerPainter
unddisabledContainerPainter
containerColor
unddisabledContainerColor
überschreiben (I4a453). - Die Änderung an
TimeText
in der vorherigen Version, durch dieBroadcastReceiver
in einen Worker-Thread verschoben wurde, wurde rückgängig gemacht, da sie Probleme bei Apps verursachte, die während der Navigation ihre eigenen Threads verwalten. (I34d02). - Die Picker-Beispiele wurden aktualisiert, um unnötige „remember“-Aufrufe zu entfernen. Stattdessen wird in Picker
rememberUpdatedState
verwendet, um die letztecontentDescription
-Lambda-Funktion zu speichern. (Icb5b1). - Die Textstile in
TimePicker
undDatePicker
wurden aktualisiert, damit Schriftartänderungen nicht mehr zu Kürzungen führen. (I26194). - Die Standardtextausrichtung von
ListHeader
undListSubHeader
ist jetzt jeweils „Zentriert“ und „Anfang“. (I78339). - Die Samples und Demos für „Wischen zum Darstellen“ in Foundation und Material wurden aktualisiert, um benutzerdefinierte Aktionen zur Barrierefreiheit anzukündigen. Die benutzerdefinierten Aktionen müssen als Semantik zum Inhalt hinzugefügt werden, nicht zum
SwipeToReveal
-Komposit selbst. (Ie92a3). - Der Standardwert für
MaxLines
fürEdgeButton
-Inhalte wurde anhand der Größe aktualisiert: „1“ für extra klein, „2“ für klein und mittel und „3“ für groß. (Ie35f6). LocalReduceMotion
wurde vereinfacht, damit der Beobachter 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, durch den das oberste sichtbare Element in der Liste nicht richtig skaliert wurde, wenn die Edge-Schaltfläche ihre volle Höhe erreicht hatte. (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 austransformedHeight
undgraphicsLayer
, wenn Sie dieselbe Funktionalität benötigen. (Ie181d)- Die
ImageButton
- undImageCard
-Kompositen wurden durchButton
- undCard/TitleCard
-Überladungen ersetzt.imageButtonColors
wurde inbuttonWithContainerPainterColors
undimageCardColors
incardWithContainerPainterColors
umbenannt. ÖffentlicheButtonDefaults.scrimBrush
undCardDefaults.scrimBrush
hinzugefügt. Die SchaltflächenimageBackgroundGradientStartColor
undimageBackgroundGradientEndColor
wurden inscrimGradientStartColor
undscrimGradientEndColor
umbenannt.CardDefaults.ImageContentPadding
inCardDefaults.CardWithContainerPainterContentPadding
umbenannt (I7b8b6) Picker
undPickerGroup
nehmen jetztcontentDescription
als Lambda an, um unnötige Neuzusammensetzungen zu vermeiden. (I002dd)
Fehlerkorrekturen
- Ein Problem wurde behoben, bei dem das unbestimmte
CircularProgressIndicator
während der Animation wackelte, wenn Breite und Höhe nicht übereinstimmten. (I76bfe) - Ein Problem wurde behoben, durch das das Layout der Edge-Schaltfläche bei einer ungültigen Größe nicht richtig angezeigt wurde. Das Layout der Edge-Schaltfläche wird jetzt nicht mehr aktualisiert, wenn die Höhe NaN ist. (I32b93)
- Der maximale Schwenkwinkel in
OpenOnPhoneDialog
wurde erhöht, damit der Standardtext „Check your phone“ (Sehen Sie Ihr Smartphone an) 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 gibt es für Google Card. Die Maler werden ausButtonColors
undCardColors
entfernt. (I8c6a1)- Platzhalter wurden aktualisiert, um die API zu vereinfachen. Wir bieten jetzt zwei Modifikatoren:
Modifier.placeholderShimmer
, um einen Schimmereffekt auf Komponentenebene anzuwenden, undModifier.placeholder
, um eine Maske auf nicht geladene Inhalte anzuwenden (Iaee7a).
Fehlerkorrekturen
- Überscrollen in die
ScrollIndicator
integriert (Icfb7f) - Leere Hintergründe und fehlende Dialogfelder beim Starten von Material 3-Dialogfeldern beheben (Ice597)
- Probleme in
FadingExpandingLabel
wurden behoben, wenn Text mehrere Zeilen umfasst. (I04eb7) - Die Abstände zwischen primären und sekundären Labels auf Schaltflächen wurden aktualisiert. (I99b7b)
ArcLarge
wurde von20sp
auf18sp
reduziert und der Buchstabenabstand beiArcLarge
undArcSmall
wurde aktualisiert. FürConfirmationDialog
/OpenOnPhoneDialog
wird jetzt der StandardwertArcLarge
verwendet, anstatt ihn durch18sp
zu überschreiben. (Id39a8)
Abhängigkeitsupdates
- Diese Bibliothek ist jetzt auf die Kotlin-Sprachebene 2.0 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
AlertDialog
Der obere Abstand 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 von
TransformingLazyColumn
wurde aktualisiert.SurfaceTransformation
bisapplyTransformation
wurden inapplyContainerTransformation
undapplyContentTransformation
aufgeteilt undcreateBackgroundPainter
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 maximiert 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 durch 18 sp zu überschreiben. (Id39a8)- Die Kopfzeilenanimation für
DatePicker
undTimePicker
wurde aktualisiert, sodass die Ausblend- und Einblendanimation als eine Federungsanimation ausgeführt wird. (I68963) PagerScaffold
wurde optimiert, indem das Lesen voncurrentPageOffsetFraction
imAnimatedPage
-Komposit vermieden wurde. (I433ef)- Alle Schriftarten wurden aktualisiert, damit standardmäßig proportionale Ziffern verwendet werden. Dies wird als der häufigste Anwendungsfall angesehen. Die Standardeinstellung „Tabelle“ führte zu zu viel Abstand zwischen bestimmten Zahlenpaaren. Bei
TimePicker
undDatePicker
wird weiterhinFontFeatureSetting=tnum
für Tabellenzahlen verwendet. (I88929) - Der ursprüngliche RSB-Eingabefokus für
TimePicker
undDatePicker
wurde korrigiert. (I1c773) - Der Standardtext bei
OpenOnPhoneDialog
wurde in „Smartphone prüfen“ geändert. (I00a3f) - Die Gewichte für
ArcLarge
undArcMedium
wurden von 600 auf 599 aktualisiert, um ein Problem zu beheben, bei dem das Gewicht 600 als fett formatiert wurde (I2a51d) - Aktualisieren Sie den
SwipeToReveal
-Abstand zwischen Inhalt und Aktionsschaltflächen sowie den Abstand zwischen Symbol und Text der Aktionsschaltflächen. (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 diese über diecontent
-Komposition bereitgestellt werden.AnimatedPage
undsnapWithSpringFlingBehaviour
sind jetzt öffentlich und können zusammen mit Wear FoundationPager
verwendet werden, um das vorherige Verhalten von M3PagerScaffold
zu erzielen. (Siehe aktualisierte Beispiele.) (Ia4724)PagerState
wurde aktualisiert. Die Compose Foundation-KlassePagerState
wurde als Basisklasse entfernt und die EigenschaftencurrentPage
,currentPageOffsetFraction
undpageCount
wurden hinzugefügt. DieGestureInclusion
-Oberfläche wurde aktualisiert und die Methode inignoreGestureStart
umbenannt. (I4ae07)LevelIndicator
-Sweep-Winkelparameter sind jetzt mitFloatRange(0, 360)
(I7e636) gekennzeichnet.- Mit
CurvedModifier.clearAndSetSemantics
können Sie die semantische Kurvenfunktion deaktivieren. BeiCurvedText
wird weiterhin standardmäßig der Text der Inhaltsbeschreibung vorgelesen. BeitimeTextCurvedText
undtimeTextSeparator
wird der Inhalt jedoch nicht mehr vorgelesen. (I4b568) AppScaffold
-Parameter für Hintergrund und Standardinhaltsfarbe hinzugefügt (I56652)- Die Standardbehandlung von Wischgesten in
HorizontalPager
wurde inPagerDefaults.gestureInclusion
umbenannt. Standardmäßig werden jetzt nur Wischgesten ignoriert, die am linken Rand der ersten Seite beginnen, und nur dann, wenn TalkBack deaktiviert ist. In anderen Fällen werden Wischgesten vom Pager nicht ignoriert und sind daher nicht für Swipe-to-Dismiss-Handler verfügbar. (Iee486) - Den Komponenten „Schaltfläche“, „Karte“ und „Listenüberschrift“ wurde der Parameter
SurfaceTransformation
hinzugefügt, damit bei Verwendung in Containern, in denen sich die Darstellung von Elementen je nach Position ändert (z. B.TransformingLazyColumn
), unterschiedliche Hintergrund- und Inhaltstransformationen angewendet werden können. (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 eingefügt werden. (Ib0f32)
- Für
SwipeToReveal
wurde die Unterstützung für eine Zone für seitliche Wischbewegungen hinzugefügt. Standardmäßig ist in FoundationSwipeToReveal
das Wischen nicht mehr zulässig, wenn die Geste am Rand beginnt. Das Standardverhalten von Material3SwipeToReveal’
ist jetzt, Wischen zu verhindern, wenn die Geste am Rand beginnt, wenn dieSwipeDirection
auf „Eine Richtung“ gesetzt ist. (I32ef0) - Es wurde die
FadingExpandingLabel
-Komposition hinzugefügt, mit der Textzeilen nacheinander eingeblendet werden können. (Ic60fa) - Für
TransformingLazyColumn
wird jetzt standardmäßig ein leerescontentPadding
verwendet, anstatt den ersten und letzten Artikel in die Mitte zu setzen. (I77ab7) SwipeToReveal
'srememberRevealState
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 von quadratischen Bildschirmen gehört ebenfalls nicht mehr zu den Wear OS-Anforderungen. Weitere Informationen finden Sie in der Einstiegsanleitung. (I9a852) - Die in
ConfirmationDialogDefaults
undOpenOnPhoneDialogDefaults
verwendeteCurvedTextStyle
wurde auf dieArcLarge
-Typografie mit der Größe18sp
und dem Buchstabenabstand1.8sp
umgestellt. (Ic9ced) - Bei
Card
,ListHeader
,RadioButton
,CheckboxButton
undSwitchButton
wird die Höhe des Inhalts standardmäßig nicht mehr eingeschränkt. Verwenden Sie bei BedarfModifier.height(IntrinsicSize.Min)
, um das vorherige Verhalten wiederherzustellen. (I80bb8) - Wir haben die Standardfarben
TimeText
undScrollIndicator
aktualisiert, um mehr Grautöne zu verwenden. Die Verwendung vonOnBackground
(Weiß) war zu dominant, wenn andere Inhalte auf dem Bildschirm wie Titel zu sehen waren. (I8b36f) - Wir haben die Zeitüberschreitung für die Animation von
TimeText
undScrollIndicator
in Scaffold-Komponenten auf 2 Sekunden reduziert. (I52021) - Wir haben die Bewegung des Dialogfelds aktualisiert, damit der Maßstab des Hintergrunds des Dialogfelds mit dem Wischen zum Schließen synchronisiert wird. (I925a9)
- Demo von M3
SwipeToReveal
mit ModifikatoredgeSwipeToDismiss
hinzufügen (I02b07) - Wir haben
DatePicker
undTimePicker
unter TalkBack eine Überschrift hinzugefügt, damit Nutzer wissen, dass sie scrollen müssen, 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 auf Displays wurde verbessert, damit mehrere Dialoge ü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
- Der Labelparameter wurde aus
SwipeToRevealScope
(primaryAction
undsecondaryAction
) entfernt. Benutzerdefinierte Aktionssemantik sollte vom Entwickler direkt dem Inhalt derSwipeToReveal
-Komponente hinzugefügt werden. (Ia67f3) - Wir haben die Präfixe „Schaltfläche“ aus den Größen, Textstilen und Farbfunktionen in
IconToggleButtonDefaults
undTextToggleButtonDefaults
entfernt (I5471d). - Wir haben die experimentelle
LocalMinimumInteractiveComponentEnforcement
(I4ad8a) entfernt. - Wir haben die
PickerGroupScope
DSL durch eine composable ersetzt. Daher haben wir die MethodepickerGroupItem
ausPickerGroupScope
entfernt und stattdessen@Composable PickerGroupItem
hinzugefügt, mit derPickerGroup
eine Auswahl hinzugefügt werden kann. Außerdem wurde der Typ des Parameters „content“ vonPickerGroup
auf@Composable PickerGroupScope.() -> Unit
aktualisiert. (Ic6aec) - Wir haben eine
LevelIndicator
-Überladung für Bruchteile hinzugefügt und den Überladungen, die einen Bereichsparameter enthalten (die sich für die Verwendung mit der Komponente „Stepper“ eignen), ein „Stepper“-Präfix hinzugefügt. (If4234) - Wir haben der API die
TransformationSpec
vonTransformingLazyColumn
hinzugefügt. Damit können die genauen Transformationen der Elemente beim Scrollen durch die TLC definiert werden. (I21856) - Wir haben
IconButtonShapes
,IconToggleButtonShapes
,TextButtonShapes
undTextToggleButtonShapes
aktualisiert, damit sie mit den Klassen „compose/material3“ (I5a081) übereinstimmen. - Wir haben
ScalingLazyColumn
,TransformingLazyColumn
undScreenScaffold
einenoverscrollEffect
-Parameter hinzugefügt. (I0cee8) - Der Parameter
swipeDirection
wurde inrememberRevealState
inrevealDirection
umbenannt. (I7472f) - Wear Pager hat jetzt eine eigene
PagerScope
, anstelle von „Schreiben“PagerScope
. (I9195b) - Wir haben das
LinearProgressIndicatorContent
-Composit entfernt. Verwenden Sie stattdessen direktLinearProgressIndicator
, damit Änderungen an Werten standardmäßig animiert werden. (I2c4ad) - Wir haben die
CircularProgressIndicatorStatic
-Kompositfunktion entfernt und eine öffentlicheDrawScope
-FunktiondrawCircularProgressIndicator
mit derselben Funktionalität hinzugefügt. Verwenden SieCircularProgressIndicator
direkt, damit Änderungen standardmäßig animiert werden. Wenn benutzerdefinierte Animationen erforderlich sind, erstellen Sie ein eigenes Composeable mitdrawCircularProgressIndicator
. (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 Einheitlichkeit mit anderen Dialogen zu sorgen. Der Parametershow
wurde invisible
umbenannt undcurvedText
wird jetzt vom Aufrufer angegeben, anstatt einen Standardwert zu haben. (Idec2d) - Wir haben
openOnPhoneCurvedText
inopenOnPhoneDialogCurvedText
(I65bdd) umbenannt. - Wir haben
ScrollIndicatorColors
hinzugefügt, umScrollIndicator
benutzerdefinierte Farben hinzuzufügen. (I9eb8c) - Es soll möglich sein, die Farbe für den Hintergrund hinter
TimeText
zu konfigurieren. (I9f5d9) - Schriftarten
ArcLarge
,ArcMedium
undArcSmall
aufCurvedTextStyle
(Iffc41) aktualisiert - Wir haben
ScreenScaffoldDefaults.contentPaddingWithEdgeButton
entfernt. (Ia923e) - Wir haben
errorDim
zuColorScheme
hinzugefügt, um Fehler mit hoher Priorität oder Notfallaktionen wie Sicherheitswarnungen, fehlgeschlagene Dialogfeld-Overlays oder Stoppschaltflächen zu kennzeichnen. (I70998)
Fehlerkorrekturen
- Wir haben
wear.compose.material3
auf Version 1.15.0 vonandroidx.core.core
(I132e9) festgelegt. - Wir haben die Leistung von Dialog verbessert, indem wir die
AppScaffold
verwendet haben, um Dialoge über andere Bildschirminhalte zu legen (I1b9a4) - Das vertikale Innenabstand von
EdgeButton
wurde reduziert. (I1a5bb) - Wir haben den Schieberegler-Schaltflächen Schaltflächen-Semantik 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
- Bei
CurvedTextStyle
haben wir den Buchstabenabstand in einen Buchstabenabstand im Uhrzeigersinn und einen Buchstabenabstand gegen den Uhrzeigersinn unterteilt. Dies ist erforderlich, da sich die Buchstaben im Uhrzeigersinn von der Grundlinie ausbreiten, während sie sich gegen den Uhrzeigersinn zusammenziehen. Daher ist ein größerer Buchstabenabstand erforderlich. (I4b848) - Wir haben
IconButtonShapes
,IconToggleButtonShapes
,TextButtonShapes
undTextToggleButtonShapes
aktualisiert, um die Konsistenz in Material3-Bibliotheken zu verbessern. Durch diese Änderung wird auch das Form-Caching eingeführt, um die Anzahl der Zuweisungen zu reduzieren. (I049fc) - Der Parameter
pressedShapeCornerSizeFraction
wurde aus dervariantAnimatedShape
-Methode inIconToggleButton
undTextToggleButton
entfernt (I58a65) - Wir führen Verbesserungen beim Rendern von gekrümmtem Text ein, einschließlich
TimeText
, der nicht mit nicht runden Bildschirmen kompatibel ist. Die Unterstützung von nicht runden Displays gehört ebenfalls nicht mehr zu den Wear OS-Anforderungen. Weitere Informationen finden Sie im Leitfaden für den Einstieg. (I1cc1c) - Wir haben die
ButtonGroupScope
vonButtonGroup
aktualisiert und die DSL-basierteButtonGroupItem
durchModifier.weight
,Modifier.minWidth
undModifier.enlargeOnPress
ersetzt. (I16c3c) - In der
ButtonGroup
API haben wir die neue modifikatorbasierteButtonGroupScope
aktualisiert:enlargeOnPress
heißt jetztanimateWidth
und nimmt einInteractionSource
anstelle vonMutableInteractionSource
an, da sie nicht mutiert werden muss. Außerdem haben wir die öffentliche KonstanteButtonGroupDefaults.DefaultMinWidth
hinzugefügt, die Standardmindestbreite von Schaltflächen in einerButtonGroup
. (Ie27ec) - Wir haben
ListHeaderDefaults.contentColor
aktualisiert, damit sie mit einem Kleinbuchstaben beginnt, da es sich um eine zusammensetzbare Property (I125a5) handelt. - Wir haben
SliderDefaults.DecreaseIcon
undSliderDefaults.IncreaseIcon
einen Parameter für die Inhaltsbeschreibung mit geeigneten Standardwerten hinzugefügt (I2e1a7). - Der Parameter
spacing
wurde inPicker
undPickerGroup
inverticalSpacing
(Ib75cc) umbenannt. - Wir haben
ConfirmationDialogDefaults.successText
undfailureText
entfernt, da davon ausgegangen wird, dass Aufrufer vonConfirmationDialog
Strings mit mehr Kontext angeben. Außerdem wurdeconfirmationCurvedText
inconfirmationDialogCurvedText
umbenannt. Der Parameter „Dialogshow
“ wurde in „sichtbar“ umbenannt, um für Einheitlichkeit mit anderen aktuellen Updates für Dialoge zu sorgen. (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
mitButton
nicht funktionierte. (Ib18a0) - Die Schriftgröße für den Titel „Large“ (Groß) wurde auf
18dp
(Ic9d52) geändert. - Wir haben den Abstand und die Größe des
AlertDialog
-Symbols aktualisiert (Iac28c). - Wir haben Inkonsistenzen bei den Unterbrechungen für große Bildschirme behoben (Bildschirme ab 225 dp gelten als groß) (I36474)
- Ein kleiner Fehler bei der Schaltflächenpositionierung 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 auf den Modus „explizite API“ umgestellt. (Iebf9f)
- Wir haben die
ScreenScaffold
- undEdgeButton
-APIs aktualisiert, damit es einfacher ist, Textabstände auf Bildschirmen mitEdgeButton
anzugeben. In der neuen API wird dersize
derEdgeButton
nur an dieEdgeButton
übergeben. DieScreenScaffold
nimmt einenedgeButtonSpacing
-Parameter für den Abstand zwischenEdgeButton
und Listeninhalt an. (I424fd) - In
DatePicker
wurden 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 unddiameter = 81.24%
als empfohlene Bildschirmhöhe festgelegt (I6f248). - Wir haben die Confirmation API aktualisiert, um ihre Verwendung als Dialogfeld widerzuspiegeln. Das Composeable heißt jetzt
ConfirmationDialog
. Die Benennung von Farben und Standardklassen wurde ebenfalls angepasst. Außerdem haben wir den Parametershow
invisible
umbenannt, um die Kompatibilität mit anderen Compose-Animations-APIs zu verbessern. Außerdem haben wirConfirmationDialogContent
,SuccessConfirmationDialogContent
undFailureConfirmationDialogContent
für Situationen verfügbar gemacht, in denen Entwickler die Dialoganimationseffekte für den Einstieg und Ausstieg anpassen müssen. (Iaeb33) - Wir haben
CircularProgressIndicatorContent
inCircularProgressIndicatorStatic
(die nicht animierte Variante vonCircularProgressIndicator
) aktualisiert, damit damit jetztCircularProgressIndicator
mit benutzerdefinierten Animationen erstellt werden kann. (I1346f) - Wir haben die Parameterreihenfolge für
ArcProgressIndicator
korrigiert und den Modifikatorparameter an den Anfang gesetzt (I4656a). - Die
SwipeToReveal
API wurde verbessert, um einen Text-Steckplatzparameter für die Labels der Aktionen (außer der sekundären Aktion) zu empfangen und Labelparameter aus der Undo-Aktion zu entfernen (I5b3db).
Fehlerkorrekturen
- Wir haben einen Fehler behoben, durch den die Haptik von
LongPress
inButton
,Card
,IconButton
undTextButton
mehrmals ausgelöst wurde (Ia8b0f) - Änderungen an der UX von
AlertDialog
: Auf großen Bildschirmen sind die Schaltflächen „Bestätigen“ und „Schließen“ jetzt kleiner. Außerdem ist der Abstand zwischen den Schaltflächen „Bestätigen“ und „Schließen“ größer. (I4f066) - Wir haben die Animationsspezifikationen für das Label der Aktionsschaltfläche der Komponente
SwipeToReveal
geändert. (Ib87fb) SwipeToReveal
wurde geändert, damit der Container gleichzeitig mit dem Text maximiert wird. (I44cf8)- Verbesserte
SwipeToReveal
, um haptisches Feedback auszuführen, wenn der Wisch den Grenzwert überschreitet, bei dem die primäre Aktion ausgeführt wird. (I23efe) - Wir haben
SwipeToReveal
so aktualisiert, dass bei Textüberlauf standardmäßig ein Auslassungszeichen für primäre Aktionen und Aktionen zum Rückgängigmachen angezeigt wird. (I71f5a) - Wir haben ein Problem behoben, das zu Rucklern bei
ButtonGroup
-Animationen geführt hat. (I63f8f) - Wir haben
AnimatedText
(I6063c) Textsemantik hinzugefügt. - Die Hintergrundskalierung wird jetzt zurückgesetzt, wenn das Dialogfeld aus der Komposition entfernt wird. Ohne diese Fehlerbehebung wäre der Startbildschirm möglicherweise in einem verkleinerten Zustand geblieben. (Id24ac)
- Wir haben den Schaltflächen in der Komponente „Stepper“ (Id6ed3) eine Formmorph-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
scrollTransform
-Modifikator fürTransformingLazyColumn
wurde neu strukturiert, was eine API-Änderung auslöste. (I0c6dc) - Wir haben
IconToggleButtonShapes
undTextToggleButtonShapes
um zwei verschiedene FormparameteruncheckedPressed
undcheckedPressed
(I85dbd) ergänzt. - Ungültige Monats-/Tagesoptionen werden jetzt in der
DatePicker
mit einer neueninvalidPickerContentColor
angezeigt, wennminDate
odermaxDate
verwendet wird. (If4541) - Wir haben die
Stepper
API umincreaseIcon
- unddecreaseIcon
-Slots erweitert. Die Inhalte dafür können wie gewohnt über das Symbol-Element erstellt werden. (Id35da) - Wir haben
dynamicColorScheme
aktualisiert, indem wir den optionalen ParameterdefaultColorScheme
entfernt und jetztColorScheme
als nullable zurückgegeben haben. Das bedeutet, dass der Aufrufer den Fallback-Fall explizit behandeln muss, wenn kein dynamisches Farbschema angegeben ist. (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. Wir empfehlen, dassCompactButton
den Inhalt umbricht, 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 das Layout vonEdgeButton
so aktualisiert, dass es unten etwas mehr Abstand als oben hat. Dadurch wird die Darstellung sowohl von Symbol- als auch von Textinhalten verbessert. (Id772a) - Wir haben
LinearProgressIndicator
Bewegung hinzugefügt undLinearProgressIndicatorContent
sichtbar gemacht, wodurch die visuellen Inhalte ohne Animationen angezeigt werden. (Idee99) - Wir haben ein neues
CircularProgressIndicatorContent
-Kompositelement hinzugefügt, mit dem die visuellen Inhalte vonCircularProgressIndicator
ohne Animationen angezeigt werden können. (Ie33d4) TransformingLazyColumn
bietet jetzt die Komposition „localLocalTransformingLazyColumnItemScope
“, mit der sichCard
,Button
undListHeader
automatisch verformen, wenn sie in einemTransformingLazyColumn
platziert werden. Anrufer können das automatische Morphing mit dem neuenTransformExclusion
-Wrapper deaktivieren. (I1652f)- Wir haben den Typ von
ButtonDefaults.shape
inRoundedCornerShape
(Iccdf2) geändert.
Fehlerkorrekturen
- Wir haben einen Fehler behoben, durch den die vorhandene Alpha im Hintergrund für
TimeText
(I1eb60) nicht berücksichtigt wurde. - Wir haben in unserer Typografie standardmäßig
TextMotion
aufAnimated
festgelegt, um Textvibrationen zu vermeiden, die durch das Anpinnen von Buchstabenglyphen an Pixelgrenzen während Skalierungsvorgängen entstehen. (I626fa) - Wir haben das Aussehen des
ScrollIndicator
aktualisiert, indem wir die Breite und die Lücke vergrößert haben, um die Sichtbarkeit zu verbessern. (Ied7cb) - Wir haben einen Fehler bei
Modifier.scrollTransform
beim Hinzufügen, Entfernen oder Verschieben von Elementen behoben. (I6830f) - Wir haben ein Problem mit der Animation runder Schaltflächen bei kurzen Tippen behoben. Bisher wurde die Mindestdauer der Animation nicht immer eingehalten. (I757a7)
- Wir haben den Schwenkwinkel für
LevelIndicator
auf 20% (d.h. 72 Grad) aktualisiert. (Idde5c) - Die Positionierung von
ScrollIndicator
wurde korrigiert, wennScalingLazyColumn
mitAutoCenteringParams
verwendet wurde. (I387dd) - Wir haben die Farben und die Typografie für
ListHeader
undListSubHeader
aktualisiert. Auch die Farben der 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, damit Animationen deaktiviert werden, 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)
- Ein Fehler wurde behoben, durch den
EdgeButton
in Paginierungskomponenten mit einer falschen Form gezeichnet werden konnte (I91db9)
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 standardmäßige Inhalte hinzugefügt, die die Uhrzeit anzeigen. (Id23b3) - Wir haben
ScrollInfoProvider
fürPagerState
vereinfacht, indem wir den Parameterorientation
entfernt haben, der nicht mehr benötigt wird. Künftig bleibtTimeText
sowohl bei horizontaler als auch bei vertikaler Seitennavigation an Ort und Stelle. (I71767) LocalHapticFeedback
bietet jetzt eine standardmäßigeHapticFeedback
-Implementierung, wenn die Vibrations-API angibt, dass Haptik unterstützt wird. Folgende Werte wurden zuHapticFeedbackType
hinzugefügt:Confirm
,ContextClick
,GestureEnd
,GestureThresholdActivate
,Reject
,SegmentFrequentTick
,SegmentTick
,ToggleOn
,ToggleOff
undVirtualKey
. Bei Wear Compose-Komponenten, die lang angeklickt werden können, wieButton
,IconButton
,TextButton
undCard
, wird jetzt die haptische RückmeldungLONG_PRESS
ausgeführt, wenn ein Handler für langes Drücken angegeben wurde. (I5083d)
Fehlerkorrekturen
- Wir haben den Antrag auf Bestätigungen aktualisiert. (I04bff)
- Die Mindest-API-Abhängigkeit für Compose-Bibliotheken wurde auf 1.7.4 aktualisiert. (I88b46)
- Für das Dialogfeld
OpenOnPhone
wurde eine neue Bewegung hinzugefügt. (I1e10a) - Wir haben einen Fehler im
LevelIndicator
behoben, sodass der Wert jetzt korrekt als „0“ angezeigt wird. (Ie95a4) - Wir haben die
HorizontalPageIndicator
- undVerticalPageIndicator
-Animationen aktualisiert. (I5c8f3) - Der unbestimmte Wert
ArcProgressIndicator
wurde um eine Animation ergänzt, bei der er sich zu einem Punkt zusammenzieht. (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 der unbestimmten kreisförmigen Fortschrittsanzeige (I2efc1) eine Bogenvariante hinzugefügt.
- Wir haben die
AlertDialogContent
- undDialog
-Kompositionen, 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; den Parameterpainter
inpainterWithPlaceholderOverlayBackgroundBrush
inoriginalPainter
umbenannt; die Sichtbarkeit vonPlaceholderState.placeholderProgression
von „öffentlich“ zu „intern“ geändert und inplaceholderShimmerProgression
umbenannt;PlaceholderDefaults
um Konstanten für die Dauer der Platzhalteranimation ergänzt. (Ie5a59) - Wir haben die
EdgeButton
API so 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
die Unterstützung für Drehknöpfe hinzugefügt, damit Nutzer Pager mit Drehknöpfen bedienen können. (I9770d) - Wir haben
MotionScheme
API-Änderungen vorgenommen, um die Nutzung zu vereinfachen und die Konsistenz zu verbessern. Eingebettete „remember“-Funktionen wurden entfernt und die integrierten Bewegungsabläufe in ein spezielles MotionScheme-Begleiterobjekt verschoben.standardMotionScheme
undexpressiveMotionScheme
wurden in „Standard“ und „Ausdrucksstark“ umbenannt. (I5fd45) - Wir haben die Unterstützung für ein dynamisches Farbschema hinzugefügt, 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 Schaltflächen-Stack-Variante entfernt werden.
AlertDialog
(I34fa9) - Wir haben eine
SwipeToReveal
-Komponente für Wear Material 3 (Ic38b2) hinzugefügt. - Wir haben die Unterstützung für das bidirektionale Wischen in
SwipeToReveal
hinzugefügt, für den seltenen Fall, dass 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 Parameter
buttonHeight
vonEdgeButton
wurde inpreferredHeight
umbenannt. (I4fab3) - Die Kotlin-Version wurde auf 1.9 (I1a14c) aktualisiert.
- Wir haben
OpenOnPhoneDialogDefaults.Icon
inOpenOnPhoneDialogDefaults.OpenOnPhoneIcon
umbenannt, um Verwechslungen mitIcon
(I0f391) zu vermeiden. - 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, die als Tokens ansonsten nur für Entwickler verfügbar waren, die die Bibliothek verwenden. (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 kreisförmige Fortschrittsanzeige hinzugefügt, die nicht genau bestimmt werden kann. (I427a7)
- Wir haben die Unterstützung für einen Fortschrittsüberlauf (> 100% Fortschritt) 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 kombiniert, um in Zukunft 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 der Schaltfläche vertikal zentriert, 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. Dieser wird von Komponenten in der gesamten Bibliothek verwendet, um Animationsspezifikationen wie Federn für ausdrucksstarke Bewegungen anzuwenden. (I54ff3)
- Wir haben der Material3-Bibliothek
AppScaffold
- undScreenScaffold
-Komponenten hinzugefügt, die Funktionen zum Koordinieren von Ebenen und Übergängen vonTimeText
undScrollIndicator
umfassen.AppScaffold
bietet eine oberste Ebene von Scaffold-Komponenten, die über allen Bildschirmen liegen. 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
bietet einen Slot für dasScrollIndicator
und animiert den Scrollindikator beim Scrollen automatisch. Außerdem gibt es eine Zeitüberschreitung, nach der der Scrollindikator bei Inaktivität ausgeblendet wird. (I047d6) - Wir haben
ScrollIndicator
mit dem neuen Material3-Design hinzugefügt. Die Größe des Vorschaubilds ist festgelegt und basiert auf dem Inhalt der ursprünglichen Liste, um Größenabweichungen zu vermeiden, wenn Lazy-Inhalte in die Liste geladen werden. (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 dem
ScreenScaffold
einen neuen Slot für eine untere Schaltfläche (z. B.EdgeButton
) hinzugefügt, die je nach gescrollten Inhalten angezeigt und deren Größe angepasst wird (I032eb) - Wir haben
Modifier.scrollTransform
undModifier.targetMorphingHeight
hinzugefügt, um Elementen inLazyColumn
Material 3-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 oder für jedes Segment „An“ oder „Aus“ angezeigt. (I6e059) - Wir haben
LinearProgressIndicator
als Alternative zuCircularProgressIndicator
hinzugefügt. (I89182) - Wir haben
AlertDialog
hinzugefügt, mit dem Layouts für die Präsentation wichtiger Prompts für den Nutzer bereitgestellt werden. Es gibt Varianten für entweder zwei Bestätigungs-/Abbruchschaltflächen oder eine einzelne Schaltfläche unten (in der Regel eine EdgeButton) unter einem Stapel von Optionen. 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 einer bestimmten Zeitüberschreitung geschlossen. (I978fd) - Wir haben
Confirmation
hinzugefügt, eine Dialogfeldkomponente mit Slots für ein Symbol und entweder gebogenen oder geraden Text. Für Erfolgs- und Fehlermeldungen gibt es bestimmte Varianten. 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, mit dem der Wert einer Einstellung wie der Lautstärke angezeigt wird. Es kann mit der vorhandenen KomponenteStepper
kombiniert werden, um einen Lautstärkebildschirm zu erstellen.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
mit Layouts für das 24-Stunden-Format (mit oder ohne Sekunden) oder das 12-Stunden-Format mit Auswahl von „Vormittags“ und „Nachmittags“ hinzugefügt. (Ia5124) - Wir haben
DatePicker
hinzugefügt, mit einer Konfiguration für die Spaltensortierung (z.B. Tag-Monat-Jahr, Monat-Tag-Jahr oder Jahr-Monat-Tag) und optionalen Mindest-/Maximaldatumsangaben. (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
AnimatedText
-Dokumentation aktualisiert, um das Überschwingen zu erläutern. (Iff30a) - Wir haben
ButtonGroup
hinzugefügt, um zwei oder drei Schaltflächen zu kombinieren, sodass durch das 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
ImageWithScrimPainter
den ParameterforcedSize
hinzugefügt, damit die Bildhintergründe von Schaltflächen jetzt standardmäßig ihre Komponentengröße beibehalten. Wenn SieforcedSize = null
festlegen, wird stattdessenPainter.instrinsicSize
übernommen. (Ic57af) - Wir haben die Funktion „Langes Drücken“ für Schaltflächen hinzugefügt (Ib613d).
- 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
LocalTextMaxLines
,LocalTextAlign
undLocalTextOverflow
zur Implementierung von UX-Richtlinien zu verwenden. Diese Parameter können von Entwicklern bei Bedarf direkt in Text überschrieben werden (Ie51f7) - Wir haben die Standardstrichbreite des
LevelIndicator
in6dp
geändert, um es von demScrollIndicator
mit einer Strichbreite von4dp
zu unterscheiden. (If6f63) - Wir haben ein Problem in
TimeText
behoben, sodass größere Schwenkwinkel 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 ein benutzerdefinierter Abstand für den Inhalt angegeben ist. (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 die Option „Zum Umschalten doppeltippen“ angezeigt wurde, wenn sie bereits ausgewählt war. (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-Schalter aktualisiert. Neben einigen Farbänderungen entspricht das Häkchen jetzt dem, das für das Kästchen verwendet wird. (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
wird 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 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 fokussierten Zustand von „Ripple“ für mehr Kontrast angepasst. (I59f0a)
- Wir haben in
Button
,ToggleButton
undRadioButton
einen Abstand zwischen primären und sekundären Labels hinzugefügt, um den neuesten Änderungen an Typografiestilen und Zeilenhöhen zu entsprechen. (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
zur Wear Compose Material3-Bibliothek hinzugefügt. Diese Komponente zeigt oben auf dem Bildschirm die aktuelle Uhrzeit (und einen zusätzlichen Status) 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. Dieser unterscheidet sich von der vorhandenenToggleButton
dadurch, dassRadioButton
auswählbar ist (und innerhalb einer Auswahlgruppe funktioniert), 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, 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 zu „null“ wechseln, wird für einige Komponenten nie eineMutableInteractionSource
zugewiesen. Bei anderen Komponenten wird eine Instanz nur bei Bedarf erstellt, was die Leistung dieser Komponenten insgesamt 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. (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 das Aktualisieren einzelner Farben in den meisten Apps nicht der Hauptanwendungsfall ist. Das ist zwar weiterhin möglich, aber es wird häufiger neu zusammengesetzt als zuvor. 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 nur noch angezeigt werden. Die Klickbehandlung wurde entfernt. 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 in Wear Compose Material 3 Tokens für Bewegungswerte von Dauern und Übergängen hinzugefügt. (I437cd)
- Wir haben einen Fehler in den
ToggleButton
-,SplitToggleButton
-,Checkbox
-,Switch
- undRadioButton
-Anzeigevarianten behoben, durch den Ansagen zur Barrierefreiheit wiederholt wurden. Zuvor 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 Basisstufe
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 Material 3HorizontalPageIndicator
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) - Wir haben die Konstruktoren von
CheckboxColors
,RadioButtonColors
undSwitchColors
veröffentlicht. (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
- Aktualisieren Sie den Code für Schaltflächen, damit Material 3-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 Typografierichtlinien für TextButton aktualisiert, um LabelLarge für LargeButtonSize zu verwenden (I8f3a7).
- Wir haben den Mindestwert für den Berührungszielbereich der Karte aus Gründen der Barrierefreiheit auf 48 dp festgelegt. (Ieb9b1)
- Demo für App-Infokarte mit Bild hinzufügen, Demo für App-Infokarte 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) - Wir haben das Problem behoben, dass das Häkchen in deaktivierten Kästchen nicht sichtbar war. (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 der Wear Compose-Funktion die Material 3-
InlineSlider
hinzugefügt. Nutzer können damit aus einem 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) - Die Höhekonstanten für Schaltflächen sind jetzt öffentlich (Idbfde).
- API-Dateien wurden aktualisiert, um die Unterdrückung der Kompatibilität zu vermerken (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 aktualisiert, damit sie öffentliche Konstruktoren und öffentliche Eigenschaften haben. (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 den Inhalt angepasst, der aufgrund von großen Schriftarten für Barrierefreiheit größer geworden ist (Iaf302)
- Wir haben einige Schaltflächen-Demos aktualisiert, um Probleme mit der Barrierefreiheit zu beheben. (I61ce9)
- Bei
Stepper
undInlineSlider
können Sie jetzt wiederholt auf die Tasten gedrückt halten, um den Wert schnell zu erhöhen oder zu verringern. Halten Sie dazu die Plus- oder Minustaste gedrückt. (I27359)Stepper
InlineSlider
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 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
curvedText
der Compose for Wear OS Material 3-Mediathek 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, 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 Material 3 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
. Das StandardsymbolTextButton
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 das umrandete SymbolTextButton
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
wird veröffentlicht. Version 1.0.0-alpha04 enthält diese Commits.
Neue Funktionen
- Wir haben Material 3 die kreisförmige Schaltfläche
IconButton
mit einem einzigen Steckplatz für ein Symbol oder Bild hinzugefügt. 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
. MitIconButtonDefaults.iconSizeFor
können Sie die empfohlene Symbolgröße für eine bestimmte Schaltflächengröße 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 sie mit der Compose Material 3-Bibliothek in Einklang zu bringen. Die Standardschaltfläche hat einen gefüllten Hintergrund. Es gibt auch Varianten 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 Betonung). Runde Schaltflächen für einfache Symbol- 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 eine
DefaultTextStyle
hinzugefügt, die standardmäßigPlatformTextStyle.includeFontPadding
auf „wahr“ (die aktuelle Einstellung) setzt. 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
wird 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 weiterentwickeln. 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 verwendet werden. Das liegt vor allem daran, dass sie auf unterschiedliche Themen verweisen, was zu unerwarteten Inkonsistenzen führen würde.