navigation3

  
Navigation 3, Compose ile çalışmak üzere 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ü
28 Ocak 2026 1.0.0 - - 1.1.0-alpha03

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 okuyun.

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.1.0-alpha03"
    implementation "androidx.navigation3:navigation3-ui:1.1.0-alpha03"
}

Kotlin

dependencies {
    implementation("androidx.navigation3:navigation3-runtime:1.1.0-alpha03")
    implementation("androidx.navigation3:navigation3-ui:1.1.0-alpha03")
}

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 olursa 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.

Bu yapıyla ilgili sürüm notu yok.

Sürüm 1.1

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ş 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 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 sayede 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, SharedTransitionScope değerini NavDisplay veya rememberSceneState parametresine ileterek etkinleştirebilirsiniz. (I15868)

Sürüm 1.0

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ıza göz atın, 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şmedi: Geçiş devam ediyorsa STARTED ile sınırlanmaya devam eder ve bu NavEntry, arka yığından çıkarılıp animasyonla kaldırılıyorsa 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 oluşan sonsuz döngü sorunu düzeltildi. (Iba3f0, b/450323470)
  • backStack, NavDisplay ile 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önteminizin (yani rememberMySceneStrategy() yönteminde) oluşturulmasına taşıyabilirsiniz. Bu yöntem, herhangi bir rememberSaveable değerinin veya anahtar 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)
  • NavDisplay ve SceneStrategy'ye iletilen onBack lambda'sı, birden fazla girişin ne zaman açılması gerektiğini belirten bir count: Int parametresi sağlamaz. Bunun yerine, () -> Unit lambda'sı, Sahne isteklerinizin birden fazla girişin gösterilmesini istediği nadir durumlarda 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 yeni bir ikincil oluşturucuya sahip nihai bir NavEntry sınıfıyla değiştirin. Bu sayede, bir 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 NavEntryDecorator sınıfı eklendi.NavEntryDecorator (If81f8, b/444447434, b/447381176)
  • SavedStateNavEntryDecorator, girişleri SaveableStateHolder ile süslediği için SaveableStateHolderNavEntryDecorator olarak yeniden adlandırıldı. İşlevsel olarak NavEntryDecorator için bir fabrika olduğundan, dekoratör de işlevden sınıfa 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(), herkese açık API yüzeyinden kaldırıldı. Bu işlev artık manuel olarak eklemeniz gerekmeden varsayılan olarak dahil ediliyor. (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 yönelik yeni bir meta veri alanı bulunur. Bu, bir Sahne'nin NavDisplay üzerindeki meta verileri (ör. geçişlerle) geçersiz kılmasına olanak tanır. (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)
  • Herkese açık API'yi kaldırın DecorateNavEntry. Bunun yerine, bir NavEntry'yi dekoratör listesiyle sarmak 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 Scene ve Scene arasındaki geçişleri ö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ş NavigationEventState'leri 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 geliyor. (I431d0, b/444449993)
  • Dekore edilecek NavEntry listesini alan yeni bir rememberDecoratedNavEntries aşırı yüklemesi eklendi. Girişler, diğer giriş dekoratörleriyle önceden süslenmiş olabilir. (I5a034, b/444230270)
  • Navigation3 joker karakter türü parametrelerini kaldırma (I02540)
  • entryProvider DSL'de genel türlerin 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üklemesini Android ile kısıtlayı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 dışı 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, tahmini 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, geri yığınları için NavKey ile sınırlı kalmak yerine ö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'e taşındı. (Id69e7, b/420443609)

Hata Düzeltmeleri

  • NavDisplay artık her bir NavEntry öğesini doğru Lifecycle.State konumuna taşıyor. (I30aac, b/440145700)
  • NavDisplay öğesinin, NavigationEvent kitaplığının LocalNavigationEventDispatcherOwner aracılığıyla ayarlanan tüm 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 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ı kullanmanı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 sahneler yerine tek tek girişlere 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 (bunu yapmanın anahtarınızın Bundle öğesine kaydedilmesini zorunlu kıldığını unutmayın) tüm durumlarda yaşam döngüsünün bozulmasına neden oluyordu. Bu hata, 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'de yerleşik olarak bulunan 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 durumu artık kesinlikle NavDisplay'a 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ız boyunca dekoratörlerin değiştirilmesi gerekir. 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 artık çağırmak için key parametresi gerektirmeyen yeni NavEntry.Content() API'sini çağırın. (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'den (I81a6c, b/422001357, b/420991203 I2d7d4, b/420991203, b/422841812) oluşturulan kaydedilebilir bir karma olan yeni contentKey alanı ile tanımlanmalıdır.

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 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 iptal edilir. 1.0.0-alpha01 sürümü bu commit'leri içerir.

Yeni Özellikler

Navigation3, Jetpack Compose uygulama içi gezinmeyi işlemek 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, 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.