navigationevent

  
Die Navigation Event Library bietet eine KMP-first API für die Verarbeitung des Systemrückgangs sowie des vorhersagenden Zurück.
Letzte Aktualisierung Stabile Version Releasekandidat Beta-Ausgabe Alphaversion
18. Juni 2025 - – - 1.0.0-alpha03

Abhängigkeiten deklarieren

Wenn Sie eine Abhängigkeit von navigationevent hinzufügen möchten, müssen Sie Ihrem Projekt das Google Maven-Repository hinzufügen. Weitere Informationen finden Sie im Maven-Repository von Google.

Fügen Sie der Datei build.gradle für Ihre App oder Ihr Modul die Abhängigkeiten für die erforderlichen Artefakte hinzu:

Groovy

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

Kotlin

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

Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.

Feedback

Ihr Feedback hilft uns, Jetpack zu verbessern. Bitte teilen Sie uns mit, wenn Sie neue Probleme feststellen oder Ideen zur Verbesserung dieser Bibliothek haben. Sehen Sie sich die vorhandenen Probleme in dieser Bibliothek an, bevor Sie ein neues erstellen. Sie können einer vorhandenen Anfrage Ihre Stimme geben, indem Sie auf die Schaltfläche mit dem Stern klicken.

Neues Problem erstellen

Weitere Informationen finden Sie in der Dokumentation zum Issue Tracker.

Für dieses Artefakt gibt es keine Versionshinweise.

Version 1.0

Version 1.0.0-alpha03

18. Juni 2025

androidx.navigationevent:navigationevent-*:1.0.0-alpha03 wird veröffentlicht. Version 1.0.0-alpha03 enthält diese Commits.

Neue Funktionen

  • Einführung eines neuen navigationevent-compose-Moduls zur Unterstützung von Jetpack Compose-Funktionen in der navigationevent-Bibliothek. (980d78)
  • NavigationEvent In Compose wurde eine neue lokale Komposition LocalNavigationEventDispatcherOwner hinzugefügt. Es wird ein typsicherer Wert zurückgegeben, um besser zu bestimmen, ob er in der aktuellen Komposition verfügbar ist. Bei NavigationEventHandler wird jetzt ein Fehler ausgegeben, wenn der zugrunde liegende Eigentümer nicht gefunden wird. (62ffda)
  • NavigationEvent In Compose wurde ein neues NavigationEventHandler-Komposit hinzugefügt, um Ereignisse (vorhersagende Zurück-Geste) zu verarbeiten. Es enthält eine Flow von NavigationEvent Objekten, die in dem von Ihnen bereitgestellten Lambda-Abschnitt c42ba6 erfasst werden müssen:
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
  }
}

API-Änderungen

  • Jede NavigationEventCallback kann jetzt nur mit einer NavigationEventDispatcher registriert werden. Wenn sie mehreren Dispatchern hinzugefügt wird, wird eine IllegalStateException ausgegeben. Dieses Verhalten unterscheidet sich von OnBackPressedDispatcher, bei dem mehrere Disponenten zulässig sind. (e82c19)
  • isPassThrough wurde in val geändert, um eine Mutation während der Navigation zu verhindern, die die Auslieferung von NavigationEvent beeinträchtigen könnte. (I0b287)

Version 1.0.0-alpha02

4. Juni 2025

androidx.navigationevent:navigationevent-*:1.0.0-alpha02 wird veröffentlicht. Version 1.0.0-alpha02 enthält diese Commits.

API-Änderungen

  • Ersetzen Sie den sekundären Konstruktor von NavigationEventDispatcher durch Standardargumente. (I716a0)
  • Entfernen Sie die Prioritätseigenschaft aus NavigationEventCallback. Übergeben Sie die Priorität stattdessen an NavigationEventDispatcher.addCallback(). (I13cae)

Fehlerkorrekturen

  • Ein ConcurrentModificationException wurde behoben, das beim Aufrufen von NavigationEventCallback.remove() auftreten konnte, weil die interne Liste der Closeables gleichzeitig geändert wurde. (b/420919815)

Version 1.0.0-alpha01

20. Mai 2025

androidx.navigationevent:navigationevent-*:1.0.0-alpha01 wird veröffentlicht. Version 1.0.0-alpha01 enthält diese Commits.

Neue Funktionen

  • Die androidx.navigationevent-Bibliothek bietet eine KMP-first-API für die Verarbeitung von System-Back sowie Predictive Back. Die NavigationEventDispatcher dient als gängige API zum Registrieren einer oder mehrerer NavigationEventCallback-Instanzen für den Empfang von Systemrückgabeereignissen.
  • Diese Schicht liegt unter den zuvor in androidx.activity veröffentlichten APIs und soll ein weniger subjektiver Ersatz für die Verwendung der Aktivitäts-APIs in Komponenten höherer Ebene oder die direkte Verwendung der Android-Framework-APIs OnBackInvokedDispatcher sein. Die androidx.activity APIs wurden im Rahmen von Activity 1.12.0-alpha01 auf Grundlage der Navigations-Ereignis-APIs neu geschrieben.