navigationevent

  
La libreria Navigation Event fornisce un'API KMP-first per la gestione del pulsante Indietro del sistema e della funzionalità Indietro predittivo.
Ultimo aggiornamento Release stabile Candidato per la release Versione beta Alpha Release
2 luglio 2025 - - - 1.0.0-alpha04

Dichiarazione di dipendenze

Per aggiungere una dipendenza da navigationevent, devi aggiungere il Repository Maven di Google al tuo progetto. Per saperne di più, consulta il repository Maven di Google.

Aggiungi le dipendenze per gli artefatti che ti servono nel file build.gradle per la tua app o il tuo modulo:

Groovy

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

Kotlin

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

Per saperne di più sulle dipendenze, consulta Aggiungere dipendenze di build.

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa libreria. Prima di crearne uno nuovo, dai un'occhiata ai problemi esistenti in questa libreria. 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 di Issue Tracker.

Non sono disponibili note di rilascio per questo artefatto.

Versione 1.0

Versione 1.0.0-alpha04

2 luglio 2025

androidx.navigationevent:navigationevent-*:1.0.0-alpha04 viene ritirata. La versione 1.0.0-alpha04 contiene questi commit.

Correzioni di bug

  • Utilizzato implementedInJetBrainsFork per navigationevent-compose e aggiunto un target commonStubs per rispettare le convenzioni di Compose. Modifica richiesta da Ivan Matkov di JetBrains. (f60c79)
  • È stata corretta l'applicazione del plug-in del compilatore Compose per Kotlin/Native per garantire la corretta generazione di stub. Nessun impatto sulle API pubbliche o sul comportamento. (1890c9)

Versione 1.0.0-alpha03

18 giugno 2025

androidx.navigationevent:navigationevent-*:1.0.0-alpha03 viene ritirata. 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 genererà un errore se il proprietario sottostante non viene trovato. (62ffda)
  • NavigationEvent Compose ha aggiunto un nuovo NavigationEventHandler composable per gestire gli eventi (gesto Indietro predittivo). Fornisce un Flow di NavigationEvent oggetti che devono essere raccolti nella lambda di 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 alle API

  • Ogni NavigationEventCallback ora può essere registrato con un solo NavigationEventDispatcher alla volta; l'aggiunta a più dispatcher genera un IllegalStateException. Tieni presente che questo comportamento è diverso da OnBackPressedDispatcher, che consente più dispatcher. (e82c19)
  • È stato creato isPassThrough un 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 ritirata. La versione 1.0.0-alpha02 contiene questi commit.

Modifiche alle API

  • Sostituisci il costruttore secondario di NavigationEventDispatcher con gli argomenti predefiniti. (I716a0)
  • Rimuovi la proprietà prioritaria da NavigationEventCallback. Trasferisci 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 degli elementi chiudibili. (b/420919815)

Versione 1.0.0-alpha01

20 maggio 2025

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

Nuove funzionalità

  • La libreria androidx.navigationevent fornisce un'API KMP-first per la gestione del pulsante Indietro del sistema e di Predictive Back. NavigationEventDispatcher funge da API comuni per registrare una o più istanze di NavigationEventCallback per la ricezione di eventi di sistema indietro.
  • Questo livello si trova sotto le API rilasciate in precedenza in androidx.activity e mira a essere un sostituto meno soggettivo per l'utilizzo delle API Activity nei componenti di livello superiore o per l'utilizzo diretto delle API del framework Android OnBackInvokedDispatcher. Le API androidx.activity sono state riscritte in base alle API Navigation Event nell'ambito di Activity 1.12.0-alpha01.