Jetpack WindowManager 1.5 es estable

Nos complace anunciar que Jetpack WindowManager 1.5.0 ya es estable.

Esta versión se basa en la sólida base de adaptabilidad de WindowManager, lo que facilita aún más la creación de IU adaptables y refinadas que se ven geniales en todos los tamaños de pantalla. A medida que el ecosistema Android sigue creciendo, los usuarios interactúan con las apps en una variedad de dispositivos más amplia que nunca: desde teléfonos y dispositivos plegables hasta tablets, pantallas conectadas, Chromebooks y hasta pantallas de automóviles en modo de estacionamiento.

WindowManager 1.5 se enfoca en proporcionar mejores herramientas para este entorno de dispositivos diversos.

Novedades de WindowManager 1.5

Esta versión estable presenta nuevos puntos de interrupción para pantallas muy grandes, mejora la API de incorporación de actividades y proporciona más flexibilidad para calcular las métricas de las ventanas.

Nuevas clases de tamaño de ventana: grande y extragrande

La actualización más importante de la versión 1.5 es la incorporación de dos nuevas clases de tamaño de ventana de ancho: grande y extragrande.

Las clases de tamaño de ventana son nuestro conjunto oficial y bien definido de puntos de interrupción de viewports que te ayudan a diseñar y desarrollar diseños adaptables. Con la versión 1.5, extendemos esta orientación para pantallas que van más allá de las tablets típicas.

Estos son los nuevos puntos de interrupción de ancho:

• Grande: Para anchos entre 1,200 dp y 1,600 dp
• Extragrande: Para anchos ≥1,600 dp

Las diferentes clases de tamaño de ventana según el ancho de la pantalla 

¿Por qué son importantes?

A partir de Android 16 QPR1 Beta 2, Android admite pantallas conectadas, lo que permite a los usuarios conectar una pantalla externa a su dispositivo y transformarlo en una herramienta similar a una computadora con una pantalla grande.

Teléfono conectado a una pantalla externa, con una sesión de escritorio en la pantalla externa. 

Con esta nueva función disponible, es fundamental contar con orientación específica para incluir pantallas más grandes. 

En estas plataformas de gran tamaño, simplemente escalar el diseño expandido de una tablet no siempre es la mejor experiencia del usuario. Por ejemplo, un cliente de correo electrónico podría mostrar cómodamente dos paneles (un buzón de mensajes y un mensaje) en la clase de tamaño de ventana expandida. Sin embargo, en un monitor de escritorio extragrande, el cliente de correo electrónico podría mostrar de forma elegante tres o incluso cuatro paneles: tal vez un buzón de correo, una lista de mensajes, el contenido completo del mensaje y un panel de calendario o tareas, todo a la vez.

Con los puntos de interrupción oficiales para pantallas muy grandes, WindowManager 1.5 te brinda una señal clara para introducir diseños creados específicamente para una experiencia de escritorio productiva y con mucha información.

Las clases de tamaño de ventana se pueden calcular con computeWindowSizeClass(), que es una función de extensión de la biblioteca de androidx.window.core.layout que extiende el tipo Set<WindowSizeClass>. 

Para incluir las nuevas clases de tamaño de ventana en tu proyecto, simplemente llama a la función desde el conjunto WindowSizeClass.BREAKPOINTS_V2 en lugar de WindowSizeClass.BREAKPOINTS_V1:

val currentWindowMetrics =

    WindowMetricsCalculator.getOrCreate()

    .computeCurrentWindowMetrics(LocalContext.current)


val sizeClass = WindowSizeClass.BREAKPOINTS_V2

    .computeWindowSizeClass(currentWindowMetrics)

Luego, aplica el diseño correcto cuando tengas la certeza de que tu app tiene, al menos, esa cantidad de espacio:

if(sizeClass.isWidthAtLeastBreakpoint(

    WindowSizeClass.WIDTH_DP_LARGE_LOWER_BOUND)){

    ...

    // window is at least 1200 dp wide


}

Bibliotecas adaptables

La biblioteca adaptable de Compose Material 3 te ayuda a crear IU adaptables que se ajustan automáticamente según las configuraciones actuales de la ventana, como las clases de tamaño de ventana o las posturas del dispositivo. 

La buena noticia es que la biblioteca ya está actualizada con los nuevos puntos de interrupción. A partir de la versión 1.2 (ahora en la etapa de versión candidata), las funciones de directiva de scaffold de panel predeterminadas admiten clases de tamaño de ancho de ventana grande y extragrande.

Solo debes habilitar la función declarando en tu archivo de compilación de Gradle que quieres usar los nuevos puntos de interrupción:

currentWindowAdaptiveInfo(

    supportLargeAndXLargeWidth = true)

Mejoras adicionales

• Incorporación de actividades: Guardado y restablecimiento automáticos: WindowManager ahora puede guardar y restablecer automáticamente el estado de las divisiones de incorporación de actividades. Esto ayuda a preservar el diseño del usuario durante la recreación del proceso, lo que genera una experiencia más estable y coherente. Los desarrolladores ya no tienen que guardar y restablecer el estado de forma manual, sino que pueden habilitar la opción automática configurando la propiedad EmbeddingConfiguration#isAutoSaveEmbeddingState.
• WindowMetrics expandido: Ahora puedes calcular WindowMetrics desde un contexto de Application, no solo desde un contexto de Activity. Esto proporciona más flexibilidad para acceder a la información de la ventana desde diferentes partes de tu app.

Cómo comenzar

Para comenzar a usar las nuevas clases de tamaño grande y extragrande, y otras funciones de la versión 1.5 en tus proyectos de Android, actualiza las dependencias de tu app en build.gradle.kts a la versión estable más reciente:

dependencies {
    implementation("androidx.window:window:1.5.0") 

    // or, if you're using the WindowManager testing library:

    testImplementation("androidx.window:window-testing:1.5.0")

}

WindowManager 1.5 es otro paso adelante para crear apps completamente adaptables que se ejecuten en todos los factores de forma de Android. Consulta las notas de la versión oficiales para obtener una lista completa de los cambios y las correcciones de errores.

¡Suerte con la programación!