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ü
23 Eylül 2026 1.2.0 - - 1.3.0-alpha01

Bağımlılıkları bildirme

navigation3'e bağımlılık eklemek için Google Maven deposunu projenize eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposunu inceleyin.

Uygulamanız veya modülünüz için build.gradle dosyasına ihtiyacınız olan yapılarla ilgili bağımlılıkları ekleyin:

Groovy

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

Kotlin

dependencies {
    implementation("androidx.navigation3:navigation3-runtime:1.3.0-alpha01")
    implementation("androidx.navigation3:navigation3-ui:1.3.0-alpha01")
}

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 bildiriminiz Jetpack'in iyileştirilmesine yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmeye yönelik fikirleriniz varsa lütfen 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 soruna oyunuzu ekleyebilirsiniz.

Yeni sorun oluşturma

Daha fazla bilgi için Sorun İzleyici belgelerini inceleyin.

Sürüm 1.3

Sürüm 1.3.0-alpha01

23 Eylül 2026

androidx.navigation3:navigation3-*:1.3.0-alpha01 iptal edilir. 1.3.0-alpha01 sürümü bu commit'leri içerir.

** Hata Düzeltmeleri **

  • NavDisplay'da DeferredAnimatedContent'ye geçiş yapılarak ve geçiş devri sorunları çözülerek tahmin edilen geri gitme animasyonunun devriyle ilgili sorun düzeltildi. I145eaedd b/430807423

Bu yapı için sürüm notu yok.

Sürüm 1.2.0

23 Eylül 2026

androidx.navigation3:navigation3-*:1.2.0 iptal edilir. 1.2.0 sürümü bu commit'leri içerir.

1.2.0 sürümü artık kararlı!

1.1.0 sürümünden beri yapılan önemli değişiklikler

Result API

  • Bu yeni API, LocalResultEventBus ve ResultEventBusNavEntryDecorator tarafından sağlanan ResultEventBus kullanılarak NavEntries arasında sonuçların iletilmesine olanak tanır.
  • rememberResultEventBus, ResultEventBus öğesini ResultEventBusNavEntryDecorator dışında yükseltmeyi ve rememberResultEventBusNavEntryDecorator öğesine iletmeyi desteklemek için 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 üzerinden androidx.navigation3.runtime.deeplink'da 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. requestExtras DSL ve RequestExtrasKey<T> ile oluşturulan tür güvenli RequestExtras kapsayıcısı kullanılarak ek istek meta verileri eklenebilir.
  • DeepLinkMatcher: DeepLinkRequest ile eşleştirilebilen bir derin bağlantıyı temsil eder. Her eşleştirici örneği, bu derin bağlantıyı destekleyen gezinme anahtarıyla ilişkilendirilir. Bir gezinme anahtarı birden fazla eşleştiriciyle ilişkilendirilebilir. DeepLinkMatcher.match işlevi, eşleşme başarılı olursa ilişkili gezinme anahtarını içeren bir MatchResult döndürür. İki varsayılan DeepLinkMatcher uygulaması vardır: Uri temelinde derin bağlantıları eşleştirmek için UriDeepLinkMatcher ve yalnızca Boole ile eşleşen DeepLinkMatcher.Filter ile derin bağlantıları eşleştirmek için StaticKeyDeepLinkMatcher.
  • BackStackMatcher: Başarılı bir derin bağlantı eşleşmesi üzerine sentetik bir geri yığın oluşturmak için DeepLinkMatcher. BackStackMatcher, DeepLinkMatcher.withBackStack uzantı işleviyle oluşturulabilir.

Tahmini Geri İşleme

  • SceneState ile tahmin edilen geri gitme işleme (onBackCompleted ve onBackCancelled) arasındaki bağlantıyı 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 gezinmeyi ve tahmin edilen geri gitme hareketlerini destekleyebilir.
  • İleri animasyonlar sırasında yarıda tetiklenen tahmin edilen geri gitme hareketleri için destek 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şimi olarak ayarlanıyor. Bu sayede, farklı arayüzlerde aynı basit adı paylaşan data object anahtarları arasında anahtar çakışmaları önleniyor.
  • EntryProvider artık eşleştirmede anahtar türleri yerine anahtar örneklerine göre ö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 iptal edilir. 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 iptal edilir. 1.2.0-beta01 sürümü bu commit'leri içerir.

API Değişiklikleri

  • DeepLinkRequest.extras, Map<String, Any> değerinden RequestExtrasKey<T> ile T çiftlerini depolayan yeni bir tür güvenli harita benzeri sınıf olan RequestExtras olarak yeniden düzenlendi. RequestExtras, requestExtras DSL ile başlatılabilir. (Ic929d, b/543883369)

Hata Düzeltmeleri

  • İleri geçiş sırasında tetiklenen tahmini geri hareketlerinin kaydırma ilerlemesine yanıt olarak animasyon oluşturmamasına neden olan sorun düzeltildi. Tahmin edilen geri gitme artık düzgün şekilde animasyonlu olarak tamamlanacak. (Icdcb0, b/456218398)
  • Scene uygulamalarının veri sınıfları olmasını veya uygun olduğunda aynı Scene'nın 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() birleşimidir. Bu, aynı adı paylaşan ancak farklı arayüzler uygulayan veri nesnelerinin artık aynı contentKey'ye sahip olmamasını sağlar. Ancak JS platformunun key::class işlevi, tam nitelikli ad yerine yalnızca basit sınıf adını döndürür. Bu nedenle, JS platformu, adları yinelenen 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 hatası düzeltildi. (I4d728, b/516312097)

Sürüm 1.2.0-alpha07

29 Temmuz 2026

androidx.navigation3:navigation3-*:1.2.0-alpha07 iptal edilir. 1.2.0-alpha07 sürümü bu commit'leri içerir.

API Değişiklikleri

  • Başka bir DeepLinkMatcher.MatchResult sarmak için soyut bir WrappedMatchResult sınıfı eklendi. Bu sayede, özelleştirilmiş maç sonuçları başka bir maç sonucunun üzerine yerleştirilebilir. (I7d4dc, b/470282247)

  • İki parametre alan yeni BackStackMatcher sınıfı eklendi: eşleştirici örneği ve giriş eşleştiricinin eşleşme sonucunu sağlayan ve geri yığın döndüren bir oluşturucu lambda. Başarılı bir eşleşme durumunda BackStackMatcher, lambda ile oluşturulan geri yığınla birlikte orijinal eşleşme sonucunu içeren WrappedMatchResult öğesini genişleten bir BackStackMatchResult döndürür. BackStackMatcher yalnızca yeni DeepLinkMatcher.withBackStack uzantı işleviyle oluşturulabilir. (Ibf987, b/470282247)

  • value : T öğesini String olarak kodlamak ve kodunu çözmek için KSerializer öğesini genişleten bir soyut 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 DeepLinkMatcher.match() tarafından döndürülen alt sınıflı MatchResult öğesinin özelliklerine tür dönüştürme olmadan erişebilmesi için out R : DeepLinkMatcher.MatchResult<T> ikinci bir tür parametresi ekledi. (I693d3, b/470282247)

  • DeepLinkMatcher.MatchResult's T üst sınırı Any?'den Any'ye değişti. (I6bf1a)

  • DeepLinkRequest oluşturucu alanı uri artık varsayılan olarak null değerini alıyor. İkincil oluşturucunun uriString adı uri olarak değiştirildi. (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ştirme 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ış gibi 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, değişmez boş dize olarak kabul edilir. Aksi takdirde, boş değer, değer sağlanmamış gibi 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 eşleştirmede anahtar türleri yerine anahtar örneklerine göre öncelik veriyor. (Ib5ec9, b/533331924)
  • SceneState artık en üstteki yer paylaşımı içermeyen sahneden başlayarak önceki sahneleri 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 iptal edilir. 1.2.0-alpha06 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Joker karakterli parçaların herhangi bir girişle eşleşeceği ancak girişin bağımsız değişken olarak çıkarılmayacağı netleştirilerek URI parçalarıyla ilgili UriDeepLinkMatcher dokümanı düzeltildi. (I5ad9b, b/524677091)
  • URI kalıbı şema içermiyorsa veya çift eğik çizgiyle başlamıyorsa UriDeepLinkMatcher öğesinin 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 iptal edilir. 1.2.0-alpha05 sürümü bu commit'leri içerir.

Yeni API

  • rememberResultEventBus API'si eklendi. Bu API, rememberResultEventBusNavEntryDecorator'ye iletilebilen bir ResultEventBus döndürür. Bu, ResultEventBus öğesinin ResultEventBusNavEntryDecorator dışında yükseltilmesine olanak tanır. (Ia655b, b/516995400)

DeepLinkRequest

  • KMP ile uyumlu iki oluşturucu eklendi. Bunlardan biri DeepLinkUri, diğeri ise ham dize uri alır. (I3c088, b/513200887, b/522194187)
  • (Yalnızca Android) Intent alan bir oluşturucu eklendi. (Ia0498, b/513200887, b/522194187)
  • Tüm oluşturucularda, ek istek bilgilerini eklemek için Map<String, Any> alanına yönelik ek bir extras alanı bulunur. (If81d5, b/513200887)
  • Ekstraların haritasını oluşturmak için tür açısından güvenli bir yöntem olarak yeni bir requestExtras dsl eklendi. DSL, RequestExtrasKey ile Any çiftlerini depolamak için put işlevini sağlar. Map<String, Any>.get(key) uzantı işlevi, RequestExtrasKey(I5091c, b/513200887) ile haritadan okumak için kullanılabilir.
  • (Yalnızca Android) ActionExtrasKey ile ekstralar haritası oluşturmak için ActionExtrasKey ve actionExtra işlevleri eklendi. (Id0c90, [b/513200887]
  • MimeTypeExtrasKey ile ekstralar haritası oluşturmak için MimeTypeExtrasKey ve mimeTypeExtra işlevi eklendi. (I85131, b/513200887)

DeepLinkMatcher

  • DeepLinkMatcher.mimeTypeFilter ve DeepLinkMatcher.actionFilter işlevleri eklenerek DeepLinkRequest öğelerini mimeType veya action'ye göre filtreleyen DeepLinkMatcher.Filters oluşturuldu (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ı. Bir Intent ve ekstralar haritası 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 alt sınıfları artık kovaryant T (out T) alıyor. Böylece, hiyerarşik anahtarlar Matcher'larla kullanıldığında tür dönüşümü yapılması gerekmeyecek. (I1e453, b/525094876)
  • Arguments map için UriMatchResult oluşturucu parametresi artık varsayılan olarak boş bir harita olur. (I3acdd)
  • DeepLinkMatcher.Filter soyut sınıfı artık işlevsel bir arayüz. filter oluşturucu alanı kaldırıldı ve bunun yerine doğrudan alt sınıfa iletilmesi gerekiyor. (I9eb7d, b/522194187)

Hata Düzeltmeleri

  • Lambda değerleri içeren iç içe yerleştirilmiş meta verileri olan bir girişe geçiş yapıldığında 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 oluşturmak yerine boş UriMatchResult döndürecek şekilde UriDeepLinkMatcher düzeltildi. (I5322f, b/524663005)
  • HTTPS şeması içeren bir UriDeeplinkMatcher yalnızca HTTPS şeması içeren isteklerle eşleştirilebilir. (Ibfe22, b/522304329)
  • Bir DeepLinkRequest öğesini UriDeepLinkMatcher ile eşleştirirken http şemasını https ile olumlu bir eşleşme olarak doğru şekilde tanımlamak için UriDeepLinkMatcher öğesini düzeltin. (I3a62b, b/518804264)
  • DeepLinkMatcher.MatchResult karşılaştırıcısı, iki sonuç eşit olduğunda varsayılan olarak 0 değerini döndürüyor. (I48ddb, b/518841353)
  • UriDeepLinkMatcher, artık gerekli bağımsız değişkenler eksik olduğundan eşleşme isteği başarısız olduğunda istisna oluşturmak yerine boş 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 iptal edilir. 1.2.0-alpha04 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • ModalBottomSheet gibi iç içe yer paylaşımlarının, üzerindeki yer paylaşımları kaldırı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 iptal edilir. 1.2.0-alpha03 sürümü bu commit'leri 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 bir derin bağlantı isteği. Yeni sınıfla birlikte, uri, mimeType veya action ile örnek oluşturmak için yardımcı işlevler de bulunur. Android platformunda, bir 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ştirilebilen bir derin bağlantıyı temsil eder. Her eşleştirici örneği, bu derin bağlantıyı destekleyen gezinme anahtarıyla ilişkilendirilir. Bir gezinme anahtarı birden fazla eşleştiriciyle ilişkilendirilebilir. DeepLinkMatcher.match işlevi, eşleşme başarılı olursa ilişkili gezinme anahtarını içeren bir MatchResult döndürür. İki varsayılan DeepLinkMatcher uygulama vardır: UriDeepLinkMatcher, URI'ye göre derin bağlantıları eşleştirmek için, StaticKeyDeepLinkMatcher ise yalnızca DeepLinkMatcher.Filter ile eşleşen derin bağlantıları Boolean ile eşleştirmek için kullanılır. (I3798e, b/470282247)

  • UriDeepLinkMatcher, DeepLinkMatcher'nin DeepLinkUri ile Serializable bir gezinme anahtarını eşleştirerek derin bağlantıyı işleyen, kendi içinde tutarlı bir uygulamasıdır. Primitive türlerinin veya Listeler, Diziler ve Kümeler gibi Primitive Koleksiyonlarını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'ın 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örüntülenirken AnimatedBottomSheetSample'nın IllegalArgumentException sorunu düzeltildi. Örnek SceneStrategy artık son OverlayScene olmayan öğeyi doğru şekilde hesaplayacak ve tüm yer paylaşımı sahnelerinin altında gösterecek. (If2281, b/506733412)
  • Android Studio Önizlemeleri'nde Tahmin Edilen Geri Gitme özelliğini etkinleştirmek için inceleme modundayken no-op NavigationEventHandler'ı kaldıran NavigationEvent bağımlılığı 1.1.1 sürümüne yükseltildi. (I487fd)

Sürüm 1.2.0-alpha02

22 Nisan 2026

androidx.navigation3:navigation3-*:1.2.0-alpha02 iptal edilir. 1.2.0-alpha02 sürümü bu commit'leri içerir.

API Değişiklikleri

  • onBack öğesini onBackCompleted olarak yeniden adlandırın ve iptal edilen geri hareketlerin işlenmesini desteklemek için NavigationBackHandler'a onBackCancelled ekleyin. (I92741)
  • SceneState kullanırken geri gitme hareketlerini ve tahmin edilen geri gitme özelliğini kolaylaştırmak 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şleme özelliğiyle SceneState bağlantısını basitleştirmek için rememberNavigationEventState ekleyin. (Iae49c)

Yeni Özellikler

  • Yeni ResultEventBusNavEntryDecorator tarafından sağlanan LocalResultEventBus ile NavEntry'ler arasında sonuçların iletilmesine olanak tanıyan bir ResultEventBus API'si eklendi. Sonuçlarda iletilenler, ResultEventBus#conflateAsState ile durum veya ResultEffect ile sonuç akışı olarak değerlendirilebilir.

Sürüm 1.2.0-alpha01

8 Nisan 2026

androidx.navigation3:navigation3-*:1.2.0-alpha01 iptal edilir. 1.2.0-alpha01 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • LocalNavAnimatedContentScope uygulamasına OverlayScene üzerinden erişmek artık IllegalStateException hatasına neden olmayacak. Çünkü OverlayScenes artık no-op LocalAnimatedContentScope ile sağlanıyor. (I2f00c, b/486067688)

Sürüm 1.1.7

26 Ağustos 2026

androidx.navigation3:navigation3-*:1.1.7 iptal edilir. 1.1.7 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • İleri geçiş sırasında tetiklenen tahmini geri hareketlerinin kaydırma ilerlemesine yanıt olarak animasyon oluşturmamasına neden olan sorun düzeltildi. Tahmin edilen geri gitme artık düzgün şekilde animasyonlu olarak tamamlanacak. (Icdcb0, b/456218398)

Sürüm 1.1.6

12 Ağustos 2026

androidx.navigation3:navigation3-*:1.1.6 iptal edilir. 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() birleşimidir. Bu sayede, aynı adı paylaşan ancak farklı arayüzleri uygulayan veri nesneleri artık aynı contentKey'ye sahip olmayacak. Ancak JS platformunun key::class işlevi, tam nitelikli ad yerine yalnızca basit sınıf adını döndürür. Bu nedenle, JS platformu, adları yinelenen veri nesneleri için özel contentKey işlevini uygulamaya devam etmelidir. (I1fbbb, b/512534342)
  • Geri yığından hızlıca açılan birden fazla pop geçişi aynı anda devam ederken anahtarın yeniden kullanılması 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 iptal edilir. 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>{ ... }) göre öncelik veriyor.(Ib5ec9, b/533331924)

Sürüm 1.1.4

1 Temmuz 2026

androidx.navigation3:navigation3-*:1.1.4 iptal edilir. 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 verileri olan bir girişe geçiş yapıldığında 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 iptal edilir. 1.1.3 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • ModalBottomSheet gibi iç içe yer paylaşımlarının, üzerindeki yer paylaşımları kaldırıldığında beklenmedik şekilde yeniden animasyon oluşturmasına neden olan yer paylaşımı animasyonu sorunu düzeltildi. (Ia2b9e, b/502624496)

  • Android Studio Previews'da Tahmini Geri özelliğini etkinleştirmek için inceleme modundayken NavigationEventHandler bağımlılığı 1.1.2 sürümüne yükseltildi. Bu sürümde, işlem yapmayan NavigationEvent kaldırıldı.

Sürüm 1.1.2

19 Mayıs 2026

androidx.navigation3:navigation3-*:1.1.2 iptal edilir. 1.1.2 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Android Studio Önizlemeleri'nde Tahmini Geri özelliğini etkinleştirmek için inceleme modundayken no-op NavigationEventHandler öğesini kaldıran NavigationEvent bağımlılığı 1.1.1 sürümüne yükseltildi.

Sürüm 1.1.1

22 Nisan 2026

androidx.navigation3:navigation3-*:1.1.1 iptal edilir. 1.1.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • LocalNavAnimatedContentScope uygulamasına OverlayScene üzerinden erişmek artık IllegalStateException hatasına neden olmayacak. Çünkü OverlayScenes artık no-op LocalAnimatedContentScope ile sağlanıyor. (I2f00c, b/486067688)

Sürüm 1.1.0

8 Nisan 2026

androidx.navigation3:navigation3-*:1.1.0 iptal edilir. 1.1.0 sürümü bu commit'leri içerir.

1.1.0 sürümü artık kararlı!

1.0.0 sürümünden beri yapılan önemli değişiklikler

Sahneler Arasındaki Paylaşılan Öğeler - Navigation3 artık sahneleri paylaşılan öğe nesnesi olarak ele almayı destekliyor. Bu sayede, sahneler değiştiğinde sorunsuz bir geçiş sağlanabilir. Bu özelliği, SharedTransitionScope değerini NavDisplay veya rememberSceneState parametresine ileterek etkinleştirebilirsiniz.

SceneDecoratorStrategy - Sahneleri ortak kullanıcı arayüzü bileşenleriyle süsleme veya sahneler arasında durum paylaşma gibi kullanım alanlarını desteklemek için SceneDecoratorStrategy tanıtıldı.

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 sayede, NavDisplay geçişleri için yeni NavMetadataKeys eklendi. Böylece, NavDisplay geçişleri eklemek için yeni meta veri DSL'siyle kullanılabilirler.

OverlayScene Animasyonları - OverlayScene arayüzünde yeni bir onRemoved askıya alma geri çağırması var. Bu geri çağırma, sahneyle ilişkili bir anahtar arka yığından kaldırıldıktan sonra ancak kompozisyondan ayrılmadan önce çağrılır. Bu, onRemoved içinde çağrılan çıkış animasyonlarının, yer paylaşımı sahnesi kompozisyondan kaldırılmadan önce tamamlanmasına olanak tanır.

Diğer Değişiklikler - NavDisplay ve rememberSceneState artık then sonekiyle zincirlenen önceki tek SceneStrategy parametresi yerine List<SceneStrategy> parametresini alıyor. Artık EntryProvider DSL aracılığıyla giriş kodu dikkate alınarak meta verileri dinamik olarak ekleyebilirsiniz.

Sürüm 1.1.0-rc01

25 Mart 2026

androidx.navigation3:navigation3-*:1.1.0-rc01 iptal edilir. 1.1.0-rc01 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • NavDisplay artık yer paylaşımlarının altında gösterilen girişlerin Lifecycle değerinin STARTED ile sınırlandırılmasını sağlıyor. Bu sayede, iletişim kutuları kullanılırken dropUnlessResumed gibi API'lerin çalışmaya devam etmesi sağlanır. (If209f, b/483966071)
  • NavDisplay'da aynı ekranlar arasında ileri geri gezinmenin ve iki ekran arasındaki animasyonları kesintiye uğratmanın, ekranların z-sırasının yanlış olmasına neden olabileceği sorun düzeltildi. (I4d491, b/459419800)

Sürüm 1.1.0-beta01

11 Mart 2026

androidx.navigation3:navigation3-*:1.1.0-beta01 iptal edilir. 1.1.0-beta01 sürümü bu commit'leri içerir.

Sürüm 1.1.0-alpha05

25 Şubat 2026

androidx.navigation3:navigation3-*:1.1.0-alpha05 iptal edilir. 1.1.0-alpha05 sürümü bu commit'leri içerir.

API Değişiklikleri

  • NavDisplay ve rememberSceneState artık then sonekiyle zincirlenen önceki tek SceneStrategy parametresi yerine List<SceneStrategy> parametresini alıyor. 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 belirli bir NavMetadataKey içerip içermediğini kontrol etmek için meta verilerde #contains operatörü eklendi. (Ic30db, b/485311895)
  • Meta veri DSL'si ile kullanılacak 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 iptal edilir. 1.1.0-alpha04 sürümü bu commit'leri 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, NavMetadataKey için yeni NavDisplay geçişleri de eklendi. Böylece, NavDisplay'ye 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 araması var. Bu geri çağırma, sahneyle ilişkili bir anahtar arka yığından kaldırıldıktan sonra ancak kompozisyondan ayrılmadan önce çağrılır. Bu, onRemoved içinde çağrılan çıkış animasyonlarının, yer paylaşımı sahnesi kompozisyondan kaldırılmadan önce tamamlanmasına olanak tanır. (I29a72, b/440558061)
  • SceneStrategy, dekorasyon işlevini yeni bir SceneDecoratorStrategy olarak ayırdı. Bu yeni arayüz, sahneleri süslemek için kullanılmalıdır. NavDisplay ve rememberSceneState için SceneDecoratorStrategies eklenmesine olanak tanıyan yeni API'ler var. (If9385, b/477669607, b/477670333)

Hata Düzeltmeleri

  • SharedTransitionLayout öğesinin NavDisplay veya rememberSceneState içine aktarılması ve herhangi bir OverlayScene öğesinin kullanılması durumunda kilitlenmeye neden olan hata düzeltildi. Bunun nedeni, SharedTransitionLayout öğesinin yalnızca AnimatedContent öğesinin bir parçası olarak oluşturulan NavEntries öğeleriyle çalışması ve OverlayScene öğelerinin kendi pencerelerinde ayrı ayrı oluşturulmasıdır. (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 düzeltme, AndroidStudio önizlemeleri sırasında NavDisplay kullanılması nedeniyle oluşan IllegalStateException sorununu giderir. (Id7212, b/477149762)

Sürüm 1.1.0-alpha03

28 Ocak 2026

androidx.navigation3:navigation3-*:1.1.0-alpha03 iptal edilir. 1.1.0-alpha03 sürümü bu commit'leri içerir.

Yeni Özellikler

  • Artık EntryProvider DSL aracılığıyla giriş kodu dikkate alınarak 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 iptal edilir. 1.1.0-alpha02 sürümü bu commit'leri içerir.

Yeni Özellikler

  • SceneStrategy artık yeni calculatedScene(Scene) işleviyle sahneleri iç içe yerleştirmeyi destekliyor. Bu nedenle, SceneStrategy'lar diğer sahnelerde ek işlevler sunacak şekilde özelleştirilebilir. (I5df7c,b/440333896)

Sürüm 1.1.0-alpha01

3 Aralık 2025

androidx.navigation3:navigation3-*:1.1.0-alpha01 iptal edilir. 1.1.0-alpha01 sürümü bu commit'leri içerir.

API Değişiklikleri

  • Navigation3 artık sahnelerin paylaşılan öğe nesnesi olarak ele alınmasını destekliyor. Bu sayede, sahneler değiştiğinde sorunsuz bir geçiş sağlanabilir. Bu özelliği, NavDisplay veya rememberSceneState'ye 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 iptal edilir. 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 düzeltme, AndroidStudio önizlemeleri sırasında NavDisplay kullanılması nedeniyle oluşan IllegalStateException sorununu giderir. (Id7212, b/477149762)

Sürüm 1.0.0

19 Kasım 2025

androidx.navigation3:navigation3-*:1.0.0 iptal edilir. 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 navigasyon için 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 iptal edilir. 1.0.0-rc01 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • NavDisplay artık Scene düzeyinde bir LocalLifecycleOwner ayarlıyor. Bu sayede sahne yazarları, Lifecycle.State değerinin RESUMED olup olmadığını kontrol ederek tüm geçişlerin tamamlanıp tamamlanmadığını belirleyebiliyor. NavEntry düzeyindeki LocalLifecycleOwner davranışı değişmeden kalır: Geçiş devam ediyorsa STARTED ile sınırlanmaya devam eder ve söz konusu NavEntry eski yığından çıkarılıp animasyonla kaldırılıyorsa ek olarak CREATED ile sınırlanır. (I03113, b/454045829)

Sürüm 1.0.0-beta01

22 Ekim 2025

androidx.navigation3:navigation3-*:1.0.0-beta01 iptal edilir. 1.0.0-beta01 sürümü bu commit'leri içerir.

API Değişiklikleri

  • SceneStrategyScope artık yalnızca bağımsız olarak SceneStrategy ve döndürülen Scene öğenizi test etmeye uygun, bağımsız değişken içermeyen bir herkese açık oluşturucuya sahip. Daha karmaşık kullanım alanları için lütfen rememberSceneState() kullanın. (I8440c, b/451679047)

Hata Düzeltmeleri

  • SceneStrategy ile then'yi zincirleme bağlarken yaşanan sonsuz döngü sorunu düzeltildi. (Iba3f0, b/450323470)
  • backStack öğesi NavDisplay öğesiyle 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 iptal edilir. 1.0.0-alpha11 sürümü bu commit'leri içerir.

API Değişiklikleri

  • SceneStrategy üzerindeki calculateScene yöntemi artık @Composable değil. Bunun yerine, bu çalışmayı SceneStrategy yönteminizi oluşturma aşamasına (yani rememberMySceneStrategy() yöntemine) taşıyabilirsiniz. Bu yöntem, herhangi bir rememberSaveable değerinin veya temel remember ifadelerinin ömrünü doğru değerlere göre tam olarak tanımlamanıza olanak tanır. (If1733, b/448709506)
  • SceneStrategy.calculateScene için onBack parametresi, bunun isteğe bağlı bir parametre olduğunu daha net bir şekilde belirtmek ve gelecekteki Navigation3 özellikleri için bir uzantı noktası sağlamak amacıyla SceneStrategyScope'nin yeni alıcı kapsamına taşındı. (I3aea3, b/448460407)
  • onBack lambda'sı NavDisplay ve SceneStrategy'ye iletildiğinde artık birden fazla girişin ne zaman açılması gerektiğini belirten bir count: Int parametresi sağlamıyor. Bunun yerine, nadir durumlarda sahne istekleriniz birden fazla giriş oluşturduğunda () -> Unit lambda art arda birden çok kez çağrılacak. (Idedb5, b/446989346)
  • NavEntryWrapper sınıfını kaldırın ve işlevini, yeni içerik içeren bir NavEntry alan birincil olmayan yeni bir oluşturucuya sahip nihai bir NavEntry sınıfıyla değiştirin. Bu sayede, girişi yeni içerikle sarmalama özelliği desteklenmeye devam edecektir. (I7da2a, b/444447130)
  • navEntryDecorator işlevi kaldırıldı ve yerine artık herkese açık olan ve alt sınıflara ayrılabilen NavEntryDecoratorNavEntryDecorator sınıfı eklendi. (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 işlevden sınıfa da yeniden düzenlendi. (Ie6013, b/447381176)
  • NavDisplay yerine SceneState kullanan özel gösterimlerin artık dahili olan LocalEntriesToRenderInCurrentScene kompozisyon yerelini kullanması gerekmiyor. (Ic40ef, b/414668196)
  • SceneSetupNavEntryDecorator ve rememberSceneSetupNavEntryDecorator(), genel API yüzeyinden kaldırıldı. Bu işlev artık manuel olarak eklemenizi gerektirmeden varsayılan olarak dahil edilmektedir. (Ieae42, b/444479133)
  • NavEntry, DialogScene, SinglePaneScene ve SceneState artık eşittir işlevini kullanıyor. (I96121)
  • Sahne arayüzünde, NavDisplay için sahneye özel meta veriler eklemeye yarayan 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 tüm platformlardan çağrılabilmelerini sağlayan ortak API'nin bir parçasıdır. (I71af9, b/447147159)
  • Sınıfın, NavEntries oluşturmak için kapsam sağlayan bir Kotlin DSL'si olduğunu doğru şekilde yansıtmak amacıyla EntryProviderBuilder sınıfını EntryProviderScope olarak yeniden adlandırın. (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'e 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 iptal edilir. 1.0.0-alpha10 sürümü bu commit'leri içerir.

API Değişiklikleri

  • rememberDecoratedNavEntries ile süslenmiş NavEntry<T> listesini alan yeni bir NavDisplay aşırı yüklemesi ekleyin. (I4025b, b/441940314)
  • DialogScene, yeni bir pakete taşındı. (Ia5840)
  • Genel API'yi kaldırın DecorateNavEntry. Bunun yerine, NavEntry'yi bir dizi dekoratörle sarmalamak için rememberDecoratedNavEntries kullanın. (Id8c09)
  • Navigation3 kullanıcı arayüzü artık yeni varsayılan transitionSpec özellikleri sunuyor. (Ibcabd)
  • Sahneleri yönetmeye yardımcı olacak yeni bir SceneState nesnesi eklendi. Bu, SceneState ve NavigationEventState değerlerini alan yeni bir NavDisplay aşırı yüklemesi de sağlar. (Idfb46, b/444479133)
  • NavDisplay artık Transition'nin currentState ve targetState özelliklerine bakarak, geçişleri ve Scene'a göre özelleştirmenize olanak tanıyor. (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ş NavigationEventStates'yi 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 nedenle, artık navigation3-runtime tarafından desteklenen tüm platformlarda kullanılabilirler. (I431d0, b/444449993)
  • Dekore edilecek NavEntry listesini alan yeni bir rememberDecoratedNavEntries aşırı yüklemesi eklendi. Girişler, diğer giriş dekoratörleriyle süslenmiş olabilir. (I5a034, b/444230270)
  • Navigation3 joker karakter türü parametrelerini kaldırma (I02540)
  • entryProvider DSL'si için genel öğelerin işlenmesi iyileştirildi. Daha önce androidx.navigation3.runtime.entry içe aktarıyorsanız artık bu işlem gerekli değildir. (I299fc)
  • Yansımaya dayalı NavBackStackSerializer aşırı yüklenmesini Android ile sınırlayın. Bu, çok platformlu kodda açık SavedStateConfiguration aşırı yüklemesinin kullanılmasını zorunlu kılarak Android dışı platformlarda örtülü ç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, Android olmayan platformlarda çalışma zamanı hatalarını önler. Çok platformlu durum kaydetme için rememberNavBackStack ile açık bir SavedStateConfiguration kullanın. (I1e418, b/420443609)

Hata Düzeltmeleri

  • İç içe yerleştirilmiş NavDisplay tek bir alt girişe sahip 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 iptal edilir. 1.0.0-alpha09 sürümü bu commit'leri içerir.

API Değişiklikleri

  • DecoratedNavEntryProvider, sağlanan dekoratörlerin listesiyle (I0fe1c, b/441328236) süslenmiş NavEntry'ler oluşturan ve döndüren rememberDecoratedNavEntries ile değiştirildi.
  • NavBackStack artık NavKey türü üzerinde geneldir. Bu sayede uygulamalar ve kitaplıklar, NavKey ile sınırlı kalmak yerine geri yığınları için özel anahtar türleri tanımlayabilir. (I4d190,Iad2f4, b/420443609)
  • NavBackStack artık @kotlinx.serialization.Serializable olduğundan, işlem sonlandırma ve yapılandırma değişiklikleri sırasında gezinme durumunu ek standart kod olmadan kaydetmek ve geri yüklemek mümkün. (I2c3cf, b/420443609)
  • RememberNavBackStack, tüm platform hedeflerinde sağlanması için commonMain konumuna taşındı. (Id69e7, b/420443609)

Hata Düzeltmeleri

  • NavDisplay artık her bir NavEntry öğesini doğru Lifecycle.State öğesine doğru şekilde taşıyor. (I30aac, b/440145700)
  • NavDisplay öğesinin, NavigationEvent kitaplığının LocalNavigationEventDispatcherOwner aracılığıyla ayarlanan tüm 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 iptal edilir. 1.0.0-alpha08 sürümü bu commit'leri içerir.

Yeni Özellikler

  • Navigation3 Runtime yapay ürünlerine yeni Kotlin MultiPlatform (KMP) hedefleri eklendi. Navigation3 Runtime artık toplamda şu platformları destekliyor: JVM (Android ve Masaüstü), Native (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ı yapmanız gerekir. 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 öğesinden 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 de alıyor. (I2f4d2, I4cd58, b/420443609)

Hata Düzeltmeleri

Bilinen Sorunlar

  • I8bf6d tarafından sunulan ve yaşam döngülerinin tek tek girişler yerine sahnelere göre belirlenmesine neden olan bir hata vardı. Bu hata, NavEntry öğesine sağlanan key öğesinin String olmadığı veya NavEntry öğenizin contentKey öğesini geçersiz kılıp key öğesine eşitlemediği durumlarda yaşam döngüsünün bozulmasına neden oluyordu (Bunu yapmanın, anahtarınızın Bundle öğesine kaydedilmesini zorunlu kıldığını unutmayın). Bu hata, 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 iptal edilir. 1.0.0-alpha07 sürümü bu commit'leri içerir.

MinSdk Güncellemesi

API Değişiklikleri

  • SavedStateNavEntryDecorator artık durumları kaydetmek ve geri yüklemek için SaveableStateProvider'ye yerleştirilmiş SaveableStateRegistry özelliğini kullanıyor. (If8d9a)
  • predictivePopTransitionSpec artık kaydırma kenarını parametre olarak sağlıyor. Bu sayede, kullanıcının Tahmin Edilen Geri Gitme hareketini hangi kenardan başlattığına bağlı olarak geçişi özelleştirebilirsiniz. (I753a8)

Hata Düzeltmeleri

  • En son sahne hatırlanmadığı için özel sahnelerin sonsuza kadar 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 iptal edilir. 1.0.0-alpha06 sürümü bu commit'leri 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 iptal edilir. 1.0.0-alpha05 sürümü bu commit'leri içerir.

Davranış Değişiklikleri

  • NavEntry'nın durumu artık kesinlikle NavDisplay'ye iletilen mevcut dekoratörler listesine dayanmaktadır. Bu nedenle, eski yığında NavEntry'lerin durumunu korumak için birden fazla eski yığın olması durumunda eski yığınlarınızda dekoratörler değiştirilmelidir. Aksi takdirde, girişler değiştirilmiş gibi değil, çıkarılmış gibi temizlenir. (I7a759, b/428033667)

Sürüm 1.0.0-alpha04

18 Haziran 2025

androidx.navigation3:navigation3-*:1.0.0-alpha04 iptal edilir. 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 yeni NavEntry.Content() API'sini çağırın. Bu API'yi çağırmak için artık key parametresi gerekmez. (Icd0fd, b/420991203)
  • NavEntry.key artık özel bir alan. NavEntry ve ilgili durumları, yeni contentKeyFactory lambda'dan oluşturulan ve varsayılan olarak NavEntry.key'ten oluşturulan kaydedilebilir bir karma olan yeni contentKey alanı ile 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 yapay ürününe bağlıdır.

Sürüm 1.0.0-alpha03

4 Haziran 2025

androidx.navigation3:navigation3-*:1.0.0-alpha03 iptal edilir. 1.0.0-alpha03 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Navigation3, artık değiştirilip başka bir backStack örneğiyle değiştirilen backStacks için dekoratör durumlarını temizlemeyecek. (I28a42, b/415076044)

Sürüm 1.0.0-alpha02

23 Mayıs 2025

androidx.navigation3:navigation3-*:1.0.0-alpha02 iptal edilir. 1.0.0-alpha02 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • SavedStateNavEntryDecorator ile ilgili, aynı özellik değerlerine sahip farklı veri sınıflarında çakışmalara neden olan 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 iptal edilir. 1.0.0-alpha01 sürümü bu commit'leri içerir.

Yeni Özellikler

Navigation3, Jetpack Compose uygulama içi gezinme işlemlerini yönetmek için özel olarak oluşturulmuş 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, içeriği geliştirici durumundaki değişikliklere göre 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.