navigationevent

  
La biblioteca de eventos de navegación proporciona una API de KMP para controlar el gesto atrás del sistema y el gesto atrás predictivo.
Actualización más reciente Versión estable Versión potencial Versión beta Versión alfa
18 de junio de 2025 - - - 1.0.0-alpha03

Cómo declarar dependencias

Para agregar una dependencia en navigationevent, debes agregar el repositorio de Maven de Google a tu proyecto. 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.navigationevent:navigationevent:1.0.0-alpha03"
}

Kotlin

dependencies {
    implementation("androidx.navigationevent:navigationevent:1.0.0-alpha03")
}

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.

No hay notas de la versión para este artefacto.

Versión 1.0

Versión 1.0.0-alpha03

18 de junio de 2025

Lanzamiento de androidx.navigationevent:navigationevent-*:1.0.0-alpha03. La versión 1.0.0-alpha03 contiene estas confirmaciones.

Nuevas funciones

  • Se presentó un nuevo módulo navigationevent-compose para admitir funciones de Jetpack Compose en la biblioteca navigationevent. (980d78).
  • NavigationEvent Compose agregó una nueva composición local LocalNavigationEventDispatcherOwner. Muestra un valor anulable para determinar mejor si está disponible en la composición actual. NavigationEventHandler ahora mostrará un error si no se encuentra el propietario subyacente. (62ffda).
  • NavigationEvent Compose agregó un nuevo elemento componible NavigationEventHandler para controlar eventos (gesto atrás predictivo). Proporciona un Flow de objetos NavigationEvent que se deben recopilar en la lambda de suspensión que proporcionas c42ba6:
NavigationEventHandler { progress: Flow<NavigationEvent> ->
  // This block is executed when the back gesture begins.
  try {
    progress.collect { backEvent ->
      // Handle gesture progress updates here.
    }
    // This block is executed if the gesture completes successfully.
  } catch (e: CancellationException) {
    // This block is executed if the gesture is cancelled
    throw e
  } finally {
    // This block is executed either the gesture is completed or cancelled
  }
}

Cambios en la API

  • Cada NavigationEventCallback ahora se puede registrar con un solo NavigationEventDispatcher a la vez. Si se agrega a varios despachadores, se genera un IllegalStateException. Ten en cuenta que este comportamiento difiere de OnBackPressedDispatcher, que permite varios despachadores. (e82c19).
  • Se convirtió isPassThrough en val para evitar la mutación durante la navegación, lo que podría interrumpir el envío de NavigationEvent. (I0b287).

Versión 1.0.0-alpha02

4 de junio de 2025

Lanzamiento de androidx.navigationevent:navigationevent-*:1.0.0-alpha02. La versión 1.0.0-alpha02 contiene estas confirmaciones.

Cambios en la API

  • Reemplaza el constructor secundario de NavigationEventDispatcher por argumentos predeterminados. (I716a0).
  • Quita la propiedad de prioridad de NavigationEventCallback. En su lugar, pasa la prioridad a NavigationEventDispatcher.addCallback(). (I13cae).

Correcciones de errores

  • Se corrigió un ConcurrentModificationException que podía ocurrir cuando se llamaba a NavigationEventCallback.remove() debido a que se modificaba de forma simultánea la lista interna de elementos que se pueden cerrar. (b/420919815)

Versión 1.0.0-alpha01

20 de mayo de 2025

Lanzamiento de androidx.navigationevent:navigationevent-*:1.0.0-alpha01. La versión 1.0.0-alpha01 contiene estas confirmaciones.

Nuevas funciones

  • La biblioteca androidx.navigationevent proporciona una API de KMP en primer lugar para controlar el gesto atrás del sistema y el gesto atrás predictivo. NavigationEventDispatcher funciona como una API común para registrar una o más instancias de NavigationEventCallback para recibir eventos de Atrás del sistema.
  • Esta capa se encuentra debajo de las APIs publicadas anteriormente en androidx.activity y tiene como objetivo ser un reemplazo menos definido para usar las APIs de Activity en componentes de nivel superior o directamente las APIs de OnBackInvokedDispatcher del framework de Android. Las APIs de androidx.activity se volvieron a escribir sobre las APIs de eventos de Navigation como parte de Activity 1.12.0-alpha01.