navigationevent

  
La biblioteca de Navigation Event proporciona una API que prioriza KMP para controlar el botón Atrás del sistema y el Atrás predictivo.
Actualización más reciente Versión estable Versión potencial Versión beta Versión alfa
8 de octubre de 2025 - - 1.0.0-beta01 -

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-beta01"
}

Kotlin

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

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-beta01

8 de octubre de 2025

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

Cambios en la API

  • Corrige la anotación FloatRange para NavigationEvent.touchX y NavigationEvent.touchY. Estos valores representan coordenadas de píxeles absolutas y no tienen un límite superior de 1.0. (I4b205, b/445989313)
  • Refactoriza el elemento NavigationEventDispatcherOwner componible a rememberNavigationEventDispatcherOwner. Ahora, la función devuelve el NavigationEventDispatcherOwner directamente. Para proporcionar este propietario a una subcomposición, usa CompositionLocalProvider. (I874b2, b/444446629)

Versión 1.0.0-alpha09

24 de septiembre de 2025

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

Cambios en la API

  • Usa el objeto singleton NavigationEventTransitionState.Idle directamente en lugar de crear una instancia de Idle(). (Ic7d9e, b/444734264)
  • Haz que los constructores de conveniencia sean internos; obtén instancias a través de NavigationEventDispatcher.history público en lugar de la construcción directa. (I3b7e0, b/444734264)
  • Se requiere crear NavigationEventState a través de rememberNavigationEventState; el constructor ahora es interno. (Ie143c, b/444734264)
  • Adopta onBackCompletedFallback y reemplaza los usos de fallbackOnBackPressed y el parámetro del constructor. El comportamiento no cambia; solo se invoca en eventos de atrás completados y no controlados. (Idabe9, b/444734264)
  • El constructor principal de NavigationEventHistory(mergedHistory, currentIndex) ahora es internal. Los consumidores externos deben usar los constructores públicos (el constructor vacío o el constructor basado en particiones) para crear instancias. (I1c047, b/444734264)
  • Se hizo que View.setViewTreeNavigationEventDispatcherOwner acepte un propietario anulable (Ic9eb6, b/444436762).
  • NavigationEventInfo ahora es un abstract class en lugar de un interface. Actualiza todas las implementaciones personalizadas para que hereden de la clase (p. ej., data class MyInfo : NavigationEventInfo()). (I1e59c, b/444734264)
  • Se quitaron la propiedad NavigationEventDispatcher.state y la función getState<T>() heredadas. Usa los nuevos flujos separados dispatcher.transitionState (para el progreso del gesto) y dispatcher.history (para la pila de navegación). (Ic2ceb, b/444734264)
  • Se reemplaza la devolución de llamada NavigationEventInput.onInfoChanged(...). Implementa la nueva devolución de llamada onHistoryChanged(history: NavigationEventHistory) para recibir actualizaciones como un solo objeto NavigationEventHistory. (I23e0b, b/444734264)
  • Se introduce un nuevo NavigationEventDispatcher.history global StateFlow. Este flujo no genérico permite que los observadores se suscriban solo a los cambios en la pila de navegación y se mantiene estable durante el progreso del gesto. Es la contraparte de transitionState. (I1db10, b/444734264)
  • Se introduce un nuevo NavigationEventDispatcher.transitionState global StateFlow. Este flujo no genérico permite que los observadores se suscriban solo al estado del gesto físico (Idle/InProgress), independientemente del historial. (I171fa, b/444734264)
  • Presenta la clase NavigationEventHistoryState. Esta será la API principal para observar el historial de información de navegación, independientemente del estado de los gestos. (I81ca5, b/444734264)
  • NavigationEvent ahora está marcado como @Immutable, lo que permite que el compilador de Compose optimice las recomposiciones. (If78c7, b/444734264)
  • Se actualizaron las APIs del controlador navigationevent-compose. NavigationEventHandler y NavigationBackHandler (y sus variantes) ahora admiten una nueva sobrecarga que acepta NavigationEventStates elevadas. Las sobrecargas simples (que toman currentInfo) se conservan y ahora usan este nuevo modelo de estado de forma interna. (Ic3251, b/444734264)
  • Agrega el nuevo @Stable NavigationEventState<T> titular del estado a la biblioteca navigationevent-compose. Este objeto combina el historial local con el estado del gesto local y será el vínculo principal entre rememberNavigationEventState y NavigationEventHandler. (Ifb69f, b/444734264)
  • Agrega una nueva propiedad transitionState: TransitionState pública y de solo lectura a NavigationEventHandler. Los controladores ahora mantienen su propio estado de transición, que los sistemas externos pueden observar. (I9acd2, b/444734264)
  • Se presenta la nueva clase sellada TransitionState. Esta será la API principal para observar el estado de los gestos, independientemente del historial de navegación. (Id4beb, b/444734264)
  • Expón currentInfo, backInfo y forwardInfo como propiedades públicas de solo lectura en NavigationEventHandler. (Ia7636, b/444734264)
  • Las implementaciones de NavigationEventHandler ahora deben proporcionar un valor initialInfo: T al constructor base. (Idcfea, b/444734264)
  • Reemplaza OnBackInvokedInput por OnBackInvokedOverlayInput o OnBackInvokedDefaultInput. (I5323f, b/428948766)
  • Marcar NavigationEventState como @Immutable Esto mejora el rendimiento de Compose, ya que garantiza que los elementos componibles que observan este estado puedan omitir correctamente la recomposición. (I399c8)
  • Cambia el nombre de NavigationEventInfo.NotProvided a NavigationEventInfo.None; y actualiza las referencias. No hay cambios de comportamiento. (I5e2d4)
  • NavigationEventInfo ahora está marcado como @Immutable, lo que permite que el compilador de Compose optimice las recomposiciones. (I7c112)
  • Mejora la ergonomía de Java con una interfaz divertida para la resiliencia de la finalización hacia atrás. (I8a860)
  • Se cambió el nombre de onHasEnabledHandlerChanged por onHasEnabledHandlersChanged. Esto aclara que la devolución de llamada informa sobre el estado de habilitación colectivo de todos los controladores, no solo de uno. (I1af61, b/443711297)
  • Quita hasEnabledHandler() de NavigationEventDispatcher; y usa NavigationEventInput.onHasEnabledHandlersChanged en su lugar. (Idef72, b/443711297)
  • Agrega la devolución de llamada onInfoChanged a NavigationEventInput para notificar a los objetos de escucha sobre los cambios en el historial de navegación. Esto proporciona el contexto completo de las pilas actual, anterior y siguiente, lo que permite que las entradas reaccionen a la información contextual. (I69a8b, b/443282983)
  • Haz que el swipeEdge de NavigationEvent sea un @IntDef (Icee54, b/443950342)
  • Agrega un parámetro priority a NavigationEventDispatcher.addInput para definir el alcance de un dispatcher en una prioridad. Los eventos como onHasEnabledCallbacksChanged ahora se activan solo cuando cambian las devoluciones de llamada en esa prioridad. (I3e488, b/443711297)
  • Se cambió el nombre del parámetro NavigationEventDispatcher de parentDispatcher a parent para mayor claridad. (Id4f1f, b/443801782)
  • Se quitó NavigationEventPriority y se agregó @IntDef para los usuarios de Java (I10a9f, b/440514265).
  • Aplica el contrato del controlador de navegación. Si tu NavigationEventHandler establece isBackEnabled o isForwardEnabled en true, ahora debes anular onBackCompleted o onForwardCompleted, respectivamente. Las implementaciones predeterminadas ahora generan una excepción para evitar errores silenciosos. (I17c62)
  • Se aplican valores de prioridad válidos cuando se agregan controladores de eventos de navegación. Llamar a addHandler con una prioridad no admitida ahora arrojará una IllegalArgumentException, lo que proporcionará comentarios inmediatos sobre el uso incorrecto en todas las plataformas de destino. (I3c474)

Correcciones de errores

  • Haz que addHandler sea idempotente y que ignore los registros duplicados. (I052aa, b/444734264)
  • Mantén las propiedades NavigationEventState sincronizadas durante la recomposición. (Ib3b4d, b/444734264)
  • Asegúrate de que NavigationEventInputs reciba la información contextual actual (actual, atrás, adelante) inmediatamente después del registro. (Ie65bf, b/443282983)

Versión 1.0.0-alpha08

10 de septiembre de 2025

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

Nuevas funciones

  • Se introduce una API de NavigationEventHandler basada en lambda que reemplaza el controlador basado en Flow. Controla los gestos hacia atrás y hacia adelante con devoluciones de llamada simples en lugar de recopilar flujos, lo que reduce el código estándar y evita problemas de cancelación. Proporciona NavigationBackHandler y NavigationForwardHandler como APIs de conveniencia segmentadas. Quita el NavigationEventHandler basado en Flow y migra a las nuevas devoluciones de llamada. (I23bac, b/436248277)
  • Permite que los usuarios pasivos accedan a la pila de navegación hacia atrás completa a través de la información combinada de atrás. Habilita las IU para renderizar vistas previas y el historial de navegación anidado en lugar de limitarse a la devolución de llamada superior. (I7a510, b/436248277)
  • Se introduce un modelo explícito de atrás/actual/adelante para aclarar el estado de navegación y admitir la navegación hacia adelante con controladores anidados. (Ib86da, b/420443609)
  • Agrega los métodos onForward* y isForwardEnabled a NavigationEventCallback. (Ic100f, b/436248290)
  • Agrega compatibilidad con la navegación hacia adelante a NavigationEventInput. (I5734b)

Cambios en la API

  • Habilita las pruebas de eventos de navegación hacia adelante con TestNavigationEventCallback. Usa los hooks isForwardEnabled y onForward*. (I21fb5, b/420443609)
  • Se cambió el nombre de las devoluciones de llamada de onEvent* a onBack* en NavEvent. (I228b3, b/436248290)
  • Convierte SwipeEdge en una clase intercalada. (Id5e01)
  • Haz que la biblioteca navigationevent sea interoperable con Java. Ahora se puede acceder a todas las APIs públicas desde el código Java, lo que permite una integración perfecta en proyectos de varios lenguajes o solo en Java. (Ibc944,I5465f, I9fb1e, b/440532890b/443040294)
  • Se aclararon los roles de la API cambiando el nombre de NavigationEventCallback a NavigationEventHandler. Este cambio refleja mejor el propósito de la clase de controlar los gestos de navegación en varias etapas. El método addCallback correspondiente ahora es addHandler. (I2492a, b/443040331)

Correcciones de errores

  • Evita que la resiliencia de atrás se ejecute en la navegación hacia adelante. (I74814, b/436248290)
  • Se agregó compatibilidad con la navegación hacia adelante predictiva. Las APIs de NavigationEvent ahora controlan los gestos hacia atrás y hacia adelante, lo que permite animaciones coherentes para ambas direcciones de navegación. (Idc98c, b/436248290)
  • Se evita una falla de IllegalStateException durante la recomposición cuando se quita un elemento NavigationEventDispatcherOwner secundario. (Iff50c, b/412629020)
  • Los usuarios pasivos ahora pueden acceder a la pila de navegación completa a través de la información de atrás combinada, lo que permite que las IU rendericen vistas previas y el historial de navegación anidado en lugar de limitarse a la devolución de llamada superior. (I7a510, b/436248277)

Versión 1.0.0-alpha07

27 de agosto de 2025

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

Cambios en la API

  • Se quita NavigationEventDispatcher.onHasEnabledCallbacksChanged. (I50e97)
  • Haz que NavigationEventCallback.onEventCompleted() sea abstracto. (I36b38)
  • Se cambiaron los métodos NavigationEventCallback#on* a protected. Actualiza el código de llamada para anularlos. (I6b691)
  • Se cambió el nombre de las funciones DirectNavigationEventInput. (Iffb62)
  • Se cambió el nombre de NavigationEventInput.onAttach por onAdded. (I2d0b8)
  • Se cambió el nombre de NavigationEventInput.onDetach por onRemoved. (I2d0b8)
  • Se cambió el nombre de NavigationEventInputHandler por NavigationEventInput. (I676a4)
  • Se agregó @EmptySuper a NavigationEventInput.onHasEnabledCallbacksChanged. (If9853)
  • Implementa onAttach en NavigationEventInputHandler. (I03648)
  • Implementa onDetach en NavigationEventInputHandler. (I03648)
  • NavigationEventCallback predeterminado habilitado tras la creación (Ic0188)
  • Reemplaza NavigationEventInput.addOnHasEnabledCallbacksChangedCallback con NavigationEventInput.onHasEnabledCallbacksChanged. (I64e93)
  • Requiere el subproceso principal para NavigationEventDispatcher.addInput. (Ic2930)
  • Requiere el subproceso principal para NavigationEventDispatcher.removeInput. (Ic2930)
  • Se quita Dispatcher.addOnHasEnabledCallbacksChangedCallback. Se reemplazó con Dispatcher.onHasEnabledCallbacksChanged (Ida3e3, b/436530096)

Correcciones de errores

  • Se corrigió un error por el que agregar un controlador ya adjunto o quitar uno no adjunto activaba una lógica de ciclo de vida incorrecta. (I9e47b)

Versión 1.0.0-alpha06

13 de agosto de 2025

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

Nuevas funciones

API de Passive Listeners

Ahora puedes pasar información contextual personalizada desde cualquier host de navegación y escuchar de forma pasiva los cambios de estado de los gestos desde cualquier lugar de la IU. Esto habilita animaciones contextuales para el gesto atrás predictivo y otros tipos de navegación controlada por gestos.

Esta función tiene dos partes:

  1. Providing Info: Usa NavigationEventInfo para transportar datos personalizados.
  2. Estado de consumo: Usa dispatcher.state (NavigationEventState) para observar el progreso y el contexto del gesto.
  • NavigationEventCallback ahora expone el método setInfo(currentInfo, previousInfo) para establecer el contexto de gestos en una sola llamada (I1d5e7, b/424470518).
  • NavigationEventHandler agrega una nueva sobrecarga que acepta currentInfo y previousInfo, lo que la convierte en la API principal para proporcionar contexto en las apps de Compose (I6ecd3, b/424470518).

Ejemplo:

  data class MyScreenInfo(val screenName: String) : NavigationEventInfo

  NavigationEventHandler(
      enabled = true,
      currentInfo = MyScreenInfo("Details Screen"),
      previousInfo = MyScreenInfo("Home Screen")
  ) { /* Handle back completion */ }
  • NavigationEventDispatcher ahora expone dispatcher.state y dispatcher.getState<T>() (If7fae, Ia90ca, b/424470518). Estas APIs basadas en StateFlow permiten que cualquier IU observe el progreso del gesto y los datos contextuales sin controlar el evento directamente.

Ejemplo:

  val gestureState by LocalNavigationEventDispatcherOwner.current!!
      .navigationEventDispatcher
      .state
      .collectAsState()

  val progress = gestureState.progress // Returns latestEvent.progress or 0F

  when (val state = gestureState) {
      is InProgress -> {
          val toScreen = state.currentInfo as MyScreenInfo
          val fromScreen = state.previousInfo as MyScreenInfo
          println("Navigating from ${fromScreen.screenName} to ${toScreen.screenName}")
      }
      is Idle -> { /* Idle state */ }
  }

  • Agrega la propiedad progress a NavigationEventState (I7b196) que devuelve latestEvent.progress cuando está en curso o 0F en otros casos:

    val progress = state.progress

  • Se agregó el elemento NavigationEventDispatcherOwner componible para crear, vincular y desechar instancias de NavigationEventDispatcher de forma jerárquica. Permite el control dinámico del estado habilitado del despachador y la limpieza automática.

    @Composable
fun Sample() {
    NavigationEventDispatcherOwner(enabled = true) {
        val localDispatcherOwner = LocalNavigationEventDispatcherOwner.current
    }
}

Cambios en la API

  • Se quitó el parámetro isPassthrough de NavigationEventCallback. (I99028, b/424470518)
  • Ahora, los constructores de NavigationEventState son internos. Para realizar pruebas, actualiza el estado (el valor predeterminado es Idle) a través de DirectNavigationEventInputHandler. Llama a handleOnStarted o handleOnProgressed para establecer el estado en InProgress, y a handleOnCompleted o handleOnCancelled para volver a Idle. Para actualizar NavigationEventInfo, usa NavigationEventCallback.setInfo. (I93dca, b/424470518)
  • Se agregaron parámetros predeterminados a NavigationEvent para permitir una instanciación más sencilla y simplificar las pruebas que se deben usar en lugar de TestNavigationEvent. (I5dc49, I232f4)
  • Se agregó un TestNavigationEventCallback para probar eventos de navegación con estados actuales o anteriores específicos. (Idd22e, b/424470518)
  • NavigationEventInputHandler se convirtió en una clase abstracta para reemplazar el AbstractNavigationEventInputHandler anterior por una implementación en DirectNavigationEventInputHandler (Iadde5, Ifed40I3897c, b/432616296, b/435416924).
  • Se cambió el nombre de los prefijos de las funciones send* en NavigationEventInputHandler por handle*. (Iffcaf)
  • Ahora, OnBackInvokedInputHandler extiende el nuevo abstract NavigationInputHandler. (Ib45aa)
  • Se cambió NavigationEventDispatcherOwner para que requiera un distribuidor principal en el que debes pasar null de forma explícita para crear un distribuidor raíz. (Ia6f64, b/431534103)

Correcciones de errores

  • Se mejoró la eficiencia evitando copias de recopilación en NavigationEventDispatcher.dispose(). (I4ab09)
  • Se corrigió un problema por el que NavigationEventHandler no respondía correctamente a los cambios en su estado habilitado. (Ia5268,I19bec, I5be5c, b/431534103)

Actualizaciones de la documentación

  • Se expandieron los KDocs para NavigationEvent para aclarar su rol como wrapper de eventos unificado y el comportamiento de las propiedades de detalle en diferentes tipos de navegación (gestos, clics). (I91e8d)
  • Se actualizó la documentación para el control del sistema hacia atrás de las APIs de Compose (BackHandler, PredictiveBackHandler, NavigationEventHandler) para destacar el comportamiento específicamente en torno al orden de devolución de llamada. (I7ab94, )

Actualización de dependencia

  • NavigationEvent ahora depende de Compose Runtime 1.9.0-beta03, lo que permite que el artefacto navigationevent-compose admita todos los destinos de KMP. (Ia1b87)

Versión 1.0.0-alpha05

30 de julio de 2025

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

Compatibilidad con la jerarquía superior-secundario:

Un NavigationEventDispatcher ahora puede tener despachadores principales y secundarios, lo que forma una estructura de árbol jerárquica. Esto permite que los eventos de navegación se propaguen y se administren de manera más flexible en los componentes de IU de Compose complejos, ya que reflejan la jerarquía estructural de la IU a través de distribuidores encadenados. (I194ac)

  // Create a parent dispatcher that will manage navigation events at a higher level.
  val parentDispatcher = NavigationEventDispatcher()

  // Create a child dispatcher linked to the parent, forming a hierarchy.
  val childDispatcher = NavigationEventDispatcher(parentDispatcher)

La propiedad jerárquica isEnabled permite el control descendente de un dispatcher. Cuando isEnabled se establece en false en un dispatcher, se inhabilitan automáticamente todos sus dispatchers descendientes. Esta función permite desactivar ramas completas del sistema de eventos de navegación de manera eficiente. (I9e985)

  // Disabling the child dispatcher disables all its callbacks and any of its children recursively.
  childDispatcher.isEnabled = false

Además, la propiedad isEnabled en NavigationEventCallback ahora respeta el estado habilitado de su dispatcher asociado. Esto significa que una devolución de llamada se considera habilitada solo si tanto la devolución de llamada como su dispatcher (incluidos sus elementos superiores) están habilitados, lo que garantiza un control jerárquico coherente sobre la activación de la devolución de llamada. (I1799a)

  // Create a test callback and add it to the child dispatcher.
  val callback1 = TestNavigationEventCallback(isEnabled = true)
  childDispatcher.addCallback(callback1)

  // Since the childDispatcher is disabled, the callback is effectively disabled as well.
  assertThat(callback1.isEnabled).isFalse()

Se introdujo un nuevo método dispose() para limpiar correctamente los despachadores y sus elementos secundarios. Si llamas a dispose(), se detienen los objetos de escucha para evitar fugas de memoria, se descartan de forma recursiva todos los distribuidores secundarios, se quitan todas las devoluciones de llamada registradas en el distribuidor y se desvincula del elemento superior. Esto garantiza que los recursos se liberen correctamente cuando ya no se necesiten los despachadores. (I9e985)

  // Dispose the child dispatcher to clean up resources.
  childDispatcher.dispose()

Si se llama a algún método público en un dispatcher descartado, se arroja un IllegalStateException de inmediato. Esto evita errores silenciosos y ayuda a los desarrolladores a identificar el uso inadecuado durante el desarrollo. (Ic2dc3)

  val callback2 = TestNavigationEventCallback()

  // Attempting to use a disposed dispatcher will throw an exception.
  assertThrows<IllegalStateException> {
      childDispatcher.addCallback(callback2)
  }

Nota: Presentaremos un nuevo elemento NavigationEventDispatcherOwner Composable que administra automáticamente un dispatcher secundario dentro de la IU de Compose en aosp/3692572. Sin embargo, este cambio no se incluyó en la versión actual y se planea para la próxima.

Biblioteca de pruebas de navegación

  • Se agregó el módulo navigationevent-testing para proporcionar utilidades de prueba dedicadas para la biblioteca de navigationevent. (0e50b6)
  • Se agregó la clase de utilidad falsa TestNavigationEventCallback para las pruebas. Registra las llamadas a métodos de devolución de llamada y almacena los elementos NavigationEvent recibidos para admitir la verificación. (4a0246)
  • Se agregó la función de utilidad falsa TestNavigationEvent para crear instancias de NavigationEvent con valores predeterminados, lo que simplifica las pruebas de unidades para el procesamiento de eventos de navegación. (3b63f5)
  • Se agregó la clase de utilidad falsa TestNavigationEventDispatcherOwner para las pruebas. Realiza un seguimiento de los recuentos de eventos de cambio de estado habilitado y de resguardo para admitir la verificación de interacciones en las pruebas. (c8753e)

Cambios en la API

  • Mueve NavigationEventInputHandler de androidMain a commonMain para que esté disponible en el código común de KMP. Se agregaron nuevos métodos public send* para despachar eventos. Cambia las funciones de envío en NavigationEventDispatcher de public a internal; ahora los usuarios deben usar NavigationEventInputHandler para enviar eventos. (Ia7114)
  • Se cambió el nombre de NavigationInputHandler por OnBackInvokedInputHandler. (I63405)

Correcciones de errores

  • Se refactorizó NavigationEventDispatcher para reducir la sobrecarga evitando asignaciones de listas intermedias y mejorando el rendimiento del envío de devoluciones de llamada. (I82702, I1a9d9)
  • Se agregaron anotaciones @FloatRange a los campos touchX, touchY y progress en NavigationEvent para aplicar rangos de valores válidos en el tiempo de compilación y mejorar la seguridad de la API. (Iac0ec)

Versión 1.0.0-alpha04

2 de julio de 2025

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

Correcciones de errores

  • Se usó implementedInJetBrainsFork para navigationevent-compose y se agregó un destino commonStubs para que coincida con las convenciones de Compose. Cambio solicitado por JetBrains. (f60c79)
  • Se corrigió la aplicación del complemento del compilador de Compose para Kotlin/Native para garantizar la generación correcta de stubs. No se afecta el comportamiento ni las APIs públicas. (1890c9)

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 introdujo un nuevo módulo navigationevent-compose para admitir las funciones de Jetpack Compose en la biblioteca navigationevent. (980d78)
  • NavigationEvent Compose agregó una nueva composición local LocalNavigationEventDispatcherOwner. Devuelve un valor anulable para determinar mejor si está disponible en la composición actual. NavigationEventHandler ahora generará un error si no se encuentra el propietario subyacente. (62ffda)
  • NavigationEvent Compose agregó un nuevo elemento NavigationEventHandler componible para controlar eventos (gesto atrás predictivo). Proporciona un Flow de objetos NavigationEvent que se deben recopilar en la expresión 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

  • Ahora, cada NavigationEventCallback solo se puede registrar con un NavigationEventDispatcher a la vez. Si se agrega a varios despachadores, se arroja 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 la modificación simultánea de 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 de androidx.navigationevent proporciona una API que prioriza KMP para controlar el sistema hacia atrás, así como Atrás predictivo. El elemento 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 lanzadas anteriormente en androidx.activity y tiene como objetivo ser un reemplazo menos subjetivo para usar las APIs de Activity en componentes de nivel superior o usar directamente las APIs de OnBackInvokedDispatcher del framework de Android. Las APIs de androidx.activity se reescribieron sobre las APIs de Navigation Event como parte de Activity 1.12.0-alpha01.