Navigation 3 es una nueva biblioteca de navegación diseñada para funcionar con Compose. Con Navigation 3, tienes control total sobre la pila de actividades, y navegar hacia y desde los destinos es tan simple como agregar y quitar elementos de una lista. Crea un sistema de navegación flexible para la app, ya que proporciona lo siguiente:
- Convenciones para modelar una pila de actividades, en la que cada entrada de la pila representa el contenido al que navegó el usuario
- Una IU que se actualiza automáticamente con los cambios en la pila de actividades (incluidas las animaciones)
- Es un alcance para los elementos de la pila de actividades que permite conservar el estado mientras un elemento está en la pila de actividades.
- Un sistema de diseño adaptable que permite mostrar varios destinos al mismo tiempo y alternar entre esos diseños sin problemas
- Un mecanismo para que el contenido se comunique con su diseño principal (metadatos)
En un nivel alto, puedes implementar Navigation 3 de las siguientes maneras:
- Define el contenido al que los usuarios pueden navegar en tu app, cada uno con una clave única, y agrega una función para resolver esa clave en el contenido. Consulta Cómo resolver claves en contenido.
- Crea una pila de actividades en la que se insertan y quitan claves a medida que los usuarios navegan por tu app. Consulta Cómo crear una pila de actividades.
- Usa un
NavDisplaypara mostrar la pila de actividades de tu app. Cada vez que cambia la pila de actividades anterior, se actualiza la IU para mostrar contenido pertinente. Consulta Cómo mostrar la pila de actividades anterior. - Modifica las estrategias de escena de
NavDisplaysegún sea necesario para admitir diseños adaptables y diferentes plataformas.
Puedes ver el código fuente completo de Navigation 3 en AOSP.
Mejoras en Navigation de Jetpack
Navigation 3 mejora la API original de Jetpack Navigation de las siguientes maneras:
- Proporciona una integración más simple con Compose
- Te ofrece control total de la pila de actividades
- Permite crear diseños que pueden leer más de un destino desde la pila de historial al mismo tiempo, lo que les permite adaptarse a los cambios en el tamaño de la ventana y otras entradas.
Obtén más información sobre los principios de Navigation 3 y las opciones de diseño de la API en esta entrada de blog.
Muestras de código
El repositorio de recetas contiene ejemplos de cómo usar los componentes básicos de Navigation 3 para resolver desafíos de navegación comunes.