navigation3
| Son Güncelleme | Kararlı Sürüm | Sürüm Adayı | Beta Sürümü | Alfa Sürümü |
|---|---|---|---|---|
| 4 Kasım 2026 | 1.2.1 | - | - | 1.3.0-alpha04 |
Bağımlılıkları bildirme
Navigation3'e bağımlılık eklemek için projenize Google Maven deposunu eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposu sayfasını okuyun.
Uygulamanız veya modülünüz için build.gradle dosyasında ihtiyacınız olan yapıların bağımlılıklarını ekleyin:
Groovy
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") }
Bağımlılıklar hakkında daha fazla bilgi için Derleme bağımlılıkları ekleme başlıklı makaleyi inceleyin.
Geri bildirim
Geri bildirimleriniz Jetpack'i geliştirmemize yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmek için fikirleriniz varsa bize bildirin. Yeni bir sorun oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir sorun için oy verebilirsiniz.
Daha fazla bilgi için Issue Tracker belgelerine bakın.
Sürüm 1.3
Sürüm 1.3.0-alpha04
4 Kasım 2026
androidx.navigation3:navigation3-*:1.3.0-alpha04 yayınlandı. 1.3.0-alpha04 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
- Paylaşılan
NavEntryöğesinin, pop işlemi tamamlanmadan önce pop ve ardından push işlemi yapıldığında ekranda oluşturulmaması sorunu düzeltildi. (I6a482)
Sürüm 1.3.0-alpha03
21 Ekim 2026
androidx.navigation3:navigation3-*:1.3.0-alpha03 yayınlandı. 1.3.0-alpha03 sürümü bu kayıtları içerir.
1.3.0-alpha02 sürümüne kıyasla değişiklik yok
Sürüm 1.3.0-alpha02
7 Ekim 2026
androidx.navigation3:navigation3-*:1.3.0-alpha02 yayınlandı. 1.3.0-alpha02 sürümü bu kayıtları içerir.
API Değişiklikleri
SceneInfosınıfı, sahnenin sonNavEntry'smeta verilerinden otomatik olarak doldurulantitleveurlözelliklerini ekledi. Girişin meta verilerinde hedef başlıklarını ve URL'lerini tanımlamak içinTitleMetadataKeyveUrlMetadataKeykullanın. (I78a20, b/542693522)
Sürüm 1.3.0-alpha01
23 Eylül 2026
androidx.navigation3:navigation3-*:1.3.0-alpha01 yayınlandı. 1.3.0-alpha01 sürümü bu kayıtları içerir.
Hata Düzeltmeleri
NavDisplayuygulamasında tahmin edilen geri gitme animasyonu geçişi,DeferredAnimatedContentsürümüne geçilerek ve geçiş sorunları çözülerek düzeltildi. I145eaedd b/430807423DeferredAnimatedContent, geçişleri ertelenmiş bir aşamaya (deferaracılığıyla) ve otomatik bir aşamaya (animateToaracılığıyla) ayırmak içinDeferredTransitionkullanır. Ertelenmiş aşamada, kaydırma hareketi sırasında manuel dönüşümler uygulanır. Otomatik aşamada ise kaydırma işlemi tamamlandığında geçiş çalıştırılır.
Bilinen Sorunlar
- Paylaşılan öğeler, geçişler sırasında gelen sahne yerine giden sahnede oluşturulur. (b/582354988)
- Paylaşılan öğeler, ertelenen (hareket) aşamasında arama yapmaz.
Navigation3 1.2 sürümü
Sürüm 1.2.1
4 Kasım 2026
androidx.navigation3:navigation3-*:1.2.1 yayınlandı. 1.2.1 sürümü bu commit'leri içerir.
Değişiklik
compileSdk, 37'den 36'ya düşürüldü. 1.2 sürümü,compileSdk37'yi gerektirmeyen Compose1.10'u kullanır.
Sürüm 1.2.0
23 Eylül 2026
androidx.navigation3:navigation3-*:1.2.0 yayınlandı. 1.2.0 sürümü bu commit'leri içerir.
1.2.0 artık kararlı sürümde.
1.1.0 sürümünden sonra yapılan önemli değişiklikler
Result API
- Bu yeni API,
LocalResultEventBusveResultEventBusNavEntryDecoratortarafından sağlananResultEventBuskullanılarak sonuçlarınNavEntriesarasında aktarılmasına olanak tanır. ResultEventBusöğesininResultEventBusNavEntryDecoratordışında kaldırılmasını verememberResultEventBusNavEntryDecoratoröğesine iletilmesini desteklemek içinrememberResultEventBuseklendi.- İletilen sonuçlara
ResultEventBus#conflateAsStateile durum olarak erişilebilir veyaResultEffectile sonuç akışı olarak toplanabilir.
Deep Link API
Navigation3 artık DeepLinkRequest, DeepLinkUri ve DeepLinkMatcher aracılığıyla androidx.navigation3.runtime.deeplink uygulamasında Kotlin Multiplatform (KMP) derin bağlantılarını destekliyor.
DeepLinkRequestveRequestExtras:DeepLinkUri, URI dizesi veya AndroidIntent'den oluşturulan bir derin bağlantı isteğini temsil eder. Ek istek meta verileri,requestExtrasDSL veRequestExtrasKey<T>ile oluşturulan, tür güvenliRequestExtraskapsayıcısı kullanılarak eklenebilir.DeepLinkMatcher:DeepLinkRequestile eşleştirilebilecek bir derin bağlantıyı temsil eder. Her eşleştirici örneği, bu derin bağlantıyı destekleyen gezinme tuşuyla ilişkilendirilir. Bir gezinme anahtarı birden fazla eşleştiriciyle ilişkilendirilebilir.DeepLinkMatcher.matchçağrıldığında, eşleşme başarılı olursa ilişkili gezinme anahtarını içeren birMatchResultdöndürülür. İki varsayılanDeepLinkMatcheruygulaması vardır:Uritemelinde derin bağlantıları eşleştirmek içinUriDeepLinkMatcherve derin bağlantıları yalnızca bir Boole değeriyle eşleşenDeepLinkMatcher.Filterile eşleştirmek içinStaticKeyDeepLinkMatcher.BackStackMatcher: Başarılı bir derin bağlantı eşleşmesi üzerine yapay bir eski yığın oluşturmak için kullanılanDeepLinkMatcher.BackStackMatcher,DeepLinkMatcher.withBackStackuzantı işlevi aracılığıyla oluşturulabilir.
Tahmin Edilen Geri Gitme İşlemi
SceneState'yi tahmin edilen geri gitme işleme (onBackCompletedveonBackCancelled) ile bağlamayı basitleştirmek içinNavigationBackHandlerverememberNavigationEventStateeklendi. Bu sayede özel kullanıcı arayüzü bileşenleri, eski yığın deltalarını manuel olarak hesaplamadan standart geri gezinme ve tahmin edilen geri gitme hareketlerini destekleyebilir.- İleri animasyonlar sırasında tetiklenen tahmin edilen geri gitme hareketleri desteği de dahil olmak üzere tahmin edilen geri gitme geçişleri iyileştirildi.
Diğer Değişiklikler
NavEntry.contentKeyartık varsayılan olarakkey.toString()vekey::class.toString()bileşimini kullanıyor. Bu sayede, farklı arayüzlerde aynı basit adı paylaşandata objectanahtarları arasında anahtar çakışmaları önleniyor.EntryProviderartık anahtar türleri yerine anahtar örneklere göre eşleştirmeye öncelik veriyor.Sceneuygulamalarınındata classveyaequalsvehashCodeuyguladığından emin olmak için bir lint kontrolü eklendi.
Sürüm 1.2.0-rc01
9 Eylül 2026
androidx.navigation3:navigation3-*:1.2.0-rc01 yayınlandı. 1.2.0-rc01 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
- Derin bağlantı URI kalıplarında yinelenen yer tutucu adlarına izin verilmez. (I8985c, b/522343165)
Sürüm 1.2.0-beta01
26 Ağustos 2026
androidx.navigation3:navigation3-*:1.2.0-beta01 yayınlandı. 1.2.0-beta01 sürümü bu commit'leri içerir.
API Değişiklikleri
DeepLinkRequest.extras,Map<String, Any>yerineRequestExtrasKey<T>ileTçiftlerini depolayan yeni bir tip güvenli harita benzeri sınıf olanRequestExtrasolarak yeniden düzenlendi.RequestExtras,requestExtrasDSL ile örneklendirilebilir. (Ic929d, b/543883369)
Hata Düzeltmeleri
- İleri geçiş sırasında tetiklenen tahmin edilen geri gitme hareketlerinin, kaydırma ilerlemesine yanıt olarak animasyon göstermemesi sorunu düzeltildi. Tahmin edilen geri gitme artık animasyonlu olarak gösterilir ve düzgün bir şekilde tamamlanır. (Icdcb0, b/456218398)
Sceneuygulamalarının veri sınıfları olmasını veya uygun olduğunda aynıSceneöğesinin kullanılmasını sağlamak için equals ve hashcode'u uygulamasını sağlayan bir lint kontrolü eklendi. (Ibdf0d, b/542316099)NavEntry.contentKeyartık varsayılan olarakkey.toString()vekey::class.toString()bileşenlerinden oluşur. Bu sayede, aynı adı paylaşan ancak farklı arayüzler uygulayan veri nesneleri artık aynıcontentKeydeğerine sahip olmaz. Ancak JS platformununkey::classişlevi, tam ad yerine yalnızca basit sınıf adını döndürür. Bu nedenle JS platformu, yinelenen adlara sahip veri nesneleri için özelcontentKeyişlevini uygulamaya devam etmelidir. (I1fbbb, b/512534342)- Birden fazla pop geçişi devam ederken hızlı geri gezinme sırasında kullanılan yinelenen anahtarlar için
SaveableStateProvidertarafından oluşturulanIllegalArgumentExceptiondüzeltildi. (I4d728, b/516312097)
Sürüm 1.2.0-alpha07
29 Temmuz 2026
androidx.navigation3:navigation3-*:1.2.0-alpha07 yayınlandı. 1.2.0-alpha07 sürümü bu kayıtları içerir.
API Değişiklikleri
- Başka bir
DeepLinkMatcher.MatchResultsınıfını sarmalamak için soyut birWrappedMatchResultsınıfı eklendi. Bu sayede, özelleştirilmiş eşleşme sonuçları başka bir eşleşme sonucunun üzerine katman olarak eklenebilir. (I7d4dc, b/470282247) İki parametre alan yeni bir
BackStackMatchersınıfı eklendi: bir eşleştirici örneği ve giriş eşleştiricinin eşleşme sonucunu sağlayan ve bir eski yığın döndüren bir oluşturucu lambda. Eşleşme başarılı olduğundaBackStackMatcher, lambda ile oluşturulan eski yığınla birlikte orijinal eşleşme sonucunu içerenWrappedMatchResult'yi genişleten birBackStackMatchResultdöndürür.BackStackMatcheryalnızca yeniDeepLinkMatcher.withBackStackuzantı işleviyle oluşturulabilir. (Ibf987, b/470282247)value : T'yiStringolarak kodlamak ve kodunu çözmek içinKSerializer'i genişleten soyut birDeepLinkSerializersınıfı eklendi.DeepLinkSerializer, ilkel olmayan derin bağlantı bağımsız değişkenlerini serileştirmek için kullanılabilir.rememberSaveableverememberNavBackStackile uyumludur. (Id3c9f, b/470282247)DeepLinkMatcher, geliştiricilerin tür dönüştürme olmadanDeepLinkMatcher.match()tarafından döndürülen alt sınıfa ayrılmışMatchResultözelliklerine erişebilmesi için ikinci bir tür parametresiout R : DeepLinkMatcher.MatchResult<T>ekledi. (I693d3, b/470282247)DeepLinkMatcher.MatchResult'sT üst sınırıAny?ikenAnyolarak değiştirildi. (I6bf1a)DeepLinkRequestoluşturucu alanıuriartık varsayılan olarak boş bırakılıyor. İkincil oluşturucununuriStringparametresiuriolarak yeniden adlandırıldı. (Ia0f14, b/522194187)
Hata Düzeltmeleri
ResultEffectartık en sononResultlambda'yı yakalamak içinrememberUpdatedStatekullanıyor. (I7d2a3, b/531709234)- Boş yol segmentleri için derin bağlantı eşleşmesi düzeltildi. Bağımsız değişken türü dize ise boş yol, boş dize değeri olarak değerlendirilir. Aksi takdirde, boş yol, değer sağlanmamış olarak değerlendirilir ve varsayılan değere geri döner. Varsayılan değer yoksa eşleştirme başarısız olur. (I56575, b/535298128)
DeepLinkRequest.uriiçinde boş sorgu değerleri için destek eklendi. Bağımsız değişken dize türündeyse boş değer, boş dize olarak değerlendirilir. Aksi takdirde, boş değer, değer sağlanmamış olarak değerlendirilir ve eşleştirme, varsayılan değere geri dönmeye çalışır. Varsayılan değer yoksa eşleştirme başarısız olur. (I30343, b/535127459)EntryProviderartık anahtar türleri yerine anahtar örneklere göre eşleştirmeye öncelik veriyor. (Ib5ec9, b/533331924)SceneStateartık önceki sahneleri, en üstteki yer paylaşımı olmayan sahneden başlayarak doğru şekilde hesaplıyor. (I91915, b/513630541)
Sürüm 1.2.0-alpha06
15 Temmuz 2026
androidx.navigation3:navigation3-*:1.2.0-alpha06 yayınlandı. 1.2.0-alpha06 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
- URI parçalarıyla ilgili
UriDeepLinkMatcherbelgeleri, joker karakter içeren parçaların tüm girişlerle eşleşeceğini ancak girişin bağımsız değişken olarak çıkarılmayacağını netleştirmek için düzeltildi. (I5ad9b, b/524677091) - URI kalıbı bir şema içermiyorsa veya çift eğik çizgiyle başlamıyorsa
UriDeepLinkMatcheröğesinin bir istekle eşleşmemesi sorunu düzeltildi. Örneğin,www.example.com/homeartıkhttp://www.example.com/homeile eşleşecek. (Ia6b65, b/522791926)
Sürüm 1.2.0-alpha05
1 Temmuz 2026
androidx.navigation3:navigation3-*:1.2.0-alpha05 yayınlandı. 1.2.0-alpha05 sürümü bu kayıtları içerir.
Yeni API
rememberResultEventBusNavEntryDecoratoröğesine iletilebilecek birResultEventBusdöndürenrememberResultEventBusAPI'si eklendi. Bu sayedeResultEventBus,ResultEventBusNavEntryDecoratordışında kullanılabilir. (Ia655b, b/516995400)
DeepLinkRequest
- Biri DeepLinkUri, diğeri ise ham dize URI'si alan iki KMP uyumlu kurucu eklendi. (I3c088, b/513200887, b/522194187)
- (Yalnızca Android)
Intentalan bir kurucu eklendi. (Ia0498, b/513200887, b/522194187) - Tüm oluşturucularda, ek istek bilgilerini eklemek için
Map<String, Any>için ek birextrasalanı bulunur. (If81d5, b/513200887) - Ekstraların haritasını oluşturmak için tip güvenliği sağlayan yeni bir
requestExtrasDSL eklendi. DSL,RequestExtrasKeyileAnyçiftlerini depolamak için birputişlevi sağlar.Map<String, Any>.get(key)uzantı işlevi,RequestExtrasKeyile haritadan okuma yapmak için kullanılabilir (I5091c, b/513200887) - (Yalnızca Android)
ActionExtrasKeyile ekstralar haritası oluşturmak içinActionExtrasKeyveactionExtraişlevi eklendi. (Id0c90, [b/513200887] MimeTypeExtrasKeyile ekstralar haritası oluşturmak içinMimeTypeExtrasKeyvemimeTypeExtraişlevi eklendi. (I85131, b/513200887)
DeepLinkMatcher
DeepLinkRequestöğesinimimeTypeveyaactionölçütüne göre filtreleyenDeepLinkMatcher.Filtersoluşturmak içinDeepLinkMatcher.mimeTypeFilterveDeepLinkMatcher.actionFilterişlevleri eklendi (yalnızca Android). Her iki filtre de dize eşitliğine göre eşleşir ve büyük/küçük harfe duyarlı değildir. (Ie7e67, b/513191950)
API Değişiklikleri
DeepLinkRequest
fromActionfabrika işlevini kaldırın. Bir işlemle ilişkili istek oluşturmak için yeniDeepLinkRequest.extrasalanını kullanın.(Id0c90, b/513200887)fromMimeTypefabrika işlevi kaldırıldı. Bir mimeType ile ilişkili istek oluşturmak için yeniDeepLinkRequest.extrasalanını kullanın. (I85131, b/513200887)- (Yalnızca Android)
fromIntentfabrika işlevi kaldırıldı. Intent ve ek eşleme alan yeni bir oluşturucuyla değiştirildi. (Ia0498, b/513200887, b/522194187) fromUrivefromUriStringfabrika işlevleri kaldırıldı.DeepLinkUriveya ham dize URI'si alan yeni oluşturucularla değiştirildi. (Id5b6f, b/522194187)DeepLinkMatcher,DeepLinkMatcher.MatchResultve bunların alt sınıfları artık eş değişken T (out T) alır. Böylece hiyerarşik anahtarların, Matchers ile kullanıldığında tür dönüştürme işlemine ihtiyacı olmaz. (I1e453, b/525094876)- Bağımsız değişken eşlemesi için
UriMatchResultoluşturucu parametresi artık varsayılan olarak boş bir eşleme olur. (I3acdd) DeepLinkMatcher.Filtersoyut sınıfı artık işlevsel bir arayüzdür.filteroluşturucu alanı kaldırıldı ve bunun yerine doğrudan alt sınıfa iletilmelidir. (I9eb7d, b/522194187)
Hata Düzeltmeleri
- Lambda değerleri içeren iç içe yerleştirilmiş meta verilerin bulunduğu bir girişe geçildiğinde, açılan girişin hemen kaybolması sorunu düzeltildi. (Idb872, b/520494430)
- Eşleştirme sırasında gerekli bağımsız değişkenler eksik olduğunda
MissingFieldExceptionhatası vermek yerine boş birUriMatchResultdöndürmesi içinUriDeepLinkMatcherdüzeltildi. (I5322f, b/524663005) - https şemasına sahip URI içeren bir
UriDeeplinkMatcher, yalnızca https şemasına sahip isteklerle eşleştirilebilir. (Ibfe22, b/522304329) UriDeepLinkMatcher,DeepLinkRequestile eşleştirilirkenhttpşemasınıhttpsile pozitif eşleşme olarak doğru şekilde tanımlamak içinUriDeepLinkMatcherdüzeltildi. (I3a62b, b/518804264)DeepLinkMatcher.MatchResultkarşılaştırıcısı artık iki sonuç eşit olduğunda varsayılan olarak 0 değerini döndürür. (I48ddb, b/518841353)UriDeepLinkMatcher, eşleşme isteği gerekli bağımsız değişkenlerin eksik olması nedeniyle başarısız olduğunda artık istisna oluşturmak yerine boş birUriMatchResultdöndürecek. (I669a7, b/470282247, b/512923412)
Sürüm 1.2.0-alpha04
3 Haziran 2026
androidx.navigation3:navigation3-*:1.2.0-alpha04 yayınlandı. 1.2.0-alpha04 sürümü bu kayıtları içerir.
Hata Düzeltmeleri
ModalBottomSheetgibi iç içe yerleştirilmiş yer paylaşımlarının, üstlerindeki yer paylaşımları açıldığında beklenmedik şekilde yeniden animasyon oluşturmasına neden olan yer paylaşımı animasyonu sorunu düzeltildi. (Ia2b9e, b/502624496)
Sürüm 1.2.0-alpha03
19 Mayıs 2026
androidx.navigation3:navigation3-*:1.2.0-alpha03 yayınlandı. 1.2.0-alpha03 sürümü bu kayıtları içerir.
Yeni özellikler
Navigation 3 artık DeepLinkRequest ve DeepLinkMatcher ile derin bağlantıları destekliyor:
DeepLinkRequest,DeepLinkUrive isteğe bağlı bir mimeType veya işlem (yalnızca Android) içeren istenen derin bağlantı. Yeni sınıfla birlikteuri,mimeTypeveyaactionile örnek oluşturmak için tamamlayıcı işlevler de sunulur. Android platformunda, Intent'ten istek oluşturmaya yardımcı olan bir araç da bulunur. (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,DeepLinkRequestile eşleştirilebilecek bir derin bağlantıyı temsil eder. Her eşleştirici örneği, bu derin bağlantıyı destekleyen gezinme tuşuyla ilişkilendirilir. Bir gezinme anahtarı birden fazla eşleştiriciyle ilişkilendirilebilir.DeepLinkMatcher.matchçağrıldığında, eşleşme başarılı olursa ilişkili gezinme anahtarını içeren birMatchResultdöndürülür. İki varsayılanDeepLinkMatcheruygulaması vardır: URI'ye göre derin bağlantıları eşleştirmek içinUriDeepLinkMatcherve yalnızcaBooleanile eşleşenDeepLinkMatcher.Filteriçeren derin bağlantıları eşleştirmek içinStaticKeyDeepLinkMatcher. (I3798e, b/470282247)UriDeepLinkMatcher,DeepLinkUriöğesini Serializable gezinme anahtarıyla eşleştirerek derin bağlantıyı işleyen,DeepLinkMatcheröğesinin özel bir uygulamasıdır. İlkel türlerin veya Liste, Dizi ve Küme gibi ilkel koleksiyonların derin bağlantı bağımsız değişkenlerini destekler. (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 ?: HomeKeyandroid.net.Uri'in Kotlin Multiplatform sürümü olanDeepLinkUrieklendi (Id4725, b/470282247)
API Değişiklikleri
- Compose'un compileSdk'siyle eşleşmesi için
compileSdk 37sürümüne yükseltildi
Hata Düzeltmeleri
- Birden fazla yer paylaşımı gösterilirken
AnimatedBottomSheetSampleadlı kullanıcınınIllegalArgumentExceptionsorunu düzeltildi.SceneStrategyörneği artık sonOverlaySceneolmayan değeri doğru şekilde hesaplayacak ve tüm yer paylaşımı sahnelerinin altında gösterecek. (If2281, b/506733412) NavigationEventbağımlılığı 1.1.1'e yükseltildi. Bu sayede, Android Studio önizlemelerinde tahmin edilen geri gitme özelliğini etkinleştirmek için denetleme modundayken işlem yapmayan NavigationEventHandler kaldırıldı. (I487fd)
Sürüm 1.2.0-alpha02
22 Nisan 2026
androidx.navigation3:navigation3-*:1.2.0-alpha02 yayınlandı. 1.2.0-alpha02 sürümü bu kayıtları içerir.
API Değişiklikleri
- İptal edilen geri hareketlerinin işlenmesini desteklemek için
onBacköğesinionBackCompletedolarak yeniden adlandırın ve NavigationBackHandler'aonBackCancelledekleyin. (I92741) SceneStatekullanırken geri hareketlerini ve tahmin edilen geri gitme özelliğini daha kolay yönetmek içinNavigationBackHandlerekleyin. Bu sayede geliştiriciler, eski yığın deltalarını manuel olarak hesaplamadan standart geri gezinme ve tahmin edilen hareketleri destekleyen özel kullanıcı arayüzü bileşenlerini daha kolay oluşturabilir. (I6a055)- Tahmin edilen geri gitme işlevini kullanarak
SceneStateile bağlantı kurmayı kolaylaştırmak içinrememberNavigationEventStateekleyin. (Iae49c)
Yeni özellikler
- Yeni
ResultEventBusNavEntryDecoratortarafından sağlananLocalResultEventBusile NavEntry'ler arasında sonuçların aktarılmasına olanak tanıyan birResultEventBusAPI'si eklendi. Geçirilen sonuçlar,ResultEventBus#conflateAsStateile bir durum olarak veyaResultEffectile bir sonuç akışı olarak değerlendirilebilir.
Sürüm 1.2.0-alpha01
8 Nisan 2026
androidx.navigation3:navigation3-*:1.2.0-alpha01 yayınlandı. 1.2.0-alpha01 sürümü bu kayıtları içerir.
Hata Düzeltmeleri
OverlaySceneüzerindenLocalNavAnimatedContentScopeerişimi artıkIllegalStateExceptionhatasına neden olmayacak.OverlayScenesartık işlem yapmayan birLocalAnimatedContentScopeile sağlanıyor. (I2f00c, b/486067688)
Navigation3 Sürüm 1.1
Sürüm 1.1.7
26 Ağustos 2026
androidx.navigation3:navigation3-*:1.1.7 yayınlandı. 1.1.7 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
- İleri geçiş sırasında tetiklenen tahmin edilen geri gitme hareketlerinin, kaydırma ilerlemesine yanıt olarak animasyon göstermemesi sorunu düzeltildi. Tahmin edilen geri gitme artık animasyonlu olarak gösterilir ve düzgün bir şekilde tamamlanır. (Icdcb0, b/456218398)
Sürüm 1.1.6
12 Ağustos 2026
androidx.navigation3:navigation3-*:1.1.6 yayınlandı. 1.1.6 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
NavEntry.contentKeyartık varsayılan olarakkey.toString()vekey::class.toString()bileşenlerinden oluşur. Bu sayede, aynı adı paylaşan ancak farklı arayüzler uygulayan veri nesneleri artık aynıcontentKeydeğerine sahip olmaz. Ancak JS platformununkey::classişlevi, tam ad yerine yalnızca basit sınıf adını döndürür. Bu nedenle JS platformu, yinelenen adlara sahip veri nesneleri için özelcontentKeyişlevini uygulamaya devam etmelidir. (I1fbbb, b/512534342)- Geri yığından hızlı bir şekilde çıkarma nedeniyle birden fazla çıkarma geçişi aynı anda gerçekleştiğinde anahtarın yeniden kullanımı için
SaveableStateHoldertarafından oluşturulanIllegalArgumentExceptiondüzeltildi. (I4d728, b/516312097)
Sürüm 1.1.5
29 Temmuz 2026
androidx.navigation3:navigation3-*:1.1.5 yayınlandı. 1.1.5 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
entryProviderDSL artık anahtar örneğiyle oluşturulanNavEntryöğelerine (ör.entry(key = userKey) { ... }), anahtar sınıfıyla oluşturulanNavEntryöğelerine (ör.entry<UserKey>{ ... }) kıyasla öncelik veriyor.(Ib5ec9, b/533331924)
Sürüm 1.1.4
1 Temmuz 2026
androidx.navigation3:navigation3-*:1.1.4 yayınlandı. 1.1.4 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
- Lambda değerleri içeren iç içe yerleştirilmiş meta verilerin bulunduğu bir girişe geçildiğinde, açılan girişin hemen kaybolması sorunu düzeltildi. (Idb872, b/520494430)
Sürüm 1.1.3
17 Haziran 2026
androidx.navigation3:navigation3-*:1.1.3 yayınlandı. 1.1.3 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
ModalBottomSheetgibi iç içe yerleştirilmiş yer paylaşımlarının, üstlerindeki yer paylaşımları açıldığında beklenmedik şekilde yeniden animasyon oluşturmasına neden olan yer paylaşımı animasyonu sorunu düzeltildi. (Ia2b9e, b/502624496)Android Studio önizlemelerinde tahmin edilen geri gitme özelliğini etkinleştirmek için denetleme modundayken işlem yapılmayan
NavigationEventHandleröğesini kaldıranNavigationEventbağımlılığı 1.1.2'ye yükseltildi.
Sürüm 1.1.2
19 Mayıs 2026
androidx.navigation3:navigation3-*:1.1.2 yayınlandı. 1.1.2 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
NavigationEventbağımlılığı 1.1.1'e yükseltildi. Bu sayede, Android Studio önizlemelerinde tahmin edilen geri gitme özelliğini etkinleştirmek için denetleme modundayken işlem yapılmayanNavigationEventHandlerkaldırıldı.
Sürüm 1.1.1
22 Nisan 2026
androidx.navigation3:navigation3-*:1.1.1 yayınlandı. 1.1.1 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
OverlaySceneüzerindenLocalNavAnimatedContentScopeerişimi artıkIllegalStateExceptionhatasına neden olmayacak.OverlayScenesartık işlem yapmayan birLocalAnimatedContentScopeile sağlanıyor. (I2f00c, b/486067688)
Sürüm 1.1.0
8 Nisan 2026
androidx.navigation3:navigation3-*:1.1.0 yayınlandı. 1.1.0 sürümü bu commit'leri içerir.
1.1.0 artık kararlı sürümde.
1.0.0 sürümünden sonra yapılan önemli değişiklikler
Sahneler arasında paylaşılan öğeler
- Navigation3 artık sahneleri paylaşılan öğe nesnesi olarak değerlendirmeyi destekliyor. Bu sayede, sahneler değiştiğinde geçişlerin sorunsuz olmasını sağlayabilirsiniz. Bu özelliği, NavDisplay veya rememberSceneState öğesine SharedTransitionScope ileterek etkinleştirebilirsiniz.
SceneDecoratorStrategy
- Sahneleri yaygın kullanıcı arayüzü bileşenleriyle süsleme veya sahneler arasında durum paylaşma gibi kullanım alanlarını desteklemek için SceneDecoratorStrategy kullanıma sunuldu.
NavMetadata DSL
- Navigation3 artık yeni bir tür güvenli meta veri DSL'si sunuyor. DSL, meta veri haritasına sağlamak istedikleri anahtar ve değer türlerini tanımlamaya olanak tanıyan yeni bir MetadataKey arayüzü kullanır. Bu değişiklik, NavDisplay geçişleri için yeni NavMetadataKeys de ekledi. Böylece, NavDisplay'e geçiş eklemek için yeni meta veri DSL ile kullanılabilirler.
OverlayScene Animasyonları
- OverlayScene arayüzünde yeni bir onRemoved askıya alma geri çağırma işlevi var. Bu geri çağırma, sahneyle ilişkili bir anahtar arka yığından kaldırıldıktan sonra ancak oluşturmadan ayrılmadan önce çağrılır. Bu sayede, yer paylaşımlı sahne oluşturmadan kaldırılmadan önce onRemoved içinde çağrılan çıkış animasyonları tamamlanabilir.
Diğer Değişiklikler
- NavDisplay ve rememberSceneState, then infix ile zincirlenmiş önceki tek SceneStrategy parametresi yerine artık bir List<SceneStrategy> alır.
- Artık EntryProvider DSL aracılığıyla giriş anahtarını dikkate alarak meta verileri dinamik olarak ekleyebilirsiniz.
Sürüm 1.1.0-rc01
25 Mart 2026
androidx.navigation3:navigation3-*:1.1.0-rc01 yayınlandı. 1.1.0-rc01 sürümü bu commit'leri içerir.
Hata Düzeltmeleri
NavDisplay, yer paylaşımlarının altında gösterilen girişlerinLifecycledeğerininSTARTEDile sınırlandırılmasını sağlar. Bu sayede, iletişim kutuları kullanılırkendropUnlessResumedgibi API'ler çalışmaya devam eder. (If209f, b/483966071)NavDisplayuygulamasında, aynı ekranlar arasında gezinirken ve ikisi arasındaki animasyonları kesintiye uğratırken ekranların z sırasının yanlış olmasına neden olan sorun düzeltildi. (I4d491, b/459419800)
Sürüm 1.1.0-beta01
11 Mart 2026
androidx.navigation3:navigation3-*:1.1.0-beta01 yayınlandı. 1.1.0-beta01 sürümü bu kayıtları içerir.
Sürüm 1.1.0-alpha05
25 Şubat 2026
androidx.navigation3:navigation3-*:1.1.0-alpha05 yayınlandı. 1.1.0-alpha05 sürümü bu kayıtları içerir.
API Değişiklikleri
NavDisplayverememberSceneStateartıktheninfix ile zincirlenmiş önceki tekSceneStrategyparametresi yerine birList<SceneStrategy>alır. Bu, her iki API'nin de kullandığıList<SceneDecoratorStrategy<T>>ile daha uyumludur. Önceki API'ler kullanımdan kaldırıldı. (I78b2c, b/482108465)- Meta veri haritasının belirtilen
NavMetadataKeydeğerini içerip içermediğini kontrol etmek için bir meta veri #contains operatörü eklendi. (Ic30db, b/485311895) - Metadata DSL ile kullanılmak üzere
DialogSceneStrategyiçinNavMetadataKeyDialogKeyeklendi. (Ic7a26, b/483388817)
Sürüm 1.1.0-alpha04
11 Şubat 2026
androidx.navigation3:navigation3-*:1.1.0-alpha04 yayınlandı. 1.1.0-alpha04 sürümü bu kayıtları içerir.
Yeni özellikler
- Navigation3 artık yeni bir tür güvenli meta veri DSL'si sunuyor. DSL, meta veri haritasına sağlamak istedikleri anahtar ve değer türlerini tanımlamaya olanak tanıyan yeni bir
MetadataKeyarayüzü kullanır. Bu sayede,NavDisplaygeçişleri için yeniNavMetadataKey'ler de eklendi. Böylece,NavDisplay'e geçiş eklemek için yenimetadataDSL ile kullanılabilirler. (Ic10ef, Ic049c,b/476213928)
API Değişiklikleri
OverlayScenearayüzünde yeni bironRemovedaskıya alma geri çağırma işlevi var. Bu geri çağırma, sahneyle ilişkili bir anahtar arka yığından kaldırıldıktan sonra ancak oluşturmadan ayrılmadan önce çağrılır. Bu sayede,onRemovediçinde çağrılan çıkış animasyonları, yer paylaşımlı sahne oluşturmadan kaldırılmadan önce tamamlanabilir. (I29a72, b/440558061)SceneStrategy, dekorasyon işlevini yeni birSceneDecoratorStrategyolarak ayırdı. Sahneleri süslemek için bu yeni arayüz kullanılmalıdır.SceneDecoratorStrategieseklenmesine olanak tanıyan yeniNavDisplayverememberSceneStateAPI'leri var. (If9385, b/477669607, b/477670333)
Hata Düzeltmeleri
NavDisplayveyarememberSceneStateöğesineSharedTransitionLayoutiletildiğinde ve herhangi birOverlayScenekullanıldığında kilitlenmeye neden olan bir hata düzeltildi.SharedTransitionLayoutkullanımı yalnızcaAnimatedContentkapsamında oluşturulanNavEntriesile çalışır veOverlayScenekendi pencerelerinde ayrı olarak oluşturulur. (I1bb76, b/478664101)
Bağımlılık Güncellemesi
Navigation31.0.1 sürümünden itibaren:Navigation3artıkNavigationEvent1.0.2 sürümüne bağlıdır. Bu sayede,AndroidStudioönizlemeleri sırasındaNavDisplaykullanılması nedeniyle oluşanIllegalStateExceptiondüzeltilir. (Id7212, b/477149762)
Sürüm 1.1.0-alpha03
28 Ocak 2026
androidx.navigation3:navigation3-*:1.1.0-alpha03 yayınlandı. 1.1.0-alpha03 sürümü bu kayıtları içerir.
Yeni özellikler
- Artık
EntryProviderDSL aracılığıyla giriş anahtarını dikkate alarak meta verileri dinamik olarak ekleyebilirsiniz. (I942fb, b/474416976)
Sürüm 1.1.0-alpha02
14 Ocak 2026
androidx.navigation3:navigation3-*:1.1.0-alpha02 yayınlandı. 1.1.0-alpha02 sürümü bu commit'leri içerir.
Yeni özellikler
SceneStrategyartık yeni bircalculatedScene(Scene)işlevi aracılığıyla iç içe yerleştirilmiş sahneleri destekliyor. Bu,SceneStrategy'lerin diğer sahnelere ek işlevler sağlayacak şekilde özelleştirilebileceği anlamına gelir. (I5df7c,b/440333896)
Sürüm 1.1.0-alpha01
3 Aralık 2025
androidx.navigation3:navigation3-*:1.1.0-alpha01 yayınlandı. 1.1.0-alpha01 sürümü bu kayıtları içerir.
API Değişiklikleri
Navigation3artık sahneleri paylaşılan öğe nesnesi olarak değerlendirmeyi destekliyor. Bu sayede, sahneler değiştiğinde geçişlerin sorunsuz olmasını sağlayabilirsiniz. Bu özelliği,NavDisplayveyarememberSceneStateöğesineSharedTransitionScopeileterek etkinleştirebilirsiniz. (I15868)
Sürüm 1.0
Sürüm 1.0.1
11 Şubat 2026
androidx.navigation3:navigation3-*:1.0.1 yayınlandı. 1.0.1 sürümü bu commit'leri içerir.
Bağımlılık Güncellemesi
Navigation3artıkNavigationEvent1.0.2'ye bağlıdır. Bu sayede,AndroidStudioönizlemeleri sırasındaNavDisplaykullanılması nedeniyle oluşanIllegalStateExceptiondüzeltilir. (Id7212, b/477149762)
Sürüm 1.0.0
19 Kasım 2025
androidx.navigation3:navigation3-*:1.0.0 yayınlandı. 1.0.0 sürümü bu commit'leri içerir.
Navigation3 ile tanışın
- Navigation3 kitaplığı artık kararlı sürümde. Navigation3, AndroidX Compose'un navigasyona yönelik ilk yaklaşımıdır.
- Daha fazla bilgi için duyuru blog yayınımızı inceleyin, kaynakları ziyaret edin ve tarifleri deneyin.
Sürüm 1.0.0-rc01
5 Kasım 2025
androidx.navigation3:navigation3-*:1.0.0-rc01 yayınlandı. 1.0.0-rc01 sürümü bu kayıtları içerir.
Hata Düzeltmeleri
NavDisplayartıkScenedüzeyinde birLocalLifecycleOwnerayarlıyor. Bu sayede sahne yazarları,Lifecycle.StatedeğerininRESUMEDolduğunu kontrol ederek tüm geçişlerin tamamlanıp tamamlanmadığını belirleyebiliyor.NavEntrydüzeyindekiLocalLifecycleOwnerdavranışı değişmez: Geçiş devam ediyorsaSTARTEDile sınırlı kalır ve buNavEntry, eski yığından çıkarılmışsa ve animasyonun çıkış sürecindeyseCREATEDile sınırlı kalır. (I03113, b/454045829)
Sürüm 1.0.0-beta01
22 Ekim 2025
androidx.navigation3:navigation3-*:1.0.0-beta01 yayınlandı. 1.0.0-beta01 sürümü bu kayıtları içerir.
API Değişiklikleri
SceneStrategyScopeartık yalnızca bağımsız değişken içermeyen herkese açık bir kurucuya sahiptir. Bu kurucu,SceneStrategyve döndürülenSceneöğelerini ayrı ayrı test etmek için uygundur. Daha karmaşık kullanım alanları için lütfenrememberSceneState()kullanın. (I8440c, b/451679047)
Hata Düzeltmeleri
SceneStrategyilethenzincirlenirken oluşan sonsuz döngü düzeltildi. (Iba3f0, b/450323470)NavDisplayöğesine iletilenbackStackdeğiştirilirken ve animasyonlar kullanılırken oluşan ekran titremesi düzeltildi. (Ief7b5, b/450967248)
Sürüm 1.0.0-alpha11
8 Ekim 2025
androidx.navigation3:navigation3-*:1.0.0-alpha11 yayınlandı. 1.0.0-alpha11 sürümü bu kayıtları içerir.
API Değişiklikleri
SceneStrategyüzerindekicalculateSceneyöntemi artık@Composable. Bunun yerine, bu çalışmayıSceneStrategyyönteminizin yapısına (ör.rememberMySceneStrategy()yöntemine) taşıyabilirsiniz. Bu yöntem, herhangi birrememberSaveabledeğerinin veya anahtarrememberifadelerinin yaşam süresini doğru değerlere göre tanımlamanıza olanak tanır. (If1733, b/448709506)SceneStrategy.calculateSceneiçinonBackparametresi, isteğe bağlı bir parametre olduğunu daha net hale getirmek ve gelecekteki Navigation3 özellikleri için bir uzantı noktası sağlamak amacıylaSceneStrategyScopeadlı yeni alıcı kapsamına taşındı. (I3aea3, b/448460407)NavDisplayveSceneStrategyöğenize iletilenonBacklambda, artık birden fazla girişin ne zaman çıkarılacağını belirten bircount: Intparametresi sağlamıyor. Bunun yerine, sahnenizin birden fazla girişin kaldırılmasını istediği nadir durumlarda() -> Unitlambda artık arka arkaya birden çok kez çağrılacak. (Idedb5, b/446989346)NavEntryWrappersınıfını kaldırın ve işlevini, yeni içerikli birNavEntryalan yeni bir ikincil kurucuya sahip nihai birNavEntrysınıfıyla değiştirin. Bu sayede, bir girişin yeni içerikle sarmalanması için destek devam eder. (I7da2a, b/444447130)NavEntryDecoratoroluşturup döndürennavEntryDecoratorişlevi kaldırıldı ve yerine, artık herkese açık olan ve alt sınıf oluşturmaya açık olanNavEntryDecoratorsınıfı getirildi. (If81f8, b/444447434, b/447381176)SavedStateNavEntryDecorator, girişleriSaveableStateHolderile süslediği içinSaveableStateHolderNavEntryDecoratorolarak yeniden adlandırıldı. Dekoratör, işlevsel olarakNavEntryDecoratoriçin bir fabrika olduğundan bir işlevden sınıfa yeniden düzenlendi. (Ie6013, b/447381176)NavDisplayyerineSceneStatekullanan özel ekranların artık dahili olanLocalEntriesToRenderInCurrentSceneoluşturma yerelini kullanması gerekmez. (Ic40ef, b/414668196)SceneSetupNavEntryDecoratorverememberSceneSetupNavEntryDecorator(), herkese açık API yüzeyinden kaldırıldı. Bu işlev artık manuel olarak eklemenize gerek kalmadan varsayılan olarak dahil edilir. (Ieae42, b/444479133)NavEntry,DialogScene,SinglePaneSceneveSceneStateartık eşittir işlevini uyguluyor. (I96121)- Sahne arayüzünde, NavDisplay için sahneye özel meta veriler eklemek üzere yeni bir meta veri alanı bulunur. Bu sayede bir sahne,
NavDisplayüzerindeki meta verileri (ör. geçişlerle) geçersiz kılabilir. (I1fd96, b/443955625) - Gereksiz genel tür parametresini kaldırarak
rememberNavBackStackimzasını basitleştirin. İşlev artıkvararg elements: NavKeydeğerini kabul ediyor. (I03e45) NavDisplayiçin varsayılan animasyonlar artık ortak API'nin bir parçasıdır ve tüm platformlardan çağrılabilir. (I71af9, b/447147159)- Sınıfın
NavEntriesoluşturmak için kapsam sağlayan bir Kotlin DSL olduğunu doğru şekilde yansıtmak içinEntryProviderBuilder,EntryProviderScopeolarak yeniden adlandırıldı. (Ia7465)
Hata Düzeltmeleri
rememberNavBackStack()artık NavKey için polimorfik serileştirmeyi zorunlu kılıyor ve doğru durum geri yüklemesini sağlamak üzere yapılandırılmış özel birSavedStateConfigurationgerektiriyor. KDoc, tüm NavKey alt türlerinin sağlanan SerializersModule'a kaydedilmesi gerektiği şartını yansıtacak şekilde güncellendi. (I6de37,I782f2, b/446664383)
Sürüm 1.0.0-alpha10
24 Eylül 2025
androidx.navigation3:navigation3-*:1.0.0-alpha10 yayınlandı. 1.0.0-alpha10 sürümü bu kayıtları içerir.
API Değişiklikleri
rememberDecoratedNavEntriesile dekore edilmiş birNavEntry<T>listesi alan yeni birNavDisplayaşırı yüklemesi ekleyin. (I4025b, b/441940314)DialogSceneyeni bir pakete taşındı. (Ia5840)- Herkese açık API'yi (
DecorateNavEntry) kaldırın. Bunun yerine, bir NavEntry'yi dekoratör listesiyle sarmalamak içinrememberDecoratedNavEntrieskullanın. (Id8c09) - Navigation3 kullanıcı arayüzü artık yeni varsayılan
transitionSpecözelliklerini sunuyor. (Ibcabd) - Sahneleri yönetmeye yardımcı olacak yeni bir
SceneStatenesnesi eklendi. Bu,SceneStateveNavigationEventState'yi alan yeni birNavDisplayaşırı yüklemesi de sağlar. (Idfb46, b/444479133) NavDisplay, artıkTransition'nincurrentStatevetargetStatedeğerlerine bakarak geçişleri, gittiğiniz ve geldiğinizScenedeğerine göre özelleştirmenize olanak tanır. (I906cc, b/443872322)NavigationEventInfoartıkinterfaceyerineabstract class. Tüm özel uygulamaları, sınıftan (ör.data class MyInfo : NavigationEventInfo()) devralacak şekilde güncelleyin. (I1e59c, b/444734264)navigationevent-composeişleyici API'leri güncellendi.NavigationEventHandlerveNavigationBackHandler(ve varyantları) artık yükseltilmişNavigationEventStatekabul eden yeni bir aşırı yüklemeyi destekliyor. Basit aşırı yüklemeler (currentInfoalan) korunur ve artık bu yeni durum modelini dahili olarak kullanır. (Ic3251, b/444734264)- Tüm Scene API'leri navigation3-ui'den navigation3-runtime'a taşındı. Bu, artık navigation3-runtime tarafından desteklenen tüm platformlarda kullanılabilecekleri anlamına gelir. (I431d0, b/444449993)
- Süslenecek
NavEntrylistesini alan yeni birrememberDecoratedNavEntriesaşırı yüklemesi eklendi. Girişler, diğer giriş dekoratörleriyle önceden dekore edilmiş olabilir. (I5a034, b/444230270) - navigation3 joker karakter türü parametrelerini kaldırın (I02540)
entryProviderDSL için genel türlerin işleyiş şekli iyileştirildi. Daha önceandroidx.navigation3.runtime.entryiçe aktarıyorduysanız artık bunu yapmanız gerekmez. (I299fc)- Yansımaya dayalı
NavBackStackSerializeraşırı yüklemesini Android ile kısıtlayın. Bu, çoklu platform kodunda açıkSavedStateConfigurationaşırı yüklemesinin kullanılmasını zorunlu kılarak Android platformu dışı platformlarda örtük çalışma zamanı serileştirme hatalarını önler. (I73313, b/420443609) - Make
NavigationEvent'sswipeEdgean@IntDef(Icee54, b/443950342) NavBackStackserileştirmesini Android ile kısıtlayın. Bu sayede Android platformu dışı platformlarda çalışma zamanı hataları önlenir. Çoklu platform durum kaydetme için açık birSavedStateConfigurationilerememberNavBackStackaşırı yüklemesini kullanın. (I1e418, b/420443609)
Hata Düzeltmeleri
- İç içe yerleştirilmiş
NavDisplayöğesinin tek bir alt girişi olduğunda tahmin edilen geri gitme sırasında kilitlenme sorunu düzeltildi. (I2cdc0, b/441933162)
Sürüm 1.0.0-alpha09
10 Eylül 2025
androidx.navigation3:navigation3-*:1.0.0-alpha09 yayınlandı. 1.0.0-alpha09 sürümü bu kayıtları içerir.
API Değişiklikleri
DecoratedNavEntryProvider, sağlanan dekoratör listesiyle dekore edilmiş NavEntry'ler oluşturan ve döndürenrememberDecoratedNavEntriesile değiştirildi (I0fe1c, b/441328236).NavBackStackartıkNavKeytürü için geneldir. Bu sayede uygulamalar ve kitaplıklar,NavKeyile sınırlı kalmak yerine eski yığınları için özel anahtar türleri tanımlayabilir. (I4d190,Iad2f4, b/420443609)NavBackStackartık@kotlinx.serialization.Serializableoldu. Bu sayede, işlem sonlandırma ve yapılandırma değişiklikleri sırasında gezinme durumunu ek bir standart kod olmadan kaydedip geri yükleyebilirsiniz. (I2c3cf, b/420443609)RememberNavBackStack, tüm platform hedeflerinde sağlandığından emin olmak içincommonMainkonumuna taşındı. (Id69e7, b/420443609)
Hata Düzeltmeleri
NavDisplayartık her birNavEntryöğesini doğruLifecycle.Stateklasörüne taşıyor. (I30aac, b/440145700)NavDisplayöğesinin,NavigationEventkitaplığınınLocalNavigationEventDispatcherOwneraracılığıyla ayarlanan iç içe yerleştirilmişNavigationEventDispatcherOwneröğelerini yoksaymasına neden olan sorun düzeltildi. (I6224a)
Bağımlılık Değişiklikleri
- Navigation3 artık NavigationEvent Alpha08'e bağlıdır.
Sürüm 1.0.0-alpha08
27 Ağustos 2025
androidx.navigation3:navigation3-*:1.0.0-alpha08 yayınlandı. 1.0.0-alpha08 sürümü bu kayıtları içerir.
Yeni özellikler
Navigation3 Runtimeyapılarına yeni Kotlin MultiPlatform (KMP) hedefleri eklendi.Navigation3 Runtimeartık şu platformları destekliyor: JVM (Android ve masaüstü), yerel (Linux, iOS, watchOS, macOS, MinGW) ve web (JavaScript, WasmJS). (I55078, b/424410398, b/419294028, b/419046226). Not: Bu,Navigation3 UIyapısı için KMP hedefleri sağlamaz. Diğer platformlarda kendi özelNavDisplayuygulamanızı kullanmanız gerekir. Bu özelliğin desteklenmesini istiyorsanız lütfen buradan Jetbrains sorununa oy verin ve ek destek için ilerleme durumunu takip edin.NavDisplayInfonesnesi artık herkese açık veNavDisplayüzerinden görünür girişlerin listesini almak için kullanılabilir. (Ibc91f)
API Değişiklikleri
- Durum geri yükleme işlemini gerçekleştirmek için
rememberNavBackStackile birlikte kullanılacak yeni birNavBackStackSerializereklendi.rememberNavBackStack()artık kendi yapılandırmanızı sağlamak için kullanılabilecek birSavedStateConfigurationda alır. (I2f4d2, I4cd58, b/420443609)
Hata Düzeltmeleri
- Gezinme sırasında yanlış yaşam döngüsü etkinliklerinin tetiklenmesine neden olan sorun düzeltildi. (I8bf6d, b/425901162, b/434109022)
Bilinen Sorunlar
- I8bf6d tarafından, yaşam döngülerinin tek tek girişler yerine sahnelere dayalı olmasına neden olan bir hata ortaya çıktı. Bu hata,
NavEntryöğesine sağlanankeyöğesininStringolmadığı veyaNavEntryöğenizincontentKeyöğesini geçersiz kılıpkeyöğesine eşit olarak ayarlamadığı tüm durumlarda yaşam döngüsünü bozdu (bunu yapmanın, anahtarınızın birBundleöğesine kaydedilebilmesini zorunlu kıldığını unutmayın). Bu sorun bir sonraki sürümde düzeltildi. (b/440145700)
Sürüm 1.0.0-alpha07
13 Ağustos 2025
androidx.navigation3:navigation3-*:1.0.0-alpha07 yayınlandı. 1.0.0-alpha07 sürümü bu kayıtları içerir.
MinSdk Güncellemesi
- AndroidX için varsayılan minSdk, API 21'den API 23'e taşındı (Ibdfca, b/380448311, b/435705964, b/435705223)
API Değişiklikleri
SavedStateNavEntryDecoratorartık durumları kaydetmek ve geri yüklemek içinSaveableStateProvider'te yerleşik olarak bulunanSaveableStateRegistryözelliğini kullanıyor. (If8d9a)predictivePopTransitionSpecartık kaydırma kenarını parametre olarak sağlar. Bu sayede, kullanıcının tahmin edilen geri gitme hareketini başlattığı kenara göre geçişi özelleştirebilirsiniz. (I753a8)
Hata Düzeltmeleri
- En son sahne hatırlanmadığı için özel sahnelerin sonsuz şekilde yeniden hesaplanmasına neden olan sorun düzeltildi. (I7ba84, b/418153031)
Bağımlılık güncellemesi
- Navigation3 artık Gezinme Etkinliği
1.0.0-alpha06'e bağlıdır.
Sürüm 1.0.0-alpha06
30 Temmuz 2025
androidx.navigation3:navigation3-*:1.0.0-alpha06 yayınlandı. 1.0.0-alpha06 sürümü bu kayıtları içerir.
Bağımlılık Güncellemesi
- Navigation3 artık Gezinme Etkinliği
1.0.0-alpha05'e bağlıdır.
Sürüm 1.0.0-alpha05
2 Temmuz 2025
androidx.navigation3:navigation3-*:1.0.0-alpha05 yayınlandı. 1.0.0-alpha05 sürümü bu kayıtları içerir.
Davranış Değişiklikleri
NavEntryöğesinin durumu artık kesinlikleNavDisplayöğesine iletilen mevcut dekoratör listesine bağlıdır. Bu, eski yığındaki NavEntry'lerin durumunu korumak için birden fazla eski yığın olması durumunda dekoratörlerin eski yığınlarınızda değiştirilmesi gerektiği anlamına gelir. Aksi takdirde, girişler çıkarılmış gibi (değiştirme yerine) durumlar temizlenir. (I7a759, b/428033667)
Sürüm 1.0.0-alpha04
18 Haziran 2025
androidx.navigation3:navigation3-*:1.0.0-alpha04 yayınlandı. 1.0.0-alpha04 sürümü bu commit'leri içerir.
API Değişiklikleri
NavEntry.contentartık gizli.NavEntryiçeriğini çağırmak için, artık çağrılacak birkeyparametresi gerektirmeyen yeniNavEntry.Content()API'sini çağırın. (Icd0fd, b/420991203)NavEntry.keyartık gizli bir alan.NavEntryve ilgili durumları, yenicontentKeyFactorylambda'dan oluşturulan ve varsayılan olarakNavEntry.key'ten oluşturulan kaydedilebilir bir karma değere ayarlanan yenicontentKeyalanı tarafından tanımlanmalıdır (I81a6c, b/422001357, b/420991203 I2d7d4, b/420991203, b/422841812)
Bağımlılık Değişiklikleri
- Navigation3 artık yeni
androidx.navigationevent.composeyapısına bağlıdır.
Sürüm 1.0.0-alpha03
4 Haziran 2025
androidx.navigation3:navigation3-*:1.0.0-alpha03 yayınlandı. 1.0.0-alpha03 sürümü bu kayıtları içerir.
Hata Düzeltmeleri
Navigation3, başka birbackStackörneğiyle değiştirilenbackStacksiçin dekoratör durumlarını artık temizlemeyecek. (I28a42, b/415076044)
Sürüm 1.0.0-alpha02
23 Mayıs 2025
androidx.navigation3:navigation3-*:1.0.0-alpha02 yayınlandı. 1.0.0-alpha02 sürümü bu kayıtları içerir.
Hata Düzeltmeleri
SavedStateNavEntryDecoratorile ilgili, aynı özellik değerlerine sahip farklı veri sınıfları için çakışmalara neden olan bir sorun düzeltildi. (b/418070648, Iff4775)- Açık bağımlılıklar bildirilmeden çalıştırıldığında kilitlenmelere neden olan eksik sınıf sorunu düzeltildi. (b/419049149, I4b4ed)
Sürüm 1.0.0-alpha01
20 Mayıs 2025
androidx.navigation3:navigation3-*:1.0.0-alpha01 yayınlandı. 1.0.0-alpha01 sürümü bu kayıtları içerir.
Yeni özellikler
Navigation3, Jetpack Compose uygulama içi gezinmeyi işlemek için özel olarak tasarlanmış yeni bir gezinme kitaplığıdır. androidx.navigation3.runtime yapısı yapı taşlarını sağlarken androidx.navigation3.ui yapısı, NavDisplay API'si aracılığıyla kullanıcı arayüzü katmanını sağlar. Geliştiriciler, kendi durumlarını doğrudan NavDisplay composable işlevine sağlayabilir. Bu işlev, geliştirici durumundaki değişikliklere göre içeriği değiştirir.
@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 */ }
})
Daha fazla bilgi için Navigation3 kılavuzuna bakın.