Material 3 para Wear Compose
Actualización más reciente | Versión estable | Versión potencial | Versión beta | Versión alfa |
---|---|---|---|---|
4 de junio de 2025 | - | - | 1.5.0-beta03 | - |
Cómo declarar dependencias
Para agregar una dependencia en Wear, debes agregar el repositorio de Maven de Google a tu proyecto. Consulta el repositorio de Maven de Google para obtener más información.
Agrega las dependencias de los artefactos que necesites en el archivo build.gradle
de tu app o módulo:
Groovy
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. }
Para obtener más información sobre las dependencias, consulta Cómo agregar dependencias de compilación.
Comentarios
Tus comentarios ayudan a mejorar Jetpack. Avísanos si descubres nuevos errores o tienes ideas para mejorar esta biblioteca. Consulta los errores existentes de esta biblioteca antes de crear uno nuevo. Puedes agregar tu voto a un error existente haciendo clic en el botón de la estrella.
Consulta la documentación sobre la Herramienta de seguimiento de errores para obtener más información.
Wear Compose Material3 versión 1.5
Versión 1.5.0-beta03
4 de junio de 2025
Lanzamiento de androidx.wear.compose:compose-*:1.5.0-beta03
. La versión 1.5.0-beta03 contiene estas confirmaciones.
Cambios en la API
OpenOnPhoneDialog
ahora anuncia solo el texto del mensaje en TalkBack y omite la semántica del ícono. Se actualizaron losOpenOnPhoneDialogDefaults
para quitariconContentDescription
y el parámetrocontentDescription
deicon()
. Además,ConfirmationDialogDefaults
ahora tiene parámetros de modificador en los elementos componiblesSuccessIcon
yFailureIcon
. (Id2ae2).
Correcciones de errores
- Se cambió el orden en el que aplicamos el efecto de los parámetros
SurfaceTransformation
. Antes, las transformaciones aplicadas a los componentes de Material3 para Wear se realizaban de la siguiente manera: pintor de fondo, transformación del contenedor y transformación del contenido. Ahora, los primeros 2 están invertidos y aplicamos cualquier modificador pasado entre ellos, de modo que se vea afectado por las transformaciones del contenedor. Esto corrige casos como el uso de un efecto de brillo de marcador de posición con elementos en un TLC con el parámetro de transformación. (I786cf). - Se agregó
RevealState.Saver
para usarlo y restablecer el estado deSwipeToReveal
cuando se recrea la actividad o el proceso. La funciónrememberRevealState
ahora usa este ahorro de forma predeterminada. (Ie0ecb). - Los botones de acciones principales y secundarias de
SwipeToReveal
deben establecerse de forma predeterminada enButtonDefault.Height
(se corrigió el error por el que estos ocupaban la altura máxima para botones más altos). (Ibfba1). - Se cambió
SwipeToReveal
para restablecer el último componente con el que se interactuó cuando se realiza el gesto de deslizar el dedo hacia la derecha. (Ia8450). - Se cambió
SwipeToReveal
para que se establezca en el estadoRevealing
cuando la posición final del deslizamiento esté entre los anclas revelados y no revelados, y esté más cerca del ancla revelado. (If4458). - Ahora, el contenido de
ButtonGroup
se invierte correctamente en un diseño RTL (Ib378d). AnimatedText
ahora admite la dirección de texto de derecha a izquierda (I4533c).TransformingLazyColumn
ahora cambia el tamaño de los elementos correctamente cuando se quita el elemento inferior (Idacab).TransformingLazyColumn
ahora realiza un solo pase de medición, lo que mejora el rendimiento reduciendo los tiempos de fotogramas. (I501a1).
Versión 1.5.0-beta02
20 de mayo de 2025
Lanzamiento de androidx.wear.compose:compose-*:1.5.0-beta02
. La versión 1.5.0-beta02 contiene estas confirmaciones.
Correcciones de errores
- Se actualizaron los perfiles de Baseline para las bibliotecas de Foundation, Material y Material3. (I53f06).
- Se corrigió un error en
TransformingLazyColumn
, en el que se cambiaba el tamaño de los elementos cuando se quitaba el elemento inferior. (Idacab). - Se corrigió un error con
TransformingLazyColumn
, que se producía cuando la lista se bloqueaba en la parte superior o inferior de la lista. (I49d00). OpenOnPhoneDialog
en TalkBack debe anunciar el texto curvo, en lugar de la descripción del contenido del ícono. (I4efe8).- Se corrigió un error en
SwipeToReveal
que informaba el ancla incorrecta enRevealState.currentValue
cuandohasPartiallyRevealedState
se configuraba como falso. (I9c7cf) - Los botones de deshacer
SwipeToReveal
ahora sonButtonDefaults.Height
de forma predeterminada. (I1f6c8) - Se mejoró el rendimiento de
BasicSwipeToDismissBox
eliminando el uso de Canvas para dibujar pantallas. (I68f2c). - Se corrigió un error de accesibilidad en el control deslizante, por el que el porcentaje anunciado no coincidía con el valor después de las actualizaciones (I91146).
- Se corrigió un error en la implementación de
placeholderShimmer
. (Iee39b - Se mejoró el rendimiento de
TransformingLazyColumn
, ya que se optimizó el cálculo deScrollProgress
en un 30%. (I4c4cb)
Versión 1.5.0-beta01
7 de mayo de 2025
Lanzamiento de androidx.wear.compose:compose-*:1.5.0-beta01
. La versión 1.5.0-beta01 contiene estas confirmaciones.
La versión 1.5.0-beta01 de Compose para Wear OS indica que esta versión de la biblioteca está completa y la API está bloqueada (excepto donde se marca como experimental).
Wear Compose 1.5.0-beta01 incluye la biblioteca de Material3 de Wear Compose, que admite el nuevo sistema de diseño de IU llamado Material 3 expresivo. Se recomienda actualizar de Material a Material3 para adoptar el nuevo diseño visual en las apps y beneficiarse de los nuevos componentes de la siguiente manera:
MaterialTheme
para obtener esquemas de colores, tipografías y formas actualizados y extendidos que aporten profundidad y variedad a tus diseños.- Temas de colores dinámicos que generan automáticamente un esquema de colores para tu app que combine con los colores de la cara de reloj.
- Los componentes nuevos se adaptan automáticamente a tamaños de pantalla más grandes de forma predeterminada.
- Deformación de forma: Los componentes de botones redondos, como
IconButton
,TextButton
,IconToggleButton
yTextToggleButton
, admiten variaciones que se animan cuando se presionan o marcan. EdgeButton
: Es un nuevo botón que se ajusta a los bordes con una forma especial diseñada para la parte inferior de la pantalla.- Andamios: Se introdujeron
AppScaffold
yScreenScaffold
para diseñar la estructura de la pantalla y coordinar las animacionesScrollIndicator
yTimeText
. - Botones: Se admiten varios botones con forma de estadio con contenedores flexibles de una sola ranura y variaciones de varias ranuras para botones con íconos y etiquetas.
CheckboxButton
ySwitchButton
se proporcionan cuando se necesitan botones de activación, mientras queRadioButton
es el botón de selección disponible (también se proporcionan variaciones "divididas" de los botones de activación y selección). ButtonGroup
: Implementa un grupo expresivo de botones en una fila que cambia de forma cuando se toca.- Las variantes de
AlertDialog
admiten botones de aceptar o cancelar o unEdgeButton
. ConfirmationDialog
está disponible para mostrar un mensaje con un tiempo de espera, lo que admite animaciones especiales para las variaciones de éxito, error y apertura en el teléfono.- Selectores: Se admiten las variantes
TimePicker
yDatePicker
, así como los componentes Picker yPickerGroup
para compilar tus propias pantallas de selector. ProgressIndicators
: Se admiten indicadores de progreso circulares y lineales (CircularProgressIndicator
tiene variaciones segmentadas e indeterminadas).- Tarjetas: Hay varias variaciones de tarjetas disponibles, incluida
TitleCard
, que ofrece diseños específicos para tarjetas con espacios de título, hora, subtítulo o contenido. También se puede asignar un fondo de imagen aTitleCard
para reforzar el significado de la información de una tarjeta. - Páginadores: Los componentes
HorizontalPagerScaffold
,VerticalPagerScaffold
yAnimatedPage
coordinan las animacionesHorizontalPageIndicator
yVerticalPagerIndicator
.HorizontalPager
yVerticalPager
se lanzaron en la biblioteca de Wear Compose Foundation. - Marcadores de posición: Dibuja una forma de esqueleto sobre un componente para situaciones en las que no hay contenido provisional disponible.
- Sliders y Steppers: Los controles deslizantes y los Steppers permiten que los usuarios seleccionen un rango de valores. Los controles deslizantes son más compactos y se pueden segmentar, mientras que el Stepper es un componente de pantalla completa que suele estar vinculado a un
StepperLevelIndicator
. SwipeToReveal
: Se usa para agregar acciones adicionales a un elemento componible cuando se desliza de derecha a izquierda.
Además, Wear Compose Foundation 1.5.0-beta01 incluye estos componentes nuevos:
TransformingLazyColumn
: Es una lista diferida de desplazamiento vertical que admite animaciones de escalamiento y transformación.- Grupos de enfoque jerárquicos: Se usan para anotar elementos componibles en una aplicación, hacer un seguimiento de la parte activa de la composición y coordinar el enfoque.
- Páginadores: Componentes
HorizontalPager
yVerticalPager
, compilados en los componentes de Compose Foundation con mejoras específicas para Wear para mejorar el rendimiento y el cumplimiento de los lineamientos de Wear OS.
Cambios en la API
- Se actualizó la API de Hierarchical Focus: Se cambió el nombre de
Modifier.hierarchicalFocus
aModifier.hierarchicalFocusGroup
y se quitó el parámetro de devolución de llamada. Se quitó la sobrecarga deModifier.hierarchicalFocusRequester
con un parámetroFocusRequester
. Se creó un nuevoCompositionLocal
,LocalScreenIsActive
, para que los componentes puedan informar y verificar qué pantalla es la activa. (I5ff7c). - Se dio de baja
SwipeToReveal
de Wear Compose Foundation en favor de las APIs deSwipeToReveal
en Wear Compose Material y Wear Compose Material3. Para seguir usando las APIs, reemplaza las importaciones deSwipeToReveal
de Wear Foundation por las importaciones de Material o Material3 de Wear Compose. (Ia147d). - Las dependencias de
SwipeToReveal
de Material3 de Wear Compose en Foundation se movieron al paquete material3, p.ej.,RevealValue
,RevealDirection
,RevealActionType
,RevealState
yrememberRevealState
. Los desarrolladores deben cambiar sus importaciones de estas clases y funciones deandroidx.wear.compose.foundation
aandroidx.wear.compose.material3
. (I640e6). - Se actualizó la API de
SwipeToReveal
de Material3 de Wear Compose de la siguiente manera: se agregaron los parámetrosprimaryAction
,onFullSwipe
,secondaryAction
,undoPrimaryAction
,undoSecondaryAction
yhasPartiallyRevealedState
al elemento componibleSwipeToReveal
; se quitó la capacidad de personalizarpositionalThreshold
yanimationSpec
desdeRevealState
; se quitaronlastActionType
,revealThreshold
y el ancho deRevealState
; se cambió el constructorRevealState
para que acepte unRevealDirection
en lugar de anclas; se quitaron las funcionescreateRevealAnchors
, las anclas y las funcionesbidirectionalAnchors
; se cambió el nombre de las funcionesSwipeToRevealScope
primaryAction
,secondaryAction
,undoPrimaryAction
yundoSecondaryAction
aPrimaryActionButton
,SecondaryActionButton
,UndoActionButton
y se convirtieron en funciones componibles; se marcóRevealActionType
como interno. (I885d0). - Se actualizó aún más la API de
SwipeToReveal
de la siguiente manera: Se cambió el nombre deonFullSwipe
aonSwipePrimaryAction
, se cambió el nombre deSwipeToRevealNonAnchoredSample
para indicar el uso del parámetrohasPartiallyRevealedState
, se quitóactionButtonHeight
, ya que el valor predeterminado es la altura predeterminada del botón y la altura más grande se puede establecer con un modificador, se quitóSmallActionButtonHeight
deSwipeToRevealDefaults
y se hizo privado el parámetro de valor en los constructoresRevealValue
yRevealDirection
. (I465ce).
Correcciones de errores
- Se corrigió el manejo de
EdgeButton
deScreenScaffold
para que, después de quitar un elementoTransformingLazyColumn
, elEdgeButton
se anime en su lugar. (I6d366). - Se actualizaron las dependencias de Wear Compose en las bibliotecas de Compose a la versión 1.8.0. (I2ef3f).
- Se actualizó el movimiento del
CircularProgressIndicator
indeterminado para que ya no retroceda temporalmente. (Ieddb1). - Se corrigió un error de
SwipeDismissableNavHost
: el enfoque no cambiaba correctamente después de deslizar el dedo hacia atrás, lo que causaba que fallara la entrada rotativa (esto era para la API 36 y versiones posteriores, que usa el gesto atrás predictivo). (Ieddb1). - Se modificó la documentación de la API de Hierarchical Focus (Idf2ff).
- Se actualizó la documentación de Button y Card para indicar cómo
containerPainter
ydisabledContainerPainter
anulancontainerColor
ydisabledContainerColor
(I4a453). - Se revirtió un cambio en
TimeText
en la versión anterior que movía elBroadcastReceiver
a un subproceso de trabajo, ya que causaba problemas en las apps que administran sus propios subprocesos durante la navegación. (I34d02). - Se actualizaron los ejemplos de Selector para quitar las llamadas de recuerdo innecesarias y, en su lugar, usar
rememberUpdatedState
en Selector para recordar la función lambdacontentDescription
más reciente. (Icb5b1). - Se actualizaron los estilos de texto en
TimePicker
yDatePicker
para que los cambios de fuente ya no provoquen truncamiento. (I26194). ListHeader
yListSubHeader
ahora establecen de forma predeterminada la alineación del texto en el centro y al principio, respectivamente. (I78339).- Se actualizaron los ejemplos y las demostraciones de Foundation y Material Swipe to Reveal para anunciar acciones de accesibilidad personalizadas (las acciones personalizadas deben agregarse como semánticas en el contenido, no en el elemento componible
SwipeToReveal
). (Ie92a3). - Se actualizó el
MaxLines
predeterminado establecido en el contenidoEdgeButton
según su tamaño: ahora es 1 para extrapequeño, 2 para pequeño y mediano, y 3 para grande. (Ie35f6). - Se simplificó
LocalReduceMotion
para que el observador solo se registre una vez, lo que mejora el rendimiento. (Ib1979). - Se minimizó la cantidad de rediseños en
ScrollIndicator
para mejorar el rendimiento. (Ia7a67). - Se corrigió un error en
TransformingLazyColumn
, en el que el elemento visible superior de la lista no se escalaba correctamente cuando EdgeButton alcanzaba su altura completa. (I30580).
Wear Compose Material3 versión 1.0
Versión 1.0.0-alpha37
23 de abril de 2025
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha37
. La versión 1.0.0-alpha37 contiene estas confirmaciones.
Cambios en la API
- Se quitó
scrollTransform
de la superficie de la API pública. Usa la combinación de modificadorestransformedHeight
ygraphicsLayer
si necesitas obtener la misma funcionalidad. (Ie181d). - Se reemplazaron los elementos componibles
ImageButton
yImageCard
por sobrecargas deButton
yCard/TitleCard
, respectivamente. Se cambió el nombre deimageButtonColors
porbuttonWithContainerPainterColors
y el deimageCardColors
porcardWithContainerPainterColors
. Se agregaronButtonDefaults.scrimBrush
yCardDefaults.scrimBrush
públicos. Se cambiaron los nombres de los botonesimageBackgroundGradientStartColor
yimageBackgroundGradientEndColor
porscrimGradientStartColor
yscrimGradientEndColor
. Se cambió el nombre deCardDefaults.ImageContentPadding
porCardDefaults.CardWithContainerPainterContentPadding
(I7b8b6). Picker
yPickerGroup
ahora tomancontentDescription
como una lambda para evitar recomposiciones innecesarias. (I002dd)
Correcciones de errores
- Se solucionó un problema por el que
CircularProgressIndicator
indeterminado se tambaleaba durante la animación si el ancho no era igual a la altura. (I76bfe). - Se corrigió un problema con el diseño del botón de borde en un tamaño no válido. Ahora se evita actualizar el diseño del botón de borde cuando la altura es NaN. (I32b93).
- Se aumentó el ángulo de barrido máximo en
OpenOnPhoneDialog
para que el texto predeterminado "Verifica tu teléfono" no se corte con el tamaño de fuente más grande. (I90af9).
Versión 1.0.0-alpha36
9 de abril de 2025
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha36
. La versión 1.0.0-alpha36 contiene estas confirmaciones.
Cambios en la API
- Se reemplazó
ButtonDefaults.imageBackgroundButtonColors
porImageButton
,ButtonDefaults.imageButtonColors
,ButtonDefaults.containerPainter
yButtonDefaults.disabledContainerPainter
. Y cambios similares para la tarjeta. Los pintores se quitan deButtonColors
yCardColors
. (I8c6a1). - Se actualizaron los marcadores de posición para simplificar la API. Ahora proporcionamos dos modificadores:
Modifier.placeholderShimmer
para aplicar un efecto de brillo a nivel del componente yModifier.placeholder
para aplicar una máscara sobre el contenido no cargado (Iaee7a).
Correcciones de errores
- Se integró el desplazamiento horizontal en
ScrollIndicator
. (Icfb7f). - Se abordaron los fondos en blanco y los diálogos faltantes cuando se inician diálogos de material3. (Ice597).
- Se corrigieron problemas en
FadingExpandingLabel
cuando el texto abarca varias líneas. (I04eb7). - Se actualizó el padding entre las etiquetas principales y secundarias en los botones. (I99b7b).
ArcLarge
se redujo de20sp
a18sp
, y se actualizaron los espaciados entre letras enArcLarge
yArcSmall
.ConfirmationDialog
/OpenOnPhoneDialog
ahora usan elArcLarge
predeterminado en lugar de anularlo a18sp
. (Id39a8).
Actualizaciones de dependencias
- Esta biblioteca ahora está orientada al nivel de lenguaje Kotlin 2.0 y requiere KGP 2.0.0 o versiones posteriores. (Idb6b5).
Versión 1.0.0-alpha35
26 de marzo de 2025
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha35
. La versión 1.0.0-alpha35 contiene estas confirmaciones.
Cambios en la API
- El padding superior de
AlertDialog
ahora se reduce de forma predeterminada cuando se proporciona un ícono, lo que aprovecha mejor el tamaño de pantalla disponible. (Ief06c). - El nombre de
PagerScaffoldDefaults.FadeOutAnimation
cambió porPagerScaffoldDefaults.FadeOutAnimationSpec
. Se cambió el nombre del parámetro de página enAnimatedPage
apageIndex
. (I701f2) - Se actualizaron los nombres de
SurfaceTransformation
deTransformingLazyColumn
:applyTransformation
se dividió enapplyContainerTransformation
yapplyContentTransformation
, y se cambió el nombre decreateBackgroundPainter
acreateContainerPainter
. Se realizaron más actualizaciones de nombres enTransformationSpec
yResponsiveTransformationSpec
. (I1c534) - Se cambió el nombre de
AppScaffold backgroundColor
porcontainerColor
. (I4e63f).
Correcciones de errores
- Se solucionó un problema en
FadingExpandingLabel
por el que el texto no siempre se expandía correctamente. (I0e773). - Se redujo el tamaño de
ArcLarge
de 20 sp a 18 sp, y se actualizaron los espacios entre letras enArcLarge
yArcSmall
.ConfirmationDialog/OpenOnPhoneDialog
ahora usa elArcLarge
predeterminado en lugar de anularlo a 18 sp. (Id39a8). - Se actualizó la animación del encabezado para
DatePicker
yTimePicker
, de modo que la animación de atenuación de entrada y salida actúe como una animación de resorte. (I68963). - Se optimizó
PagerScaffold
evitando la lectura decurrentPageOffsetFraction
en el elemento componibleAnimatedPage
. (I433ef) - Todas las escalas de tipo se actualizaron para tener números proporcionales de forma predeterminada, ya que se considera que ese es el caso de uso más frecuente y que establecer la opción tabular de forma predeterminada generaba demasiado espacio entre ciertas parejas de números.
TimePicker
yDatePicker
siguen aplicandoFontFeatureSetting=tnum
para los números tabulares. (I88929) - Se corrigió el enfoque de entrada de la RSB inicial para
TimePicker
yDatePicker
. (I1c773) - Se actualizó el texto predeterminado de
OpenOnPhoneDialog
a "Verifica tu teléfono". (I00a3f). - Se actualizaron los pesos de
ArcLarge
yArcMedium
de 600 a 599 para solucionar un problema en el que el peso 600 se consideraba negrita (I2a51d). - Se actualizaron los paddings de
SwipeToReveal
entre el contenido y los botones de acción, así como el padding entre el ícono y el texto de los botones de acción. (Ic46cb).
Versión 1.0.0-alpha34
12 de marzo de 2025
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha34
. La versión 1.0.0-alpha34 contiene estas confirmaciones.
Cambios en la API
PagerScaffold
ya no emite un componentePager
, sino que se debe proporcionar a través del elemento componiblecontent
.AnimatedPage
ysnapWithSpringFlingBehaviour
ahora son públicos y se pueden usar junto conPager
de Wear Foundation para lograr el comportamiento anterior dePagerScaffold
de M3. (consulta las muestras actualizadas). (Ia4724).- Se actualizó
PagerState
, se quitóPagerState
de Compose Foundation como la clase base y se agregaron las propiedadescurrentPage
,currentPageOffsetFraction
ypageCount
. Se actualizó la interfazGestureInclusion
y se cambió el nombre del método aignoreGestureStart
. (I4ae07). - Los parámetros de ángulo de barrido
LevelIndicator
ahora se anotan conFloatRange(0, 360)
(I7e636). - Agregamos
CurvedModifier.clearAndSetSemantics
para proporcionar un medio a través del cual se pueda desactivar la semántica curva.CurvedText
sigue estableciendo de forma predeterminada la descripción del contenido en el texto, perotimeTextCurvedText
ytimeTextSeparator
ahora no anuncian su contenido. (I4b568). - Se agregaron parámetros de color de fondo y de contenido predeterminados a
AppScaffold
. (I56652). - Se cambió el nombre del control predeterminado de
HorizontalPager
de gestos de deslizamiento aPagerDefaults.gestureInclusion
. El comportamiento predeterminado ahora es ignorar solo los gestos de deslizamiento que comienzan en el borde izquierdo de la primera página y solo cuando TalkBack está desactivado. En otros casos, el comportamiento predeterminado es que el selector no ignorará los gestos de deslizamiento, por lo que no estarán disponibles para los controladores de deslizamiento para descartar. (Iee486). - Se agregó un parámetro
SurfaceTransformation
a los componentes de encabezado de lista, tarjeta y botón para que puedan aplicar diferentes transformaciones de fondo y contenido cuando se usan en contenedores que cambian la apariencia de los elementos según su posición, comoTransformingLazyColumn
. (Iabe3f). - Se actualizaron las propiedades "public const val" de nuestra API de Material3 de Wear Compose a "public val" para evitar que los valores se incorporen. (Ib0f32).
- Se agregó compatibilidad con una zona de deslizamiento lateral a
SwipeToReveal
. El comportamiento predeterminado deSwipeToReveal
de Foundation ahora es no permitir el deslizamiento cuando el gesto comienza desde el borde. El comportamiento predeterminado deSwipeToReveal’
de Material3 ahora es no permitir el deslizamiento cuando el gesto comienza desde el borde, cuandoSwipeDirection
está configurado en una sola dirección. (I32ef0). - Se agregó el elemento componible
FadingExpandingLabel
, que le permite atenuar el texto con animación línea por línea. (Ic60fa). TransformingLazyColumn
ahora usacontentPadding
vacío de forma predeterminada en lugar de colocar el primer y el último elemento en el centro. (I77ab7).- Se quitó
rememberRevealState
deSwipeToReveal
de la biblioteca de Material3 de Wear Compose. (I8c0e0).
Correcciones de errores
- Las bibliotecas de Wear Compose se actualizaron al compilador de Kotlin 2.0. (I2de79).
- Se quitó la compatibilidad con
ScrollIndicator
yPageIndicator
no redondos de Material3. La compatibilidad con pantallas cuadradas ya no forma parte de los requisitos de Wear OS. Consulta la Guía de introducción para obtener más información. (I9a852). - Se actualizó el
CurvedTextStyle
que se usa enConfirmationDialogDefaults
yOpenOnPhoneDialogDefaults
para usar la tipografíaArcLarge
con el tamaño18sp
y el espacio entre letras1.8sp
. (Ic9ced) Card
,ListHeader
,RadioButton
,CheckboxButton
ySwitchButton
ya no restringen la altura de su contenido de forma predeterminada. Cuando sea necesario, usaModifier.height(IntrinsicSize.Min)
para restablecer el comportamiento anterior. (I80bb8).- Actualizamos los colores predeterminados
TimeText
yScrollIndicator
para incluir más tonos de gris, ya que el uso deOnBackground
(blanco) tenía demasiado peso visual cuando competía con otro contenido en pantalla, como los títulos. (I8b36f). - Redujimos el tiempo de espera para animar
TimeText
yScrollIndicator
en los componentes del andamiaje a 2 segundos. (I52021). - Actualizamos el movimiento de Dialog para que la escala del fondo del diálogo se sincronice con el deslizamiento para descartarlo. (I925a9)
- Se agregó una demostración de
SwipeToReveal
de M3 con el modificadoredgeSwipeToDismiss
. (I02b07). - Agregamos un encabezado a
DatePicker
yTimePicker
en TalkBack para que se le informe al usuario que se desplace para establecer la fecha y la hora. (Id738d). AnimatedText
ahora sigue la configuración de reducción de movimiento. (Ib6578).- Se mejoró la optimización para usar
AppScaffold
para mostrar el contenido del diálogo, lo que permite que se muestren varios diálogos uno encima del otro (I1209c).
Versión 1.0.0-alpha33
26 de febrero de 2025
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha33
. La versión 1.0.0-alpha33 contiene estas confirmaciones.
Cambios en la API
- Quitamos el parámetro de etiqueta de
primaryAction
ysecondaryAction
deSwipeToRevealScope
. El desarrollador debe agregar la semántica de acción personalizada directamente al contenido del componenteSwipeToReveal
. (Ia67f3). - Quitamos los prefijos "Button" de los tamaños, los estilos de texto y las funciones de color en
IconToggleButtonDefaults
yTextToggleButtonDefaults
(I5471d). - Se quitó el
LocalMinimumInteractiveComponentEnforcement
experimental (I4ad8a). - Reemplazamos la DSL de
PickerGroupScope
por un elemento componible. Por lo tanto, quitamos el métodopickerGroupItem
dePickerGroupScope
y, en su lugar, agregamos@Composable PickerGroupItem
, que se debe usar para agregar un selector aPickerGroup
. También actualizamos el tipo del parámetro "content" dePickerGroup
a@Composable PickerGroupScope.() -> Unit
. (Ic6aec). - Se agregó una sobrecarga
LevelIndicator
para valores fraccionarios y un prefijo Stepper a aquellas sobrecargas que incluyen un parámetro de rango (que son adecuadas para usar con el componente Stepper). (If4234). - Agregamos
TransformationSpec
deTransformingLazyColumn
a la API, lo que permite definir las transformaciones exactas que se producen en los elementos a medida que se desplazan por el TLC. (I21856). - Se actualizaron
IconButtonShapes
,IconToggleButtonShapes
,TextButtonShapes
yTextToggleButtonShapes
para que sean coherentes con las clases de Compose/Material3 (I5a081). - Se agregó un parámetro
overscrollEffect
aScalingLazyColumn
,TransformingLazyColumn
yScreenScaffold
. (I0cee8). - Se cambió el nombre del parámetro
swipeDirection
arevealDirection
enrememberRevealState
. (I7472f). - El selector de páginas para Wear ahora tiene su propio
PagerScope
en lugar de usarPagerScope
de Compose. (I9195b) - Quitamos el elemento componible
LinearProgressIndicatorContent
. UsaLinearProgressIndicator
directamente para que los cambios en los valores se animen de forma predeterminada. (I2c4ad). - Quitamos el elemento componible
CircularProgressIndicatorStatic
y agregamos una función públicaDrawScope
drawCircularProgressIndicator
con la misma funcionalidad. UsaCircularProgressIndicator
directamente para que los cambios se animen de forma predeterminada, pero compila tu propio elemento componible desdedrawCircularProgressIndicator
si necesitas animaciones personalizadas. (Ie762f). - Reordenamos los parámetros en
DrawScope.drawCircularProgressIndicator
para subir el parámetrotargetProgress
. (I8ab92). - Se actualizó la API de
OpenOnPhoneDialog
para que sea más clara y coherente con otros diálogos. Se cambió el nombre del parámetroshow
avisible
y el llamador ahora proporcionacurvedText
en lugar de tener un valor predeterminado. (Idec2d). - Cambiamos el nombre de
openOnPhoneCurvedText
poropenOnPhoneDialogCurvedText
(I65bdd). - Se agregó
ScrollIndicatorColors
para proporcionar colores personalizados aScrollIndicator
. (I9eb8c). - Permite la configuración del color que se usa para dibujar un fondo detrás de
TimeText
. (I9f5d9). - Se actualizaron las tipografías
ArcLarge
,ArcMedium
yArcSmall
aCurvedTextStyle
(Iffc41). - Quitamos
ScreenScaffoldDefaults.contentPaddingWithEdgeButton
. (Ia923e) - Se agregó
errorDim
aColorScheme
para errores de alta prioridad o acciones de emergencia, como alertas de seguridad, superposiciones de diálogo fallidas o botones de detención. (I70998).
Correcciones de errores
- Fijé
wear.compose.material3
a la versión 1.15.0 deandroidx.core.core
(I132e9). - Mejoramos el rendimiento de Dialog usando
AppScaffold
para superponer diálogos sobre otro contenido de la pantalla (I1b9a4). - Se redujo el padding vertical interno de
EdgeButton
. (I1a5bb). - Se agregaron semánticas de botones a los botones del control deslizante. (I80cc6).
Versión 1.0.0-alpha32
29 de enero de 2025
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha32
. La versión 1.0.0-alpha32 contiene estas confirmaciones.
Cambios en la API
- En
CurvedTextStyle
, dividimos el espaciado entre letras en sentido de las manecillas del reloj y en sentido contrario a las manecillas del reloj. Esto es necesario porque las letras en el sentido de las manecillas del reloj se expanden desde la línea de base, mientras que las letras en el sentido contrario se contraen (por lo que se necesita un espaciado entre letras más grande) (I4b848). - Actualizamos
IconButtonShapes
,IconToggleButtonShapes
,TextButtonShapes
yTextToggleButtonShapes
para mejorar la coherencia entre las bibliotecas de Material3. Este cambio también presenta el almacenamiento en caché de formas para reducir la cantidad de asignaciones. (I049fc). - Quitamos el parámetro
pressedShapeCornerSizeFraction
del métodovariantAnimatedShape
enIconToggleButton
yTextToggleButton
(I58a65). - Presentamos mejoras en la renderización de texto curvo (incluidos
TimeText
) que no son compatibles con pantallas no redondas. La compatibilidad con pantallas no redondas ya no forma parte de los requisitos de Wear OS. Consulta la Guía de introducción para obtener más información. (I1cc1c). - Se actualizó
ButtonGroupScope
deButtonGroup
y se reemplazóButtonGroupItem
basado en DSL porModifier.weight
,Modifier.minWidth
yModifier.enlargeOnPress
. (I16c3c). - En la API de
ButtonGroup
, actualizamos el nuevoButtonGroupScope
basado en modificadores:enlargeOnPress
ahora se llamaanimateWidth
y toma unInteractionSource
, en lugar deMutableInteractionSource
, porque no es necesario mutarlo. También agregamos la constante públicaButtonGroupDefaults.DefaultMinWidth
, que es la anchura mínima predeterminada de los botones en unButtonGroup
. (Ie27ec). - Se actualizó
ListHeaderDefaults.contentColor
para que comience con una letra en minúscula, ya que es una propiedad componible (I125a5). - Se agregó un parámetro de descripción de contenido a
SliderDefaults.DecreaseIcon
ySliderDefaults.IncreaseIcon
, con valores predeterminados adecuados (I2e1a7). - Se cambió el nombre del parámetro
spacing
enPicker
yPickerGroup
averticalSpacing
(Ib75cc). - Quitamos
ConfirmationDialogDefaults.successText
yfailureText
porque se espera que los llamadores deConfirmationDialog
proporcionen cadenas con más contexto. También se cambió el nombre deconfirmationCurvedText
porconfirmationDialogCurvedText
. Por último, se cambió el nombre del parámetroshow
de diálogo a visible para mantener la coherencia con otras actualizaciones recientes de los diálogos. (I10074). IconButton
cambió el nombre dedisabledImageOpacity
aDisabledImageOpacity
. (I5f94a).
Correcciones de errores
- Corregimos un error en la animación de
EdgeButton
para que se use el tamaño correcto en cada fotograma (Id3b58). - Se corrigió un problema por el que
animateContentSize
no funcionaba conButton
. (Ib18a0). - Cambiamos la escala de tipo de título grande para que tenga un tamaño de fuente de
18dp
(Ic9d52). - Se actualizaron el espaciado y el tamaño del ícono de
AlertDialog
(Iac28c). - Se corrigieron las inconsistencias en los puntos de interrupción de pantallas grandes (las pantallas de 225 dp o más son pantallas grandes) (I36474).
- Se corrigió un error menor en la posición de los botones (I952c2).
Versión 1.0.0-alpha31
15 de enero de 2025
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha31
. La versión 1.0.0-alpha31 contiene estas confirmaciones.
Cambios en la API
- Actualizamos todas las bibliotecas de Wear Compose al modo "API explícita". (Iebf9f).
- Actualizamos las APIs de
ScreenScaffold
yEdgeButton
para que sea más fácil especificar rellenos de contenido en pantallas que incluyen unEdgeButton
. En la nueva API, elsize
deEdgeButton
solo se pasa aEdgeButton
, yScreenScaffold
toma un parámetroedgeButtonSpacing
para el espaciado entreEdgeButton
y el contenido de la lista. (I424fd). - En
DatePicker
, cambiamos el nombre de los parámetrosminDate
amaxDate
yminValidDate
amaxValidDate
. EnDatePickerColors
, cambiamos el nombre del parámetroselectedPickerContentColor
aactivePickerContentColor
y el deunselectedPickerContentColor
ainactivePickerContentColor
(Iba17b). - Se actualizaron los valores predeterminados de
ArcProgressIndicator
astrokeWidth=6dp
y se recomendódiameter = 81.24%
de altura de pantalla (I6f248). - Actualizamos la API de Confirmation para que refleje su uso como diálogo. El elemento componible ahora se llama
ConfirmationDialog
, con actualizaciones asociadas a los nombres de los colores y las clases predeterminadas. También cambiamos el nombre del parámetroshow
avisible
para que sea compatible con otras APIs de animación de Compose. Además,ConfirmationDialogContent
,SuccessConfirmationDialogContent
yFailureConfirmationDialogContent
están disponibles para situaciones en las que los desarrolladores necesitan personalizar las animaciones de los diálogos de introducción o cierre. (Iaeb33). - Se actualizó
CircularProgressIndicatorContent
aCircularProgressIndicatorStatic
(la variación no animada deCircularProgressIndicator
) para que ahora se pueda usar para compilarCircularProgressIndicator
con animaciones personalizadas. (I1346f). - Corrigimos el orden de los parámetros en
ArcProgressIndicator
y colocamos el parámetro modificador en primer lugar (I4656a). - Se mejoró la API de
SwipeToReveal
para recibir un parámetro de espacio de texto para las etiquetas de las acciones (excepto la acción secundaria) y quitar los parámetros de etiqueta de la acción de deshacer (I5b3db).
Correcciones de errores
- Se corrigió un error por el que se activaban las respuestas táctiles de
LongPress
más de una vez enButton
,Card
,IconButton
yTextButton
(Ia8b0f). - Se realizaron cambios en la UX de
AlertDialog
: en pantallas grandes, los botones de confirmación y descarte ahora son más pequeños. También se aumentó el espacio debajo de los botones de confirmación y descarte. (I4f066). - Cambiamos las especificaciones de animación de la etiqueta del botón de acción del componente
SwipeToReveal
. (Ib87fb). - Se cambió
SwipeToReveal
para expandir el contenedor al mismo tiempo que se muestra el texto. (I44cf8) - Se mejoró
SwipeToReveal
para realizar respuestas táctiles cuando el deslizamiento supera el umbral en el que se confirma la acción principal. (I23efe). - Actualizamos
SwipeToReveal
para que muestre puntos suspensivos en el desbordamiento de texto de forma predeterminada, para las acciones principales y de deshacer. (I71f5a). - Solucionamos un problema que causaba jitter en las animaciones
ButtonGroup
. (I63f8f). - Se agregaron semánticas de texto a
AnimatedText
(I6063c). - El diálogo ahora restablece el escalamiento en segundo plano cuando se quita de la composición (sin esta corrección, es posible que la pantalla de inicio se haya dejado en un estado reducido) (Id24ac).
- Se agregó una animación de transformación de forma a los botones del componente Stepper (Id6ed3).
Versión 1.0.0-alpha30
11 de diciembre de 2024
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha30
. La versión 1.0.0-alpha30 contiene estas confirmaciones.
Cambios en la API
- Se refactorizó el modificador
scrollTransform
paraTransformingLazyColumn
, lo que activó un cambio en la API. (I0c6dc). - Se actualizaron
IconToggleButtonShapes
yTextToggleButtonShapes
para tener dos parámetros de forma diferentes:uncheckedPressed
ycheckedPressed
(I85dbd). - Las opciones de mes o día no válidas ahora se pueden ver en
DatePicker
, con un nuevoinvalidPickerContentColor
, cuando se usaminDate
omaxDate
. (If4541). - Actualizamos la API de
Stepper
para proporcionar ranurasincreaseIcon
ydecreaseIcon
. El contenido para estas se puede compilar como de costumbre desde el elemento componible Icon. (Id35da) - Actualizamos
dynamicColorScheme
quitando el parámetro opcionaldefaultColorScheme
y ahora devolvemosColorScheme
anulable. Esto significa que el llamador debe controlar de forma explícita el caso de resguardo cuando no se proporciona un esquema de colores dinámico. (I6d62e). - Se actualizaron los tamaños de los íconos en
ButtonDefaults
para usarlos conCompactButton
. UnCompactButton
que solo contiene un ícono debe usarButtonDefaults.SmallIconSize = 24.dp
, mientras que unCompactButton
que contiene ícono y texto debe usarButtonDefaults.ExtraSmallIconSize = 20.dp
. Se recomienda queCompactButton
una su contenido (en lugar de completar el ancho máximo) y se actualizaron los ejemplos para mostrarlo. (I0582c) - Agregamos
EdgeButtonDefaults
con tamaños de íconos recomendados para los 4EdgeButtonSizes
diferentes. También se actualizó el diseño deEdgeButton
para que tenga un padding inferior ligeramente más grande que el padding superior, lo que mejora la apariencia del contenido de íconos y texto. (Id772a) - Agregamos movimiento a
LinearProgressIndicator
y expusimosLinearProgressIndicatorContent
, que proporciona el contenido visual sin animaciones. (Idee99). - Agregamos un nuevo elemento componible
CircularProgressIndicatorContent
para mostrar el contenido visual deCircularProgressIndicator
sin animaciones. (Ie33d4) TransformingLazyColumn
ahora proporciona elLocalTransformingLazyColumnItemScope
local de composición que losCard
,Button
yListHeader
ahora usan para transformarse automáticamente cuando se colocan dentro de unTransformingLazyColumn
. Los emisores pueden inhabilitar la transformación automática con el nuevo wrapperTransformExclusion
. (I1652f).- Se actualizó el tipo de
ButtonDefaults.shape
aRoundedCornerShape
(Iccdf2).
Correcciones de errores
- Corregimos un error para respetar el alfa existente en el fondo de
TimeText
(I1eb60). - Establecimos
TextMotion
enAnimated
de forma predeterminada en nuestra tipografía para evitar el jitter de texto debido a que los glifos de letras se ajustan a los límites de píxeles durante las operaciones de escalamiento. (I626fa). - Actualizamos el aspecto de
ScrollIndicator
aumentando el ancho y el tamaño del espacio para mejorar la visibilidad. (Ied7cb). - Corregimos un error en
Modifier.scrollTransform
cuando se agregaban, quitaban o movían elementos. (I6830f). - Se corrigió un problema de animación de botones redondos para toques cortos (anteriormente, no siempre se observaba la duración mínima de la animación). (I757a7).
- Actualizamos el ángulo de barrido de
LevelIndicator
al 20% (es decir, 72 grados). (Idde5c). - Se corrigió el posicionamiento de
ScrollIndicator
cuando se usabaScalingLazyColumn
conAutoCenteringParams
. (I387dd). - Actualizamos los colores y la tipografía de
ListHeader
yListSubHeader
. También los colores de los controles de activación enCheckboxButton
ySwitchButton
. (I39817) - Se corrigió el posicionamiento de
ScrollIndicator
enLazyColumn
yScalingLazyColumn
conContentPadding
. (I2bc51). - Corregimos un error que se veía en la animación de progreso de
OpenOnPhoneDialog
con el nuevoCircularProgressIndicatorContent
. (I3e443) - Se actualizaron
HorizontalPagerScaffold
yVerticalPagerScaffold
para inhabilitar las animaciones cuando se habilita la opción para reducir el movimiento (Iaaf68). - Implementamos una animación independiente para los indicadores de progreso circulares cuando el progreso supera el 100%. (I47135).
- Corregimos un error por el que
EdgeButton
se podía dibujar con una forma incorrecta en los componentes de Pager (I91db9).
Versión 1.0.0-alpha29
13 de noviembre de 2024
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha29
. La versión 1.0.0-alpha29 contiene estas confirmaciones.
Cambios en la API
- Actualizamos
TimeText
para proporcionar contenido predeterminado que muestre la hora. (Id23b3). - Se simplificó
ScrollInfoProvider
paraPagerState
quitando el parámetroorientation
, que ya no es necesario. El nuevo comportamiento es queTimeText
permanezca en su lugar para la paginación horizontal y vertical. (I71767). LocalHapticFeedback
ahora proporciona una implementación predeterminada deHapticFeedback
cuando la API de Vibrator indica que se admiten las respuestas táctiles. Se agregaron los siguientes elementos aHapticFeedbackType
:Confirm
,ContextClick
,GestureEnd
,GestureThresholdActivate
,Reject
,SegmentFrequentTick
,SegmentTick
,ToggleOn
,ToggleOff
yVirtualKey
. Los componentes de Wear Compose en los que se puede hacer clic con el botón presionado, comoButton
,IconButton
,TextButton
yCard
, ahora realizan la respuesta táctilLONG_PRESS
cuando se proporciona un controlador de clic largo. (I5083d)
Correcciones de errores
- Actualizamos el movimiento de Confirmaciones. (I04bff).
- Actualizamos la dependencia mínima de API a 1.7.4 para las bibliotecas de Compose. (I88b46).
- Se agregó un nuevo movimiento para el diálogo
OpenOnPhone
. (I1e10a). - Corregimos un error en
LevelIndicator
para que ahora se muestre correctamente con el nivel cero. (Ie95a4). - Actualizamos las animaciones
HorizontalPageIndicator
yVerticalPageIndicator
. (I5c8f3) - Se agregó una animación de reducción a punto al
ArcProgressIndicator
indeterminado. (I9fd51).
Versión 1.0.0-alpha28
30 de octubre de 2024
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha28
. La versión 1.0.0-alpha28 contiene estas confirmaciones.
Cambios en la API
- Agregamos una variación de arco al indicador de progreso circular indeterminado (I2efc1).
- Hicimos públicos los elementos componibles
AlertDialogContent
yDialog
que conforman la API deAlertDialog
para que sea posible agregar personalización si es necesario (como personalizar la animación deAlertDialog
y, al mismo tiempo, mantener el diseño de contenido recomendado). Además, agregamos los parámetrosModifier
yColor
a los miembrosEdgeButton
,ConfirmButton
yDismissButton
deAlertDialogDefaults
. (I4eb71). - Actualizamos la API de
Placeholder
de la siguiente manera: cambiamos el nombre dePlaceholderState.startPlaceholderAnimation
aPlaceholderState.animatePlaceholder
, dePlaceholderState.isShowContent
aPlaceholderState.isHidden
y dePlaceholderDefaults.shape
aPlaceholderDefaults.Shape
; cambiamos el nombre del parámetropainter
enpainterWithPlaceholderOverlayBackgroundBrush
aoriginalPainter
; cambiamos la visibilidad dePlaceholderState.placeholderProgression
de pública a interna y le cambiamos el nombre aplaceholderShimmerProgression
; y agregamos constantes de duración de animación de marcador de posición aPlaceholderDefaults
. (Ie5a59). - Actualizamos la API de
EdgeButton
de la siguiente manera: cambiamos el nombre del parámetro enScreenScaffold
debottomButton
aedgeButton
y convertimosEdgeButtonSize
en una clase de valor. (Ieef15). - Cambiamos la visibilidad de
copy()
a pública en las clases de colores de Material3 para Wear (I0287f).
Correcciones de errores
- Se agregó una duración mínima de animación para
IconToggleButton
yTextToggleButton
al hacer clic (Ieb333). - Se agregó una duración mínima a la animación de formas
IconButton
yTextButton
(Iebcee). - Se corrigió el estado de la opción de repetición de
DatePicker
. (I3587c). - Se agregó movimiento para los diálogos de Alerta y Confirmación. (I173b1).
Versión 1.0.0-alpha27
16 de octubre de 2024
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha27
. La versión 1.0.0-alpha27 contiene estas confirmaciones.
Cambios en la API
- Se actualizaron
ScreenScaffold
yScrollIndicator
después de cambiar el nombre de Wear Compose FoundationLazyColumn
aTransformingLazyColumn
. (I0608b). - Se cambió el nombre del parámetro
preferredHeight
deEdgeButton
abuttonSize
, y su valor solo se puede elegir entre 4 constantes en la nueva clase de valoresEdgeButtonSize
. (Icdd70). - Cambiamos el nombre de
ListSubheader
aListSubHeader
y agregamos valores predeterminados de acceso público paraListHeader
yListSubHeader
. (I96730). - Agregamos nuevos componentes
HorizontalPagerScaffold
yVerticalPagerScaffold
para Wear que proporcionan animaciones y coordinación nuevas entre el texto de la hora y los componentes del indicador de página. (Iff7d0). - Se agregó compatibilidad con controles rotativos a
HorizontalPagerScaffold
yVerticalPagerScaffold
, lo que permite a los usuarios navegar por los buscapersonas con dispositivos de entrada rotativos. (I9770d). - Realizamos cambios en la API de
MotionScheme
para simplificar el uso y mejorar la coherencia. Se quitaron las funciones de recuerdo intercaladas y se movieron los esquemas de movimiento integrados a un objeto complementario de MotionScheme dedicado. Se cambió el nombre destandardMotionScheme
yexpressiveMotionScheme
a estándar y expresivo. (I5fd45). - Se agregó compatibilidad con un esquema de colores dinámico basado en los colores del sistema. (I073e9)
- Actualizamos el control Stepper a las especificaciones de UX más recientes. (I622bb).
Correcciones de errores
- Actualizamos la tipografía y los paddings de los componentes de la tarjeta. (I3ae48).
- Cambiamos el padding en
AlertDialog
entre los botones Confirmar/Cancelar y el resto del contenido de 8 dp a 12 dp según las especificaciones de UX (Ie55f0). - Actualizamos la opacidad del color del componente Slider. (Idb383).
Versión 1.0.0-alpha26
2 de octubre de 2024
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha26
. La versión 1.0.0-alpha26 contiene estas confirmaciones.
Cambios en la API
- Se actualizaron la API y el aspecto de
HorizontalPageIndicator
, y se agregóVerticalPageIndicator
para usar conVerticalPager
(Ic9309). AlertDialog
ahora admite la posibilidad de omitir el botón inferior predeterminado de la variación de pila de botones para diseños personalizados en los que no se requiere EdgeButton. (I34fa9).- Agregamos un componente
SwipeToReveal
para Wear Material 3 (Ic38b2). - Agregamos compatibilidad con el deslizamiento bidireccional en
SwipeToReveal
para los casos poco frecuentes en los que la pantalla actual no admite el deslizamiento para descartar. La opción predeterminada sigue siendo el gesto de deslizar para mostrar solo en los deslizamientos de derecha a izquierda, y se recomienda respetar el comportamiento predeterminado para evitar conflictos con el gesto de deslizar para descartar. (Ifac04). - Se cambió el nombre del parámetro
buttonHeight
deEdgeButton
apreferredHeight
. (I4fab3). - Se actualizó la versión de Kotlin a la 1.9 (I1a14c).
- Se cambió el nombre de
OpenOnPhoneDialogDefaults.Icon
porOpenOnPhoneDialogDefaults.OpenOnPhoneIcon
para evitar conflictos conIcon
(I0f391). - Agregamos compatibilidad con
ScrollIndicator
enLazyColumn
. (Ia546a). - Actualizamos los valores predeterminados de
TextToggleButton
yIconToggleButton
. (I7aaa9). - Simplificamos las APIs de
Picker
yPickerGroup
. (Id0653). - Se agregaron
CardDefaults.Shape
yCardDefaults.Height
, que (como tokens) eran privados para los desarrolladores que usaban la biblioteca. (I1594a, b/347649765) - Cambiamos el nombre del parámetro de progreso del indicador de progreso circular segmentado binario a
segmentValue
. (Ib72d9). - Actualizamos los colores y el diseño del control deslizante. (Ic3eec).
Correcciones de errores
- Se actualizó la animación del ícono
openOnPhone
(I66f85). - Ahora usamos íconos de Google Symbols en
Slider
,TimePicker
yDatePicker
. (I46c7c). - Se actualizaron los rellenos en
Confirmation
yOpenOnPhoneDialog
. (Iaa82e).
Versión 1.0.0-alpha25
18 de septiembre de 2024
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha25
. La versión 1.0.0-alpha25 contiene estas confirmaciones.
Cambios en la API
- Agregamos un indicador de progreso circular indeterminado. (I427a7)
- Se agregó compatibilidad con el desbordamiento de progreso (>100% de progreso) para
CircularProgressIndicator
ySegmentedCircularProgressIndicator
. Cuando el progreso supere 1.0, se indicará con el nuevo coloroverflowTrack
. (Iaaa3d). - Los elementos
IconToggleButton
yTextToggleButton
redondos ahora admiten una nueva variación de animación de formas, en la que diferentes formas representan estados marcados, no marcados y presionados. Se sigue admitiendo la variación de forma animada anterior para el estado de solo presionar. (I29f03). - Quitamos la compatibilidad con el uso de
EdgeButton
conColumn
debido a la necesidad de especificar la altura deEdgeButton
de forma explícita enScreenScaffold
. (Ie353d). - Agregamos compatibilidad con
LazyColumn
de Wear Compose con nuestroScreenScaffold
(y agregamos una implementación deScrollInfoProvider
paraLazyColumnState
). (Ib8d29). - Combinamos
LocalTextMaxLines
,LocalTextAlign
yLocalTextOverflow
en una sola composición local deLocalTextConfiguration
para proporcionar una solución más escalable en el futuro. (I5edbc). - Agregamos arc-large como un tipo de escala adicional, reservado para cadenas de texto de encabezado breves en la parte superior o inferior de la pantalla, como en las superposiciones de confirmación. (I60e3e).
- Agregamos valores predeterminados a Button para los tamaños de íconos grandes y extragrandes recomendados, y el padding de contenido. (I84675).
Correcciones de errores
- Se actualizaron los colores de
IconButton
yTextButton
. (I48324). - Cambiamos las sobrecargas de Button base para que estén alineadas verticalmente en el centro para mantener la coherencia con otras sobrecargas. Para restaurar el comportamiento anterior, usa
Modifier.align
desdeRowScope
. (I66e57).
Versión 1.0.0-alpha24
4 de septiembre de 2024
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha24
. La versión 1.0.0-alpha24 contiene estas confirmaciones.
Cambios en la API
- Se agregó un esquema de movimiento al tema Material3. Los componentes de la biblioteca lo usarán para aplicar especificaciones de animación, como resortes para el movimiento expresivo. (I54ff3)
- Agregamos componentes
AppScaffold
yScreenScaffold
a la biblioteca de Material3, que incluyen funciones para coordinar las capas y las transiciones deTimeText
yScrollIndicator
.AppScaffold
proporciona un nivel superior de componentes de andamiaje que se ubican sobre todas las pantallas. Por lo tanto, agregarTimeText
aAppScaffold
le permite permanecer en su lugar mientras te deslizas entre pantallas. Las pantallas pueden anular o ocultar el texto de la hora.ScreenScaffold
proporciona un espacio paraScrollIndicator
y anima automáticamente el indicador de desplazamiento cuando se desplaza, incluido el tiempo de espera para ocultar el indicador de desplazamiento después de la inactividad. (I047d6) - Agregamos
ScrollIndicator
con el nuevo diseño de Material3. Tiene un tamaño de miniatura fijo basado en el contenido inicial de la lista para evitar variaciones de tamaño cuando se carga contenido diferido en la lista. (Ic228d). - Cambiamos la API de
ScrollAway
de modo queScreenStage
sea una clase de valor en lugar de una clase de enum para permitir que se agreguen etapas adicionales según sea necesario en el futuro. (I48c93). - Agregamos
EdgeButton
, un botón distintivo específico para Wear con una forma que sigue la curvatura de la parte inferior de la pantalla (I16369). - Se agregó un nuevo espacio a
ScreenScaffold
para un botón inferior (comoEdgeButton
), que se mostrará y cambiará de tamaño según el contenido del desplazamiento (I032eb). - Se agregaron
Modifier.scrollTransform
yModifier.targetMorphingHeight
para agregar efectos de movimiento de Material3 a los elementos deLazyColumn
. (Ie229a) - Se agregó
SegmentedCircularProgressIndicator
como una variación deCircularProgressIndicator
. La variación segmentada muestra un solo valor de progreso en todos los segmentos o muestra cada segmento como activado o desactivado. (I6e059) - Se agregó
LinearProgressIndicator
como alternativa alCircularProgressIndicator
existente. (I89182) - Agregamos
AlertDialog
, que proporciona diseños para presentar instrucciones importantes al usuario. Se incluyen variaciones para un par de botones de confirmación o descarte, o un solo botón inferior (por lo general, un EdgeButton) debajo de una pila de opciones. Ambas variantes tienen espacios para el ícono, el título y el texto adicional para proporcionar más detalles. (Ieb873) - Agregamos
OpenOnPhoneDialog
, que se debe usar para indicar una acción que continuará en el teléfono del usuario.OpenOnPhoneDialog
se descarta después de un tiempo de espera especificado. (I978fd). - Se agregó
Confirmation
, un componente de diálogo que tiene ranuras para un ícono y texto curvo o lineal. Se proporcionan variaciones específicas para los mensajes de éxito o error. Las confirmaciones se descartan automáticamente después de un tiempo de espera. (Ib43e8) - Agregamos un fondo a
TimeText
para mitigar los problemas en los que el contenido subyacente yTimeText
se superponían y ocultaban la hora. (Ia11fd). - Agregamos
LevelIndicator
, que muestra el valor de un parámetro de configuración, como el volumen, y se puede usar con el componenteStepper
existente para construir una pantalla de volumen.LevelIndicator
es similar aScrollIndicator
, pero se muestra en el lado opuesto de la pantalla y tiene un ancho de trazo más amplio y un color de indicador diferente de forma predeterminada. (I8a4ac) - Se agregó
TimePicker
, con diseños para la hora de 24 horas (con o sin segundos) o la hora de 12 horas con selección de a.m./p.m. (Ia5124). - Se agregó
DatePicker
, con la configuración para el orden de las columnas (es decir, día-mes-año, mes-día-año o año-mes-día) y fechas mínimas y máximas opcionales. (Ibf13b). - Se agregó un parámetro de peso a la función
text
deTimeText
. En los casos en que TimeText consta de más de un elemento de texto, esto permite controlar cómo se distribuye el espacio. (I36700). - Agregamos
RadioButton
ySplitRadioButton
. Estos componentes simplifican la API anterior combinando (Split)SelectableButton
y el control de radio secundario (If7ae8). - Agregamos
CheckboxButton
ySplitCheckboxButton
. Estos componentes simplifican la API anterior combinandoToggleButton
(dividido) y el control de casilla de verificación secundario (Ia8f70). - Agregamos
SwitchButton
ySplitSwitchButton
. Estos componentes simplifican la API anterior combinando(Split)ToggleButton
y el control de interruptor secundario (I0d349). - Actualizamos la documentación de
AnimatedText
para explicar el comportamiento de sobrepaso. (Iff30a). - Agregamos
ButtonGroup
para combinar 2 o 3 botones de modo que los toques produzcan una animación coordinada. (Ie27db). - Se agregó una animación de forma opcional para
IconButton
yTextButton
cuando se presionan. (Iffca5). - Se agregó una variación de color adicional,
FilledVariant
, aButton
,IconButton
,TextButton
,CompactButton
yEdgeButton
(I65fc3). - Se agregó el parámetro
forcedSize
aImageWithScrimPainter
, de modo que los fondos de imagen de Button ahora mantienen su tamaño de componente de forma predeterminada. Si configurasforcedSize = null
, se adoptaráPainter.instrinsicSize
. (Ic57af). - Se agregó la acción de mantener presionado a los botones (Ib613d).
- También se agregó compatibilidad con el clic largo a
IconButton
yTextButton
. (I38891). - Se agregó compatibilidad con el clic largo a las tarjetas. (I305d5).
- Agregamos
LocalTextMaxLines
,LocalTextAlign
yLocalTextOverflow
comoCompositionLocals
y los usamos como parámetros predeterminados enText
. Los componentes comoCheckboxButton
,SwitchButton
yRadioButton
ahora pueden usar los elementos locales de composición para implementar la guía de UX, pero los desarrolladores pueden anular los parámetros si es necesario. (Iab841). - Agregamos
Placeholder
para ayudar a enmascarar el contenido de componentes como botones y tarjetas hasta que se carguen los datos. (I1a532) - Agregamos
IconToggleButtonColors
yTextToggleButtonColors
para reemplazarToggleButtonColors
, que ahora se quitó. (Ie0bf1).
Correcciones de errores
- Actualizamos
Button
,FilledTonalButton
,OutlinedButton
,ChildButton
yCompactButton
para usar los nuevosCompositionLocals
LocalTextMaxLines
,LocalTextAlign
yLocalTextOverflow
para implementar la guía de UX. Los desarrolladores pueden anular estos parámetros directamente en Text si es necesario (Ie51f7). - Cambiamos el ancho de trazo predeterminado de
LevelIndicator
a6dp
para diferenciarlo deScrollIndicator
, que tiene un ancho de trazo de4dp
. (If6f63). - Se corrigió un problema en
TimeText
para que se admitan ángulos de barrido más grandes. (Ie489f) - Se corrigió un problema durante la recomposición de
EdgeButton
. (I4cdca). - Se corrigieron los diseños de los botones de activación divididos cuando se proporciona un padding de contenido personalizado. (Ia33d3)
- Se redondearon los valores de progreso pequeños al menos al ancho de línea del indicador de progreso. (I3bd84).
Versión 1.0.0-alpha23
14 de mayo de 2024
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha23
. La versión 1.0.0-alpha23 contiene estas confirmaciones.
Cambios en la API
- Se actualizaron las APIs de
ToggleButton
yRadioButton
para que se puedan configurar los colores inhabilitados. (If13a7). - Se agregó un nuevo
CircularProgressIndicator
para Material3. (Ib3bd7).
Correcciones de errores
- Corregimos un error por el que los botones seleccionables anunciaban la acción de presionar dos veces para activar o desactivar cuando ya estaban seleccionados. (I7ed88).
Versión 1.0.0-alpha22
1 de mayo de 2024
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha22
. La versión 1.0.0-alpha22 contiene estas confirmaciones.
Cambios en la API
- Se actualizó el
ColorScheme
de Material3. (I7b2b8). - Actualizamos el interruptor de Material3. Además de algunos cambios de color, la marca ahora coincide con la que se usa para la casilla de verificación. (Icac7b)
Correcciones de errores
- Se actualizaron todas las demostraciones de integración para usar el nuevo modificador
rotaryScrollable
. (I25090).
Versión 1.0.0-alpha21
17 de abril de 2024
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha21
. La versión 1.0.0-alpha21 contiene estas confirmaciones.
- Esta versión se activó debido a un problema técnico en la versión anterior que provocó la falta de frascos de origen. No hay confirmaciones nuevas en esta versión.
Versión 1.0.0-alpha20
3 de abril de 2024
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha20
. La versión 1.0.0-alpha20 contiene estas confirmaciones.
Correcciones de errores
- Ajustamos las alfas de estado enfocado y presionado de Ripple para mejorar el contraste. (I59f0a).
- Agregamos espacio entre las etiquetas principales y secundarias en
Button
,ToggleButton
yRadioButton
, siguiendo los cambios más recientes en los estilos de tipografía y las alturas de línea. (I2c0ba).
Versión 1.0.0-alpha19
6 de marzo de 2024
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha19
. La versión 1.0.0-alpha19 contiene estas confirmaciones.
Cambios en la API
- Se agregó
TimeText
a la biblioteca de Material3 de Wear Compose. Este componente muestra la hora actual (y el estado adicional) en la parte superior de la pantalla. La nueva API concisa de Material3 evita la duplicación entre el contenido lineal y el curvo. (I4d7c3). - Se actualizaron los nombres de los parámetros de
onSelected
aonSelect
paraRadioButton
. (I1a971). - Tokeniza
RadioButton
ySplitRadioButton
, y también refactoriza los métodos existentes para reducir la cantidad de búsquedas deCompositionLocal
agregando instancias almacenadas en caché de colores y haciendo que los métodos deRadioButtonColors
ySplitRadioButtonColors
sean internos. (I02b33).
Versión 1.0.0-alpha18
21 de febrero de 2024
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha18
. La versión 1.0.0-alpha18 contiene estas confirmaciones.
Cambios en la API
- Se refactorizó el patrón predeterminado para
CardColors
,ToggleButtonColors
ySplitToggleButtonColors
creando instancias almacenadas en caché de forma interna y reduciendo el uso deCompositionLocal
. (If3fec).
Versión 1.0.0-alpha17
7 de febrero de 2024
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha17
. La versión 1.0.0-alpha17 contiene estas confirmaciones.
Cambios en la API
- Actualizamos la API de Button para usar
buttonColors
de forma predeterminada y quitamos elfilledButtonColors
duplicado. (I4fe3b). - Se refactorizaron los patrones predeterminados de
ButtonColors
,IconButtonColors
yTextButtonColors
creando una instancia almacenada en caché de forma interna y reduciendo el uso deCompositionLocal
. (I5f51c). - Quitamos la sobrecarga de
rememberUpdatedState
en las clases de colores específicas del componente y marcamos los métodos de acceso dentro de las clases de colores como internos. (If6571).
Correcciones de errores
- Se actualizó
Modifier.minimumInteractiveComponentSize
para usarModifier.node
. (Iba6b7).
Versión 1.0.0-alpha16
24 de enero de 2024
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha16
. La versión 1.0.0-alpha16 contiene estas confirmaciones.
Nuevas funciones
- Agregamos
CompactButton
, que puede usar los mismos colores rellenos, tonal y con contornos que Button.(I05df0)
Cambios en la API
- Se agregaron
RadioButton
/SplitRadioButton
como contenedores para controles de selección, como el control de radio. Esto difiere deToggleButton
existente en queRadioButton
se puede seleccionar (y opera dentro de un grupo de selección), mientras queToggleButton
se puede activar o desactivar (y es independiente). (I61275). - Quitaremos
LocalContentAlpha
de la biblioteca de Material3 de Wear Compose para mantener la coherencia con la biblioteca de Material3 de Compose. (I49a0a) - Los componentes de Material para Wear y Material 3 para Wear que exponen un
MutableInteractionSource
en su API se actualizaron para exponer unMutableInteractionSource
anulable que se establece de forma predeterminada como nulo. No hay cambios semánticos aquí: pasar un valor nulo significa que no deseas elevar elMutableInteractionSource
, y se creará dentro del componente si es necesario. Cambiar a nulo permite que algunos componentes nunca asignen unMutableInteractionSource
y que otros componentes solo creen una instancia de forma diferida cuando lo necesiten, lo que mejora el rendimiento de estos componentes. Si no usas elMutableInteractionSource
que pasas a estos componentes, te recomendamos que pases un valor nulo. También te recomendamos que realices cambios similares en tus propios componentes. (Ib90fc, b/298048146). - Se agregó una nueva API de Ripple en las bibliotecas
wear:compose-material
ywear:compose-material3
, que reemplaza a larememberRipple
obsoleta. También se agrega unCompositionLocal
temporal,LocalUseFallbackRippleImplementation
, para revertir los componentes de Material a usar las APIs derememberRipple/RippleTheme
que dejaron de estar disponibles. Se quitará en la próxima versión estable y solo se diseñó como una ayuda de migración temporal para los casos en los que proporcionas unRippleTheme
personalizado. Consulta developer.android.com para obtener información sobre la migración y más información contextual sobre este cambio. (af92b21). - Realizamos mejoras menores en la API de
HorizontalPageIndicator
y su documentación. (I60efc). - Actualizamos
ColorScheme
para que sea inmutable, lo que hace que las actualizaciones de colores individuales sean menos eficientes, pero que el uso más común de los colores sea más eficiente. El motivo de este cambio es que la mayoría de las apps no tendrían la actualización de colores individuales como caso de uso principal. Esto sigue siendo posible, pero se volverá a componer más que antes. A su vez, disminuiremos significativamente la cantidad de suscripciones de estado a través de todo el código de material y afectará el costo de inicialización y tiempo de ejecución de casos de uso más estándar. (Ibc2d6) - Se actualizaron las APIs de
ToggleButton
ySplitToggleButton
para permitir que se personalicen los colores inhabilitados. Además, los tokens de Material Design ahora se usan para los valores de color y tipografía. (If087c). - Se actualizaron los colores de fondo de la imagen del botón para usar tokens de Material Design. (Iba215).
- Quitamos el control de clics para que los componentes
Checkbox
,Switch
yRadioButton
solo se muestren. Se espera que estos componentes se usen en(Split)ToggleButton
, que controla el clic, por lo que ahora se indican más claramente como solo para visualización (y no están diseñados para usarse de forma independiente en Wear). (I2322e).
Correcciones de errores
- Se agregaron tokens para los valores de movimiento de las duraciones y las suavizaciones en Wear Compose Material 3. (I437cd)
- Se corrigió un error en
ToggleButton
,SplitToggleButton
,Checkbox
,Switch
yRadioButton
para que no se repitan los anuncios de accesibilidad (anteriormente, se duplicaban los roles semánticos). (Ica281). - Quitamos la capa de materialcore para
CompactButton
para mejorar el rendimiento. (7902858)
Versión 1.0.0-alpha15
15 de noviembre de 2023
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha15
. La versión 1.0.0-alpha15 contiene estas confirmaciones.
Cambios en la API
- Se cambió el nombre del nivel de fundación
SwipeToDismissBox
aBasicSwipeToDismissBox
. Esto hace que la distinción entre el componente de nivel de Foundation y elSwipeToDismissBox
de nivel de Material3 sea más clara. Este último extrae colores deMaterialTheme
para usarlos en las pantallas en blanco y delega la implementación restante aBasicSwipeToDismissBox
. (Ibecfc).
Correcciones de errores
- Quitamos la capa material-core para el botón Material3 para mejorar el rendimiento. (I55555).
Versión 1.0.0-alpha14
18 de octubre de 2023
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha14
. La versión 1.0.0-alpha14 contiene estas confirmaciones.
Cambios en la API
- Quitamos el parámetro
indicatorStyle
deHorizontalPageIndicator
de Material3. En su lugar, seguirá la forma de la pantalla del dispositivo (lineal o redonda). (I83728). - Separamos los colores de
SplitToggleButton
de los deToggleButton
agregando una nueva claseSplitToggleButtonColors
. (I78bee).
Versión 1.0.0-alpha13
4 de octubre de 2023
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha13
. La versión 1.0.0-alpha13 contiene estas confirmaciones.
Cambios en la API
- Se agregó un campo de subtítulos opcional a
TitleCard
. (Ifc45a). - Agregamos tokens de color de Material Design para
TextButton
. (I769dc)
Versión 1.0.0-alpha12
20 de septiembre de 2023
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha12
. La versión 1.0.0-alpha12 contiene estas confirmaciones.
Cambios en la API
- Se actualizó
IconButton
para usar tokens de Material Design. (I3f137). - Se actualizó
IconToggleButton
para usar tokens de Material Design. (I7d263). - Hicimos públicos los constructores de
CheckboxColors
,RadioButtonColors
ySwitchColors
. (I82b73).
Versión 1.0.0-alpha11
6 de septiembre de 2023
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha11
. La versión 1.0.0-alpha11 contiene estas confirmaciones.
Correcciones de errores
- Se actualizó la tipografía de las tarjetas de Material3 a
TitleMedium
. (I597bd). - Actualizamos la tipografía y la alineación de nuestros elementos
ListHeader
yListSubheader
de Material3. (Ib5ceb).
Versión 1.0.0-alpha10
23 de agosto de 2023
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha10
. La versión 1.0.0-alpha10 contiene estas confirmaciones.
Nuevas funciones
- Se agregó
HorizontalPageIndicator
en la biblioteca de Material3 para Wear. (Ifee99).
Cambios en la API
- Se actualizó el código de los botones para usar tokens de diseño de Material3. (I92fe4).
- Se declararon las APIs de Stepper y Slider de Wear Material 3 como experimentales, ya que aún se están finalizando los detalles de la interfaz de usuario. (I84d54).
- Quitamos los tamaños
ExtraSmall
de losTextButton
yTextToggleButton
redondos, ya que ese tamaño solo se aplica aIconButton
. (Ibc7d5).
Correcciones de errores
- Actualizamos la guía de tipografía de TextToggleButton para usar LabelLarge para LargeButtonSize (Ib10fa).
- Actualizamos la guía de tipografía de TextButton para usar LabelLarge para LargeButtonSize (I8f3a7).
- Para mejorar la accesibilidad, configuramos el objetivo táctil mínimo de la tarjeta en 48 dp. (Ieb9b1)
- Se agregó la tarjeta de aplicación con la demostración de imagen y se quitó la tarjeta de aplicación con la demostración de fondo (Id735f).
- Se corrigió un error en los botones redondos en el que los modificadores no se encadenaban correctamente. (I5e162).
Versión 1.0.0-alpha09
9 de agosto de 2023
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha09
. La versión 1.0.0-alpha09 contiene estas confirmaciones.
Nuevas funciones
- Se agregó
ToggleButton
para material3 (I6bed6).
Cambios en la API
- Activamos la anotación
FloatRange
como restricciones de la API , que se indicaban anteriormente en los comentarios. (Icb401). - Actualizamos la tipografía de Material3 para Wear para que cumpla con los lineamientos más recientes de Material3. (I1bad6).
Correcciones de errores
- Actualizamos los colores de
Button
,IconButton
yTextButton
de acuerdo con el diseño de Material3. (Ib2495). - Corrigimos la visibilidad de la marca de verificación de la casilla en los estados inhabilitados. (Ib25bf).
Versión 1.0.0-alpha08
26 de julio de 2023
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha08
. La versión 1.0.0-alpha08 contiene estas confirmaciones.
Nuevas funciones
- Agregamos los siguientes controles de selección para Material3:
Switch
,Checkbox
yRadioButton
. (Ib918c). - Agregamos
IconToggleButton
yTextToggleButton
a Material3, un botón de activación circular con una sola ranura para ícono y texto, respectivamente. Para diferentes tamaños deToggleButton
, te recomendamos que usesModifier.touchTargetAwareSize
con los tamaños proporcionados en los botones de activación correspondientes. (I9f015). - Agregamos
ListHeader
yListSubheader
a nuestros componentes de Material3. (Ibaefe). - Agregamos Material3
SwipeToDismissBox
, que llama al nuevoSwipeToDismissBox
de Foundation y proporciona valores de color predeterminados desde su tema. (I275fb). - Se agregó
InlineSlider
de Material3 a Wear Compose. Permite que los usuarios seleccionen un rango de valores. El rango de selecciones se muestra como una barra entre los valores mínimos y máximos del rango, desde el que los usuarios pueden seleccionar un solo valor.InlineSlider
es ideal para ajustar parámetros de configuración, como el volumen o el brillo. (I7085f).
Cambios en la API
- Se actualizó el tema Shapes en Material 3 para Wear para usar
RoundedCornerShape
en lugar de Shape. (Idb133). - Se hicieron públicas las constantes de altura para el botón (Idbfde).
- Se actualizaron los archivos de API para anotar la supresión de compatibilidad (I8e87a, b/287516207).
- Actualizamos
InlineSliderColors
en Wear Compose Material 3 para que tenga un constructor y propiedades públicas. (I6b632). - Actualizamos todas las clases de color en Wear Compose Material 3 para que tengan constructores y propiedades públicos. (I17702).
- Se hicieron públicas las constantes de padding horizontal y vertical de Button. (Ieeaf7).
Correcciones de errores
- El botón ahora ajustará su altura para adaptarse al contenido que aumentó debido a las fuentes grandes para la accesibilidad, cuando sea necesario (Iaf302).
- Actualizamos varias demostraciones de botones para abordar problemas de accesibilidad. (I61ce9)
Stepper
yInlineSlider
ahora admiten clics repetidos en la presión prolongada para que puedas aumentar o disminuir rápidamente el valor deStepper
yInlineSlider
manteniendo presionados los botones + o - (I27359).
Versión 1.0.0-alpha07
21 de junio de 2023
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha07
. La versión 1.0.0-alpha07 contiene estas confirmaciones.
Nuevas funciones
- Agregamos el componente
Stepper
a nuestra biblioteca de Material 3 de Compose para Wear OS. Esto es similar a la versión anterior de Material, pero omite la semántica de rango de forma predeterminada, según los comentarios de los desarrolladores. ProporcionamosModifier.rangeSemantics
en los casos en los que se requieren semánticas de rango. (Ic39fd) - Agregamos
curvedText
a nuestra biblioteca de Material 3 de Compose para Wear OS. (Ia8ae3).
Correcciones de errores
- Se actualizó
wear.compose.foundation
para que sea una dependencia de API dewear.compose.material3
(I72004, b/285404743).
Versión 1.0.0-alpha06
7 de junio de 2023
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha06
. La versión 1.0.0-alpha06 contiene estas confirmaciones.
Correcciones de errores
- Actualizamos
TextButton
para usar la función de extensióntoDisabledColor
para corregir los valores de alfa inhabilitados. (I814c8).
Versión 1.0.0-alpha05
24 de mayo de 2023
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha05
. La versión 1.0.0-alpha05 contiene estas confirmaciones.
Nuevas funciones
- Agregamos
TextButton
a Material3, un botón circular con una sola ranura para texto. Para diferentes tamaños deTextButton
, te recomendamos que usesModifier.touchTargetAwareSize
yExtraSmallButtonSize
,SmallButtonSize
,DefaultButtonSize
yLargeButtonSizeIcon
proporcionados enTextButtonDefaults
. ElTextButton
predeterminado no tiene borde ni fondo transparente para las acciones de énfasis bajo. Para las acciones que requieren un énfasis alto, usafilledTextButtonColors
; para un énfasis medio, usaTextButton
con contorno, establece el borde enButtonDefaults.outlinedButtonBorder
; para un término medio entre el contorno y el relleno, usafilledTonalTextButtonColors
. (I667e4) - Agregamos
Card
,OutlinedCard
,AppCard
yTitleCard
a la biblioteca de Material3 de Wear Compose.AppCard
yTitleCard
también pueden tener el aspecto de un contorno conCardDefaults.outlinedCardColors
yCardDefaults.outlinedCardBorder
(I80e72).
Cambios en la API
- Movemos el parámetro de etiqueta de botón al final para admitir la sintaxis de expresión lambda final y quitamos el parámetro de rol (ya que se puede anular con
Modifier.semantics
). Los constructores deButtonColors
ahora son públicos. (Ie1b6d).
Versión 1.0.0-alpha04
10 de mayo de 2023
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha04
. La versión 1.0.0-alpha04 contiene estas confirmaciones.
Nuevas funciones
- Agregamos
IconButton
a Material3, un botón circular con una sola ranura para ícono o imagen. Hay cuatro variaciones:IconButton
,FilledIconButton
,FilledTonalIconButton
yOutlinedIconButton
. Para diferentes tamaños deIconButton
, te recomendamos que usesModifier.touchTargetAwareSize
yExtraSmallButtonSize
,SmallButtonSize
,DefaultButtonSize
yLargeButtonSizeIcon
proporcionados enIconButtonDefaults
. También proporcionamosIconButtonDefaults.iconSizeFor
para determinar el tamaño de ícono recomendado para un tamaño de botón determinado. (I721d4)
Versión 1.0.0-alpha03
19 de abril de 2023
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha03
. La versión 1.0.0-alpha03 contiene estas confirmaciones.
Cambios en la API
- Agregamos el componente de botón de Material 3, que es nuestro botón con forma de estadio y antes se llamaba Chip en la biblioteca de Material de Wear Compose (se cambió el nombre a Botón para mantener la coherencia con la biblioteca de Material 3 de Compose). El botón predeterminado tiene un fondo relleno y hay variaciones de botones para
FilledTonal
(fondo atenuado), con contorno (transparente con un borde delgado) y secundario (fondo transparente y sin borde, que se usa para acciones complementarias con la menor cantidad de importancia). Los botones redondos para íconos simples y contenido de texto se agregarán en una versión futura.(Ia6942)
Versión 1.0.0-alpha02
5 de abril de 2023
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha02
. La versión 1.0.0-alpha02 contiene estas confirmaciones.
Correcciones de errores
- Se agregó un
DefaultTextStyle
a Wear Compose Material 3, que establecePlatformTextStyle.includeFontPadding
como verdadero de forma predeterminada (el parámetro de configuración actual). Esto nos permitirá sincronizar la desactivación del padding de fuente de forma predeterminada con las bibliotecas de Compose en el futuro (consulta Cómo corregir el padding de fuente en Compose para el fondo). (I7e461).
Versión 1.0.0-alpha01
22 de marzo de 2023
Lanzamiento de androidx.wear.compose:compose-material3:1.0.0-alpha01
. La versión 1.0.0-alpha01 contiene estas confirmaciones.
Nuevas funciones
Material 3 es la siguiente evolución de Material Design y, además, incluye temas actualizados y componentes rediseñados. Material 3 en Wear Compose está diseñado para ser cohesivo con la biblioteca de Material 3 Compose en Android. Esta primera versión alfa contiene implementaciones iniciales y funcionales de lo siguiente:
Seguiremos desarrollando Wear Material (
androidx.wear.compose:compose-material
) y Wear Material 3 (androidx.wear.compose:compose-material3
) en paralelo. Las próximas versiones de material3 extenderán el conjunto de widgets para incluir otros componentes conocidos de Compose para Wear OS, como botones, selectores y controles deslizantes.Las bibliotecas de Wear Material y Wear Material 3 son mutuamente excluyentes y no deben mezclarse en la misma app, principalmente porque hacen referencia a temas diferentes, lo que generaría inconsistencias inesperadas.