navigation3

  
Navigation 3, Compose ile çalışacak şekilde tasarlanmış yeni bir gezinme kitaplığıdır.
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.

Yeni bir sorun oluşturma

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

  • SceneInfo sınıfı, sahnenin son NavEntry's meta verilerinden otomatik olarak doldurulan title ve url özelliklerini ekledi. Girişin meta verilerinde hedef başlıklarını ve URL'lerini tanımlamak için TitleMetadataKey ve UrlMetadataKey kullanı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

  • NavDisplay uygulamasında tahmin edilen geri gitme animasyonu geçişi, DeferredAnimatedContent sürümüne geçilerek ve geçiş sorunları çözülerek düzeltildi. I145eaedd b/430807423
    • DeferredAnimatedContent, geçişleri ertelenmiş bir aşamaya (defer aracılığıyla) ve otomatik bir aşamaya (animateTo aracılığıyla) ayırmak için DeferredTransition kullanı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.

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ü, compileSdk 37'yi gerektirmeyen Compose 1.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, LocalResultEventBus ve ResultEventBusNavEntryDecorator tarafından sağlanan ResultEventBus kullanılarak sonuçların NavEntries arasında aktarılmasına olanak tanır.
  • ResultEventBus öğesinin ResultEventBusNavEntryDecorator dışında kaldırılmasını ve rememberResultEventBusNavEntryDecorator öğesine iletilmesini desteklemek için rememberResultEventBus eklendi.
  • İletilen sonuçlara ResultEventBus#conflateAsState ile durum olarak erişilebilir veya ResultEffect ile 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.

  • DeepLinkRequest ve RequestExtras: DeepLinkUri, URI dizesi veya Android Intent'den oluşturulan bir derin bağlantı isteğini temsil eder. Ek istek meta verileri, requestExtras DSL ve RequestExtrasKey<T> ile oluşturulan, tür güvenli RequestExtras kapsayıcısı kullanılarak eklenebilir.
  • DeepLinkMatcher: DeepLinkRequest ile 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 bir MatchResult döndürülür. İki varsayılan DeepLinkMatcher uygulaması vardır: Uri temelinde derin bağlantıları eşleştirmek için UriDeepLinkMatcher ve derin bağlantıları yalnızca bir Boole değeriyle eşleşen DeepLinkMatcher.Filter ile eşleştirmek için StaticKeyDeepLinkMatcher.
  • BackStackMatcher: Başarılı bir derin bağlantı eşleşmesi üzerine yapay bir eski yığın oluşturmak için kullanılan DeepLinkMatcher. BackStackMatcher, DeepLinkMatcher.withBackStack uzantı işlevi aracılığıyla oluşturulabilir.

Tahmin Edilen Geri Gitme İşlemi

  • SceneState'yi tahmin edilen geri gitme işleme (onBackCompleted ve onBackCancelled) ile bağlamayı basitleştirmek için NavigationBackHandler ve rememberNavigationEventState eklendi. 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.contentKey artık varsayılan olarak key.toString() ve key::class.toString() bileşimini kullanıyor. Bu sayede, farklı arayüzlerde aynı basit adı paylaşan data object anahtarları arasında anahtar çakışmaları önleniyor.
  • EntryProvider artık anahtar türleri yerine anahtar örneklere göre eşleştirmeye öncelik veriyor.
  • Scene uygulamalarının data class veya equals ve hashCode uyguladığı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> yerine RequestExtrasKey<T> ile T çiftlerini depolayan yeni bir tip güvenli harita benzeri sınıf olan RequestExtras olarak yeniden düzenlendi. RequestExtras, requestExtras DSL 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)
  • Scene uygulamaları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.contentKey artık varsayılan olarak key.toString() ve key::class.toString() bileşenlerinden oluşur. Bu sayede, aynı adı paylaşan ancak farklı arayüzler uygulayan veri nesneleri artık aynı contentKey değerine sahip olmaz. Ancak JS platformunun key::class iş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 özel contentKey iş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 SaveableStateProvider tarafından oluşturulan IllegalArgumentException dü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.MatchResult sınıfını sarmalamak için soyut bir WrappedMatchResult sı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 BackStackMatcher sı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ğunda BackStackMatcher, lambda ile oluşturulan eski yığınla birlikte orijinal eşleşme sonucunu içeren WrappedMatchResult'yi genişleten bir BackStackMatchResult döndürür. BackStackMatcher yalnızca yeni DeepLinkMatcher.withBackStack uzantı işleviyle oluşturulabilir. (Ibf987, b/470282247)

  • value : T'yi String olarak kodlamak ve kodunu çözmek için KSerializer'i genişleten soyut bir DeepLinkSerializer sınıfı eklendi. DeepLinkSerializer, ilkel olmayan derin bağlantı bağımsız değişkenlerini serileştirmek için kullanılabilir. rememberSaveable ve rememberNavBackStack ile uyumludur. (Id3c9f, b/470282247)

  • DeepLinkMatcher, geliştiricilerin tür dönüştürme olmadan DeepLinkMatcher.match() tarafından döndürülen alt sınıfa ayrılmış MatchResult özelliklerine erişebilmesi için ikinci bir tür parametresi out R : DeepLinkMatcher.MatchResult<T> ekledi. (I693d3, b/470282247)

  • DeepLinkMatcher.MatchResult's T üst sınırı Any? iken Any olarak değiştirildi. (I6bf1a)

  • DeepLinkRequest oluşturucu alanı uri artık varsayılan olarak boş bırakılıyor. İkincil oluşturucunun uriString parametresi uri olarak yeniden adlandırıldı. (Ia0f14, b/522194187)

Hata Düzeltmeleri

  • ResultEffect artık en son onResult lambda'yı yakalamak için rememberUpdatedState kullanı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.uri iç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)
  • EntryProvider artık anahtar türleri yerine anahtar örneklere göre eşleştirmeye öncelik veriyor. (Ib5ec9, b/533331924)
  • SceneState artı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 UriDeepLinkMatcher belgeleri, 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/home artık http://www.example.com/home ile 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 bir ResultEventBus döndüren rememberResultEventBus API'si eklendi. Bu sayede ResultEventBus, ResultEventBusNavEntryDecorator dışı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) Intent alan bir kurucu eklendi. (Ia0498, b/513200887, b/522194187)
  • Tüm oluşturucularda, ek istek bilgilerini eklemek için Map<String, Any> için ek bir extras alanı bulunur. (If81d5, b/513200887)
  • Ekstraların haritasını oluşturmak için tip güvenliği sağlayan yeni bir requestExtras DSL eklendi. DSL, RequestExtrasKey ile Any çiftlerini depolamak için bir put işlevi sağlar. Map<String, Any>.get(key) uzantı işlevi, RequestExtrasKey ile haritadan okuma yapmak için kullanılabilir (I5091c, b/513200887)
  • (Yalnızca Android) ActionExtrasKey ile ekstralar haritası oluşturmak için ActionExtrasKey ve actionExtra işlevi eklendi. (Id0c90, [b/513200887]
  • MimeTypeExtrasKey ile ekstralar haritası oluşturmak için MimeTypeExtrasKey ve mimeTypeExtra işlevi eklendi. (I85131, b/513200887)

DeepLinkMatcher

  • DeepLinkRequest öğesini mimeType veya action ölçütüne göre filtreleyen DeepLinkMatcher.Filters oluşturmak için DeepLinkMatcher.mimeTypeFilter ve DeepLinkMatcher.actionFilter iş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

  • fromAction fabrika işlevini kaldırın. Bir işlemle ilişkili istek oluşturmak için yeni DeepLinkRequest.extras alanını kullanın.(Id0c90, b/513200887)
  • fromMimeType fabrika işlevi kaldırıldı. Bir mimeType ile ilişkili istek oluşturmak için yeni DeepLinkRequest.extras alanını kullanın. (I85131, b/513200887)
  • (Yalnızca Android) fromIntent fabrika işlevi kaldırıldı. Intent ve ek eşleme alan yeni bir oluşturucuyla değiştirildi. (Ia0498, b/513200887, b/522194187)
  • fromUri ve fromUriString fabrika işlevleri kaldırıldı. DeepLinkUri veya ham dize URI'si alan yeni oluşturucularla değiştirildi. (Id5b6f, b/522194187)
  • DeepLinkMatcher, DeepLinkMatcher.MatchResult ve 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 UriMatchResult oluşturucu parametresi artık varsayılan olarak boş bir eşleme olur. (I3acdd)
  • DeepLinkMatcher.Filter soyut sınıfı artık işlevsel bir arayüzdür. filter oluş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 MissingFieldException hatası vermek yerine boş bir UriMatchResult döndürmesi için UriDeepLinkMatcher dü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, DeepLinkRequest ile eşleştirilirken http şemasını https ile pozitif eşleşme olarak doğru şekilde tanımlamak için UriDeepLinkMatcher düzeltildi. (I3a62b, b/518804264)
  • DeepLinkMatcher.MatchResult karşı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ş bir UriMatchResult dö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

  • ModalBottomSheet gibi 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, DeepLinkUri ve isteğe bağlı bir mimeType veya işlem (yalnızca Android) içeren istenen derin bağlantı. Yeni sınıfla birlikte uri, mimeType veya action ile ö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, DeepLinkRequest ile 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 bir MatchResult döndürülür. İki varsayılan DeepLinkMatcher uygulaması vardır: URI'ye göre derin bağlantıları eşleştirmek için UriDeepLinkMatcher ve yalnızca Boolean ile eşleşen DeepLinkMatcher.Filter içeren derin bağlantıları eşleştirmek için StaticKeyDeepLinkMatcher. (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 ?: HomeKey
    
  • android.net.Uri'in Kotlin Multiplatform sürümü olan DeepLinkUri eklendi (Id4725, b/470282247)

API Değişiklikleri

  • Compose'un compileSdk'siyle eşleşmesi için compileSdk 37 sürümüne yükseltildi

Hata Düzeltmeleri

  • Birden fazla yer paylaşımı gösterilirken AnimatedBottomSheetSample adlı kullanıcının IllegalArgumentException sorunu düzeltildi. SceneStrategy örneği artık son OverlayScene olmayan değeri doğru şekilde hesaplayacak ve tüm yer paylaşımı sahnelerinin altında gösterecek. (If2281, b/506733412)
  • NavigationEvent bağı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 öğesini onBackCompleted olarak yeniden adlandırın ve NavigationBackHandler'a onBackCancelled ekleyin. (I92741)
  • SceneState kullanırken geri hareketlerini ve tahmin edilen geri gitme özelliğini daha kolay yönetmek için NavigationBackHandler ekleyin. 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 SceneState ile bağlantı kurmayı kolaylaştırmak için rememberNavigationEventState ekleyin. (Iae49c)

Yeni özellikler

  • Yeni ResultEventBusNavEntryDecorator tarafından sağlanan LocalResultEventBus ile NavEntry'ler arasında sonuçların aktarılmasına olanak tanıyan bir ResultEventBus API'si eklendi. Geçirilen sonuçlar, ResultEventBus#conflateAsState ile bir durum olarak veya ResultEffect ile 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 üzerinden LocalNavAnimatedContentScope erişimi artık IllegalStateException hatasına neden olmayacak. OverlayScenes artık işlem yapmayan bir LocalAnimatedContentScope ile sağlanıyor. (I2f00c, b/486067688)

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.contentKey artık varsayılan olarak key.toString() ve key::class.toString() bileşenlerinden oluşur. Bu sayede, aynı adı paylaşan ancak farklı arayüzler uygulayan veri nesneleri artık aynı contentKey değerine sahip olmaz. Ancak JS platformunun key::class iş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 özel contentKey iş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 SaveableStateHolder tarafından oluşturulan IllegalArgumentException dü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

  • entryProvider DSL artık anahtar örneğiyle oluşturulan NavEntry öğelerine (ör. entry(key = userKey) { ... }), anahtar sınıfıyla oluşturulan NavEntry öğ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

  • ModalBottomSheet gibi 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ıran NavigationEvent bağı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

  • NavigationEvent bağı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ılmayan NavigationEventHandler kaldı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 üzerinden LocalNavAnimatedContentScope erişimi artık IllegalStateException hatasına neden olmayacak. OverlayScenes artık işlem yapmayan bir LocalAnimatedContentScope ile 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şlerin Lifecycle değerinin STARTED ile sınırlandırılmasını sağlar. Bu sayede, iletişim kutuları kullanılırken dropUnlessResumed gibi API'ler çalışmaya devam eder. (If209f, b/483966071)
  • NavDisplay uygulaması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

  • NavDisplay ve rememberSceneState artık then infix ile zincirlenmiş önceki tek SceneStrategy parametresi yerine bir List<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 NavMetadataKey değ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 DialogSceneStrategy için NavMetadataKey DialogKey eklendi. (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 MetadataKey arayüzü kullanır. Bu sayede, NavDisplay geçişleri için yeni NavMetadataKey'ler de eklendi. Böylece, NavDisplay'e geçiş eklemek için yeni metadata DSL ile kullanılabilirler. (Ic10ef, Ic049c,b/476213928)

API Değişiklikleri

  • 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, onRemoved iç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 bir SceneDecoratorStrategy olarak ayırdı. Sahneleri süslemek için bu yeni arayüz kullanılmalıdır. SceneDecoratorStrategies eklenmesine olanak tanıyan yeni NavDisplay ve rememberSceneState API'leri var. (If9385, b/477669607, b/477670333)

Hata Düzeltmeleri

  • NavDisplay veya rememberSceneState öğesine SharedTransitionLayout iletildiğinde ve herhangi bir OverlayScene kullanıldığında kilitlenmeye neden olan bir hata düzeltildi. SharedTransitionLayout kullanımı yalnızca AnimatedContent kapsamında oluşturulan NavEntries ile çalışır ve OverlayScene kendi pencerelerinde ayrı olarak oluşturulur. (I1bb76, b/478664101)

Bağımlılık Güncellemesi

  • Navigation3 1.0.1 sürümünden itibaren: Navigation3 artık NavigationEvent 1.0.2 sürümüne bağlıdır. Bu sayede, AndroidStudio önizlemeleri sırasında NavDisplay kullanılması nedeniyle oluşan IllegalStateException dü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 EntryProvider DSL 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

  • SceneStrategy artık yeni bir calculatedScene(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

  • 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. (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

  • Navigation3 artık NavigationEvent 1.0.2'ye bağlıdır. Bu sayede, AndroidStudio önizlemeleri sırasında NavDisplay kullanılması nedeniyle oluşan IllegalStateException dü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

  • NavDisplay artık Scene düzeyinde bir LocalLifecycleOwner ayarlıyor. Bu sayede sahne yazarları, Lifecycle.State değerinin RESUMED olduğunu kontrol ederek tüm geçişlerin tamamlanıp tamamlanmadığını belirleyebiliyor. NavEntry düzeyindeki LocalLifecycleOwner davranışı değişmez: Geçiş devam ediyorsa STARTED ile sınırlı kalır ve bu NavEntry, eski yığından çıkarılmışsa ve animasyonun çıkış sürecindeyse CREATED ile 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

  • SceneStrategyScope artık yalnızca bağımsız değişken içermeyen herkese açık bir kurucuya sahiptir. Bu kurucu, SceneStrategy ve döndürülen Scene öğelerini ayrı ayrı test etmek için uygundur. Daha karmaşık kullanım alanları için lütfen rememberSceneState() kullanın. (I8440c, b/451679047)

Hata Düzeltmeleri

  • SceneStrategy ile then zincirlenirken oluşan sonsuz döngü düzeltildi. (Iba3f0, b/450323470)
  • NavDisplay öğesine iletilen backStack değ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 üzerindeki calculateScene yöntemi artık @Composable. Bunun yerine, bu çalışmayı SceneStrategy yönteminizin yapısına (ör. rememberMySceneStrategy() yöntemine) taşıyabilirsiniz. Bu yöntem, herhangi bir rememberSaveable değerinin veya anahtar remember ifadelerinin yaşam süresini doğru değerlere göre tanımlamanıza olanak tanır. (If1733, b/448709506)
  • SceneStrategy.calculateScene için onBack parametresi, isteğe bağlı bir parametre olduğunu daha net hale getirmek ve gelecekteki Navigation3 özellikleri için bir uzantı noktası sağlamak amacıyla SceneStrategyScope adlı yeni alıcı kapsamına taşındı. (I3aea3, b/448460407)
  • NavDisplay ve SceneStrategy öğenize iletilen onBack lambda, artık birden fazla girişin ne zaman çıkarılacağını belirten bir count: Int parametresi sağlamıyor. Bunun yerine, sahnenizin birden fazla girişin kaldırılmasını istediği nadir durumlarda () -> Unit lambda artık arka arkaya birden çok kez çağrılacak. (Idedb5, b/446989346)
  • NavEntryWrapper sınıfını kaldırın ve işlevini, yeni içerikli bir NavEntry alan yeni bir ikincil kurucuya sahip nihai bir NavEntry sınıfıyla değiştirin. Bu sayede, bir girişin yeni içerikle sarmalanması için destek devam eder. (I7da2a, b/444447130)
  • NavEntryDecorator oluşturup döndüren navEntryDecorator işlevi kaldırıldı ve yerine, artık herkese açık olan ve alt sınıf oluşturmaya açık olan NavEntryDecorator sınıfı getirildi. (If81f8, b/444447434, b/447381176)
  • SavedStateNavEntryDecorator, girişleri SaveableStateHolder ile süslediği için SaveableStateHolderNavEntryDecorator olarak yeniden adlandırıldı. Dekoratör, işlevsel olarak NavEntryDecorator için bir fabrika olduğundan bir işlevden sınıfa yeniden düzenlendi. (Ie6013, b/447381176)
  • NavDisplay yerine SceneState kullanan özel ekranların artık dahili olan LocalEntriesToRenderInCurrentScene oluşturma yerelini kullanması gerekmez. (Ic40ef, b/414668196)
  • SceneSetupNavEntryDecorator ve rememberSceneSetupNavEntryDecorator(), 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, SinglePaneScene ve SceneState artı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 rememberNavBackStack imzasını basitleştirin. İşlev artık vararg elements: NavKey değerini kabul ediyor. (I03e45)
  • NavDisplay iç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 NavEntries oluşturmak için kapsam sağlayan bir Kotlin DSL olduğunu doğru şekilde yansıtmak için EntryProviderBuilder, EntryProviderScope olarak 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 bir SavedStateConfiguration gerektiriyor. 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

  • rememberDecoratedNavEntries ile dekore edilmiş bir NavEntry<T> listesi alan yeni bir NavDisplay aşırı yüklemesi ekleyin. (I4025b, b/441940314)
  • DialogScene yeni bir pakete taşındı. (Ia5840)
  • Herkese açık API'yi (DecorateNavEntry) kaldırın. Bunun yerine, bir NavEntry'yi dekoratör listesiyle sarmalamak için rememberDecoratedNavEntries kullanın. (Id8c09)
  • Navigation3 kullanıcı arayüzü artık yeni varsayılan transitionSpec özelliklerini sunuyor. (Ibcabd)
  • Sahneleri yönetmeye yardımcı olacak yeni bir SceneState nesnesi eklendi. Bu, SceneState ve NavigationEventState'yi alan yeni bir NavDisplay aşırı yüklemesi de sağlar. (Idfb46, b/444479133)
  • NavDisplay, artık Transition'nin currentState ve targetState değerlerine bakarak geçişleri, gittiğiniz ve geldiğiniz Scene değerine göre özelleştirmenize olanak tanır. (I906cc, b/443872322)
  • NavigationEventInfo artık interface yerine abstract class. Tüm özel uygulamaları, sınıftan (ör. data class MyInfo : NavigationEventInfo()) devralacak şekilde güncelleyin. (I1e59c, b/444734264)
  • navigationevent-compose işleyici API'leri güncellendi. NavigationEventHandler ve NavigationBackHandler (ve varyantları) artık yükseltilmiş NavigationEventState kabul eden yeni bir aşırı yüklemeyi destekliyor. Basit aşırı yüklemeler (currentInfo alan) 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 NavEntry listesini alan yeni bir rememberDecoratedNavEntries aşı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)
  • entryProvider DSL için genel türlerin işleyiş şekli iyileştirildi. Daha önce androidx.navigation3.runtime.entry içe aktarıyorduysanız artık bunu yapmanız gerekmez. (I299fc)
  • Yansımaya dayalı NavBackStackSerializer aşırı yüklemesini Android ile kısıtlayın. Bu, çoklu platform kodunda açık SavedStateConfiguration aşı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's swipeEdge an @IntDef (Icee54, b/443950342)
  • NavBackStack serileş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 bir SavedStateConfiguration ile rememberNavBackStack aşı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üren rememberDecoratedNavEntries ile değiştirildi (I0fe1c, b/441328236).
  • NavBackStack artık NavKey türü için geneldir. Bu sayede uygulamalar ve kitaplıklar, NavKey ile sınırlı kalmak yerine eski yığınları için özel anahtar türleri tanımlayabilir. (I4d190,Iad2f4, b/420443609)
  • NavBackStack artık @kotlinx.serialization.Serializable oldu. 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çin commonMain konumuna taşındı. (Id69e7, b/420443609)

Hata Düzeltmeleri

  • NavDisplay artık her bir NavEntry öğesini doğru Lifecycle.State klasörüne taşıyor. (I30aac, b/440145700)
  • NavDisplay öğesinin, NavigationEvent kitaplığının LocalNavigationEventDispatcherOwner aracı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

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 Runtime yapılarına yeni Kotlin MultiPlatform (KMP) hedefleri eklendi. Navigation3 Runtime artı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 UI yapısı için KMP hedefleri sağlamaz. Diğer platformlarda kendi özel NavDisplay uygulamanı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.
  • NavDisplayInfo nesnesi artık herkese açık ve NavDisplay ü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 rememberNavBackStack ile birlikte kullanılacak yeni bir NavBackStackSerializer eklendi. rememberNavBackStack() artık kendi yapılandırmanızı sağlamak için kullanılabilecek bir SavedStateConfiguration da 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ğlanan key öğesinin String olmadığı veya NavEntry öğenizin contentKey öğesini geçersiz kılıp key öğesine eşit olarak ayarlamadığı tüm durumlarda yaşam döngüsünü bozdu (bunu yapmanın, anahtarınızın bir Bundle öğ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

API Değişiklikleri

  • SavedStateNavEntryDecorator artık durumları kaydetmek ve geri yüklemek için SaveableStateProvider'te yerleşik olarak bulunan SaveableStateRegistry özelliğini kullanıyor. (If8d9a)
  • predictivePopTransitionSpec artı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

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

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 kesinlikle NavDisplay öğ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.content artık gizli. NavEntry içeriğini çağırmak için, artık çağrılacak bir key parametresi gerektirmeyen yeni NavEntry.Content() API'sini çağırın. (Icd0fd, b/420991203)
  • NavEntry.key artık gizli bir alan. NavEntry ve ilgili durumları, yeni contentKeyFactory lambda'dan oluşturulan ve varsayılan olarak NavEntry.key'ten oluşturulan kaydedilebilir bir karma değere ayarlanan yeni contentKey alanı 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.compose yapı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 bir backStack örneğiyle değiştirilen backStacks iç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

  • SavedStateNavEntryDecorator ile 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.