navigationevent

  
La bibliothèque Navigation Event fournit une API KMP pour gérer la touche Retour du système ainsi que la Retour prédictif.
Dernière mise à jour Version stable Version finale Version bêta Version alpha
18 juin 2025 - - - 1.0.0-alpha03

Déclarer des dépendances

Pour ajouter une dépendance à navigationevent, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.

Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module :

Groovy

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

Kotlin

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

Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un nouveau problème

Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.

Aucune note de version pour cet artefact.

Version 1.0

Version 1.0.0-alpha03

18 juin 2025

Publication d'androidx.navigationevent:navigationevent-*:1.0.0-alpha03. La version 1.0.0-alpha03 contient ces commits.

Nouvelles fonctionnalités

  • Ajout d'un nouveau module navigationevent-compose pour prendre en charge les fonctionnalités Jetpack Compose dans la bibliothèque navigationevent. (980d78)
  • NavigationEvent Compose a ajouté une nouvelle composition locale LocalNavigationEventDispatcherOwner. Il renvoie une valeur nullable pour mieux déterminer si elle est disponible dans la composition actuelle. NavigationEventHandler génère désormais une erreur si le propriétaire associé est introuvable. (62ffda)
  • NavigationEvent Compose a ajouté un nouveau composable NavigationEventHandler pour gérer les événements (geste Retour prédictif). Il fournit un Flow d'objets NavigationEvent qui doivent être collectés dans le lambda de suspension que vous fournissez 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
  }
}

Modifications apportées à l'API

  • Chaque NavigationEventCallback ne peut désormais être enregistré qu'avec un seul NavigationEventDispatcher à la fois. L'ajout à plusieurs répartiteurs génère une erreur IllegalStateException. Notez que ce comportement diffère de OnBackPressedDispatcher, qui autorise plusieurs coordinateurs. (e82c19)
  • isPassThrough est devenu un val pour éviter la mutation pendant la navigation, ce qui pourrait endommager le traitement de NavigationEvent. (I0b287)

Version 1.0.0-alpha02

4 juin 2025

Publication d'androidx.navigationevent:navigationevent-*:1.0.0-alpha02. La version 1.0.0-alpha02 contient ces commits.

Modifications apportées à l'API

  • Remplacez le constructeur secondaire de NavigationEventDispatcher par des arguments par défaut. (I716a0)
  • Supprimez la propriété de priorité de NavigationEventCallback. Transmettez plutôt la priorité à NavigationEventDispatcher.addCallback(). (I13cae)

Correction de bugs

  • Correction d'une ConcurrentModificationException pouvant se produire lors de l'appel de NavigationEventCallback.remove() en raison de la modification simultanée de la liste interne des éléments pouvant être fermés. (b/420919815)

Version 1.0.0-alpha01

20 mai 2025

Publication d'androidx.navigationevent:navigationevent-*:1.0.0-alpha01. La version 1.0.0-alpha01 contient ces commits.

Nouvelles fonctionnalités

  • La bibliothèque androidx.navigationevent fournit une API KMP-first pour gérer la touche Retour du système ainsi que la Retour prédictif. NavigationEventDispatcher sert d'API commune pour enregistrer une ou plusieurs instances NavigationEventCallback afin de recevoir les événements de retour du système.
  • Cette couche se trouve sous les API publiées précédemment dans androidx.activity et vise à remplacer de manière moins subjective l'utilisation des API Activity dans des composants de niveau supérieur ou l'utilisation directe des API OnBackInvokedDispatcher du framework Android. Les API androidx.activity ont été réécrites sur la base des API Navigation Event dans le cadre de Activity 1.12.0-alpha01.