Wear Compose Material 3
| Dernière mise à jour | Version stable | Version finale | Version bêta | Version alpha |
|---|---|---|---|---|
| 27 août 2025 | 1.5.0 | - | - | - |
Déclarer des dépendances
Pour ajouter une dépendance sur Wear, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.
Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module :
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. }
Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.
Commentaires
Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.
Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.
Wear Compose Material3 version 1.5
Version 1.5.0
27 août 2025
Publication d'androidx.wear.compose:compose-*:1.5.0. La version 1.5.0 contient ces commits.
Changements importants depuis la version 1.4.0
Première version de la bibliothèque Wear Compose Material 3, qui est compatible avec le nouveau système de conception Material 3 Expressive. Cette version inclut :
- Mise à jour de
MaterialThemeet de la thématisation des couleurs dynamiques. - Nouveaux composants
AppScaffold, ScreenScaffold,HorizontalPagerScaffoldetVerticalPagerScaffoldpour structurer l'écran et coordonner les animationsScrollIndicator,TimeText,HorizontalPageIndicatoretVerticalPageIndicator. - Morphing de forme :
IconButton,TextButton,IconToggleButtonetTextToggleButton, avec des variantes qui s'animent lorsqu'elles sont appuyées ou cochées. EdgeButton, qui a une forme spéciale conçue pour le bas de l'écran.ButtonGroupimplémente un groupe expressif de boutons, sur une ligne qui change de forme au toucher.AlertDialogetConfirmationDialogavec des variantes pour le contenu de la boîte de dialogue supplémentaire.- composants
TimePickeretDatePicker. - Les indicateurs de progression incluent
CircularProgressIndicator(avec une variante segmentée),ArcProgressIndicatoretLinearProgressIndicator.
Wear Compose Foundation 1.5.0 inclut également les éléments suivants :
TransformingLazyColumn, une liste à défilement vertical différé qui prend en charge les animations de mise à l'échelle et de morphing.- Compatibilité avec la pagination dans Wear Compose Foundation avec
HorizontalPageretVerticalPager. - Groupes de mise au point hiérarchiques : utilisés pour annoter les composables d'une application afin de suivre la partie active de la composition et de coordonner la mise au point.
En savoir plus sur Material 3 Expressive pour Wear OS
Version 1.5.0-rc02
13 août 2025
Publication d'androidx.wear.compose:compose-*:1.5.0-rc02. La version 1.5.0-rc02 contient ces commits.
Correction de bugs
- Correction d'un bug dans
TimePickeroù les chaînes longues et internationalisées pour la période (AM/PM) pouvaient casser la mise en page. (I0fa81)
Version 1.5.0-rc01
30 juillet 2025
Publication d'androidx.wear.compose:compose-*:1.5.0-rc01. La version 1.5.0-rc01 contient ces commits.
Correction de bugs
TimePickerest désormais entièrement piloté par les paramètres régionaux de l'utilisateur, à l'aide deDateFormat.getBestDateTimePatternpour déterminer l'ordre et le contenu de ses sélecteurs et séparateurs. Correction de l'ordre incorrect des colonnes pour les langues CJK, résolution des problèmes de mise en page de droite à gauche dans des langues comme l'arabe, utilisation de séparateurs localisés et prise en charge des formats d'heure 0-11 et 1-12 en fonction des paramètres régionaux (I5d543)DatePickeraffiche désormais un mois numérique dans certaines langues, comme le chinois, le japonais et le coréen, pour éviter de mélanger les formats numériques et linguistiques (par exemple, 2025 | 07 | 02 au lieu de 2025 | 7月 | 02). Cette modification applique une heuristique qui vérifie si les paramètres régionaux utilisent des suffixes linguistiques pour l'année et, le cas échéant, remplace le format du mois de texte (MMM) par un format numérique (MM) pour plus de cohérence. (Ia93fe)- L'espace vertical de l'en-tête dans le composant Picker est désormais constant, ce qui évite un décalage visible lorsqu'une colonne de sélecteur est sélectionnée, en particulier en mode
Talkback. (I7f8b7) - Correction d'un bug d'accessibilité causé par l'affichage en plein écran de
HorizontalPageIndicatoretVerticalPageIndicator. Les indicateurs de page ne sont plus en plein écran et seront positionnés automatiquement lorsqu'ils seront utilisés avecHorizontalPagerScaffoldouVerticalPagerScaffold. Lorsque vous n'utilisez pas de scaffold de mise en page, spécifiez l'alignement de manière explicite à l'aide demodifier = Modifier.align(Alignment.BottomCenter)avecHorizontalPageIndicatoretmodifier =Modifier.align(Alignment.CenterEnd)avecVerticalPageIndicator. (I3a0ad) - Le sens du balayage dans
SwipeToRevealest désormais cohérent pour lesLayoutDirectionsLTR et RTL. (I6d427) - Rétablissement du centrage vertical
SwipeToRevealpour les actions. SihasPartiallyRevealedState = true,RevealStatedoit être réinitialisé surRevealValue.Coveredpar l'appelant lors du défilement. (I6473d) SwipeDismissableNavHostcoupe désormais correctement le contenu pour l'API 36 et les versions ultérieures. (Ib9a44)
Version 1.5.0-beta06
16 juillet 2025
Publication d'androidx.wear.compose:compose-*:1.5.0-beta06. La version 1.5.0-beta06 contient ces commits.
Correction de bugs
- Correction de l'animation
EdgeButtonlorsqueLazyColumnouScalingLazyColumnontreverseLayout = true. (I46a1a) - Correction d'un bug dans
ScreenScaffoldqui empêchait le fonctionnement de l'exploration tactile sous Talkback si unScrollIndicator/PageIndicatorétait fourni. (I6dcee) TransformingLazyColumnpermet désormais une déformation personnalisée à partir deTransformationSpecen lisant la valeuritemHeightfournie parTransformationSpecdans le peintre d'arrière-plan. (I6a599)- Transitions de couleur animées pour l'activation/la désactivation de
IconButton, pour assurer la cohérence avecIconToggleButton. (Ife10a) - Suppression du clamping de la section minimale dans
CircularProgressIndicatorpour éviter un saut visible vers la taille de point minimale lors de l'animation. Dans le cadre de ce changement, le paramètretargetProgressdansdrawCircularProgressIndicatorn'est plus utilisé. (I33309) - Le sélecteur possède désormais le rôle sémantique
ValuePicker, qui peut être utilisé par les lecteurs d'écran pour rendre les sélecteurs plus accessibles. Le sélecteur a également mis à jour les libellés d'accessibilité pour les clics, qui font la différence entre l'ajustement de la valeur en mode lecture seule et la sélection de la valeur actuelle dans les autres cas. (I33309)
Version 1.5.0-beta05
2 juillet 2025
Publication d'androidx.wear.compose:compose-*:1.5.0-beta05. La version 1.5.0-beta05 contient ces commits.
Correction de bugs
- Mise à jour de la documentation pour clarifier l'utilisation de
Modifier.edgeSwipeToDismiss(I78cb5) - Correction d'un bug qui pouvait afficher plusieurs éléments révélés avec
SwipeToRevealdans les listes à chargement différé (I1d4f6) - Les formes de conteneur dans
TransformingLazyColumnsont désormais mises à l'échelle pour éviter de rogner le contenu. (I9221a) - Les libellés
TimePickeretDatePickerpour les heures/minutes/secondes ou les années/mois/jours ont désormais une sémantique d'en-tête pour les lecteurs d'écran (I77d8b). - Suppression de la pause entre les boucles dans l'indicateur de progression indéterminé
CircularProgressIndicator(Iaf0bb) - Correction d'un bug d'animation dans
TransformingLazyColumnlors de la suppression d'éléments. (I73034) - Correction de la gestion des éléments d'ancrage dans
TransformingLazyColumnlorsque des éléments sont supprimés. (I841a8) PickerGroupanime désormais les sélecteurs horizontalement lorsque le centrage automatique est activé et que le sélecteur sélectionné (centré) est modifié. (Ic82c4)
Version 1.5.0-beta04
18 juin 2025
Publication d'androidx.wear.compose:compose-*:1.5.0-beta04. La version 1.5.0-beta04 contient ces commits.
Correction de bugs
- Correction d'un bug de mise en page dans
TransformingLazyColumn, où le contenu qui tient sur l'écran est désormais correctement aligné en haut de l'écran (I80115). - Correction d'un problème lié à
TransformingLazyColumn, où l'élément du bas était mis à l'échelle de manière incorrecte lors du défilement tout en bas d'une liste avec unEdgeButton. La progression du défilement suit désormais une descente de gradient lors de la restauration de la mise en page. (Iea375) TransformingLazyColumnlit désormais la hauteur de l'élément à l'intérieur du peintre d'arrière-plan, ce qui permet àTransformationSpecspersonnalisé d'implémenter la morphose. (I022f0)SwipeToRevealcentre désormais correctement les actions révélées verticalement. (I4419b)- Correction d'un bug dans
SwipeToRevealqui l'empêchait de fonctionner correctement avec le balayage pour fermer si les vues et Compose étaient utilisés à l'écran. (I5dc0e) - Correction d'un bug qui entraînait un décalage vertical des actions
SwipeToReveallors du défilement. (I29444) AlertDialog,ConfirmationDialog,OpenOnPhoneDialogetSwipeToRevealarrondissent désormais les marges intérieures et les tailles calculées en pourcentage de la taille de l'écran. (I76367)ButtonDefaults.outlinedButtonBordermet désormais à jour la taille en fonction de l'état activé/désactivé(If2ddd).- Correction d'un bug de hauteur
EdgeButtonqui se produisait sur les écrans complexes avec Pager etScreenScaffold. (I946e3) - Correction d'une condition de concurrence pouvant entraîner l'arrêt des animations d'espace réservé. (I53530)
- Amélioration des performances de
HorizontalPageIndicatoretVerticalPageIndicatoren dessinant dans Canvas. (Ifae1e) - La forme d'EdgeButton a été affinée pour adoucir les transitions entre les points de suspension et les cercles qui composent le contour. (I7721e)
- Correction d'un bug dans
LevelIndicatorqui entraînait l'arrêt des animations en raison de recompositions inutiles. (I45d08)
Version 1.5.0-beta03
4 juin 2025
Publication d'androidx.wear.compose:compose-*:1.5.0-beta03. La version 1.5.0-beta03 contient ces commits.
Modifications apportées à l'API
OpenOnPhoneDialogn'annonce désormais que le texte du message sous TalkBack et ignore la sémantique des icônes. LesOpenOnPhoneDialogDefaultsont été mis à jour pour supprimer le paramètreiconContentDescriptionetcontentDescriptiondeicon(). De plus,ConfirmationDialogDefaultspossède désormais des paramètres de modificateur sur les composablesSuccessIconetFailureIcon. (Id2ae2)
Correction de bugs
- Modification de l'ordre dans lequel nous appliquons l'effet des paramètres
SurfaceTransformation. Auparavant, les transformations appliquées aux composants Wear Material3 étaient effectuées comme suit : peintre d'arrière-plan, transformation du conteneur, transformation du contenu. Désormais, les deux premiers sont inversés et nous appliquons tout modificateur transmis entre eux, de sorte qu'il soit affecté par les transformations de conteneur. Cela corrige les cas tels que l'utilisation d'un effet shimmer d'espace réservé avec des éléments dans un TLC à l'aide du paramètre de transformation. (I786cf) RevealState.Savera été ajouté pour restaurer l'état deSwipeToReveallorsque l'activité ou le processus sont recréés. La fonctionrememberRevealStateutilise désormais ce Saver par défaut. (Ie0ecb)- Les boutons d'action principaux et secondaires
SwipeToRevealdoivent être définis par défaut surButtonDefault.Height(correction d'un bug qui faisait que ces boutons remplissaient la hauteur maximale pour les boutons plus grands). (Ibfba1) - Modification de
SwipeToRevealpour réinitialiser le dernier composant avec lequel l'utilisateur a interagi lorsque le geste de balayage vers la droite est effectué. (Ia8450) SwipeToReveala été modifié pour s'établir sur l'étatRevealinglorsque la position de fin du balayage se situe entre les ancres de masquage et de dévoilement, et est plus proche de l'ancre de masquage. (If4458)- Le contenu de
ButtonGroupest désormais correctement inversé dans une mise en page RTL (Ib378d). AnimatedTextest désormais compatible avec le texte de droite à gauche (I4533c).TransformingLazyColumnredimensionne désormais correctement les éléments lorsque l'élément du bas est supprimé (Idacab).TransformingLazyColumnn'effectue désormais qu'une seule passe de mesure, ce qui améliore les performances en réduisant les temps de frame. (I501a1)
Version 1.5.0-beta02
20 mai 2025
Publication d'androidx.wear.compose:compose-*:1.5.0-beta02. La version 1.5.0-beta02 contient ces commits.
Correction de bugs
- Mise à jour des profils de référence pour les bibliothèques foundation, material et material3. (I53f06)
- Correction d'un bug dans
TransformingLazyColumn, où les éléments étaient redimensionnés lorsque l'élément du bas était supprimé. (Idacab) - Correction d'un bug avec
TransformingLazyColumn, lorsque la liste restait bloquée en haut ou en bas. (I49d00) OpenOnPhoneDialogsous TalkBack doit annoncer le texte incurvé, et non la description du contenu de l'icône. (I4efe8)- Correction d'un bug dans
SwipeToRevealqui signalait le mauvais ancrage dansRevealState.currentValuelorsquehasPartiallyRevealedStateétait défini sur "false". (I9c7cf) - Les boutons d'annulation
SwipeToRevealsont désormaisButtonDefaults.Heightpar défaut. (I1f6c8) - Les performances de
BasicSwipeToDismissBoxont été améliorées en éliminant l'utilisation de Canvas pour dessiner les caches. (I68f2c) - Correction d'un bug d'accessibilité dans le curseur, où le pourcentage annoncé ne correspondait pas à la valeur après les mises à jour (I91146).
- Correction d'un bug lié à l'implémentation de
placeholderShimmer. (Iee39b - Les performances de
TransformingLazyColumnont été améliorées en optimisant le calcul deScrollProgressde 30 %. (I4c4cb)
Version 1.5.0-beta01
7 mai 2025
Publication d'androidx.wear.compose:compose-*:1.5.0-beta01. La version 1.5.0-beta01 contient ces commits.
La version 1.5.0-beta01 de Compose pour Wear OS indique que cette version de la bibliothèque est complète et que l'API est verrouillée (sauf si elle est marquée comme expérimentale).
Wear Compose 1.5.0-beta01 inclut la bibliothèque Wear Compose Material3, qui est compatible avec le nouveau système de conception d'UI appelé Material 3 Expressive. Nous vous recommandons de passer de Material à Material3 pour adopter la nouvelle conception visuelle dans les applications et bénéficier des nouveaux composants comme suit :
MaterialThemepour des jeux de couleurs, une typographie et des formes mis à jour et étendus afin d'apporter à la fois de la profondeur et de la variété à vos conceptions.- La thématisation des couleurs dynamiques, qui génère automatiquement un jeu de couleurs pour votre application afin qu'il corresponde aux couleurs du cadran.
- Les nouveaux composants s'adaptent automatiquement aux écrans plus grands par défaut
- Morphing de forme : les composants de bouton rond tels que
IconButton,TextButton,IconToggleButtonetTextToggleButtonsont compatibles avec les variantes qui s'animent lorsqu'elles sont appuyées ou cochées. EdgeButton: nouveau bouton bord à bord avec une forme spéciale conçu pour le bas de l'écran.- Scaffolds : présentation de
AppScaffoldetScreenScaffoldpour structurer l'écran et coordonner les animationsScrollIndicatoretTimeText. - Boutons : de nombreux boutons en forme de stade sont compatibles avec des conteneurs flexibles à un emplacement et des variantes à plusieurs emplacements pour les boutons avec icônes et libellés.
CheckboxButtonetSwitchButtonsont fournis lorsque des boutons bascule sont nécessaires, tandis queRadioButtonest le bouton de sélection disponible (des variantes "Split" des boutons bascule et de sélection sont également fournies). ButtonGroup: implémente un groupe expressif de boutons sur une ligne qui se transforment au toucher.- Les variantes
AlertDialogsont compatibles avec les boutons "OK" et "Annuler" ou avec unEdgeButton. ConfirmationDialogest disponible pour afficher un message avec un délai d'expiration, et prend en charge les animations spéciales pour les variantes de réussite, d'échec et d'ouverture sur téléphone.- Les sélecteurs – les variantes
TimePickeretDatePickersont acceptées, ainsi que les composants Picker etPickerGrouppour créer vos propres écrans de sélecteur. - Les indicateurs de progression circulaires et linéaires
ProgressIndicatorssont acceptés (CircularProgressIndicatorcomporte des variantes segmentées et indéterminées). - Cartes : plusieurs variantes de cartes sont disponibles, y compris
TitleCard, qui propose des mises en page spécifiques pour les cartes avec des emplacements pour le titre, l'heure, le sous-titre ou le contenu.TitleCardpeut également être associé à une image d'arrière-plan pour renforcer la signification des informations d'une fiche. - Les composants de pagination
HorizontalPagerScaffold,VerticalPagerScaffoldetAnimatedPagecoordonnent les animationsHorizontalPageIndicatoretVerticalPagerIndicator.HorizontalPageretVerticalPagersont publiés dans la bibliothèque Wear Compose Foundation. - Espaces réservés : dessinent une forme squelettique sur un composant, dans les cas où aucun contenu provisoire n'est disponible.
- Curseurs et steppers : les curseurs et les steppers permettent aux utilisateurs de faire un choix parmi une plage de valeurs. Les curseurs sont plus compacts et peuvent être segmentés, tandis que le sélecteur est un composant plein écran généralement associé à un
StepperLevelIndicator. SwipeToReveal: permet d'ajouter des actions supplémentaires à un composable lorsqu'il est balayé de droite à gauche.
Wear Compose Foundation 1.5.0-beta01 inclut également les nouveaux composants suivants :
TransformingLazyColumn: liste à défilement vertical différé qui accepte les animations de mise à l'échelle et de morphing- Groupes de mise au point hiérarchiques : utilisés pour annoter les composables d'une application, pour suivre la partie active de la composition et coordonner la mise au point.
- Composants Pagers :
HorizontalPageretVerticalPager, basés sur les composants Compose Foundation avec des améliorations spécifiques à Wear pour améliorer les performances et la conformité aux consignes Wear OS.
Modifications apportées à l'API
- Mise à jour de l'API Hierarchical Focus :
Modifier.hierarchicalFocusa été renomméModifier.hierarchicalFocusGroupet le paramètre de rappel a été supprimé. La surcharge deModifier.hierarchicalFocusRequesteravec un paramètreFocusRequestera été supprimée. De nouvellesCompositionLocaletLocalScreenIsActiveont été créées afin que les composants puissent informer et vérifier quel écran est actif. (I5ff7c). - Abandon de
SwipeToRevealde Wear Compose Foundation au profit des APISwipeToRevealdans Wear Compose Material et Wear Compose Material3. Veuillez remplacer les importations Wear FoundationSwipeToRevealpar des importations Wear Compose Material/ Wear Compose Material3 pour continuer à utiliser les API. (Ia147d). - Les dépendances
SwipeToRevealWear Compose Material3 sur Foundation ont été déplacées vers le package material3, par exempleRevealValue,RevealDirection,RevealActionType,RevealState,rememberRevealState. Les développeurs doivent remplacer leurs importations de ces classes et fonctions deandroidx.wear.compose.foundationparandroidx.wear.compose.material3. (I640e6). - Mise à jour de l'API
SwipeToRevealWear Compose Material3 : ajout des paramètresprimaryAction,onFullSwipe,secondaryAction,undoPrimaryAction,undoSecondaryActionethasPartiallyRevealedStateau composableSwipeToReveal; suppression de la possibilité de personnaliserpositionalThresholdetanimationSpecà partir deRevealState; suppression delastActionType,revealThresholdet de la largeur deRevealState; modification du constructeurRevealStatepour qu'il accepte unRevealDirectionau lieu d'ancres ; suppression des fonctionscreateRevealAnchors, d'ancres etbidirectionalAnchors; les fonctionsSwipeToRevealScopeprimaryAction,secondaryAction,undoPrimaryActionetundoSecondaryActionont été renomméesPrimaryActionButton,SecondaryActionButtonetUndoActionButtonet transformées en fonctions composables ;RevealActionTypea été marqué comme interne. (I885d0). - Mise à jour supplémentaire de l'API
SwipeToRevealcomme suit :onFullSwiperenommé enonSwipePrimaryAction;SwipeToRevealNonAnchoredSamplerenommé pour indiquer l'utilisation du paramètrehasPartiallyRevealedState;actionButtonHeightsupprimé, car la hauteur par défaut est celle du bouton et la hauteur supérieure peut être définie à l'aide d'un modificateur ;SmallActionButtonHeightsupprimé deSwipeToRevealDefaults; paramètre de valeur dans les constructeursRevealValueetRevealDirectionrendu privé. (I465ce).
Correction de bugs
- Correction de la gestion de
EdgeButtonparScreenScaffoldafin que, après la suppression d'un élémentTransformingLazyColumn,EdgeButtonsoit animé pour se mettre en place. (I6d366). - Mise à jour des dépendances Wear Compose sur les bibliothèques Compose vers la version 1.8.0. (I2ef3f).
- Mise à jour du mouvement de l'
CircularProgressIndicatorindéterminé afin qu'il ne régresse plus temporairement. (Ieddb1) - Correction d'un bug
SwipeDismissableNavHost: la sélection ne basculait pas correctement après un balayage vers l'arrière, ce qui entraînait l'échec de la saisie par rotation (pour l'API 36 et versions ultérieures, qui utilisent la prévisualisation du Retour). (Ieddb1) - Documentation modifiée pour l'API Hierarchical Focus (Idf2ff).
- Mise à jour de la documentation pour les boutons et les cartes afin d'indiquer comment
containerPainteretdisabledContainerPainterremplacentcontainerColoretdisabledContainerColor(I4a453). - Rétablissement d'une modification apportée à
TimeTextdans la version précédente, qui avait déplacéBroadcastReceiververs un thread de worker, car cela posait des problèmes pour les applications qui gèrent leur propre threading lors de la navigation. (I34d02). - Mise à jour des exemples de sélecteur pour supprimer les appels "remember" inutiles et utiliser plutôt
rememberUpdatedStatedans le sélecteur pour mémoriser la dernière fonction lambdacontentDescription. (Icb5b1). - Mise à jour des styles de texte dans
TimePickeretDatePickerafin que les modifications de police n'entraînent plus de troncature. (I26194). ListHeaderetListSubHeaderalignent désormais le texte par défaut au centre et au début, respectivement. (I78339).- Mise à jour des exemples et des démos de Foundation et Material Swipe to Reveal pour annoncer des actions d'accessibilité personnalisées (les actions personnalisées doivent être ajoutées en tant que sémantiques sur le contenu, et non sur le composable
SwipeToReveallui-même). (Ie92a3). - La valeur par défaut de
MaxLinesdéfinie sur le contenuEdgeButtona été mise à jour en fonction de sa taille : elle est désormais de 1 pour les tailles XS, de 2 pour les tailles S et M, et de 3 pour les tailles L. (Ie35f6). LocalReduceMotionsimplifié pour que l'observateur ne soit enregistré qu'une seule fois, afin d'améliorer les performances. (Ib1979).- Le nombre de redessins dans
ScrollIndicatora été réduit pour améliorer les performances. (Ia7a67). - Correction d'un bug dans
TransformingLazyColumn, où l'élément visible en haut de la liste ne s'adaptait pas correctement lorsque EdgeButton atteignait sa hauteur maximale. (I30580).
Wear Compose Material3 version 1.0
Version 1.0.0-alpha37
23 avril 2025
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha37. La version 1.0.0-alpha37 contient ces commits.
Modifications apportées à l'API
- Suppression de
scrollTransformde la surface de l'API publique. Utilisez la combinaison des modificateurstransformedHeightetgraphicsLayersi vous avez besoin de la même fonctionnalité. (Ie181d) - Remplacement des composables
ImageButtonetImageCardpar les surchargesButtonetCard/TitleCard, respectivement. Remplacement du nomimageButtonColorsparbuttonWithContainerPainterColorset du nomimageCardColorsparcardWithContainerPainterColors. Ajout deButtonDefaults.scrimBrushetCardDefaults.scrimBrushpublics. Les boutonsimageBackgroundGradientStartColoretimageBackgroundGradientEndColoront été renommésscrimGradientStartColoretscrimGradientEndColor. Changement de nom :CardDefaults.ImageContentPaddingdevientCardDefaults.CardWithContainerPainterContentPadding. (I7b8b6) PickeretPickerGroupacceptent désormaiscontentDescriptionen tant que lambda pour éviter les recompositions inutiles. (I002dd)
Correction de bugs
- Correction d'un problème qui entraînait le vacillement de
CircularProgressIndicatorindéterminé pendant l'animation si la largeur n'était pas égale à la hauteur. (I76bfe) - Correction d'un problème lié à la mise en page des boutons de bordure lorsque la taille n'est pas valide. Empêche désormais la mise à jour de la mise en page du bouton Edge lorsque la hauteur est NaN. (I32b93)
- Augmentation de l'angle de balayage maximal dans
OpenOnPhoneDialogafin que le texte par défaut "Vérifier votre téléphone" ne soit pas coupé avec la plus grande taille de police. (I90af9)
Version 1.0.0-alpha36
9 avril 2025
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha36. La version 1.0.0-alpha36 contient ces commits.
Modifications apportées à l'API
ButtonDefaults.imageBackgroundButtonColorsa été remplacé parImageButton,ButtonDefaults.imageButtonColors,ButtonDefaults.containerPainteretButtonDefaults.disabledContainerPainter. Et des modifications similaires pour Card. Les peintres sont supprimés deButtonColorsetCardColors. (I8c6a1)- Mise à jour des espaces réservés pour simplifier l'API. Nous fournissons désormais deux modificateurs :
Modifier.placeholderShimmerpour appliquer un effet scintillant au niveau du composant etModifier.placeholderpour appliquer un masque sur le contenu non chargé (Iaee7a).
Correction de bugs
- Intégration du défilement hors limites dans
ScrollIndicator. (Icfb7f) - Correction des arrière-plans vides et des boîtes de dialogue manquantes lors du lancement des boîtes de dialogue material3. (Ice597)
- Correction des problèmes dans
FadingExpandingLabellorsque le texte s'étend sur plusieurs lignes. (I04eb7) - Mise à jour de la marge intérieure entre les libellés principal et secondaire sur les boutons. (I99b7b)
ArcLargeest passé de20spà18sp, et l'espacement entre les lettres deArcLargeetArcSmalla été modifié.ConfirmationDialog/OpenOnPhoneDialogutilisent désormais la valeur par défautArcLargeau lieu de la remplacer par18sp. (Id39a8)
Mises à jour des dépendances
- Cette bibliothèque cible désormais le langage Kotlin 2.0 et nécessite KGP 2.0.0 ou version ultérieure. (Idb6b5)
Version 1.0.0-alpha35
26 mars 2025
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha35. La version 1.0.0-alpha35 contient ces commits.
Modifications apportées à l'API
- La marge intérieure supérieure
AlertDialogest désormais réduite par défaut lorsqu'une icône est fournie. Cela permet d'utiliser au mieux la taille d'écran disponible. (Ief06c) - Le compte de service (
PagerScaffoldDefaults.FadeOutAnimation) a été renomméPagerScaffoldDefaults.FadeOutAnimationSpec. Le paramètre de page surAnimatedPagea été renommépageIndex. (I701f2) - Mise à jour des noms pour la division
SurfaceTransformationdeTransformingLazyColumn:applyTransformationdivisé enapplyContainerTransformationetapplyContentTransformation, etcreateBackgroundPainterrenommécreateContainerPainter. Mise à jour des noms deTransformationSpecetResponsiveTransformationSpec. (I1c534) AppScaffold backgroundColora été renommécontainerColor. (I4e63f)
Correction de bugs
- Correction d'un problème dans
FadingExpandingLabelqui empêchait parfois le texte de se développer correctement. (I0e773) - La taille de la police de
ArcLargea été réduite de 20 sp à 18 sp, et l'espacement des lettres deArcLargeetArcSmalla été modifié.ConfirmationDialog/OpenOnPhoneDialogutilise désormais la valeur par défautArcLargeau lieu de la remplacer par 18 sp. (Id39a8) - Mise à jour de l'animation d'en-tête pour les éléments basés sur
DatePickeretTimePicker, de sorte que l'animation de fondu sortant et de fondu entrant agisse comme une seule animation de rétroaction. (I68963) - Optimisation de
PagerScaffolden évitant la lecture decurrentPageOffsetFractiondans le composableAnimatedPage. (I433ef) - Toutes les échelles typographiques ont été mises à jour pour utiliser des chiffres proportionnels par défaut. En effet, il s'agit du cas d'utilisation le plus fréquent, et le fait de définir les chiffres tabulaires par défaut entraînait un espacement trop important entre certaines paires de nombres.
TimePickeretDatePickercontinuent d'appliquerFontFeatureSetting=tnumpour les chiffres tabulaires. (I88929) - Correction du focus d'entrée RSB initial pour
TimePickeretDatePicker. (I1c773) - Le texte par défaut sur
OpenOnPhoneDialoga été remplacé par "Vérifiez votre téléphone". (I00a3f) - Mise à jour des pondérations pour
ArcLargeetArcMediumde 600 à 599 afin de contourner un problème où la pondération 600 est traitée comme du texte en gras (I2a51d) - Mise à jour des marges intérieures
SwipeToRevealentre le contenu et les boutons d'action, ainsi que de la marge intérieure entre l'icône et le texte des boutons d'action. (Ic46cb)
Version 1.0.0-alpha34
12 mars 2025
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha34. La version 1.0.0-alpha34 contient ces commits.
Modifications apportées à l'API
PagerScaffoldn'émet plus de composantPager. Il doit désormais être fourni via le composablecontent.AnimatedPageetsnapWithSpringFlingBehavioursont désormais publiques et peuvent être utilisées avecPagerWear Foundation pour obtenir le comportementPagerScaffoldM3 précédent. (Consultez les exemples mis à jour.) (Ia4724)- Mise à jour de
PagerState, suppression de Compose FoundationPagerStateen tant que classe de base et ajout des propriétéscurrentPage,currentPageOffsetFractionetpageCount. Mise à jour de l'interfaceGestureInclusion, avec changement de nom de la méthode enignoreGestureStart. (I4ae07) - Les paramètres d'angle de balayage
LevelIndicatorsont désormais annotés avecFloatRange(0, 360)(I7e636). - Nous avons ajouté
CurvedModifier.clearAndSetSemanticspour permettre de désactiver la sémantique des courbes.CurvedTextcontinue de définir par défaut la description du contenu sur le texte, maistimeTextCurvedTextettimeTextSeparatorn'annoncent plus leur contenu. (I4b568) - Ajout de paramètres de couleur d'arrière-plan et de contenu par défaut à
AppScaffold. (I56652) - La gestion par défaut des gestes de balayage de
HorizontalPagera été renomméePagerDefaults.gestureInclusion. Le comportement par défaut consiste désormais à ignorer uniquement les gestes de balayage qui commencent sur le bord gauche de la première page, et uniquement lorsque Talkback est désactivé. Dans les autres cas, le comportement par défaut est que les gestes de balayage ne seront pas ignorés par le pager. Ils ne seront donc pas disponibles pour les gestionnaires de balayage pour fermer. (Iee486) - Ajout d'un paramètre
SurfaceTransformationaux composants d'en-tête de bouton, de fiche et de liste, afin qu'ils puissent appliquer différentes transformations d'arrière-plan et de contenu lorsqu'ils sont utilisés dans des conteneurs qui modifient l'apparence des éléments en fonction de leur position, tels queTransformingLazyColumn. (Iabe3f) - Nous avons mis à jour les propriétés "public const val" de notre API Wear Compose Material3 en "public val" pour éviter que les valeurs ne soient intégrées. (Ib0f32)
- Ajout de la prise en charge d'une zone de balayage sur le bord à
SwipeToReveal. Le comportement par défaut de FoundationSwipeToRevealconsiste désormais à interdire le balayage lorsque le geste commence sur le bord. Le comportement par défaut deSwipeToReveal’Material3 consiste désormais à interdire le balayage lorsque le geste commence sur le bord, lorsqueSwipeDirectionest défini sur une seule direction. (I32ef0) - Ajout du composable
FadingExpandingLabel, qui permet d'afficher le texte progressivement avec une animation ligne par ligne. (Ic60fa) TransformingLazyColumnutilise désormais descontentPaddingvides par défaut au lieu de placer les premier et dernier éléments au centre. (I77ab7)- Suppression de
rememberRevealStatedeSwipeToRevealde la bibliothèque Wear Compose Material3. (I8c0e0)
Correction de bugs
- Les bibliothèques Wear Compose ont été mises à jour vers le compilateur Kotlin 2.0. (I2de79)
- La prise en charge des
ScrollIndicatoretPageIndicatornon arrondis a été supprimée de Material3. La prise en charge des écrans carrés ne fait plus partie des exigences Wear OS. Pour en savoir plus, consultez le guide de démarrage. (I9a852) - Le
CurvedTextStyleutilisé dansConfirmationDialogDefaultsetOpenOnPhoneDialogDefaultsa été mis à jour pour utiliser la typographieArcLargeavec la taille18spet l'espacement des lettres1.8sp. (Ic9ced) Card,ListHeader,RadioButton,CheckboxButtonetSwitchButtonne contraignent plus la hauteur de leur contenu par défaut. Si nécessaire, utilisezModifier.height(IntrinsicSize.Min)pour restaurer le comportement précédent. (I80bb8)- Nous avons mis à jour les couleurs par défaut de
TimeTextetScrollIndicatorpour inclure davantage de tons gris. En effet, l'utilisation directe deOnBackground(blanc) avait trop d'impact visuel par rapport aux autres contenus à l'écran, comme les titres. (I8b36f) - Nous avons réduit le délai d'expiration pour l'animation des
TimeTextetScrollIndicatordans les composants de canevas à deux secondes. (I52021) - Nous avons modifié le mouvement de la boîte de dialogue afin que la mise à l'échelle de l'arrière-plan de la boîte de dialogue soit synchronisée avec le balayage pour la fermer. (I925a9)
- Ajout d'une démo de
SwipeToRevealM3 à l'aide du modificateuredgeSwipeToDismiss. (I02b07) - Nous avons ajouté un titre à
DatePickeretTimePickersous TalkBack pour informer l'utilisateur qu'il doit faire défiler l'écran pour définir la date et l'heure. (Id738d) AnimatedTextsuit désormais le paramètre de réduction du mouvement. (Ib6578)- L'optimisation de l'utilisation de
AppScaffoldpour afficher le contenu de la boîte de dialogue a été améliorée afin de permettre l'affichage de plusieurs boîtes de dialogue les unes sur les autres (I1209c).
Version 1.0.0-alpha33
26 février 2025
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha33. La version 1.0.0-alpha33 contient ces commits.
Modifications apportées à l'API
- Nous avons supprimé le paramètre "label" de
primaryActionetsecondaryActiondeSwipeToRevealScope. Les développeurs doivent ajouter la sémantique des actions personnalisées directement au contenu du composantSwipeToReveal. (Ia67f3) - Nous avons supprimé les préfixes "Button" (Bouton) des tailles, des styles de texte et des fonctions de couleur dans
IconToggleButtonDefaultsetTextToggleButtonDefaults(I5471d). - Nous avons supprimé la
LocalMinimumInteractiveComponentEnforcementexpérimentale (I4ad8a). - Nous avons remplacé le DSL
PickerGroupScopepar un composable. Nous avons donc supprimé la méthodepickerGroupItemdePickerGroupScopeet ajouté@Composable PickerGroupItem, qui doit être utilisé pour ajouter un sélecteur àPickerGroup. Nous avons également modifié le type du paramètrePickerGroup"content" en@Composable PickerGroupScope.() -> Unit. (Ic6aec) - Nous avons ajouté une surcharge
LevelIndicatorpour les valeurs fractionnaires et un préfixe Stepper aux surcharges qui incluent un paramètre de plage (qui conviennent à l'utilisation avec le composant Stepper). (If4234) - Nous avons ajouté
TransformationSpecdeTransformingLazyColumnà l'API, ce qui permet de définir les transformations exactes qui se produisent sur les éléments lorsqu'ils défilent dans le TLC. (I21856) - Nous avons mis à jour
IconButtonShapes,IconToggleButtonShapes,TextButtonShapesetTextToggleButtonShapespour qu'ils soient cohérents avec les classes compose/material3 (I5a081). - Nous avons ajouté un paramètre
overscrollEffectàScalingLazyColumn,TransformingLazyColumnetScreenScaffold. (I0cee8) - Nous avons renommé le paramètre
swipeDirectionenrevealDirectiondansrememberRevealState. (I7472f) - Wear Pager dispose désormais de son propre
PagerScopeau lieu d'utiliser ComposePagerScope. (I9195b) - Nous avons supprimé le composable
LinearProgressIndicatorContent. Veuillez utiliserLinearProgressIndicatordirectement afin que les modifications apportées aux valeurs soient animées par défaut. (I2c4ad) - Nous avons supprimé le composable
CircularProgressIndicatorStaticet ajouté une fonction publiqueDrawScopedrawCircularProgressIndicatoravec les mêmes fonctionnalités. Veuillez utiliserCircularProgressIndicatordirectement pour que les modifications soient animées par défaut, mais créez votre propre composable à partir dedrawCircularProgressIndicatorsi des animations personnalisées sont nécessaires. (Ie762f) - Nous avons réorganisé les paramètres dans
DrawScope.drawCircularProgressIndicatorpour déplacer le paramètretargetProgressvers le haut. (I8ab92) - L'API
OpenOnPhoneDialoga été mise à jour pour plus de clarté et de cohérence avec les autres boîtes de dialogue. Le paramètreshowa été renommévisible, etcurvedTextest désormais fourni par l'appelant au lieu d'avoir une valeur par défaut. (Idec2d) - Nous avons renommé
openOnPhoneCurvedTextenopenOnPhoneDialogCurvedText(I65bdd) - Nous avons ajouté
ScrollIndicatorColorspour fournir des couleurs personnalisées àScrollIndicator. (I9eb8c) - Autorisez la configuration de la couleur utilisée pour dessiner un arrière-plan derrière
TimeText. (I9f5d9) - Mise à jour des typographies
ArcLarge,ArcMediumetArcSmallpour qu'elles soientCurvedTextStyle(Iffc41) - Nous avons supprimé
ScreenScaffoldDefaults.contentPaddingWithEdgeButton. (Ia923e) - Nous avons ajouté
errorDimàColorSchemepour les erreurs de priorité élevée ou les actions d'urgence telles que les alertes de sécurité, les superpositions de boîte de dialogue ayant échoué ou les boutons d'arrêt. (I70998)
Correction de bugs
- Nous avons épinglé
wear.compose.material3à la version 1.15.0 deandroidx.core.core(I132e9). - Nous avons amélioré les performances de Dialog en utilisant
AppScaffoldpour superposer les boîtes de dialogue à d'autres contenus d'écran (I1b9a4). - Réduction de la marge intérieure verticale de
EdgeButton. (I1a5bb) - Nous avons ajouté la sémantique de bouton aux boutons du curseur. (I80cc6)
Version 1.0.0-alpha32
29 janvier 2025
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha32. La version 1.0.0-alpha32 contient ces commits.
Modifications apportées à l'API
- Sur
CurvedTextStyle, nous avons divisé l'espacement des lettres en espacement des lettres dans le sens des aiguilles d'une montre et en espacement des lettres dans le sens inverse des aiguilles d'une montre. Cela est nécessaire, car les lettres dans le sens des aiguilles d'une montre s'étalent à partir de la ligne de base, tandis que les lettres dans le sens inverse des aiguilles d'une montre se resserrent (un espacement plus important est donc nécessaire) (I4b848). - Nous avons mis à jour
IconButtonShapes,IconToggleButtonShapes,TextButtonShapesetTextToggleButtonShapespour améliorer la cohérence entre les bibliothèques Material3. Cette modification introduit également la mise en cache des formes pour réduire le nombre d'allocations. (I049fc) - Nous avons supprimé le paramètre
pressedShapeCornerSizeFractionde la méthodevariantAnimatedShapedansIconToggleButtonetTextToggleButton(I58a65). - Nous apportons des améliorations au rendu du texte incurvé (y compris
TimeText) qui sont incompatibles avec les écrans non ronds. La prise en charge des écrans non ronds ne fait plus partie des exigences Wear OS. Pour en savoir plus, consultez le guide de démarrage. (I1cc1c) - Nous avons mis à jour
ButtonGroupScopedeButtonGroupen remplaçantButtonGroupItembasé sur DSL parModifier.weight,Modifier.minWidthetModifier.enlargeOnPress. (I16c3c) - Dans l'API
ButtonGroup, nous avons mis à jour le nouveauButtonGroupScopebasé sur les modificateurs :enlargeOnPresss'appelle désormaisanimateWidthet prend unInteractionSource, plutôt qu'unMutableInteractionSource, car il n'est pas nécessaire de le modifier. Nous avons également ajouté la constante publiqueButtonGroupDefaults.DefaultMinWidth, qui correspond à la largeur minimale par défaut des boutons dans unButtonGroup. (Ie27ec) - Nous avons mis à jour
ListHeaderDefaults.contentColorpour qu'il commence par une lettre minuscule, car il s'agit d'une propriété composable (I125a5). - Nous avons ajouté un paramètre de description du contenu à
SliderDefaults.DecreaseIconetSliderDefaults.IncreaseIcon, avec des valeurs par défaut appropriées (I2e1a7). - Nous avons renommé le paramètre
spacingdansPickeretPickerGroupenverticalSpacing(Ib75cc). - Nous avons supprimé
ConfirmationDialogDefaults.successTextetfailureText, car les appelants deConfirmationDialogsont censés fournir des chaînes avec plus de contexte.confirmationCurvedTexta également été renomméconfirmationDialogCurvedText. Enfin, nous avons renommé le paramètreshowde la boîte de dialogue en "visible" pour plus de cohérence avec les autres mises à jour récentes des boîtes de dialogue. (I10074) IconButtona renommédisabledImageOpacityenDisabledImageOpacity. (I5f94a)
Correction de bugs
- Nous avons corrigé un bug dans l'animation
EdgeButtonafin que la taille correcte soit utilisée dans chaque frame (Id3b58). - Correction d'un problème lié à
animateContentSizequi ne fonctionnait pas avecButton. (Ib18a0) - Nous avons modifié la taille de la police de la typographie "Titre grand" pour qu'elle soit de
18dp(Ic9d52). - Nous avons mis à jour l'espacement et la taille de l'icône
AlertDialog(Iac28c). - Nous avons corrigé les incohérences dans les points d'arrêt pour les grands écrans (les écrans de 225 dp et plus sont considérés comme grands) (I36474).
- Correction d'un bug mineur dans le positionnement des boutons (I952c2)
Version 1.0.0-alpha31
15 janvier 2025
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha31. La version 1.0.0-alpha31 contient ces commits.
Modifications apportées à l'API
- Nous avons mis à jour toutes les bibliothèques Wear Compose en mode "API explicite". (Iebf9f)
- Nous avons mis à jour les API
ScreenScaffoldetEdgeButtonpour faciliter la spécification des marges intérieures de contenu sur les écrans qui incluent unEdgeButton. Dans la nouvelle API, lesizedeEdgeButtonn'est transmis qu'àEdgeButton, etScreenScaffoldprend un paramètreedgeButtonSpacingpour l'espacement entreEdgeButtonet le contenu de la liste. (I424fd) - Dans
DatePicker, nous avons renommé les paramètresminDateenmaxDateetminValidDateenmaxValidDate. DansDatePickerColors, nous avons renommé le paramètreselectedPickerContentColorenactivePickerContentColoretunselectedPickerContentColoreninactivePickerContentColor. (Iba17b) - Nous avons mis à jour les valeurs par défaut de
ArcProgressIndicatoràstrokeWidth=6dpet recommandédiameter = 81.24%de la hauteur de l'écran. (I6f248) - Nous avons mis à jour l'API Confirmation pour refléter son utilisation en tant que boîte de dialogue. Le composable s'appelle désormais
ConfirmationDialog, avec des mises à jour associées concernant la dénomination des classes de couleurs et par défaut. Nous avons également renommé le paramètreshowenvisiblepour assurer la compatibilité avec d'autres API d'animation Compose. De plus, nous avons mis à dispositionConfirmationDialogContent,SuccessConfirmationDialogContentetFailureConfirmationDialogContentpour les situations où les développeurs doivent personnaliser les animations de la boîte de dialogue d'introduction/de conclusion. (Iaeb33) - Nous avons mis à jour
CircularProgressIndicatorContentversCircularProgressIndicatorStatic(la variante non animée deCircularProgressIndicator) afin qu'il puisse désormais être utilisé pour créerCircularProgressIndicatoravec des animations personnalisées. (I1346f) - Nous avons corrigé l'ordre des paramètres sur
ArcProgressIndicatoren plaçant le paramètre de modificateur en premier (I4656a). - Amélioration de l'API
SwipeToRevealpour recevoir un paramètre d'emplacement de texte pour les libellés des actions (sauf l'action secondaire) et pour supprimer les paramètres de libellé de l'action d'annulation (I5b3db)
Correction de bugs
- Nous avons corrigé un bug qui déclenchait les retours haptiques
LongPressplusieurs fois dansButton,Card,IconButtonetTextButton. (Ia8b0f) - Modifications apportées à l'UI de
AlertDialog: sur les grands écrans, les boutons de confirmation et d'annulation sont désormais plus petits. L'espacement sous les boutons de confirmation et de fermeture a également été augmenté. (I4f066) - Nous avons modifié les spécifications d'animation du libellé du bouton d'action du composant
SwipeToReveal. (Ib87fb) - Modification de
SwipeToRevealpour développer le conteneur en même temps que le texte s'affiche. (I44cf8) - Amélioration de
SwipeToRevealpour effectuer un retour haptique lorsque le balayage dépasse le seuil où l'action principale est effectuée. (I23efe) - Nous avons mis à jour
SwipeToRevealpour afficher des points de suspension en cas de dépassement de texte par défaut, pour les actions principales et d'annulation. (I71f5a) - Nous avons corrigé un problème qui entraînait des saccades dans les animations
ButtonGroup. (I63f8f) - Nous avons ajouté la sémantique de texte à
AnimatedText. (I6063c) - La boîte de dialogue réinitialise désormais la mise à l'échelle de l'arrière-plan lorsqu'elle est supprimée de la composition (sans cette correction, l'écran de lancement aurait pu rester à une échelle réduite) (Id24ac).
- Nous avons ajouté une animation de morphing de forme aux boutons du composant Stepper. (Id6ed3)
Version 1.0.0-alpha30
11 décembre 2024
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha30. La version 1.0.0-alpha30 contient ces commits.
Modifications apportées à l'API
- Le modificateur
scrollTransformpourTransformingLazyColumna été refactorisé, ce qui a entraîné une modification de l'API. (I0c6dc) - Nous avons mis à jour
IconToggleButtonShapesetTextToggleButtonShapespour qu'ils aient deux paramètres de forme différents,uncheckedPressedetcheckedPressed. (I85dbd) - Les options de mois/jour non valides sont désormais visibles dans
DatePicker, avec un nouveauinvalidPickerContentColor, lorsque vous utilisezminDateoumaxDate. (If4541) - Nous avons mis à jour l'API
Stepperpour fournir des emplacementsincreaseIconetdecreaseIcon. Le contenu de ces emplacements peut être créé comme d'habitude à partir du composable Icon. (Id35da) - Nous avons mis à jour
dynamicColorSchemeen supprimant le paramètre facultatifdefaultColorSchemeet en renvoyant désormaisColorSchemepouvant avoir une valeur nulle. Cela signifie que l'appelant doit gérer explicitement le cas de remplacement lorsqu'un schéma de couleurs dynamiques n'est pas fourni. (I6d62e) - Nous avons mis à jour les tailles d'icônes dans
ButtonDefaultspour une utilisation avecCompactButton. UnCompactButtoncontenant uniquement une icône doit utiliserButtonDefaults.SmallIconSize = 24.dp, tandis qu'unCompactButtoncontenant à la fois une icône et du texte doit utiliserButtonDefaults.ExtraSmallIconSize = 20.dp. Il est recommandé queCompactButtonenveloppe son contenu (plutôt que de remplir la largeur maximale). Les exemples ont été mis à jour pour le montrer. (I0582c) - Nous avons ajouté
EdgeButtonDefaultsavec les tailles d'icônes recommandées pour les quatreEdgeButtonSizes. Nous avons également mis à jour la mise en pageEdgeButtonafin qu'elle dispose d'une marge intérieure inférieure légèrement plus grande que la marge intérieure supérieure, ce qui améliore l'apparence du contenu "Icône" et "Texte". (Id772a) - Nous avons ajouté du mouvement à
LinearProgressIndicatoret exposéLinearProgressIndicatorContent, qui fournit le contenu visuel sans animations. (Idee99) - Nous avons ajouté un composable
CircularProgressIndicatorContentpour afficher le contenu visuel deCircularProgressIndicatorsans animations. (Ie33d4) TransformingLazyColumnfournit désormais la composition localeLocalTransformingLazyColumnItemScopeque lesCard,ButtonetListHeaderutilisent désormais pour se transformer automatiquement lorsqu'ils sont placés dans unTransformingLazyColumn. Les appelants peuvent désactiver la morphose automatique à l'aide du nouveau wrapperTransformExclusion. (I1652f)- Nous avons modifié le type de
ButtonDefaults.shapeenRoundedCornerShape. (Iccdf2)
Correction de bugs
- Nous avons corrigé un bug pour respecter l'alpha existant sur l'arrière-plan de
TimeText(I1eb60). - Nous avons défini
TextMotionsurAnimatedpar défaut dans notre typographie, afin d'éviter les tremblements de texte dus à l'alignement des glyphes de lettres sur les limites des pixels lors des opérations de mise à l'échelle. (I626fa) - Nous avons modifié l'apparence de
ScrollIndicatoren augmentant la largeur et la taille de l'espace pour améliorer la visibilité. (Ied7cb) - Nous avons corrigé un bug sur
Modifier.scrollTransformlors de l'ajout, de la suppression ou du déplacement d'éléments. (I6830f) - Nous avons corrigé un problème d'animation des boutons ronds pour les brefs appuis (auparavant, la durée minimale de l'animation n'était pas toujours respectée). (I757a7)
- Nous avons modifié l'angle de balayage de
LevelIndicatorpour le définir sur 20 % (soit 72 degrés). (Idde5c) - Nous avons corrigé le positionnement de
ScrollIndicatorlorsqueScalingLazyColumnétait utilisé avecAutoCenteringParams. (I387dd) - Nous avons mis à jour les couleurs et la typographie pour
ListHeaderetListSubHeader. ainsi que les couleurs des commandes d'activation/désactivation surCheckboxButtonetSwitchButton. (I39817) - Nous avons corrigé le positionnement de
ScrollIndicatordansLazyColumnetScalingLazyColumnavecContentPadding. (I2bc51) - Nous avons corrigé un bug observé dans l'animation de progression
OpenOnPhoneDialogen utilisant le nouveauCircularProgressIndicatorContent. (I3e443) - Nous avons mis à jour
HorizontalPagerScaffoldetVerticalPagerScaffoldpour désactiver les animations lorsque l'option "Réduire les animations" est activée (Iaaf68). - Nous avons implémenté une animation distincte pour les indicateurs de progression circulaire lorsque la progression dépasse 100 %. (I47135)
- Nous avons corrigé un bug qui pouvait entraîner l'affichage de
EdgeButtonavec une forme incorrecte dans les composants Pager (I91db9).
Version 1.0.0-alpha29
13 novembre 2024
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha29. La version 1.0.0-alpha29 contient ces commits.
Modifications apportées à l'API
- Nous avons mis à jour
TimeTextpour fournir un contenu par défaut qui affiche l'heure. (Id23b3) - Nous avons simplifié
ScrollInfoProviderpourPagerStateen supprimant le paramètreorientation, qui n'est plus nécessaire. Le nouveau comportement consiste à laisserTimeTexten place pour la pagination horizontale et verticale. (I71767) LocalHapticFeedbackfournit désormais une implémentationHapticFeedbackpar défaut lorsque l'API Vibrator indique que les retours haptiques sont pris en charge. Les éléments suivants ont été ajoutés àHapticFeedbackType:Confirm,ContextClick,GestureEnd,GestureThresholdActivate,Reject,SegmentFrequentTick,SegmentTick,ToggleOn,ToggleOff,VirtualKey. Les composants Wear Compose cliquables de manière prolongée tels queButton,IconButton,TextButtonetCardeffectuent désormais le retour haptiqueLONG_PRESSlorsqu'un gestionnaire de clic prolongé a été fourni. (I5083d)
Correction de bugs
- Nous avons modifié la motion pour les confirmations. (I04bff)
- Nous avons mis à jour la dépendance d'API minimale à la version 1.7.4 pour les bibliothèques Compose. (I88b46)
- Un nouveau mouvement a été ajouté à la boîte de dialogue
OpenOnPhone. (I1e10a) - Nous avons corrigé un bug dans
LevelIndicatorpour qu'il s'affiche correctement lorsque le niveau est défini sur zéro. (Ie95a4) - Nous avons mis à jour les animations
HorizontalPageIndicatoretVerticalPageIndicator. (I5c8f3) - Nous avons ajouté une animation de réduction en point au
ArcProgressIndicatorindéterminé. (I9fd51)
Version 1.0.0-alpha28
30 octobre 2024
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha28. La version 1.0.0-alpha28 contient ces commits.
Modifications apportées à l'API
- Nous avons ajouté une variante d'arc à l'indicateur de progression circulaire indéterminé (I2efc1).
- Nous avons rendu publics les composables
AlertDialogContentetDialogqui composent l'APIAlertDialog. Vous pouvez ainsi ajouter des personnalisations si nécessaire (par exemple, personnaliser l'animationAlertDialogtout en conservant la mise en page de contenu recommandée). De plus, nous avons ajouté les paramètresModifieretColoraux membresEdgeButton,ConfirmButtonetDismissButtondeAlertDialogDefaults. (I4eb71) - Nous avons mis à jour l'API
Placeholdercomme suit :PlaceholderState.startPlaceholderAnimationa été renomméPlaceholderState.animatePlaceholder,PlaceholderState.isShowContenta été renomméPlaceholderState.isHiddenetPlaceholderDefaults.shapea été renomméPlaceholderDefaults.Shape; le paramètrepainterdepainterWithPlaceholderOverlayBackgroundBrusha été renomméoriginalPainter; la visibilité dePlaceholderState.placeholderProgressionest passée de publique à interne et a été renomméeplaceholderShimmerProgression; des constantes de durée d'animation d'espace réservé ont été ajoutées àPlaceholderDefaults. (Ie5a59) - Nous avons mis à jour l'API
EdgeButtoncomme suit : nous avons renommé le paramètre surScreenScaffolddebottomButtonenedgeButtonet nous avons fait deEdgeButtonSizeune classe de valeur. (Ieef15) - Nous avons défini la visibilité de
copy()sur "public" dans les classes Colors de wear material3 (I0287f).
Correction de bugs
- Ajout d'une durée d'animation minimale pour
IconToggleButtonetTextToggleButtonau clic (Ieb333) - Ajout d'une durée minimale pour l'animation de forme
IconButtonetTextButton(Iebcee) - Correction de l'état de l'option de répétition de
DatePicker. (I3587c) - Ajout de mouvements pour les boîtes de dialogue d'alerte et de confirmation. (I173b1)
Version 1.0.0-alpha27
16 octobre 2024
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha27. La version 1.0.0-alpha27 contient ces commits.
Modifications apportées à l'API
- Nous avons mis à jour
ScreenScaffoldetScrollIndicatorsuite au changement de nom de Wear Compose FoundationLazyColumnenTransformingLazyColumn. (I0608b) - Le paramètre
preferredHeightdeEdgeButtona été renommébuttonSize. Sa valeur ne peut être choisie que parmi quatre constantes de la nouvelle classe de valeursEdgeButtonSize. (Icdd70) - Nous avons renommé
ListSubheaderenListSubHeaderet ajouté des valeurs par défaut accessibles au public pourListHeaderetListSubHeader. (I96730) - Nous avons ajouté de nouveaux composants
HorizontalPagerScaffoldetVerticalPagerScaffoldpour Wear, qui fournissent de nouvelles animations et une coordination entre les composants de texte temporel et d'indicateur de page. (Iff7d0) - Nous avons ajouté la prise en charge du dispositif rotatif à
HorizontalPagerScaffoldetVerticalPagerScaffold, ce qui permet aux utilisateurs de parcourir les sélecteurs de page à l'aide de dispositifs de saisie rotatifs. (I9770d) - Nous avons apporté des modifications à l'API
MotionSchemepour simplifier son utilisation et améliorer sa cohérence. Suppression des fonctions "remember" intégrées et déplacement des schémas de mouvement intégrés vers un objet associé MotionScheme dédié. Les nomsstandardMotionSchemeetexpressiveMotionSchemeont été remplacés par "standard" et "expressif". (I5fd45) - Nous avons ajouté la prise en charge d'un jeu de couleurs dynamiques basé sur les couleurs système. (I073e9)
- Nous avons mis à jour le Stepper pour qu'il soit conforme aux dernières spécifications de l'expérience utilisateur. (I622bb)
Correction de bugs
- Nous avons mis à jour la typographie et les marges intérieures des composants de carte. (I3ae48)
- Nous avons modifié la marge intérieure de
AlertDialogentre les boutons "Confirmer"/"Annuler" et le reste du contenu, en la faisant passer de 8 dp à 12 dp, conformément aux spécifications de l'expérience utilisateur (Ie55f0). - Nous avons mis à jour l'opacité des couleurs pour le composant "Curseur". (Idb383)
Version 1.0.0-alpha26
2 octobre 2024
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha26. La version 1.0.0-alpha26 contient ces commits.
Modifications apportées à l'API
- Mise à jour de l'API et de l'apparence de
HorizontalPageIndicatoret ajout deVerticalPageIndicatorà utiliser avecVerticalPager(Ic9309) AlertDialogpermet désormais d'omettre le bouton inférieur par défaut de la variante de pile de boutons, pour les mises en page personnalisées dans lesquelles EdgeButton n'est pas requis. (I34fa9)- Nous avons ajouté un composant
SwipeToRevealpour Wear Material 3 (Ic38b2). - Nous avons ajouté la prise en charge du balayage bidirectionnel dans
SwipeToReveal, pour les rares cas où l'écran actuel ne prend pas en charge le balayage pour fermer. Par défaut, le balayage pour afficher n'est toujours disponible que pour les balayages de droite à gauche. Il est fortement conseillé de respecter le comportement par défaut pour éviter tout conflit avec le balayage pour fermer. (Ifac04) - Nous avons renommé le paramètre
buttonHeightdeEdgeButtonenpreferredHeight. (I4fab3) - La version Kotlin a été mise à jour vers la version 1.9 (I1a14c).
- Nous avons renommé
OpenOnPhoneDialogDefaults.IconenOpenOnPhoneDialogDefaults.OpenOnPhoneIconpour éviter tout conflit avecIcon(I0f391). - Nous avons ajouté la prise en charge de
ScrollIndicatordansLazyColumn. (Ia546a) - Nous avons modifié les valeurs par défaut de
TextToggleButtonetIconToggleButton. (I7aaa9) - Nous avons simplifié les API
PickeretPickerGroup. (Id0653) - Nous avons ajouté
CardDefaults.ShapeetCardDefaults.Height, qui (étant des jetons) étaient autrement privés pour les développeurs utilisant la bibliothèque. (I1594a, b/347649765) - Nous avons renommé le paramètre de progression de l'indicateur de progression circulaire segmenté binaire en
segmentValue. (Ib72d9) - Nous avons modifié les couleurs et la mise en page du curseur. (Ic3eec)
Correction de bugs
- Nous avons mis à jour l'animation de l'icône
openOnPhone(I66f85). - Nous utilisons désormais les icônes Google Symbols dans
Slider,TimePickeretDatePicker. (I46c7c) - Nous avons mis à jour les marges intérieures dans
ConfirmationetOpenOnPhoneDialog. (Iaa82e)
Version 1.0.0-alpha25
18 septembre 2024
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha25. La version 1.0.0-alpha25 contient ces commits.
Modifications apportées à l'API
- Nous avons ajouté un indicateur de progression circulaire indéterminé. (I427a7)
- Nous avons ajouté la prise en charge du dépassement de la progression (> 100 %) pour
CircularProgressIndicatoretSegmentedCircularProgressIndicator. Lorsque la progression dépasse 1,0, la nouvelle couleuroverflowTrackl'indique. (Iaaa3d) - Les boutons ronds
IconToggleButtonetTextToggleButtonsont désormais compatibles avec une nouvelle variante d'animation de forme, dans laquelle différentes formes représentent les états "coché", "décoché" et "appuyé". L'ancienne variante de forme animée pour l'état "Appuyé" reste acceptée. (I29f03) - Nous avons supprimé la compatibilité de
EdgeButtonavecColumn, car il est nécessaire de spécifier explicitement la hauteur deEdgeButtondansScreenScaffold. (Ie353d) - Nous avons ajouté la prise en charge de
LazyColumnWear Compose avec notreScreenScaffold(et ajouté une implémentation deScrollInfoProviderpourLazyColumnState). (Ib8d29) - Nous avons combiné
LocalTextMaxLines,LocalTextAlignetLocalTextOverflowdans une seule compositionLocalTextConfigurationlocale pour fournir une solution plus évolutive à l'avenir. (I5edbc) - Nous avons ajouté "arc-large" comme échelle typographique supplémentaire, réservée aux chaînes de texte d'en-tête courtes en haut ou en bas de l'écran, comme dans les pop-ups de confirmation. (I60e3e)
- Nous avons ajouté des valeurs par défaut au bouton pour les tailles d'icône et la marge intérieure de contenu recommandées (grandes et très grandes). (I84675)
Correction de bugs
- Nous avons modifié les couleurs de
IconButtonetTextButton. (I48324) - Nous avons modifié les surcharges de bouton de base pour qu'elles soient alignées verticalement au centre, afin d'assurer la cohérence avec les autres surcharges. Pour rétablir le comportement précédent, utilisez
Modifier.alignà partir deRowScope. (I66e57)
Version 1.0.0-alpha24
4 septembre 2024
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha24. La version 1.0.0-alpha24 contient ces commits.
Modifications apportées à l'API
- Nous avons ajouté un schéma de mouvement au thème Material3. Il sera utilisé par les composants de la bibliothèque pour appliquer des spécifications d'animation telles que des ressorts pour un mouvement expressif. (I54ff3)
- Nous avons ajouté les composants
AppScaffoldetScreenScaffoldà la bibliothèque Material3, qui incluent des fonctionnalités permettant de coordonner la superposition et les transitions deTimeTextetScrollIndicator.AppScaffoldfournit un niveau supérieur de composants de structure qui se trouvent au-dessus de tous les écrans. Par conséquent, l'ajout deTimeTextàAppScaffoldlui permet de rester en place lors du balayage entre les écrans. Les écrans peuvent eux-mêmes remplacer ou masquer le texte de l'heure.ScreenScaffoldfournit un emplacement pourScrollIndicatoret anime automatiquement l'indicateur de défilement lors du défilement, y compris le délai d'inactivité pour masquer l'indicateur de défilement. (I047d6) - Nous avons ajouté
ScrollIndicatoravec le nouveau design Material3. La taille de la miniature est fixe et basée sur le contenu initial de la liste. Cela permet d'éviter les variations de taille lorsque le contenu à chargement différé est chargé dans la liste. (Ic228d) - Nous avons modifié l'API
ScrollAwayde sorte queScreenStagesoit une classe de valeurs au lieu d'une classe enum, afin de permettre l'ajout d'étapes supplémentaires si nécessaire à l'avenir. (I48c93) - Nous avons ajouté
EdgeButton, un bouton Wear spécifique dont la forme suit la courbure du bas de l'écran (I16369). - Nous avons ajouté un nouvel emplacement au
ScreenScaffoldpour un bouton en bas (tel queEdgeButton), qui sera affiché et redimensionné en fonction du contenu défilant (I032eb). - Nous avons ajouté
Modifier.scrollTransformetModifier.targetMorphingHeightpour ajouter des effets de mouvement Material3 aux éléments deLazyColumn. (Ie229a) - Nous avons ajouté
SegmentedCircularProgressIndicatorcomme variante deCircularProgressIndicator. La variante segmentée affiche une seule valeur de progression pour tous les segments ou indique si chaque segment est activé ou désactivé. (I6e059) - Nous avons ajouté
LinearProgressIndicatorcomme alternative àCircularProgressIndicator. (I89182) - Nous avons ajouté
AlertDialog, qui fournit des mises en page pour présenter des invites importantes à l'utilisateur. Des variantes sont incluses pour une paire de boutons de confirmation/d'annulation ou un seul bouton en bas (généralement un EdgeButton) sous une pile d'options. Les deux variantes comportent des emplacements pour l'icône, le titre et du texte supplémentaire permettant de fournir plus de détails. (Ieb873) - Nous avons ajouté
OpenOnPhoneDialog, qui doit être utilisé pour indiquer une action qui se poursuivra sur le téléphone de l'utilisateur.OpenOnPhoneDialogest fermé après un délai spécifié. (I978fd) - Nous avons ajouté
Confirmation, un composant de boîte de dialogue qui comporte des emplacements pour une icône et du texte incurvé ou linéaire. Des variantes spécifiques sont fournies pour les messages de réussite/d'échec. Les confirmations sont automatiquement fermées après un certain délai. (Ib43e8) - Nous avons ajouté un arrière-plan à
TimeTextpour atténuer les problèmes liés au chevauchement du contenu sous-jacent et deTimeText, qui masquait l'heure. (Ia11fd) - Nous avons ajouté
LevelIndicator, qui affiche la valeur d'un paramètre tel que le volume et peut être utilisé avec le composantStepperexistant pour créer un écran de volume.LevelIndicatorest semblable àScrollIndicator, mais s'affiche de l'autre côté de l'écran et présente par défaut une épaisseur de trait plus importante et une couleur d'indicateur différente. (I8a4ac) - Nous avons ajouté
TimePicker, avec des mises en page pour l'heure au format 24 heures (avec ou sans secondes) ou au format 12 heures avec sélection AM/PM. (Ia5124) - Nous avons ajouté
DatePicker, avec une configuration pour l'ordre des colonnes (par exemple, jour-mois-année, mois-jour-année ou année-mois-jour) et des dates minimales/maximales facultatives. (Ibf13b) - Nous avons ajouté un paramètre de pondération à la fonction
textdeTimeText. Dans les cas où TimeText est composé de plusieurs éléments de texte, cela permet de contrôler la façon dont l'espace est réparti. (I36700) - Nous avons ajouté
RadioButtonetSplitRadioButton. Ces composants simplifient l'API précédente en combinant leSelectableButton(Split) et le bouton radio enfant (If7ae8). - Nous avons ajouté
CheckboxButtonetSplitCheckboxButton. Ces composants simplifient l'API précédente en combinant le contrôle (fractionné)ToggleButtonet le contrôle enfant de la case à cocher (Ia8f70). - Nous avons ajouté
SwitchButtonetSplitSwitchButton. Ces composants simplifient l'API précédente en combinant le(Split)ToggleButtonet le contrôle Switch enfant (I0d349). - Nous avons mis à jour la documentation
AnimatedTextpour expliquer le comportement de dépassement. (Iff30a) - Nous avons ajouté
ButtonGrouppour combiner deux ou trois boutons de sorte que les pressions sur les boutons produisent une animation coordonnée. (Ie27db) - Nous avons ajouté une animation de forme facultative pour
IconButtonetTextButtonlorsque l'utilisateur appuie dessus. (Iffca5) - Nous avons ajouté une variante de couleur supplémentaire,
FilledVariant, àButton,IconButton,TextButton,CompactButtonetEdgeButton(I65fc3). - Nous avons ajouté le paramètre
forcedSizeàImageWithScrimPainter, de sorte que les arrière-plans des images de bouton conservent désormais la taille de leur composant par défaut. Si vous définissezforcedSize = null,Painter.instrinsicSizeest adopté à la place. (Ic57af) - Nous avons ajouté un appui prolongé aux boutons (Ib613d).
- La prise en charge du clic long a également été ajoutée à
IconButtonetTextButton. (I38891) - La prise en charge du clic long a été ajoutée aux cartes. (I305d5)
- Nous avons ajouté
LocalTextMaxLines,LocalTextAlignetLocalTextOverflowen tant queCompositionLocalset les avons utilisés comme paramètres par défaut surText. Les locaux de composition peuvent désormais être utilisés par des composants tels queCheckboxButton,SwitchButtonetRadioButtonpour implémenter des conseils UX, mais les développeurs peuvent remplacer les paramètres si nécessaire. (Iab841) - Nous avons ajouté
Placeholderpour vous aider à masquer le contenu des composants tels que les boutons et les cartes jusqu'à ce que les données soient chargées. (I1a532) - Nous avons ajouté
IconToggleButtonColorsetTextToggleButtonColorspour remplacerToggleButtonColors, qui a été supprimé. (Ie0bf1)
Correction de bugs
- Nous avons mis à jour
Button,FilledTonalButton,OutlinedButton,ChildButtonetCompactButtonpour utiliser les nouveauxCompositionLocals,LocalTextMaxLines,LocalTextAlignetLocalTextOverflowafin d'implémenter les conseils sur l'expérience utilisateur. Les développeurs peuvent remplacer ces paramètres directement dans le texte si nécessaire (Ie51f7). - Nous avons modifié la largeur de trait par défaut de
LevelIndicatorpour la définir sur6dpafin de la différencier deScrollIndicator, dont la largeur de trait est de4dp. (If6f63) - Nous avons corrigé un problème dans
TimeTextafin que les angles de balayage plus importants soient pris en charge. (Ie489f) - Correction d'un problème lors de la recomposition de
EdgeButton. (I4cdca) - Correction de la mise en page des boutons à bascule fractionnés lorsque des marges intérieures de contenu personnalisées sont fournies. (Ia33d3)
- Arrondi à la valeur supérieure les petites valeurs de progression pour qu'elles soient au moins égales à la largeur de ligne de l'indicateur de progression. (I3bd84)
Version 1.0.0-alpha23
14 mai 2024
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha23. La version 1.0.0-alpha23 contient ces commits.
Modifications apportées à l'API
- Nous avons mis à jour les API
ToggleButtonetRadioButtonpour que les couleurs désactivées puissent être configurées. (If13a7) - Nous avons ajouté un
CircularProgressIndicatorpour Material3. (Ib3bd7)
Correction de bugs
- Nous avons corrigé un bug qui faisait que les boutons sélectionnables annonçaient "Appuyez deux fois pour activer/désactiver" alors qu'ils étaient déjà sélectionnés. (I7ed88)
Version 1.0.0-alpha22
1er mai 2024
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha22. La version 1.0.0-alpha22 contient ces commits.
Modifications apportées à l'API
- Nous avons mis à jour
ColorSchemeMaterial3. (I7b2b8) - Nous avons mis à jour le composant Switch Material3. En plus de quelques modifications de couleur, la coche correspond désormais à celle utilisée pour la case à cocher. (Icac7b)
Correction de bugs
- Mettez à jour toutes les démos d'intégration pour utiliser le nouveau modificateur
rotaryScrollable. (I25090)
Version 1.0.0-alpha21
17 avril 2024
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha21. La version 1.0.0-alpha21 contient ces commits.
- Cette version a été déclenchée en raison d'un problème technique dans la version précédente, qui entraînait l'absence de fichiers JAR sources. Aucun nouveau commit dans cette version.
Version 1.0.0-alpha20
3 avril 2024
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha20. La version 1.0.0-alpha20 contient ces commits.
Correction de bugs
- Nous avons ajusté les valeurs alpha des états "pressed" (appuyé) et "focused" (sélectionné) de Ripple pour le contraste. (I59f0a)
- Nous avons ajouté un espacement entre les libellés principaux et secondaires dans
Button,ToggleButtonetRadioButton, suite aux dernières modifications apportées aux styles typographiques et aux hauteurs de ligne. (I2c0ba)
Version 1.0.0-alpha19
6 mars 2024
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha19. La version 1.0.0-alpha19 contient ces commits.
Modifications apportées à l'API
- Nous avons ajouté
TimeTextà la bibliothèque Wear Compose Material3. Ce composant affiche l'heure actuelle (et d'autres informations sur l'état) en haut de l'écran. La nouvelle API Material3 concise évite la duplication entre le contenu linéaire et le contenu incurvé. (I4d7c3) - Nous avons remplacé les noms des paramètres
onSelectedparonSelectpourRadioButton. (I1a971) - Tokenize
RadioButtonetSplitRadioButton, et refactorisez également les méthodes existantes pour réduire la quantité de rechercheCompositionLocalen ajoutant des instances mises en cache de couleurs et en rendant les méthodes deRadioButtonColorsetSplitRadioButtonColorsinternes. (I02b33)
Version 1.0.0-alpha18
21 février 2024
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha18. Liste des commits de la version 1.0.0-alpha18
Modifications apportées à l'API
- Nous avons refactorisé le modèle par défaut pour
CardColors,ToggleButtonColorsetSplitToggleButtonColorsen créant des instances mises en cache en interne et en réduisant l'utilisation deCompositionLocal. (If3fec)
Version 1.0.0-alpha17
7 février 2024
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha17. Liste des commits de la version 1.0.0-alpha17
Modifications apportées à l'API
- Mise à jour de l'API Button pour qu'elle utilise
buttonColorspar défaut et suppression dufilledButtonColorsen double. (I4fe3b) - Nous avons refactorisé les modèles par défaut pour
ButtonColors,IconButtonColorsetTextButtonColorsen créant une instance mise en cache en interne et en réduisant l'utilisation deCompositionLocal. (I5f51c) - Nous avons supprimé la surcharge de
rememberUpdatedStatedans les classes de couleurs spécifiques aux composants et marqué les méthodes d'accesseur à l'intérieur des classes de couleurs comme internes. (If6571)
Correction de bugs
- Nous avons mis à jour
Modifier.minimumInteractiveComponentSizepour utiliserModifier.node. (Iba6b7)
Version 1.0.0-alpha16
24 janvier 2024
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha16. Liste des commits de la version 1.0.0-alpha16
Nouvelles fonctionnalités
- Nous avons ajouté
CompactButton, qui peut utiliser les mêmes couleurs pleines, tonales pleines et de contour que Button.(I05df0)
Modifications apportées à l'API
- Nous avons ajouté
RadioButton/SplitRadioButtonen tant que conteneurs pour les contrôles de sélection, tels que le contrôle radio.RadioButtonest différent deToggleButton, car il peut être sélectionné (et fonctionne dans un groupe de sélection), tandis queToggleButtonpeut être activé ou désactivé (et est indépendant). (I61275) - Nous supprimons
LocalContentAlphade la bibliothèque Wear Compose Material3 pour assurer la cohérence avec la bibliothèque Compose Material3. (I49a0a) - Les composants Wear Material et Wear Material3 exposant un
MutableInteractionSourcedans leur API ont été mis à jour pour exposer désormais unMutableInteractionSourcepouvant être nul, qui est défini par défaut sur null. Il n'y a pas de changement sémantique ici : transmettre la valeur null signifie que vous ne souhaitez pas hisser leMutableInteractionSource, et il sera créé à l'intérieur du composant si nécessaire. Le passage à la valeur nulle permet à certains composants de ne jamais allouer deMutableInteractionSourceet à d'autres de ne créer une instance que lorsqu'ils en ont besoin, ce qui améliore les performances de ces composants. Si vous n'utilisez pas leMutableInteractionSourceque vous transmettez à ces composants, nous vous recommandons de transmettre plutôt la valeur "null". Nous vous recommandons également d'apporter des modifications similaires à vos propres composants. (Ib90fc, b/298048146) - Ajout d'une nouvelle API Ripple dans les bibliothèques
wear:compose-materialetwear:compose-material3, qui remplace l'APIrememberRippleobsolète. Ajoute également unCompositionLocal,LocalUseFallbackRippleImplementationtemporaire pour rétablir l'utilisation des APIrememberRipple/RippleThemeobsolètes par les composants Material. Cette fonctionnalité sera supprimée dans la prochaine version stable. Elle n'est destinée qu'à aider temporairement à la migration dans les cas où vous fournissez unRippleThemepersonnalisé. Consultez developer.android.com pour obtenir des informations sur la migration et plus de contexte sur ce changement. (af92b21) - Nous avons apporté des améliorations mineures à l'API
HorizontalPageIndicatoret à sa documentation. (I60efc) - Nous avons mis à jour
ColorSchemepour le rendre immuable, ce qui rend les mises à jour de couleurs individuelles moins efficaces, mais rend l'utilisation plus courante des couleurs plus efficace. La raison de ce changement est que la majorité des applications n'ont pas pour cas d'utilisation principal la mise à jour de couleurs individuelles. Cela reste possible, mais la recomposition sera plus fréquente qu'avant. En contrepartie, nous réduisons considérablement le nombre d'abonnements d'état dans l'ensemble du code matériel, ce qui aura un impact sur le coût d'initialisation et d'exécution des cas d'utilisation plus standards. (Ibc2d6) - Mise à jour des API
ToggleButtonetSplitToggleButtonpour permettre la personnalisation des couleurs désactivées. De plus, les jetons Material Design sont désormais utilisés pour les valeurs de couleur et de typographie. (If087c) - Mise à jour des couleurs d'arrière-plan des images de boutons pour utiliser les jetons Material Design. (Iba215)
- Nous avons modifié les composants
Checkbox,SwitchetRadioButtonpour qu'ils soient en lecture seule en supprimant la gestion des clics. Ces composants sont censés être utilisés dans(Split)ToggleButtonqui gère le clic. Ils sont donc désormais plus clairement indiqués comme étant réservés à l'affichage (et ne sont pas destinés à être utilisés de manière autonome sur Wear). (I2322e)
Correction de bugs
- Nous avons ajouté des jetons pour les valeurs de mouvement des durées et des courbes d'accélération dans Wear Compose Material 3. (I437cd)
- Nous avons corrigé un bug dans les
ToggleButton,SplitToggleButton,Checkbox,SwitchetRadioButtonafin que les annonces d'accessibilité ne soient pas répétées (auparavant, les rôles sémantiques étaient dupliqués). (Ica281) - Nous avons supprimé le calque materialcore pour
CompactButtonafin d'améliorer les performances. (7902858)
Version 1.0.0-alpha15
15 novembre 2023
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha15. Liste des commits de la version 1.0.0-alpha15
Modifications apportées à l'API
- Nous avons renommé le niveau de base
SwipeToDismissBoxenBasicSwipeToDismissBox. Cela permet de mieux distinguer le composant de niveau Foundation et le composant de niveau Material3SwipeToDismissBox. Ce dernier extrait les couleurs deMaterialThemeà utiliser dans les écrans de protection et délègue l'implémentation restante àBasicSwipeToDismissBox. (Ibecfc)
Correction de bugs
- Nous avons supprimé la couche material-core pour le bouton Material3 afin d'améliorer les performances. (I55555)
Version 1.0.0-alpha14
18 octobre 2023
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha14. Liste des commits de la version 1.0.0-alpha14
Modifications apportées à l'API
- Nous avons supprimé le paramètre
indicatorStyledeHorizontalPageIndicatorMaterial3. Il suivra désormais la forme de l'écran de l'appareil (linéaire ou ronde). (I83728) - Nous avons séparé les couleurs de
SplitToggleButtonde celles deToggleButtonen ajoutant une classeSplitToggleButtonColors. (I78bee)
Version 1.0.0-alpha13
4 octobre 2023
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha13. Liste des commits de la version 1.0.0-alpha13
Modifications apportées à l'API
- Nous avons ajouté un champ "Sous-titre" facultatif à
TitleCard. (Ifc45a) - Nous avons ajouté des jetons de couleur Material Design pour
TextButton. (I769dc)
Version 1.0.0-alpha12
20 septembre 2023
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha12. Liste des commits de la version 1.0.0-alpha12.
Modifications apportées à l'API
- Nous avons mis à jour
IconButtonpour qu'il utilise les jetons Material Design. (I3f137) - Nous avons mis à jour
IconToggleButtonpour qu'il utilise les jetons Material Design. (I7d263) - Nous avons rendu publics les constructeurs de
CheckboxColors,RadioButtonColorsetSwitchColors. (I82b73)
Version 1.0.0-alpha11
6 septembre 2023
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha11. Liste des commits de la version 1.0.0-alpha11.
Correction de bugs
- Nous avons mis à jour la typographie des cartes Material3 pour
TitleMedium. (I597bd) - Nous avons mis à jour la typographie et l'alignement de nos
ListHeaderetListSubheaderMaterial 3. (Ib5ceb)
Version 1.0.0-alpha10
23 août 2023
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha10. Liste des commits de la version 1.0.0-alpha10
Nouvelles fonctionnalités
- Ajoutez
HorizontalPageIndicatordans la bibliothèque Wear Material3. (Ifee99)
Modifications apportées à l'API
- Mettez à jour le code des boutons pour utiliser les jetons de conception Material3. (I92fe4)
- Les API Wear Material 3 Stepper et Slider sont déclarées expérimentales, car les détails de l'interface utilisateur sont encore en cours de finalisation. (I84d54)
- Nous avons supprimé les tailles
ExtraSmalldesTextButtonetTextToggleButtonronds, car cette taille ne s'applique qu'auxIconButton. (Ibc7d5)
Correction de bugs
- Nous avons mis à jour les consignes de typographie pour TextToggleButton afin d'utiliser LabelLarge pour LargeButtonSize (Ib10fa).
- Nous avons mis à jour les consignes concernant la typographie pour TextButton afin d'utiliser LabelLarge pour LargeButtonSize (I8f3a7).
- Nous avons défini la taille minimale de la cible tactile de la carte sur 48 dp pour l'accessibilité. (Ieb9b1)
- Ajout d'une démo AppCard avec image, suppression de la démo AppCard avec arrière-plan (Id735f)
- Correction d'un bug dans les boutons ronds où les modificateurs n'étaient pas chaînés correctement. (I5e162)
Version 1.0.0-alpha09
9 août 2023
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha09. Liste des commits de la version 1.0.0-alpha09
Nouvelles fonctionnalités
- Ajout de
ToggleButtonpour Material 3 (I6bed6)
Modifications apportées à l'API
- Nous avons activé l'annotation
FloatRangeen tant que contraintes d'API , qui étaient auparavant indiquées dans les commentaires. (Icb401) - Nous avons mis à jour la typographie de Wear Material3 pour qu'elle respecte les dernières consignes Material3. (I1bad6)
Correction de bugs
- Nous avons mis à jour les couleurs de
Button,IconButtonetTextButtonconformément à la conception Material3. (Ib2495) - Nous avons corrigé la visibilité des coches dans les cases à cocher désactivées. (Ib25bf)
Version 1.0.0-alpha08
26 juillet 2023
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha08. Liste des commits de la version 1.0.0-alpha08
Nouvelles fonctionnalités
- Nous avons ajouté les contrôles de sélection suivants pour Material3 :
Switch,CheckboxetRadioButton. (Ib918c) - Nous avons ajouté
IconToggleButtonetTextToggleButtonà Material3, un bouton bascule circulaire avec un seul emplacement pour l'icône et le texte, respectivement. Pour différentes tailles deToggleButton, nous vous recommandons d'utiliserModifier.touchTargetAwareSizeavec les tailles fournies dans les boutons bascule correspondants. (I9f015) - Nous avons ajouté
ListHeaderetListSubheaderà nos composants Material3. (Ibaefe) - Nous avons ajouté Material3
SwipeToDismissBox, qui appelle la nouvelle fondationSwipeToDismissBoxet fournit les valeurs de couleur par défaut de son thème. (I275fb) - Nous avons ajouté
InlineSliderMaterial3 à Wear Compose. Il permet aux utilisateurs de faire une sélection parmi une plage de valeurs. La plage de sélections s'affiche sous forme de barre entre les valeurs minimales et maximales de la plage. Les utilisateurs peuvent sélectionner une seule valeur.InlineSliderest idéal pour ajuster des paramètres comme le volume ou la luminosité. (I7085f)
Modifications apportées à l'API
- Nous avons mis à jour les formes du thème Wear Material 3 pour qu'elles utilisent
RoundedCornerShapeau lieu de Shape. (Idb133) - Nous avons rendu publiques les constantes de hauteur pour le bouton (Idbfde).
- Mise à jour des fichiers API pour annoter la suppression de la compatibilité. (I8e87a, b/287516207)
- Nous avons mis à jour
InlineSliderColorsdans Wear Compose Material 3 pour qu'il dispose d'un constructeur et de propriétés publics. (I6b632) - Nous avons mis à jour toutes les classes de couleur dans Wear Compose Material 3 pour qu'elles disposent de constructeurs et de propriétés publics. (I17702)
- Nous avons rendu publiques les constantes de marge intérieure horizontale et verticale du bouton. (Ieeaf7)
Correction de bugs
- Le bouton ajuste désormais sa hauteur pour s'adapter au contenu qui a augmenté en raison de grandes polices pour l'accessibilité, si nécessaire (Iaf302).
- Nous avons mis à jour un certain nombre de démos de boutons pour résoudre les problèmes d'accessibilité. (I61ce9)
StepperetInlineSlideracceptent désormais les clics répétés sur un appui prolongé. Vous pouvez ainsi augmenter ou diminuer rapidement la valeur deStepperetInlineSlideren appuyant de manière prolongée sur les boutons + ou - (I27359).
Version 1.0.0-alpha07
21 juin 2023
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha07. Liste des commits de la version 1.0.0-alpha07
Nouvelles fonctionnalités
- Nous avons ajouté le composant
Stepperà notre bibliothèque Compose pour Wear OS Material 3. Cette version est semblable à la version Material précédente, mais elle omet la sémantique de plage par défaut, conformément aux commentaires des développeurs. Nous fournissonsModifier.rangeSemanticsles cas où la sémantique de plage est requise. (Ic39fd) - Nous avons ajouté
curvedTextà notre bibliothèque Compose pour Wear OS Material 3. (Ia8ae3)
Correction de bugs
- Nous avons mis à jour
wear.compose.foundationpour qu'il s'agisse d'une dépendance d'API dewear.compose.material3. (I72004, b/285404743)
Version 1.0.0-alpha06
7 juin 2023
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha06. Liste des commits de la version 1.0.0-alpha06
Correction de bugs
- Nous avons mis à jour
TextButtonpour utiliser la fonction d'extensiontoDisabledColorafin de corriger les valeurs alpha désactivées. (I814c8)
Version 1.0.0-alpha05
24 mai 2023
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha05. Liste des commits de la version 1.0.0-alpha05.
Nouvelles fonctionnalités
- Nous avons ajouté
TextButtonà Material3, un bouton circulaire avec un seul emplacement pour le texte. Pour différentes tailles deTextButton, nous vous recommandons d'utiliserModifier.touchTargetAwareSizeetExtraSmallButtonSize,SmallButtonSize,DefaultButtonSizeetLargeButtonSizeIconfournis dansTextButtonDefaults. La valeur par défautTextButtonn'a pas de bordure et présente un arrière-plan transparent pour les actions peu importantes. Pour les actions qui nécessitent une forte intensité, utilisezfilledTextButtonColors. Pour une intensité moyenne, utilisezTextButtonavec une bordureButtonDefaults.outlinedButtonBorder. Pour un juste milieu entre les deux, utilisezfilledTonalTextButtonColors. (I667e4) - Nous avons ajouté
Card,OutlinedCard,AppCardetTitleCardà la bibliothèque Wear Compose Material3.AppCardetTitleCardpeuvent également être représentés sous forme de contour à l'aide deCardDefaults.outlinedCardColorsetCardDefaults.outlinedCardBorder(I80e72).
Modifications apportées à l'API
- Nous avons déplacé le paramètre de libellé du bouton à la fin pour prendre en charge la syntaxe lambda de fin et supprimé le paramètre de rôle (qui peut être remplacé à l'aide de
Modifier.semantics). Les constructeursButtonColorssont désormais publics. (Ie1b6d)
Version 1.0.0-alpha04
10 mai 2023
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha04. Liste des commits de la version 1.0.0-alpha04
Nouvelles fonctionnalités
- Nous avons ajouté
IconButtonà Material3, un bouton circulaire avec un seul emplacement pour une icône ou une image. Il existe quatre variantes :IconButton,FilledIconButton,FilledTonalIconButtonetOutlinedIconButton. Pour différentes tailles deIconButton, nous vous recommandons d'utiliserModifier.touchTargetAwareSizeetExtraSmallButtonSize,SmallButtonSize,DefaultButtonSizeetLargeButtonSizeIconfournis dansIconButtonDefaults. Nous fournissons égalementIconButtonDefaults.iconSizeForpour déterminer la taille d'icône recommandée pour une taille de bouton donnée. (I721d4)
Version 1.0.0-alpha03
19 avril 2023
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha03. Liste des commits de la version 1.0.0-alpha03
Modifications apportées à l'API
- Nous avons ajouté le composant Button Material 3. Il s'agit de notre bouton en forme de stade, qui s'appelait auparavant Chip dans la bibliothèque Wear Compose Material (il a été renommé Button pour assurer la cohérence avec la bibliothèque Compose Material 3). Le bouton par défaut a un arrière-plan rempli. Il existe des variantes de bouton pour
FilledTonal(arrière-plan atténué), "Outlined" (transparent avec une bordure fine) et "Child" (arrière-plan transparent sans bordure, utilisé pour les actions supplémentaires avec le moins de visibilité). Les boutons ronds pour les icônes et le contenu textuel simples seront disponibles dans une prochaine version.(Ia6942)
Version 1.0.0-alpha02
5 avril 2023
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha02. Liste des commits de la version 1.0.0-alpha02.
Correction de bugs
- Nous avons ajouté un
DefaultTextStyleà Wear Compose Material 3, qui définit la valeur par défaut dePlatformTextStyle.includeFontPaddingsur "true" (le paramètre actuel). Cela nous permettra de synchroniser la désactivation de la marge intérieure de la police par défaut avec les bibliothèques Compose à l'avenir (voir Corriger la marge intérieure de la police dans Compose pour l'arrière-plan). (I7e461)
Version 1.0.0-alpha01
22 mars 2023
Publication d'androidx.wear.compose:compose-material3:1.0.0-alpha01. Liste des commits de la version 1.0.0-alpha01
Nouvelles fonctionnalités
Material 3 est la nouvelle évolution de Material Design. Il inclut une thématisation mise à jour et des composants repensés. Material 3 sur Wear Compose est conçu pour être cohérent avec la bibliothèque Compose Material 3 sur Android. Cette première version alpha contient les premières implémentations fonctionnelles des éléments suivants :
- Thème Material : configure le schéma de couleurs, la typographie et les formes de manière cohérente pour tous les composants de la bibliothèque. Le thème Material3 a des couleurs révisées qui prennent en charge le contraste accessible. (I84005)
- Texte/Icône : composants de base pour les applications Wear Compose (I8e06a)
Nous continuerons à développer Wear Material (
androidx.wear.compose:compose-material) et Wear Material 3 (androidx.wear.compose:compose-material3) en parallèle. Les prochaines versions de Material3 étendront l'ensemble de widgets pour inclure d'autres composants connus de Compose pour Wear OS, tels que les boutons, les sélecteurs et les curseurs.Les bibliothèques Wear Material et Wear Material 3 s'excluent mutuellement et ne doivent pas être mélangées dans la même application, principalement parce qu'elles font référence à des thèmes différents, ce qui entraînerait des incohérences inattendues.