navigation3
| 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.
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
NavEntrycondiviso 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
SceneInfoha aggiunto le proprietàtitleeurl, che vengono compilate automaticamente dagli ultimi metadatiNavEntry'sdella scena. UtilizzaTitleMetadataKeyeUrlMetadataKeyper 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
NavDisplayeseguendo la migrazione aDeferredAnimatedContente risolvendo i problemi di handoff della transizione. I145eaedd b/430807423DeferredAnimatedContentutilizzaDeferredTransitionper separare le transizioni in una fase differita (tramitedefer), che applica trasformazioni manuali durante un gesto di scorrimento, e una fase automatica (tramiteanimateTo), 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).
Navigation3 Versione 1.2
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 Compose1.10, che non richiedecompileSdk37.
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
NavEntriesutilizzandoResultEventBusfornito daLocalResultEventBuseResultEventBusNavEntryDecorator. - È stato aggiunto
rememberResultEventBusper supportare l'hoisting di unResultEventBusall'esterno diResultEventBusNavEntryDecoratore il suo passaggio arememberResultEventBusNavEntryDecorator. - È possibile accedere ai risultati passati come stato con
ResultEventBus#conflateAsStateo raccoglierli come flusso di risultati conResultEffect.
API Deep Link
Navigation3 ora supporta i deep link Kotlin Multiplatform (KMP) in androidx.navigation3.runtime.deeplink tramite DeepLinkRequest, DeepLinkUri e DeepLinkMatcher.
DeepLinkRequesteRequestExtras: rappresentano una richiesta di deep link creata da unDeepLinkUri, una stringa URI o unIntentAndroid. È possibile allegare metadati di richiesta aggiuntivi utilizzando il containerRequestExtrascon sicurezza dei tipi creato con il DSLrequestExtraseRequestExtrasKey<T>.DeepLinkMatcher: rappresenta un deep link che può essere associato a unDeepLinkRequest. 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 aDeepLinkMatcher.matchrestituirà unMatchResultche contiene la chiave di navigazione associata se la corrispondenza ha esito positivo. Esistono due implementazioni predefinite diDeepLinkMatcher:UriDeepLinkMatcherper la corrispondenza dei deep link in base aUrieStaticKeyDeepLinkMatcherper la corrispondenza dei deep link con soloDeepLinkMatcher.Filterche corrispondono a un valore booleano.BackStackMatcher: unDeepLinkMatcherper creare un back stack sintetico in caso di corrispondenza corretta del deep link.BackStackMatcherpuò essere creato tramite la funzione di estensioneDeepLinkMatcher.withBackStack.
Gestione di Indietro predittivo
- Sono stati aggiunti
NavigationBackHandlererememberNavigationEventStateper semplificare la connessione diSceneStatecon la gestione del gesto Indietro predittivo (onBackCompletedeonBackCancelled). 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.contentKeyora viene impostato per impostazione predefinita su un composto dikey.toString()ekey::class.toString(), impedendo collisioni di chiavi tra le chiavidata objectche condividono lo stesso nome semplice in interfacce diverse.EntryProviderora 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
Scenesianodata classo implementinoequalsehashCode.
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.extrasdaMap<String, Any>a una nuova classe di tipo mappa sicuraRequestExtrasche memorizza coppie diRequestExtrasKey<T>inT. È possibile creare un'istanza diRequestExtrascon il DSLrequestExtras. (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
Scenesiano classi di dati o implementino equals e hashcode per garantire che venga utilizzato lo stessoScenequando appropriato. (Ibdf0d, b/542316099) NavEntry.contentKeyora viene impostato per impostazione predefinita su una combinazione dikey.toString()ekey::class.toString(). In questo modo, gli oggetti dati che condividono lo stesso nome, ma implementano interfacce diverse, non avranno più lo stessocontentKey. Tuttavia,key::classdella piattaforma JS restituisce solo il nome della classe semplice anziché il nome completo, quindi la piattaforma JS deve comunque implementarecontentKeypersonalizzati per gli oggetti dati con nomi duplicati. (I1fbbb, b/512534342)- Risolto il problema
IllegalArgumentExceptiongenerato daSaveableStateProviderper 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
WrappedMatchResultastratta per aggregare un'altra classeDeepLinkMatcher.MatchResult. In questo modo, i risultati di corrispondenza personalizzati vengono sovrapposti a un altro. (I7d4dc, b/470282247) È stata aggiunta una nuova classe
BackStackMatcherche 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,BackStackMatcherrestituisce unBackStackMatchResultche estendeWrappedMatchResultcontenente il risultato della corrispondenza originale insieme al back stack creato con la funzione lambda.BackStackMatcherpuò essere creato solo con la nuova funzione di estensioneDeepLinkMatcher.withBackStack. (Ibf987, b/470282247)È stata aggiunta una classe
DeepLinkSerializerastratta che estendeKSerializerper codificare e decodificarevalue : TcomeString.DeepLinkSerializerpuò essere utilizzato per serializzare argomenti di deep link non primitivi. Compatibile conrememberSaveableerememberNavBackStack. (Id3c9f, b/470282247)DeepLinkMatcherha aggiunto un secondo parametro di tipoout R : DeepLinkMatcher.MatchResult<T>in modo che gli sviluppatori possano accedere alle proprietà della sottoclasseMatchResultrestituita daDeepLinkMatcher.match()senza eseguire il type casting. (I693d3, b/470282247)Il limite superiore di T
DeepLinkMatcher.MatchResult'sè stato modificato daAny?aAny. (I6bf1a)Il campo del costruttore
DeepLinkRequesturiora è nullo per impostazione predefinita. Il costruttore secondariouriStringè stato rinominato inuri. (Ia0f14, b/522194187)
Correzioni di bug
ResultEffectora utilizzarememberUpdatedStateper acquisire l'ultima lambdaonResult. (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) EntryProviderora dà la priorità alla corrispondenza in base alle istanze delle chiavi rispetto ai tipi di chiavi. (Ib5ec9, b/533331924)SceneStateora 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
UriDeepLinkMatchersui 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
UriDeepLinkMatchernon corrispondeva a una richiesta se il pattern URI non conteneva uno schema o non iniziava con una doppia barra. Ad esempio,www.example.com/homeora corrisponderà ahttp://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
rememberResultEventBusche restituisce unResultEventBusche può essere passato arememberResultEventBusNavEntryDecorator. In questo modo è possibile eseguire l'hoisting di unResultEventBusall'esterno diResultEventBusNavEntryDecorator. (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
extrasaggiuntivo per unMap<String, Any>per allegare informazioni aggiuntive sulla richiesta. (If81d5, b/513200887) - È stato aggiunto un nuovo DSL
requestExtrascome modo con sicurezza dei tipi per creare una mappa di extra. Il DSL fornisce una funzioneputper archiviare coppie diRequestExtrasKeyinAny. La funzione di estensioneMap<String, Any>.get(key)può essere utilizzata per leggere dalla mappa con unRequestExtrasKey(I5091c, b/513200887) - (Solo Android) Sono state aggiunte una funzione
ActionExtrasKeye una funzioneactionExtraper creare una mappa di extra conActionExtrasKey. (Id0c90, [b/513200887] - È stata aggiunta una funzione
MimeTypeExtrasKeyemimeTypeExtraper creare una mappa di extra conMimeTypeExtrasKey. (I85131, b/513200887)
DeepLinkMatcher
- Sono state aggiunte le funzioni
DeepLinkMatcher.mimeTypeFiltereDeepLinkMatcher.actionFilterper creareDeepLinkMatcher.Filtersche filtranoDeepLinkRequestpermimeTypeoaction(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 campoDeepLinkRequest.extras.(Id0c90, b/513200887) fromMimeTypefunzione di fabbrica rimossa. Per creare una richiesta associata a un mimeType, utilizza il nuovo campoDeepLinkRequest.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
fromUriefromUriString. Sostituito da nuovi costruttori che accettano unDeepLinkUrio un URI di stringa non elaborata. (Id5b6f, b/522194187) DeepLinkMatcher,DeepLinkMatcher.MatchResulte 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
UriMatchResultper la mappa degli argomenti ora viene impostato per impostazione predefinita su una mappa vuota. (I3acdd) - La classe astratta
DeepLinkMatcher.Filterora è un'interfaccia funzionale. Il campo del costruttorefilterviene 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
UriDeepLinkMatcherin modo che restituisca un valoreUriMatchResultnull anziché generareMissingFieldExceptionquando mancano gli argomenti obbligatori durante la corrispondenza. (I5322f, b/524663005) - Un
UriDeeplinkMatchercontenente un URI con schema HTTPS può essere associato solo a richieste che hanno anche lo schema HTTPS. (Ibfe22, b/522304329) - Correzione di
UriDeepLinkMatcherper identificare correttamente lo schemahttpcome corrispondenza positiva conhttpsquando si associa unDeepLinkRequesta unUriDeepLinkMatcher. (I3a62b, b/518804264) - Il comparatore
DeepLinkMatcher.MatchResultora restituisce 0 per impostazione predefinita quando due risultati sono uguali. (I48ddb, b/518841353) UriDeepLinkMatcherora restituirà un valoreUriMatchResultnull 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
ModalBottomSheetvenivano 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:
DeepLinkRequestun deep link richiesto contenente unDeepLinkUrie un mimeType o un'azione facoltativi (solo Android). Insieme alla nuova classe sono disponibili funzioni companion per creare un'istanza con unuri, unmimeTypeo unaction. 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" )DeepLinkMatcherrappresenta un deep link che può essere associato a unDeepLinkRequest. 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 aDeepLinkMatcher.matchrestituirà unMatchResultche contiene la chiave di navigazione associata se la corrispondenza ha esito positivo. Esistono due implementazioni predefinite diDeepLinkMatcher:UriDeepLinkMatcherper la corrispondenza dei deep link in base all'URI eStaticKeyDeepLinkMatcherper la corrispondenza dei deep link solo conDeepLinkMatcher.Filterche corrispondono a unBoolean. (I3798e, b/470282247)UriDeepLinkMatcherun'implementazione diDeepLinkMatcherche gestisce il deep link associandoDeepLinkUria 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 diandroid.net.Uri(Id4725, b/470282247)
Modifiche alle API
- Aggiornato a
compileSdk 37per corrispondere a compileSdk di Compose
Correzioni di bug
- Risolto il problema relativo a
IllegalArgumentExceptiondiAnimatedBottomSheetSampledurante la visualizzazione di più overlay. L'esempioSceneStrategyora calcolerà correttamente l'ultimo non-OverlayScenee lo mostrerà in tutte le scene in overlay. (If2281, b/506733412) - È stato eseguito l'upgrade della dipendenza
NavigationEventalla 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
onBackinonBackCompletede aggiungionBackCancelleda NavigationBackHandler per supportare la gestione dei gesti Indietro annullati. (I92741) - Aggiungi
NavigationBackHandlerper semplificare la gestione dei gesti Indietro e della funzionalità Indietro predittivo quando utilizziSceneState. 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
rememberNavigationEventStateper semplificare la connessioneSceneStatecon la gestione della funzionalità Indietro predittivo. (Iae49c)
Nuove funzionalità
- È stata aggiunta un'API
ResultEventBusper consentire il passaggio dei risultati tra NavEntries conLocalResultEventBusfornito dal nuovoResultEventBusNavEntryDecorator. I risultati trasmessi possono essere valutati come uno stato conResultEventBus#conflateAsStateo come un flusso di risultati conResultEffect.
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
LocalNavAnimatedContentScopeda unOverlayScenenon causerà più unIllegalStateException, poichéOverlayScenesora è dotato di unLocalAnimatedContentScopeno-op. (I2f00c, b/486067688)
Versione 1.1 di Navigation3
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.contentKeyora viene impostato per impostazione predefinita su una combinazione dikey.toString()ekey::class.toString(). In questo modo, gli oggetti dati che condividono lo stesso nome, ma implementano interfacce diverse, non avranno più lo stessocontentKey. Tuttavia,key::classdella piattaforma JS restituisce solo il nome della classe semplice anziché il nome completo, quindi la piattaforma JS deve comunque implementarecontentKeypersonalizzati per gli oggetti dati con nomi duplicati. (I1fbbb, b/512534342)- Risolto il problema relativo all'eccezione
IllegalArgumentExceptiongenerata daSaveableStateHolderper 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
entryProviderora dà la priorità aNavEntrycreato con un'istanza di chiave, ad esempioentry(key = userKey) { ... }rispetto aNavEntrycreato con una classe di chiave comeentry<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
ModalBottomSheetvenivano rianimati in modo imprevisto quando gli overlay sopra venivano visualizzati. (Ia2b9e, b/502624496)È stata eseguita la migrazione della dipendenza
NavigationEventalla versione 1.1.2, che ha rimosso l'operazione no-opNavigationEventHandlerin 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
NavigationEventalla versione 1.1.1, che ha rimosso l'operazione no-opNavigationEventHandlerin 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
LocalNavAnimatedContentScopeda unOverlayScenenon causerà più unIllegalStateException, poichéOverlayScenesora è dotato di unLocalAnimatedContentScopeno-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
NavDisplayora garantisce che le voci visualizzate sotto gli overlay abbiano il valoreLifecyclelimitato aSTARTED. In questo modo, le API comedropUnlessResumedcontinuano a funzionare quando si utilizzano le finestre di dialogo. (If209f, b/483966071)- Risolto un problema in
NavDisplayper 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
NavDisplayerememberSceneStateora accettano unList<SceneStrategy>anziché il precedente singolo parametroSceneStrategyconcatenato dall'infissothen. Questo approccio è più in linea con ilList<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
NavMetadataKeyspecificato. (Ic30db, b/485311895) - Aggiunto
NavMetadataKeyDialogKeyperDialogSceneStrategyda 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
MetadataKeyche consente di definire i tipi di chiave e valore da fornire alla mappa dei metadati. Inoltre, sono stati aggiunti nuoviNavMetadataKeyper le transizioniNavDisplayin modo che possano essere utilizzati con il nuovo DSLmetadataper aggiungere transizioni aNavDisplay. (Ic10ef, Ic049c,b/476213928)
Modifiche alle API
- L'interfaccia
OverlaySceneha un nuovo callback di sospensioneonRemoved. 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 dionRemovedpossono essere completate prima che la scena in overlay venga rimossa dalla composizione. (I29a72, b/440558061) SceneStrategyha separato la funzione di decorazione in un nuovoSceneDecoratorStrategy. Questa nuova interfaccia è quella che deve essere utilizzata per decorare le scene. Sono disponibili nuove API perNavDisplayerememberSceneStateper consentire l'aggiunta diSceneDecoratorStrategies. (If9385, b/477669607, b/477670333)
Correzioni di bug
- Risolto un errore per cui il passaggio di un
SharedTransitionLayoutaNavDisplayorememberSceneStatee l'utilizzo di qualsiasiOverlayScenecausava un arresto anomalo perché l'utilizzo diSharedTransitionLayoutfunziona solo conNavEntriesdi cui viene eseguito il rendering come parte diAnimatedContente il rendering diOverlaySceneviene eseguito separatamente nelle rispettive finestre. (I1bb76, b/478664101)
Aggiornamento delle dipendenze
- Da
Navigation31.0.1:Navigation3ora dipende daNavigationEvent1.0.2. In questo modo viene risolto unIllegalStateExceptioncausato dall'utilizzo diNavDisplaydurante le anteprime diAndroidStudio. (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à
SceneStrategyora supporta l'annidamento delle scene tramite una nuova funzionecalculatedScene(Scene). Ciò significa che iSceneStrategypossono 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
Navigation3ora 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 unSharedTransitionScopeaNavDisplayo arememberSceneState. (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
Navigation3ora dipende daNavigationEvent1.0.2. In questo modo viene risolto unIllegalStateExceptioncausato dall'utilizzo diNavDisplaydurante le anteprime diAndroidStudio. (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
NavDisplayora imposta unLocalLifecycleOwnera livello diSceneche consente agli autori delle scene di determinare se tutte le transizioni sono terminate controllando cheLifecycle.StatesiaRESUMED. Il comportamento diLocalLifecycleOwnera livello diNavEntryrimane invariato: rimane limitato aSTARTEDse è in corso una transizione ed è inoltre limitato aCREATEDseNavEntryè 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
SceneStrategyScopeora ha solo un costruttore pubblico senza argomenti, adatto per testareSceneStrategyeScenerestituito in isolamento. Per casi d'uso più complessi, utilizzarememberSceneState(). (I8440c, b/451679047)
Correzioni di bug
- Risolto il loop infinito durante il concatenamento di
SceneStrategyconthen. (Iba3f0, b/450323470) - È stato corretto lo sfarfallio dello schermo durante lo scambio di
backStackpassato aNavDisplaye 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
calculateScenesuSceneStrategynon è più@Composable. Valuta invece la possibilità di spostare questo lavoro nella costruzione del metodoSceneStrategy(ovvero in un metodorememberMySceneStrategy()) che ti consente di definire completamente la durata di qualsiasi valorerememberSaveableo istruzionerememberchiave in base ai valori corretti. (If1733, b/448709506) - Il parametro
onBackperSceneStrategy.calculateSceneè stato spostato nel nuovo ambito del ricevitore diSceneStrategyScopeper 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
onBackpassata aNavDisplaye aSceneStrategynon fornisce più un parametrocount: Intper indicare quando devono essere rimosse più voci. Invece, la funzione lambda() -> Unitverrà 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
NavEntryWrappere sostituisci la sua funzionalità con una classeNavEntryfinale con un nuovo costruttore secondario che accetta unNavEntrycon nuovi contenuti. In questo modo, continuerà a essere supportato il wrapping di una voce con nuovi contenuti. (I7da2a, b/444447130) - La funzione
navEntryDecoratorche crea e restituisce unNavEntryDecoratorè stata rimossa e sostituita dalla classeNavEntryDecorator, che ora è resa pubblica e aperta alla sottoclasse. (If81f8, b/444447434, b/447381176) SavedStateNavEntryDecoratorè stato rinominato inSaveableStateHolderNavEntryDecoratorperché decora le voci con unSaveableStateHolder. Anche il decoratore è stato rifattorizzato da una funzione a una classe, poiché dal punto di vista funzionale è una factory perNavEntryDecorator. (Ie6013, b/447381176)- I display personalizzati che utilizzano
SceneStatecome alternativa all'utilizzo diNavDisplaynon devono più utilizzare la composizione localeLocalEntriesToRenderInCurrentScene, che ora è interna. (Ic40ef, b/414668196) SceneSetupNavEntryDecoratorerememberSceneSetupNavEntryDecorator()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,SinglePaneSceneeSceneStateora 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
rememberNavBackStackrimuovendo il parametro di tipo generico ridondante. La funzione ora accettavararg elements: NavKey. (I03e45) - Le animazioni predefinite per
NavDisplayora fanno parte dell'API comune, il che consente di chiamarle da tutte le piattaforme. (I71af9, b/447147159) - Rinomina
EntryProviderBuilderinEntryProviderScopeper riflettere con precisione che la classe è un DSL Kotlin che fornisce un ambito per creareNavEntries. (Ia7465)
Correzioni di bug
rememberNavBackStack()ora applica la serializzazione polimorfica per NavKey e richiede unSavedStateConfigurationpersonalizzato 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
NavDisplayche accetta un elenco diNavEntry<T>decorato darememberDecoratedNavEntries. (I4025b, b/441940314) DialogSceneè stato spostato in un nuovo pacchetto. (Ia5840)- Rimuovi l'API pubblica
DecorateNavEntry. Utilizza invecerememberDecoratedNavEntriesper aggregare un NavEntry con un elenco di decoratori. (Id8c09) - La UI di Navigation3 ora fornisce nuove proprietà
transitionSpecpredefinite. (Ibcabd) - È stato aggiunto un nuovo oggetto
SceneStateper facilitare la gestione delle scene. Inoltre, fornisce un nuovo overloadNavDisplayche accettaSceneStateeNavigationEventState. (Idfb46, b/444479133) NavDisplayora ti consente di personalizzare le transizioni in base allaScenedi destinazione e di partenza esaminandocurrentStateetargetStatediTransition. (I906cc, b/443872322)NavigationEventInfoora è unabstract classanziché uninterface. 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-composesono state aggiornate.NavigationEventHandlereNavigationBackHandler(e varianti) ora supportano un nuovo overload che accetta unNavigationEventStatecon hoisting. I semplici overload (che accettanocurrentInfo) 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
rememberDecoratedNavEntriesche accetta un elenco diNavEntryda 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 importaviandroidx.navigation3.runtime.entry, non è più necessario. (I299fc) - Limita l'overload di
NavBackStackSerializerbasato 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 diSavedStateConfigurationnel codice multipiattaforma. (I73313, b/420443609) - È stato reso
swipeEdgediNavigationEventun@IntDef(Icee54, b/443950342) - Limita la serializzazione di
NavBackStackad Android. In questo modo si evitano errori di runtime su piattaforme non Android. Per il salvataggio dello stato multipiattaforma, utilizza l'overloadrememberNavBackStackcon unSavedStateConfigurationesplicito. (I1e418, b/420443609)
Correzioni di bug
- Risolto un arresto anomalo durante l'Indietro predittivo quando l'elemento
NavDisplaynidificato 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 conrememberDecoratedNavEntries, che crea e restituisce NavEntries decorate con l'elenco di decoratori forniti (I0fe1c, b/441328236)NavBackStackè ora generico rispetto al tipoNavKey. In questo modo, le app e le librerie possono definire tipi di chiavi personalizzati per i propri back stack, anziché essere limitate aNavKey. (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 incommonMainper garantire che venga fornito su tutte le piattaforme di destinazione. (Id69e7, b/420443609)
Correzioni di bug
NavDisplayora sposta correttamente ogni singoloNavEntrynelLifecycle.Statecorretto. (I30aac, b/440145700)- Risolto un problema per cui
NavDisplayignorava qualsiasiNavigationEventDispatcherOwnernidificato impostato tramiteLocalNavigationEventDispatcherOwnerdella libreriaNavigationEvent. (I6224a)
Modifiche alle dipendenze
- Navigation3 ora dipende da NavigationEvent Alpha08.
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 Runtimeora 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'artefattoNavigation3 UI. Su altre piattaforme, dovrai implementare il tuoNavDisplaypersonalizzato. 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 daNavDisplay. (Ibc91f)
Modifiche alle API
- È stato aggiunto un nuovo
NavBackStackSerializerda utilizzare insieme arememberNavBackStackper eseguire il ripristino dello stato.rememberNavBackStack()ora accetta anche unSavedStateConfigurationche può essere utilizzato per fornire la tua configurazione. (I2f4d2, I4cd58, b/420443609)
Correzioni di bug
- Risolto un problema per cui la navigazione causava l'attivazione di eventi del ciclo di vita errati. (I8bf6d, b/425901162, b/434109022)
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
keyfornito alNavEntrynon è unStringo il tuoNavEntrynon ha eseguito l'override delcontentKeye lo ha impostato in modo che sia uguale alkey(tieni presente che in questo modo viene applicato il salvataggio della chiave in unBundle). 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
- Il valore minSdk predefinito per AndroidX è stato spostato dall'API 21 all'API 23 (Ibdfca, b/380448311, b/435705964, b/435705223)
Modifiche alle API
SavedStateNavEntryDecoratorora utilizzaSaveableStateRegistryintegrato inSaveableStateProviderper salvare e ripristinare gli stati. (If8d9a)predictivePopTransitionSpecora 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
- Navigation3 ora dipende da Navigation Event
1.0.0-alpha06.
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
- Navigation3 ora dipende da Navigation Event
1.0.0-alpha05.
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
NavEntryora si basa rigorosamente sull'elenco corrente di decoratori passati aNavDisplay. 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.contentora è privato. Per richiamare i contenuti diNavEntry, chiama la nuova APINavEntry.Content()che non richiede più un parametrokeyper essere richiamata. (Icd0fd, b/420991203)NavEntry.keyora è un campo privato.NavEntrye i relativi stati pertinenti devono essere identificati dal nuovo campocontentKey, generato dalla nuova funzione lambdacontentKeyFactorye impostato per impostazione predefinita su un hash salvabile generato daNavEntry.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
Navigation3non cancellerà più gli stati del decoratore perbackStacksche sono stati scambiati e sostituiti con un'altra istanzabackStack. (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
SavedStateNavEntryDecoratorche 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.