Se usó la API de Cloud Translation para traducir esta página.

Compose material3 adaptable

Referencia de la API
androidx.compose.material3.adaptive

Cómo usar la biblioteca adaptable de Material 3 para crear IU adaptables que se adaptarán automáticamente según la ventana actual como las clases de tamaño de ventana o las posiciones del dispositivo. La biblioteca proporciona Tanto las implementaciones de Scaffold predeterminadas como los elementos componibles necesarios que admiten composición para crear tus propias experiencias personalizadas.

Actualización más reciente	Versión estable	Versión potencial	Versión beta	Versión alfa
4 de septiembre de 2024	1.0.0	-	-	1.1.0-alpha02

Cómo declarar dependencias

Para agregar una dependencia en Compose, debes agregar el repositorio de Maven de Google a tu en un proyecto final. 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.compose.material3.adaptive:adaptive:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-layout:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-navigation:1.1.0-alpha02"
}

Kotlin

dependencies {
    implementation("androidx.compose.material3.adaptive:adaptive:1.1.0-alpha02")
    implementation "androidx.compose.material3.adaptive:adaptive-layout:1.1.0-alpha02"
    implementation "androidx.compose.material3.adaptive:adaptive-navigation:1.1.0-alpha02"
}

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.

Crear un error nuevo

Consulta la documentación sobre la Herramienta de seguimiento de errores para obtener más información.

Compose Material 3 adaptable versión 1.1

Versión 1.1.0-alpha02

4 de septiembre de 2024

Lanzamiento de androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha02. La versión 1.1.0-alpha02 contiene estas confirmaciones.

Nuevas funciones

Se admite la personalización del movimiento (I0bf9c) (I80e66) para que los creadores cambien los movimientos predeterminados durante los cambios de estado del andamiaje adaptable. Los creadores pueden elegir entre un conjunto de transiciones predeterminadas de entrada y salida, o implementar transiciones personalizadas únicamente con la información proporcionada a través de los nuevos alcances de movimiento.
Se implementó la animación de atenuación de los controladores de arrastre de expansión del panel. (46e3c69)
Se puede guardar PaneExpansionState recordado (61ff76f)

Cambios en la API

Se agregaron las APIs de expansión de paneles que faltan a Scaffold. (Ic5bc0)
Se cambió el nombre de ThreePaneScaffoldDestinationItem.content por contentKey. Los argumentos de tipo predeterminado rememberListDetailPaneScaffoldNavigator y rememberSupportingPaneScaffoldNavigator cambiaron de Nothing a Any. (I58749).
Marca ThreePaneScaffoldState como estable (I64aec).
Se estableció el alcance de los parámetros del controlador de arrastre. (Ic0aa2)

Versión 1.1.0-alpha01

21 de agosto de 2024

Lanzamiento de androidx.compose.material3.adaptive:adaptive-*:1.1.0-alpha01. La versión 1.1.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

Se introdujo la compatibilidad de expansión de paneles con andamiaje adaptable.

Cambios en la API

Se agregaron las APIs de expansión de paneles al público. (I301d6)
Se agregó ThreePaneScaffoldState para controlar las transiciones de valores del panel Se agregaron sobrecargas de ListDetailPaneScaffold y SupportingPaneScaffold, que aceptan este estado. (I5db3b).
Se introdujeron la clave de expansión de panel y la interfaz del proveedor de claves. (Id621f)

Correcciones de errores

Se corrigió el cálculo de partición incorrecto cuando se presenta la bisagra excluida. (9dfd483).

Compose Material 3 adaptable versión 1.0

Versión 1.0.0

4 de septiembre de 2024

Lanzamiento de androidx.compose.material3.adaptive:adaptive-*:1.0.0. La versión 1.0.0 contiene estas confirmaciones.

Funciones principales de la versión 1.0.0

Funciones de componibilidad de una sola línea currentWindowSize(), collectFoldingFeaturesAsState() y currentWindowAdaptiveInfo() para obtener la información requerida de las ventanas y adaptarlas a las apps, como los tamaños de las ventanas y las funciones de plegado
ListDetailPaneScaffold y SupportingPaneScaffold para proporcionar dos diseños canónicos de Material3 que se adaptarán automáticamente según las diferentes configuraciones de las ventanas. Esos dos andamiaje también se pueden personalizar por completo para adaptarse a las diferentes necesidades de los fabricantes.
ThreePaneScaffoldNavigator y sus funciones de recordatorio relevantes, rememberListDetailPaneScaffoldNavigator() y rememberSupportingPaneScaffoldNavigator(), para proporcionar soluciones de navegación dentro de un andamiaje adaptable, que puede mostrar varios destinos de navegación al mismo tiempo, en comparación con la configuración común de un destino a la vez en el mundo no adaptable.
Animaciones predeterminadas de Material 3 integradas cuando se cambian los estados del andamiaje adaptable

Versión 1.0.0-rc01

21 de agosto de 2024

Lanzamiento de androidx.compose.material3.adaptive:adaptive-*:1.0.0-rc01. La versión 1.0.0-rc01 contiene estas confirmaciones.

Correcciones de errores

Se corrigió el cálculo de partición incorrecto cuando se presenta la bisagra excluida. (9dfd483).

Versión 1.0.0-beta04

26 de junio de 2024

Lanzamiento de androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta04. La versión 1.0.0-beta04 contiene estas confirmaciones.

Correcciones de errores

Se corrigió el problema de que, cuando se actualizan los límites de la bisagra, el diseño no se actualiza en consecuencia. (71e9cf1).

Versión 1.0.0-beta03

12 de junio de 2024

Lanzamiento de androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta03. La versión 1.0.0-beta03 contiene estas confirmaciones.

Correcciones de errores

Corrige las fallas causadas por una resolución de dependencia incorrecta en la versión beta02.

Versión 1.0.0-beta02

29 de mayo de 2024

Lanzamiento de androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta02. La versión 1.0.0-beta02 contiene estas confirmaciones.

Versión 1.0.0-beta01

14 de mayo de 2024

Lanzamiento de androidx.compose.material3.adaptive:adaptive-*:1.0.0-beta01. La versión 1.0.0-beta01 contiene estas confirmaciones.

Versión 1.0.0-alpha12

1 de mayo de 2024

Lanzamiento de androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha12. La versión 1.0.0-alpha12 contiene estas confirmaciones.

Cambios en la API

Se agregó información de isFlat a HingeInfo. (Ie0516, b/333784198)
Se hicieron no experimentales las APIs adaptables. (I1d038)
Se hicieron no experimentales las APIs de diseño adaptable. (Id23df)
Se cambió BackNavigationBehavior de una enumeración a una clase de valor. (Id8757)

Correcciones de errores

Cambia la fracción de transición a una lambda. (I6f5a9)
Se corrigió el problema de estado inicial de SizeTracker (18326a9).
Se incluye una lista de bisagras en la verificación de igualdad de Posture (6687137).

Versión 1.0.0-alpha11

17 de abril de 2024

Lanzamiento de androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha11. La versión 1.0.0-alpha11 contiene estas confirmaciones.

Cambios en la API

Haz que las interfaces del alcance estén selladas. (Iefa57).
Presenta AnimatedPaneScope. (I62d73, b/332750742).
Haz que AdaptStrategy esté sellada y estable. (Ia28b2).
Presenta un método de copia de PaneScaffoldDirective. (I9291f).
Marca ThreePaneScaffoldScope como experimental. (I9d527).
Proporciona APIs de andamiaje fáciles de usar que admitan la navegación. (I263f0, b/321010778).

Versión 1.0.0-alpha10

3 de abril de 2024

Lanzamiento de androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha10. La versión 1.0.0-alpha10 contiene estas confirmaciones.

Cambios en la API

Haz que el ancho preferido predeterminado sea adaptable y personalizable. (Ic3abc).
Cambia el nombre de las funciones de cálculo de directivas de andamiaje. (I10855).
Quita los paddings y las inserciones de las APIs de Scaffold. (I786f8).
Agrega métodos de recordatorio del navegador sin tipos genéricos. (I607c3).

Versión 1.0.0-alpha09

20 de marzo de 2024

Lanzamiento de androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha09. La versión 1.0.0-alpha09 contiene estas confirmaciones.

Cambios en la API

Agrega campos de transición de estado a ThreePaneScaffoldScope. (I3d917).
Reordena los parámetros de Scaffold. (I4dff5).
Proporciona el valor predeterminado del parámetro modificador AnimatedPane. (I77dd7).

Correcciones de errores

Incluye el tamaño del separador en los movimientos del panel. (a3174ca).

Versión 1.0.0-alpha08

6 de marzo de 2024

Lanzamiento de androidx.compose.material3.adaptive:adaptive-*:1.0.0-alpha08. La versión 1.0.0-alpha08 contiene estas confirmaciones.

Nuevas funciones

Implementa el deslizamiento retrasado cuando se cambia de paneles. (I1a38e).

Cambios en la API

Se quitó la interfaz ThreePaneScaffoldState. (I63f23).

Versión 1.0.0-alpha07

21 de febrero de 2024