Navegación 3

Navigation 3 es una biblioteca de navegación diseñada para funcionar con Compose. Con Navigation 3, tienes control total sobre la pila de actividades y puedes navegar entre destinos agregando y quitando 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, lo que permite cambiar sin problemas entre esos diseños
  • Mecanismo para que el contenido se comunique con su diseño de nivel superior (metadatos)
  • Comunicación entre destinos para devolver resultados entre pantallas

En un nivel alto, puedes implementar Navigation 3 de las siguientes maneras:

  1. 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.
  2. 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.
  3. Usa un NavDisplay para 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 el historial de la pila de actividades.
  4. Modifica las estrategias de escena de NavDisplay según sea necesario para admitir diseños adaptables y diferentes plataformas.
  5. Admite vínculos directos para navegar directamente a los destinos.

Puedes ver el código fuente completo de Navigation 3 en AOSP.

Mejoras en Jetpack Navigation

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 de la pila de actividades 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 y las opciones de diseño de la API de Navigation 3 en la entrada de blog del anuncio.

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.