navigationevent

  
La libreria Navigation Event fornisce un'API KMP-first per gestire il pulsante Indietro di sistema e il tasto Indietro predittivo.
Ultimo aggiornamento Release stabile Candidato per la release Versione beta Versione alpha
18 giugno 2025 - - - 1.0.0-alpha03

Dichiarazione delle dipendenze

Per aggiungere una dipendenza a navigationevent, devi aggiungere il repository Maven di Google al tuo progetto. Per ulteriori informazioni, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli elementi necessari nel file build.gradle per la tua app o il tuo modulo:

Groovy

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

Kotlin

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

Per ulteriori informazioni sulle dipendenze, consulta Aggiungere dipendenze di compilazione.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di crearne uno nuovo, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Creare un nuovo problema

Per ulteriori informazioni, consulta la documentazione del Monitoraggio problemi.

Non sono disponibili note di rilascio per questo elemento.

Versione 1.0

Versione 1.0.0-alpha03

18 giugno 2025

androidx.navigationevent:navigationevent-*:1.0.0-alpha03 viene rilasciato. La versione 1.0.0-alpha03 contiene questi commit.

Nuove funzionalità

  • È stato introdotto un nuovo modulo navigationevent-compose per supportare le funzionalità di Jetpack Compose nella libreria navigationevent. (980d78)
  • NavigationEvent Compose ha aggiunto una nuova composizione locale LocalNavigationEventDispatcherOwner. Restituisce un valore nullable per determinare meglio se è disponibile nella composizione corrente. NavigationEventHandler ora genera un errore se il proprietario sottostante non viene trovato. (62ffda)
  • NavigationEvent Compose ha aggiunto un nuovo componente composable NavigationEventHandler per gestire gli eventi (gesto Indietro predittivo). Fornisce un Flow di oggetti NavigationEvent che devono essere raccolti nella funzione lambda in sospensione che fornisci 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
  }
}

Modifiche all'API

  • Ora ogni NavigationEventCallback può essere registrato con un solo NavigationEventDispatcher alla volta; se lo aggiungi a più gestori, viene generato un errore IllegalStateException. Tieni presente che questo comportamento è diverso da OnBackPressedDispatcher, che consente più mittenti. (e82c19)
  • È stato impostato isPassThrough come val per impedire la mutazione durante la navigazione, che potrebbe interrompere l'invio di NavigationEvent. (I0b287)

Versione 1.0.0-alpha02

4 giugno 2025

androidx.navigationevent:navigationevent-*:1.0.0-alpha02 viene rilasciato. La versione 1.0.0-alpha02 contiene questi commit.

Modifiche all'API

  • Sostituisci il costruttore secondario di NavigationEventDispatcher con gli argomenti predefiniti. (I716a0)
  • Rimuovi la proprietà priority da NavigationEventCallback. Assegna la priorità a NavigationEventDispatcher.addCallback(). (I13cae)

Correzioni di bug

  • È stato corretto un ConcurrentModificationException che poteva verificarsi quando veniva chiamato NavigationEventCallback.remove() a causa della modifica simultanea dell'elenco interno di elementi chiudibili. (b/420919815)

Versione 1.0.0-alpha01

20 maggio 2025

androidx.navigationevent:navigationevent-*:1.0.0-alpha01 viene rilasciato. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

  • La libreria androidx.navigationevent fornisce un'API KMP-first per gestire il ritorno al sistema e il ritorno predittivo. NavigationEventDispatcher funge da API comuni per la registrazione di una o più istanze di NavigationEventCallback per la ricezione di eventi di risposta del sistema.
  • Questo livello si trova sotto le API rilasciate in precedenza in androidx.activity e ha lo scopo di essere una sostituzione meno opinabile dell'utilizzo delle API Activity in componenti di livello superiore o dell'utilizzo diretto delle API OnBackInvokedDispatcher del framework Android. Le API androidx.activity sono state riscritte in base alle API Navigation Event nell'ambito di Activity 1.12.0-alpha01.