La navegación se refiere a las interacciones que permiten a los usuarios navegar a través de las diferentes piezas de contenido de tu app, y dentro y fuera ellas.
El componente Navigation de Android Jetpack incluye la biblioteca de Navigation, el complemento Safe Args de Gradle y las herramientas para ayudarte a implementar la navegación en apps. El componente Navigation controla diversos casos de uso de navegación, desde clics simples en botones hasta patrones más complejos, como las barras de la aplicación y el panel lateral de navegación.
Conceptos clave
En la siguiente tabla, se proporciona una descripción general de los conceptos clave de la navegación y los tipos principales que usas para implementarlos.
Concepto |
Propósito |
Tipo |
---|---|---|
Host |
Un elemento de la IU que contiene el destino de navegación actual. Es decir, cuando un usuario navega por una app, esta esencialmente intercambia destinos dentro y fuera del host de navegación. |
|
Gráfico |
Es una estructura de datos que define todos los destinos de navegación dentro de la app y cómo se conectan entre sí. |
|
Controlador |
Es el coordinador central para administrar la navegación entre destinos. El controlador ofrece métodos para navegar entre destinos, controlar vínculos directos, administrar la pila de actividades y mucho más. |
|
Destino |
Nodo en el gráfico de navegación. Cuando el usuario navega a este nodo, el host muestra su contenido. |
Por lo general, se crea al construir el gráfico de navegación. |
Ruta |
Identifica de manera inequívoca un destino y los datos que requiere. Puedes navegar por las rutas. Las rutas te llevan a destinos. |
Cualquier tipo de datos serializables. |
Beneficios y funciones
El componente Navigation ofrece algunos otros beneficios y funciones, entre los que se incluyen los siguientes:
- Animaciones y transiciones: Proporciona recursos estandarizados para animaciones y transiciones
- Vínculos directos: Implementa y controla vínculos directos que llevan al usuario directamente a un destino
- Patrones de la IU: Admite patrones como los paneles laterales de navegación y la navegación inferior con un mínimo trabajo adicional
- Seguridad de tipos: Incluye compatibilidad para pasar datos entre destinos con seguridad de tipos.
- Compatibilidad con ViewModel: Permite definir el alcance de un elemento
ViewModel
en relación con un gráfico de navegación para compartir datos relacionados con la IU entre los destinos del gráfico - Transacciones de fragmentos: Admite y controla por completo transacciones de fragmentos
- Acciones hacia atrás y arriba: Controla correctamente las acciones hacia atrás y arriba de forma predeterminada
Cómo configurar tu entorno
Para incluir compatibilidad con Navigation en tu proyecto, agrega las siguientes dependencias al archivo build.gradle
de tu app:
Groovy
dependencies { def nav_version = "2.8.0" // Jetpack Compose Integration implementation "androidx.navigation:navigation-compose:$nav_version" // Views/Fragments Integration implementation "androidx.navigation:navigation-fragment:$nav_version" implementation "androidx.navigation:navigation-ui:$nav_version" // Feature module support for Fragments implementation "androidx.navigation:navigation-dynamic-features-fragment:$nav_version" // Testing Navigation androidTestImplementation "androidx.navigation:navigation-testing:$nav_version" }
Kotlin
dependencies { val nav_version = "2.8.0" // Jetpack Compose integration implementation("androidx.navigation:navigation-compose:$nav_version") // Views/Fragments integration implementation("androidx.navigation:navigation-fragment:$nav_version") implementation("androidx.navigation:navigation-ui:$nav_version") // Feature module support for Fragments implementation("androidx.navigation:navigation-dynamic-features-fragment:$nav_version") // Testing Navigation androidTestImplementation("androidx.navigation:navigation-testing:$nav_version") }
Si quieres obtener información sobre cómo agregar otros componentes de la arquitectura a tu proyecto, consulta Cómo agregar componentes a tu proyecto.
Próximos pasos
Para consultar más documentación y recursos relacionados con el componente Navigation, accede a los siguientes recursos.
Guías detalladas
Para obtener más información sobre cómo implementar un host de navegación y NavController
, además de detalles sobre cómo interactúan con Compose y otros frameworks de IU, consulta las siguientes guías:
- Cómo crear un controlador de navegación: describe cómo crear un
NavController
- Cómo crear tu gráfico de navegación: detalla cómo crear un host de navegación y un gráfico de navegación
- Cómo navegar a un destino: muestra cómo usar un
NavController
para desplazarte entre los destinos del gráfico
Codelabs
- Componente Navigation de Jetpack
- Los fragmentos y el componente de Navigation
- Cómo compilar una app adaptable con navegación dinámica
Videos
- Cómo navegar con Navigation
- 10 prácticas recomendadas para pasar a una sola actividad
- Actividad única: Por qué, cuándo y cómo (Android Dev Summit 2018)
- Android Jetpack: cómo administrar la navegación de la IU con el controlador de Navigation (Google I/O 2018)