Navigasyon

Navigation, hedefler Fragment, Activity veya başka bileşenler olarak uygulanmış olsa da tutarlı bir API sağlayan, Android uygulamasındaki "hedefler" arasında gezinmeye yönelik bir çerçevedir.
Son Güncelleme Kararlı Sürüm Sürüm Adayı Beta Sürümü Alfa Sürümü
28 Ocak 2026 2.9.7 - - -

Bağımlılıkları bildirme

Navigation'a 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

plugins {
  // Kotlin serialization plugin for type safe routes and navigation arguments
  id 'org.jetbrains.kotlin.plugin.serialization' version '2.0.21'
}
  
dependencies {
  def nav_version = "2.9.7"

  // Jetpack Compose Integration
  implementation "androidx.navigation:navigation-compose:$nav_version"

  // Views/Fragments Integration
  implementation "androidx.navigation:navigation-fragment:$nav_version"
  implementation "androidx.navigation:navigation-ui:$nav_version"

  // Feature module support for Fragments
  implementation "androidx.navigation:navigation-dynamic-features-fragment:$nav_version"

  // Testing Navigation
  androidTestImplementation "androidx.navigation:navigation-testing:$nav_version"

  // JSON serialization library, works with the Kotlin serialization plugin.
  implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3"
}

Kotlin

plugins {
  // Kotlin serialization plugin for type safe routes and navigation arguments
  kotlin("plugin.serialization") version "2.0.21"
}

dependencies {
  val nav_version = "2.9.7"

  // Jetpack Compose integration
  implementation("androidx.navigation:navigation-compose:$nav_version")

  // Views/Fragments integration
  implementation("androidx.navigation:navigation-fragment:$nav_version")
  implementation("androidx.navigation:navigation-ui:$nav_version")

  // Feature module support for Fragments
  implementation("androidx.navigation:navigation-dynamic-features-fragment:$nav_version")

  // Testing Navigation
  androidTestImplementation("androidx.navigation:navigation-testing:$nav_version")

  // JSON serialization library, works with the Kotlin serialization plugin
  implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.7.3")
}

Safe Args

Projenize Safe Args eklemek için üst düzey build.gradle dosyanıza aşağıdaki classpath öğesini ekleyin:

Groovy

buildscript {
    repositories {
        google()
    }
    dependencies {
        def nav_version = "2.9.7"
        classpath "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version"
    }
}

Kotlin

buildscript {
    repositories {
        google()
    }
    dependencies {
        val nav_version = "2.9.7"
        classpath("androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version")
    }
}

Ayrıca, mevcut iki eklentiden birini de uygulamanız gerekir.

Java veya karma Java ve Kotlin modüllerine uygun Java dil kodu oluşturmak için bu satırı uygulamanızın veya modülünüzün build.gradle dosyasına ekleyin:

Groovy

plugins {
  id 'androidx.navigation.safeargs'
}

Kotlin

plugins {
    id("androidx.navigation.safeargs")
}

Alternatif olarak, yalnızca Kotlin modüllerine uygun Kotlin kodu oluşturmak için şunları ekleyin:

Groovy

plugins {
  id 'androidx.navigation.safeargs.kotlin'
}

Kotlin

plugins {
    id("androidx.navigation.safeargs.kotlin")
}

AndroidX'e Taşıma bölümünde belirtildiği gibi, gradle.properties dosyanızda android.useAndroidX=true olmalıdır.

Kotlin uzantılarını kullanma hakkında bilgi edinmek için ktx dokümanlarına bakın.

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.

Sürüm 2.9

Sürüm 2.9.7

28 Ocak 2026

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

Hata Düzeltmeleri

  • Navigasyon SafeArgs, Google hizmetleriyle birlikte kullanılırken artık yapılandırma önbelleğe alma sorunları yaşamıyor. (I57cda, b/458071608)
  • Gezinme testinde SavedStateHandle oluşturucusunun List<String> kodunu çözmemesi sorunu düzeltildi. (I26aac,b/454180135)

Sürüm 2.9.6

5 Kasım 2025

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

Hata Düzeltmeleri

  • Navigation SafeArgs eklentisi, modern Android Gradle eklentisi API'lerine taşındı. Bu sayede, eklentinin tüm AGP 8.4.2 ve sonraki sürümleriyle uyumlu olması sağlanacak. Bu değişiklikler sonucunda, eklenti tarafından oluşturulan dosyaların çıkış dizini, AGP tarafından sağlanan varsayılan konuma değiştirildi. (Ie09d6, I7c431, b/203559535, b/293920476, b/269532448, b/443261197)
  • Gezinme SafeArgs eklentisi, AGP 9.0.0-alpha04+ ile kullanıldığında artık useAndroidX özelliğinin ayarlanmasını gerektirmeyecek. (I6c3a4, b/444746731, b/443106400)

Sürüm 2.9.5

24 Eylül 2025

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

Hata Düzeltmeleri

  • Navigation Safe Args artık AGP 9.0'ın yerleşik Kotlin desteğini işleyebilir. (I1d9d76)

Bağımlılık Güncellemesi

  • Navigation Safe Args Plugin artık Android Gradle Plugin 8.4.2 sürümüne bağlıdır. (b/431847270, I5932a)

Sürüm 2.9.4

10 Eylül 2025

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

Hata Düzeltmeleri

  • NavHost geçişinde işleyici devre dışı bırakıldıktan sonra kare ortasında tahmini geri etkinliği teslim edildiğinde kilitlenmeyi önleme. (I5667c, b/384186542)

Sürüm 2.9.3

30 Temmuz 2025

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

Hata Düzeltmeleri

  • NavController içinde, OnDestinationChangedListeners kullanılırken ConcurrentModificationException hatasına neden olan hata düzeltildi. (If7406, b/417784831)
  • navigate(uri, navOptions,navigationExtras) kullanılırken ekstraların yoksayıldığı hata düzeltildi. (I67fb7, b/430336813)

Sürüm 2.9.2

16 Temmuz 2025

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

Hata Düzeltmeleri

  • Girişin üzerindeki iletişim kutusu kapatıldığında girişin devam etmemesi sorunu düzeltildi (Idb20e, b/418746335).
  • Özel NavTypes kullanılırken tür güvenli rotalarla SavedStateHandle test edilirken oluşan MissingFieldException hatası düzeltildi. (I2f843, b/421002511)

Sürüm 2.9.1

2 Temmuz 2025

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

Hata Düzeltmeleri

  • Tek üst kullanılarak oluşturulan NavEntries öğelerinin Lifecycle.State içinde hiçbir zaman CREATED durumunun ötesine geçmemesine neden olan sorun düzeltildi. (I043ba, b/421095236)

Sürüm 2.9.0

7 Mayıs 2025

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

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

  • Navigasyon Safe Args işlemleri artık @CheckResult ek açıklamasıyla oluşturuluyor. Böylece bu işlemlerin kullanılması sağlanıyor.

SupportingPane Arayüzü

  • Özel Gezginler artık hedeflerini, SupportingPane arayüzünü uygulayan yerler olarak işaretleyebilir. Bu, NavController'a bu hedeflerin diğer hedeflerle birlikte gösterileceğini belirtir. Bu arayüzü kullanarak aynı anda birden fazla hedef RESUMED edilebilir.

Compose Kotlin Multiplatform

  • Gezinme artık Intent yerine NavDeepLinkRequest alan yeni bir ortak NavController.handleDeepLink() işlevi sunuyor. Bu sayede Android dışındaki platformlar derin bağlantıları düzgün şekilde işleyebilir. Teşekkürler Konstantin Tskhovrebov!
  • Navigasyon artık diğer platformlarda Android'in URI'si için uyumlu bir API olan yeni bir ortak ayrıştırıcı işlevi NavUri sunuyor. Bu sayede platformdan bağımsız bir şekilde URI oluşturulabilir. Teşekkürler Konstantin Tskhovrebov!

Tür güvenli işlevler

  • Daha önce yalnızca reified yöntemleriyle erişilebilen tür güvenli API'ler (ör. composable<YourScreen> artık doğrudan bir KClass örneği alan, somutlaştırılmamış sürümlere sahip.
  • Gezinme türü güvenliği artık değer sınıflarını rota olarak veya rotanın bağımsız değişken türü olarak destekliyor.

Sürüm 2.9.0-rc01

23 Nisan 2025

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

Hata Düzeltmeleri

  • Bu hedefler aslında çalışmadığı için Jetpack Navigation'dan Android dışı tüm platform hedefleri kaldırıldı. Artık farklı platformlar için saplamalar sağlanmaktadır.(I2877d)

Sürüm 2.9.0-beta01

9 Nisan 2025

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

API Değişiklikleri

  • parseStringAsNavUri'nın ortak API'si, bir dize alan NavUri fabrika işlevi olarak değiştirildi. (I4db6e, b/403616316)

Bağımlılık Güncellemeleri

  • Bu kitaplık artık Kotlin 2.0 dil seviyesini hedefliyor ve KGP 2.0.0 veya daha yeni bir sürüm gerektiriyor. (Idb6b5)

Sürüm 2.9.0-alpha09

26 Mart 2025

androidx.navigation:navigation-*:2.9.0-alpha09 iptal edilir. 2.9.0-alpha09 sürümü bu commit'leri içerir.

Yeni Özellikler

  • navigation-testing modülü artık Android'in yanı sıra masaüstü, Linux, macOS ve iOS'te de destekleniyor. (I2b770, b/398265336)
  • NavType artık Android'in yanı sıra masaüstü, Linux, macOS ve iOS'te de destekleniyor. (I297d8)

Sürüm 2.9.0-alpha08

12 Mart 2025

androidx.navigation:navigation-*:2.9.0-alpha08 iptal edilir. 2.9.0-alpha08 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Gezinme 2.8.9: Gezinme 2.8.8'de bulunan ve eşleşme olarak kabul edilmesi için derin bağlantı isteği veya amacının tüm alanlarıyla tam olarak eşleşen bir derin bağlantı gerektiren bir gerileme düzeltildi. Bu durum, kısmi alan eşleşmeleri içeren ve başka eşleşme içermeyen derin bağlantıların artık çalışmamasına neden oldu. (Ie5e36, b/399826566)

Harici Katkı (External Contribution)

  • NavUri oluşturmak için yeni ortak ayrıştırıcı işlevi. Teşekkürler Konstantin Tskhovrebov! (If0a6a)

Sürüm 2.9.0-alpha07

26 Şubat 2025

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

Hata Düzeltmeleri

  • Kapsayıcı olmayan pop ile saveState denendiğinde, geri yükleme sırasında kilitlenmeye neden olabilecek boş bir savedState ile sonuçlanmasına neden olan sorun düzeltildi. (I9f3e8, b/395091644)
  • Navigation 2.8.8 sürümünden itibaren: Bir derin bağlantı ve derin bağlantı isteğinin uri, işlem ve mime üzerinde tam olarak eşleşmesi gerektiği NavDeepLink eşleşme sorunu düzeltildi. Yalnızca bir veya iki alan eşleşiyorsa artık eşleştirme yapılamaz. (I3b029, b/395712033)
  • Navigation 2.8.8 sürümünde: Joker karakterli yolların eklenen derin bağlantıyla eşleşmemesine neden olan hata düzeltildi (I7ea92, b/389970341).

Harici Katkı (External Contribution)

  • Gezinme için ortak, gezinme için çalışma zamanı ve gezinme için oluşturma API'lerini ortak platforma ayıklayın. Teşekkürler Konstantin Tskhovrebov! (I1e626, Ica76f, Idf479)

Bilinen Sorunlar

  • b/395712033 numaralı sorunu giderme çalışmaları nedeniyle, derin bağlantıların derin bağlantı isteği ve/veya Intent ile aynı alanlara sahip olması yanlış bir şekilde zorunlu tutuluyor. Derin bağlantıların yalnızca sahip oldukları alanlarla eşleşmesi gerekir ve dahil edilmeyen alanlar yoksayılmalıdır. Bu sorun, b/399826566 kapsamında sonraki bir sürümde düzeltilmiştir.

Sürüm 2.9.0-alpha06

12 Şubat 2025

androidx.navigation:navigation-*:2.9.0-alpha06 iptal edilir. 2.9.0-alpha06 sürümü bu commit'leri içerir.

Yeni Özellikler

  • Navigasyon Safe Args işlemleri artık @CheckResult ek açıklamasıyla oluşturuluyor. Böylece bu işlemlerin kullanılması sağlanıyor. (I14d4c, b/356323084)

Hata Düzeltmeleri

  • NavController'da, backStack durumları bir listeye kaydedildiğinde bir diziye yanlışlıkla geri yüklenmeye çalışılan hata düzeltildi. (Idfb9b)
  • Gezinme 2.8.7: Gezinme için güvenli bağımsız değişkenler artık composable hedefleri destekliyor. (I35320, b/362791955)

Sürüm 2.9.0-alpha05

29 Ocak 2025

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

Hata Düzeltmeleri

  • Navigation Compose kullanılırken beklenmedik bir ölçek animasyonuna neden olan sorun düzeltildi. (I480f4, b/353294030)
  • Gezinme 2.8.6: XML aracılığıyla sağlanan NavDestination etiketleri, özel NavType mantığına uyulmasını sağlamak için NavType.get üzerinden ayrıştırılır. (I7ec2f, b/388100796)
  • Gezinme 2.8.6: dataPattern ile etkinliğe giderken ActivityNavigator artık arg değerini bağımsız değişkenin NavType ile kodlamaya çalışacak. (I16376, b/383616432)
  • Navigation 2.8.5: Navigation Compose kullanılırken ve gezinme işlemi, mevcut animasyonun sona erdiği karede çağrılırken beklenmedik bir ölçek animasyonuna neden olan sorun düzeltildi. (I26cb1, b/353294030)

Sürüm 2.9.0-alpha04

11 Aralık 2024

androidx.navigation:navigation-*:2.9.0-alpha04 iptal edilir. 2.9.0-alpha04 sürümü bu commit'leri içerir.

Yeni Özellikler

Aşağıdaki tabloda, reified ve KClass API'leri verilmiştir.

gerçekleştirilmiş KClass
composable<TestClass> { } composable(TestClass::class) { }
navigation<NestedGraph>(startDestination = TestClass::class) navigation(route = NestedGraph::class, startDestination = TestClass::class)
dialog<TestClass> {} dialog(TestClass::class) {}
navDeepLink<TestClass>(baseUri) navDeepLink(TestClass::class, baseUri)
NavDeepLink.Builder.setUriPattern<TestClass>(baseUri) NavDeepLink.Builder.setUriPattern(TestClass::class, baseUri)
NavDestinationBuilder.deepLink<TestDeepLink>(baseUri) { } NavDestinationBuilder.deepLink(TestDeepLink::class, baseUri) { }
navController.getBackStackEntry<TestClass>() navController.getBackStackEntry(TestClass::class)
navController.popBackStack<TestClass>(true) navController.popBackStack(TestClass::class, true)
navController.clearBackStack<TestClass>() navController.clearBackStack(TestClass::class)
NavOptions.setPopUpTo<TestClass>() NavOptions.setPopUpTo(TestClass::class)
navOptions { popUpTo<TestClass> {...} } navOptions { popUpTo(TestClass::class) {...} }
NavGraph.setStartDestination<TestClass>() NavGraph.setStartDestination(TestClass::class)
NavGraph.findNode<TestClass>() NavGraph.findNode(TestClass::class)
backStackEntry.toRoute<TestClass>() backStackEntry.toRoute(TestClass::class)
savedStateHandle.toRoute<TestClass>() savedStateHandle.toRoute(TestClass::class)

API Değişiklikleri

  • Tür güvenliği için Kotlin'e özgü NavGraph.setStartDestination aşırı yüklemesi, Java kaynaklarından gizlenir. (Ic640c, b/364634035)

Hata Düzeltmeleri

  • Gezinme 2.8.5: Geri yığın 1 girişe indirildiğinde ve aynı karede bir sistem geri işlemi tetiklendiğinde NavHost öğesinin PredictiveBackHandler içinde istisna oluşturmasına neden olan sorun düzeltildi. (I1a429, b/375343407)
  • Gezinme 2.8.5 bölümünde: Bir grafiğin startDestination güncellenirken NavDestination NullPointerException sorunu düzeltildi. (I99421, b/361560785)

Harici Katkı (External Contribution)

Sürüm 2.9.0-alpha03

13 Kasım 2024

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

Yeni Özellikler

  • Gezinme türü güvenliği artık değer sınıflarını rota olarak veya rotanın bağımsız değişken türü olarak destekliyor. (I9344a, b/374347483)

Hata Düzeltmeleri

  • Bir NavBackStackEntry öğesine eklenen LifecycleObserver, kapsayan Etkinlik veya Parça gibi ana makine LifecycleOwner yaşam döngüsü durumunu değiştirdiğinde arka yığında değişikliğe neden olabilecek ConcurrentModificationException düzeltildi. (Ia9494)

Sürüm 2.9.0-alpha02

30 Ekim 2024

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

Harici Katkı (External Contribution)

  • Yeni ortak NavController.handleDeepLink(request: NavDeepLinkRequest) yöntemi. Teşekkürler Konstantin Tskhovrebov! (I3e228)

Sürüm 2.9.0-alpha01

16 Ekim 2024

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

Yeni Özellikler

  • Özel Gezginler artık hedeflerini, SupportingPane arayüzünü uygulayan yerler olarak işaretleyebilir. Bu, NavController'a bu hedeflerin diğer hedeflerle birlikte gösterileceğini belirtir. Bu arayüzü kullanarak aynı anda birden fazla hedef RESUMED edilebilir. (Id5559)
  • Gezinme 2.8.3: navigation-common, navigation-runtime ve navigation-compose modülleri için, @Serializable ile doğru şekilde açıklama eklenmemiş tür güvenli rotaları belirlemeye yardımcı olacak yeni lint kontrolleri eklendi. Bu kontrol, tüm NavGraphBuilder ve NavDeepLinkBuilder uzantı işlevlerine uygulanır. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816)
  • Navigation 2.8.3: navigation-common, navigation-runtime ve navigation-compose modüllerine, @Keep ile doğru şekilde açıklama eklenmemiş Enum bağımsız değişkenlerine sahip tür açısından güvenli rotaları belirlemeye yardımcı olacak yeni lint kontrolleri eklendi. Bu kontrol, tüm NavGraphBuilder ve NavDeepLinkBuilder uzantı işlevlerine uygulanır. (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)

Davranış Değişiklikleri

  • Daha önce DESTROYED olan bir NavController kullanmaya çalışmak artık IllegalStateException hatasına neden olacak. (I520da, b/369616172)

Hata Düzeltmeleri

  • Enum sınıfı, küçültülmüş derlemelerde silinirse @Keep ek açıklamasının kullanılmasını önermek için Enum sınıfı bulunamadı istisnasını güncelleyin. (I90e79, b/358137294)

Bilinen Sorunlar

  • Navigation 2.8.* sürümünde eklenen yeni lint kurallarıyla ilgili bir sorun var. Bu sorun, Android Gradle Eklentisi 8.4 veya sonraki sürümlerinde lint çalıştırmaya çalışırken Obsolete custom lint check hatasına neden oluyor. (b/368070326, b/371463741)

Sürüm 2.8

Sürüm 2.8.9

12 Mart 2025

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

Hata Düzeltmeleri

  • Navigation 2.8.8'de bulunan ve eşleşme olarak kabul edilmesi için derin bağlantı isteği veya intent'in tüm alanlarıyla tam olarak eşleşen bir derin bağlantı gerektiren regresyon düzeltildi. Bu durum, kısmi alan eşleşmeleri içeren ve başka eşleşme içermeyen derin bağlantıların artık çalışmamasına neden oldu. (Ie5e36, b/399826566)

Sürüm 2.8.8

26 Şubat 2025

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

Hata Düzeltmeleri

  • Joker karakterli yollar içeren rotaların, eklenen bir derin bağlantıyla eşleşmemesine neden olan hata düzeltildi. (I7ea92, b/389970341)
  • Derin bağlantı ve derin bağlantı isteğinin uri, işlem ve mime'de tam olarak eşleşmesi gerektiği NavDeepLink eşleşmesi düzeltildi. Yalnızca bir veya iki alan eşleşiyorsa artık eşleştirme yapılamaz. (I3227f, b/395712033)

Bilinen Sorunlar

  • b/395712033 numaralı sorunu giderme çalışmaları nedeniyle, derin bağlantıların derin bağlantı isteği ve/veya Intent ile aynı alanlara sahip olması yanlış bir şekilde zorunlu tutuluyor. Derin bağlantıların yalnızca sahip oldukları alanlarla eşleşmesi gerekir ve dahil edilmeyen alanlar yoksayılmalıdır. Bu sorun, b/399826566 kapsamında sonraki bir sürümde düzeltilmiştir.

Sürüm 2.8.7

12 Şubat 2025

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

Hata Düzeltmeleri

  • Navigation Safe Args artık composable hedeflerini destekliyor. (I35320, b/362791955)

Sürüm 2.8.6

29 Ocak 2025

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

Hata Düzeltmeleri

  • NavDestination etiketleri, özel NavType mantığına uyulmasını sağlamak için NavType.get üzerinden ayrıştırılır. (Id366d, b/388100796)
  • dataPattern ile etkinliğe giderken ActivityNavigator artık arg değerini bağımsız değişkenin NavType ile kodlamaya çalışacak. (I1a71d, b/383616432)

Sürüm 2.8.5

11 Aralık 2024

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

Hata Düzeltmeleri

  • Geri yığın 1 girişe indirildiğinde ve aynı karede bir sistem geri işlemi tetiklendiğinde NavHost öğesinin PredictiveBackHandler içinde istisna oluşturmasına neden olan sorun düzeltildi. (I1a429, b/375343407)
  • Bir grafiğin startDestination güncellenirken NavDestination NullPointerException sorunu düzeltildi. (I99421, b/361560785)
  • Navigation Compose kullanılırken ve mevcut animasyonun sona erdiği karede gezinme çağrısı yapılırken beklenmedik bir ölçek animasyonuna neden olan sorun düzeltildi. (I26cb1, b/353294030)
  • Bir NavBackStackEntry öğesine eklenen LifecycleObserver, kapsayan Etkinlik veya Parça gibi ana makine LifecycleOwner yaşam döngüsü durumunu değiştirdiğinde arka yığında değişikliğe neden olabilecek ConcurrentModificationException düzeltildi. (Ia9494)

Harici Katkı (External Contribution)

  • Gezinme türü güvenliği artık özel NavType gerektirmeden bir rotanın bağımsız değişken türü olarak List<Enum>'yı destekliyor. Teşekkürler Csaba Kozák! (GH-725, b/375559962)

Sürüm 2.8.4

13 Kasım 2024

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

Yeni Özellikler

Hata Düzeltmeleri

Sürüm 2.8.3

16 Ekim 2024

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

Yeni Özellikler

  • navigation-common, navigation-runtime ve navigation-compose modülleri için, @Serializable ile doğru şekilde açıklama eklenmemiş tür güvenli rotaları belirlemeye yardımcı olacak yeni lint kontrolleri eklendi. Bu kontrol, tüm NavGraphBuilder ve NavDeepLinkBuilder uzantı işlevlerine uygulanır. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816)
  • navigation-common, navigation-runtime ve navigation-compose modülleri için yeni lint kontrolleri eklendi. Bu kontroller, @Keep ile doğru şekilde açıklama eklenmemiş Enum bağımsız değişkenlerine sahip tür açısından güvenli rotaları belirlemeye yardımcı olur. Bu kontrol, tüm NavGraphBuilder ve NavDeepLinkBuilder uzantı işlevlerine uygulanır. (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)

Hata Düzeltmeleri

  • Navigation 2.8.* sürümünde eklenen yeni lint kurallarının, Android Gradle Eklentisi 8.4 veya sonraki sürümlerle lint çalıştırma girişiminde Obsolete custom lint check hatasına neden olduğu sorun düzeltildi. (I1be3d, b/368070326, b/371463741)

Bilinen Sorunlar

  • Navigation lint, Lint 16 (AGP 8.7) veya sonraki sürümlerle lint çalıştırmaya çalışırken Obsolete custom lint check hatası verir. (b/371926651)

Sürüm 2.8.2

2 Ekim 2024

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

Yeni Özellikler

  • Navigation Type Safety artık özel NavType gerektirmeden Double, Double?, DoubleArray, DoubleArray?, List<Double> ve List<Double>? içeren Serializable sınıflarını destekliyor. (I570eb, Ibc4c0, I37461, I5bed4, b/359245753)

Hata Düzeltmeleri

  • Navigasyon, bir rotanın bağımsız değişkenini NavType ile eşleyemediğinde gösterilen hata mesajı iyileştirildi. Yeni hata mesajında bağımsız değişken adı, bağımsız değişkenin tam nitelikli adı ve rotanın tam nitelikli adı yer alacak. (Id8416, b/346264232)

Sürüm 2.8.1

18 Eylül 2024

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

Yeni Özellikler

  • Tür güvenli API'ler kullanılarak popBackStack işlemi denenirken somutlaştırılmış sınıf türü alan popBackStack işlevinin kullanılmasını sağlamak için yeni bir lint kuralı eklendi. (Ief161, b/358095343)

Hata Düzeltmeleri

  • Navigasyon artık bir NavGraph öğesinin startDestination öğesine iletilen rotanın, boş değer atanamayan ve varsayılan değeri olmayan bağımsız değişkenler de dahil olmak üzere tüm zorunlu bağımsız değişkenlerin değerlerini içermesini gerektiriyor. (I18e74, b/362594265)
  • Navigation Safe Args, boş değer içermeyen dizeler için destek ekledi. Bu sayede "null" değerleri ayrıştırılıp olduğu gibi pakette depolanacak. Bu, "null" değerlerinin null nesne olarak ayrıştırıldığı mevcut davranıştan farklıdır. Bu değişiklik yalnızca boş değer atanamayan String türleri için geçerlidir. Boş değer atanabilir dizeler değişmeden kalır. (I08b4a, b/348936238)
  • NavDestination artık yalnızca hedefe açıkça eklenen bir derin bağlantı aracılığıyla derin bağlantı oluşturulabilir. Bu, yalnızca dize rotası alan gezinme işlevi aşırı yüklemesiyle bir hedefin rotasına gidebileceğiniz anlamına da gelir. Bu düzeltme, potansiyel olarak korunan bir hedefe derin bağlantı oluşturmayı mümkün kılan güvenlik açığını giderir. (Ie30e6)

Bağımlılık Güncellemesi

  • Navigation Safe Args artık Kotlin 2.X yerine Kotlin 1.9.24'e bağlı olduğundan geliştiriciler güncelleme yapmaya zorlanmaz. (a4129a)
  • Gezinme ile E-posta Yazma özelliği artık E-posta Yazma 1.7.2 özelliğine bağlıdır.

Sürüm 2.8.0

4 Eylül 2024

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

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

Navigation Kotlin DSL Tür Güvenliği

  • Navigasyon artık Kotlin Serialization'ı kullanarak Kotlin DSL (Navigation Compose tarafından kullanılır) için tür güvenliği sağlıyor. Böylece, tür güvenli nesneler ve veri sınıfları aracılığıyla gezinme grafiğinizdeki hedefleri tanımlayabilirsiniz:
    // Define a home destination that doesn't take any arguments
    @Serializable
    object Home

    // Define a profile destination that takes an ID
    @Serializable
    data class Profile(val id: String)

    // Now define your NavHost using type safe objects
    NavHost(navController, startDestination = Home) {
        composable<Home> {
            HomeScreen(onNavigateToProfile = { id ->
                navController.navigate(Profile(id))
            })
        }
        composable<Profile> { backStackEntry ->
            val profile: Profile = backStackEntry.toRoute()
            ProfileScreen(profile)
        }
    }

Daha fazla bilgi için Navigation Compose meet Type Safety blog yayınını inceleyin.

Navigation Compose ile Tahmin Edilen Geri Gitme

  • Navigation Compose artık compose-animation'daki yeni SeekableTransitionState API'leri aracılığıyla uygulama içi tahmin edilen geri gitme özelliğini destekliyor. Bu sayede, işlemi tamamlanmış hareketle onaylamaya veya iptal etmeye karar vermeden önce özel geçişinizle önceki hedefi görmek için geri hareketini kullanabilirsiniz.

Navigation Fragment Composable

  • NavHostFragment yerine ComposableNavHostFragment alternatifini içeren yeni bir navigation-fragment-compose yapısı eklendi. Bu yapı, Navigation XML dosyalarınıza composable hedefler eklemenize olanak tanır. Her composable hedef, tam nitelikli adı her hedefte android:name özelliği olarak kullanılan, üst düzey ve bağımsız değişken içermeyen bir @Composable yöntemi olarak ifade edilmelidir. Bu hedeflerden birine gidildiğinde, composable içeriği göstermek için kapsayan bir parça oluşturulur.
  // In HomeScreen.kt
  @Composable
  fun HomeScreen() {
    // Your Composable content here
  }

  // In your navigation.xml
  <composable
    android:id="@+id/home_screen"
    android:name="com.example.HomeScreenKt\$HomeScreen" />

Diğer Değişiklikler

  • Navigation Compose artık Compose 1.7.0'a bağlıdır.
  • Navigation artık liste, diziler ve haritalar gibi koleksiyona dayalı bağımsız değişkenler için NavType<T> sınıfının alt sınıfı olan yeni bir CollectionNavType<T> sınıfı sunuyor. Tüm varsayılan NavType dizileri (IntArrayType, LongArrayType, FloatArrayType, BoolArrayType ve StringArrayType) artık bu yeni sınıftan devralınıyor.
  • NavType artık Int, String, Boolean, Float ve Long listeleri için yerleşik destek sunuyor.

Sürüm 2.8.0-rc01

21 Ağustos 2024

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

Hata Düzeltmeleri

  • Üst düzey Enum sınıfları tür açısından güvenli bağımsız değişkenler olarak geçirildiğinde gezinme kilitlenmesi düzeltildi. (I0ba76, b/358137294)
  • Navigation 2.8 artık SDK 34 ile doğru şekilde çalışıyor ve AndroidX kitaplıklarının geri kalanıyla birlikte 2.9 sürümü yayınlanana kadar SDK 35'e geçmeyecek. (b/358798728)

Sürüm 2.8.0-beta07

7 Ağustos 2024

androidx.navigation:navigation-*:2.8.0-beta07 iptal edilir. 2.8.0-beta07 sürümü bu commit'leri içerir.

Bilinen Sorunlar

  • b/358137294 nedeniyle, yalnızca başka bir sınıfa yerleştirilmiş Enums'lar kutudan çıktığı haliyle desteklenir. En üst düzey numaralandırmalar sonraki sürümde desteklenecektir.

Hata Düzeltmeleri

  • Aynı veya paylaşılan hedeflere giderken navigasyon, grafikteki mevcut konumdan en yakın eşleşen hedefe gitmeye öncelik verir. (Ic89a4, b/352006850)
  • Güvenli bağımsız değişkenlerde gezinmeye yeni bir NavType.EnumType eklendi. Bu, Enum türlerinin artık özel NavType gerektirmediği anlamına gelir. Enum'nın SerialName, varsayılan tam nitelikli ad olmalıdır. (I66d22, b/346475493)
  • Safe Args'da gezinme,Int?, Long?, Float?, Boolean? ve Enum<*>? dahil olmak üzere boş değer atanabilir bağımsız değişken türleri için yerleşik destek ekledi. (I32d13,I1c580,Ifba66,I978b0,Ide076 , b/351994237)
  • NavGraph'nın startDestination, NavGraph'ya iletilen startDestination rotası startDestination.route'ye tam olarak eşitse artık varsayılan bağımsız değişken değerlerini kullanacak. (I13762, b/354046047)

Sürüm 2.8.0-beta06

24 Temmuz 2024

androidx.navigation:navigation-*:2.8.0-beta06 iptal edilir. 2.8.0-beta06 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • WrongStartDestinationType Lint kontrollerinin, iletilen sınıf türünde Companion nesnelerini kontrol etmemesi ve bu nedenle lint'in hatayı algılayamamasına neden olan sorun düzeltildi. (I92b09)

Sürüm 2.8.0-beta05

10 Temmuz 2024

androidx.navigation:navigation-*:2.8.0-beta05 iptal edilir. 2.8.0-beta05 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • İç içe yerleştirilmiş singleTop öğeler aynı startDestination rotayı paylaştığında singleTop navigasyonunun kilitlenmesi sorunu düzeltildi.NavGraphs (I17b94, b/294408596)

Sürüm 2.8.0-beta04

26 Haziran 2024

androidx.navigation:navigation-*:2.8.0-beta04 iptal edilir. 2.8.0-beta04 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Navigasyon artık yol bağımsız değişkenlerinde boş dizelerle gezinmeyi destekliyor. (Ic5dbd, b/339481310)
  • Doğrudan sınıf alanlarında @Serializable(with =...) aracılığıyla bildirilen özel serileştiriciler için hata mesajını iyileştirerek bu özelliğin şu anda desteklenmediğini netleştirin. (I052b0, b/341319151)
  • SavedStateHandleFactory test API'si artık Android dışı testlerde kullanılabilir ancak paketlerle bağımsız değişken ayrıştırmayı desteklemek için Robolectric gerektirir. (I76cdc, b/340966212)
  • Compose'da Type-Safe Navigation kullanılırken işlem sonlandırıldıktan sonra uygulama devam ettirildiğinde durumun geri yüklenmesiyle ilgili kilitlenme sorunu düzeltildi. (Ia8f38, b/341801005)
  • Navigation Compose'da, Tahmin Edilen Geri Gitme Hareketi iptal edildikten sonra kullanıcının döndüğü NavBackStackEntry öğesinin hiçbir zaman RESUMED yaşam döngüsü durumuna geri dönmemesine neden olan sorun düzeltildi. Bu, geri dönen hedef için de kaydırma işleminden sonra yerine oturmak yerine doğru şekilde geri animasyon yapılmasını sağlar. (I97a0c, b/346608857)
  • Navigation Compose ile tahmin edilen geri gitme özelliği kullanılırken, açılan hedef artık uygun z-sırasına sahip olacak ve gelen hedefin üzerinde doğru şekilde animasyon oluşturacak. (I2077b, b/345993681)

Sürüm 2.8.0-beta03

12 Haziran 2024

androidx.navigation:navigation-*:2.8.0-beta03 iptal edilir. 2.8.0-beta03 sürümü bu commit'leri içerir.

API Değişiklikleri

  • CollectionNavType, yeni bir emptyCollection() yöntemi kullanıyor. Boş bir koleksiyonun bağımsız değişken olarak iletilmesini işlemek için bu işlevi geçersiz kılın. (Ie4d84, b/341723133)

Hata Düzeltmeleri

  • Nihai çıktıların URI kodlu olması gerektiğini vurgulamak için NavType.serializeAsValue ve serializeAsValues ile ilgili dokümanlar eklendi. (Ida6bd, b/344943214)
  • Boş CollectionNavType bağımsız değişkeniyle toRoute<T> çağrıldığında kilitlenme sorunu düzeltildi. Boş bir CollectionNavType ile gezinirken çıkış bağımsız değişkeni, Serializable sınıfınızda belirtilen varsayılan değer veya varsayılan değer yoksa emptyCollection()'nin dönüş değeri olur. (I84158, Id630f, b/342672856)

Sürüm 2.8.0-beta02

29 Mayıs 2024

androidx.navigation:navigation-*:2.8.0-beta02 iptal edilir. 2.8.0-beta02 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Boş değer atanabilir özel NavType ile NavBackStackEntry.toRoute kullanılırken ClassCastException kilitlenmesi sorunu düzeltildi. (I1c29b, b/342239473)
  • Geçerli hedeften kimlik aracılığıyla ulaşılamayan bir geri yığın girişi geri yüklenmeye çalışıldığında oluşan, gezinme geri yığın durumu geri yükleme sorunları düzeltildi. Rotalar kimliklerle desteklendiğinden, rotalarla oluşturulan hedefler de bu durumdan etkilendi. Bu düzeltme, aynı temel soruna sahip olan clearBackStack() çağrıldığında oluşan kilitlenmeyi de düzeltir. (I423c3, b/339908057)

Sürüm 2.8.0-beta01

14 Mayıs 2024

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

API Değişiklikleri

  • SavedStateHandle.toRoute() artık özel bağımsız değişken türleri için typeMap parametresini alıyor. (Ie39fb, b/339026523)
  • navigation-testing adlı kitaplığa, Kotlin Serializable nesnesinden SavedStateHandle oluşturmak için bir test API'si eklendi. (Id4867, b/339080702)

Hata Düzeltmeleri

  • Navigation Kotlin DSL işlevleri için eksik olan parametre belgeleri eklendi. (I26a36)

Sürüm 2.8.0-alpha08

1 Mayıs 2024

androidx.navigation:navigation-*:2.8.0-alpha08 iptal edilir. 2.8.0-alpha08 sürümü bu commit'leri içerir.

Navigation Compose'da Safe Args

Bu işlev, Kotlin Serialization'ı kullanarak gezinme grafiğinizdeki hedefleri tür güvenli nesneler ve veri sınıfları aracılığıyla tanımlamanıza olanak tanır:

  // Define a home destination that doesn't take any arguments
  @Serializable
  object Home

  // Define a profile destination that takes an ID
  @Serializable
  data class Profile(val id: String)

  // Now define your NavHost using type safe objects
  NavHost(navController, startDestination = Home) {
      composable<Home> {
          HomeScreen(onNavigateToProfile = { id ->
              navController.navigate(Profile(id))
          })
      }
      composable<Profile> { backStackEntry ->
          val profile: Profile = backStackEntry.toRoute()
          ProfileScreen(profile)
      }
  }

Daha fazla bilgi için Navigation Compose meet Type Safety blog yayınını inceleyin.

Yeni Özellikler

  • navigation-fragment-compose yapısı artık ComposableFragment içinde oluşturulabilir yöntemlere yerel bir LocalFragment kompozisyonu sağlıyor. (If35e5)
  • NavType artık Int, String, Boolean, Float ve Long listeleri için yerleşik destek sunuyor. (I4b6dd, Ia914c, b/188693139)

Sürüm 2.8.0-alpha07

17 Nisan 2024

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

Yeni Özellikler

  • NavHostFragment yerine ComposableNavHostFragment alternatifini içeren yeni bir navigation-fragment-compose yapısı ekler. Bu yapı, gezinme XML dosyalarınıza composable hedefleri eklemenize olanak tanır. Her composable hedef, tam nitelikli adı her hedefte android:name özelliği olarak kullanılan, üst düzey ve bağımsız değişken içermeyen bir @Composable yöntemi olarak ifade edilmelidir. Bu hedeflerden birine gidildiğinde, composable içeriği göstermek için kapsayan bir parça oluşturulur. (I0ef2e, b/265480755)

    // In HomeScreen.kt
@Composable
fun HomeScreen() {
  // Your Composable content here
}

    // In your navigation.xml
<composable
  android:id="@+id/home_screen"
  android:name="com.example.HomeScreenKt\$HomeScreen" />

API Değişiklikleri

  • Kotlin Serialization'a dayalı bir yaklaşım kullanılarak Navigation Compose'da Safe Args desteği devam etti. Bu API'ler tamamlanmamıştır ve ExperimentalSafeArgsApi açıklamasıyla işaretlenmiştir. Bu açıklama, gelecekteki bir sürümde tüm API yüzeyi tamamlandığında kaldırılacaktır. (Iefd95, I409c8, I5b5ac, I7e753, I960f8, I3eabd, I8ed5a, Ied2c9, I9b73c, I554db, Ib3aba, Ia668d, b/188693139)

Sürüm 2.8.0-alpha06

3 Nisan 2024

androidx.navigation:navigation-*:2.8.0-alpha06 iptal edilir. 2.8.0-alpha06 sürümü bu commit'leri içerir.

API Değişiklikleri

Hata Düzeltmeleri

  • NavHost artık varsayılan contentAlignment bağımsız değişkeni olarak Alignment.TopStart kullanılıyor. Bu değişiklik, AnimatedContent için varsayılan değerle uyumlu hale getirir ve merkezden beklenmedik ölçek geçişiyle ilgili bazı sorunları düzeltir. (I09e72, b/330111602)
  • Navigation Compose kullanılırken tahmin edilen geri gitme hareketi yapıldığında NavHost artık özel geçişi hemen bitirmek yerine doğru şekilde tamamlayacak. (I99017, b/327292110)

Sürüm 2.8.0-alpha05

20 Mart 2024

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

Yeni Özellikler

  • Artık NavGraph'nın startDestination işlevine defaultValue'a güvenmeden doğrudan startDestination rotasında bağımsız değişkenler iletebilirsiniz. Bu durum, iç içe yerleştirilmiş NavGraph startDestinations için de geçerlidir. (I0e0b5, b/109505019, b/188693139)

API Değişiklikleri

  • Liste, diziler, haritalar gibi koleksiyona dayalı bağımsız değişkenler için NavType<T> sınıfının alt sınıfı olan yeni bir soyut CollectionNavType<T> sınıfı eklendi. (Ic6d63, b/188693139)
  • Tüm varsayılan NavType dizileri (IntArrayType, LongArrayType, FloatArrayType, BoolArrayType ve StringArrayType) artık CollectionNavType türündedir (Idcf79, b/188693139).
  • NavType artık aynı türdeki iki değerin birbirine eşit olup olmadığını belirleyen yeni bir açık valueEquals API'si sunuyor. (I6cb97, b/327229511)

Hata Düzeltmeleri

  • Derin bağlantılardaki sorgu parametreleri artık dize tabanlı NavTypes için geçerli değerler olarak bağımsız değişken adının etrafında küme parantezleri (ör. {argName}) biçimindeki değerlere izin veriyor. Bu düzeltme, söz konusu değerin tüm türler için geçersiz (veya değerin olmaması) olarak kabul edildiği sorunu giderir. (I18302, b/327274038)
  • NavController veya popBackStack gibi rotaları destekleyen NavController işlevleri artık Dizi NavTypes bağımsız değişkenleriyle doldurulmuş rotaları düzgün şekilde eşleştirebilir.navigate (Iea805, b/327229511)

Sürüm 2.8.0-alpha04

6 Mart 2024

androidx.navigation:navigation-*:2.8.0-alpha04 iptal edilir. 2.8.0-alpha04 sürümü bu commit'leri içerir.

Yeni Özellikler

  • Artık SizeTranform ve/veya navigation işlevlerinin başlatılması kapsamında tanımlayarak Navigation Compose'daki geçişleriniz için SizeTranform belirtebilirsiniz.composable (I91062, b/296912651)

Hata Düzeltmeleri

  • Sistem Geri'yi hareket olmadan kullanırken, Oluşturma Gezinme'de NavHost geçişinin düzgün şekilde gösterilememesi sorunu düzeltildi. (Iceeae, b/325998468)

Sürüm 2.8.0-alpha03

21 Şubat 2024

androidx.navigation:navigation-*:2.8.0-alpha03 iptal edilir. 2.8.0-alpha03 sürümü şu commit'leri içerir.

API Değişiklikleri

  • NavBackStackEntry.savedStateHandle, ana iş parçacığında olması gereken kodu kullandığı için artık @MainThread olarak işaretleniyor. (Ibb988, b/299523245)

Hata Düzeltmeleri

  • Gezinme'de, ilişkili girişin ViewModel kaydedilmiş duruma dahil olmadığı için NavGraphViewModel'lerin DESTROYED çok erken oluşturulmasına neden olan sorun düzeltildi. (Ib6bb7, b/317581849)

Bağımlılık Güncellemesi

Sürüm 2.8.0-alpha02

7 Şubat 2024

androidx.navigation:navigation-*:2.8.0-alpha02 iptal edilir. 2.8.0-alpha02 sürümü şu commit'leri içerir.

Yeni Özellikler

  • Navigation Compose artık compose-animation'daki yeni SeekableTransitionState API'leri aracılığıyla uygulama içi tahmin edilen geri gitme özelliğini destekliyor. Bu sayede, işlemi tamamlanmış hareketle onaylamaya veya iptal etmeye karar vermeden önce özel geçişinizle önceki hedefi görmek için geri hareketini kullanabilirsiniz. (I8b8e9)

Sürüm 2.8.0-alpha01

24 Ocak 2024

androidx.navigation:navigation-*:2.8.0-alpha01 iptal edilir. 2.8.0-alpha01 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Bir hedefte birden fazla saveState çağrısı yapıldığında birden fazla durumun kaydedilmesine ancak yalnızca ilk durumun geri yüklenebilmesine neden olan BackStackState sızıntısı düzeltildi. (I598b0, b/309559751)
  • Uygulama çubuklarının başlığını doldurmak için NavigationUI yardımcıları kullanılırken String olmayan bağımsız değişkenlerin düzgün şekilde gösterilmemesi sorunu düzeltildi. (#636, b/316676794)

Bağımlılık Güncellemesi

Harici Katkı (External Contribution)

  • NavigationUI yardımcılarını kullanarak uygulama çubuklarının başlığını doldururken String olmayan bağımsız değişkenler için görüntüleme sorununu düzelttiği için SimonMarquis'e teşekkür ederiz.

Sürüm 2.7.7

Sürüm 2.7.7

7 Şubat 2024

androidx.navigation:navigation-*:2.7.7 iptal edilir. 2.7.7 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Navigation 2.8.0-alpha01'dan geri bağlantı oluşturuldu: Tek bir NavBackStackEntry üzerinde birden fazla saveState() çağrısının yapılması durumunda birden fazla durumun kaydedilmesine ancak yalnızca ilk kaydedilen durumun geri yüklenebilmesine neden olan BackStackState sızıntısı düzeltildi. (I598b0, b/309559751)
  • Navigation 2.8.0-alpha01'dan geri aktarıldı: NavigationUI yardımcıları, uygulama çubuklarının başlığını doldurmak için kullanıldığında String olmayan bağımsız değişkenlerin düzgün şekilde görüntülenmemesine neden olan sorun düzeltildi. (#636, b/316676794)

Harici Katkı (External Contribution)

  • NavigationUI yardımcılarını kullanarak uygulama çubuklarının başlığını doldururken String olmayan bağımsız değişkenler için görüntüleme sorununu düzelttiği için SimonMarquis'e teşekkür ederiz.

Sürüm 2.7.6

Sürüm 2.7.6

13 Aralık 2023

androidx.navigation:navigation-*:2.7.6 iptal edilir. 2.7.6 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • NavGraph equals() işlevi artık yalnızca çağıran grafiği değil, diğer grafiğin düğümlerini de doğru şekilde dikkate alıyor. Bu sayede, farklı kimliklere sahip düğümler içeren grafikler artık eşit kabul edilmeyecek (I401cb, b/311414915).

Sürüm 2.7.5

Sürüm 2.7.5

1 Kasım 2023

androidx.navigation:navigation-*:2.7.5 iptal edilir. 2.7.5 sürümü şu commit'leri içerir.

Performans İyileştirmeleri

  • İki grafiği karşılaştırma performansı (hem süre hem de tahsis sayısı açısından) önemli ölçüde iyileştirildi. Bu, yeni grafiği mevcut olanla dahili olarak karşılaştıran setGraph gibi çağrıların çok daha hızlı olduğu ve daha az atlanan kareyle sonuçlandığı anlamına gelir. Bu iyileştirmeye yol açan kapsamlı analiz için Michał Z'ye teşekkür ederiz. (I6ad62)
  • NavHost artık güncellenmiş durumu okumak için ikinci geçişin beklenmesine gerek kalmadan başlangıç hedefini ilk bileşim geçişinde oluşturacak. (I439a7, b/304852206)

Hata Düzeltmeleri

  • Grafiğinizde iki hedefi bağlayan bir işlem içeren bir hedef varsa ve setGraph işlevini tam olarak aynı grafikle birden fazla kez çağırdıysanız geri yığınınızın çıkarılmasına neden olan sorun düzeltildi. (Ieaed7)
  • Hızlı bir şekilde gezinilip kapatılan iletişim kutuları artık NavController.visibleEntries listesine sızmayacak. (I67586, b/287969970)
  • Bir giriş, yapılandırma değişikliğiyle birlikte açıldığında saveState yanlışsa girişin ViewModel değeri artık düzgün şekilde temizlenecek. (Idf242, b/298164648)
  • Geriye dönme yığını, yapılandırma değişikliğinden veya yalnızca gelen Intent'te FLAG_ACTIVITY_NEW_TASK işareti ayarlanmışken setGraph çağrısından önce tamamen boşsa NavController öğesinin aynı derin bağlantıyı birden fazla kez işleyebildiği sorun düzeltildi. (I73c7f)

Bağımlılık Güncellemeleri

  • Parçalarla gezinme artık Fragment 1.6.2'ye bağlıdır. Bu sayede, clearBackStack çağrıldığında iç içe yerleştirilmiş parçaların ViewModel örneklerinin temizlenmemesi sorunu düzeltilir.

Sürüm 2.7.4

Sürüm 2.7.4

4 Ekim 2023

androidx.navigation:navigation-*:2.7.4 iptal edilir. 2.7.4 sürümü şu commit'leri içerir.

Yeni Özellikler

  • popUpTo için destek eklendi. Bu sayede, popBackStack'deki destekle eşleşen şekilde, tam olarak bu bağımsız değişkenleri kullanan belirli bir girişe geri dönülmesine olanak tanımak için bağımsız değişkenli rotalar kullanılabilecek. (I731f4, b/299255572)

Hata Düzeltmeleri

  • popUpTo ile yapılan bir navigasyonun popUpTo ile yapılan başka bir navigasyonla kesintiye uğratılması durumunda FragmentNavigator'ın kilitlenmesine neden olan sorun düzeltildi. (I3c848, b/301887045)
  • Sistemde geri tuşuna basıldığında currentDestination simgesinin, görüntülenen parçayla eşleşecek şekilde doğru güncellenmemesine neden olan sorun düzeltildi. (Id0d6c, b/289877514)
  • DialogFragment yaşam döngüsü, artık üstündeki iletişim kutusu kapatıldığında RESUMED durumuna düzgün şekilde geçiş yapacak. (I88f0d, b/301811387)

Sürüm 2.7.3

Sürüm 2.7.3

20 Eylül 2023

androidx.navigation:navigation-*:2.7.3 iptal edilir. 2.7.3 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Parçalarla gezinme özelliğinde, visibleEntries listesinin yanlış girişler içermesine neden olan sorun düzeltildi. (I5caa9, b/288520638)
  • Kayan pencere hedefinin (ör.Dialogs, Bottomsheets vb.) hiçbir zaman RESUMED yaşam döngüsü geri çağırması almamasına neden olan sorun düzeltildi. (I3b866, b/287505132)

Sürüm 2.7.2

Sürüm 2.7.2

6 Eylül 2023

androidx.navigation:navigation-*:2.7.2 iptal edilir. 2.7.2 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Gezinme artık Lifecycle 2.6.2'a bağlıdır. Bu sayede, hedeflerin rememberSaveable durumu ile Navigation Compose'un NavHost arasındaki etkileşim düzeltilerek işlem sonlandırma ve yeniden oluşturma sonrasında rememberSaveable durumu ile ViewModel sahipli SavedStateHandle örneklerinin düzgün şekilde geri yüklenmesi sağlanır. (b/298059596, b/289436035)
  • Navigation Compose'da aynı anda birden fazla iletişim kutusu gösterilirken kısmen gizlenmiş iletişim kutularının (ör. en üstteki iletişim kutusu olmayan) STARTED durumu yerine CREATED yaşam döngüsü durumunda olması sorunu düzeltildi. (aosp/2728520, b/289257213)
  • Navigation Compose'da aynı anda birden fazla iletişim kutusu gösterilirken en üstteki iletişim kutusunun kapatılmasının, yeni en üstteki iletişim kutusunun doğru şekilde RESUMED yaşam döngüsü durumuna geçmek yerine STARTED yaşam döngüsü durumunda takılmasına neden olan sorun düzeltildi. (aosp/2629401, b/286371387)
  • Navigation Safe Args artık gerçekten yürütülmüyorsa görevini hemen başlatmaz. (I0e385, b/260322841)

Bağımlılık Güncellemesi

  • Navigation Compose artık Compose 1.5.1'e bağlıdır.

Sürüm 2.7.1

Sürüm 2.7.1

23 Ağustos 2023

androidx.navigation:navigation-*:2.7.1 iptal edilir. 2.7.1 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Compose ile gezinmede, Scaffold kullanıldığında Lifecycle.State.DESTROYED ViewModel erişmeye çalışırken hata alınmasına neden olan sorun düzeltildi. (I1dc11, b/268422136)

Sürüm 2.7.0

Sürüm 2.7.0

9 Ağustos 2023

androidx.navigation:navigation-*:2.7.0 iptal edilir. 2.7.0 sürümü şu commit'leri içerir.

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

Accompanist'ten animasyonlar

AnimatedContent kararlı sürümüne ulaştığı için Accompanist Navigation Animation'daki kodu Navigation Compose'a geri taşıyabildik.

Bu, AnimatedNavHost'da bulunan özel geçişleri ayarlama desteğinin tamamının doğrudan NavHost'da desteklendiği anlamına gelir.

Accompanist Navigation Animation'da başka değişiklik yapılmayacak ve Navigation Compose'a nasıl geri geçileceğine dair yönergelerle birlikte kısa süre içinde resmi olarak desteği sonlandırılacak. Ancak, en son Accompanist alfa sürümünü (0.31.2-alpha) kullanıyorsanız başka API değişikliği yapmanız gerekmeyecek ve bu, taşıma kılavuzunun tersi olacak. (b/197140101)

Hata Düzeltmeleri

  • Navigation Compose'daki NavHost artık Etkinlik DURDURULUP DEVAM ETTİRİLDİKTEN sonra bile sistemin geri çağırmalarını doğru şekilde yakalıyor. (Icb6de, b/279118447)

Bağımlılık Güncellemeleri

  • Gezinme artık 1.1.0 yerine Compose 1.5.0'a bağlıdır.

Sürüm 2.7.0-rc01

26 Temmuz 2023

androidx.navigation:navigation-*:2.7.0-rc01 iptal edilir. 2.7.0-rc01 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • NavHost kapsamında oluşturulan EnterTransition ve ExitTransition lambda'larının, NavHost kompozisyondan kaldırıldıktan sonra bile bellekte kalmasına neden olan sorun düzeltildi. (I893d0)

Bilinen Sorunlar

  • Navigation 2.6.x sürümünde, popUpTo ile gezinirken IllegalArgumentException hatasına neden olabilecek bir sorun var. Bu istisna, grafiğinizi burada önerilen şekilde yeniden yapılandırarak önlenebilir. (b/287133013)

Sürüm 2.7.0-beta02

28 Haziran 2023

androidx.navigation:navigation-*:2.7.0-beta02 iptal edilir. 2.7.0-beta02 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Navigation Compose artık popUpTo seçeneğiyle gezinmeyi kullanan özel geçişler için doğru z-sırasına sahip.(/Ib1c3a, b/285153947)

Sürüm 2.7.0-beta01

7 Haziran 2023

androidx.navigation:navigation-*:2.7.0-beta01 iptal edilir. 2.7.0-beta01 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • NavHost artık STOPPED ve RESUMED işleminden sonra bile sistemin geri çağırmalarını doğru şekilde yakalıyor.Activity (Icb6de, b/279118447)

Sürüm 2.7.0-alpha01

24 Mayıs 2023

androidx.navigation:navigation-*:2.7.0-alpha01 iptal edilir. 2.7.0-alpha01 sürümü şu commit'leri içerir.

Accompanist'ten animasyonlar

AnimatedContent kararlı sürümüne ulaştığı için Accompanist Navigation Animation'daki kodu Navigation Compose'a geri taşıyabildik.

Bu, AnimatedNavHost'da bulunan özel geçişleri ayarlama desteğinin tamamının doğrudan NavHost'da desteklendiği anlamına gelir.

Accompanist Navigation Animation'da başka değişiklik yapılmayacak ve Navigation Compose'a nasıl geri geçileceğine dair yönergelerle birlikte kısa süre içinde resmi olarak desteği sonlandırılacak. Ancak, en son Accompanist alfa sürümünü (0.31.2-alpha) kullanıyorsanız başka API değişikliği yapmanız gerekmeyecek ve bu, taşıma kılavuzunun tersi olacak. (b/197140101)

Hata Düzeltmeleri

  • Navigation 2.6.0-rc02: Parçalarda gezinme ile ilgili bir sorun düzeltildi. Bu sorunda, popUpTo ile gezinme ve görünümü yeniden oluşturmadan bir parçayı geri yığından çıkarma işlemi, sistemin geri düğmesinin çalışmamasına neden oluyordu. (Ieb8d4, b/281726455)

Bağımlılık Güncellemeleri

  • Gezinme artık Compose'a 1.5.0-beta01 bağlıdır.

Sürüm 2.6.0

Sürüm 2.6.0

7 Haziran 2023

androidx.navigation:navigation-*:2.6.0 iptal edilir. 2.6.0 sürümü şu commit'leri içerir.

2.5.0 sürümünden beri gezinme özelliğinde yapılan önemli değişiklikler

  • NavBackStackEntry'nın arguments ve OnDestinationChangedListener'ye iletilen arguments artık yalnızca hedefe gittiğinizde oluşturulan değişmez bağımsız değişkenlerin bir kopyasıdır. Bu nedenle, bu paketlerde yapılan değişiklikler, arguments veya diğer OnDestinationChangedListener örneklerine sonraki erişimlerde yansıtılmaz.
  • NavDeepLink artık diziler için varsayılan değerleri destekliyor. Bu sayede, bağımsız değişkenin dizi türüyle eşlenecek olan tekrarlanan sorgu parametreleri desteklenebiliyor. NavType artık iki ayrıştırılmış değeri birleştirmek için geçersiz kılınabilen varsayılan bir yöntemi de içeriyor.
  • NavType öğesinin özel alt sınıfları artık bir değeri dizeye dönüştürmek için serializeAsValue öğesini geçersiz kılabilir. Bu sayede hem serileştirme hem de seri durumdan çıkarma (parseValue aracılığıyla) tamamen NavType sınıfında kapsanabilir. StringType artık bu yöntemi geçersiz kılarak belirtilen String üzerinde Uri.encode'ı çağırır.

2.5.0 sürümünden beri Navigation Compose'da yapılan önemli değişiklikler

  • NavHost ile bir composable'ı önizlerken artık varsayılan olarak NavGraph'ın startDestination öğesi gösterilecek.
  • NavController.popBackStack(route), NavController.getBackStackEntry(route) ve NavController.clearBackStack(route) artık kısmen veya tamamen doldurulmuş bağımsız değişkenlere sahip rotaları destekliyor. Bağımsız değişkenlerin, girişin bağımsız değişkenleriyle tam olarak eşleşmesi gerektiğini unutmayın.
  • navDeepLink Kotlin DSL'si kullanılarak boş bir NavDeepLink oluşturulmaya çalışıldığında artık derin bağlantının geçerli olması için uri, action ve/veya mimetype'e ihtiyacı olduğunu belirten bir lint uyarısı gösterilecek.

2.5.0 sürümünden beri Navigation with Fragments'da yapılan önemli değişiklikler

  • NavHostFragment artık sistemin geri düğmesini engellemiyor. Bu, temel FragmentManager öğesinin sistem geri işlemini gerçekleştirmesine olanak tanır. Bu sayede Fragment 1.7.0-alpha01 ve sonraki sürümler, Android U cihazlarda uygulama içi tahmini geri animasyonu sağlayabilir.
  • Parçalarla gezinme kullanılırken artık FragmentTransaction işlemi manuel olarak yapılmaya çalışıldığında FragmentManager'nin geri yığınına bir parça eklenir ve IllegalArgumentException hatası verilir. Parçaları her zaman navigate() API'si üzerinden eklemelisiniz.
  • Bir gezinme XML dosyasının etkinlik öğesindeki app:data ve app:dataPattern özelliklerinde yer tutucu olarak tam ${applicationId} dizesi kullanıldığında, yer tutucu genişletme sırasında bağlamın packageName ile otomatik olarak doldurulur.
  • FragmentNavigator artık gezinme ve pop-up işlemleri sırasında geçiş API'lerini kullanıyor NavBackStackEntries. Bu, NavBackStackEntry Lifecycle öğesinin artık son Lifecycle.State öğesini hareket ettirmeden önce giriş ve çıkış parçası özel efektlerinin tamamlanmasını bekleyeceği anlamına gelir.
  • DialogFragmentNavigator artık gezinme ve pop-up işlemleri sırasında geçiş API'lerini kullanıyor NavBackStackEntries. Bu, NavBackStackEntry Lifecycle öğesinin artık DESTROYED öğesine geçmeden önce DialogFragment Lifecycle öğesinin DESTROYED öğesine geçmesini bekleyeceği anlamına gelir.
  • NavHostFragment artık NavHostFragment öğesi FragmentManager öğesine eklendiği anda NavController öğesini almanıza olanak tanıyor. Bu işlem daha önce yalnızca onCreate() işleminden sonra yapılabiliyordu.
  • Gezinme özelliğinin dinamik özellik modülleri desteği artık ayrıntılı Play Feature Delivery Kitaplığı'na bağlı.
  • Navigation Safe Args artık Android Gradle eklentisinin 7.3.0 sürümüne bağlıdır. Bu nedenle, artık yalnızca 7.3.0 ve sonraki sürümlerle uyumludur.

2.5.0 sürümünden beri NavigationUI'da yapılan önemli değişiklikler

  • Bir gezinme grafiğinin kimliğini AppBarConfiguration'ya iletirken (ör. Menu aracılığıyla) NavigationUI artık bu gezinme grafiğinin başlangıç hedefini üst düzey hedef olarak kabul ediyor. Grafikteki her hedefi yanlışlıkla üst düzey hedef olarak işaretlemiyor. Tek bir hedefin kimliğini iletme davranışı değişmedi. Aynı işlev, AppBarConfiguration üzerindeki yeni isTopLevelDestination işlevi aracılığıyla kendi kodunuzda da kullanılabilir.
  • Üst uygulama çubuğuyla çalışmak için NavigationUI'daki setupWithNavController entegrasyonları artık android:label'nızda bulunan ReferenceType bağımsız değişkenleri için R.string değerlerini otomatik olarak oluşturulan kaynak tamsayısını çıkış olarak vermek yerine String değerlerine ayrıştıracak.
  • NavigationUI artık seçilen bir MenuItem üzerinden gezinemediğinde günlükler sağlar.

Sürüm 2.6.0-rc02

24 Mayıs 2023

androidx.navigation:navigation-*:2.6.0-rc02 iptal edilir. 2.6.0-rc02 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Parçalarda gezinmeyle ilgili bir sorun düzeltildi. Bu sorunda, popUpTo ile gezinme ve görünümü yeniden oluşturmadan bir parçayı geri yığından çıkarma, sistemin geri düğmesinin çalışmayı durdurmasına neden oluyordu. (Ieb8d4, b/281726455)

Sürüm 2.6.0-rc01

10 Mayıs 2023

androidx.navigation:navigation-*:2.6.0-rc01 iptal edilir. 2.6.0-rc01 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Gezinme'de, bir parçanın popUpTo ile onResume() yaşam döngüsü geri çağırma işlevi kullanılarak kaldırılması durumunda IllegalStateException'ye neden olan parçalarla ilgili sorun düzeltildi. (I21884, b/279644470)

Sürüm 2.6.0-beta01

19 Nisan 2023

androidx.navigation:navigation-*:2.6.0-beta01 iptal edilir. 2.6.0-beta01 sürümü şu commit'leri içerir.

Yeni Özellikler

  • NavBackStackEntry artık özel bir toString uygulaması sunuyor. (Iff00b)

Hata Düzeltmeleri

  • Parçalarla gezinme kullanılırken artık FragmentTransaction işlemi manuel olarak yapılmaya çalışıldığında FragmentManager'nin geri yığınına bir parça eklenir ve IllegalArgumentException hatası verilir. Parçaları her zaman navigate() API'si üzerinden eklemelisiniz. (I6d38e)
  • Aynı karede bir giriş ekleyen navigate ve bu girişi kaldıran popBackStack olduğunda, eski yığındaki sonuçlanan üst giriş artık tutarlı bir şekilde RESUMED Lifecycle.State'e geri dönecek. (Id8067, b/276495952)

Sürüm 2.6.0-alpha09

5 Nisan 2023

androidx.navigation:navigation-*:2.6.0-alpha09 iptal edilir. 2.6.0-alpha09 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Geçersiz rota kontrolleri düzeltildi. Artık bir NavDestination, boş değer atanamayan NavArgument içeriyorsa bu hedefin rotası, boş değer atanamayan NavArgument ile aynı ada sahip bağımsız değişkenler için yer tutucular içermelidir. (Ic62bf, b/274697949)
  • Action/MimeType tabanlı derin bağlantı gezinmeleri, gezinme işleminde Action/MimeType ile eşleşen NavDestination tarafından gerekli olan, boş değer atanamayan bir NavArgument eksikse artık başarısız olur. (Ibfa17, b/271777424)
  • NavController, önceki grafikle aynı rotaya ve hedeflere sahip bir grafik ayarladığında artık mevcut grafik düğümlerini ve geri yığın hedeflerini yeni örneklerle düzgün bir şekilde değiştiriyor. Bu düzeltme, Navigation Compose'da durumu kaydetmeden onLaunchSingleTop kullanılırken yaşanan kilitlenme sorununu giderir. Bu düzeltme, kök grafik derlemeleriyle ilişkili hedeflere gitmenin yanlış geri yığın oluşturmasına neden olan hatayı da düzeltir. (I5bc58, b/275258161, b/275407804)

Sürüm 2.6.0-alpha08

22 Mart 2023

androidx.navigation:navigation-*:2.6.0-alpha08 iptal edilir. 2.6.0-alpha08 sürümü şu commit'leri içerir.

Yeni Özellikler

  • NavHostFragment artık NavHostFragment öğesi FragmentManager öğesine eklendiği anda NavController öğesini almanıza olanak tanıyor. Bu işlem daha önce yalnızca onCreate() işleminden sonra yapılabiliyordu. (Ic6382, b/220186282)

Hata Düzeltmeleri

  • Boş değer atanamayan bir bağımsız değişken içeren iç içe yerleştirilmiş bir grafik açılırken oluşan NullPointerException düzeltildi. (6b3581, b/249988437)
  • popUpTo ile gezinme işleminden sonra sistem geri işlevi kullanıldığında NavController durumu doğru girişe yönlendirilir. (I3a8ec, b/270447657)
  • FragmentNavigator artık sistem geri veya popBackStack() aracılığıyla geri yığın çıkarıldığında ve işlemin parça için efekt kullanıp kullanmadığına bakılmaksızın girişleri düzgün şekilde çıkaracak. (I81bdf)
  • Gezinme kullanmadan FragmentNavigator's FragmentManager öğesine parça eklemek artık kilitlenmeye neden olmayacak. (b17204, b/274167493)

Bağımlılık Güncellemeleri

Sürüm 2.6.0-alpha07

8 Mart 2023

androidx.navigation:navigation-*:2.6.0-alpha07 iptal edilir. 2.6.0-alpha07 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Artık rotaları alan getBackStackEntry, popBackStack, clearBackStack API varyantları, boş değer atanabilir bağımsız değişkenlere ve boş değer atanabilir sorgu parametrelerine sahip rota kalıplarını kullanıyor (I22294, b/269302500).
  • NavController öğesinden clearBackStack() çağrıldığında, temizlenen arka yığınla ilişkili parça yöneticisindeki kayıtlı durumun temizlenmemesine neden olan sorun düzeltildi. (Ic1cce, b/271190202)
  • 2.6.0-alpha06 sürümünde, sekmeler arasında Sistem Geri'yi kullanırken BottomNavigationView içindeki yanlış MenuItem öğesinin vurgulanmasına neden olan gerileme düzeltildi. (I634f6, b/270447657)
  • 2.6.0-alpha06 sürümünde, Animation kullanılırken NavBackStackEntryların RESUMED durumuna taşınmamasına neden olan gerileme düzeltildi. (Ib3589, b/269646882)

Sürüm 2.6.0-alpha06

22 Şubat 2023

androidx.navigation:navigation-*:2.6.0-alpha06 iptal edilir. 2.6.0-alpha06 sürümü şu commit'leri içerir.

Yeni özellikler

  • NavHost ile bir composable'ı önizlerken artık varsayılan olarak NavGraph'ın startDestination öğesi gösterilecek. (I2b89f)

API Değişiklikleri

  • Tüm NavController navigate aşırı yüklemeleri artık ana iş parçacığında çağrıldıklarından emin olmak için @MainThread ile açıklama eklenmiş durumda. (I2c0b0, b/263427111)

Hata Düzeltmeleri

  • Dinamik Parça Gezinme kullanılırken gezinmeye çalışıldığında yaşanan kilitlenme sorunu düzeltildi. (I3ee29, b/268360479)
  • Sistemin geri düğmesiyle başka bir parçaya gidildiğinde alt çubuğun doğru seçili öğeyle güncellenmemesi hatası düzeltildi (If559f, b/269044426).

Bilinen Sorunlar

  • Parçalarla gezinme kullanılırken Animation API'leri kullanıldığında NavBackStackEntry'nın yaşam döngüsü RESUMED'ye ulaşamıyor. (b/269646882)
  • Parçalarla gezinme kullanılırken ve BottomNavigation ile gezinilirken birden fazla giriş içeren bir geri yığını geri yüklemeye çalışırsanız BottomMenuItem doğru şekilde güncellenmez. (b/270447657)
  • Parçalarla gezinme kullanılırken durum geri yüklendikten sonra parçası DESTROYED olduğunda NavBackStackEntry Lifecycle DESTROYED olmaz . (b/270610768)

Sürüm 2.6.0-alpha05

8 Şubat 2023

androidx.navigation:navigation-*:2.6.0-alpha05 iptal edilir. 2.6.0-alpha05 sürümü şu commit'leri içerir.

Yeni Özellikler

  • NavController.popBackStack(route), NavController.getBackStackEntry(route) ve NavController.clearBackStack(route) artık kısmen veya tamamen doldurulmuş bağımsız değişkenlere sahip rotaları destekliyor. Bağımsız değişkenlerin, girişin bağımsız değişkenleriyle tam olarak eşleşmesi gerektiğini unutmayın. (Iebd28, Ic678c, I3b37b, b/257514373)
  • FragmentNavigator artık gezinme ve pop-up işlemleri sırasında geçiş API'lerini kullanıyor NavBackStackEntries. Bu, NavBackStackEntry Lifecycle öğesinin artık son Lifecycle.State öğesini hareket ettirmeden önce giriş ve çıkış parçası özel efektlerinin tamamlanmasını bekleyeceği anlamına gelir. (I3cb19, b/238686802)
  • DialogFragmentNavigator artık gezinme ve pop-up işlemleri sırasında geçiş API'lerini kullanıyor NavBackStackEntries. Bu, NavBackStackEntry Lifecycle öğesinin artık DESTROYED öğesine geçmeden önce DialogFragment Lifecycle öğesinin DESTROYED öğesine geçmesini bekleyeceği anlamına gelir. (I53ee5, b/261213893)

API Değişiklikleri

  • NavigatorState, Navigator'lerin NavBackStackEntries'leri ara Lifecycle.State'lere taşımasına olanak tanıyan prepareForTransition API'sini sunmaktadır. (I42c21, b/238686802)
  • Artık NavGraphNavigator veya ComposeNavigator ile ilişkili geri yığına backstack mülkü üzerinden erişebilirsiniz. ComposeNavigator artık onTransitionComplete() geri çağırmasını da kullanıma sunarak bir gezinme veya popBackStack işlemi gerçekleştirmiş olan bir NavBackStackEntry öğesini tamamlandı olarak işaretlemenizi sağlar. (I02062, I718db, b/257519195)

Hata Düzeltmeleri

  • Giriş zaten işleniyorsa Navigator durumu artık push/popWithTransition API'leri kullanılırken işlem yapmayacak. (Iadbfa, b/261213893)
  • İç içe yerleştirilmiş bir NavGraph ile launchSingleTop kullanılırken orijinal hedeften startDestination'sine kadar olan tüm hedefler yalnızca geri yığınının en üstüne doğru şekilde eklenir. (Id4bea, b/253256629)
  • Gezinme özelliği, launchSingleTop işareti true olarak ayarlanmış şekilde aynı hedefe gidildiğinde artık DialogFragment örneğini düzgün şekilde değiştirecek. (I45b5a, b/149572817)
  • Navigation SafeArgs, tam olarak 19 karakter uzunluğunda bağımsız değişkenler kullanıldığında artık derleme hatasına neden olmayacak. (Id60bc, b/257110095)

Sürüm 2.6.0-alpha04

9 Kasım 2022

androidx.navigation:navigation-*:2.6.0-alpha04 iptal edilir. 2.6.0-alpha04 sürümü şu commit'leri içerir.

Yeni Özellikler

  • NavType öğesinin özel alt sınıfları artık bir değeri dizeye dönüştürmek için serializeAsValue öğesini geçersiz kılabilir. Bu sayede hem serileştirme hem de seri durumdan çıkarma (parseValue aracılığıyla) tamamen NavType sınıfında kapsanabilir. StringType artık bu yöntemi geçersiz kılarak belirtilen String üzerinde Uri.encode'ı çağırır. (Ie5213, b/247637434)
  • NavigationUI artık seçilen bir MenuItem üzerinden gezinemediğinde günlükler sağlar. (I2af5a, b/247730357)

Hata Düzeltmeleri

  • Gezinme derin bağlantıları artık grafik başlatma sırasında değil, geç ayrıştırılıyor. Bu da başlangıçta uygulama performansını artırabilir. (Iab0ab)
  • Derin bağlantı oluşturma işlemiyle varsayılan bağımsız değişkenleri null olan bir hedefe gidildikten sonra yukarı gidildiğinde oluşan kilitlenme sorunu düzeltildi. (I51c24, b/243183636)

Bağımlılık Güncellemesi

  • Gezinme özelliğinin dinamik özellik modülleri desteği artık ayrıntılı Play Feature Delivery Kitaplığı'na bağlı. (Ib4ddc)
  • Navigation Safe Args artık Android Gradle eklentisinin 7.3.0 sürümüne bağlıdır. Bu nedenle, artık yalnızca 7.3.0 ve sonraki sürümlerle uyumludur. (I47e49)

Sürüm 2.6.0-alpha03

24 Ekim 2022

androidx.navigation:navigation-*:2.6.0-alpha03 iptal edilir. 2.6.0-alpha03 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Gezinme 2.5.3 bölümünden: NavHost, Crossfade için oluşturulacak bir hedef olmadığında artık NoSuchElementException'e neden olmayacak. Artık yalnızca kompozisyon atlanır. (Ieb46e, b/253299416)
  • Navigation 2.5.3: Bir hedef arka yığından çıkarıldığında kaydedilmiş Compose durumunun (ör. rememberSaveable kullanımları) unutulup kaldırılmamasına neden olan sorun düzeltildi. (I64949)

Bağımlılık Güncellemeleri

Sürüm 2.6.0-alpha02

5 Ekim 2022

androidx.navigation:navigation-*:2.6.0-alpha02 iptal edilir. 2.6.0-alpha02 sürümü şu commit'leri içerir.

Davranış Değişiklikleri

  • Bir gezinme grafiğinin kimliğini AppBarConfiguration'ya iletirken (ör. Menu aracılığıyla) NavigationUI artık bu gezinme grafiğinin başlangıç hedefini üst düzey hedef olarak kabul ediyor. Grafikteki her hedefi yanlışlıkla üst düzey hedef olarak işaretlemiyor. Tek bir hedefin kimliğini iletme davranışı değişmedi. Aynı işlev, AppBarConfiguration üzerindeki yeni isTopLevelDestination işlevi aracılığıyla kendi kodunuzda da kullanılabilir. (Ie936e, b/238496771)

Hata Düzeltmeleri

  • navigation:navigation-fragment bileşeni artık Parça sürümü 1.5.2'ne bağlıdır. (I00ba4)
  • Seçili menü öğesi, iletişim kutusu gibi bir FloatingWindow hedefine gidildiğinde artık güncellenmeyecek. (I4cde8, b/240308330)

Sürüm 2.6.0-alpha01

7 Eylül 2022

androidx.navigation:navigation-*:2.6.0-alpha01 iptal edilir. 2.6.0-alpha01 sürümü şu commit'leri içerir.

Yeni Özellikler

  • Üst uygulama çubuğuyla çalışmak için NavigationUI'daki setupWithNavController entegrasyonları artık android:label'nızda bulunan ReferenceType bağımsız değişkenleri için R.string değerlerini otomatik olarak oluşturulan kaynak tamsayısını çıkış olarak vermek yerine String değerlerine ayrıştıracak. (I5f803, b/167959935)
  • NavDeepLink artık diziler için varsayılan değerleri destekliyor. Bu sayede, bağımsız değişkenin dizi türüyle eşlenecek olan tekrarlanan sorgu parametreleri desteklenebiliyor. NavType artık iki ayrıştırılmış değeri birleştirmek için geçersiz kılınabilen varsayılan bir yöntemi de içeriyor. (Id68c3, b/209977108)
  • Bir gezinme XML dosyasının etkinlik öğesindeki app:data ve app:dataPattern özelliklerinde yer tutucu olarak tam ${applicationId} dizesi kullanıldığında, yer tutucu genişletme sırasında bağlamın packageName ile otomatik olarak doldurulur. (Iaabde, b/234223561)
  • navDeepLink Kotlin DSL'si kullanılarak boş bir NavDeepLink oluşturulmaya çalışıldığında artık derin bağlantının geçerli olması için uri, action ve/veya mimetype'e ihtiyacı olduğunu belirten bir lint uyarısı gösterilecek. (I08d2f, b/154038883)

API Değişiklikleri

  • android:label="{arg}" biçiminde bağımsız değişkenlere sahip dinamik etiketleri String olarak ayrıştırmak için yeni NavDestination uzantı işlevi eklendi. ReferenceType değerlerini dize değerlerine ayrıştırarak R.string bağımsız değişkenlerini destekler. (I07d89, b/236269380)

Davranış Değişiklikleri

  • NavBackStackEntry'nin arguments ve OnDestinationChangedListener'ye iletilen arguments artık yalnızca hedefe gittiğinizde oluşturulan değişmez bağımsız değişkenlerin bir kopyasıdır. Bu nedenle, bu paketlerde yapılan değişiklikler, arguments veya diğer OnDestinationChangedListener örneklerine sonraki erişimlerde yansıtılmaz. (I676f5)

Hata Düzeltmeleri

  • Gezinme 2.5.2: Dinamik gezinme artık diğer modüllerden etkinlik hedeflerini yüklemeyi dener ve ardından bu hedeflere gider. (Ia2c16, b/240292838)
  • Gezinme 2.5.2: Gezinme, aynı hedefe gidip launchSingleTop işaretini doğru olarak ayarlarken artık Fragment örneğini düzgün şekilde değiştirecek. (I5a2f1, b/237374580)
  • Gezinme 2.5.2: Yeni açılan bir başlangıç hedefiyle üst öğe paylaşan, iki kez iç içe yerleştirilmiş bir grafiğe gidildiğinde oluşan IllegalStateException düzeltildi. (I9f7cb, b/243778589)

Sürüm 2.5

Sürüm 2.5.3

24 Ekim 2022

androidx.navigation:navigation-*:2.5.3 iptal edilir. 2.5.3 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • NavHost, Crossfade için oluşturulacak hedef olmadığında artık NoSuchElementException hatasına neden olmayacak. Artık yalnızca kompozisyon atlanır. (Ieb46e, b/253299416)
  • Bir hedef arka yığından çıkarıldığında, kaydedilen Compose durumunun (ör. rememberSaveable kullanımları) unutulup kaldırılmamasına neden olan sorun düzeltildi. (I64949)

Sürüm 2.5.2

7 Eylül 2022

androidx.navigation:navigation-*:2.5.2 iptal edilir. 2.5.2 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Dinamik gezinme artık diğer modüllerdeki etkinlik hedeflerini, bu hedeflere gitmeden önce düzgün şekilde yüklemeye çalışıyor. (Ia2c16, b/240292838)
  • Gezinme, aynı hedefe gidilirken ve launchSingleTop işareti doğru olarak ayarlanırken artık Fragment örneğini düzgün şekilde değiştiriyor. (I5a2f1, b/237374580)
  • Yeni açılan başlangıç hedefiyle üst öğeyi paylaşan, iki kez iç içe yerleştirilmiş bir grafiğe gidildiğinde oluşan IllegalStateException sorunu düzeltildi. (I9f7cb, b/243778589)

Bağımlılık Güncellemesi

Sürüm 2.5.1

27 Temmuz 2022

androidx.navigation:navigation-*:2.5.1 iptal edilir. 2.5.1 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Navigation Safe Args, Bundle içinde kaydedilen özel bağımsız değişken türleri kullanılırken oluşturulan sınıflarda artık kullanımdan kaldırma uyarılarına neden olmayacak. (Id86ed, b/237725966)

Bağımlılık Güncellemeleri

Sürüm 2.5.0

29 Haziran 2022

androidx.navigation:navigation-*:2.5.0 iptal edilir. 2.5.0 sürümü şu commit'leri içerir.

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

  • CreationExtras Entegrasyonu: Navigation artık Lifecycle 2.5.0'ın CreationExtras aracılığıyla durum bilgisi içermeyen ViewModelProvider.Factory sağlayabilir.

Navigation SafeArgs

  • Navigation Safe Args, Android Gradle Plugin bağımlılığını 7.0.4'ye dayanacak şekilde yükseltti ve 7.0'den önceki AGP sürümleriyle uyumluluğu bıraktı.
  • applicationId yerine kullanılacak ad alanı build.gradle özelliği için destek eklendi.

Diğer Değişiklikler

  • visibleEntries API artık deneysel değildir ve NavController'e göre hedefi şu anda görünür olan tüm girişleri almak için bir işlev sağlar.

Sürüm 2.5.0-rc02

15 Haziran 2022

androidx.navigation:navigation-*:2.5.0-rc02 iptal edilir. 2.5.0-rc02 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Navigation Compose NavHost kullanılırken alt hedefler arasında hızlı geçiş yapıldığında kilitlenmeye neden olan sorun düzeltildi. (I3979a, b/234054916)
  • Navigation SafeArgs, applicationIdSuffix ve ad alanı kullanılırken artık kilitlenmeyecek. Bu durum, applicationId öğesinin bulunmadığı veya applicationId ile ad alanının farklı olduğu durumlarda geçerlidir. (I754b1, b/233119646)
  • NavArgument artık bağımsız değişkenin dahili değerlerini göstermek için özel bir toString() işlevine sahip. (I900a8)

Sürüm 2.5.0-rc01

11 Mayıs 2022

androidx.navigation:navigation-*:2.5.0-rc01 iptal edilir. 2.5.0-rc01 sürümü şu commit'leri içerir.

Yeni Özellikler

  • navigation.xml dosyanızda <deeplink> öğelerini <activity> öğelerinin içine yerleştirme konusunda uyarı veren yeni bir lint kuralı eklendi.(Ic15a5, b/178403185)

Hata Düzeltmeleri

  • NavHost ve DialogHost içindeki birleştirilebilir kapsamlar artık beklenen sırada (yani içteki birleştirilebilirler dıştakilerden önce) kaldırılıyor. (I157e6)
  • Navigation SafeArgs artık önbelleğin taşınabilirliğini sağlamak için ArgumentsGenerationTask içinde PathSensitivity.RELATIVE kullanıyor. Bu, önbellek girişinin artık bir CI derlemesinden yerel bir derlemeye yeniden kullanılabileceği anlamına gelir. (I5f67c, b/173420454)
  • UnrememberedGetBackStackEntryDetector lint kuralı, getBackStackEntry() çağrısı etrafındaki remember çağrısının da anahtar olarak NavBackStackEntry nesnesini geçirmesini sağlamak için güncellendi.(Ib7081, b/227382831)

Sürüm 2.5.0-beta01

20 Nisan 2022

androidx.navigation:navigation-*:2.5.0-beta01 iptal edilir. 2.5.0-beta01 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • DialogNavigator artık dismiss() araması yaparken popWithTransition kullanıyor. Bu düzeltme, dialog hedefinde ViewModel kullanılırken, iletişim kutusunu sistem geri düğmesini kullanarak veya iletişim kutusunun dışına dokunarak kapatırken IllegalStateException hatasına neden olan yarışma koşulunu düzeltir. (Id7376, b/226552301)

Bağımlılık Güncellemeleri

  • Gezinme artık Yaşam Döngüsü2.5.0-beta01'ne bağlı. Birden fazla geri yığın kullanırken bir NavHost'i birincil olmayan bir alt gezinme sekmesinde başka bir NavHost'in içine yerleştirirken IllegalStateException düzeltildi.

Sürüm 2.5.0-alpha04

6 Nisan 2022

androidx.navigation:navigation-*:2.5.0-alpha04 iptal edilir. 2.5.0-alpha04 sürümü şu commit'leri içerir.

API Değişiklikleri

Hata Düzeltmeleri

  • NavHost artık hangi girişlerin oluşturulacağını belirlemek için NavController'deki visibleEntries'ya bağlıdır. Bu, iç içe yerleştirilmiş NavHost kullanılırken artık içteki NavHost öğesinin düzgün şekilde animasyonla çıkacağı anlamına gelir. (I4ba2b, b/225394514)
  • NavController tarafından sağlanan visibleEntries StateFlow artık mevcut yaşam döngüsü durumu yerine girişin maksimum yaşam döngüsü durumuna göre belirleniyor. Bu nedenle, navController öğesinin ana makine yaşam döngüsü STARTED'ın altına düşse bile görünür girişlerin listesi aynı kalır. (I9e2a8, b/225394514)
  • SavedStateViewFactory artık SavedStateRegistryOwner ile başlatılmış olsa bile CreationExtras kullanımını destekliyor. Ekstralar sağlanırsa başlatılan bağımsız değişkenler yoksayılır. (I6c43b, b/224844583)
  • NavDeepLink artık değeri olmayan tek bir sorgu parametresine sahip URI'leri ayrıştırabilir. (I0efe8, b/148905489)
  • Boş dizeler artık derin bağlantılarda geçerli bağımsız değişkenler olarak kabul ediliyor. (I70a0d, b/217399862)
  • Ad alanları kullanılırken ve AndroidManifest.xml bulunmadığında Navigation Safe Args artık kilitlenmeyecek. (I17ccf, b/227229815)

Sürüm 2.5.0-alpha03

23 Şubat 2022

androidx.navigation:navigation-*:2.5.0-alpha03 iptal edilir. 2.5.0-alpha03 sürümü şu commit'leri içerir.

API Değişiklikleri

  • Artık ViewModel oluşturmak için CreationExtras değerini by navGraphViewModels parametresine iletebilirsiniz. (I29217, b/217618359)

Hata Düzeltmeleri

  • NavDeepLinks artık rotalara/derin bağlantı URI'lerine yerleştirilmiş kodlanmış yeni satır karakterlerini düzgün şekilde destekliyor. (I513d1, b/217815060)
  • CreationExtras, artık ViewModel'ler oluşturmak için NavBackStackEntries ile birlikte kullanıldığında doğru şekilde çalışacak. (I69161, b/217617710)
  • Navigation Safe Args artık AndroidManifest'teki paketin yerine build.gradle içinde tanımlanan ad alanının kullanılmasını destekliyor. (I659ef, b/217414933)

Sürüm 2.5.0-alpha02

9 Şubat 2022

androidx.navigation:navigation-*:2.5.0-alpha02 iptal edilir. 2.5.0-alpha02 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Gezinme 2.4.1: NavHostFragment, iç içe yerleştirilmiş grafiklerle viewbinding kullanılırken artık OnBackPressedDispatcher öğesini düzgün şekilde ayarlayacak. (Ifbb51, b/214577959)
  • Gezinme2.4.1: Birden fazla iç içe yerleştirilmiş NavGraph üzerinden derin bağlantı oluşturulduğunda geri yığın artık ara başlangıç hedeflerini düzgün şekilde içerecek. (I504c0, b/214383060)

Sürüm 2.5.0-alpha01

26 Ocak 2022

androidx.navigation:navigation-*:2.5.0-alpha01 iptal edilir. 2.5.0-alpha01 sürümü şu commit'leri içerir.

Yeni Özellikler

Hata Düzeltmeleri

  • Bir Fragment'ın onCreate() bölümünden by navGraphViewModels() aracılığıyla oluşturulan ViewModel öğesine erişmenin IllegalStateException ile başarısız olmasına neden olan sorun düzeltildi. (I8a14d)
  • NavDeepLink artık gereksiz yere iki kez kod çözülmeyecek. Bu sayede, nihai hedefinize doğru bağımsız değişkenler iletilecek. (I31b0a, b/210711399)

Safe Args

  • Safe Args artık Android Gradle eklentisi 7.0.4 sürümüne bağlıdır. Bu nedenle, Navigation Safe Args artık 7.0'dan önceki Android Studio sürümleriyle uyumlu olmayacak ancak Android Gradle eklentisinin 7.1.0 ve sonraki sürümleriyle uyumlu olacaktır. (I41c88, b/213086135, b/207670704)

Sürüm 2.4.2

Sürüm 2.4.2

6 Nisan 2022

androidx.navigation:navigation-*:2.4.2 iptal edilir. 2.4.2 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

Sürüm 2.4.1

Sürüm 2.4.1

9 Şubat 2022

androidx.navigation:navigation-*:2.4.1 iptal edilir. 2.4.1 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • NavHostFragment, iç içe yerleştirilmiş grafiklerle viewbinding kullanılırken artık OnBackPressedDispatcher öğesini düzgün şekilde ayarlayacak. (Ifbb51, b/214577959)
  • Birden fazla iç içe yerleştirilmiş NavGraph üzerinden derin bağlantı oluşturulduğunda geri yığın artık ara başlangıç hedeflerini düzgün şekilde içerecek. (I504c0, b/214383060)
  • Navigation 2.5.0-alpha01'dan geri taşındı: by navGraphViewModels() aracılığıyla oluşturulan bir ViewModel'e Fragment'in onCreate() bölümünden erişildiğinde IllegalStateException ile başarısız olmasına neden olan sorun düzeltildi. (I8a14d)
  • Navigation 2.5.0-alpha01'dan geri taşındı: NavDeepLinkArtık bağımsız değişkenler gereksiz yere iki kez kod çözülmüyor. Bu sayede, düzgün şekilde kod çözülmüş bağımsız değişkenler nihai hedefinize iletiliyor. (I31b0a, b/210711399)
  • Navigation 2.5.0-alpha01'dan geri taşındı: Safe Args artık Android Gradle Eklentisi 7.0.4 sürümüne bağlıdır. Bu nedenle, Navigation Safe Args artık 7.0'dan önceki Android Studio sürümleriyle uyumlu olmayacak ancak Android Gradle eklentisinin 7.1.0 ve sonraki sürümleriyle uyumlu olacaktır. (I41c88, b/213086135, b/207670704)

Sürüm 2.4.0

Sürüm 2.4.0

26 Ocak 2022

androidx.navigation:navigation-*:2.4.0 iptal edilir. 2.4.0 sürümü şu commit'leri içerir.

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

  • Tüm Navigation yapıları Kotlin ile yeniden yazıldı. Bu, genel öğeler kullanan sınıfların (ör. NavType alt sınıfları) boş değer atanabilirliğini iyileştirdi. Eskiden -ktx yapılarının parçası olan tüm Kotlin uzantı işlevleri, ilgili ana yapılara taşındı. -ktx yapıları yayınlanmaya devam eder ancak tamamen boştur.
  • navigation-fragment yapısı artık yeni AbstractListDetailFragment aracılığıyla iki panelli düzenin önceden oluşturulmuş bir uygulamasını içeriyor. Bu parça, örnek uygulamamızda görüldüğü gibi, bir liste bölmesini (alt sınıfınız tarafından sağlanır) ve bir ayrıntı bölmesini yönetmek için SlidingPaneLayout kullanır. Ayrıntı bölmesi, uygulama olarak NavHostFragment kullanır.
  • NavController üzerindeki currentBackStackEntryAsFlow() yöntemi, mevcut NavBackStackEntry her değiştiğinde yayın yapan bir Flow sağlar. Bu akış, OnDestinationChangedListener'nın manuel olarak yönetilmesine alternatif olarak kullanılabilir.
  • NavController artık deneysel visibleEntries özelliği aracılığıyla tüm görünür NavBackStackEntry örneklerinin listesini StateFlow olarak alma olanağı sunuyor.
  • Artık NavType sınıfını genişleterek özel NavType'lar oluşturabilirsiniz. Özel türler yalnızca gezinme grafiğinizi programatik olarak oluştururken (ör. Navigation Graph Kotlin DSL aracılığıyla) desteklenir.

  • Navigation artık özel NavigationUI'nin uygulanmasına yardımcı olmak için kullanılabilecek findStartDestination() ve getHierarchy() API'leri sunuyor. findStartDestination(), NavGraph üzerinde bir uzantı işlevidir. startDestination kendi başına iç içe yerleştirilmiş bir NavGraph olsa bile grafiğe gittiğinizde gösterilecek gerçek başlangıç hedefini bulur. getHierarchy(), NavDestination üzerinde belirli bir hedefin başka bir hedefin hiyerarşisi içinde olup olmadığını doğrulamak için kullanılabilen bir işlevdir.

    val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }

  • NavigationUI yöntemleri, BottomNavigationView yerine Material 1.4.0, NavigationBarView'de kullanıma sunulan üst sınıfını alacak şekilde güncellendi. Bu sayede, bu yöntemler NavigationRailView ile kullanılabilir.

  • Bir <action> öğesi XML üzerinden genişletilirken animasyon özellikleri, app:enterAnim="?attr/transitionEnter" söz dizimi kullanılarak temanızdan çekilen özellikleri kullanabilir.

  • Safe Args artık her NavArgs sınıfı için bir fromSavedStateHandle() yöntemi oluşturuyor. (#122, b/136967621)

    class HomeViewModel(savedStateHandle: SavedStateHandle) : ViewModel() {
  // Create a HomeDestinationArgs class with type safe accessors for each argument
  // defined on your destination
  private val args = HomeDestinationArgs.fromSavedStateHandle(savedStateHandle)
}

Gezinme Rotaları ve Kotlin DSL'si

Navigasyon'un önceki sürümlerinde, her hedef için benzersiz bir tam sayı kimliği kullanılıyordu. Bu kimlik, hedefi kardeş hedeflerinden benzersiz şekilde tanımlıyor ve doğrudan veya bir işlem aracılığıyla o hedefe navigate() gitmenize olanak tanıyordu. Bu yöntem, özellikle gezinme grafiğinizi XML'de tanımladığınız ve otomatik olarak oluşturulan R.id sabitlerini ya da Safe Args'ı (bu sabitleri kullanarak derleme zamanında kod oluşturur) kullanabildiğiniz durumlarda geçerliliğini ve faydasını korumaya devam etse de bu benzersiz tam sayı sistemi, Navigation Kotlin DSL aracılığıyla çalışma zamanında programatik olarak oluşturulan tamamen dinamik grafikleri desteklemek için gereken anlamsal anlamı ve ifade gücünü yakalamadı.

Bu sürümde, bir hedefi navigasyon grafiğinde rotasına göre benzersiz şekilde tanımlamak için yeni bir seçenek sunuluyor. Rota, bir hedefe giden benzersiz yolu tanımlayan bir String'dir. Hedef kimliği alan tüm Kotlin DSL yöntemleri artık kullanımdan kaldırıldı ve rota alan eşdeğer bir API ile değiştirildi.

Her rota, hedefi tanımlayan bir Uri öğesinin "yol" kısmı olarak değerlendirilmelidir. Örneğin: home, profile/{userId}, profile/{userId}/friends vb. Bir hedef kimliği belirli bir içerikle ilişkilendirildiğinde bu dinamik bağımsız değişkenler, örtülü derin bağlantılarla aynı kurallara uyarak rotanın bir parçası olmalıdır.

Daha önce yalnızca kimlik alan tüm NavController API'leri artık rota String alan bir aşırı yüklemeye sahip. Bu kategoriye navigate(), popBackStack(), popUpTo() ve getBackStackEntry() dahildir.

Bu durumun API ile ilgili bazı sonuçları oldu:

  • Kotlin DSL'deki popUpTo Kotlin özelliğinin desteği sonlandırıldı. Bunun yerine popUpToId kullanılacak.
  • getStartDestination() API'si, getStartDestinationId() lehine kullanımdan kaldırıldı.

Kimliğe göre gezinmenin aksine, rotaya göre gezinme örtülü derin bağlantılarla aynı kurallara uyar. Bu sayede, harici olarak görünür bir derin bağlantıyı her hedefe açıkça eklemeden çok modüllü projelerde kullanılabilir olmalarını sağlayarak herhangi bir iç içe yerleştirilmiş grafikteki herhangi bir hedefe doğrudan gidebilirsiniz.

Navigation Compose

navigation-compose yapısı, Navigation Component ile Jetpack Compose arasında entegrasyon sağlar. Uygulamanızdaki hedefler olarak @Composable işlevlerini kullanır.

Bu sürümde sunulanlar:

  • NavHost ve dialog hedeflerini kullanarak Kotlin DSL aracılığıyla gezinme grafiğinizi oluşturmanıza olanak tanıyan bir NavHost composable'ı. Ayrıca, Accompanist Navigation Material'daki gibi isteğe bağlı Navigator'lar için destek de sunar.composable
  • Hedefler arasında geçiş efektinin zorunlu olarak desteklenmesi. Eşlikçi gezinme animasyonu, deneysel Compose API'leri kullanılarak giriş ve çıkış geçişlerini kontrol etmek için kullanılabilir.
  • Her bir composable hedef için Lifecycle kapsamı. Her hedef yalnızca giriş geçişleri tamamlandığında RESUMED durumuna ulaşır ve çıkış geçişleri başladığında hemen STARTED durumuna düşer. Böylece, yalnızca Lifecycle RESUMED olduğunda bir navigate çağrısı tetikleyerek tüm IllegalStateException ve çoklu dokunma sorunlarını önleyebilirsiniz.
  • ViewModel kapsamı (hedef düzeyinde Lifecycle ViewModel Compose 2.4.0'un viewModel() API'si veya Hilt Navigation Compose 1.0.0'un hiltViewModel() aracılığıyla). Bu kapsam, yapılandırma değişikliklerinden ve geri yığında olmaktan (Composable içeriğiniz başka bir şekilde kaldırıldığında) etkilenmez. Ayrıca, ViewModel'in onCleared() bölümünde, NavBackStackEntry ile ilişkili durumun kalıcı olarak kaldırıldığını ve temizlendiğini belirten bir sinyal sağlar.
  • rememberSaveable durumunun hedef düzeyinde kapsamı belirlenir. Böylece, hedefe döndüğünüzde tüm birleştirilebilir durum otomatik olarak kaydedilir ve geri yüklenir.
  • İşlem sonlandırılıp yeniden oluşturulduktan sonra NavController ve hedefinin durumunu kaydetme ve geri yükleme için tam destek.
  • Sistemin geri düğmesiyle otomatik entegrasyon.

  • Bağımsız değişkenleri iletme, hedeflere derin bağlantılar ekleme ve önceki hedeflere sonuç döndürme desteği.

  • rememberNavController() ve currentBackStackEntryAsState() içinde, durum yükseltmeye izin vermek ve NavController öğesini NavHost dışındaki composable'lara (ör. alt gezinme çubuğu) bağlamak için belirli yardımcılar oluşturun.

val navController = rememberNavController()
Scaffold { innerPadding ->
    NavHost(navController, "home", Modifier.padding(innerPadding)) {
        composable("home") {
            // This content fills the area provided to the NavHost
            HomeScreen()
        }
        dialog("detail_dialog") {
            // This content will be automatically added to a Dialog() composable
            // and appear above the HomeScreen or other composable destinations
            DetailDialogContent()
        }
    }
}

Daha fazla bilgi için Compose Navigation kılavuzuna bakın.

Birden fazla geri yığın

NavController, hedeflerin eski yığınını yönetmekten, navigate() ile hedeflere gittiğinizde hedefleri eski yığına eklemekten ve popBackStack() işlevini çağırdığınızda veya sistemin geri düğmesini tetiklediğinizde hedefleri kaldırmaktan sorumludur. Mevcut NavOptions sınıfı ve gezinme grafiği XML'sindeki <action> öğeleriyle entegrasyon, geri yığını kaydetme ve geri yükleme işlemlerini destekleyecek şekilde genişletildi.

Bu değişiklik kapsamında, NavigationUI yöntemleri onNavDestinationSelected(), BottomNavigationView.setupWithNavController() ve NavigationView.setupWithNavController() artık açılan hedeflerin durumunu otomatik olarak kaydedip geri yükleyerek kodda herhangi bir değişiklik yapmadan birden fazla geri yığınını desteklemeyi mümkün kılıyor. Navigation with Fragments kullanılırken birden fazla geri yığınıyla entegrasyon için bu yöntem önerilir.

Durumu kaydetme ve geri yükleme için temel alınan API'ler çeşitli yüzeyler aracılığıyla kullanıma sunulur:

  • Navigasyon XML'sinde artık <action> öğesi, app:popUpToSaveState ve app:restoreState boolean özelliklerini kullanarak app:popUpTo aracılığıyla açılan tüm hedeflerin durumunu kaydedebilir ve app:destination olarak iletilen hedefle ilişkili durumu geri yükleyebilir:

    <action
  android:id=”@+id/swap_stack”
  app:destination=”@id/second_stack”
  app:restoreState=”true”
  app:popUpTo=”@id/first_stack_start_destination”
  app:popUpToSaveState=”true” />

  • navOptions Kotlin DSL'de, popUpTo oluşturucusuna restoreState boole özelliğini ve saveState boole özelliğini ekleyebilirsiniz:

    // Use the navigate() method that takes a navOptions DSL Builder
navController.navigate(selectedBottomNavRoute) {
  launchSingleTop = true
  restoreState = true
  popUpTo(navController.graph.findStartDestination().id) {
    saveState = true
  }
}

  • NavOptions.Builder aracılığıyla manuel olarak bir NavOptions nesnesi oluştururken ek bir saveState parametresi alan setPopUpTo() için setRestoreState() ve yeni aşırı yüklemeyi kullanabilirsiniz.

    NavOptions navOptions = new NavOptions.Builder()
  .setLaunchSingleTop(true)
  .setRestoreState(true)
  .setPopUpTo(NavGraph.findStartDestination(navController.getGraph()).getId(),
    false, // inclusive
    true) // saveState
  .build();
navController.navigate(selectedBottomNavId, null, navOptions);

  • popBackStack() için yapılan programatik çağrılar artık ek bir saveState parametresi içerebilir.

  • clearBackStack() yöntemini kullanarak popBackStack() veya popUpToSaveState ile kaydedilen tüm durumları temizleyebilirsiniz.

Her durumda, NavController, kapsamı belirlenmiş ViewModel örnekleri de dahil olmak üzere her bir NavBackStackEntry'nin durumunu kaydeder ve geri yükler. Navigator API'leri, her Navigator'nin kendi durumunu kaydetmesini ve geri yüklemesini destekleyecek şekilde güncellendi.

Davranış değişiklikleri

  • NavDeepLinkBuilder artık PendingIntent PendingIntent.FLAG_IMMUTABLE ekliyor. Bu sayede createPendingIntent() tarafından döndürülen PendingIntent, Android 12 hedeflenirken bu API'nin beklendiği gibi çalışmasını sağlıyor.
  • Navigasyon artık Lifecycle 2.3.1'a bağlıdır. Ayrıca setGraph(), popBackStack(), navigateUp() ve navigate() yöntemleri artık NavBackStackEntry Lifecycle'ı @MainThread olarak günceller. Bu sayede Navigasyon, Lifecycle 2.3.0'da kullanıma sunulan ana iş parçacığı zorunluluğuyla uyumlu hale gelir.
  • Derin bağlantılar artık gerekli tüm bağımsız değişkenlerin (varsayılan değerleri olmayanlar) Uri içinde bulunduğunu doğruluyor.
  • NavDeepLink Ayrıştırılan bağımsız değişkenler artık yol segmentleri arasında ayırıcı olarak soru işaretleriyle aynı şekilde kare işaretlerini dikkate alıyor ve bir bağımsız değişkenin kare işareti boyunca yayılmasını engelliyor.
  • Kotlin kodu, Safe Args'tan oluşturulan işlemleri oluştururken artık varsayılan değerleri olmayan bağımsız değişkenleri, parametre olarak varsayılan değerleri olan bağımsız değişkenlerin önüne yerleştiriyor.
  • Güvenli Argümanlar, artık argüman oluştururken varsayılan değerleri olmayan parametreleri varsayılan değerleri olan parametrelerden önce yerleştiriyor.
  • Safe-Args artık Android Gradle Eklentisi 4.2.0'a bağlıdır. Bu durumda artık applicationIdTextResource kullanma uyarısını almazsınız.

Bilinen sorunlar

  • Gezinme 2.5.0-alpha01 bölümünde düzeltildi: onCreate() bölümünden by navGraphViewModels() aracılığıyla oluşturulan ViewModel öğesine erişildiğinde IllegalStateException hatası oluşuyordu. (b/213504272)
  • Navigation 2.5.0-alpha01'da düzeltildi: Safe Args 2.4.0, Android Gradle eklentisinin 7.1.0 ve sonraki sürümleriyle uyumlu değil. (b/213086135)
  • Birden fazla iç içe yerleştirilmiş gezinme grafiğiyle derin bağlantı oluşturma, tam geri yığını doğru şekilde oluşturmuyor. (b/214383060)

Sürüm 2.4.0-rc01

15 Aralık 2021

androidx.navigation:navigation-*:2.4.0-rc01 iptal edilir. 2.4.0-rc01 sürümü şu commit'leri içerir.

Davranış değişiklikleri

  • NavDeepLink ayrıştırılmış bağımsız değişkenler artık bağımsız değişkenler arasında ayırıcı olarak soru işaretleriyle aynı şekilde diyez işaretlerini de dikkate alıyor. (I21309, b/180042703)

Hata Düzeltmeleri

  • Derin bağlantılar artık yer tutucunun adıyla aynı değere sahip bağımsız değişkenleri yoksaymayacak. (If8017, b/207389470)
  • NavController geri yüklendikten sonra geçişler kullanılarak iç içe yerleştirilmiş bir hedef açıldığında NavController artık kilitlenmeyecek. (I0f7c9, b/205021623)
  • Geçersiz bir startDestination kullanılırken hata mesajı, varsa başlangıç hedefinin rotasını varsayılan olarak gösterecek. (I86b9d, b/208041894)

Navigation Compose'daki hata düzeltmeleri

  • Alt gezinme menüsü öğeleri kullanılarak başlangıç hedefi ile başka bir hedef arasında hızlı geçiş yapıldığında ortaya çıkabilecek kilitlenme sorunu düzeltildi. (Ic8976, b/208887901)
  • Yapılandırma değişikliklerinden veya işlemin sonlandırılmasından sonra iletişim kutusu hedefleri artık ekranın üst kısmında düzgün şekilde geri yükleniyor. (I4c0dc, b/207386169)
  • Bir iletişim kutusunun NavBackStackEntry öğesinden ViewModel almaya çalışıldığında iletişim kutusu kapatıldığında işlemin başarısız olmasına neden olan sorun düzeltildi. (I6b96d, b/206465487)
  • Navigation Compose'un NavHost ile activity hedefleri kullanılırken sonsuz yeniden oluşturmaya neden olan sorun düzeltildi. (I8f64c)
  • Yapılandırma değişikliği veya işlem sonlandırma sonrasında eski etkinliğin referansını tutan Navigation Compose'daki sızıntı düzeltildi. (I4efcb, b/204905432)

Safe Args ile İlgili Hata Düzeltmeleri

  • SafeArgs İşlem sonlandırıldıktan sonra özel Parcelable dizileri geri yüklenmeye çalışıldığında artık kilitlenmiyor. (I618e8, b/207315994)
  • Güvenli bağımsız değişkenlerde, boole dizilerinin null değerine sahip olmasına izin vermeyen hata düzeltildi. (I8c396, b/174787525)

Sürüm 2.4.0-beta02

3 Kasım 2021

androidx.navigation:navigation-*:2.4.0-beta02 iptal edilir. 2.4.0-beta02 sürümü şu commit'leri içerir.

API Değişiklikleri

  • Hem açık hem de örtülü derin bağlantıların işlenmesi, artık başka bir grafiğe giderken saveState işaretini otomatik olarak ekleyerek NavigationUI.setupWithNavController gibi kodların ve birden fazla geri yığın kullanan kodların beklendiği gibi çalışmasını sağlar. (Ic8807)

Davranış Değişiklikleri

  • Derin bağlantı kalıpları artık şişirme sırasında değil, NavDeepLink'te geç derleniyor. Bu, derin bağlantılar içeren gezinme grafiklerinin şişirilme süresini iyileştirmelidir. (b8d257, b/184149935)

Hata Düzeltmeleri

  • NavHost doğrudan etkinliğin setContent() öğesine eklendiğinde Lifecycle.State.STARTED öğesine geçiş yapıldıktan sonra NavBackStackEntries öğelerinin Lifecycle.State.CREATED öğesine gönderilmesi sorunu düzeltildi. (Ia5ac1, b/203536683)
  • İletişim kutusu gerçekten gösterilmeden önce DialogFragment hedefinin arka yığından çıkarılmasının iletişim kutusunu kapatmaması ve kullanıcının hatalı iletişim kutusunu manuel olarak kapatması durumunda kilitlenmeye neden olmasıyla ilgili yarış durumu düzeltildi. (I687e5)
  • NavigationUI üzerindeki onNavDestinationSelected API'sinin, söz konusu gezinme grafiğine navigate() yapmamış olsanız bile true döndürmesine neden olan sorun düzeltildi. Artık yalnızca hedefle ilişkili MenuItem öğesini seçmek için setupWithNavController tarafından dahili olarak kullanılan mantığın aynısı kullanılıyor. Bu işlem, hedefin hierarchy kullanılarak yapılıyor. (I2b053)

Sürüm 2.4.0-beta01

27 Ekim 2021

androidx.navigation:navigation-*:2.4.0-beta01 iptal edilir. 2.4.0-beta01 sürümü şu commit'leri içerir.

Yeni Özellikler

  • Artık by navGraphViewModel öğesini, kimlik kullanmaya alternatif olarak bir rotayla birlikte kullanarak Navigation Kotlin DSL'nin Fragment'lerle kullanımını daha iyi destekleyebilirsiniz. (I901e3, b/201446416)

API Değişiklikleri

  • visibleEntries API artık deneyseldir. (I93f6f)

Hata Düzeltmeleri

  • Aynı ekranlar arasında ileri geri gezinme nedeniyle geçişler kesintiye uğradığında ViewModels artık yok edilmeyecek (Id52d8, b/200817333)
  • Derin bağlantılar NavDestination'lere eklenirken artık boş değer atanabilir NavDeepLink bağımsız değişkenleri için varsayılan değer gerekmiyor. (I5aad4, b/201320030)
  • Artık farklı yaşam döngülerine sahip NavBackStackEntries eşit kabul edilmiyor. Bu, NavHost'un singleTop ile gezinme yaparken ve alt menü öğelerini yeniden seçerken tüm hedefleri düzgün şekilde yeniden oluşturacağı anlamına gelir. (I1b351, b/196997433)
  • AbstractListDetailFragment ile ilgili bir sorun düzeltildi. Bu sorun, onCreateListPaneView() tarafından döndürülen liste bölmesindeki layout_width ve layout_weight özelliklerinin yanlış işlenmesine veya yoksayılmasına neden oluyordu. (f5fbf3)
  • İletişim kutusu hedeflerinin görsel durumu artık DialogFragmentNavigator'nın durumuyla doğru şekilde senkronize ediliyor. Bu, dismiss() API'nin DialogFragment için eşzamansız olarak manuel şekilde çağrılmasının, artık kapatılan iletişim kutusunun üzerindeki tüm iletişim kutusu hedeflerini düzgün şekilde temizlediği anlamına gelir. Bu durum, iletişim kutunuzu kapatmak için popUpTo veya popBackStack() kullandığınız durumları etkilemez. (I77ba2)
  • AbstractAppBarOnDestinationChangedListener artık onDestinationChanged() için daha net hata mesajları gösteriyor. (Ie742d)

Sürüm 2.4.0-alpha10

29 Eylül 2021

androidx.navigation:navigation-*:2.4.0-alpha10 iptal edilir. 2.4.0-alpha10 sürümü şu commit'leri içerir.

Yeni Özellikler

  • NavController artık visibleEntries StateFlow (Ia964e) aracılığıyla tüm görünür NavBackStackEntry örneklerinin listesini alma olanağı sunuyor.
  • rememberNavController() artık isteğe bağlı Navigator örnekleri alıyor. Bu örnekler, Refakatçi Gezinme Materyali gibi isteğe bağlı gezinme araçlarını daha iyi desteklemek için döndürülen NavController öğesine eklenecek. (I4619e)

Hata Düzeltmeleri

  • Etkinlik yeniden oluşturulduğunda dinamik gezinme artık kilitlenmeyecek. (Ifa6a3, b/197942869)
  • Yalnızca NavHost içeren bir composable hedefe geri döndükten sonra oluşan sistem geri düğmesiyle ilgili sorun düzeltildi. (3ed148, b/195668143)
  • SafeArgs artık fromBundle() ve fromSavedStateHandle() için bağımsız değişkenleri doğru parametre sırasıyla oluşturuyor. (I824a8, b/200059831)

Sürüm 2.4.0-alpha09

15 Eylül 2021

androidx.navigation:navigation-*:2.4.0-alpha09 iptal edilir. 2.4.0-alpha09 sürümü şu commit'leri içerir.

Yeni Özellikler

  • Artık clearBackStack() yöntemini kullanarak popBackStack() veya popUpToSaveState ile kaydedilen durumları temizleyebilirsiniz. (I80a0f)
  • Artık iç içe yerleştirilmiş gezinme grafiğinizin oluşturucusuna bir bağımsız değişken listesi ve/veya derin bağlantılar iletebilirsiniz. Bunlar, sonuçta elde edilen grafiğe otomatik olarak eklenir. (I8a470, b/182545357)

API Değişiklikleri

  • navArgument Kotlin DSL işlevi artık navigation-compose yerine navigation-common'in bir parçasıdır. Bu işlevi kullanmaya devam etmek için içe aktarma işlemlerini güncellemeniz gerekir. (I1d095)

Davranış Değişiklikleri

  • Güvenli Argümanlar, artık argüman oluştururken varsayılan değerleri olmayan parametreleri varsayılan değerleri olan parametrelerden önce yerleştiriyor. (I89709, b/198493585)

Hata Düzeltmeleri

  • Navigation Compose kullanılırken NavGraph'lar yalnızca tüm alt öğeleri DESTROYED olduğunda DESTROYED olur. (I86552, b/198741720)
  • Boş değer atanabilir NavDeepLink bağımsız değişkenleri artık varsayılan değer gerektirmiyor. (Ia14ef, b/198689811)
  • Yeni bir grafikle setGraph() işlevini çağırmak, artık geri yığını açma davranışına ek olarak kaydedilmiş geri yığınları da temizleyecek. (I97f96)
  • launchSingleTop kullanılırken OnDestinationChangedListener örneklerinin ve currentBackStackEntryFlow öğesinin bildirim almama sorunu düzeltildi. (Iaaebc)

Bağımlılık Güncellemeleri

Sürüm 2.4.0-alpha08

1 Eylül 2021

androidx.navigation:navigation-*:2.4.0-alpha08 iptal edilir. 2.4.0-alpha08 sürümü şu commit'leri içerir.

Yeni Özellikler

  • Artık NavType sınıfını genişleterek özel NavType'lar oluşturabilirsiniz. Özel türler yalnızca gezinme grafiğinizi programatik olarak oluştururken (ör. Navigation Graph Kotlin DSL aracılığıyla) desteklenir. (I78440, b/196871885)

Davranış Değişiklikleri

  • Kotlin kodu, Safe Args'tan oluşturulan işlemleri oluştururken artık varsayılan değerleri olmayan bağımsız değişkenleri, parametre olarak varsayılan değerleri olan bağımsız değişkenlerin önüne yerleştiriyor. (Idb697, b/188855904)
  • Derin bağlantılar artık gerekli tüm bağımsız değişkenlerin (varsayılan değerleri olmayanlar) Uri içinde bulunduğunu doğruluyor. (#204, b/185527157)

Hata Düzeltmeleri

  • getBackStackEntry ve previousBackStackEntry'nin remember() ile birlikte composable() içinde kullanılması artık arka yığında hedef olmaması nedeniyle istisna oluşturmayacak. (I75138, b/194313238)
  • Navigation Compose, geri yığın bağımsız değişkenleri değiştirilirken ve launchSingleTop=true kullanılırken artık düzgün şekilde yeniden oluşturuluyor. (Iebd69, b/186392337)
  • 13 veya 29 hedef içeren bir grafikle setGraph aranırken artık ArrayIndexOutOfBoundsException olmayacak. (I1a9f1, b/195171984)
  • SafeArgs Java oluşturucu, Args sınıfları oluşturulurken artık lint uyarılarına neden olmamalıdır. (I1a666, b/185843837)

Harici Katkı (External Contribution)

  • ospixd, derin bağlantıların, gerekli tüm bağımsız değişkenlerin (varsayılan değerleri olmayanlar) Uri içinde bulunduğunu doğrulamasını sağladığı için teşekkür ederiz. (#204, b/185527157)

Sürüm 2.4.0-alpha07

18 Ağustos 2021

androidx.navigation:navigation-*:2.4.0-alpha07 iptal edilir. 2.4.0-alpha07 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Navigation Compose artık yapılandırma değişikliklerinden sonra ve birden fazla geri yığın özelliği kullanılırken grafikler değiştirildiğinde durumu düzgün şekilde kaydediyor. (If5a3d, b/195141957)
  • Gezinme Compose'u birden fazla geri yığınıyla kullanırken aynı sekmeyi yeniden seçtiğinizde artık boş ekranla karşılaşmayacaksınız. (I860dc, b/194925622)
  • NavHost artık NavBackStackEntry'lerin Lifecycle.State değişikliklerini gözlemliyor. Bu da bir parçada NavHost kullanmanın artık boş bir ekranla sonuçlanmak yerine yaşam döngüsü değiştikçe düzgün şekilde yeniden oluşturulacağı anlamına geliyor. (I4eb85, b/195864489)
  • Bir DialogFragment kapatıldığında, etkinliğiniz yeniden oluşturulduktan sonra (ör. yapılandırma değişikliğinden sonra) NavController durumunun doğru şekilde güncellenmemesine neden olan sorun düzeltildi. (Icd72b)
  • Bir iletişim kutusu hedefinin açılmasının NavController'ın sistem geri düğmesi işleme özelliğini güncellememesine neden olan sorun düzeltildi. Bu durum, NavController'ın açılacak bir geri yığını olmamasına rağmen geri düğmesini engellemesine neden olabiliyordu. (If3b34)
  • Safe-args artık toSavedStateHandle yöntemini otomatik olarak oluşturuyor. Bu yöntem, ViewModel kodunuzu test etmek için kullanılabilir. (If1e2d, b/193353880)

Sürüm 2.4.0-alpha06

4 Ağustos 2021

androidx.navigation:navigation-*:2.4.0-alpha06 iptal edilir. 2.4.0-alpha06 sürümü şu commit'leri içerir.

API Değişiklikleri

  • AbstractListDetailFragment üzerindeki requireSlidingPaneLayout() ve requireDetailPaneNavHostFragment() yöntemleri sırasıyla getSlidingPaneLayout() ve getDetailPaneNavHostFragment() olarak yeniden adlandırıldı. (I34a08)

Davranış Değişiklikleri

  • Animasyonlarla (ör. Crossfade) gezinirken yeni hedefteki Lifecycle, animasyon tamamlandığında artık yalnızca RESUMED'ye ulaşacak. (If0543, b/172112072, b/194301889)
  • Navigation Compose'daki NavHost artık grafiği ilk kompozisyonun bir parçası olarak ayarlıyor. (Ieb7be)

Hata Düzeltmeleri

  • Gezinme grafiğinin son hedefinin çıkarılması artık ClassCastException oluşturmuyor. (If0543, b/172112072, b/194301889)
  • NullPointerException olmadan derin bağlantı eklenip bir rota veya derin bağlantı üzerinden gezinildiğinde oluşan NullPointerException düzeltildi.Uri (938a0c, b/193805425)
  • Navigation Compose'da, derin bağlantılı NavBackStackEntry öğesinin RESUMED durumuna ulaşmamasına neden olan sorun düzeltildi. (I192c5)
  • Bir iletişim kutusu hedefinin açılmasının NavController'ın sistem geri düğmesi işleme özelliğini güncellememesine neden olan sorun düzeltildi. Bu durum, NavController'ın açılacak bir geri yığını olmamasına rağmen geri düğmesini engellemesine neden olabiliyordu. (aosp/1782668)

Sürüm 2.4.0-alpha05

21 Temmuz 2021

androidx.navigation:navigation-*:2.4.0-alpha05 iptal edilir. 2.4.0-alpha05 sürümü şu commit'leri içerir.

Davranış Değişiklikleri

  • Navigation Compose'un NavHost özelliği, artık hedefler arasında gezinirken her zaman çapraz geçiş kullanıyor. (I07049, b/172112072)
  • Artık bir NavHost'un grafiğinde değişiklik yapabilirsiniz. Aynı startDestination'a sahip ve grafikteki hedefleri aynı olan grafikler eşit kabul edilir ve NavController geri yığını temizlenmez. (I0b8db, b/175392262)

Hata Düzeltmeleri

  • NoSuchElementException düzeltildi. popBackStack(), LifecycleObserver içinden NavBackStackEntry'a bağlıyken arandığında, NavController'ın durumunda yeniden girişli güncellemeler nedeniyle NoSuchElementException oluşuyordu. (I64621)
  • AbstractListDetailFragment artık AbstractListDetailFragment kullanılmadığında APK'nızdan tamamen kaldırılmasına olanak tanıyor.SlidingPaneLayout (I611ad)
  • NavGraph ve NavDestination artık equals yöntemini geçersiz kılıyor. Bu nedenle, aynı değerlere sahip iki nesne eşit kabul ediliyor. (I166eb, b/175392262)

Sürüm 2.4.0-alpha04

1 Temmuz 2021

androidx.navigation:navigation-*:2.4.0-alpha04 iptal edilir. 2.4.0-alpha04 sürümü şu commit'leri içerir.

Yeni Özellikler

  • navigation-fragment yapısı artık yeni AbstractListDetailFragment aracılığıyla iki panelli düzenin önceden oluşturulmuş bir uygulamasını içeriyor. Bu parça, örnek uygulamamızda görüldüğü gibi, bir liste bölmesini (alt sınıfınız tarafından sağlanır) ve bir ayrıntı bölmesini yönetmek için SlidingPaneLayout kullanır. Ayrıntı bölmesi, uygulama olarak NavHostFragment kullanır. (Iac4be, b/191276636)
  • navigation-compose yapay nesnesinin NavHost özelliği, artık composable hedeflerine ek olarak dialog hedefi de destekliyor. Bu iletişim kutusu hedeflerinin her biri, mevcut composable hedefinin üzerinde kayan bir Composable Dialog içinde gösterilir. (I011d0)
val navController = rememberNavController()
    Scaffold { innerPadding ->
        NavHost(navController, "home", Modifier.padding(innerPadding)) {
            composable("home") {
                // This content fills the area provided to the NavHost
                HomeScreen()
            }
            dialog("detail_dialog") {
                // This content will be automatically added to a Dialog() composable
                // and appear above the HomeScreen or other composable destinations
                DetailDialogContent()
            }
        }
    }

API Değişiklikleri

  • NavigatorState içindeki add işlevi, push olarak yeniden adlandırıldı. add() için yapılan tüm mevcut çağrıların push() olarak değiştirilmesi gerekir. (Ie89fc, b/172112072)
  • Özel Navigator örnekleri artık NavigatorState üzerinde pushWithTransaction ve popWithTransition API'lerini kullanarak bir hedefi eşzamansız olarak gönderebilir veya açabilir. Bu API'lerin henüz dahil edilen gezinme sistemlerinden herhangi biri tarafından kullanılmadığını unutmayın. (Ic4d7c, b/172112072)

Davranış Değişiklikleri

  • NavDeepLinkBuilder artık PendingIntent PendingIntent.FLAG_IMMUTABLE ekliyor. Bu sayede createPendingIntent() tarafından döndürülen PendingIntent, Android 12 hedeflenirken bu API'nin beklendiği gibi çalışmasını sağlıyor. (If8c52)

Hata Düzeltmeleri

  • <include-dynamic> ile ilgili bir sorun düzeltildi. Bu sorunda, grafiğe iletilen bağımsız değişkenler, dinamik olarak dahil edilen grafiğe doğru şekilde iletilmiyordu. (I3e115)
  • @null varsayılan değerine sahip bir string[] bağımsız değişkeniyle bir hedefe giderken NullPointerException sorunu düzeltildi. (I1fbe8)
  • @Navigator.Name için ProGuard kuralları ekleyerek R8 3.1 tam modu kullanılırken ortaya çıkan sorunları düzeltin. (I2add9, b/191654433)
  • SafeArgs, uygulamanızı Kotlin sürümünden önceki 1.5.0 sürümlerle oluştururken artık başarısız olmayacak. (Icd1ff, b/190739257)

Sürüm 2.4.0-alpha03

16 Haziran 2021

androidx.navigation:navigation-*:2.4.0-alpha03 iptal edilir. 2.4.0-alpha03 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Dahil edilen bir dinamik grafiğe gitmek için iki navigate() çağrısı yapılması gereken sorun düzeltildi. (I7785c, b/188859835)
  • Gezinme 2.4.0-alpha01 bölümünde ortaya çıkan bir gerileme düzeltildi. Bu gerileme nedeniyle setupActionBarWithNavController(), üst düzey bir hedefteyken Yukarı simgesini düzgün şekilde kaldırmıyordu. (I5d443, b/189868637)
  • Daha önce NavController'ın kök grafiği açıldıktan sonra IllegalStateException popBackStack() çağrılırken oluşan sorun düzeltildi. (I2a330, b/190265699)
  • by navArgs() için ProGuard kuralları artık navigation-common veya ona bağlı tüm yapılar kullanılırken düzgün şekilde uygulanıyor. (I68800, b/190082521)
  • Bir geri çağırma aldığında ilk kez navigate()'i çağıran OnDestinationChangedListener artık gittiği hedefle birlikte ikinci bir geri çağırma alıyor. (Ie5f9e, b/190228815)
  • Safe Args, dinamik özellik modülleri ve AGP 7.0+ ile kullanıldığında artık kilitlenmiyor. (I69518, b/189966576)

Bilinen Sorun

  • Safe Args, Kotlin'in eski bir sürümüne bağımlı olduğundan Gradle 6.7.0 kullanılırken Unable to find method ‘’java.lang.String kotlin.text.CarsKt.titleCase(char, java.util.Locale)’’ hatasıyla başarısız olur. Bu sorun, Gradle 7.0'a güncellenerek çözülebilir. (b/190739257)

Sürüm 2.4.0-alpha02

2 Haziran 2021

androidx.navigation:navigation-*:2.4.0-alpha02 iptal edilir. 2.4.0-alpha02 sürümü şu commit'leri içerir.

Yeni Özellikler

  • Artık Activity, Fragment ve Dialog hedefleri ile DynamicNavigation Kotlin DSL'de rotalar destekleniyor. (Ib5544, Ia617b, I22f96, b/188914648, b/188901565)
  • NavigationUI, durumunuzun kaydedilmesini devre dışı bırakmanıza olanak tanıyan deneysel API'leri geçici olarak ekledi. Durumu her zaman kaydetmek doğru davranış olsa da durumu kaydederken desteklenemeyen, kullanımdan kaldırılmış kitaplıkların (ör.tutulan parçalar) kullanımları vardır. Bu nedenle, uygulamalara desteklenmeyen API'lerden yavaş yavaş geçme fırsatı verilir. (Idf93c)

  • Navigation artık özel NavigationUI'nin uygulanmasına yardımcı olmak için kullanılabilecek findDestination() ve getHierarchy() API'leri sunuyor. findDestination(), grafikte bir hedefi bulan NavGraph üzerindeki bir uzantı işlevidir. getHierarchy(), belirli bir hedefin başka bir hedefin hiyerarşisinde olup olmadığını doğrulamak için kullanılabilen bir NavDestination işlevidir.(I2932f, b/188183365)

    val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }

  • BottomNavigationView alanını kullanan NavigationUI yöntemleri, bunun yerine Material 1.4.0, NavigationBarView'de kullanıma sunulan üst sınıfını kullanacak şekilde güncellendi. Bu sayede, bu yöntemler NavigationRailView ile kullanılabilir. (Ib0b36, b/182938895)

  • Bir <action> öğesi XML üzerinden genişletilirken animasyon özellikleri, app:enterAnim="?attr/transitionEnter" söz dizimi kullanılarak temanızdan çekilen özellikleri kullanabilir. (I07bc1, b/178291654)

API Değişiklikleri

  • Kimlik kullanan Kotlin DSL oluşturucularının desteği sonlandırıldı ve rotaları kullanan oluşturucularla değiştirilmesi gerekiyor (I85b42, b/188816479) (I9f58f, b/188816479)

Hata Düzeltmeleri

  • DialogFragmentNavigator artık NavController'ı bilgilendirmek için NavigatorState.pop() API'sini kullanıyor. Bu API, sistemin geri düğmesine basılarak veya iletişim kutusunun dışına tıklanarak kapatıldığında NavController durumunun her zaman Navigator'ın durumuyla senkronize olmasını sağlıyor. (I2ead9)

  • Gezinme, onDestinationChanged geri çağırma işleviyle OnDestinationChangedListeners listesi değiştirilirken artık ConcurrentModificationException vermiyor. (Ib1707, b/188860458)

  • Safe Args, Kotlin'de yön özellikleri oluşturulmaya çalışılırken artık kilitlenmiyor. (Id2416, b/188564435)

  • NavDestination'daki setId yöntemi artık @IdRes ile düzgün şekilde açıklama eklenmiş olduğundan yalnızca kaynak kimliklerini kabul eder. (I69b80)

  • findNode parametresinin int parametresi artık resid yerine resId. (I7711d)

Bağımlılık Güncellemesi

  • Safe-Args artık Android Gradle Eklentisi 4.2.0'a bağlıdır. Bu durumda artık applicationIdTextResource kullanma uyarısını almazsınız. (I6d67b, b/172824579)

Sürüm 2.4.0-alpha01

18 Mayıs 2021

androidx.navigation:navigation-*:2.4.0-alpha01 iptal edilir. 2.4.0-alpha01 sürümü şu commit'leri içerir.

Yeni Özellikler

  • NavController üzerindeki currentBackStackEntryAsFlow() yöntemi, mevcut NavBackStackEntry her değiştiğinde yayın yapan bir Flow sağlar. Bu akış, OnDestinationChangedListener'nın manuel olarak yönetilmesine alternatif olarak kullanılabilir. (I19c4a, #89, b/163947280)

Birden fazla geri yığın

NavController, hedeflerin eski yığınını yönetmekten, navigate() ile hedeflere gittiğinizde hedefleri eski yığına eklemekten ve popBackStack() işlevini çağırdığınızda veya sistemin geri düğmesini tetiklediğinizde hedefleri kaldırmaktan sorumludur. Mevcut NavOptions sınıfı ve gezinme grafiği XML'sindeki <action> girişlerine entegrasyon, geri yığını kaydetme ve geri yükleme işlemlerini destekleyecek şekilde genişletildi. (b/80029773)

Bu değişiklik kapsamında, NavigationUI yöntemleri onNavDestinationSelected(), BottomNavigationView.setupWithNavController() ve NavigationView.setupWithNavController() artık açılan hedeflerin durumunu otomatik olarak kaydedip geri yükleyerek kodda herhangi bir değişiklik yapmadan birden fazla geri yığınını desteklemeyi mümkün kılıyor. Navigation with Fragments kullanılırken birden fazla geri yığınıyla entegrasyon için bu yöntem önerilir. (Ie07ca)

Durumu kaydetme ve geri yükleme için temel alınan API'ler çeşitli yüzeyler aracılığıyla kullanıma sunulur:

  • Navigasyon XML'sinde artık <action> öğesi, app:popUpToSaveState ve app:restoreState boolean özelliklerini kullanarak app:popUpTo aracılığıyla açılan tüm hedeflerin durumunu kaydedebilir ve app:destination olarak iletilen hedefle ilişkili durumu geri yükleyebilir:

    <action
  android:id=”@+id/swap_stack”
  app:destination=”@id/second_stack”
  app:restoreState=”true”
  app:popUpTo=”@id/first_stack_start_destination”
  app:popUpToSaveState=”true” />

  • navOptions Kotlin DSL'de, popUpTo oluşturucusuna restoreState boole özelliğini ve saveState boole özelliğini ekleyebilirsiniz:

    // Use the navigate() method that takes a navOptions DSL Builder
navController.navigate(selectedBottomNavRoute) {
  launchSingleTop = true
  restoreState = true
  popUpTo(navController.graph.startDestinationId) {
    saveState = true
  }
}

  • NavOptions.Builder aracılığıyla manuel olarak bir NavOptions nesnesi oluştururken ek bir saveState parametresi alan setPopUpTo() için setRestoreState() ve yeni aşırı yüklemeyi kullanabilirsiniz.

    NavOptions navOptions = new NavOptions.Builder()
  .setLaunchSingleTop(true)
  .setRestoreState(true)
  .setPopUpTo(navController.getGraph().getStartDestinationId(),
    false, // inclusive
    true) // saveState
  .build();
navController.navigate(selectedBottomNavId, null, navOptions);

  • popBackStack() için yapılan programatik çağrılar artık ek bir saveState parametresi içerebilir.

Her durumda, NavController, kapsamı belirlenmiş ViewModel örnekleri de dahil olmak üzere her bir NavBackStackEntry'nin durumunu kaydeder ve geri yükler. Navigator API'leri, her Navigator'nin kendi durumunu kaydetmesini ve geri yüklemesini destekleyecek şekilde güncellendi.

Navigation Compose'da composable hedefleri için kullanılan ComposeNavigator, Navigation with Fragments'da <fragment> hedefleri için kullanılan FragmentNavigator ve DynamicFragmentNavigator, yeni Navigator API'lerini kullanacak ve durumu kaydetme ile geri yüklemeyi destekleyecek şekilde güncellendi.

Gezinme Rotaları

Rota, bir hedefi benzersiz şekilde tanımlayan bir String. Daha önce yalnızca Navigation Compose'da kullanılan bu kavram, artık temel Navigation API'lerinin bir parçası haline geldi. Bu, Navigation Kotlin DSL aracılığıyla grafiğinizi oluştururken tam sayı kimlikleri kullanmaya alternatif bir yöntem sunar. (b/172823546)

Daha önce yalnızca kimlik alan tüm API'ler artık rota alan bir aşırı yüklemeye sahip String. Bu kategoriye navigate(), popBackStack(), popUpTo() ve getBackStackEntry() dahildir.

Bu durumun API ile ilgili bazı sonuçları oldu:

  • Kotlin DSL'deki popUpTo kotlin özelliğinin desteği sonlandırıldı. Bunun yerine popUpToId kullanılabilir. (I59c73, b/172823546)
  • getStartDestination() API'si, getStartDestinationId() lehine kullanımdan kaldırıldı. (I0887f, b/172823546)

Navigation Compose'un önceki sürümlerinden Navigation Compose 2.4.0-alpha01'a yükselten geliştiriciler için bu, uzantı yöntemlerindeki aşağıdaki içe aktarmaların artık gerekli olmadığı ve kaldırılması gerektiği anlamına gelir:

import androidx.navigation.compose.navigation
import androidx.navigation.compose.createGraph
import androidx.navigation.compose.getBackStackEntry
import androidx.navigation.compose.navigate
import androidx.navigation.compose.popUpTo

KEY_ROUTE bağımsız değişkeninin yerini NavDestination üzerinde route özelliği aldı. Bu sayede navBackStackEntry.destination.route'ü doğrudan arayabilirsiniz.

API Değişiklikleri

  • Tüm Navigation yapıları Kotlin ile yeniden yazıldı. Bu, genel öğeler kullanan sınıfların (ör. NavType alt sınıfları) boş değer atanabilirliğini iyileştirdi. Eskiden -ktx yapılarının parçası olan tüm Kotlin uzantı işlevleri, ilgili ana yapılara taşındı. -ktx yapıları yayınlanmaya devam eder ancak tamamen boştur. (b/184292145)
  • NavDeepLinkBuilder artık oluşturulan geri yığına birden fazla farklı hedef eklemeyi destekliyor. (I3ee0d, b/147913689)
  • DynamicNavHostFragment için fabrika işlevleri ekleme (Icd515, b/175222619)
  • NavBackStackEntry benzersiz kimliği artık herkese açık API'sinin bir parçası olarak kullanıma sunuluyor. (Ie033a)
  • name ve argument alanları ile NamedNavArgument'nin yapı bozma işlevleri artık herkese açık. (#174, b/181320559)
  • İlgili beste yerellerine NavBackStackEntry sağlayan yeni bir NavBackStackEntry#provideToCompositionLocals uzantısı kullanıma sunuldu. (#175, b/187229439)

Safe Args

  • Safe Args artık her NavArgs sınıfı için bir fromSavedStateHandle() yöntemi oluşturuyor. (#122, b/136967621)

    class HomeViewModel(savedStateHandle: SavedStateHandle) : ViewModel() {
  // Create a HomeDestinationArgs class with type safe accessors for each argument
  // defined on your destination
  private val args = HomeDestinationArgs.fromSavedStateHandle(savedStateHandle)
}

  • Safe Args, KotlinPoet'e 1.8.0 bağlı olacak şekilde güncellendi. (#172, b/183990444)

Davranış Değişiklikleri

  • Navigasyon artık Lifecycle 2.3.1'a bağlıdır. Ayrıca setGraph(), popBackStack(), navigateUp() ve navigate() yöntemleri artık NavBackStackEntry Lifecycle'ı @MainThread olarak günceller. Bu sayede Navigasyon, Lifecycle 2.3.0'da kullanıma sunulan ana iş parçacığı zorunluluğuyla uyumlu hale gelir. (b/171125856)
  • Derin bağlantılardan Enum bağımsız değişkenlerinin ayrıştırılması artık büyük/küçük harfe duyarlı değildir. Bu sayede, enum'ın değeri RED olsa bile http://www.example.com/red gibi bir derin bağlantı, www.example.com/{color} derin bağlantısıyla eşleşebilir. (#152, b/135857840)

Oluşturma Uyumluluğu

  • androidx.navigation:navigation-compose:2.4.0-alpha01 yalnızca Compose'un 1.0.0-beta07 ve sonraki sürümleriyle uyumludur.

Hata Düzeltmeleri

  • Sondaki bağımsız değişken yer tutucularının, tam olarak eşleşen bir soneke sahip derin bağlantılardan öncelikli olmasına neden olan sorun düzeltildi. (#153, b/184072811)
  • NavHostFragment artık varsayılan DialogFragmentNavigator ile aynı @Navigator.Name("dialog") öğesini kullanan özel Navigatörleri destekliyor. (Ib1c2c, b/175979140)
  • Aynı örnekle tekrar tekrar çağrılmasının sorunlara neden olmaması için NavigatorProvider#addNavigator işlevi iyileştirildi. (#176, b/187443146)

Harici Katkılar

  • NavArgs sınıfı için fromSavedStateHandle() yöntemi oluşturarak Safe Args desteği geliştirdiği için simonschiller'a teşekkür ederiz. (#122, b/136967621)
  • Derin bağlantılardan Enum bağımsız değişkenlerinin ayrıştırılmasını büyük/küçük harfe duyarsız hale getirdiği için Bradleycorn'a teşekkür ederiz. (#152, b/135857840)
  • Sondaki bağımsız değişken yer tutucularının, tam olarak eşleşen bir soneke sahip derin bağlantılardan öncelikli olmasına neden olan sorunu düzelttiği için osipxd'ye teşekkür ederiz. (#153, b/184072811)
  • Safe Args'ın KotlinPoet 1.8.0'e bağlı olacak şekilde güncellenmesi için tatocaster'a teşekkür ederiz. (#172, b/183990444)
  • name ve argument alanlarını ve NamedNavArgument'in yapı bozma işlevlerini herkese açık hale getirdiği için jossiwolf'a teşekkür ederiz. (#174, b/181320559)
  • NavBackStackEntry'ı ilgili beste yerellerine sağlayan yeni bir NavBackStackEntry#provideToCompositionLocals uzantısı tanıttığı için jossiwolf'a teşekkür ederiz. (#175, b/187229439)
  • NavigatorProvider#addNavigator davranışını iyileştirerek aynı örnekle tekrar tekrar çağrılmasının sorunlara neden olmamasını sağlayan jossiwolf'a teşekkür ederiz. (#176, b/187443146)

Sürüm 1.0.0-alpha10

7 Nisan 2021

androidx.navigation:navigation-compose:1.0.0-alpha10 iptal edilir. 1.0.0-alpha10 sürümü şu commit'leri içerir.

API Değişiklikleri

  • NavHost artık hedef composable'ları sarmalayan composable kapsayıcıya aktarılan bir Modifier kabul ediyor. (I85aca, b/175125483)

Hata Düzeltmeleri

  • NavHost artık OnBackPressedDispatcherOwner bulunmadığında bile çalışıyor. Bu durum, NavHost önizlenirken geçerlidir. (I7d8b4)
  • Navigation Compose artık Navigation 2.3.5'a bağlıdır. Bu sayede, BackHandler öğesi NavHost hedefinde kullanıldığında yaşanan sorun düzeltilir. (I7e63b, b/182284739)

Sürüm 1.0.0-alpha09

10 Mart 2021

androidx.navigation:navigation-compose:1.0.0-alpha09 iptal edilir. 1.0.0-alpha09 sürümü şu commit'leri içerir.

API Değişiklikleri

  • LocalViewModelStoreOwner.current artık, ViewModelStoreOwner öğesinin mevcut kompozisyonda kullanılabilir olup olmadığını daha iyi belirlemek için boş değer atanabilir bir ViewModelStoreOwner döndürüyor. ViewModelStoreOwner gerektiren API'ler (ör. viewModel() ve NavHost) ViewModelStoreOwner ayarlanmamışsa yine de istisna oluşturur. (Idf39a)

Hata Düzeltmeleri

  • Navigation Compose artık Navigation 2.3.4'e bağlıdır. Bu sürümde, grafik ayarlandıktan sonra aynı ViewModelStore nesnesini ayarlamaya çalışmayla ilgili düzeltme yer alır. (I65c24, b/177825470)

Sürüm 1.0.0-alpha08

24 Şubat 2021

androidx.navigation:navigation-compose:1.0.0-alpha08 iptal edilir. 1.0.0-alpha08 sürümü şu commit'leri içerir.

Yeni Özellikler

  • NavHost artık LocalSavedStateRegistryOwner CompositionLocal'ı bu hedefin NavBackStackEntry ile dolduruyor. Böylece, doğrudan SavedStateRegistry'e kaydedilen tüm durumlar, hedefle birlikte kaydedilip geri yüklenebiliyor. (I435d7, b/179469431)

Sürüm 1.0.0-alpha07

10 Şubat 2021

androidx.navigation:navigation-compose:1.0.0-alpha07 iptal edilir. 1.0.0-alpha07 sürümü şu commit'leri içerir.

Bağımlılık Güncellemeleri

Sürüm 1.0.0-alpha06

28 Ocak 2021

androidx.navigation:navigation-compose:1.0.0-alpha06 iptal edilir. 1.0.0-alpha06 sürümü şu commit'leri içerir.

API Değişiklikleri

  • NavController üzerinde, ilişkili NavBackStackEntry değerini döndüren bir getBackStackEntry(route: String) uzantı yöntemi eklendi. (If8931)

Sürüm 1.0.0-alpha05

13 Ocak 2021

androidx.navigation:navigation-compose:1.0.0-alpha05 iptal edilir. 1.0.0-alpha05 sürümü şu commit'leri içerir.

Compose 1.0.0-alpha10'a bağlı olacak şekilde güncellendi.

Sürüm 1.0.0-alpha04

16 Aralık 2020

androidx.navigation:navigation-compose:1.0.0-alpha04 iptal edilir. 1.0.0-alpha04 sürümü şu commit'leri içerir.

  • Compose 1.0.0-alpha09 ile uyumluluk için güncellendi.

Sürüm 1.0.0-alpha03

2 Aralık 2020

androidx.navigation:navigation-compose:1.0.0-alpha03 iptal edilir. 1.0.0-alpha03 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Yapılandırma değişikliği veya işlem sonlandırma ve yeniden oluşturma işleminden sonra popBackStack() ve navigateUp() işlevlerinin çalışmamasına neden olan sorun düzeltildi. (Icea47, b/173281473)
  • NavHost'unuzdaki iç içe yerleştirilmiş bir grafiğe gitme işlemi artık düzgün şekilde çalışıyor. (I0948d, b/173647694)

Sürüm 1.0.0-alpha02

11 Kasım 2020

androidx.navigation:navigation-compose:1.0.0-alpha02 iptal edilir. 1.0.0-alpha02 sürümü şu commit'leri içerir.

API Değişiklikleri

  • Navigation Compose artık popUpTo ve launchSingleTop işlemlerini kullanmak için NavOptions'ı destekliyor (If96c3, b/171468994)
  • Navigation Compose DSL'de iç içe yerleştirilmiş grafikler oluşturmanıza olanak tanıyan, kimlik yerine rota alan bir gezinme işlevi eklendi. (I1661d)
  • startDestination artık NavHost için parametreler listesinde rotadan önce geliyor (Ie620e).
  • Artık rotayı NavHost composable'ın dışında bir başlangıç hedefi olarak kullanarak grafik oluşturabilirsiniz. (Iceb75)

Sürüm 1.0.0-alpha01

28 Ekim 2020

android.navigation:navigation-compose:1.0.0-alpha01 iptal edilir. 1.0.0-alpha01 sürümü şu commit'leri içerir.

Yeni Özellikler

navigation-compose yapısı, Navigation Component ile Jetpack Compose arasında entegrasyon sağlar. Uygulamanızdaki hedefler olarak @Composable işlevlerini kullanır.

Bu ilk sürümde şunlar sunulmaktadır:

  • Navigasyon grafiğinizi Kotlin DSL aracılığıyla oluşturmanıza olanak tanıyan bir NavHost composable.
  • Yaşam döngüsü, ViewModel ve hedef düzeyinde hatırlanan durumun kapsamı.
  • Sistemin geri düğmesiyle otomatik entegrasyon.
  • Bağımsız değişkenleri iletme, hedeflere derin bağlantılar ekleme ve önceki hedeflere sonuç döndürme desteği.
  • rememberNavController() ve currentBackStackEntryAsState() içinde, durum yükseltmeye izin vermek ve NavController öğesini NavHost dışındaki composable'lara (ör. alt gezinme çubuğu) bağlamak için belirli yardımcılar oluşturun.

Daha fazla bilgi için Compose Navigation kılavuzuna bakın.

Sürüm 2.3.5

Sürüm 2.3.5

7 Nisan 2021

androidx.navigation:navigation-*:2.3.5 iptal edilir. 2.3.5 sürümü şu commit'leri içerir.

Yeni Özellikler

  • NavDeepLinkRequest veya Uri kullanarak gezinirken artık KEY_DEEP_LINK_INTENT aracılığıyla bağımsız değişkenlerden amaç alarak sonuçlanan hedefteki Uri, işlem ve MIME türüne erişebilirsiniz. Bu, harici derin bağlantı için zaten kullanılabilen işlevselliğin yansıtılmasıdır. (I975c3, b/181521877)

Hata Düzeltmeleri

  • OnBackPressedCallbacks, LifecycleOwner olarak NavBackStackEntry ile bir dağıtıcıya eklendiğinde artık Etkinlik Yaşam Döngüsü STOPPED, ardından STARTED olduğunda geri tuşuna basma işlemini düzgün şekilde engelliyor (Iff94f, b/182284739).
  • Derin bağlantı alan adı ayrıştırma artık büyük/küçük harfe duyarlı değildir. Bu sayede www.example.com hem www.example.com hem de www.Example.com ile eşleşir. Sorgu parametresi adlarının büyük/küçük harfe duyarlı olmaya devam ettiğini unutmayın. (#144, b/153829033)
  • Bir hedefte birden fazla boş değer içermeyen varsayılan bağımsız değişken olduğunda ve bu hedefe yalnızca bu bağımsız değişkenlerin bir alt kümesini geçersiz kılarken gidildiğinde oluşabilecek NullPointerException düzeltildi. (aosp/1644827)

Bağımlılık Güncellemeleri

  • Navigation Safe Args Gradle eklentisi artık Kotlin Gradle eklentisi 1.4.31'e bağlıdır. (aosp/1661058, b/181156413)

Harici Katkı (External Contribution)

  • Derin bağlantı alan adı ayrıştırmasını büyük/küçük harfe duyarsız hale getiren çekme isteği için bentrengrove teşekkür ederiz. (#144, b/153829033)

Sürüm 2.3.4

Sürüm 2.3.4

10 Mart 2021

androidx.navigation:navigation-*:2.3.4 iptal edilir. 2.3.4 sürümü şu commit'leri içerir.

Yeni Özellikler

  • ReferenceType bağımsız değişkenleri artık bir derin bağlantı URI'sinin parçası olarak gönderildiğinde düzgün şekilde ayrıştırılabiliyor. Bu, hem ham tam sayı değerini hem de 0x ile öneklenmiş onaltılık değerleri destekler. (#127, b/179166693)
  • app:argType="float" içeren bir bağımsız değişken için android:defaultValue artık tamsayı varsayılan değerlerini destekliyor. Bu sayede 0.0 kullanmak yerine android:defaultValue="0" kullanabilirsiniz. (#117, b/173766247)

Hata Düzeltmeleri

  • Navigasyon'un dinamik özellik desteğini kullanırken yükleme ilerleme durumunun takılı kalması sorununu düzeltir. (Ib27a7, b/169636207)
  • Aynı nesneyle setViewModelStore veya setLifecycleOwner'yi çağırma işlemi artık no-op olacak (Idf491, b/177825470)
  • Safe-Args artık java kullanılırken uygun yöntemlere bastırma ek açıklamaları ekliyor. (I8fbc5, b/179463137)

Harici Katkılar

  • ReferenceType bağımsız değişkenlerinin artık bir derin bağlantı URI'si kapsamında gönderildiğinde düzgün şekilde ayrıştırılabilmesini sağlayan çekme isteği için teşekkür ederiz JvmName. (#127, b/179166693)
  • app:argType=”float” ile bağımsız değişken için defaultValue'e izin veren çekme isteği için teşekkürler tatocaster. Artık varsayılan tam sayı değerleri destekleniyor. (#117, b/173766247)

Sürüm 2.3.3

Sürüm 2.3.3

27 Ocak 2021

androidx.navigation:navigation-*:2.3.3 iptal edilir. 2.3.3 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • NavBackStackEntry, Lifecycle'si CREATED'ye taşınmadan önce açıldığında artık kilitlenme yaşanmıyor. (Ie3ba3)
  • b/171364502 nedeniyle oluşan regresyon düzeltildi. Bu regresyon, 0 animasyon kaynağı değerine sahip bir etkinliğe gidildiğinde ResourceNotFoundException hatasına neden oluyordu. (I7aedb, b/176819931)

Sürüm 2.3.2

Sürüm 2.3.2

2 Aralık 2020

androidx.navigation:navigation-*:2.3.2 iptal edilir. 2.3.2 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • NavigationUI içinde, onNavDestinationSelected ile <activity> hedefinin kullanılması durumunda Etkinliğe gidilememesine neden olan gerileme düzeltildi. (I22e34, b/171364502)
  • navigation-dynamic-features-fragment simgesinin, yeni yüklenen hedefe birden fazla kez gidilmesine neden olan sorun düzeltildi. (aosp/1486056, b/169636207)
  • launchSingleTop kullanılırken varsayılan bağımsız değişkenlerin OnDestinationChangedListener örneklerine gönderilmemesine neden olan sorun düzeltildi. (I2c5cb)
  • İç içe yerleştirilmiş bir gezinme grafiğine gidildiğinde arka yığında yeni bir grafik örneği oluşturulmamasına neden olan sorun düzeltildi. (Ifc831)
  • Bir gezinme grafiğindeki son hedefi kaldıran bir popUpTo ile navigate() kullanıldığında gezinme grafiğinin hemen yok edilip arka yığından kaldırılmamasına neden olan sorun düzeltildi. (I910a3)
  • Navigation SafeArgs artık Kotlin'in açık API modunu destekleyen KotlinPoet 1.7.2 sürümünü kullanıyor. (I918b5)
  • NavHostFragment.findNavController(Fragment) artık Fragment hiyerarşisi ve Fragment'ın görünüm hiyerarşisinin mevcut kontrollerine ek olarak bir DialogFragment'ın kök dekor görünümünü de kontrol ediyor. Bu sayede, FragmentScenario ve Navigation.setViewNavController() ile gezinmeyi kullanan iletişim kutusu parçalarını test edebilirsiniz. (I69e0d)

Sürüm 2.3.1

Sürüm 2.3.1

14 Ekim 2020

androidx.navigation:navigation-*:2.3.1 iptal edilir. 2.3.1 sürümü şu commit'leri içerir.

Yeni Özellikler

  • Varsayılan Animator kaynakları Navigation UI'ya eklendi ve varsayılan animasyon kaynakları yerine kullanılması önerilir. (b/167430145)
  • NavOptions artık karma kodu ve eşittir yöntemlerini geçersiz kılıyor (b/161586466)
  • Gezinme artık "No destination with ID" IllegalArgumentException'da mevcut hedefi içeriyor. Bu, geliştiricilerin hata ayıklama deneyimini iyileştirmelidir. (b/168311416)

Hata Düzeltmeleri

  • Oluşturulan bağımsız değişken sınıfı adı 100 karakterden uzun olsa bile Safe Args artık dönüş satırını sarmalamayacak. (b/168584987)

Bağımlılık Değişiklikleri

  • navigation-ui artık DrawerLayout 1.1.1'e bağlıdır. Bu sayede NavigationUI, LOCK_MODE_LOCKED_CLOSED veya LOCK_MODE_LOCKED_OPEN kullanılırken bile çekmeceyi açabilir. (b/162253907)
  • Safe Args artık KotlinPoet 1.6.0'a (aosp/1435911) bağlıdır.
  • Safe Args artık AGP 4.0.1'e (aosp/1442337) bağlıdır.

Sürüm 2.3.0

Sürüm 2.3.0

24 Haziran 2020

androidx.navigation:navigation-*:2.3.0 iptal edilir. 2.3.0 sürümü şu commit'leri içerir.

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

  • Özellik modülü entegrasyonu: navigation-dynamic-features-runtime ve navigation-dynamic-features-fragment yapıları, özellik modüllerinde tanımlanan hedeflere gitmenize olanak tanır ve gerektiğinde özellik modüllerinin yüklenmesini otomatik olarak gerçekleştirir. Daha fazla bilgi için Özellik modülleriyle gezinme başlıklı makaleyi inceleyin.
  • Gezinme Testi: navigation-testing yapısı, mevcut hedefi ayarlamanıza ve gezinme işlemlerinden sonra eski yığını doğrulamanıza olanak tanıyan bir TestNavHostController sağlar. Daha fazla bilgi için Test Navigation (Test Gezinme) başlıklı makaleyi inceleyin.
  • Sonuç döndürme: Gezinme eski yığınındaki her hedefle ilişkili NavBackStackEntry, artık belirli bir eski yığın girişiyle ilişkilendirilmesi gereken küçük miktarlarda kaydedilmiş durumu depolamaya uygun bir SavedStateHandle'ye erişmenize olanak tanır. Daha fazla bilgi için Sonucu önceki hedefe döndürme başlıklı makaleyi inceleyin.
  • NavigationUI için Openable desteği: NavigationUI içindeki tüm DrawerLayout kullanımları, CustomView 1.1.0 içinde eklenen ve DrawerLayout 1.1.0 içinde DrawerLayout tarafından uygulanan daha genel Openable arayüzüyle değiştirildi.
  • Derin bağlantılarda işlem ve MIME türü desteği: Derin bağlantı, daha önce kullanılabilen app:uri'ye ek olarak app:action ve app:mimeType'ü destekleyecek şekilde genişletildi. NavController artık yeni NavDeepLinkRequest sınıfı aracılığıyla bu alanların herhangi bir kombinasyonuyla gezinmeyi destekliyor. Daha fazla bilgi için NavDeepLinkRequest kullanarak gezinme başlıklı makaleyi inceleyin.

Bilinen Sorunlar

  • Derin bağlantı işlemleri ve MIME türleri için destek henüz Manifest Merger'da kullanılamamaktadır. Bu çalışma tamamlanana kadar, manifest dosyanızdaki <nav-graph> öğesinden oluşturulan <intent-filter> öğeleri, <data> öğesinde MIME türünüzü veya özel <action> öğenizi içermez. Manifestinize uygun bir <intent-filter> öğesini manuel olarak eklemeniz gerekir.

Sürüm 2.3.0-rc01

10 Haziran 2020

androidx.navigation:navigation-*:2.3.0-rc01 iptal edilir. 2.3.0-rc01 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Bağımsız değişken içermeyen bir hedef örneği, bağımsız değişken içeren başka bir örnekle değiştirilirken singleTop ile ilgili NullPointerException sorunu düzeltildi. (b/158006669)
  • destination is unknown tarafından oluşturulan tüm destination is unknown istisnaları artık NavController durumunu belirlemeye yardımcı olacak ek hata ayıklama bilgilerine sahip.NavController (b/157764916)

Sürüm 2.3.0-beta01

20 Mayıs 2020

androidx.navigation:navigation-*:2.3.0-beta01 yayınlanır. 2.3.0-beta01 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • İşlem sonlandırıldıktan sonra NavBackStackEntry öğesinin Lifecycle değerinin düzgün şekilde güncellenmemesine neden olan sorun düzeltildi. (b/155218371)
  • OnDestinationChangedListener, setGraph() aranmadan önce kaydedilen örnekler artık bir işlem sonlandırıldıktan sonra geri yüklenen hedefe doğru şekilde gönderiliyor. (b/155218371)
  • singleTop kullanılırken NavBackStackEntry artık bağımsız değişkenlerini doğru şekilde güncelliyor ve güncellenen bağımsız değişkenler tüm OnDestinationChangeListener örneklerine gönderiliyor. (b/156545508)

Bağımlılık Güncellemeleri

Sürüm 2.3.0-alpha06

29 Nisan 2020

androidx.navigation:navigation-*:2.3.0-alpha06 iptal edilir. (2.3.0-alpha06 sürümü bu commit'leri içerir.)

Yeni Özellikler

  • Derin bağlantı, daha önce kullanılabilen app:uri'a ek olarak app:action ve app:mimeType'ı destekleyecek şekilde genişletildi. NavController artık yeni NavDeepLinkRequest sınıfı aracılığıyla bu alanların herhangi bir kombinasyonuyla gezinmeyi destekliyor. (b/136573074, b/135334841)

API Değişiklikleri

  • Dinamik gezinme hedefleri için Kotlin DSL desteği önemli ölçüde genişletildi. (b/148969800)

Hata Düzeltmeleri

  • İç içe yerleştirilmiş bir başlangıç hedefi kullanılırken derin bağlantı amaçlarının yoksayılmasına neden olan sorun düzeltildi. (b/154532067)

Sürüm 2.3.0-alpha05

15 Nisan 2020

androidx.navigation:navigation-*:2.3.0-alpha05 iptal edilir. 2.3.0-alpha05 sürümü şu commit'leri içerir.

Yeni Özellikler

  • <include-dynamic> kullanılarak yapılan dinamik grafik eklemelerinde artık app:graphPackage belirtmeniz gerekmez. Noktadan sonra applicationId öğesine moduleName soneki eklenerek varsayılan bir değer kullanılır. graphPackage simgenizi özelleştirmeniz gerekiyorsa artık ${applicationId} yer tutucusu desteklenmektedir. (b/152696768)
  • Navigation Graph Kotlin DSL artık işlemler için defaultArguments Map özelliğini kullanıma sunuyor. Bu özellik, Navigation XML dosyalarındaki <action> öğelerinde varsayılan değerler ayarlama özelliğini yansıtıyor. (b/150345605)

Hata Düzeltmeleri

  • Navigation 2.2.2: Etkinliğinizde birden fazla NavHostFragment örneği olduğunda grafiğinizin başlangıç hedefine derin bağlantı oluştururken oluşan IllegalStateException sorunu düzeltildi. (b/147378752)

Bağımlılık güncellemeleri

Sürüm 2.3.0-alpha04

18 Mart 2020

androidx.navigation:navigation-*:2.3.0-alpha04 iptal edilir. 2.3.0-alpha04 sürümü şu commit'leri içerir.

Yeni Özellikler

  • Navigation Kotlin DSL'de özellik modülü etkinliği ve fragment hedefleri için destek eklendi. (b/148969800)

API Değişiklikleri

  • DynamicExtras sınıfı artık oluşturucu kalıbı kullanmıyor ve doğrudan oluşturulabiliyor. (aosp/1253671)
  • DynamicActivityNavigator artık oluşturucusunda Activity yerine Context alıyor. (aosp/1250252)

Hata Düzeltmeleri

  • NavigationUI artık boş etiketleri (ör. android:label=”” içeren bir hedef) yoksaymıyor ve başlığı doğru şekilde boş bir dize olarak ayarlıyor. (b/148679860)

Bağımlılık Güncellemeleri

  • Navigasyon Dinamik Özellikler yapıları artık Play Core'a 1.6.5 bağlıdır. (b/149556401)

Sürüm 2.3.0-alpha03

4 Mart 2020

androidx.navigation:navigation-*:2.3.0-alpha03 iptal edilir. 2.3.0-alpha03 sürümü şu commit'leri içerir.

API Değişiklikleri

  • DrawerLayout sınıfına güvenmek yerine, AppBarConfiguration artık CustomView 1.1.0-alpha02'da (DrawerLayout 1.1.0-alpha04 itibarıyla uygulanan) kullanıma sunulan Openable arayüzünü kullanıyor. Bu sayede, Openable'nin özel uygulamalarını NavigationUI ile kullanabilirsiniz.DrawerLayout (b/129030452)

Hata Düzeltmeleri

  • navigation-common-ktx ProGuard kuralları artık yalnızca kullanılan NavArgs sınıflarını doğru şekilde tutuyor ve tüm NavArgs örneklerini tutmuyor. (b/150213558)

Bağımlılık değişiklikleri

  • Navigasyon, Core 1.2.0'ya olan bağımlılığını geri aldı ve artık Core 1.1.0'ya bağımlı. Bunun nedeni, Navigasyon Core 1.2.0'daki yeni API'leri kullanmadığında geliştiricileri daha yeni bir bağımlılığa geçmeye zorlamayı önlemektir.

Sürüm 2.3.0-alpha02

19 Şubat 2020

androidx.navigation:navigation-*:2.3.0-alpha02 iptal edilir. 2.3.0-alpha02 sürümü şu commit'leri içerir.

Yeni Özellikler

  • NavBackStackEntry artık belirli bir eski yığın girişiyle ilişkilendirilmesi gereken küçük miktarlarda kayıtlı durumu depolamaya uygun bir SavedStateHandle'ye erişmenize olanak tanır. Kullanım örneği için Sonuç döndürme başlıklı makaleyi inceleyin. (b/79672220)

API Değişiklikleri

  • Mevcut ve önceki hedefler için NavBackStackEntry alma işlemini kolaylaştırmak amacıyla getCurrentBackStackEntry() ve getPreviousBackStackEntry() kolaylık yöntemleri eklendi. (b/79672220)

Hata Düzeltmeleri

  • navigateUp() artık uygulamanızı kendi görev yığınınıza başlatırken mevcut hedefin bağımsız değişkenlerini ve KEY_DEEP_LINK_INTENT öğesini önceki hedefe iletiyor. (b/147456890)

Bağımlılık değişiklikleri

Sürüm 2.3.0-alpha01

5 Şubat 2020

androidx.navigation:navigation-*:2.3.0-alpha01 iptal edilir. 2.3.0-alpha01 sürümü şu commit'leri içerir.

Yeni özellikler

  • Yeni navigation-testing yapısı, TestNavHostController sınıfı sağlar. Bu sınıf, gezinmeyi test ederken sahte NavController kullanmaya alternatif bir yöntem sunar. Bu yöntem, mevcut hedefi ayarlamanıza ve gezinme işlemlerinden sonra geri yığını doğrulamanıza olanak tanır. (b/140884273)
  • Yeni navigation-dynamic-features-fragment (ve geçişli bağımlılığı olan navigation-dynamic-features-runtime), özellik modüllerinden hedefler veya gezinme grafiklerinin tamamını (<include-dynamic> aracılığıyla) dahil etmenize olanak tanır. Bu sayede, bu hedeflere gidilirken isteğe bağlı özellik modüllerinin sorunsuz bir şekilde yüklenmesini sağlar. Daha fazla bilgi için Özellik modülleriyle gezinme başlıklı makaleyi inceleyin. (b/132170186)

Hata düzeltmeleri

  • Gezinme 2.2.1: Sorgu parametreleri olmayan derin bağlantılar artık sorgu parametrelerini sondaki {argument} öğelerine eklemek veya derin bağlantıyla eşleşmemek yerine doğru şekilde yoksayıyor. (b/147447512)
  • Gezinme 2.2.1: navigation-ui DrawerArrowDrawable için ProGuard kuralları, android.enableJetifier=true'ın gerekli olmaması için güncellendi. (b/147610424)
  • Gezinme 2.2.1: navigation-common-ktx modülü artık navigation-runtime-ktx ile aynı manifest paket adını paylaşmak yerine benzersiz bir manifest paket adına sahip. (aosp/1141947)

Bağımlılık güncellemeleri

Sürüm 2.2.2

Sürüm 2.2.2

15 Nisan 2020

androidx.navigation:navigation-*:2.2.2 yayınlanır. 2.2.2 sürümü şu commit'leri içerir.

Hata Düzeltmeleri

  • Etkinliğinizde birden fazla IllegalStateException örneği olduğunda grafiğinizin başlangıç hedefine derin bağlantı oluştururken NavHostFragment sorunu düzeltildi. (b/147378752)
  • NavigationUI artık boş etiketleri (ör. android:label=”” içeren bir hedef) yoksaymıyor ve başlığı doğru şekilde boş bir dize olarak ayarlıyor. Bu özellik daha önce Navigation 2.3.0-alpha04 sürümünde kullanıma sunulmuştu. (b/148679860)
  • navigation-common-ktx ProGuard kuralları artık yalnızca kullanılan NavArgs sınıflarını doğru şekilde tutuyor ve tüm NavArgs örneklerini tutmuyor. Bu özellik daha önce Navigation 2.3.0-alpha03'te yayınlanmıştı. (b/150213558

Bağımlılık güncellemeleri

Sürüm 2.2.1

Sürüm 2.2.1

5 Şubat 2020

androidx.navigation:navigation-*:2.2.1 iptal edilir. 2.2.1 sürümü şu commit'leri içerir.

Hata düzeltmeleri

  • Sorgu parametresi içermeyen derin bağlantılar artık sorgu parametrelerini sondaki {argument} öğelerine eklemek veya derin bağlantıyla eşleşmemek yerine doğru şekilde yoksayıyor. (b/147447512)
  • navigation-ui için DrawerArrowDrawable ProGuard kuralları, android.enableJetifier=true'ın gerekli olmaması için güncellendi. (b/147610424)
  • navigation-common-ktx modülü artık navigation-runtime-ktx ile aynı manifest paket adını paylaşmak yerine benzersiz bir manifest paket adına sahip. (aosp/1141947)

Bağımlılık güncellemeleri

Sürüm 2.2.0

Sürüm 2.2.0

22 Ocak 2020

androidx.navigation:navigation-*:2.2.0 iptal edilir. 2.2.0 sürümü şu commit'leri içerir.

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

  • NavBackStackEntry: Artık NavController.getBackStackEntry() işlevini çağırabilir ve geri yığında bir hedef veya gezinme grafiğinin kimliğini iletebilirsiniz. Döndürülen NavBackStackEntry, hedefi başlatmak için kullanılan bağımsız değişkenleri sağlamanın yanı sıra navigasyon odaklı bir LifecycleOwner, ViewModelStoreOwner (NavController.getViewModelStoreOwner() tarafından döndürülenle aynı) ve SavedStateRegistryOwner sağlar.
  • Lifecycle ViewModel SavedState Integration: SavedStateViewModelFactory, artık by navGraphViewModels() veya ViewModelProvider oluşturucu NavController.getBackStackEntry() ya da NavController.getViewModelStoreOwner() tarafından döndürülen bir ViewModelStoreOwner ile birlikte kullanılırken kullanılan varsayılan fabrika.
  • Derin bağlantılar için sorgu parametresi desteği: Sorgu parametreleri içeren derin bağlantılar artık yeniden sıralanmış sorgu parametrelerini destekliyor. Varsayılan değeri olan veya boş değer atanabilen bağımsız değişkenler, derin bağlantılar eşleştirilirken artık isteğe bağlıdır.
  • Geliştirilmiş Animasyon Desteği: NavHostFragment artık Fragment 1.2.0'daki FragmentContainerView'ı kullanıyor. Bu sayede animasyon z-sıralama sorunları ve pencere yerleştirmelerinin Fragment'lere gönderilmesi düzeltiliyor.

Sürüm 2.2.0-rc04

18 Aralık 2019

androidx.navigation:navigation-*:2.2.0-rc04 iptal edilir. 2.2.0-rc04 sürümü şu commit'leri içerir.

Hata düzeltmeleri

  • navigation-ui tarafından kullanılan varsayılan silme animasyonları, Fragment 1.2.0-rc04'daki ayarlanmış silme animasyonlarıyla eşleşecek şekilde düzenlendi. (b/145769814)

Sürüm 2.2.0-rc03

4 Aralık 2019

androidx.navigation:navigation-*:2.2.0-rc03 iptal edilir. 2.2.0-rc03 sürümü şu commit'leri içerir.

Hata düzeltmeleri

  • Sorgu parametreleri ve bir bağımsız değişken yolun son kısmı olarak kullanıldığında nihai yol bağımsız değişkeninin birden fazla karakterinin ayrıştırılmasını engelleyen derin bağlantı ayrıştırma sorunu düzeltildi. (b/144554689)
  • Derin bağlantı ayrıştırmayla ilgili bir sorun düzeltildi. Bu sorunda, isteğe bağlı parametreler null yerine "@null" alıyordu. (b/141613546)
  • NavHostFragment, FragmentContainerView ile kullanıldığında yapılandırma değişikliğinden sonra grafiği artık doğru şekilde geri yüklüyor. (b/143752103)

Bağımlılık değişiklikleri

  • Navigasyon artık uygun durumlarda Lifecycle 2.2.0-rc03, Lifecycle ViewModel SavedState 1.0.0-rc03, Activity 1.1.0-rc03 ve Fragment 1.2.0-rc03'e bağlıdır.

Sürüm 2.2.0-rc02

7 Kasım 2019

androidx.navigation:navigation-*:2.2.0-rc02 iptal edilir. 2.2.0-rc02 sürümü şu commit'leri içerir.

Bağımlılık değişiklikleri

  • Navigasyon artık androidx.lifecycle 2.2.0-rc02 öğesine bağlıdır.

Sürüm 2.2.0-rc01

23 Ekim 2019

androidx.navigation:navigation-*:2.2.0-rc01, 2.2.0-beta01 tarihinden beri herhangi bir değişiklik yapılmadan yayınlandı. 2.2.0-rc01 sürümü şu commit'leri içerir.

Sürüm 2.2.0-beta01

9 Ekim 2019

androidx.navigation:navigation-*:2.2.0-beta01 iptal edilir. 2.2.0-beta01 sürümü şu commit'leri içerir.

Yeni özellikler

  • NavDestination ve alt sınıfları artık hata ayıklama sırasında daha faydalı bilgiler sağlamak için toString() öğesini geçersiz kılıyor. (b/141264986)

Davranış değişiklikleri

  • Artık derin bağlantılar eşleştirilirken eşleşmenin başarısız olmasına neden olmak yerine fazladan sorgu parametreleri yoksayılıyor. (b/141482822)

Hata düzeltmeleri

  • Sorgu parametreleri de belirtilmişse derin bağlantının yolundaki bağımsız değişkenlerin yoksayılmasına neden olan sorun düzeltildi. (b/141505755)
  • navArgs() Kotlin uzantısı Activity artık ekstralar olmadığında daha iyi bir hata mesajı gösteriyor. (b/141408999)
  • Safe Args tarafından oluşturulan Directions Java sınıfları artık varsayılan değerler içeriyor. (b/141099045)
  • Safe Args tarafından oluşturulan Args Java sınıfları artık varsayılan değerler içeriyor. (b/140123727)
  • Toolbar kullanılırken NavigationUI, iki üst düzey hedef arasında geçiş yapılırken metin değişikliğini artık animasyonla göstermiyor. (b/140848160)

Sürüm 2.2.0-alpha03

18 Eylül 2019

androidx.navigation:navigation-*:2.2.0-alpha03 iptal edilir. 2.2.0-alpha03 sürümü şu commit'leri içerir.

Davranış değişiklikleri

  • setGraph numarası arandıktan sonra setViewModelStore() numarası arandığında artık IllegalStateException hatası oluşmuyor. Bu, tüm NavBackStackEntry örneklerinin ViewModel örnekleri için tutarlı bir depolama alanına sahip olmasını sağlamak amacıyla ilk kurulumun bir parçası olarak her zaman NavHost tarafından ayarlanmalıdır. (aosp/1111821)

Hata düzeltmeleri

  • Birden fazla farklı gezinme grafiği kapsamlı ViewModelStore örneğine bağlı ViewModel örnekleri kullanılırken ConcurrentModificationException düzeltildi. (aosp/1112257)

Sürüm 2.2.0-alpha02

5 Eylül 2019

androidx.navigation:navigation-*:2.2.0-alpha02 iptal edilir. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Yeni özellikler

  • Sorgu parametreleri içeren derin bağlantılar artık yeniden sıralanmış sorgu parametrelerini destekliyor. Varsayılan değeri olan veya boş değer atanabilen bağımsız değişkenler, derin bağlantılar eşleştirilirken artık isteğe bağlıdır. (b/133273839)
  • Artık NavController.getBackStackEntry() işlevini çağırabilir ve arka yığında bir hedef veya gezinme grafiğinin kimliğini iletebilirsiniz. Döndürülen NavBackStackEntry, hedefi başlatmak için kullanılan bağımsız değişkenleri sağlamanın yanı sıra navigasyon odaklı bir LifecycleOwner, ViewModelStoreOwner (NavController.getViewModelStoreOwner() tarafından döndürülenle aynı) ve SavedStateRegistryOwner sağlar. (aosp/1101691, aosp/1101710)

Hata düzeltmeleri

  • NavHostFragment öğesinin ViewPager2 öğesine eklenmesinin IllegalArgumentException ile başarısız olmasına neden olan sorun düzeltildi. (b/133640271)
  • NavInflater artık gereksiz yere getResourceName() çağırmıyor ve bu sayede şişirme süresi %40'a kadar kısalıyor. (b/139213740)

Sürüm 2.2.0-alpha01

7 Ağustos 2019

androidx.navigation:navigation-*:2.2.0-alpha01 iptal edilir. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Yeni özellikler

  • SavedStateViewModelFactory artık by navGraphViewModels() veya ViewModelProvider oluşturucu, NavController.getViewModelStoreOwner() tarafından döndürülen bir ViewModelStoreOwner ile birlikte kullanılırken varsayılan fabrika olarak kullanılıyor. (b/135716331)

API değişiklikleri

  • Navigation 2.1.0-rc01: 2.1.0-alpha02 sürümünde kullanıma sunulan ve NavController üzerindeki desteği sonlandırılan getViewModelStore() API'si kaldırıldı. (aosp/1091021)

Hata düzeltmeleri

  • NavHostFragment artık FragmentContainerView kullanıyor. Bu sayede animasyonun z sırasıyla ilgili sorunlar ve pencere yerleştirmelerinin Fragment'lere gönderilmesi düzeltildi. (b/137310379)

Sürüm 2.1.0

Sürüm 2.1.0

5 Eylül 2019

androidx.navigation:navigation-*:2.1.0 iptal edilir. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

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

  • ViewModel'leri gezinme grafiğiyle sınırlama: Artık by navGraphViewModels() özellik temsilcisini kullanarak (-ktx kitaplıklarını kullanan Kotlin kullanıcıları için) veya NavController'a eklenen getViewModelStoreOwner() API'yi kullanarak gezinme grafiği düzeyinde kapsamlandırılmış ViewModel'ler oluşturabilirsiniz. Daha fazla bilgi için Kullanıcı arayüzüyle ilgili verileri hedefler arasında paylaşma başlıklı makaleyi inceleyin.
  • İletişim kutusu hedefleri: Artık <dialog> hedefleri oluşturabilirsiniz. Bu hedefler, navigate yaptığınızda DialogFragment gösterir. NavHostFragment, varsayılan olarak iletişim kutusu hedeflerini destekler. Daha fazla bilgi için DialogFragment'ten hedef oluşturma başlıklı makaleyi inceleyin.
  • URI ile gezinme: Artık navigate kullanarak Uri yapabilirsiniz. Bu özellik, bir hedefe eklediğiniz <deepLink> kullanarak hedefe gitmenizi sağlar. Daha fazla bilgi için Uri kullanarak gezinme bölümüne bakın.
  • NavHostController: Özellikle özel bir NavHost oluşturmak için kullanılan API'ler NavHostController'e taşındı. Böylece uygulamalar NavController'lerini barındırma LifecycleOwner, OnBackPressedDispatcher ve ViewModelStore'ye bağlayabilir.

Sürüm 2.1.0-rc01

7 Ağustos 2019

androidx.navigation:navigation-*:2.1.0-rc01 iptal edilir. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

API değişiklikleri

  • 2.1.0-alpha02 sürümünde kullanıma sunulan ve NavController üzerindeki kullanımdan kaldırılmış getViewModelStore() API'si kaldırıldı. (aosp/1091021)

Sürüm 2.1.0-beta02

19 Temmuz 2019

androidx.navigation:*:2.1.0-beta02 iptal edilir. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Hata düzeltmeleri

  • 2.1.0-beta01 sürümünde eklenen, istenmeyen Jacoco bağımlılığı kaldırıldı. (b/137782950)

Sürüm 2.1.0-beta01

17 Temmuz 2019

androidx.navigation:*:2.1.0-beta01 iptal edilir. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Yeni özellikler

  • NavigationUI artık setupWithNavController(), Toolbar veya CollapsingToolbarLayout ile kullanılırken Yukarı düğmesinin kaldırılmasını animasyonla gösteriyor. (b/131403621)

Hata düzeltmeleri

  • findNavController() ile aynı kapsayıcıya sahip birden fazla NavHostFragment kullanılırken yaşanan zamanlama sorunu düzeltildi. (b/136021571)

Sürüm 2.1.0-alpha06

2 Temmuz 2019

androidx.navigation:*:2.1.0-alpha06 iptal edilir. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Yeni özellikler

  • NavHostFragment tarafından kullanılan app:navGraph özelliği artık navigation-runtime yapay ürününe taşındı. XML aracılığıyla eklenebilen özel gezinme araçları, Gezinme Düzenleyici'nin Ana Makine paneliyle entegrasyon sağlamak için bu özelliği kullanmalıdır. (b/133880955)

API değişiklikleri

  • NavController üzerindeki getViewModelStore() API'sinin desteği sonlandırıldı. Bunun yerine ViewModelStoreOwner döndüren yeni getViewModelStoreOwner() yöntemi kullanıma sunuldu. (aosp/987010)
  • <dialog> hedefleri gibi kayan pencere hedeflerinin uygulanması, artık tüm <dialog> hedeflerinin uyguladığı bir işaretleyici arayüzü olan FloatingWindow olarak genelleştirildi. Üst uygulama çubuğuyla etkileşim için kullanılan NavigationUI yöntemleri artık FloatingWindow hedeflerini yoksayıyor. (b/133600763)

Davranış değişiklikleri

  • Gezinme, artık <dialog> hedefi kullanılırken durumunu ekranda görünenlerle doğru şekilde senkronize ediyor. Bu nedenle, artık bir <fragment> hedefi gibi iletişim kutusu ve etkinlik olmayan bir hedefe gittiğinizde Navigasyon, <dialog> hedeflerini otomatik olarak gösterir. (b/134089818)

Hata düzeltmeleri

  • Derin bağlantı işlenirken etkinliğin yeniden oluşturulması sırasında oluşan animasyon artık gezinme tarafından bastırılıyor ve görsel yanıp sönme düzeltiliyor. (b/130362979)
  • İlk parça eklenirken bir parçanın çıkarılması durumunda gezinme geri yığını senkronize olmuyordu. Bu hata düzeltildi. (b/133832218)

Sürüm 2.1.0-alpha05

5 Haziran 2019

androidx.navigation:*:2.1.0-alpha05 iptal edilir. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

API değişiklikleri

  • NavController üzerindeki ana makineyle ilgili API'ler yeniden adlandırıldı ve NavController'nın yeni bir alt sınıfı olan NavHostController'ye taşındı. (aosp/966091)
  • NavController setHostOnBackPressedDispatcherOwner() yöntemi, NavHostController'ın setOnBackPressedDispatcher() yöntemiyle değiştirildi ve artık bu yöntemi çağırmadan önce setLifecycleOwner()'ı aramanız gerekiyor. (aosp/965409)
  • NavHostController artık setHostOnBackPressedDispatcherOwner() tarafından daha önce döndürülen NavHostOnBackPressedManager sınıfının yerini alan bir enableOnBackPressed(boolean) yöntemi içeriyor. (aosp/966091)

Hata düzeltmeleri

  • URI ile gezinildikten sonra geri yığınının doğru olmamasına neden olan sorun düzeltildi. (b/132509387)
  • NavController tarafından otomatik olarak işlenen derin bağlantılar artık yalnızca bir kez tetikleniyor. (b/132754763)

Sürüm 2.1.0-alpha04

16 Mayıs 2019

androidx.navigation:*:2.1.0-alpha04 iptal edilir. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Hata düzeltmeleri

  • NavHostFragment, sistemin geri düğmesi etkinliklerini yakalarken app:defaultNavHost öğesine doğru şekilde saygı duyuyor ve gezinme 2.1.0-alpha03 bölümündeki bir gerilemeyi düzeltiyor. b/132077777
  • DialogFragmentNavigator artık popBackStack() ve navigateUp() işlemlerini doğru şekilde gerçekleştiriyor. b/132576764
  • İç içe yerleştirilmiş grafikler arasında tekrar tekrar gezinirken oluşan IllegalStateException: unknown destination during restore sorunu düzeltildi. b/131733658

Sürüm 2.1.0-alpha03

7 Mayıs 2019

androidx.navigation:*:2.1.0-alpha03 iptal edilir. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Bilinen Sorunlar

  • NavHostFragment, app:defaultNavHost="false" b/132077777 kullanmasına rağmen sistemin geri düğmesini engellemeye devam ediyor.

Yeni özellikler

  • Artık <dialog> hedefleri oluşturabilirsiniz. Bu hedeflere navigate yaptığınızda DialogFragment gösterilir. NavHostFragment, varsayılan olarak sohbet hedefi türlerini destekler. b/80267254
  • Bir kaynak kimliği veya NavDirections örneğiyle navigate işlevini çağırmanın yanı sıra artık bir Uri üzerinden de gezinebilirsiniz. Bu işlev, doğru hedefe gitmek için bir hedefe eklediğiniz <deepLink> işlevini kullanır. b/110412864

Davranış değişiklikleri

  • NavigationUI tarafından sağlanan varsayılan animasyonlar, etkinliklerin ve parçaların varsayılan animasyon hızıyla eşleşmesi için 400 ms'den 220 ms'ye çıkarıldı. b/130055522

API değişiklikleri

  • createFragmentNavigator() NavHostFragment yöntemi kullanımdan kaldırıldı ve işlevi, NavHostFragment alt sınıflandırılırken özel Navigator'lar eklemenin doğru giriş noktası olduğunu daha net bir şekilde belirtmek için yeni onCreateNavController() yöntemine taşındı. b/122802849
  • Belirli bir Uri öğesinin söz konusu hedef tarafından veya bir NavGraph durumunda gezinme grafiğindeki herhangi bir hedef tarafından işlenip işlenemeyeceğini kontrol etmenize olanak tanımak için NavDestination öğesine bir hasDeepLink() yöntemi eklendi. b/117437718

Hata düzeltmeleri

  • Varsayılan bağımsız değişkenler artık OnDestinationChangedListener örneklerine doğru şekilde iletiliyor. b/130630686
  • NavHostFragment artık OnBackPressedDispatcher kullanarak sistemin geri gitme etkinliklerini yakalıyor ve bir parçaya geri dönüldüğünde parça yaşam döngüsü yöntemlerinde koşullu gezinme yapılırken yaşanan bir sorunu düzeltiyor. b/111598096
  • Güvenli Args için, belirtilmemiş app:argType ile android:defaultValue=”@null” artık düzgün bir şekilde string bağımsız değişkeni olarak çıkarılıyor. b/129629192

Sürüm 2.1.0-alpha02

3 Nisan 2019

androidx.navigation:*:2.1.0-alpha02 iptal edilir. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Yeni özellikler

  • Artık Kotlin kullanıcıları için by navGraphViewModels() özellik temsilcisini kullanarak veya NavController'ye eklenen getViewModelStore() API'sini kullanarak bir gezinme grafiği düzeyinde kapsamı belirlenmiş ViewModel'ler oluşturabilirsiniz. b/111614463

API değişiklikleri

  • Artık eşleşen paket adını sınırlamak için <activity> hedefine app:targetPackage ekleyebilirsiniz. Paketi kendi uygulama kimliğinizle kısıtlamak için app:targetPackage="${applicationId}" özelliğini destekler. b/110975456

Hata düzeltmeleri

  • <activity> hedefleri için android:name artık enflasyon sırasında bir Sınıf'a ayrıştırılmıyor. Bu sayede, dinamik özellikler kullanılırken ClassNotFoundExceptions önleniyor. b/124538597

Sürüm 2.1.0-alpha01

19 Mart 2019

Bu, Navigation 2.1.0'ın ilk alfa sürümüdür.

Bağımlılık değişiklikleri

  • Gezinme artık androidx.core:core:1.0.1 ve androidx.fragment:fragment:1.1.0-alpha05 öğelerine bağlıdır. Bu sürüm, androidx.legacy:legacy-support-core-utils:1.0.0 bağımlılığını da kaldırır. b/128632612

API Değişiklikleri

  • Kaynak kimliği ve paketle tıklama işleyici oluşturmaya alternatif olarak yeni bir Navigation.createNavigateOnClickListener(NavDirections) yöntemi eklendi. b/127631752
  • FragmentNavigator.instantiateFragment desteği sonlandırıldı. Varsayılan uygulama artık Fragment'leri oluşturmak için FragmentFactory kullanıyor. b/119054429

Hata Düzeltmeleri

  • Hedefe bağımsız değişkenler eklendiğinde gezinme artık boş bir Bundle göndermiyor. Bu sayede, android:defaultValue="@null" kullanılırken yaşanan sorun düzeltildi. b/128531879
  • Safe Args artık KotlinPoet 1.1.0'a bağlıdır ve bu sayede çok uzun paket adlarıyla ilgili bir sorun düzeltilmiştir. b/123654948

Sürüm 2.0.0

Sürüm 2.0.0

14 Mart 2019

2.0.0 navigasyonu, 2.0.0-rc02 sürümüne göre herhangi bir değişiklik yapılmadan yayınlandı.

Sürüm 2.0.0-rc02

6 Mart 2019

Navigation 2.0.0-rc02, androidx.navigation grup kimliğine sahip yeni yapılar sunar ve bağımlılıklarını AndroidX eşdeğerleriyle değiştirir.

2.0.0-rc02'nin davranışı, Navigation 1.0.0-rc02'nin davranışı ile aynıdır. 1.0.0-rc02'den güncelleme yapmak için kodunuzda değişiklik yapmanız gerekmez. Yalnızca bağımlılıklarınızı yeni bağımlılıklarla eşleşecek şekilde güncellemeniz gerekir.

Navigation'ın 2.X sürümlerini kullanmak için projenizin AndroidX'e taşınmış olması gerekir. Kararlı Navigation 1.0, Support Library bağımlılıklarını kullanan son sürüm olacaktır. 1.0'ın ötesindeki tüm gelecekteki geliştirmeler AndroidX'e dayanacak ve kararlı 2.0 sürümü üzerine kurulacaktır.

AndroidX Öncesi Bağımlılıklar

Navigation'ın AndroidX öncesi sürümleri için şu bağımlılıkları ekleyin:

dependencies {
    def nav_version = "1.0.0"

    implementation "android.arch.navigation:navigation-fragment:$nav_version" // For Kotlin use navigation-fragment-ktx
    implementation "android.arch.navigation:navigation-ui:$nav_version" // For Kotlin use navigation-ui-ktx
}

Safe args için build.gradle dosyanızın en üst düzeyine aşağıdaki classpath'i ekleyin.

buildscript {
    repositories {
        google()
    }
    dependencies {
        classpath "android.arch.navigation:navigation-safe-args-gradle-plugin:1.0.0"
    }
}

Sürüm 1.0.0

Sürüm 1.0.0

14 Mart 2019

1.0.0 navigasyonu, 1.0.0-rc02 sürümüne göre herhangi bir değişiklik yapılmadan yayınlandı.

Sürüm 1.0.0-rc02

26 Şubat 2019

Bu, Navigation'ın 1.0.0 kararlı sürümünün ikinci sürüm adayıdır. Bu sürümde çeşitli hata düzeltmeleri yapılmıştır.

Hata Düzeltmeleri

  • Kök grafikte kimlik yoksa popBackStack() öğesinin yoksayılmasına neden olan sorun düzeltildi. b/126251695
  • navigateUp() artık FLAG_ACTIVITY_NEW_TASK olmadan derin bağlantı işlendikten sonra çağrıldığında uygulamanızın görevine geri dönme işlemini doğru şekilde gerçekleştiriyor. b/126082008
  • ActivityNavigator.applyPopAnimationsToPendingTransition öğesinin doğru pop çıkış animasyonunu uygulamamasıyla ilgili sorun düzeltildi. b/126237567
  • Safe Args tarafından oluşturulan Kotlin kodu artık in ve fun gibi Kotlin anahtar kelimelerini R sınıfıyla ilişkili paket adında düzgün şekilde kod dışına alıyor. b/126020455

Sürüm 1.0.0-rc01

21 Şubat 2019

Bu, Navigation'ın 1.0.0 kararlı sürümü için yayınlanmış bir sürüm adayıdır. Bu sürümde bir hata düzeltmesi yer almaktadır.

Hata Düzeltmeleri

  • Parçalar ve singleTop gezinme işlemleri kullanılırken yaşanan sorun düzeltildi. b/124294805

Sürüm 1.0.0-beta02

12 Şubat 2019

Bu sürümde, bir dizi küçük iyileştirme ve önemli hata düzeltmeleri yer almaktadır.

Yeni Özellikler

  • Artık 0 uygulamasını reference bağımsız değişkenleri için android:defaultValue olarak kullanabilirsiniz. b/124248602

Davranış değişiklikleri

  • Tam derin bağlantı eşleşmeleri artık .* veya bağımsız değişken eşleşmeleri içeren derin bağlantılardan daha öncelikli olacak. b/123969518

Hata Düzeltmeleri

  • popBackStack() ve navigateUp, artık geri yığındaki son hedefi açarken false değerini doğru şekilde döndürüyor. Bu sayede, 1.0.0-beta01 sürümünde kullanıma sunulan bir gerileme düzeltiliyor. b/123933201
  • Gezinme artık kaydedilmiş örnek durumu geri yüklenirken ClassLoader değerini doğru şekilde ayarlıyor. Böylece, Navigator kaydedilmiş durumunda veya NavDestination öğesine gönderilen bağımsız değişkenlerde özel sınıflar kullanılırken sorun yaşanmıyor. b/123893858
  • Kaydedilmiş örnek durumundan bir Parcelable[] bağımsız değişkeni geri yüklenirken Safe Args tarafından oluşturulan NavArgs sınıfları artık kilitlenmiyor. b/123963545
  • Safe Args artık gereksiz oluşturulan Kotlin sınıflarını düzgün şekilde temizliyor. b/124120883

Sürüm 1.0.0-beta01

4 Şubat 2019

Bu, Navigation'ın ilk beta sürümüdür. Kritik bir sorun olmadığı sürece Navigation API'nin bir sonraki sürüme kadar kararlı kalması beklenmektedir. Bu sürümde bazı hata düzeltmeleri ve davranış değişiklikleri yer almaktadır.

Davranış değişiklikleri

  • Geçiş artık bağımsız değişken varsayılan değerlerinin çalışma zamanında ve Safe Args aracılığıyla aynı şekilde işlenmesini sağlıyor. Sonuç olarak, yalnızca app:argType="reference" içeren bağımsız değişkenler başka bir kaynağa (ör. @color/colorPrimary) işaret eden bir varsayılan değere sahip olabilir. Farklı bir app:argType ile referans varsayılan değeri kullanmaya çalışmak, gezinme XML'si ayrıştırılırken bir istisnaya neden olur.b/123551990
  • Safe Args artık Android Gradle Eklentisi 3.3.0'a bağlıdır. aosp/888413
  • Safe Args artık Kotlin 1.3.20'ye bağlıdır. aosp/888414

Hata Düzeltmeleri

  • Safe Args artık Android Gradle Plugin'in tüm sürümlerinde kitaplık ve özellik modüllerinde kullanılabilir. b/121304903
  • Tek bir popBackStack() işleminin, hedefteki tüm kopyaları arka yığının en üstünden kaldırmasına (bir seferde yalnızca tek bir hedef yerine) neden olan gerileme düzeltildi. b/123552990
  • FragmentNavigator durumunun NavController durumuyla senkronizasyonunun bozulmasına ve geri yığını geri yüklemeye çalışırken IllegalStateException'ye neden olan sorun düzeltildi. b/123803044
  • ProGuard, karartma ile kullanılırken NavigationUI işlenmiş geri okunun görünmemesi sorunu düzeltildi. b/123449431
  • Safe Args tarafından oluşturulan kod artık app:argType biçimindeki statik bir iç sınıfa işaret eden .OuterClass$InnerClass kullanımını düzgün şekilde işliyor. b/123736741
  • Safe Args tarafından oluşturulan Java kodu artık genel işlemleri ve derin iç içe yerleştirilmiş hedefleri düzgün şekilde işliyor. b/123347762

Sürüm 1.0.0-alpha11

23 Ocak 2019

Bu, 1.0.0-alpha10 için yayınlanan ve Safe Args ile ilgili bir sorunu düzelten acil düzeltme sürümüdür.

Hata Düzeltmeleri

  • Safe Args'ın, genel işlemlerle ilişkili Directions sınıfını içe aktaramamasına neden olan sorun düzeltildi. b/123307342

Sürüm 1.0.0-alpha10

23 Ocak 2019

Bilinen Sorunlar

  • Safe Args, genel işlemlerle ilişkili Directions sınıfını içe aktaramıyor. b/123307342

Bu sürüm, API'de zarar veren değişiklikler içerir. Lütfen aşağıdaki Zarar Veren Değişiklikler bölümüne bakın.

Yeni Özellikler

  • Kotlin kullanıcıları artık by navArgs() özelliği temsilcisini kullanarak Activity veya Fragment içinde Safe Args tarafından oluşturulan NavArgs sınıfına referans almak için tembel başlatma özelliğini kullanabilir. b/122603367
  • Safe Args artık androidx.navigation.safeargs.kotlin eklentisini uygulayarak Kotlin kodu oluşturmanıza olanak tanıyor. Kotlin kodu, yalnızca Kotlin modülleri için özel olarak oluşturulur. Önceki androidx.navigation.safeargs eklentisi aracılığıyla hâlâ kullanılabilen oluşturucu kalıbı yerine varsayılan bağımsız değişkenler ve değişmez sınıflar kullanılır. b/110263087

Davranış Değişiklikleri

  • Eşleşen derin bağlantılar artık en fazla eşleşen bağımsız değişkene sahip derin bağlantıya yönlendiriliyor. b/118393029
  • NavController cihazında setGraph() numaralı telefonu aradığınızda artık geri yığın sıfırlanacak. b/111450672
  • Bilinmeyen derin bağlantılar artık IllegalStateException oluşturmuyor ancak yoksayılıyor. Bu sayede, iç içe yerleştirilmiş veya birden fazla IllegalStateException ile ilgili sorunlar düzeltiliyor. b/121340440NavHostFragment

Zarar Veren Değişiklikler

  • Bir etkinliğe NavOptions.applyPopAnimationsToPendingTransition() pop animasyonları uygulama yöntemi ActivityNavigator bölümüne taşındı. b/122413117
  • Safe Args artık bağımsız değişken içermeyen işlemler için aynı sınıfların kopyalanmasını önlüyor. Oluşturulan NavDirections sınıflarındaki bağımsız değişken içermeyen yöntemlerin dönüş türü artık NavDirections. b/123233147
  • Safe Args tarafından oluşturulan Directions sınıfları artık herkese açık bir oluşturucuya sahip değil. Yalnızca oluşturulan statik yöntemlerle etkileşim kurmalısınız. b/123031660
  • Safe Args tarafından oluşturulan NavDirections sınıfları artık herkese açık bir oluşturucuya sahip değil. Bu sınıflar yalnızca oluşturulan Directions sınıflarındaki statik yöntemler aracılığıyla oluşturulmalıdır. b/122963206
  • NavDirections' getArguments() ürününden döndürülen Bundle artık @Nullable yerine @NonNull olarak işaretleniyor. b/123243957

Hata Düzeltmeleri

  • NavDeepLinkBuilder, benzersizliği belirlemek için ilettiğiniz bağımsız değişkenleri kullanarak aynı hedefe yönelik birden fazla eşzamanlı PendingIntent isteğini artık doğru şekilde işliyor. b/120042732
  • İç içe yerleştirilmiş NavHostFragment veya geri yığınlı diğer alt parçalar kullanılırken NavController artık popBackStack() işlemlerini doğru şekilde gerçekleştiriyor. b/122770335
  • NavigationUI artık Yukarı düğmesinin içerik açıklamasını doğru şekilde ayarlıyor. b/120395362
  • Safe Args tarafından oluşturulan Directions sınıfları artık hedefteki bir işlemle aynı kimliğe sahip genel işlemleri doğru şekilde işliyor. b/122962504
  • NavDirections sınıfları, equals() doğru değerini döndürdüğünde artık eşit hashCode() değerlere sahip. b/123043662
  • FragmentNavigator artık NavHostFragment'nin FragmentManager üzerinde özel FragmentTransactions yapmaya çalıştığınızda daha iyi bir hata mesajı gösteriyor. Her zaman getChildFragmentManager() kullanmalısınız. b/112927148

Sürüm 1.0.0-alpha09

18 Aralık 2018

Bu sürüm, API'de zarar veren değişiklikler içerir. Lütfen aşağıdaki Zarar Veren Değişiklikler bölümüne bakın.

android.arch.navigation:navigation-testing yapay nesnesinin geliştirilmesine devam etmemeyi tercih ettik. NavController'nın dahili olarak test edilmesi için faydalı olduğu kanıtlanmış olsa da doğru navigate() çağrılarının yapıldığını doğrulamak için NavController örneğini taklit etmek gibi alternatif test stratejilerini kullanmanızı önemle tavsiye ederiz. Bu yaklaşım, AndroidDevSummit 2018'deki Single Activity konuşmasında ayrıntılı olarak ele alınmıştır. Ayrıca, Navigation ile test etme konusunda özel olarak ek dokümanlar hazırlayacağız.

Yeni Özellikler

  • NavigationUI yöntemleriyle kullanıldığında menuCategory="secondary" içeren MenuItem artık arka yığını açmayacak. b/120104424
  • AppBarConfiguration artık bir yedek OnNavigateUpListener örneği ayarlamanıza olanak tanıyor. Bu örnek, navController.navigateUp() false döndürdüğünde çağrılır. b/79993862 b/120690961

Zarar Veren Değişiklikler

  • <argument> ile argType="reference" kullanıldığında Navigation artık referansı ayrıştırmıyor ve bunun yerine ham kaynak kimliğini sağlıyor. b/111736515
  • onNavDestinationSelected() artık varsayılan olarak gezinme grafiğinizin başlangıç hedefine geri dönüyor ve setup yöntemleriyle tutarlı hale geliyor. Geri yığınına geri dönmeyi önlemek için MenuItem öğenize menuCategory="secondary" ekleyin. aosp/852869
  • Oluşturulan fromBundle() sınıflarının Args yöntemleri artık boş değer atanabilir Bundle yerine boş olmayan bir Bundle alıyor. aosp/845616

Hata Düzeltmeleri

  • Bağımsız değişkenler artık her zaman dize olarak değil, doğru argType olarak derin bağlantılardan düzgün şekilde ayrıştırılıyor. b/110273284
  • Navigasyon artık herkese açık kaynaklarını doğru şekilde dışa aktarıyor. b/121059552
  • Safe Args artık Android Gradle Eklentisi 3.4 Canary 4 ve sonraki sürümlerle uyumlu b/119662045

Sürüm 1.0.0-alpha08

6 Aralık 2018

Bu sürüm, API'de zarar veren değişiklikler içerir. Lütfen aşağıdaki Zarar Veren Değişiklikler bölümüne bakın.

Yeni Özellikler

  • NavigationUI yöntemleriyle kullanıldığında hedef etiketleri artık android:label öğenizdeki {argName} örneklerini doğru bağımsız değişkenle otomatik olarak değiştirecek.b/80267266
  • Gezinme artık Destek Kitaplığı 28.0.0'a bağlıdır. b/120293333

Zarar Veren Değişiklikler

  • OnNavigatedListener, OnDestinationChangedListener olarak yeniden adlandırıldı b/118670572
  • OnDestinationChangedListener artık bağımsız değişkenlerin Bundle değerini de iletiyor. aosp/837142
  • app:clearTask ve app:launchDocument özellikleri ile ilişkili yöntemleri kaldırıldı. Grafiğinizin köküyle birlikte app:popUpTo kullanarak tüm hedefleri geri yığınınızdan kaldırın. b/119628354
  • ActivityNavigator.Extras artık Builder kalıbını kullanıyor ve Intent.FLAG_ACTIVITY_ işaretlerini ayarlama özelliği ekliyor. aosp/828140
  • NavController.onHandleDeepLink, handleDeepLink olarak yeniden adlandırıldı aosp/836063
  • Alt sınıflara ayırma için tasarlanmamış birçok sınıf ve yöntem (ör. NavOptions, NavInflater, NavDeepLinkBuilder ve AppBarConfiguration) final olarak değiştirildi. aosp/835681
  • Desteği sonlandırılan NavHostFragment.setGraph() yöntemi kaldırıldı aosp/835684
  • Desteği sonlandırılan NavigationUI.navigateUp(DrawerLayout, NavController) yöntemi kaldırıldı. aosp/835684
  • Parça oluşturma işlemi FragmentNavigator bölümüne taşındı. Böylece, parça oluşturma işlemini FragmentFactory'ye devretmek kolaylaştı. b/119054429
  • NavGraphNavigator oluşturucusu artık Context almıyor. aosp/835340
  • NavigatorProvider artık arayüz değil, sınıf olarak kullanılıyor. getNavigatorProvider() tarafından döndürülen NavigatorProvider işlevselliği değişmedi. aosp/830660
  • NavDestination.navigate() kaldırıldı. Bunun yerine Navigator numaralı telefondan navigate() kullanıcısını arayın. aosp/830663
  • Navigator işlevinde önemli yeniden düzenleme yapılarak OnNavigatorNavigatedListener işlevine olan ihtiyaç ortadan kaldırıldı ve bunun yerine navigate işlevinin, gidilen NavDestination öğesini döndürmesi sağlandı.
  • Navigator örnekleri artık NavController'ye pop etkinlikleri gönderemez. Geri düğmesine basılmasını engellemek ve navController.popBackStack() işlevini çağırmak için OnBackPressedCallback kullanmayı düşünebilirsiniz. aosp/833716

Hata Düzeltmeleri

  • Hedef bir <navigation> öğesi olduğunda popUpTo artık tutarlı bir şekilde çalışıyor. b/116831650
  • İç içe yerleştirilmiş grafikler kullanılırken IllegalArgumentException oluşmasına neden olan çeşitli hatalar düzeltildi. b/118713731 b/113611083 b/113346925 b/113305559
  • <activity> hedeflerinin dataPattern özelliği artık toString() çağrılarak dize olmayan bağımsız değişkenlerden bağımsız değişkenlerle doldurulacak. b/120161365

Safe Args

  • Safe Args, Enum değerleri de dahil olmak üzere Serializable nesneleri destekler. Numaralandırma türleri, sınıf adı olmadan numaralandırma değişmezini kullanarak varsayılan bir değer ayarlayabilir (ör. app:defaultValue="READ") b/111316353
  • Safe Args, desteklenen tüm türlerin dizilerini destekler. b/111487504
  • Safe Args artık kaynak dizinlerinin alt klasörlerini yoksayıyor. b/117893516
  • Safe Args, uygun yerlere @Override ek açıklamaları ekler b/117145301

Sürüm 1.0.0-alpha07

29 Ekim 2018

Yeni Özellikler

  • Yeni bir AppBarConfiguration sınıfı, hangi hedeflerin üst düzey hedef olarak kabul edileceğini özelleştirmenize olanak tanır. Ayrıntılı bilgi için güncellenmiş dokümanlara göz atın. b/117333663
  • Artık grafiğinizin başlangıç hedefine bağımsız değişkenler iletebilirsiniz. b/110300470
  • Derin bağlantılar artık nokta, kısa çizgi ve artı işareti içeren özel şemaları destekliyor. b/112806402

Zarar Veren Değişiklikler

  • navigation-testing-ktx modülü, navigation-testing artifact modülüne dahil edildi ve artık yayınlanmayacak.
  • navigation-testing yapısı artık Kotlin standart kitaplığına bağlıdır. API, Kotlin kurallarıyla daha tutarlı olacak şekilde değiştirildi ancak Java ile yazılmış testler için kullanmaya devam edebilirsiniz.
  • Meta veri manifestosuna kaydedilen gezinme grafikleri artık desteklenmiyor. b/118355937
  • İşlemler artık <activity> hedeflerine eklenemez. aosp/785539

Hata Düzeltmeleri

  • Derin bağlantılar artık sorgu parametrelerini doğru şekilde ayrıştırıyor. b/110057514
  • Etkinlik hedefleri artık tüm giriş ve çıkış animasyonlarını doğru şekilde uyguluyor. b/117145284
  • Özel Navigator'lar kullanılırken yapılandırma değişikliklerinden sonra meydana gelen kilitlenme sorunu düzeltildi. b/110763345

Safe Args

  • Safe args artık Android Gradle Eklentisi 3.2.1'e sabit bir bağımlılığa sahip. b/113167627
  • Artık iç sınıflar için yol tarifleri oluşturulabilir. b/117407555
  • <include> grafiği için yol tarifi oluşturmayla ilgili sorun düzeltildi. b/116542123

Sürüm 1.0.0-alpha06

20 Eylül 2018

Yeni Özellikler

API Değişiklikleri

  • Önemli Değişiklik: Navigator navigate() yöntemi artık Navigator.Extras parametresini alıyor.
  • NavController'ın getGraph() yöntemi artık NonNull b/112243286

Hata Düzeltmeleri

  • NavigationUI.setupWithNavController() Ayrı hedeflerdeki görünümlerle birlikte kullanıldığında artık görüntüleme sayısı sızdırmıyor b/111961977
  • Navigator onSaveState() artık yalnızca bir kez çağrılıyor b/112627079

Safe Args

  • Navigasyon hedefi Yol Tarifi sınıfları, üst Yol Tarifi sınıfı varsa bu sınıfı genişletir b/79871405
  • Directions ve Args sınıfları artık faydalı bir toString() uygulamasına sahip b/111843389

Sürüm 1.0.0-alpha05

10 Ağustos 2018

Hata Düzeltmeleri

  • Yanlış geri yığın davranışına neden olan hata düzeltildi. b/111907708
  • Oluşturulan Args sınıflarının equals() bölümündeki bir hata düzeltildi. b/111450897
  • Safe Args'da derleme hatasını düzeltme. b/109409713
  • Kaynak tanımlayıcılardan Java adlarına dönüşümü düzeltme b/111602491
  • Safe Args eklentisindeki nullability ile ilgili hata mesajları düzeltildi.
  • Eksik nullability ek açıklamalarını ekleyin.

Sürüm 1.0.0-alpha04

19 Temmuz 2018

Navigation 1.0.0-alpha04 ve ilişkili Safe Args Gradle eklentisi, çeşitli API değişiklikleri, davranış değişiklikleri ve hata düzeltmeleri içerir.

API / Davranış Değişiklikleri

  • NavHostFragment, her zaman geçerli Fragment'ı birincil gezinme parçası olarak ayarlar. Böylece, dış NavController açılmadan önce alt fragment yöneticilerinin açılması sağlanır. b/111345778

Safe Args

  • Zarar Veren Değişiklik: ConstraintLayout 2.0.0-alpha1 gibi diğer kitaplıklarla çakışmayı önlemek için app:type, app:argType olarak değiştirildi b/111110548.
  • Safe Args'dan gelen hata mesajları artık tıklanabilir b/111534438
  • Args sınıfları artık NonNull özelliklerinin gerçekten null olmadığını onaylıyor b/111451769
  • NavDirections ve Args oluşturulan sınıflara ek NonNull ek açıklamalar eklendi b/111455455 b/111455456

Hata Düzeltmeleri

  • Parça hedefine derin bağlantı oluşturulduktan sonra sistemin geri düğmesiyle ilgili sorun düzeltildi b/111515685.

Sürüm 1.0.0-alpha03

12 Temmuz 2018

Navigation 1.0.0-alpha03 ve ilişkili Safe Args Gradle eklentisi, çeşitli API değişiklikleri, davranış değişiklikleri ve hata düzeltmeleri içerir.

API / Davranış Değişiklikleri

  • Araç çubuğu için NavigationUI.setupWithNavController yöntemi eklendi b/109868820
  • CollapsingToolbarLayout için NavigationUI.setupWithNavController yöntemi eklendi b/110887183
  • popBackStack(), geri yığın boş olduğunda veya verilen hedef kimliği geri yığında olmadığında artık false değerini döndürüyor b/110893637
  • FragmentNavigator artık FragmentManager durumu kaydettikten sonraki gezinme işlemlerini yoksayarak "Can not perform this action after onSaveInstanceState" (Bu işlem, onSaveInstanceState'ten sonra gerçekleştirilemez) istisnalarını önlüyor. b/110987825

Safe Args

  • Önemli Değişiklik: İşlem ve bağımsız değişken adlarındaki alfanümerik olmayan karakterler, ilgili NavDirections yöntemi adlarında camel case ile değiştirilecek.
    • Örneğin, DemoController.index, setDemoControllerIndex b/79995048 olur.
    • Örneğin, action_show_settings, actionShowSettings b/79642240 olur.
  • Önemli Değişiklik: Bağımsız değişkenler artık varsayılan olarak null olmayan değerler olarak kabul ediliyor. Dize ve paketlenebilir bağımsız değişkenlerde boş değerlere izin vermek için app:nullable="true" b/79642307 ekleyin.
  • Artık app:type="long" özelliğini "123L" biçiminde defaultValues ile kullanabilirsiniz. b/79563966
  • Parcelable bağımsız değişkenleri artık app:type için tam nitelikli bir sınıf adı kullanılarak destekleniyor. Yalnızca "@null" b/79563966 varsayılan değeri desteklenir.
  • Args sınıfları artık equals() ve hashCode() b/79642246'yı uyguluyor.
  • Safe Args eklentisi artık kitaplık projelerine uygulanabilir b/80036553
  • Safe Args eklentisi artık özellik projelerine uygulanabilir b/110011752

Hata Düzeltmeleri

  • Parça yaşam döngüsü yöntemleri sırasında gezinirken karşılaşılan sorunlar düzeltildi. b/109916080
  • İç içe yerleştirilmiş grafiklerde birden fazla kez gezinirken oluşan sorunlar düzeltildi. b/110178671
  • Grafikteki ilk hedefle (b/109909461) setPopUpTo kullanılırken yaşanan sorunlar düzeltildi.
  • Tüm app:defaultValue değerlerinin dize olarak iletilmesi sorunu düzeltildi. b/110710788
  • Android Gradle Eklentisi 3.2 Beta 01 ile birlikte gelen aapt2, artık Navigation XML dosyalarındaki her android:name özelliği için keep kuralları ekliyor b/79874119
  • Varsayılan FragmentNavigator değiştirilirken oluşan bellek sızıntısı düzeltildi b/110900142.

Sürüm 1.0.0-alpha02

7 Haziran 2018

Davranış Değişiklikleri

  • FragmentNavigator artık setReorderingAllowed(true) kullanıyor. b/109826220

  • Gezinme özelliği artık derin bağlantı URL'lerinden ayrıştırılan bağımsız değişkenlerin URL kodunu çözüyor. b/79982454

Hata Düzeltmeleri

  • Fragment yaşam döngüsü yöntemlerinden navigate() çağrılırken yaşanan IllegalStateException sorunu düzeltildi. b/79632233

  • Gezinme artık animasyonlar kullanılırken titremeyi düzeltmek için Destek Kitaplığı 27.1.1'e bağlıdır. b/80160903

  • VarsayılanNavHost="true" öğesi alt parça olarak kullanılırken IllegalArgumentException sorunu düzeltildi. b/79656847

  • NavDeepLinkBuilder kullanılırken StackOverflowError sorunu düzeltildi. b/109653065

  • İç içe yerleştirilmiş bir grafiğe geri dönüldüğünde IllegalArgumentException düzeltildi. b/80453447

  • launchSingleTop kullanılırken Fragment'lerin çakışması sorunu düzeltildi. b/79407969

  • Gezinme artık iç içe yerleştirilmiş grafikler için doğru yapay geri yığını oluşturuyor. b/79734195

  • NavigationUI artık iç içe yerleştirilmiş bir grafik MenuItem olarak kullanıldığında doğru öğeyi vurgulayacak. b/109675998

API Değişiklikleri

  • İşlemler için clearTask özelliği ve NavOptions'deki ilişkili API kullanımdan kaldırıldı. b/80338878

  • İşlemler için launchDocument özelliği ve NavOptions içindeki ilişkili API kullanımdan kaldırıldı. b/109806636

Sürüm 1.0.0-alpha01

8 Mayıs 2018

Gezinme, uygulama içi gezinme oluşturmak için bir çerçeve sağlar. Bu ilk sürüm 1.0.0-alpha01.