navigation3

  
Navigation 3 è una nuova libreria di navigazione progettata per funzionare con Compose.
Ultimo aggiornamento Release stabile Candidato per la release Release beta Release alpha
4 novembre 2026 1.2.1 - - 1.3.0-alpha04

Dichiara le dipendenze

Per aggiungere una dipendenza da navigation3, 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 necessari nel file build.gradle per la tua app o il tuo modulo:

Trendy

dependencies {
    implementation "androidx.navigation3:navigation3-runtime:1.3.0-alpha04"
    implementation "androidx.navigation3:navigation3-ui:1.3.0-alpha04"
}

Kotlin

dependencies {
    implementation("androidx.navigation3:navigation3-runtime:1.3.0-alpha04")
    implementation("androidx.navigation3:navigation3-ui:1.3.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 raccolta. Prima di segnalare un nuovo problema, 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.

Crea un nuovo problema

Per saperne di più, consulta la documentazione di Issue Tracker.

Versione 1.3

Versione 1.3.0-alpha04

4 novembre 2026

androidx.navigation3:navigation3-*:1.3.0-alpha04 è stato rilasciato. La versione 1.3.0-alpha04 contiene questi commit.

Correzioni di bug

  • Risolto il problema per cui l'elemento NavEntry condiviso non veniva visualizzato sullo schermo quando veniva rimosso e poi aggiunto di nuovo prima del completamento della rimozione. (I6a482)

Versione 1.3.0-alpha03

21 ottobre 2026

androidx.navigation3:navigation3-*:1.3.0-alpha03 è stato rilasciato. La versione 1.3.0-alpha03 contiene questi commit.

Nessuna modifica rispetto alla versione 1.3.0-alpha02

Versione 1.3.0-alpha02

7 ottobre 2026

androidx.navigation3:navigation3-*:1.3.0-alpha02 è stato rilasciato. La versione 1.3.0-alpha02 contiene questi commit.

Modifiche alle API

  • La classe SceneInfo ha aggiunto le proprietà title e url, che vengono compilate automaticamente dagli ultimi metadati NavEntry's della scena. Utilizza TitleMetadataKey e UrlMetadataKey per definire i titoli e gli URL di destinazione nei metadati della voce. (I78a20, b/542693522)

Versione 1.3.0-alpha01

23 settembre 2026

androidx.navigation3:navigation3-*:1.3.0-alpha01 è stato rilasciato. La versione 1.3.0-alpha01 contiene questi commit.

Correzioni di bug

  • Risolto il problema di handoff dell'animazione Indietro predittivo in NavDisplay eseguendo la migrazione a DeferredAnimatedContent e risolvendo i problemi di handoff della transizione. I145eaedd b/430807423
    • DeferredAnimatedContent utilizza DeferredTransition per separare le transizioni in una fase differita (tramite defer), che applica trasformazioni manuali durante un gesto di scorrimento, e una fase automatica (tramite animateTo), che esegue la transizione quando lo scorrimento viene confermato.

Problemi noti

  • Gli elementi condivisi vengono visualizzati nella scena in uscita durante le transizioni anziché nella scena in entrata. (b/582354988)
  • Gli elementi condivisi non eseguono la ricerca durante la fase differita (gesto).

Versione 1.2.1

4 novembre 2026

androidx.navigation3:navigation3-*:1.2.1 è stato rilasciato. La versione 1.2.1 contiene questi commit.

Modifiche

  • compileSdk è stato eseguito il downgrade da 37 a 36. La versione 1.2 dipende da Compose 1.10, che non richiede compileSdk 37.

Versione 1.2.0

23 settembre 2026

androidx.navigation3:navigation3-*:1.2.0 è stato rilasciato. La versione 1.2.0 contiene questi commit.

La versione 1.2.0 è ora stabile.

Modifiche importanti dalla versione 1.1.0

API Result

  • Questa nuova API consente di passare i risultati tra NavEntries utilizzando ResultEventBus fornito da LocalResultEventBus e ResultEventBusNavEntryDecorator.
  • È stato aggiunto rememberResultEventBus per supportare l'hoisting di un ResultEventBus all'esterno di ResultEventBusNavEntryDecorator e il suo passaggio a rememberResultEventBusNavEntryDecorator.
  • È possibile accedere ai risultati passati come stato con ResultEventBus#conflateAsState o raccoglierli come flusso di risultati con ResultEffect.

API Deep Link

Navigation3 ora supporta i deep link Kotlin Multiplatform (KMP) in androidx.navigation3.runtime.deeplink tramite DeepLinkRequest, DeepLinkUri e DeepLinkMatcher.

  • DeepLinkRequest e RequestExtras: rappresentano una richiesta di deep link creata da un DeepLinkUri, una stringa URI o un Intent Android. È possibile allegare metadati di richiesta aggiuntivi utilizzando il container RequestExtras con sicurezza dei tipi creato con il DSL requestExtras e RequestExtrasKey<T>.
  • DeepLinkMatcher: rappresenta un deep link che può essere associato a un DeepLinkRequest. Ogni istanza di matcher è associata alla chiave di navigazione che supporta questo deep link. Una chiave di navigazione può essere associata a più matcher. La chiamata a DeepLinkMatcher.match restituirà un MatchResult che contiene la chiave di navigazione associata se la corrispondenza ha esito positivo. Esistono due implementazioni predefinite di DeepLinkMatcher: UriDeepLinkMatcher per la corrispondenza dei deep link in base a Uri e StaticKeyDeepLinkMatcher per la corrispondenza dei deep link con solo DeepLinkMatcher.Filter che corrispondono a un valore booleano.
  • BackStackMatcher: un DeepLinkMatcher per creare un back stack sintetico in caso di corrispondenza corretta del deep link. BackStackMatcher può essere creato tramite la funzione di estensione DeepLinkMatcher.withBackStack.

Gestione di Indietro predittivo

  • Sono stati aggiunti NavigationBackHandler e rememberNavigationEventState per semplificare la connessione di SceneState con la gestione del gesto Indietro predittivo (onBackCompleted e onBackCancelled). In questo modo, i componenti UI personalizzati possono supportare la navigazione a ritroso standard e i gesti Indietro predittivi senza calcolare manualmente i delta del back stack.
  • Transizioni Indietro predittivo migliorate, incluso il supporto dei gesti Indietro predittivo attivati durante le animazioni in avanti.

Altre modifiche

  • NavEntry.contentKey ora viene impostato per impostazione predefinita su un composto di key.toString() e key::class.toString(), impedendo collisioni di chiavi tra le chiavi data object che condividono lo stesso nome semplice in interfacce diverse.
  • EntryProvider ora dà la priorità alla corrispondenza in base alle istanze delle chiavi rispetto ai tipi di chiavi.
  • È stato aggiunto un controllo lint per garantire che le implementazioni di Scene siano data class o implementino equals e hashCode.

Versione 1.2.0-rc01

9 settembre 2026

androidx.navigation3:navigation3-*:1.2.0-rc01 è stato rilasciato. La versione 1.2.0-rc01 contiene questi commit.

Correzioni di bug

  • Non consentire nomi di segnaposto duplicati nei pattern URI dei deep link. (I8985c, b/522343165)

Versione 1.2.0-beta01

26 agosto 2026

androidx.navigation3:navigation3-*:1.2.0-beta01 è stato rilasciato. La versione 1.2.0-beta01 contiene questi commit.

Modifiche alle API

  • Rifattorizzato DeepLinkRequest.extras da Map<String, Any> a una nuova classe di tipo mappa sicura RequestExtras che memorizza coppie di RequestExtrasKey<T> in T. È possibile creare un'istanza di RequestExtras con il DSL requestExtras. (Ic929d, b/543883369)

Correzioni di bug

  • È stato risolto un problema per cui i gesti Indietro predittivi attivati durante una transizione in avanti non venivano animati in risposta all'avanzamento dello scorrimento. Ora l'Indietro predittivo verrà animato e completato correttamente. (Icdcb0, b/456218398)
  • È stato aggiunto un controllo lint per garantire che le implementazioni di Scene siano classi di dati o implementino equals e hashcode per garantire che venga utilizzato lo stesso Scene quando appropriato. (Ibdf0d, b/542316099)
  • NavEntry.contentKey ora viene impostato per impostazione predefinita su una combinazione di key.toString() e key::class.toString(). In questo modo, gli oggetti dati che condividono lo stesso nome, ma implementano interfacce diverse, non avranno più lo stesso contentKey. Tuttavia, key::class della piattaforma JS restituisce solo il nome della classe semplice anziché il nome completo, quindi la piattaforma JS deve comunque implementare contentKey personalizzati per gli oggetti dati con nomi duplicati. (I1fbbb, b/512534342)
  • Risolto il problema IllegalArgumentException generato da SaveableStateProvider per le chiavi duplicate utilizzate durante la navigazione a ritroso rapida quando sono in corso più transizioni di uscita. (I4d728, b/516312097)

Versione 1.2.0-alpha07

29 luglio 2026

androidx.navigation3:navigation3-*:1.2.0-alpha07 è stato rilasciato. La versione 1.2.0-alpha07 contiene questi commit.

Modifiche alle API

  • È stata aggiunta una classe WrappedMatchResult astratta per aggregare un'altra classe DeepLinkMatcher.MatchResult. In questo modo, i risultati di corrispondenza personalizzati vengono sovrapposti a un altro. (I7d4dc, b/470282247)
  • È stata aggiunta una nuova classe BackStackMatcher che accetta due parametri: un'istanza di matcher e una funzione lambda del builder che fornisce il risultato della corrispondenza del matcher di input e restituisce un back stack. In caso di corrispondenza, BackStackMatcher restituisce un BackStackMatchResult che estende WrappedMatchResult contenente il risultato della corrispondenza originale insieme al back stack creato con la funzione lambda. BackStackMatcher può essere creato solo con la nuova funzione di estensione DeepLinkMatcher.withBackStack. (Ibf987, b/470282247)

  • È stata aggiunta una classe DeepLinkSerializer astratta che estende KSerializer per codificare e decodificare value : T come String. DeepLinkSerializer può essere utilizzato per serializzare argomenti di deep link non primitivi. Compatibile con rememberSaveable e rememberNavBackStack. (Id3c9f, b/470282247)

  • DeepLinkMatcher ha aggiunto un secondo parametro di tipo out R : DeepLinkMatcher.MatchResult<T> in modo che gli sviluppatori possano accedere alle proprietà della sottoclasse MatchResult restituita da DeepLinkMatcher.match() senza eseguire il type casting. (I693d3, b/470282247)

  • Il limite superiore di T DeepLinkMatcher.MatchResult's è stato modificato da Any? a Any. (I6bf1a)

  • Il campo del costruttore DeepLinkRequest uri ora è nullo per impostazione predefinita. Il costruttore secondario uriString è stato rinominato in uri. (Ia0f14, b/522194187)

Correzioni di bug

  • ResultEffect ora utilizza rememberUpdatedState per acquisire l'ultima lambda onResult. (I7d2a3, b/531709234)
  • Risolto il problema relativo alla corrispondenza dei deep link per i segmenti di percorso vuoti. Se il tipo di argomento è String, il percorso vuoto verrà trattato come un valore di stringa vuoto. In caso contrario, il percorso vuoto viene considerato come nessun valore fornito e verrà utilizzato il valore predefinito. Se non esiste un valore predefinito, la corrispondenza non andrà a buon fine. (I56575, b/535298128)
  • È stato aggiunto il supporto per i valori di query vuoti in DeepLinkRequest.uri. Se l'argomento è di tipo Stringa, il valore vuoto verrà trattato come una stringa vuota letterale. In caso contrario, il valore vuoto viene considerato come nessun valore fornito e la corrispondenza tenterà di tornare al valore predefinito. Se non esiste un valore predefinito, la corrispondenza non andrà a buon fine. (I30343, b/535127459)
  • EntryProvider ora dà la priorità alla corrispondenza in base alle istanze delle chiavi rispetto ai tipi di chiavi. (Ib5ec9, b/533331924)
  • SceneState ora calcola correttamente le scene precedenti a partire dalla scena non in overlay più in alto. (I91915, b/513630541)

Versione 1.2.0-alpha06

15 luglio 2026

androidx.navigation3:navigation3-*:1.2.0-alpha06 è stato rilasciato. La versione 1.2.0-alpha06 contiene questi commit.

Correzioni di bug

  • È stata corretta la documentazione di UriDeepLinkMatcher sui frammenti URI per chiarire che i frammenti con caratteri jolly corrispondono a qualsiasi input, ma l'input non viene estratto come argomento. (I5ad9b, b/524677091)
  • Risolto il problema per cui UriDeepLinkMatcher non corrispondeva a una richiesta se il pattern URI non conteneva uno schema o non iniziava con una doppia barra. Ad esempio, www.example.com/home ora corrisponderà a http://www.example.com/home. (Ia6b65, b/522791926)

Versione 1.2.0-alpha05

1° luglio 2026

androidx.navigation3:navigation3-*:1.2.0-alpha05 è stato rilasciato. La versione 1.2.0-alpha05 contiene questi commit.

Nuova API

  • È stata aggiunta un'API rememberResultEventBus che restituisce un ResultEventBus che può essere passato a rememberResultEventBusNavEntryDecorator. In questo modo è possibile eseguire l'hoisting di un ResultEventBus all'esterno di ResultEventBusNavEntryDecorator. (Ia655b, b/516995400)

DeepLinkRequest

  • Sono stati aggiunti due costruttori compatibili con KMP: uno che accetta un DeepLinkUri e uno che accetta un URI di stringa non elaborata. (I3c088, b/513200887, b/522194187)
  • (Solo Android) È stato aggiunto un costruttore che accetta un Intent. (Ia0498, b/513200887, b/522194187)
  • Tutti i costruttori hanno un campo extras aggiuntivo per un Map<String, Any> per allegare informazioni aggiuntive sulla richiesta. (If81d5, b/513200887)
  • È stato aggiunto un nuovo DSL requestExtras come modo con sicurezza dei tipi per creare una mappa di extra. Il DSL fornisce una funzione put per archiviare coppie di RequestExtrasKey in Any. La funzione di estensione Map<String, Any>.get(key) può essere utilizzata per leggere dalla mappa con un RequestExtrasKey(I5091c, b/513200887)
  • (Solo Android) Sono state aggiunte una funzione ActionExtrasKey e una funzione actionExtra per creare una mappa di extra con ActionExtrasKey. (Id0c90, [b/513200887]
  • È stata aggiunta una funzione MimeTypeExtrasKey e mimeTypeExtra per creare una mappa di extra con MimeTypeExtrasKey. (I85131, b/513200887)

DeepLinkMatcher

  • Sono state aggiunte le funzioni DeepLinkMatcher.mimeTypeFilter e DeepLinkMatcher.actionFilter per creare DeepLinkMatcher.Filters che filtrano DeepLinkRequest per mimeType o action (solo Android). Entrambi i filtri corrispondono per uguaglianza di stringhe e non fanno distinzione tra maiuscole e minuscole. (Ie7e67, b/513191950)

Modifiche alle API

DeepLinkRequest

  • Rimuovi la funzione factory fromAction. Per creare una richiesta associata a un'azione, utilizza il nuovo campo DeepLinkRequest.extras.(Id0c90, b/513200887)
  • fromMimeType funzione di fabbrica rimossa. Per creare una richiesta associata a un mimeType, utilizza il nuovo campo DeepLinkRequest.extras. (I85131, b/513200887)
  • (Solo Android) Rimossa la funzione factory fromIntent. Sostituito da un nuovo costruttore che accetta un intent e una mappa di extra. (Ia0498, b/513200887, b/522194187)
  • Rimosse le funzioni factory fromUri e fromUriString. Sostituito da nuovi costruttori che accettano un DeepLinkUri o un URI di stringa non elaborata. (Id5b6f, b/522194187)
  • DeepLinkMatcher, DeepLinkMatcher.MatchResult e le relative sottoclassi ora accettano un T covariante (out T) in modo che le chiavi gerarchiche non richiedano il type casting se utilizzate con i matcher. (I1e453, b/525094876)
  • Il parametro del costruttore UriMatchResult per la mappa degli argomenti ora viene impostato per impostazione predefinita su una mappa vuota. (I3acdd)
  • La classe astratta DeepLinkMatcher.Filter ora è un'interfaccia funzionale. Il campo del costruttore filter viene rimosso e deve essere passato direttamente nella sottoclasse. (I9eb7d, b/522194187)

Correzioni di bug

  • Risolto il problema per cui la voce estratta scompariva immediatamente quando si estraeva una voce con metadati nidificati contenenti valori lambda. (Idb872, b/520494430)
  • È stato corretto UriDeepLinkMatcher in modo che restituisca un valore UriMatchResult null anziché generare MissingFieldException quando mancano gli argomenti obbligatori durante la corrispondenza. (I5322f, b/524663005)
  • Un UriDeeplinkMatcher contenente un URI con schema HTTPS può essere associato solo a richieste che hanno anche lo schema HTTPS. (Ibfe22, b/522304329)
  • Correzione di UriDeepLinkMatcher per identificare correttamente lo schema http come corrispondenza positiva con https quando si associa un DeepLinkRequest a un UriDeepLinkMatcher. (I3a62b, b/518804264)
  • Il comparatore DeepLinkMatcher.MatchResult ora restituisce 0 per impostazione predefinita quando due risultati sono uguali. (I48ddb, b/518841353)
  • UriDeepLinkMatcher ora restituirà un valore UriMatchResult null anziché generare un'eccezione quando la richiesta con corrispondenza non va a buon fine a causa di argomenti obbligatori mancanti. (I669a7, b/470282247, b/512923412)

Versione 1.2.0-alpha04

3 giugno 2026

androidx.navigation3:navigation3-*:1.2.0-alpha04 è stato rilasciato. La versione 1.2.0-alpha04 contiene questi commit.

Correzioni di bug

  • Risolto il problema di animazione degli overlay per cui gli overlay nidificati come ModalBottomSheet venivano rianimati in modo imprevisto quando gli overlay sopra venivano visualizzati. (Ia2b9e, b/502624496)

Versione 1.2.0-alpha03

19 maggio 2026

androidx.navigation3:navigation3-*:1.2.0-alpha03 è stato rilasciato. La versione 1.2.0-alpha03 contiene questi commit.

Nuove funzionalità

Navigation 3 ora supporta i deep link con DeepLinkRequest e DeepLinkMatcher:

  • DeepLinkRequest un deep link richiesto contenente un DeepLinkUri e un mimeType o un'azione facoltativi (solo Android). Insieme alla nuova classe sono disponibili funzioni companion per creare un'istanza con un uri, un mimeType o un action. La piattaforma Android dispone anche di un helper per creare una richiesta da un intent. (Iaaac9, b/470282247)

    val uriOnlyRequest = DeepLinkRequest.fromUriString("https://sampledeeplink.com/home")
    val uriAndMimeRequest = DeepLinkRequest.fromUriString(
      "https://sampledeeplink.com/user/profile?id=123",
      "image/png"
    )
    
  • DeepLinkMatcher rappresenta un deep link che può essere associato a un DeepLinkRequest. Ogni istanza di matcher è associata alla chiave di navigazione che supporta questo deep link. Una chiave di navigazione può essere associata a più matcher. La chiamata a DeepLinkMatcher.match restituirà un MatchResult che contiene la chiave di navigazione associata se la corrispondenza ha esito positivo. Esistono due implementazioni predefinite di DeepLinkMatcher: UriDeepLinkMatcher per la corrispondenza dei deep link in base all'URI e StaticKeyDeepLinkMatcher per la corrispondenza dei deep link solo con DeepLinkMatcher.Filter che corrispondono a un Boolean. (I3798e, b/470282247)

  • UriDeepLinkMatcher un'implementazione di DeepLinkMatcher che gestisce il deep link associando DeepLinkUri a una chiave di navigazione serializzabile. Supporta argomenti di deep link di tipi primitivi o raccolte di primitive come elenchi, array e set. (I1520b, b/470282247)

    @Serializable
    data class UserKey(val id: Int): NavKey
    
    // declare a deep link supported by UserKey
    val userMatcher = UriDeepLinkMatcher(
      uriPattern = "www.sampledeeplink.com/user?userId={id}",
      serializer = serializer<UserKey>()
    )
    
    // handle a requested deep link with fallback key
    val key = userMatcher.match(deepLinkRequest)?.key ?: HomeKey
    
  • È stato aggiunto DeepLinkUri, che è una versione multipiattaforma Kotlin di android.net.Uri (Id4725, b/470282247)

Modifiche alle API

  • Aggiornato a compileSdk 37 per corrispondere a compileSdk di Compose

Correzioni di bug

  • Risolto il problema relativo a IllegalArgumentException di AnimatedBottomSheetSample durante la visualizzazione di più overlay. L'esempio SceneStrategy ora calcolerà correttamente l'ultimo non-OverlayScene e lo mostrerà in tutte le scene in overlay. (If2281, b/506733412)
  • È stato eseguito l'upgrade della dipendenza NavigationEvent alla versione 1.1.1, che rimuove il NavigationEventHandler no-op in modalità di ispezione per attivare Indietro predittivo nelle anteprime di Android Studio. (I487fd)

Versione 1.2.0-alpha02

22 aprile 2026

androidx.navigation3:navigation3-*:1.2.0-alpha02 è stato rilasciato. La versione 1.2.0-alpha02 contiene questi commit.

Modifiche alle API

  • Rinomina onBack in onBackCompleted e aggiungi onBackCancelled a NavigationBackHandler per supportare la gestione dei gesti Indietro annullati. (I92741)
  • Aggiungi NavigationBackHandler per semplificare la gestione dei gesti Indietro e della funzionalità Indietro predittivo quando utilizzi SceneState. In questo modo, gli sviluppatori possono creare più facilmente componenti UI personalizzati che supportano la navigazione a ritroso standard e i gesti predittivi senza calcolare manualmente i delta del back stack. (I6a055)
  • Aggiungi rememberNavigationEventState per semplificare la connessione SceneState con la gestione della funzionalità Indietro predittivo. (Iae49c)

Nuove funzionalità

  • È stata aggiunta un'API ResultEventBus per consentire il passaggio dei risultati tra NavEntries con LocalResultEventBus fornito dal nuovo ResultEventBusNavEntryDecorator. I risultati trasmessi possono essere valutati come uno stato con ResultEventBus#conflateAsState o come un flusso di risultati con ResultEffect.

Versione 1.2.0-alpha01

8 aprile 2026

androidx.navigation3:navigation3-*:1.2.0-alpha01 è stato rilasciato. La versione 1.2.0-alpha01 contiene questi commit.

Correzioni di bug

  • L'accesso a LocalNavAnimatedContentScope da un OverlayScene non causerà più un IllegalStateException, poiché OverlayScenes ora è dotato di un LocalAnimatedContentScope no-op. (I2f00c, b/486067688)

Versione 1.1.7

26 agosto 2026

androidx.navigation3:navigation3-*:1.1.7 è stato rilasciato. La versione 1.1.7 contiene questi commit.

Correzioni di bug

  • È stato risolto un problema per cui i gesti Indietro predittivi attivati durante una transizione in avanti non venivano animati in risposta all'avanzamento dello scorrimento. Ora l'Indietro predittivo verrà animato e completato correttamente. (Icdcb0, b/456218398)

Versione 1.1.6

12 agosto 2026

androidx.navigation3:navigation3-*:1.1.6 è stato rilasciato. La versione 1.1.6 contiene questi commit.

Correzioni di bug

  • NavEntry.contentKey ora viene impostato per impostazione predefinita su una combinazione di key.toString() e key::class.toString(). In questo modo, gli oggetti dati che condividono lo stesso nome, ma implementano interfacce diverse, non avranno più lo stesso contentKey. Tuttavia, key::class della piattaforma JS restituisce solo il nome della classe semplice anziché il nome completo, quindi la piattaforma JS deve comunque implementare contentKey personalizzati per gli oggetti dati con nomi duplicati. (I1fbbb, b/512534342)
  • Risolto il problema relativo all'eccezione IllegalArgumentException generata da SaveableStateHolder per il riutilizzo della chiave quando più transizioni di uscita sono in corso contemporaneamente a causa di un'uscita rapida dal back stack. (I4d728, b/516312097)

Versione 1.1.5

29 luglio 2026

androidx.navigation3:navigation3-*:1.1.5 è stato rilasciato. La versione 1.1.5 contiene questi commit.

Correzioni di bug

  • Il DSL entryProvider ora dà la priorità a NavEntry creato con un'istanza di chiave, ad esempio entry(key = userKey) { ... } rispetto a NavEntry creato con una classe di chiave come entry<UserKey>{ ... }.(Ib5ec9, b/533331924)

Versione 1.1.4

1° luglio 2026

androidx.navigation3:navigation3-*:1.1.4 è stato rilasciato. La versione 1.1.4 contiene questi commit.

Correzioni di bug

  • Risolto il problema per cui la voce estratta scompariva immediatamente quando si estraeva una voce con metadati nidificati contenenti valori lambda. (Idb872, b/520494430)

Versione 1.1.3

17 giugno 2026

androidx.navigation3:navigation3-*:1.1.3 è stato rilasciato. La versione 1.1.3 contiene questi commit.

Correzioni di bug

  • Risolto il problema di animazione degli overlay per cui gli overlay nidificati come ModalBottomSheet venivano rianimati in modo imprevisto quando gli overlay sopra venivano visualizzati. (Ia2b9e, b/502624496)

  • È stata eseguita la migrazione della dipendenza NavigationEvent alla versione 1.1.2, che ha rimosso l'operazione no-op NavigationEventHandler in modalità di ispezione per attivare Indietro predittivo nelle anteprime di Android Studio.

Versione 1.1.2

19 maggio 2026

androidx.navigation3:navigation3-*:1.1.2 è stato rilasciato. La versione 1.1.2 contiene questi commit.

Correzioni di bug

  • È stata eseguita la migrazione della dipendenza NavigationEvent alla versione 1.1.1, che ha rimosso l'operazione no-op NavigationEventHandler in modalità di ispezione per attivare Indietro predittivo nelle anteprime di Android Studio.

Versione 1.1.1

22 aprile 2026

androidx.navigation3:navigation3-*:1.1.1 è stato rilasciato. La versione 1.1.1 contiene questi commit.

Correzioni di bug

  • L'accesso a LocalNavAnimatedContentScope da un OverlayScene non causerà più un IllegalStateException, poiché OverlayScenes ora è dotato di un LocalAnimatedContentScope no-op. (I2f00c, b/486067688)

Versione 1.1.0

8 aprile 2026

androidx.navigation3:navigation3-*:1.1.0 è stato rilasciato. La versione 1.1.0 contiene questi commit.

La versione 1.1.0 è ora stabile.

Modifiche importanti dalla versione 1.0.0

Elementi condivisi tra le scene - Navigation3 ora supporta il trattamento delle scene come oggetti di elementi condivisi. Ciò significa che, quando le scene cambiano, è possibile garantire una transizione fluida. Puoi attivare questa funzionalità passando un SharedTransitionScope a NavDisplay o a rememberSceneState.

SceneDecoratorStrategy - Introduzione di SceneDecoratorStrategy per supportare casi d'uso come la decorazione di scene con componenti UI comuni o la condivisione dello stato tra le scene.

DSL NavMetadata - Navigation3 ora fornisce un nuovo DSL di metadati con sicurezza dei tipi. Il DSL utilizza una nuova interfaccia MetadataKey che consente di definire i tipi di chiave e valore da fornire alla mappa dei metadati. Inoltre, sono stati aggiunti nuovi NavMetadataKeys per le transizioni NavDisplay, in modo che possano essere utilizzati con il nuovo DSL dei metadati per aggiungere transizioni a NavDisplay.

Animazioni OverlayScene - L'interfaccia OverlayScene ha un nuovo callback di sospensione onRemoved. Questo callback viene richiamato dopo che una chiave associata alla scena viene rimossa dal backstack, ma prima che lasci la composizione. In questo modo, le animazioni di uscita chiamate all'interno di onRemoved possono essere completate prima che la scena in overlay venga rimossa dalla composizione.

Altre modifiche - NavDisplay e rememberSceneState ora accettano un List<SceneStrategy> anziché il precedente parametro SceneStrategy singolo concatenato dall'infisso then. - Ora puoi aggiungere dinamicamente i metadati tenendo conto della chiave di immissione tramite il DSL EntryProvider.

Versione 1.1.0-rc01

25 marzo 2026

androidx.navigation3:navigation3-*:1.1.0-rc01 è stato rilasciato. La versione 1.1.0-rc01 contiene questi commit.

Correzioni di bug

  • NavDisplay ora garantisce che le voci visualizzate sotto gli overlay abbiano il valore Lifecycle limitato a STARTED. In questo modo, le API come dropUnlessResumed continuano a funzionare quando si utilizzano le finestre di dialogo. (If209f, b/483966071)
  • Risolto un problema in NavDisplay per cui la navigazione avanti e indietro tra le stesse schermate e l'interruzione delle animazioni tra le due poteva causare un ordine di visualizzazione errato delle schermate. (I4d491, b/459419800)

Versione 1.1.0-beta01

11 marzo 2026

androidx.navigation3:navigation3-*:1.1.0-beta01 è stato rilasciato. La versione 1.1.0-beta01 contiene questi commit.

Versione 1.1.0-alpha05

25 febbraio 2026

androidx.navigation3:navigation3-*:1.1.0-alpha05 è stato rilasciato. La versione 1.1.0-alpha05 contiene questi commit.

Modifiche alle API

  • NavDisplay e rememberSceneState ora accettano un List<SceneStrategy> anziché il precedente singolo parametro SceneStrategy concatenato dall'infisso then. Questo approccio è più in linea con il List<SceneDecoratorStrategy<T>> già adottato da entrambe le API. Le API precedenti sono state ritirate. (I78b2c, b/482108465)
  • È stato aggiunto un operatore #contains dei metadati per verificare se la mappa dei metadati contiene l'elemento NavMetadataKey specificato. (Ic30db, b/485311895)
  • Aggiunto NavMetadataKey DialogKey per DialogSceneStrategy da utilizzare con il DSL dei metadati. (Ic7a26, b/483388817)

Versione 1.1.0-alpha04

11 febbraio 2026

androidx.navigation3:navigation3-*:1.1.0-alpha04 è stato rilasciato. La versione 1.1.0-alpha04 contiene questi commit.

Nuove funzionalità

  • Navigation3 ora fornisce un nuovo DSL di metadati con sicurezza dei tipi. Il DSL utilizza una nuova interfaccia MetadataKey che consente di definire i tipi di chiave e valore da fornire alla mappa dei metadati. Inoltre, sono stati aggiunti nuovi NavMetadataKey per le transizioni NavDisplay in modo che possano essere utilizzati con il nuovo DSL metadata per aggiungere transizioni a NavDisplay. (Ic10ef, Ic049c,b/476213928)

Modifiche alle API

  • L'interfaccia OverlayScene ha un nuovo callback di sospensione onRemoved. Questo callback viene richiamato dopo che una chiave associata alla scena viene rimossa dal backstack, ma prima che lasci la composizione. In questo modo, le animazioni di uscita chiamate all'interno di onRemoved possono essere completate prima che la scena in overlay venga rimossa dalla composizione. (I29a72, b/440558061)
  • SceneStrategy ha separato la funzione di decorazione in un nuovo SceneDecoratorStrategy. Questa nuova interfaccia è quella che deve essere utilizzata per decorare le scene. Sono disponibili nuove API per NavDisplay e rememberSceneState per consentire l'aggiunta di SceneDecoratorStrategies. (If9385, b/477669607, b/477670333)

Correzioni di bug

  • Risolto un errore per cui il passaggio di un SharedTransitionLayout a NavDisplay o rememberSceneState e l'utilizzo di qualsiasi OverlayScene causava un arresto anomalo perché l'utilizzo di SharedTransitionLayout funziona solo con NavEntries di cui viene eseguito il rendering come parte di AnimatedContent e il rendering di OverlayScene viene eseguito separatamente nelle rispettive finestre. (I1bb76, b/478664101)

Aggiornamento delle dipendenze

  • Da Navigation3 1.0.1: Navigation3 ora dipende da NavigationEvent 1.0.2. In questo modo viene risolto un IllegalStateException causato dall'utilizzo di NavDisplay durante le anteprime di AndroidStudio. (Id7212, b/477149762)

Versione 1.1.0-alpha03

28 gennaio 2026

androidx.navigation3:navigation3-*:1.1.0-alpha03 è stato rilasciato. La versione 1.1.0-alpha03 contiene questi commit.

Nuove funzionalità

  • Ora puoi aggiungere dinamicamente i metadati tenendo conto della chiave di immissione tramite il DSL EntryProvider. (I942fb, b/474416976)

Versione 1.1.0-alpha02

14 gennaio 2026

androidx.navigation3:navigation3-*:1.1.0-alpha02 è stato rilasciato. La versione 1.1.0-alpha02 contiene questi commit.

Nuove funzionalità

  • SceneStrategy ora supporta l'annidamento delle scene tramite una nuova funzione calculatedScene(Scene). Ciò significa che i SceneStrategy possono essere personalizzati per fornire funzionalità aggiuntive ad altre scene. (I5df7c,b/440333896)

Versione 1.1.0-alpha01

3 dicembre 2025

androidx.navigation3:navigation3-*:1.1.0-alpha01 è stato rilasciato. La versione 1.1.0-alpha01 contiene questi commit.

Modifiche alle API

  • Navigation3 ora supporta il trattamento delle scene come oggetti di elementi condivisi. Ciò significa che, quando le scene cambiano, è possibile garantire una transizione fluida. Puoi attivare questa funzionalità passando un SharedTransitionScope a NavDisplay o a rememberSceneState. (I15868)

Versione 1.0

Versione 1.0.1

11 febbraio 2026

androidx.navigation3:navigation3-*:1.0.1 è stato rilasciato. La versione 1.0.1 contiene questi commit.

Aggiornamento delle dipendenze

  • Navigation3 ora dipende da NavigationEvent 1.0.2. In questo modo viene risolto un IllegalStateException causato dall'utilizzo di NavDisplay durante le anteprime di AndroidStudio. (Id7212, b/477149762)

Versione 1.0.0

19 novembre 2025

androidx.navigation3:navigation3-*:1.0.0 è stato rilasciato. La versione 1.0.0 contiene questi commit.

Introducing Navigation3!

  • La libreria Navigation3 è ora stabile. Navigation3 è l'approccio incentrato su AndroidX Compose alla navigazione.
  • Per saperne di più, consulta il nostro blog post di annuncio, visita le risorse e prova le ricette.

Versione 1.0.0-rc01

5 novembre 2025

androidx.navigation3:navigation3-*:1.0.0-rc01 è stato rilasciato. La versione 1.0.0-rc01 contiene questi commit.

Correzioni di bug

  • NavDisplay ora imposta un LocalLifecycleOwner a livello di Scene che consente agli autori delle scene di determinare se tutte le transizioni sono terminate controllando che Lifecycle.State sia RESUMED. Il comportamento di LocalLifecycleOwner a livello di NavEntry rimane invariato: rimane limitato a STARTED se è in corso una transizione ed è inoltre limitato a CREATED se NavEntry è stato rimosso dal back stack ed è in fase di animazione in uscita. (I03113, b/454045829)

Versione 1.0.0-beta01

22 ottobre 2025

androidx.navigation3:navigation3-*:1.0.0-beta01 è stato rilasciato. La versione 1.0.0-beta01 contiene questi commit.

Modifiche alle API

  • SceneStrategyScope ora ha solo un costruttore pubblico senza argomenti, adatto per testare SceneStrategy e Scene restituito in isolamento. Per casi d'uso più complessi, utilizza rememberSceneState(). (I8440c, b/451679047)

Correzioni di bug

  • Risolto il loop infinito durante il concatenamento di SceneStrategy con then. (Iba3f0, b/450323470)
  • È stato corretto lo sfarfallio dello schermo durante lo scambio di backStack passato a NavDisplay e l'utilizzo di animazioni. (Ief7b5, b/450967248)

Versione 1.0.0-alpha11

8 ottobre 2025

androidx.navigation3:navigation3-*:1.0.0-alpha11 è stato rilasciato. La versione 1.0.0-alpha11 contiene questi commit.

Modifiche alle API

  • Il metodo calculateScene su SceneStrategy non è più @Composable. Valuta invece la possibilità di spostare questo lavoro nella costruzione del metodo SceneStrategy (ovvero in un metodo rememberMySceneStrategy()) che ti consente di definire completamente la durata di qualsiasi valore rememberSaveable o istruzione remember chiave in base ai valori corretti. (If1733, b/448709506)
  • Il parametro onBack per SceneStrategy.calculateScene è stato spostato nel nuovo ambito del ricevitore di SceneStrategyScope per chiarire che si tratta di un parametro facoltativo e fornire un punto di estensione per le future funzionalità di Navigation3. (I3aea3, b/448460407)
  • La funzione lambda onBack passata a NavDisplay e a SceneStrategy non fornisce più un parametro count: Int per indicare quando devono essere rimosse più voci. Invece, la funzione lambda () -> Unit verrà ora chiamata più volte di seguito nel raro caso in cui la scena richieda la rimozione di più voci. (Idedb5, b/446989346)
  • Rimuovi la classe NavEntryWrapper e sostituisci la sua funzionalità con una classe NavEntry finale con un nuovo costruttore secondario che accetta un NavEntry con nuovi contenuti. In questo modo, continuerà a essere supportato il wrapping di una voce con nuovi contenuti. (I7da2a, b/444447130)
  • La funzione navEntryDecorator che crea e restituisce un NavEntryDecorator è stata rimossa e sostituita dalla classe NavEntryDecorator, che ora è resa pubblica e aperta alla sottoclasse. (If81f8, b/444447434, b/447381176)
  • SavedStateNavEntryDecorator è stato rinominato in SaveableStateHolderNavEntryDecorator perché decora le voci con un SaveableStateHolder. Anche il decoratore è stato rifattorizzato da una funzione a una classe, poiché dal punto di vista funzionale è una factory per NavEntryDecorator. (Ie6013, b/447381176)
  • I display personalizzati che utilizzano SceneState come alternativa all'utilizzo di NavDisplay non devono più utilizzare la composizione locale LocalEntriesToRenderInCurrentScene, che ora è interna. (Ic40ef, b/414668196)
  • SceneSetupNavEntryDecorator e rememberSceneSetupNavEntryDecorator() sono stati rimossi dalla superficie dell'API pubblica. Questa funzionalità è ora inclusa per impostazione predefinita senza che tu debba includerla manualmente. (Ieae42, b/444479133)
  • NavEntry, DialogScene, SinglePaneScene e SceneState ora implementano tutti equals. (I96121)
  • L'interfaccia Scene ha un nuovo campo dei metadati per allegare metadati specifici della scena per NavDisplay. In questo modo, una scena può eseguire l'override dei metadati su NavDisplay, ad esempio con le transizioni. (I1fd96, b/443955625)
  • Semplifica la firma rememberNavBackStack rimuovendo il parametro di tipo generico ridondante. La funzione ora accetta vararg elements: NavKey. (I03e45)
  • Le animazioni predefinite per NavDisplay ora fanno parte dell'API comune, il che consente di chiamarle da tutte le piattaforme. (I71af9, b/447147159)
  • Rinomina EntryProviderBuilder in EntryProviderScope per riflettere con precisione che la classe è un DSL Kotlin che fornisce un ambito per creare NavEntries. (Ia7465)

Correzioni di bug

  • rememberNavBackStack() ora applica la serializzazione polimorfica per NavKey e richiede un SavedStateConfiguration personalizzato configurato per garantire il corretto ripristino dello stato. KDoc è stato aggiornato per riflettere il requisito che tutti i sottotipi NavKey devono essere registrati nel SerializersModule fornito. (I6de37,I782f2, b/446664383)

Versione 1.0.0-alpha10

24 settembre 2025

androidx.navigation3:navigation3-*:1.0.0-alpha10 è stato rilasciato. La versione 1.0.0-alpha10 contiene questi commit.

Modifiche alle API

  • Aggiungi un nuovo overload NavDisplay che accetta un elenco di NavEntry<T> decorato da rememberDecoratedNavEntries. (I4025b, b/441940314)
  • DialogScene è stato spostato in un nuovo pacchetto. (Ia5840)
  • Rimuovi l'API pubblica DecorateNavEntry. Utilizza invece rememberDecoratedNavEntries per aggregare un NavEntry con un elenco di decoratori. (Id8c09)
  • La UI di Navigation3 ora fornisce nuove proprietà transitionSpec predefinite. (Ibcabd)
  • È stato aggiunto un nuovo oggetto SceneState per facilitare la gestione delle scene. Inoltre, fornisce un nuovo overload NavDisplay che accetta SceneState e NavigationEventState. (Idfb46, b/444479133)
  • NavDisplay ora ti consente di personalizzare le transizioni in base alla Scene di destinazione e di partenza esaminando currentState e targetState di Transition. (I906cc, b/443872322)
  • NavigationEventInfo ora è un abstract class anziché un interface. Aggiorna tutte le implementazioni personalizzate in modo che ereditino dalla classe (ad es. data class MyInfo : NavigationEventInfo()). (I1e59c, b/444734264)
  • Le API del gestore navigationevent-compose sono state aggiornate. NavigationEventHandler e NavigationBackHandler (e varianti) ora supportano un nuovo overload che accetta un NavigationEventState con hoisting. I semplici overload (che accettano currentInfo) vengono conservati e ora utilizzano questo nuovo modello di stato internamente. (Ic3251, b/444734264)
  • Tutte le API Scene sono state spostate da navigation3-ui a navigation3-runtime. Ciò significa che ora sono disponibili su tutte le piattaforme supportate da navigation3-runtime. (I431d0, b/444449993)
  • È stato aggiunto un nuovo overload rememberDecoratedNavEntries che accetta un elenco di NavEntry da decorare. Le voci di input possono essere già decorate con altri decoratori di voci. (I5a034, b/444230270)
  • Rimuovi i parametri di tipo carattere jolly navigation3 (I02540)
  • Migliorata la gestione dei generici per il DSL entryProvider. Se in precedenza importavi androidx.navigation3.runtime.entry, non è più necessario. (I299fc)
  • Limita l'overload di NavBackStackSerializer basato sulla riflessione ad Android. In questo modo, si evitano errori di serializzazione impliciti in fase di runtime su piattaforme non Android, applicando l'uso dell'overload esplicito di SavedStateConfiguration nel codice multipiattaforma. (I73313, b/420443609)
  • È stato reso swipeEdge di NavigationEvent un @IntDef (Icee54, b/443950342)
  • Limita la serializzazione di NavBackStack ad Android. In questo modo si evitano errori di runtime su piattaforme non Android. Per il salvataggio dello stato multipiattaforma, utilizza l'overload rememberNavBackStack con un SavedStateConfiguration esplicito. (I1e418, b/420443609)

Correzioni di bug

  • Risolto un arresto anomalo durante l'Indietro predittivo quando l'elemento NavDisplay nidificato ha una singola voce secondaria. (I2cdc0, b/441933162)

Versione 1.0.0-alpha09

10 settembre 2025

androidx.navigation3:navigation3-*:1.0.0-alpha09 è stato rilasciato. La versione 1.0.0-alpha09 contiene questi commit.

Modifiche alle API

  • DecoratedNavEntryProvider è stato sostituito con rememberDecoratedNavEntries, che crea e restituisce NavEntries decorate con l'elenco di decoratori forniti (I0fe1c, b/441328236)
  • NavBackStack è ora generico rispetto al tipo NavKey. In questo modo, le app e le librerie possono definire tipi di chiavi personalizzati per i propri back stack, anziché essere limitate a NavKey. (I4d190,Iad2f4, b/420443609)
  • NavBackStack è ora @kotlinx.serialization.Serializable, il che consente di salvare e ripristinare lo stato di navigazione in caso di interruzione del processo e modifiche alla configurazione senza codice boilerplate aggiuntivo. (I2c3cf, b/420443609)
  • RememberNavBackStack è stato spostato in commonMain per garantire che venga fornito su tutte le piattaforme di destinazione. (Id69e7, b/420443609)

Correzioni di bug

  • NavDisplay ora sposta correttamente ogni singolo NavEntry nel Lifecycle.State corretto. (I30aac, b/440145700)
  • Risolto un problema per cui NavDisplay ignorava qualsiasi NavigationEventDispatcherOwner nidificato impostato tramite LocalNavigationEventDispatcherOwner della libreria NavigationEvent. (I6224a)

Modifiche alle dipendenze

Versione 1.0.0-alpha08

27 agosto 2025

androidx.navigation3:navigation3-*:1.0.0-alpha08 è stato rilasciato. La versione 1.0.0-alpha08 contiene questi commit.

Nuove funzionalità

  • Sono stati aggiunti nuovi target Kotlin Multiplatform (KMP) agli artefatti Navigation3 Runtime. Navigation3 Runtime ora supporta le seguenti piattaforme in totale: JVM (Android e computer), Native (Linux, iOS, watchOS, macOS, MinGW) e Web (JavaScript, WasmJS). (I55078, b/424410398, b/419294028, b/419046226). Nota: questa operazione non fornisce target KMP per l'artefatto Navigation3 UI. Su altre piattaforme, dovrai implementare il tuo NavDisplay personalizzato. Se vuoi che venga supportato, vota il problema di Jetbrains qui e monitora i progressi per ricevere ulteriore assistenza.
  • L'oggetto NavDisplayInfo è ora pubblico e può essere utilizzato per recuperare l'elenco delle voci visibili da NavDisplay. (Ibc91f)

Modifiche alle API

  • È stato aggiunto un nuovo NavBackStackSerializer da utilizzare insieme a rememberNavBackStack per eseguire il ripristino dello stato. rememberNavBackStack() ora accetta anche un SavedStateConfiguration che può essere utilizzato per fornire la tua configurazione. (I2f4d2, I4cd58, b/420443609)

Correzioni di bug

Problemi noti

  • È stato introdotto un bug da I8bf6d che ha causato la basazione dei cicli di vita sulle scene anziché sulle singole voci, il che ha interrotto il ciclo di vita per tutti i casi in cui il key fornito al NavEntry non è un String o il tuo NavEntry non ha eseguito l'override del contentKey e lo ha impostato in modo che sia uguale al key (tieni presente che in questo modo viene applicato il salvataggio della chiave in un Bundle). Questo problema è stato risolto per la prossima release. (b/440145700)

Versione 1.0.0-alpha07

13 agosto 2025

androidx.navigation3:navigation3-*:1.0.0-alpha07 è stato rilasciato. La versione 1.0.0-alpha07 contiene questi commit.

Aggiornamento di MinSdk

Modifiche alle API

  • SavedStateNavEntryDecorator ora utilizza SaveableStateRegistry integrato in SaveableStateProvider per salvare e ripristinare gli stati. (If8d9a)
  • predictivePopTransitionSpec ora riceve il bordo di scorrimento come parametro, consentendoti di personalizzare la transizione in base al bordo da cui l'utente ha avviato il gesto Indietro predittivo. (I753a8)

Correzioni di bug

  • Risolto un problema che causava il ricalcolo infinito delle scene personalizzate perché la scena più recente non veniva memorizzata. (I7ba84, b/418153031)

Aggiornamento delle dipendenze

Versione 1.0.0-alpha06

30 luglio 2025

androidx.navigation3:navigation3-*:1.0.0-alpha06 è stato rilasciato. La versione 1.0.0-alpha06 contiene questi commit.

Aggiornamento delle dipendenze

Versione 1.0.0-alpha05

2 luglio 2025

androidx.navigation3:navigation3-*:1.0.0-alpha05 è stato rilasciato. La versione 1.0.0-alpha05 contiene questi commit.

Modifiche del comportamento

  • Lo stato di NavEntry ora si basa rigorosamente sull'elenco corrente di decoratori passati a NavDisplay. Ciò significa che i decoratori devono essere scambiati lungo i back stack nel caso di più back stack per preservare lo stato delle NavEntry nel back stack. In caso contrario, gli stati verranno cancellati come se le voci fossero state rimosse (anziché scambiate). (I7a759, b/428033667)

Versione 1.0.0-alpha04

18 giugno 2025

androidx.navigation3:navigation3-*:1.0.0-alpha04 è stato rilasciato. La versione 1.0.0-alpha04 contiene questi commit.

Modifiche alle API

  • NavEntry.content ora è privato. Per richiamare i contenuti di NavEntry, chiama la nuova API NavEntry.Content() che non richiede più un parametro key per essere richiamata. (Icd0fd, b/420991203)
  • NavEntry.key ora è un campo privato. NavEntry e i relativi stati pertinenti devono essere identificati dal nuovo campo contentKey, generato dalla nuova funzione lambda contentKeyFactory e impostato per impostazione predefinita su un hash salvabile generato da NavEntry.key (I81a6c, b/422001357, b/420991203 I2d7d4, b/420991203, b/422841812)

Modifiche alle dipendenze

  • Navigation3 ora dipende dal nuovo artefatto androidx.navigationevent.compose.

Versione 1.0.0-alpha03

4 giugno 2025

androidx.navigation3:navigation3-*:1.0.0-alpha03 è stato rilasciato. La versione 1.0.0-alpha03 contiene questi commit.

Correzioni di bug

  • Navigation3 non cancellerà più gli stati del decoratore per backStacks che sono stati scambiati e sostituiti con un'altra istanza backStack. (I28a42, b/415076044)

Versione 1.0.0-alpha02

23 maggio 2025

androidx.navigation3:navigation3-*:1.0.0-alpha02 è stato rilasciato. La versione 1.0.0-alpha02 contiene questi commit.

Correzioni di bug

  • Risolto un problema relativo a SavedStateNavEntryDecorator che causava collisioni per classi di dati diverse con gli stessi valori delle proprietà. (b/418070648, Iff4775)
  • Risolto un problema relativo a una classe mancante che causava arresti anomali durante l'esecuzione senza dichiarare dipendenze esplicite. (b/419049149, I4b4ed)

Versione 1.0.0-alpha01

20 maggio 2025

androidx.navigation3:navigation3-*:1.0.0-alpha01 è stato rilasciato. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

Navigation3 è una nuova libreria di navigazione creata appositamente per gestire la navigazione in-app di Jetpack Compose. L'artefatto androidx.navigation3.runtime fornisce i componenti di base, mentre l'artefatto androidx.navigation3.ui fornisce il livello UI tramite l'API NavDisplay. Gli sviluppatori possono fornire il proprio stato direttamente alla funzione componibile NavDisplay, che modifica i contenuti in base alle modifiche apportate allo stato dello sviluppatore.

@Serialiable object Home : NavKey
@Serialiable object Chat : NavKey

val backStack = rememberNavBackStack(Home)

NavDisplay(backStack, entryProvider = entryProvider {
  entry<Home> {
    Column {
      Text(“Home”)
      Button(onClick = { backStack.add(Chat) } ) {
        Text(“Go to Chat”)
      } 
    }
  }
  entry<Chat> { /* My Composable Content */ }
})

Per saperne di più, consulta la guida di Navigation3.