Gezinme

Gezinme, bir Android uygulamasındaki "hedefler" arasında gezinmek için kullanılan bir çerçevedir. Hedefler ister Parçalar, Etkinlikler ister başka bileşenler olarak uygulansın, tutarlı bir API sağlar.
Son Güncelleme Kararlı Sürüm Sürüm Adayı Beta Sürümü Alfa Sürümü
23 Eylül 2026 2.10.2 - - -

Bağımlılıkları bildirme

Navigation'a bağımlılık eklemek için projenize Google Maven deposunu eklemeniz gerekir. Daha fazla bilgi için Google'ın Maven deposu sayfasını okuyun.

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

Groovy

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.10.2"

  // 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.10.2"

  // 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.10.2"
        classpath "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version"
    }
}

Kotlin

buildscript {
    repositories {
        google()
    }
    dependencies {
        val nav_version = "2.10.2"
        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 dili kodu oluşturmak için uygulamanızın ya da modülünüzün build.gradle dosyasına şu satırı 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 şunu ekleyin:

Groovy

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

Kotlin

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

AndroidX'e taşıma işlemine göre gradle.properties dosyanızda android.useAndroidX=true olmalıdır.

Kotlin uzantılarını kullanma hakkında bilgi edinmek için ktx belgelerine 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 bildirimleriniz Jetpack'i geliştirmemize yardımcı olur. Yeni sorunlar keşfederseniz veya bu kitaplığı iyileştirmek için fikirleriniz varsa bize bildirin. Yeni bir sorun oluşturmadan önce lütfen bu kitaplıktaki mevcut sorunlara göz atın. Yıldız düğmesini tıklayarak mevcut bir sorun için oy verebilirsiniz.

Yeni bir sorun oluşturma

Daha fazla bilgi için Issue Tracker belgelerine bakın.

Sürüm 2.10.2

23 Eylül 2026

androidx.navigation:navigation-*:2.10.2 yayınlandı. 2.10.2 sürümü bu commit'leri içerir.

Bağımlılık Güncellemeleri

  • androidx.lifecycle bağımlılıkları 2.10.0 sürümüne güncellendi. I4505a9f9a

Sürüm 2.10.1

9 Eylül 2026

androidx.navigation:navigation-*:2.10.1 yayınlandı. 2.10.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • NavHost animasyonları atladığında, beklenmedik kırpmaları önlemek için sizeTransform de atlanan animasyonun bir parçası olarak kabul edilir. (I4f995, b/550924680)

Sürüm 2.10.0

26 Ağustos 2026

androidx.navigation:navigation-*:2.10.0 yayınlandı. 2.10.0 sürümü bu commit'leri içerir.

2.9.0 sürümünden sonra yapılan önemli değişiklikler:

  • NavHost artık tahmin edilen geri gitme hareketi sırasında özel geçişe izin vermek için predictivePopEnterTransition ve predictivePopExitTransition parametrelerini kabul eden bir aşırı yükleme sağlar.
  • handleDeepLink, yalnızca tanınan derin bağlantıların işlenmesini ve diğerlerinin yoksayılmasını sağlayacak şekilde değiştirildi. Bu durum uygulamanızda hataya neden oluyorsa gezinme grafiğinizde tanımlanan derin bağlantılar üzerinden gezinmeye geçme olasılığını değerlendirin. Robolectric testleri için güvenilir bir pakette setPackage yöntemini kullanmanız gerekebilir.
  • Gezinme etkinlikleri sırasında eski yığın anlık görüntülerini göstermek için NavBackStackEntryInfo eklendi. Bu sayede, daha zengin özel tahmin edilen geri gitme animasyonları kullanılabilir.

Ek Platform Desteği

  • navigation-common, navigation-runtime ve navigation-testing modülleri; desktop, linux, macOS, iOS, javascript, WASM, watchos ve tvos için destek ekledi.

Sürüm 2.10.0-rc01

12 Ağustos 2026

androidx.navigation:navigation-*:2.10.0-rc01 yayınlandı. 2.10.0-rc01 sürümü bu commit'leri içerir.

Davranış değişiklikleri

  • Navigasyon için minimum SDK, diğer AndroidX kitaplıklarıyla birlikte API 24'e taşındı. (I972da, b/474169350)

Sürüm 2.10.0-beta01

29 Temmuz 2026

androidx.navigation:navigation-*:2.10.0-beta01 yayınlandı. 2.10.0-beta01 sürümü bu commit'leri içerir.

API Değişiklikleri

  • Gezinme etkinlikleri sırasında eski yığın anlık görüntülerini göstermek için NavBackStackEntryInfo kullanıma sunuldu. Bu sayede daha zengin özel tahmin edilen geri gitme animasyonları kullanılabilir. (Icb3b8)

Sürüm 2.10.0-alpha06

1 Temmuz 2026

androidx.navigation:navigation-*:2.10.0-alpha06 yayınlandı. 2.10.0-alpha06 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Yalnızca tanınan derin bağlantıların işlenmesini sağlamak için handleDeepLink değiştirildi (Id4fe3, b/509640056)
  • ComposableFragment, composable işlevleri genişletmek için bir parça bağımsız değişkeni yerine hedeften tam nitelikli adı kullanacak şekilde değiştirildi. (I65ded, b/509640586)
  • FragmentNavigator uygulamasında, işlemler optimize edildiğinde geçerli Fragment'ların IllegalArgumentException hatası vermesine neden olan kilitlenme sorunu düzeltildi. (I093b0, b/340202276)
  • Parçalarla gezinme özelliğinde, grafiğin programatik olarak ayarlanmasının düzgün şekilde geri yüklenememesine neden olan bir hata düzeltildi. (I41251, b/321147435)

Sürüm 2.10.0-alpha05

19 Mayıs 2026

androidx.navigation:navigation-*:2.10.0-alpha05 yayınlandı. 2.10.0-alpha05 sürümü bu kayıtları içerir.

Sürüm 2.10.0-alpha04

6 Mayıs 2026

androidx.navigation:navigation-*:2.10.0-alpha04 yayınlandı. 2.10.0-alpha04 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Tahmin edilen geri gitme hareketiyle ilgili yarışma durumunun neden olduğu olası NullPointerException sorunlarına karşı NavHost iyileştirildi. (Ie36c6, b/500945998)

Sürüm 2.10.0-alpha03

22 Nisan 2026

androidx.navigation:navigation-*:2.10.0-alpha03 yayınlandı. 2.10.0-alpha03 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Compose compileSdk, API 37'ye güncellendi. Bu nedenle, Compose kullanılırken minimum AGP sürümü 9.2.0 olmalıdır. (Id45cd, b/413674743)

Harici Katkı

  • watchos ve tvos hedefleri navigation-common, navigation-runtime ve navigation-testing modüllerine eklendi (I60e46)
  • DefaultNavTransitions adlı öğeyi herkese açık yapın (Ide293)

Sürüm 2.10.0-alpha02

25 Mart 2026

androidx.navigation:navigation-*:2.10.0-alpha02 yayınlandı. 2.10.0-alpha02 sürümü bu commit'leri içerir.

Sürüm 2.10.0-alpha01

11 Mart 2026

androidx.navigation:navigation-*:2.10.0-alpha01 yayınlandı. 2.10.0-alpha01 sürümü bu kayıtları içerir.

Yeni özellikler

  • NavHost artık tahmin edilen geri gitme hareketi sırasında özel geçişe izin vermek için predictivePopEnterTransition ve predictivePopExitTransition parametrelerini kabul eden bir aşırı yükleme sağlar. (Iac9b0, b/478294569)

Min SDK Güncellemesi

Harici Katkı

  • navigation:navigation-common, navigation:navigation-runtime ve navigation:navigation-testing artık Android'in yanı sıra masaüstü, Linux, macOS, iOS, JavaScript ve WASM'yi de destekliyor. Konstantin Tskhovrebov'a teşekkürler (I035d9, Iec624, I1615d)

Sürüm 2.9

Sürüm 2.9.8

22 Nisan 2026

androidx.navigation:navigation-*:2.9.8 yayınlandı. 2.9.8 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Tahmin edilen geri gitme hareketiyle ilgili yarışma durumunun neden olduğu olası NullPointerException sorunlarına karşı NavHost iyileştirildi. (Ie36c6, b/500945998)

Sürüm 2.9.7

28 Ocak 2026

androidx.navigation:navigation-*:2.9.7 yayınlandı. 2.9.7 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Navigasyon SafeArgs, Google hizmetleriyle birlikte kullanıldığında artık yapılandırma önbelleğe alma sorunları yaşamıyor. (I57cda, b/458071608)
  • navigation-testing'deki test 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 yayınlandı. 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 tüm AGP 8.4.2 ve sonraki sürümlerle uyumlu olması sağlanır. Bu değişikliklerin sonucunda, eklenti tarafından üretilen 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 yayınlandı. 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 eklentisi artık Android Gradle eklentisi 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 yayınlandı. 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 tahmin edilen geri gitme etkinliği yayınlandığında kilitlenme önlenir. (I5667c, b/384186542)

Sürüm 2.9.3

30 Temmuz 2025

androidx.navigation:navigation-*:2.9.3 yayınlandı. 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 bir hata düzeltildi. (If7406, b/417784831)
  • navigate(uri, navOptions,navigationExtras) kullanılırken ekstraların yoksayılmasına neden olan bir hata düzeltildi. (I67fb7, b/430336813)

Sürüm 2.9.2

16 Temmuz 2025

androidx.navigation:navigation-*:2.9.2 yayınlandı. 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 etmemesiyle ilgili sorun düzeltildi (Idb20e, b/418746335).
  • Özel NavTypes kullanılırken tip 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 yayınlandı. 2.9.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

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

Sürüm 2.9.0

7 Mayıs 2025

androidx.navigation:navigation-*:2.9.0 yayınlandı. 2.9.0 sürümü bu commit'leri içerir.

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

  • Navigation Safe Args işlemleri artık kullanıldıklarından emin olmak için @CheckResult ek açıklamasıyla oluşturuluyor.

SupportingPane arayüzü

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

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.
  • Gezinme artık diğer platformlarda Android'in URI'si ile uyumlu bir API olan yeni ve yaygın bir 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öntemleri (ör. aracılığıyla erişilebilen tip güvenli API'ler 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 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 yayınlandı. 2.9.0-rc01 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Jetpack Navigation'dan Android platformu dışı tüm hedefler kaldırıldı. Bu hedefler aslında çalışmıyor. Bunun yerine artık farklı platformlar için taslaklar sağlanıyor.(I2877d)

Sürüm 2.9.0-beta01

9 Nisan 2025

androidx.navigation:navigation-*:2.9.0-beta01 yayınlandı. 2.9.0-beta01 sürümü bu commit'leri içerir.

API Değişiklikleri

  • parseStringAsNavUri için ortak API, dize alan bir NavUri fabrika işleviyle değiştirildi. (I4db6e, b/403616316)

Bağımlılık Güncellemeleri

  • Bu kitaplık artık Kotlin 2.0 dil düzeyini 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 yayınlandı. 2.9.0-alpha09 sürümü bu kayıtları 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 yayınlandı. 2.9.0-alpha08 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

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

Harici Katkı

  • 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 yayınlandı. 2.9.0-alpha07 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Kapsayıcı olmayan pop ile saveState yapmaya çalışıldığında, geri yükleme sırasında kilitlenmeye neden olabilecek boş bir savedState oluşması sorunu düzeltildi. (I9f3e8, b/395091644)
  • Navigation 2.8.8 sürümünden itibaren: Derin bağlantı ile derin bağlantı isteğinin URI, işlem ve MIME açısından tam olarak eşleşmesi gereken NavDeepLink eşleşmesi düzeltildi. Yalnızca bir veya iki alan eşleşiyorsa eşleşmeye artık izin verilmez. (I3b029, b/395712033)
  • Navigation 2.8.8 sürümünden itibaren: Joker karakter yolları içeren rotaların eklenen bir derin bağlantıyla eşleşmemesine neden olan hata düzeltildi (I7ea92, b/389970341).

Harici Katkı

  • navigation-common, navigation-runtime ve navigation-compose API'lerini ortak platforma ayıklayın. Teşekkürler Konstantin Tskhovrebov. (I1e626, Ica76f, Idf479)

Bilinen Sorunlar

  • b/395712033 sorununu çözmeye yönelik ç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. Dahil edilmeyen alanlar yoksayılmalıdır. Bu sorun, b/399826566 kapsamında daha sonraki bir sürümde düzeltildi.

Sürüm 2.9.0-alpha06

12 Şubat 2025

androidx.navigation:navigation-*:2.9.0-alpha06 yayınlandı. 2.9.0-alpha06 sürümü bu kayıtları içerir.

Yeni özellikler

  • Navigation Safe Args işlemleri artık kullanıldıklarından emin olmak için @CheckResult ek açıklamasıyla oluşturuluyor. (I14d4c, b/356323084)

Hata Düzeltmeleri

  • NavController içinde, backStack durumlarının bir listeye kaydedildikten sonra yanlışlıkla bir diziye geri yüklenmeye çalışılmasına neden olan hata düzeltildi. (Idfb9b)
  • Navigation 2.8.7: Navigation Safe Args 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 yayınlandı. 2.9.0-alpha05 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Navigation Compose kullanılırken beklenmedik bir ölçek animasyonuna neden olan sorun düzeltildi. (I480f4, b/353294030)
  • Navigasyon 2.8.6: XML aracılığıyla sağlanan NavDestination etiketleri, özel NavType mantığına uyulmasını sağlamak için NavType.get aracılığıyla ayrıştırılır. (I7ec2f, b/388100796)
  • Gezinme 2.8.6: dataPattern ile etkinliğe giderken ActivityNavigator artık bağımsız değişken değerini bağımsız değişkenin NavType değeriyle kodlamaya çalışır. (I16376, b/383616432)
  • Navigation 2.8.5: Navigation Compose kullanılırken ve mevcut animasyonun sona erdiği karede gezinme ç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 yayınlandı. 2.9.0-alpha04 sürümü bu commit'leri içerir.

Yeni özellikler

Aşağıdaki tabloda, somutlaştırılmış ve KClass API'leri verilmiştir.

somutlaştırılmış 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

  • Tip 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: Eski yığın 1 girişe düşürülürse ve aynı karede sistem geri düğmesi tetiklenirse NavHost'ün PredictiveBackHandler içinde bir istisna oluşturmasına neden olan sorun düzeltildi. (I1a429, b/375343407)
  • Gezinme 2.8.5 bölümünden: Bir grafiğin startDestination güncellenirken NavDestination NullPointerException düzeltildi. (I99421, b/361560785)

Harici Katkı

  • Navigation 2.8.5: Navigation tip güvenliği, artık herhangi bir özel NavType gerektirmeden bir rotanın bağımsız değişken türü olarak List<Enum> öğesini destekler. Teşekkürler Csaba Kozák. (GH-725, b/375559962)

Sürüm 2.9.0-alpha03

13 Kasım 2024

androidx.navigation:navigation-*:2.9.0-alpha03 yayınlandı. 2.9.0-alpha03 sürümü bu kayıtları içerir.

Yeni özellikler

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

Hata Düzeltmeleri

  • NavBackStackEntry öğesine eklenen bir LifecycleObserver, barındıran LifecycleOwner (ör. içeren Etkinlik veya Parça) yaşam döngüsü durumunu değiştirdiğinde eski yığında değişikliği tetiklediğinde ortaya çıkabilecek bir ConcurrentModificationException düzeltildi. (Ia9494)

Sürüm 2.9.0-alpha02

30 Ekim 2024

androidx.navigation:navigation-*:2.9.0-alpha02 yayınlandı. 2.9.0-alpha02 sürümü bu kayıtları içerir.

Harici Katkı

  • 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 yayınlandı. 2.9.0-alpha01 sürümü bu kayıtları içerir.

Yeni özellikler

  • Özel Gezginler artık hedeflerini SupportingPane arayüzünü uyguluyor olarak işaretleyebilir. Bu, NavController'e bu hedeflerin diğer hedeflerle birlikte gösterileceğini belirtir. Bu arayüzü kullanarak, örneğin aynı anda birden fazla hedef RESUMED. (Id5559)
  • Gezinme 2.8.3: @Serializable ile doğru şekilde ek açıklama eklenmemiş, tür güvenli rotaları belirlemeye yardımcı olmak için navigation-common, navigation-runtime ve navigation-compose modüllerine 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ülleri için yeni lint kontrolleri eklendi. Bu kontroller, @Keep ile doğru şekilde ek açıklama eklenmemiş Enum bağımsız değişkenleri içeren, 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)

Davranış Değişiklikleri

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

Hata Düzeltmeleri

  • Enum sınıfı sadeleştirilmiş 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üne eklenen yeni lint kurallarıyla ilgili bir sorun var. Bu sorun, Android Gradle Eklentisi 8.4 ve sonraki sürümlerle 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 yayınlandı. 2.8.9 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Navigasyon 2.8.8'de bulunan ve eşleşme olarak kabul edilmesi için derin bağlantı isteğinin veya amacının tüm alanlarıyla tam olarak eşleşmesi gereken bir gerileme düzeltildi. Bu durum, kısmi alan eşleşmeleri içeren ve başka eşleşmeleri olmayan 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 yayınlandı. 2.8.8 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Joker karakter yolları içeren rotaların, eklenen derin bağlantıyla eşleşmemesine neden olan hata düzeltildi. (I7ea92, b/389970341)
  • Derin bağlantı ile derin bağlantı isteğinin URI, işlem ve MIME açısından tam olarak eşleşmesi gereken NavDeepLink eşleşmesi düzeltildi. Yalnızca bir veya iki alan eşleşiyorsa eşleşmeye artık izin verilmez. (I3227f, b/395712033)

Bilinen Sorunlar

  • b/395712033 sorununu çözmeye yönelik ç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. Dahil edilmeyen alanlar yoksayılmalıdır. Bu sorun, b/399826566 kapsamında daha sonraki bir sürümde düzeltildi.

Sürüm 2.8.7

12 Şubat 2025

androidx.navigation:navigation-*:2.8.7 yayınlandı. 2.8.7 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

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

Sürüm 2.8.6

29 Ocak 2025

androidx.navigation:navigation-*:2.8.6 yayınlandı. 2.8.6 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

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

Sürüm 2.8.5

11 Aralık 2024

androidx.navigation:navigation-*:2.8.5 yayınlandı. 2.8.5 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Eski yığın 1 girişe düşürüldüğünde ve aynı karede sistem geri düğmesi tetiklendiğinde NavHost öğesinin PredictiveBackHandler içinde bir istisna oluşturmasına neden olan sorun düzeltildi. (I1a429, b/375343407)
  • Grafiğin startDestination değeri güncellenirken NavDestination NullPointerException düzeltildi. (I99421, b/361560785)
  • Navigation Compose kullanılırken ve mevcut animasyonun sona erdiği karede gezinme çağrısı yapıldığında beklenmedik bir ölçek animasyonuna neden olan sorun düzeltildi. (I26cb1, b/353294030)
  • NavBackStackEntry öğesine eklenen bir LifecycleObserver, barındıran LifecycleOwner (ör. içeren Etkinlik veya Parça) yaşam döngüsü durumunu değiştirdiğinde eski yığında değişikliği tetiklediğinde ortaya çıkabilecek bir ConcurrentModificationException düzeltildi. (Ia9494)

Harici Katkı

  • Gezinme tip güvenliği, artık herhangi bir özel NavType gerektirmeden bir rotanın bağımsız değişken türü olarak List<Enum> öğesini 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 yayınlandı. 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 yayınlandı. 2.8.3 sürümü bu commit'leri içerir.

Yeni özellikler

  • navigation-common, navigation-runtime ve navigation-compose modülleri için yeni lint kontrolleri eklendi. Bu kontroller, @Serializable ile doğru şekilde ek açıklama eklenmemiş tür güvenli rotaları belirlemeye yardımcı olur. Bu kontrol, tüm NavGraphBuilder ve NavDeepLinkBuilder uzantı işlevlerine uygulanır. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816)
  • @Keep ile doğru şekilde ek açıklama eklenmemiş Enum bağımsız değişkenleri içeren, tür güvenli rotaları belirlemeye yardımcı olmak için navigation-common, navigation-runtime ve navigation-compose modüllerine yeni lint kontrolleri eklendi. 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üne eklenen yeni lint kurallarının, Android Gradle Eklentisi 8.4 ve sonraki sürümlerle lint çalıştırmaya çalışırken Obsolete custom lint check hatasına neden olduğu bir sorun düzeltildi. (I1be3d, b/368070326, b/371463741)

Bilinen Sorunlar

  • Gezinme lint'i, Lint 16 (AGP 8.7) veya sonraki sürümlerle lint çalıştırmaya çalışırken "Eski özel lint kontrolü" hatası verir. (b/371926651)

Sürüm 2.8.2

2 Ekim 2024

androidx.navigation:navigation-*:2.8.2 yayınlandı. 2.8.2 sürümü bu commit'leri içerir.

Yeni özellikler

  • Gezinme Tip Güvenliği 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 adı ve rotanın tam adı yer alacak. (Id8416, b/346264232)

Sürüm 2.8.1

18 Eylül 2024

androidx.navigation:navigation-*:2.8.1 yayınlandı. 2.8.1 sürümü bu commit'leri içerir.

Yeni özellikler

  • Tip güvenliği API'leri kullanarak popBackStack yapmaya çalışırken 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

  • Gezinme için artık 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çermesi gerekiyor. (I18e74, b/362594265)
  • Navigation Safe Args, null değer alabilen dizeler için destek ekledi. Böylece "null" değerler ayrıştırılıp pakete olduğu gibi depolanacak. Bu, "null" değerlerin null nesneye ayrıştırıldığı mevcut davranıştan farklıdır. Bu değişiklik yalnızca null değer alamayan dize türleri için geçerlidir. Boş değer atanabilir dizeler değişmeden kalır. (I08b4a, b/348936238)
  • NavDestination, hedefe açıkça eklenen bir derin bağlantı dışında artık derin bağlantı oluşturulamaz. Bu, bir hedefin rotasına yalnızca dize rotası alan aşırı yüklenmiş gezinme işleviyle gidebileceğiniz anlamına da gelir. Bu sayede, korumalı olabilecek bir hedefe derin bağlantı oluşturmayı mümkün kılan bir güvenlik açığı düzeltilir. (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 yapmak zorunda kalmaz. (a4129a)
  • Navigation Compose artık Compose 1.7.2'a bağlıdır.

Sürüm 2.8.0

4 Eylül 2024

androidx.navigation:navigation-*:2.8.0 yayınlandı. 2.8.0 sürümü bu commit'leri içerir.

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

Navigation Kotlin DSL Tip Güvenliği

  • Navigation artık Kotlin Serileştirme'yi kullanarak Kotlin DSL (Navigation Compose tarafından kullanılır) için tip güvenliği sağlar. Böylece, gezinme grafiğinizdeki hedefleri tip güvenli nesneler ve veri sınıfları aracılığıyla 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 Tip Güvenliği blog yayınını inceleyin.

Navigation Compose 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, geri hareketini kullanarak önceki hedefi özel geçişinizle görebilir ve ardından işlemi tamamlanan hareketle onaylamaya veya iptal etmeye karar verebilirsiniz.

Navigation Fragment Composable

  • Gezinme XML dosyalarınıza composable hedefler eklemenize olanak tanıyan, NavHostFragment için ComposableNavHostFragment alternatifi içeren yeni bir navigation-fragment-compose yapı eklendi. Her composable hedefi, tam nitelikli adı her hedefte android:name özelliği olarak kullanılan üst düzey, bağımsız değişkensiz bir @Composable yöntemi olarak ifade edilmelidir. Bu hedeflerden birine gittiğinizde, composable içeriği görüntülemek için bir kapsayıcı fragment 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.
  • Navigasyon artık liste, diziler, haritalar gibi koleksiyon tabanlı bağımsız değişkenler için NavType<T> 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ır.
  • NavType artık Int, String, Boolean, Float ve Long listeleri için yerleşik desteğe sahip.

Sürüm 2.8.0-rc01

21 Ağustos 2024

androidx.navigation:navigation-*:2.8.0-rc01 yayınlandı. 2.8.0-rc01 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Üst düzey Enum sınıfları, tip güvenliği açısından güvenli bağımsız değişkenler olarak iletilirken oluşan gezinme kilitlenmesi düzeltildi. (I0ba76, b/358137294)
  • Navigation 2.8 artık SDK 34 ile doğru şekilde çalışıyor ve diğer AndroidX kitaplıkları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 yayınlandı. 2.8.0-beta07 sürümü bu kayıtları içerir.

Bilinen Sorunlar

  • b/358137294 nedeniyle, yalnızca başka bir sınıfta iç içe yerleştirilmiş Enum'lar kullanıma hazır olarak desteklenir. Üst düzey Enum'lar bir sonraki sürümde desteklenecektir.

Hata Düzeltmeleri

  • Yinelenen veya paylaşılan hedeflere giderken navigasyon, grafikteki mevcut konumdan en yakın eşleşen hedefe gitmeye öncelik verir. (Ic89a4, b/352006850)
  • Safe Args'ta gezinmeye yeni bir NavType.EnumType eklendi. Bu, Enum türlerinin artık özel NavType gerektirmediği anlamına gelir. Enum'nin SerialName değerinin varsayılan tam nitelikli ad olması gerektiğini unutmayın. (I66d22, b/346475493)
  • Navigation Safe Args, Int?,Long?, Float?, Boolean? ve Enum<*>? dahil olmak üzere null değer alabilen bağımsız değişken türleri için yerleşik destek ekledi. (I32d13,I1c580,Ifba66,I978b0,Ide076 , b/351994237)
  • NavGraph öğesinin startDestination bileşeni, NavGraph öğesine iletilen startDestination rotası tam olarak startDestination.route değerine 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 yayınlandı. 2.8.0-beta06 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • WrongStartDestinationType lint kontrollerinin, iletilen sınıf türündeki Companion nesnelerini kontrol etmemesi ve 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 yayınlandı. 2.8.0-beta05 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

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

Sürüm 2.8.0-beta04

26 Haziran 2024

androidx.navigation:navigation-*:2.8.0-beta04 yayınlandı. 2.8.0-beta04 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Gezinme artık yol bağımsız değişkenlerinde boş dizelerle gezinmeyi destekliyor. (Ic5dbd, b/339481310)
  • @Serializable(with =...) aracılığıyla doğrudan sınıf alanlarında tanımlanan özel serileştiriciler için hata mesajı iyileştirildi. Bu özelliğin şu anda desteklenmediği daha net bir şekilde belirtildi. (I052b0, b/341319151)
  • SavedStateHandleFactory test API'si artık Android dışı testlerde kullanılabilir ancak Robolectric'in Bundle'lar ile bağımsız değişken ayrıştırmayı desteklemesi gerekir. (I76cdc, b/340966212)
  • Compose'da Type-Safe Navigation kullanılırken işlem sonlandırmadan sonra uygulama devam ettirildiğinde durumu geri yükleme nedeniyle oluşan kilitlenme düzeltildi. (Ia8f38, b/341801005)
  • Navigation Compose'da, tahmin edilen geri gitme hareketi iptal edildikten sonra kullanıcının geri döndüğü NavBackStackEntry öğesinin hiçbir zaman RESUMED yaşam döngüsü durumuna dönmemesine neden olan sorun düzeltildi. Bu sayede, geri dönen hedef de bir kaydırma hareketinden sonra yerine oturmak yerine doğru şekilde animasyonla geri döner. (I97a0c, b/346608857)
  • Navigation Compose ile tahmin edilen geri gitme kullanıldığında, açılan hedef artık doğru z sırasına sahip olur ve gelen hedefin üzerinde doğru şekilde animasyon gösterir. (I2077b, b/345993681)

Sürüm 2.8.0-beta03

12 Haziran 2024

androidx.navigation:navigation-*:2.8.0-beta03 yayınlandı. 2.8.0-beta03 sürümü bu kayıtları içerir.

API Değişiklikleri

  • CollectionNavType, yeni bir soyut emptyCollection() yöntemine sahip. Bağımsız değişken olarak iletilen boş bir koleksiyonu işlemek için bu değeri geçersiz kılın. (Ie4d84, b/341723133)

Hata Düzeltmeleri

  • Nihai çıkışların URI kodlamalı olması gerektiğini vurgulamak için NavType.serializeAsValue ve serializeAsValues ile ilgili dokümanlar eklendi. (Ida6bd, b/344943214)
  • Boş bir CollectionNavType bağımsız değişkeniyle toRoute<T> çağrılırken oluşan kilitlenme düzeltildi. Boş bir CollectionNavType ile gezinirken çıkış bağımsız değişkeni, Serializable sınıfınızda tanımlanan varsayılan değer veya varsayılan değer yoksa emptyCollection() işlevinin döndürdüğü değer olur. (I84158, Id630f, b/342672856)

Sürüm 2.8.0-beta02

29 Mayıs 2024

androidx.navigation:navigation-*:2.8.0-beta02 yayınlandı. 2.8.0-beta02 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • NavBackStackEntry.toRoute, null değer alabilen özel bir NavType ile kullanılırken oluşan ClassCastException kilitlenme sorunu düzeltildi. (I1c29b, b/342239473)
  • Mevcut hedeften kimlik aracılığıyla erişilemeyen bir eski yığın girişini geri yüklemeye çalışırken ortaya çıkan, gezinme eski yığını durumunu geri yükleme sorunları düzeltildi. Rotalar kimliklerle desteklendiğinden rotalarla oluşturulan hedefler de etkilendi. Bu sayede, aynı sorundan kaynaklanan ve clearBackStack() çağrıldığında ortaya çıkan kilitlenme sorunu da düzeltildi. (I423c3, b/339908057)

Sürüm 2.8.0-beta01

14 Mayıs 2024

androidx.navigation:navigation-*:2.8.0-beta01 yayınlandı. 2.8.0-beta01 sürümü bu kayıtları içerir.

API Değişiklikleri

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

Hata Düzeltmeleri

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

Sürüm 2.8.0-alpha08

1 Mayıs 2024

androidx.navigation:navigation-*:2.8.0-alpha08 yayınlandı. 2.8.0-alpha08 sürümü bu kayıtları içerir.

Navigation Compose'da Safe Args

Bu işlev, gezinme grafiğinizdeki hedefleri, tip güvenli nesneler ve veri sınıfları aracılığıyla tanımlamanıza olanak tanımak için Kotlin Serileştirme'yi kullanı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 Tip Güvenliği blog yayınını inceleyin.

Yeni özellikler

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

Sürüm 2.8.0-alpha07

17 Nisan 2024

androidx.navigation:navigation-*:2.8.0-alpha07 yayınlandı. 2.8.0-alpha07 sürümü bu commit'leri içerir.

Yeni özellikler

  • NavHostFragment için ComposableNavHostFragment alternatifi 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 hedefi, tam nitelikli adı her hedefte android:name özelliği olarak kullanılan üst düzey, bağımsız değişkensiz bir @Composable yöntemi olarak ifade edilmelidir. Bu hedeflerden birine gittiğinizde, composable içeriği görüntülemek için bir kapsayıcı fragment 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

  • Navigation Compose'da Kotlin Serileştirme'ye dayalı bir yaklaşım kullanılarak Safe Args desteği devam etti. Bu API'ler tamamlanmamıştır ve ExperimentalSafeArgsApi ek açıklamasıyla işaretlenmiştir. Bu ek açıklama, gelecekteki bir sürümde API yüzeyinin tamamı 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 yayınlandı. 2.8.0-alpha06 sürümü bu kayıtları 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ıyor. Bu sayede AnimatedContent için varsayılan değerle uyumlu hale gelir ve merkezden geçişte beklenmeyen ölçeklendirme sorunları düzeltilir. (I09e72, b/330111602)
  • Navigation Compose kullanılırken tahmin edilen geri gitme hareketi yapıldığında NavHost artık hemen bitmek yerine özel geçişi doğru şekilde tamamlar. (I99017, b/327292110)

Sürüm 2.8.0-alpha05

20 Mart 2024

androidx.navigation:navigation-*:2.8.0-alpha05 yayınlandı. 2.8.0-alpha05 sürümü bu kayıtları içerir.

Yeni özellikler

  • Artık defaultValue'ye gerek kalmadan NavGraph'ın startDestination öğesine 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 koleksiyon tabanlı bağımsız değişkenler için NavType<T> 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ünde (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 parantezi biçimindeki değerlere (ör. {argName}) izin veriyor. Bu sayede, bu tür bir değerin tüm türler için geçersiz (veya değer yok) olarak kabul edilmesi sorunu düzeltilir. (I18302, b/327274038)
  • navigate veya popBackStack gibi rotaları destekleyen NavController işlevleri artık NavTypes dizisinin bağımsız değişkenleriyle doldurulmuş rotaları doğru şekilde eşleştirebilir. (Iea805, b/327229511)

Sürüm 2.8.0-alpha04

6 Mart 2024

androidx.navigation:navigation-*:2.8.0-alpha04 yayınlandı. 2.8.0-alpha04 sürümü bu kayıtları içerir.

Yeni özellikler

  • Artık Navigation Compose'da geçişleriniz için SizeTranform değerini, composable ve/veya navigation işlevlerinin başlatma işleminin bir parçası olarak tanımlayarak belirtebilirsiniz. (I91062, b/296912651)

Hata Düzeltmeleri

  • Compose Navigation'da NavHost, hareket olmadan sistem geri düğmesi kullanıldığında geçişi düzgün şekilde göstermiyordu. Bu sorun düzeltildi. (Iceeae, b/325998468)

Sürüm 2.8.0-alpha03

21 Şubat 2024

androidx.navigation:navigation-*:2.8.0-alpha03 yayınlandı. 2.8.0-alpha03 sürümü bu commit'leri içerir.

API Değişiklikleri

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

Hata Düzeltmeleri

  • Navigasyon'da, ilişkili girişin ViewModel öğesi kaydedilen durumun bir parçası olmadığı için NavGraph ViewModels'ın çok erken DESTROYED olmasına neden olan bir 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 yayınlandı. 2.8.0-alpha02 sürümü bu kayıtları 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, geri hareketini kullanarak önceki hedefi özel geçişinizle görebilir ve ardından işlemi tamamlanan hareketle onaylamaya veya iptal etmeye karar verebilirsiniz. (I8b8e9)

Sürüm 2.8.0-alpha01

24 Ocak 2024

androidx.navigation:navigation-*:2.8.0-alpha01 yayınlandı. 2.8.0-alpha01 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Bir hedefte birden fazla saveState çağrısının birden fazla durumun kaydedilmesine neden olduğu ancak yalnızca ilk durumun geri yüklenebildiği 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 dize olmayan bağımsız değişkenlerin düzgün şekilde görüntülenmemesine neden olan sorun düzeltildi. (#636, b/316676794)

Bağımlılık Güncellemesi

  • Navigation Compose artık Compose 1.7.0-alpha01'a bağlıdır. Bu sayede, beklenmedik bir ölçek animasyonuna neden olabilecek bir sorun düzeltilmiştir. (b/297258205)

Harici Katkı

  • Uygulama çubuklarının başlığını doldurmak için NavigationUI yardımcılarını kullanırken dize olmayan bağımsız değişkenlerin 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 yayınlandı. 2.7.7 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Navigation 2.8.0-alpha01'dan geriye dönük olarak taşındı: Tek bir NavBackStackEntry üzerinde birden fazla saveState() çağrısının birden fazla durumun kaydedilmesine neden olduğu ancak yalnızca ilk kaydedilen durumun geri yüklenebildiği BackStackState sızıntısı düzeltildi. (I598b0, b/309559751)
  • Navigation 2.8.0-alpha01'dan geriye dönük olarak taşındı: Uygulama çubuklarının başlığını doldurmak için NavigationUI yardımcıları kullanılırken dize olmayan bağımsız değişkenlerin düzgün şekilde gösterilmemesine neden olan sorun düzeltildi. (#636, b/316676794)

Harici Katkı

  • Uygulama çubuklarının başlığını doldurmak için NavigationUI yardımcılarını kullanırken dize olmayan bağımsız değişkenlerin 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 yayınlandı. 2.7.6 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • NavGraph equals() işlevi artık yalnızca çağıran grafiğin düğümlerini 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 olarak 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 yayınlandı. 2.7.5 sürümü bu commit'leri içerir.

Performans iyileştirmeleri

  • İki grafiği karşılaştırma performansı (hem süre hem de ayırma sayısı açısından) büyük ölçüde iyileştirildi. Bu sayede, yeni grafiği mevcut grafikle dahili olarak karşılaştıran setGraph gibi çağrılar çok daha hızlı gerçekleşir ve daha az kare atlanır. Bu iyileştirmeyi sağlayan kapsamlı analiz için Michał Z'ye teşekkür ederiz. (I6ad62)
  • NavHost, güncellenen durumu okumak için ikinci geçişi beklemek yerine ilk oluşturma geçişinde başlangıç hedefini oluşturur. (I439a7, b/304852206)

Hata Düzeltmeleri

  • Grafiğinizde iki hedefi birbirine bağlayan bir işlem bağlantısı içeren bir hedef varsa setGraph yöntemini aynı grafikle birden fazla kez çağırdığınızda eski yığınınızın çıkarılmasına neden olan sorun düzeltildi. (Ieaed7)
  • Hızlı bir şekilde gidilen ve kapatılan iletişim kutuları artık NavController.visibleEntries listesine sızmayacak. (I67586, b/287969970)
  • Bir giriş açıldıktan sonra yapılandırma değişikliği yapıldığında, saveState değeri yanlışsa girişin ViewModel değeri artık düzgün bir şekilde temizlenecek. (Idf242, b/298164648)
  • Yapılandırma değişikliğinden önce eski yığın tamamen boşsa veya gelen Intent'te FLAG_ACTIVITY_NEW_TASK işareti ayarlandığında setGraph çağrısı yapılıyorsa NavController öğesinin aynı derin bağlantıyı birden fazla kez işleyebilmesi sorunu düzeltildi. (I73c7f)

Bağımlılık Güncellemeleri

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

Sürüm 2.7.4

Sürüm 2.7.4

4 Ekim 2023

androidx.navigation:navigation-*:2.7.4 yayınlandı. 2.7.4 sürümü bu commit'leri içerir.

Yeni özellikler

  • popUpTo için, bağımsız değişkenler içeren rotaları kullanma desteği eklendi. Bu sayede, popBackStack'deki desteğe uygun olarak, tam olarak bu bağımsız değişkenleri kullanan belirli bir girişe geri dönmek mümkün hale geldi. (I731f4, b/299255572)

Hata Düzeltmeleri

  • popUpTo ile bir gezinme işlemini başka bir gezinme işlemiyle kesintiye uğratmanın FragmentNavigator uygulamasının kilitlenmesine neden olduğu sorun düzeltildi. (I3c848, b/301887045)
  • Sistem geri düğmesine basıldığında currentDestination öğesinin, görüntülenen Fragment ile eşleşecek şekilde doğru şekilde güncellenmemesine neden olan sorun düzeltildi. (Id0d6c, b/289877514)
  • DialogFragment yaşam döngüsü, üstündeki iletişim kutusu kapatıldığında artık düzgün bir şekilde RESUMED durumuna geçecek. (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 yayınlandı. 2.7.3 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Parçalarla gezinme özelliğinde, visibleEntries listesinin yanlış girişler içermesine neden olan bir sorun düzeltildi. (I5caa9, b/288520638)
  • Kayan pencere hedefinin (ör. Dialogs, Bottomsheets vb.) hiçbir zaman RESUMED yaşam döngüsü geri çağırma yöntemi almamasına neden olan bir 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 yayınlandı. 2.7.2 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Gezinme artık Lifecycle 2.6.2'a bağlıdır. Bu sayede, rememberSaveable ile Gezinme Oluşturma'nın NavHost arasındaki etkileşim düzeltilir. Bu etkileşim, hedeflerin rememberSaveable durumunun ve ViewModel'e ait tüm SavedStateHandle örneklerinin, işlem sonlandırma ve yeniden oluşturma işleminden sonra düzgün şekilde geri yüklenmesine neden olur. (b/298059596, b/289436035)
  • Navigation Compose'da aynı anda birden fazla iletişim kutusu gösterilirken kısmen gizlenen iletişim kutularının (ör. en üstteki iletişim kutusu değil) STARTED durumu yerine CREATED Yaşam Döngüsü durumunda olmasına neden olan sorun 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ı, yeni en üstteki iletişim kutusunun doğru şekilde RESUMED durumuna geçmek yerine STARTED yaşam döngüsü durumunda takılı kalmasına neden oluyordu. Bu sorun düzeltildi. (aosp/2629401, b/286371387)
  • Navigation Safe Args, gerçekten yürütülmüyorsa görevini artık istekli bir şekilde örneklendirmez. (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 yayınlandı. 2.7.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Navigation with Compose'da, Scaffold kullanılırken Lifecycle.State.DESTROYED ViewModel öğesine erişmeye çalışıldığında 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 yayınlandı. 2.7.0 sürümü bu commit'leri içerir.

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

Accompanist'ten animasyonlar

AnimatedContent artık kararlı olduğundan, kodu Accompanist Navigation Animation'dan tekrar Navigation Compose'a taşıyabildik.

Bu, AnimatedNavHost içinde bulunan özel geçişleri ayarlamaya yönelik tüm desteğin NavHost içinde doğrudan desteklendiği anlamına gelir.

Accompanist Navigation Animation'da başka değişiklik yapılmayacak ve yakında resmi olarak desteği sonlandırılacak. Ayrıca, Navigation Compose'a nasıl geri geçiş yapılacağına dair rehberlik de sunulacak. Ancak bu, geçiş rehberinin tersi olacak ve 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. (b/197140101)

Hata Düzeltmeleri

  • Navigation Compose'daki NavHost, etkinlik DURDURULDU ve DEVAM ETTİRİLDİ durumuna geçtikten sonra bile sistem geri aramalarını doğru şekilde yakalar. (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 yayınlandı. 2.7.0-rc01 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

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

Bilinen Sorunlar

  • Navigation 2.6.x'te, popUpTo ile gezinirken IllegalArgumentException hatasına neden olabilecek bir sorun var. Burada önerilen tavsiyeye benzer şekilde, grafiğinizi yeniden yapılandırarak bu istisnadan kaçınmanız mümkün olabilir. (b/287133013)

Sürüm 2.7.0-beta02

28 Haziran 2023

androidx.navigation:navigation-*:2.7.0-beta02 yayınlandı. 2.7.0-beta02 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Navigation Compose, popUpTo seçeneğiyle gezinmeyi kullanan özel geçişler için artık 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 yayınlandı. 2.7.0-beta01 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Navigation Compose'daki NavHost, Activity STOPPED ve RESUMED olduktan sonra bile sistem geri aramalarını doğru şekilde kesiyor. (Icb6de, b/279118447)

Sürüm 2.7.0-alpha01

24 Mayıs 2023

androidx.navigation:navigation-*:2.7.0-alpha01 yayınlandı. 2.7.0-alpha01 sürümü bu kayıtları içerir.

Accompanist'ten animasyonlar

AnimatedContent artık kararlı olduğundan, kodu Accompanist Navigation Animation'dan tekrar Navigation Compose'a taşıyabildik.

Bu, AnimatedNavHost içinde bulunan özel geçişleri ayarlamaya yönelik tüm desteğin NavHost içinde doğrudan desteklendiği anlamına gelir.

Accompanist Navigation Animation'da başka değişiklik yapılmayacak ve yakında resmi olarak desteği sonlandırılacak. Ayrıca, Navigation Compose'a nasıl geri geçiş yapılacağına dair rehberlik de sunulacak. Ancak bu, geçiş rehberinin tersi olacak ve 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. (b/197140101)

Hata Düzeltmeleri

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

Bağımlılık Güncellemeleri

  • Gezinme artık Compose 1.5.0-beta01'a 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 yayınlandı. 2.6.0 sürümü bu commit'leri içerir.

2.5.0 sürümünden bu yana gezinme ile ilgili önemli değişiklikler

  • NavBackStackEntry'ın arguments ve OnDestinationChangedListener'ye iletilen arguments, artık yalnızca hedefe gittiğinizde oluşturulan sabit 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şimlere 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 yinelenen sorgu parametreleri destekleniyor. NavType artık ayrıştırılmış iki değeri birleştirmek için geçersiz kılınabilen varsayılan bir yöntem de içeriyor.
  • NavType özel alt sınıfları artık bir değeri dizeye serileştirmek için serializeAsValue değerini geçersiz kılabilir. Böylece hem serileştirme hem de serileştirmeyi geri alma (parseValue aracılığıyla) işlemleri NavType sınıfında tamamen kapsüllenebilir. StringType artık bu yöntemi geçersiz kılarak belirli bir String üzerinde Uri.encode yöntemini çağırıyor.

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

  • NavHost ile bir composable önizlenirken artık varsayılan olarak NavGraph'ın startDestination öğesi gösterilir.
  • NavController.popBackStack(route), NavController.getBackStackEntry(route) ve NavController.clearBackStack(route) artık bağımsız değişkenleri kısmen veya tamamen doldurulmuş tüm rotaları destekliyor. Bağımsız değişkenlerin, girişin bağımsız değişkenleriyle tam eşleşmesi gerektiğini unutmayın.
  • navDeepLink Kotlin DSL'yi kullanarak boş bir NavDeepLink oluşturmaya çalışmak, artık derin bağlantının geçerli olması için URI, işlem ve/veya MIME türü gerektiğini belirten bir lint uyarısına neden olur.

2.5.0 sürümünden bu yana Parçalarla Gezinme'de yapılan önemli değişiklikler

  • NavHostFragment artık sistemin geri düğmesini kendisi engellemiyor. Bu sayede, temel FragmentManager sistem geri işlemini gerçekleştirebilir. Bu sayede Fragment 1.7.0-alpha01 ve sonraki sürümler, Android U cihazlarda uygulama içi tahmin edilen geri gitme animasyonu sunabilir.
  • Parçalarla gezinme kullanılırken FragmentManager öğesinin eski yığınına parça ekleyen bir FragmentTransaction işlemini manuel olarak yapmaya çalışmak artık IllegalArgumentException hatasına neden olur. Parçaları her zaman navigate() API'si üzerinden eklemeniz gerekir.
  • Bir gezinme XML dosyasının etkinlik öğesindeki app:data ve app:dataPattern özelliklerinde yer tutucu olarak tam dize ${applicationId} kullanıldığında, yer tutucu, şişirme sırasında bağlamın packageName ile otomatik olarak doldurulur.
  • FragmentNavigator artık NavBackStackEntries gezinirken ve açılırken geçiş API'lerini kullanıyor. Bu, NavBackStackEntry Lifecycle öğesinin artık son Lifecycle.State öğesini taşımadan önce giriş ve çıkış parçası özel efektlerinin tamamlanmasını bekleyeceği anlamına gelir.
  • DialogFragmentNavigator artık NavBackStackEntries gezinirken ve açılırken geçiş API'lerini kullanıyor. Bu, NavBackStackEntry Lifecycle adlı aracın DESTROYED konumuna geçmeden önce DialogFragment Lifecycle adlı aracın DESTROYED konumuna geçmesini bekleyeceği anlamına gelir.
  • NavHostFragment artık NavController değerini yalnızca onCreate() sonrasında değil, NavHostFragment FragmentManager öğesine eklenir eklenmez almanıza olanak tanır.
  • Navigasyonun Dinamik Özellik Modülleri desteği artık ayrıntılı Play Feature Delivery Kitaplığı'na bağlıdır.
  • Navigation Safe Args artık Android Gradle eklentisi 7.3.0 sürümüne bağlıdır. Bu, SDK'nın artık yalnızca 7.3.0 ve sonraki sürümlerle uyumlu olduğu anlamına gelir.

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

  • Bir gezinme grafiğinin kimliğini AppBarConfiguration öğesine (ör. Menu aracılığıyla) iletirken NavigationUI artık grafikteki her hedefi yanlış bir şekilde üst düzey hedef olarak işaretlemek yerine yalnızca söz konusu gezinme grafiğinin başlangıç hedefini üst düzey hedef olarak kabul ediyor. Tek bir hedefin kimliğini iletme davranışı değişmez. Aynı işlev, AppBarConfiguration üzerindeki yeni isTopLevelDestination işlevi aracılığıyla kendi kodunuzda da kullanılabilir.
  • NavigationUI uygulamasında üst uygulama çubuğuyla çalışmak için kullanılan setupWithNavController entegrasyonları, artık android:label uygulamanızda bulunan ReferenceType bağımsız değişkenleri için R.string değerlerini otomatik olarak oluşturulan kaynak tam sayısı yerine dize değerlerine ayrıştıracak.
  • NavigationUI, seçilen bir MenuItem üzerinden gezinemediğinde artık günlükleri sağlar.

Sürüm 2.6.0-rc02

24 Mayıs 2023

androidx.navigation:navigation-*:2.6.0-rc02 yayınlandı. 2.6.0-rc02 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Parçalarda gezinmeyle ilgili bir sorun düzeltildi. Bu sorunda, popUpTo ile gezinmek ve görünümünü yeniden oluşturmadan bir parçayı eski yığından çıkarmak, 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 yayınlandı. 2.6.0-rc01 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Parçalarla gezinme sırasında, onResume() yaşam döngüsü geri çağırma yönteminde popUpTo ile gezinme yoluyla bir parçanın kaldırılmasının IllegalStateException hatasına neden olması sorunu düzeltildi. (I21884, b/279644470)

Sürüm 2.6.0-beta01

19 Nisan 2023

androidx.navigation:navigation-*:2.6.0-beta01 yayınlandı. 2.6.0-beta01 sürümü bu commit'leri içerir.

Yeni özellikler

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

Hata Düzeltmeleri

  • Parçalarla gezinme kullanılırken FragmentManager öğesinin eski yığınına parça ekleyen bir FragmentTransaction işlemini manuel olarak yapmaya çalışmak artık IllegalArgumentException hatasına neden olur. Parçaları her zaman navigate() API'si üzerinden eklemeniz gerekir. (I6d38e)
  • Aynı karede bir giriş ekleyen navigate ve bu girişi kaldıran popBackStack olduğunda, eski yığındaki en üst giriş artık tutarlı bir şekilde RESUMED Lifecycle.State değerine geri döner. (Id8067, b/276495952)

Sürüm 2.6.0-alpha09

5 Nisan 2023

androidx.navigation:navigation-*:2.6.0-alpha09 yayınlandı. 2.6.0-alpha09 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Geçersiz rota kontrolleri düzeltildi. Buna göre, bir NavDestination null değer alabilen NavArgument içeriyorsa bu hedefin rotası, null değer alabilen 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 için gerekli olan ve null değer alabilen 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 eski yığın hedeflerini yeni örneklerle doğru şekilde değiştirir. Bu güncelleme, Navigation Compose'da durumu kaydetmeden onLaunchSingleTop kullanıldığında oluşan kilitlenme sorununu düzeltir. Bu sayede, kök grafikle ilişkili hedeflere gidildiğinde yanlış bir eski yığın oluşturulması hatası da düzeltildi. (I5bc58, b/275258161, b/275407804)

Sürüm 2.6.0-alpha08

22 Mart 2023

androidx.navigation:navigation-*:2.6.0-alpha08 yayınlandı. 2.6.0-alpha08 sürümü bu kayıtları içerir.

Yeni özellikler

  • NavHostFragment artık NavController değerini yalnızca onCreate() sonrasında değil, NavHostFragment FragmentManager öğesine eklenir eklenmez almanıza olanak tanır. (Ic6382, b/220186282)

Hata Düzeltmeleri

  • Null değer alabilen 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 yaptıktan sonra sistem geri düğmesini kullandığınızda NavController durumu doğru girişe geçer. (I3a8ec, b/270447657)
  • FragmentNavigator, eski yığın sistem geri düğmesi veya popBackStack() aracılığıyla çıkarıldığında ve işlemin parça için efekt kullanıp kullanmadığına bakılmaksızın girişleri düzgün bir şekilde çıkarır. (I81bdf)
  • FragmentNavigator'e gezinme kullanmadan parça eklemek artık kilitlenmeye neden olmayacak.FragmentManager (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 yayınlandı. 2.6.0-alpha07 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Rota alan getBackStackEntry, popBackStack, clearBackStack API varyantları artık null değer alabilen bağımsız değişkenler ve null değer alabilen sorgu parametreleri içeren rota kalıpları alıyor (I22294, b/269302500).
  • NavController öğesinden clearBackStack() çağrıldığında, temizlenen eski yığınla ilişkili parça yöneticisindeki kayıtlı durumun temizlenmemesi sorunu düzeltildi. (Ic1cce, b/271190202)
  • 2.6.0-alpha06 sürümünde, sekmeler arasında sistem geri düğmesi kullanılırken BottomNavigationView içindeki yanlış MenuItem öğesinin vurgulanmasına neden olan bir gerileme düzeltildi. (I634f6, b/270447657)
  • 2.6.0-alpha06 sürümünde, Animation kullanılırken NavBackStackEntry öğelerinin 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 yayınlandı. 2.6.0-alpha06 sürümü bu kayıtları içerir.

Yeni özellikler

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

API Değişiklikleri

  • Tüm NavController navigate aşırı yüklemeleri, ana iş parçacığında çağrılmalarını sağlamak için artık @MainThread ile ek açıklama eklenmiştir. (I2c0b0, b/263427111)

Hata Düzeltmeleri

  • Dinamik Parça Gezinme kullanılırken gezinmeye çalışıldığında oluşan 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 öğeye güncellenmemesine neden olan hata düzeltildi (If559f, b/269044426).

Bilinen Sorunlar

  • Parçalarla gezinme kullanılırken Animation API'leri kullanıldığında NavBackStackEntry öğesinin yaşam döngüsü RESUMED değerine ulaşamıyor. (b/269646882)
  • Fragment'lar ile gezinme özelliğini kullanırken ve BottomNavigation ile gezinirken birden fazla giriş içeren bir eski 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 NavBackStackEntry Lifecycle, parçası DESTROYED olduğunda DESTROYED olmaz. (b/270610768)

Sürüm 2.6.0-alpha05

8 Şubat 2023

androidx.navigation:navigation-*:2.6.0-alpha05 yayınlandı. 2.6.0-alpha05 sürümü bu kayıtları içerir.

Yeni özellikler

  • NavController.popBackStack(route), NavController.getBackStackEntry(route) ve NavController.clearBackStack(route) artık bağımsız değişkenleri kısmen veya tamamen doldurulmuş tüm rotaları destekliyor. Bağımsız değişkenlerin, girişin bağımsız değişkenleriyle tam eşleşmesi gerektiğini unutmayın. (Iebd28, Ic678c, I3b37b, b/257514373)
  • FragmentNavigator artık NavBackStackEntries gezinirken ve açılırken geçiş API'lerini kullanıyor. Bu, NavBackStackEntry Lifecycle öğesinin artık son Lifecycle.State öğesini taşımadan önce giriş ve çıkış parçası özel efektlerinin tamamlanmasını bekleyeceği anlamına gelir. (I3cb19, b/238686802)
  • DialogFragmentNavigator artık NavBackStackEntries gezinirken ve açılırken geçiş API'lerini kullanıyor. Bu, NavBackStackEntry Lifecycle adlı aracın DESTROYED konumuna geçmeden önce DialogFragment Lifecycle adlı aracın DESTROYED konumuna geçmesini bekleyeceği anlamına gelir. (I53ee5, b/261213893)

API Değişiklikleri

  • NavigatorState, Navigator'lerin NavBackStackEntries'yi ara Lifecycle.State'lere taşımasına olanak tanımak için prepareForTransition API'yi sunuyor. (I42c21, b/238686802)
  • Artık backstack özelliği aracılığıyla NavGraphNavigator veya ComposeNavigator ile ilişkili eski yığına erişebilirsiniz. ComposeNavigator artık bir gezinme veya popBackStack işlemi gerçekleştiren NavBackStackEntry öğesini tamamlandı olarak işaretlemek için onTransitionComplete() geri çağırma işlevini de kullanıma sunuyor. (I02062, I718db, b/257519195)

Hata Düzeltmeleri

  • push/popWithTransition API'leri kullanılırken ve giriş zaten işlenirken Navigator durumu artık işlem yapmayacak. (Iadbfa, b/261213893)
  • İç içe yerleştirilmiş NavGraph ile launchSingleTop kullanıldığında, orijinal hedeften başlayıp startDestination hedefine kadar olan tüm hedefler, geri yığının en üstüne doğru şekilde eklenir. (Id4bea, b/253256629)
  • Gezinme, launchSingleTop işareti "true" olarak ayarlanmış şekilde aynı hedefe giderken DialogFragment örneğini artık doğru ş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 yayınlandı. 2.6.0-alpha04 sürümü bu commit'leri içerir.

Yeni özellikler

  • NavType özel alt sınıfları artık bir değeri dizeye serileştirmek için serializeAsValue değerini geçersiz kılabilir. Böylece hem serileştirme hem de serileştirmeyi geri alma (parseValue aracılığıyla) işlemleri NavType sınıfında tamamen kapsüllenebilir. StringType artık bu yöntemi geçersiz kılarak belirli bir String üzerinde Uri.encode yöntemini çağırıyor. (Ie5213, b/247637434)
  • NavigationUI, seçilen bir MenuItem üzerinden gezinemediğinde artık günlükleri 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 uygulamanın başlangıçtaki performansını artırabilir. (Iab0ab)
  • Boş varsayılan bağımsız değişkenleri olan bir hedefe derin bağlantı oluşturduktan sonra yukarı gitmenin neden olduğu kilitlenme düzeltildi. (I51c24, b/243183636)

Bağımlılık Güncellemesi

  • Navigasyonun Dinamik Özellik Modülleri desteği artık ayrıntılı Play Feature Delivery Kitaplığı'na bağlıdır. (Ib4ddc)
  • Navigation Safe Args artık Android Gradle eklentisi 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 yayınlandı. 2.6.0-alpha03 sürümü bu taahhütleri içerir.

Hata Düzeltmeleri

  • Gezinme 2.5.3: NavHost, Crossfade için oluşturulacak bir hedef olmadığında artık NoSuchElementException hatasına neden olmayacak. Artık oluşturma işlemini atlar. (Ieb46e, b/253299416)
  • Gezinme 2.5.3: Bir hedef, eski yığından çıkarıldığında kaydedilen Oluşturma durumunun (ör. rememberSaveable kullanımları) unutulmamasına ve 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 yayınlandı. 2.6.0-alpha02 sürümü bu commit'leri içerir.

Davranış Değişiklikleri

  • Bir gezinme grafiğinin kimliğini AppBarConfiguration öğesine (ör. Menu aracılığıyla) iletirken NavigationUI artık grafikteki her hedefi yanlış bir şekilde üst düzey hedef olarak işaretlemek yerine yalnızca söz konusu gezinme grafiğinin başlangıç hedefini üst düzey hedef olarak kabul ediyor. Tek bir hedefin kimliğini iletme davranışı değişmez. 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 Fragment 1.5.2 sürümü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 yayınlandı. 2.6.0-alpha01 sürümü bu commit'leri içerir.

Yeni özellikler

  • NavigationUI uygulamasında üst uygulama çubuğuyla çalışmak için kullanılan setupWithNavController entegrasyonları, artık android:label uygulamanızda bulunan ReferenceType bağımsız değişkenleri için R.string değerlerini otomatik olarak oluşturulan kaynak tam sayısı yerine dize 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 yinelenen sorgu parametreleri destekleniyor. NavType artık ayrıştırılmış iki değeri birleştirmek için geçersiz kılınabilen varsayılan bir yöntem de içeriyor. (Id68c3, b/209977108)
  • Bir gezinme XML dosyasının etkinlik öğesindeki app:data ve app:dataPattern özelliklerinde yer tutucu olarak tam dize ${applicationId} kullanıldığında, yer tutucu, şişirme sırasında bağlamın packageName ile otomatik olarak doldurulur. (Iaabde, b/234223561)
  • navDeepLink Kotlin DSL'yi kullanarak boş bir NavDeepLink oluşturmaya çalışmak, artık derin bağlantının geçerli olması için URI, işlem ve/veya MIME türü gerektiğini belirten bir lint uyarısına neden olur. (I08d2f, b/154038883)

API Değişiklikleri

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

Davranış Değişiklikleri

  • NavBackStackEntry'nin arguments ve OnDestinationChangedListener öğesine iletilen arguments artık yalnızca hedefe gittiğinizde oluşturulan sabit 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şimlere yansıtılmaz. (I676f5)

Hata Düzeltmeleri

  • Gezinme 2.5.2: Dinamik Gezinme artık diğer modüllerdeki etkinlik hedeflerine gitmeden önce bunları düzgün bir şekilde yüklemeye çalışır. (Ia2c16, b/240292838)
  • Navigation 2.5.2: Navigation, aynı hedefe giderken ve launchSingleTop işaretini true olarak ayarlarken artık Fragment örneğini doğru şekilde değiştirecek. (I5a2f1, b/237374580)
  • Gezinme 2.5.2: Yeni bir pop-up başlangıç hedefiyle bir üst öğeyi paylaşan çift iç içe yerleştirilmiş grafiğe gidildiğinde ortaya çıkan IllegalStateException hatası 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 yayınlandı. 2.5.3 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • NavHost, Crossfade için oluşturulacak bir hedef olmadığında artık NoSuchElementException hatasına neden olmayacak. Artık oluşturma işlemini atlar. (Ieb46e, b/253299416)
  • Bir hedef, eski yığından çıkarıldığında kaydedilen Compose durumunun (ör. rememberSaveable kullanımları) unutulmaması ve kaldırılmaması sorunu düzeltildi. (I64949)

Sürüm 2.5.2

7 Eylül 2022

androidx.navigation:navigation-*:2.5.2 yayınlandı. 2.5.2 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Dinamik Gezinme artık etkinlik hedeflerine gitmeden önce bunları diğer modüllerden düzgün bir şekilde yüklemeye çalışıyor. (Ia2c16, b/240292838)
  • Navigation, aynı hedefe gidilirken ve launchSingleTop işareti true olarak ayarlanırken Fragment örneğini artık doğru şekilde değiştirecek. (I5a2f1, b/237374580)
  • Yeni bir pop-up başlangıç hedefiyle üst öğeyi paylaşan çift iç içe yerleştirilmiş bir grafiğe gidilmesinden kaynaklanan IllegalStateException 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 yayınlandı. 2.5.1 sürümü bu 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 desteğin sonlandırılması 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 yayınlandı. 2.5.0 sürümü bu commit'leri içerir.

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

  • CreationExtras Entegrasyonu: Navigation, artık Lifecycle 2.5.0'ın CreationExtras aracılığıyla durum bilgisiz ViewModelProvider.Factory sağlayabilir.

Navigation SafeArgs

  • Navigation Safe Args, Android Gradle Plugin bağımlılığını 7.0.4'ye bağlı olacak şekilde yükseltti ve 7.0'ten önceki AGP sürümleriyle uyumluluğu kaldırdı.
  • 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 uyarınca hedefi şu anda görünür olan tüm girişleri alma işlevi sunar.

Sürüm 2.5.0-rc02

15 Haziran 2022

androidx.navigation:navigation-*:2.5.0-rc02 yayınlandı. 2.5.0-rc02 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Navigation Compose NavHost kullanılırken alt hedefler arasında hızlı geçiş yapıldığında oluşan kilitlenme sorunu düzeltildi. (I3979a, b/234054916)
  • Navigation SafeArgs, applicationIdSuffix ve ad alanı kullanılırken applicationId yoksa veya applicationId ile ad alanı farklıysa artık kilitlenmeyecek. (I754b1, b/233119646)
  • NavArgument artık bağımsız değişkenin dahili değerlerini gösteren ö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 yayınlandı. 2.5.0-rc01 sürümü bu kayıtları içerir.

Yeni özellikler

  • navigation.xml dosyanızda <activity> öğelerinin içine <deeplink> öğeleri yerleştirilmesine karşı uyarıda bulunmak için yeni bir lint kuralı eklendi.(Ic15a5, b/178403185)

Hata Düzeltmeleri

  • NavHost ve DialogHost içindeki composable kapsamlar artık beklenen sırayla (yani iç composable'lar dış composable'lardan önce) siliniyor. (I157e6)
  • Navigation SafeArgs, önbelleğin yerinin değiştirilebilmesi için artık ArgumentsGenerationTask içinde PathSensitivity.RELATIVE kullanıyor. Bu, önbellek girişinin artık bir CI derlemesinden yerel derlemeye yeniden kullanılabileceği anlamına gelir. (I5f67c, b/173420454)
  • UnrememberedGetBackStackEntryDetector lint kuralı, getBackStackEntry() çağrısını çevreleyen remember çağrısının da anahtar olarak bir NavBackStackEntry nesnesi iletmesini sağlayacak şekilde güncellendi.(Ib7081, b/227382831)

Sürüm 2.5.0-beta01

20 Nisan 2022

androidx.navigation:navigation-*:2.5.0-beta01 yayınlandı. 2.5.0-beta01 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • DialogNavigator, dismiss() çağrısı yürütürken artık popWithTransition kullanıyor. Bu sayede, dialog hedefinde ViewModel kullanırken sistem geri düğmesini kullanarak veya iletişim kutusunun dışına dokunarak iletişim kutusunu kapattığınızda IllegalStateException hatasına neden olan yarışma durumu düzeltilir. (Id7376, b/226552301)

Bağımlılık Güncellemeleri

  • Gezinme artık Yaşam Döngüsü2.5.0-beta01'ne bağlıdır. Bu sayede, birden fazla eski yığın kullanılırken birincil olmayan bir alt gezinme sekmesinde bir NavHost, başka bir NavHost içine yerleştirildiğinde oluşan IllegalStateException düzeltilir.

Sürüm 2.5.0-alpha04

6 Nisan 2022

androidx.navigation:navigation-*:2.5.0-alpha04 yayınlandı. 2.5.0-alpha04 sürümü bu kayıtları içerir.

API Değişiklikleri

Hata Düzeltmeleri

  • NavHost artık hangi girişlerin oluşturulacağını belirlemek için NavController içindeki visibleEntries öğesine bağlıdır. Bu, iç içe yerleştirilmiş NavHost kullanıldığında içteki NavHost öğesinin artık düzgün bir ş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ş maksimum yaşam döngüsü durumunu temel alıyor. Bu, navController öğesinin ana makine yaşam döngüsü STARTED'ın altına düşse bile görünür girişlerin listesinin aynı kalacağı anlamına gelir. (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 parametresi içeren URI'leri ayrıştırabilir. (I0efe8, b/148905489)
  • Boş dize artık derin bağlantılarda geçerli bağımsız değişken olarak kabul ediliyor. (I70a0d, b/217399862)
  • Navigation Safe Args, ad alanları kullanılırken ve AndroidManifest.xml yokken artık kilitlenmeyecek. (I17ccf, b/227229815)

Sürüm 2.5.0-alpha03

23 Şubat 2022

androidx.navigation:navigation-*:2.5.0-alpha03 yayınlandı. 2.5.0-alpha03 sürümü bu kayıtları 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, ViewModel'ler oluşturmak için NavBackStackEntries ile kullanıldığında artık doğru şekilde çalışacak. (I69161, b/217617710)
  • Navigation Safe Args artık AndroidManifest'teki paket 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 yayınlandı. 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ırken artık OnBackPressedDispatcher değerini doğru şekilde ayarlayacak. (Ifbb51, b/214577959)
  • Gezinme 2.4.1: Birden fazla iç içe yerleştirilmiş NavGraph üzerinden derin bağlantı oluştururken eski yığın artık ara başlangıç hedeflerini doğru şekilde içerecek. (I504c0, b/214383060)

Sürüm 2.5.0-alpha01

26 Ocak 2022

androidx.navigation:navigation-*:2.5.0-alpha01 yayınlandı. 2.5.0-alpha01 sürümü bu commit'leri içerir.

Yeni özellikler

Hata Düzeltmeleri

  • Bir parçanın onCreate() yönteminden by navGraphViewModels() aracılığıyla oluşturulan bir ViewModel öğesine erişirken IllegalStateException hatasıyla başarısız olmasına neden olan sorun düzeltildi. (I8a14d)
  • NavDeepLink artık bağımsız değişkenlerin kodunu gereksiz yere iki kez çözmeyecek. Bu sayede, doğru bağımsız değişkenler nihai hedefinize 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, Navigation Safe Args'ın artık Android Studio'nun 7.0'dan önceki sürümleriyle uyumlu olmayacağı ancak Android Gradle eklentisi 7.1.0 ve sonraki sürümleriyle uyumlu olacağı anlamına gelir. (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 yayınlandı. 2.4.2 sürümü bu 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 yayınlandı. 2.4.1 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • NavHostFragment, iç içe yerleştirilmiş grafiklerle görünüm bağlama kullanılırken OnBackPressedDispatcher değerini artık doğru şekilde ayarlayacak. (Ifbb51, b/214577959)
  • İç içe yerleştirilmiş birden fazla NavGraph üzerinden derin bağlantı oluşturulduğunda eski yığın artık ara başlangıç hedeflerini doğru şekilde içerir. (I504c0, b/214383060)
  • Navigation 2.5.0-alpha01'dan geri taşındı: Bir Fragment'ın onCreate() öğesinden by navGraphViewModels() aracılığıyla oluşturulan bir ViewModel'e erişirken IllegalStateException hatasıyla başarısız olunmasına neden olan sorun düzeltildi. (I8a14d)
  • Gezinme 2.5.0-alpha01 sürümünden geriye doğru taşındı: NavDeepLinks artık bağımsız değişkenlerin kodunu gereksiz yere iki kez çözmüyor. Bu sayede, kodu doğru şekilde çözülen bağımsız değişkenler artık nihai hedefinize iletiliyor. (I31b0a, b/210711399)
  • Navigation 2.5.0-alpha01'dan geriye doğru taşındı: Safe Args artık Android Gradle eklentisi 7.0.4 sürümüne bağlıdır. Bu, Navigation Safe Args'ın artık Android Studio'nun 7.0'dan önceki sürümleriyle uyumlu olmayacağı ancak Android Gradle eklentisi 7.1.0 ve sonraki sürümleriyle uyumlu olduğu anlamına gelir. (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 yayınlandı. 2.4.0 sürümü bu commit'leri içerir.

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

  • Tüm Gezinme yapıları Kotlin'de yeniden yazıldı. Bu sayede, jenerik kullanan sınıfların (ör. NavType alt sınıfları) null değer alabilme özelliği iyileştirildi. Daha önce -ktx yapılarına ait olan tüm Kotlin uzantı işlevleri, ilgili ana yapılarına taşındı. -ktx yapıları yayınlanmaya devam edecek ancak tamamen boş olacak.
  • navigation-fragment yapısı artık yeni AbstractListDetailFragment aracılığıyla iki bölmeli 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ın sağladığı) ve uygulama olarak NavHostFragment kullanan bir ayrıntı penceresini yönetmek için SlidingPaneLayout kullanır.
  • NavController üzerindeki currentBackStackEntryAsFlow() yöntemi, mevcut NavBackStackEntry her değiştiğinde yayınlanan bir Flow sağlar. Bu akış, OnDestinationChangedListener'yi manuel olarak yönetmeye 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 imkanı sunuyor.
  • Artık özel NavType'lar oluşturmak için NavType sınıfını genişletebilirsiniz. Özel türler yalnızca gezinme grafiğinizi programatik olarak (ör. Gezinme Grafiği Kotlin DSL aracılığıyla) oluştururken desteklenir.
  • Gezinme artık özel NavigationUI'ın uygulanmasına yardımcı olmak için kullanılabilecek findStartDestination() ve getHierarchy() API'leri sağlar. findStartDestination(), NavGraph üzerinde bir uzantı işlevidir. startDestination, iç içe yerleştirilmiş bir NavGraph olsa bile grafiğe gittiğinizde gösterilecek gerçek başlangıç hedefini bulur. getHierarchy(), belirli bir hedefin başka bir hedefin hiyerarşisinde olup olmadığını doğrulamak için kullanılabilecek NavDestination üzerinde bir işlevdir.

    val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }
    
  • BottomNavigationView alan NavigationUI yöntemleri, Material 1.4.0, NavigationBarView'te sunulan üst sınıfını alacak şekilde güncellendi. Bu sayede, bu yöntemler NavigationRailView ile kullanılabilir.

  • XML aracılığıyla bir <action> öğesini genişletirken animasyon özellikleri, app:enterAnim="?attr/transitionEnter" söz dizimini kullanarak temanızdan alınan ö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

Gezinme'nin önceki sürümlerinde, her hedefin onu kardeş hedeflerinden benzersiz şekilde tanımlayacak ve doğrudan veya bir işlem aracılığıyla o hedefe navigate() yapmanıza olanak tanıyacak sabit bir tam sayı kimliği vardı. Bu yöntem, özellikle gezinme grafiğinizi XML'de tanımladığınız ve otomatik olarak oluşturulan R.id sabitlerini veya Safe Args'ı (derleme zamanında kod oluşturmak için bu sabitleri kullanır) kullanabileceğiniz durumlarda geçerli ve yararlı olmaya devam eder. Ancak bu benzersiz tam sayı sistemi, çalışma zamanında Navigation Kotlin DSL aracılığıyla programatik olarak oluşturulan tamamen dinamik grafikleri desteklemek için gereken semantik anlamı ve ifade gücünü yakalamadı.

Bu sürümde, gezinme grafiğindeki bir hedefi rotasına göre benzersiz şekilde tanımlamak için yeni bir seçenek sunulmaktadır. Rota, bir hedefe giden benzersiz yolu tanımlayan bir String nesnesidir. 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, ilgili hedefi tanımlayan bir Uri öğesinin "yol" kısmı olarak değerlendirilmelidir (ör. home, profile/{userId}, profile/{userId}/friends vb.). Bir hedefin kimliği belirli bir içerik parçasıyla ilişkilendirildiğinde bu dinamik bağımsız değişkenler, kapalı 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 sahiptir. Bu ülkeler arasında navigate(), popBackStack(), popUpTo() ve getBackStackEntry() yer alır.

Bu durumun API'lerle ilgili bazı sonuçları oldu:

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

Kimliğe göre gezinmenin aksine, rotaya göre gezinme kapalı derin bağlantılarla aynı kurallara uyar. Bu sayede, herhangi bir iç içe yerleştirilmiş grafikteki herhangi bir hedefe doğrudan gidebilir ve bu rotaların, her hedefe harici olarak görünen bir derin bağlantı eklemeden çok modüllü projelerde kullanılabilmesini sağlayabilirsiniz.

Navigation Compose

navigation-compose yapısı, Gezinme Bileşeni ile Jetpack Compose arasında entegrasyon sağlar. Uygulamanızda hedef olarak @Composable işlevlerini kullanır.

Bu sürümde sunulanlar:

  • composable ve dialog hedeflerini kullanarak Kotlin DSL aracılığıyla gezinme grafiğinizi oluşturmanıza olanak tanıyan NavHost composable. Ayrıca Accompanist Navigation Material gibi isteğe bağlı Gezginler için de destek sunar.
  • Hedefler arasında geçiş için zorunlu destek. Accompanist Navigation Animation, deneysel Compose API'lerini kullanarak giriş ve çıkış geçişlerini kontrol etmek için kullanılabilir.
  • Her birleştirilebilir hedefe bir Lifecycle kapsamı belirleme. 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.
  • Hedef düzeyinde ViewModel kapsamı (Lifecycle ViewModel Compose 2.4.0'un viewModel() API'si veya Hilt Navigation Compose 1.0.0'un hiltViewModel() API'si aracılığıyla), yapılandırma değişikliklerinden etkilenmeyen ve eski yığında bulunan bir kapsam (aksi takdirde Composable içeriğiniz silinir) ve ViewModel'in onCleared() öğesinde bu NavBackStackEntry ile ilişkili durumun kalıcı olarak silindiğini ve temizlendiğini belirten bir sinyal sağlar.
  • rememberSaveable durumunun kapsamını hedef düzeyinde belirleyerek tüm composable durumlarının kaydedilmesini ve bir hedefe döndüğünüzde otomatik olarak geri yüklenmesini sağlar.
  • İşlem sonlandırma ve yeniden oluşturma işleminden sonra NavController ve hedefinin durumunu kaydetme ve geri yükleme için tam destek.
  • Sistem 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.

  • Durumun yukarı taşınmasına ve NavController öğesinin NavHost dışındaki composable'lara (ör. alt gezinme çubuğu) bağlanmasına olanak tanımak için rememberNavController() ve currentBackStackEntryAsState() içinde Compose'a özel yardımcılar.

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'da gezinme kılavuzuna bakın.

Birden fazla eski yığın

NavController, hedeflerin eski yığınını yönetmekten, navigate() yaptığınızda hedefleri eski yığına eklemekten ve popBackStack() yöntemini ç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'indeki <action> öğelerine entegrasyon, eski yığının kaydedilmesini ve geri yüklenmesini destekleyecek şekilde genişletildi.

Bu değişiklik kapsamında, onNavDestinationSelected(), BottomNavigationView.setupWithNavController() ve NavigationView.setupWithNavController()'nin NavigationUI yöntemleri artık çıkarılan hedeflerin durumunu otomatik olarak kaydedip geri yükleyerek herhangi bir kod değişikliği olmadan birden fazla eski yığın için destek sağlar. Parçalarla gezinme kullanılırken birden fazla eski yığınla entegrasyon için önerilen yöntem budur.

Durumu kaydetmek ve geri yüklemek için kullanılan temel API'ler, çeşitli yüzeyler aracılığıyla gösterilir:

  • Gezinme XML'inde <action> öğesi, app:popUpTo aracılığıyla açılan tüm hedeflerin durumunu kaydetmek ve app:destination olarak iletilen hedefle ilişkili durumu geri yüklemek için artık app:popUpToSaveState ve app:restoreState boole özelliklerini kullanabilir:

    <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 setRestoreState() ve ek bir saveState parametresi alan setPopUpTo() için 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 programatik çağrılar artık ek bir saveState parametresi içerebilir.

  • popBackStack() veya popUpToSaveState ile kaydedilen durumları temizlemek için clearBackStack() yöntemini kullanabilirsiniz.

Her durumda NavController, gezinme hedefi kapsamındaki ViewModel örnekleri de dahil olmak üzere her NavBackStackEntry öğesinin durumunu kaydedip geri yükler. Navigator API'leri, her Navigator'nin kendi durumunu kaydetmeyi ve geri yüklemeyi desteklemesini sağlayacak şekilde güncellendi.

Davranış değişiklikleri

  • NavDeepLinkBuilder artık createPendingIntent() tarafından döndürülen PendingIntent değerine PendingIntent.FLAG_IMMUTABLE ekleyerek bu API'nin Android 12'yi hedeflerken beklendiği gibi çalışmasını sağlıyor.
  • Navigasyon artık Lifecycle 2.3.1'a bağlıdır ve NavBackStackEntry Lifecycle'ı güncelleyen setGraph(), popBackStack(), navigateUp() ve navigate() yöntemlerini @MainThread olarak işaretler. Böylece Navigasyon, Lifecycle 2.3.0'da sunulan ana iş parçacığı zorunlu kılma özelliğiyle 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 mevcut olduğunu doğrular.
  • NavDeepLink ayrıştırılmış bağımsız değişkenler artık yol segmentleri arasında ayırıcı olarak soru işaretleriyle aynı şekilde diyez işaretlerini dikkate alarak bağımsız değişkenin diyez işaretini kapsamasını önler.
  • İşlem oluştururken Safe Args'tan oluşturulan Kotlin kodu, artık varsayılan değerleri olmayan bağımsız değişkenleri, varsayılan değerleri olan bağımsız değişkenlerden önce parametre olarak yerleştirir.
  • Safe Args, bağımsız değişken oluştururken artık varsayılan değerleri olmayan parametreleri varsayılan değerleri olan parametrelerden önce yerleştirir.
  • Safe-Args artık Android Gradle eklentisi 4.2.0'a bağlıdır. Bu durumda, applicationIdTextResource kullanılıyor uyarısını artık görmezsiniz.

Bilinen sorunlar

  • Navigation 2.5.0-alpha01 sürümünde düzeltildi: Bir Fragment'ın onCreate() öğesinden by navGraphViewModels() aracılığıyla oluşturulan bir ViewModel öğesine erişim, IllegalStateException ile başarısız olur. (b/213504272)
  • Navigation 2.5.0-alpha01'da düzeltildi: Safe Args 2.4.0, Android Gradle eklentisi 7.1.0 ve sonraki sürümlerle uyumlu değil. (b/213086135)
  • Birden fazla iç içe yerleştirilmiş gezinme grafiği içeren derin bağlantılar, tam geri yığını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 yayınlandı. 2.4.0-rc01 sürümü bu kayıtları içerir.

Davranış değişiklikleri

  • NavDeepLink ayrıştırılmış bağımsız değişkenleri 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ır. (I21309, b/180042703)

Hata Düzeltmeleri

  • Derin bağlantılar, yer tutucunun adıyla aynı değerlere sahip bağımsız değişkenleri artık 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ıldığında gösterilen hata mesajı, artık varsa başlangıç hedefinin rotasını varsayılan olarak kullanacak. (I86b9d, b/208041894)

Navigation Compose Hata Düzeltmeleri

  • Alt gezinme menüsü öğelerini kullanarak başlangıç hedefi ile başka bir hedef arasında hızlı geçiş yapmanın neden olduğu olası kilitlenme düzeltildi. (Ic8976, b/208887901)
  • İletişim kutusu hedefi, yapılandırma değişikliklerinden veya işlem sonlandırmadan sonra ekranın üst kısmında düzgün şekilde geri yükleniyor. (I4c0dc, b/207386169)
  • İletişim kutusu kapatıldığında, iletişim kutusunun NavBackStackEntry öğesinden ViewModel alma girişiminin başarısız olmasına neden olan sorun düzeltildi. (I6b96d, b/206465487)
  • Navigation Compose'un NavHost özelliğiyle activity hedefleri kullanılırken sonsuz yeniden oluşturma işlemine neden olan bir sorun düzeltildi. (I8f64c)
  • Navigation Compose'da, yapılandırma değişikliği veya işlem sonlandırma sonrasında eski etkinliğin referansını tuttuğu bir sızıntı düzeltildi. (I4efcb, b/204905432)

Safe Args Hata Düzeltmeleri

  • SafeArgs, işlem sonlandırmadan sonra özel parcelable dizileri geri yüklemeye çalışırken artık kilitlenmiyor. (I618e8, b/207315994)
  • Safe Args'te, Boole dizilerinin null değerine sahip olmasına izin vermeyen bir hata düzeltildi. (I8c396, b/174787525)

Sürüm 2.4.0-beta02

3 Kasım 2021

androidx.navigation:navigation-*:2.4.0-beta02 yayınlandı. 2.4.0-beta02 sürümü bu kayıtları içerir.

API Değişiklikleri

  • Hem açık hem de kapalı derin bağlantıların işlenmesi, artık başka bir grafiğe giderken saveState işaretini otomatik olarak ekler. Böylece NavigationUI.setupWithNavController gibi kodların ve birden fazla eski yığın kullanan kodların beklendiği gibi çalışması sağlanır. (Ic8807)

Davranış Değişiklikleri

  • Derin bağlantı kalıpları artık şişirme sırasında değil, NavDeepLink'te geç derlenir. Bu sayede, derin bağlantılar içeren gezinme grafiklerinin şişirme süresi kısalır. (b8d257, b/184149935)

Hata Düzeltmeleri

  • NavHost doğrudan etkinliğin setContent() öğesine eklendiğinde, Lifecycle.State.STARTED durumuna geçtikten sonra NavBackStackEntries'in Lifecycle.State.CREATED durumuna düşürülmesine neden olan sorun düzeltildi. (Ia5ac1, b/203536683)
  • İletişim kutusu gösterilmeden önce eski yığından bir DialogFragment hedefi çıkarıldığında iletişim kutusunun kapatılmamasına ve hatalı iletişim kutusu kullanıcı tarafından manuel olarak kapatıldığında kilitlenmeye neden olan bir yarışma durumu düzeltildi. (I687e5)
  • NavigationUI üzerinde onNavDestinationSelected API'sinin, ilgili gezinme grafiğine navigate() yapmasanız bile true döndürmesine neden olan sorun düzeltildi. Artık setupWithNavController tarafından dahili olarak kullanılan aynı mantığı kullanarak, hedefin hierarchy değerini kullanarak yalnızca mevcut hedefle ilişkili MenuItem değerini seçer. (I2b053)

Sürüm 2.4.0-beta01

27 Ekim 2021

androidx.navigation:navigation-*:2.4.0-beta01 yayınlandı. 2.4.0-beta01 sürümü bu commit'leri içerir.

Yeni özellikler

  • Artık Navigation Kotlin DSL'nin parçalarla kullanımını daha iyi desteklemek için kimlik kullanmak yerine rota ile by navGraphViewModel kullanabilirsiniz. (I901e3, b/201446416)

API Değişiklikleri

  • visibleEntries API artık deneyseldir. (I93f6f)

Hata Düzeltmeleri

  • Geçişler aynı ekranlar arasında ileri ve geri gezinerek kesintiye uğradığında ViewModel'ler artık yok edilmeyecek (Id52d8, b/200817333).
  • NavDestination'lere derin bağlantı eklerken null değer alabilen NavDeepLink bağımsız değişkenleri için artık varsayılan değer gerekmiyor. (I5aad4, b/201320030)
  • Farklı yaşam döngülerine sahip NavBackStackEntry'ler artık eşit kabul edilmiyor. Bu, NavHost'un singleTop ile gezinme yaparken ve alt menü öğelerini yeniden seçerken tüm hedefleri doğru ş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'nin durumuyla doğru şekilde senkronize kalıyor. Bu, DialogFragment için eşzamansız dismiss() API'sini manuel olarak çağırmanın, kapatılan iletişim kutusunun üzerindeki tüm iletişim kutusu hedeflerini düzgün bir şekilde temizlediği anlamına gelir. Bu durum, iletişim kutunuzu kapatmak için popUpTo veya popBackStack() kullandığınız durumları etkilemez. (I77ba2)
  • AbstractAppBarOnDestinationChangedListener, onDestinationChanged() için artık 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 yayınlandı. 2.4.0-alpha10 sürümü bu kayıtları içerir.

Yeni özellikler

  • NavController artık visibleEntries StateFlow (Ia964e) aracılığıyla görünür tüm NavBackStackEntry örneklerinin listesini alma imkanı sunuyor.
  • rememberNavController() artık isteğe bağlı bir Navigator örneği kümesi alır. Bu örnekler, Accompanist Navigation Material gibi isteğe bağlı Gezginleri daha iyi desteklemek için döndürülen NavController öğesine eklenir. (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önüldükten sonra ortaya çıkan, sistem geri düğmesiyle ilgili bir 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ında oluşturuyor. (I824a8, b/200059831)

Sürüm 2.4.0-alpha09

15 Eylül 2021

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

Yeni özellikler

  • Artık popBackStack() veya popUpToSaveState ile kaydedilen durumları temizlemek için clearBackStack() yöntemini kullanabilirsiniz. (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ç grafiğine otomatik olarak eklenir. (I8a470, b/182545357)

API Değişiklikleri

  • navArgument Kotlin DSL işlevi artık navigation-compose yerine navigation-common kapsamında yer alıyor. Bu işlevi kullanmaya devam etmek için içe aktarma işlemlerini güncellemeniz gerekir. (I1d095)

Davranış Değişiklikleri

  • Safe Args, bağımsız değişken oluştururken artık varsayılan değerleri olmayan parametreleri varsayılan değerleri olan parametrelerden önce yerleştirir. (I89709, b/198493585)

Hata Düzeltmeleri

  • Navigation Compose kullanılırken NavGraph'ler 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 için artık varsayılan değer gerekmez. (Ia14ef, b/198689811)
  • setGraph(), yeni bir grafikle çağrıldığında artık eski yığını açma şeklindeki önceki davranışına ek olarak kaydedilen eski yığınları da temizleyecek. (I97f96)
  • launchSingleTop kullanılırken OnDestinationChangedListener örneklerinin ve currentBackStackEntryFlow'nin bilgilendirilmemesine neden olan sorun 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 yayınlandı. 2.4.0-alpha08 sürümü bu kayıtları içerir.

Yeni özellikler

  • Artık özel NavType'lar oluşturmak için NavType sınıfını genişletebilirsiniz. Özel türler yalnızca gezinme grafiğinizi programatik olarak (ör. Gezinme Grafiği Kotlin DSL aracılığıyla) oluştururken desteklenir. (I78440, b/196871885)

Davranış Değişiklikleri

  • İşlem oluştururken Safe Args'tan oluşturulan Kotlin kodu, artık varsayılan değerleri olmayan bağımsız değişkenleri, varsayılan değerleri olan bağımsız değişkenlerden önce parametre olarak yerleştirir. (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 mevcut olduğunu doğrular. (#204, b/185527157)

Hata Düzeltmeleri

  • getBackStackEntry ve previousBackStackEntry, remember() ile birlikte composable() içinde kullanıldığında artık eski yığında hedef olmaması nedeniyle istisnaya neden olmayacak. (I75138, b/194313238)
  • Navigation Compose, eski yığın bağımsız değişkenlerini değiştirirken ve launchSingleTop=true kullanırken artık düzgün şekilde yeniden oluşturuluyor. (Iebd69, b/186392337)
  • 13 veya 29 hedef içeren bir grafikle setGraph çağrıldığında artık ArrayIndexOutOfBoundsException oluşmayacak. (I1a9f1, b/195171984)
  • SafeArgs Java oluşturucu, Args sınıfları oluştururken artık lint uyarılarına neden olmayacak. (I1a666, b/185843837)

Harici Katkı

  • Derin bağlantıların, gerekli tüm bağımsız değişkenlerin (varsayılan değerleri olmayanlar) Uri içinde mevcut olduğunu doğrulamasını sağladığı için ospixd'ye 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 yayınlandı. 2.4.0-alpha07 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Navigation Compose, yapılandırma değişikliklerinden sonra ve birden fazla eski yığın özelliğini kullanırken grafikleri değiştirirken durumu artık düzgün bir şekilde kaydediyor. (If5a3d, b/195141957)
  • Birden fazla eski yığınla gezinme oluşturma kullanılırken aynı sekmenin yeniden seçilmesi artık boş bir ekranla sonuçlanmayacak. (I860dc, b/194925622)
  • NavHost artık NavBackStackEntry'lerin Lifecycle.State değerindeki değişiklikleri gözlemliyor. Bu sayede, bir parçada NavHost kullanıldığında boş ekran yerine yaşam döngüsü değiştikçe düzgün bir şekilde yeniden oluşturulacak. (I4eb85, b/195864489)
  • Etkinliğinizi yeniden oluşturduktan sonra (ör. yapılandırma değişikliğinden sonra) DialogFragment kapatıldığında NavController durumunun doğru şekilde güncellenmemesine neden olan sorun düzeltildi. (Icd72b)
  • İletişim kutusu hedefinin kaldırılması, NavController'ın sistem geri düğmesi işleme özelliğini güncellemiyordu. Bu durum, NavController'ın kaldırılacak bir eski yığını olmasa bile geri düğmesini engellemesine neden olabiliyordu. Bu sorun düzeltildi. (If3b34)
  • Safe-args artık bağımsız değişkenler için otomatik olarak bir toSavedStateHandle yöntemi 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 yayınlandı. 2.4.0-alpha06 sürümü bu 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 hedefin Lifecycle değeri artık yalnızca animasyon tamamlandığında RESUMED değerine ulaşacak. (If0543, b/172112072, b/194301889)
  • Navigation Compose'un NavHost öğesi artık grafiği ilk oluşturmanın bir parçası olarak ayarlıyor. (Ieb7be)

Hata Düzeltmeleri

  • Bir gezinme grafiğinin son hedefini kaldırmak artık ClassCastException hatasına neden olmaz. (If0543, b/172112072, b/194301889)
  • Uri olmadan derin bağlantı eklerken ve bir rota veya derin bağlantı üzerinden gezinirken oluşan NullPointerException düzeltildi. (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 ve NavController'ın, açılacak bir eski yığını olmamasına rağmen geri düğmesini engellemesine neden olabilen sorun düzeltildi. (aosp/1782668)

Sürüm 2.4.0-alpha05

21 Temmuz 2021

androidx.navigation:navigation-*:2.4.0-alpha05 yayınlandı. 2.4.0-alpha05 sürümü bu kayıtları içerir.

Davranış Değişiklikleri

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

Hata Düzeltmeleri

  • NavController'ın durumunda yapılan yeniden giriş güncellemeleri nedeniyle, NavBackStackEntry öğesine ekli bir LifecycleObserver içinden popBackStack() çağrılırken oluşan NoSuchElementException düzeltildi. (I64621)
  • AbstractListDetailFragment, AbstractListDetailFragment kullanılmadığında SlidingPaneLayout öğesinin APK'nızdan tamamen kaldırılmasına olanak tanır. (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 edilecek. (I166eb, b/175392262)

Sürüm 2.4.0-alpha04

1 Temmuz 2021

androidx.navigation:navigation-*:2.4.0-alpha04 yayınlandı. 2.4.0-alpha04 sürümü bu kayıtları içerir.

Yeni özellikler

  • navigation-fragment yapısı artık yeni AbstractListDetailFragment aracılığıyla iki bölmeli 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ın sağladığı) ve uygulama olarak NavHostFragment kullanan bir ayrıntı penceresini yönetmek için SlidingPaneLayout kullanır. (Iac4be, b/191276636)
  • navigation-compose yapısının NavHost özelliği artık composable hedefin yanı sıra dialog hedefi de destekliyor. Bu iletişim kutusu hedeflerinin her biri, mevcut composable hedefinin üzerinde yüzen 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 mevcut tüm çağrıların push() olarak değiştirilmesi gerekir. (Ie89fc, b/172112072)
  • Özel Navigator örnekleri artık bir hedefi eşzamansız olarak eklemek veya kaldırmak için NavigatorState üzerinde pushWithTransaction ve popWithTransition API'lerini kullanabilir. Bu API'lerin henüz dahil edilen navigasyon araçlarından herhangi biri tarafından kullanılmadığını unutmayın. (Ic4d7c, b/172112072)

Davranış Değişiklikleri

  • NavDeepLinkBuilder artık createPendingIntent() tarafından döndürülen PendingIntent değerine PendingIntent.FLAG_IMMUTABLE ekleyerek bu API'nin Android 12'yi hedeflerken beklendiği gibi çalışmasını sağlıyor. (If8c52)

Hata Düzeltmeleri

  • Grafiğe iletilen bağımsız değişkenlerin, dinamik olarak dahil edilen grafiğe doğru şekilde iletilmemesine neden olan <include-dynamic> ile ilgili sorun düzeltildi. (I3e115)
  • Varsayılan değeri @null olan bir string[] bağımsız değişkeni kullanarak bir hedefe giderken oluşan NullPointerException düzeltildi. (I1fbe8)
  • @Navigator.Name için ProGuard kuralları eklenerek R8 3.1 tam modu kullanılırken karşılaşılan sorunlar düzeltildi. (I2add9, b/191654433)
  • SafeArgs, uygulamanızı 1.5.0 sürümünden önceki Kotlin sürümleriyle derlerken artık hata vermeyecek. (Icd1ff, b/190739257)

Sürüm 2.4.0-alpha03

16 Haziran 2021

androidx.navigation:navigation-*:2.4.0-alpha03 yayınlandı. 2.4.0-alpha03 sürümü bu kayıtları içerir.

Hata Düzeltmeleri

  • Dahil edilen bir dinamik grafiğe gitmek için iki navigate() çağrısının yapılmasına neden olan sorun düzeltildi. (I7785c, b/188859835)
  • Navigation 2.4.0-alpha01'da, üst düzey bir hedefteyken setupActionBarWithNavController()'nin Yukarı simgesini düzgün şekilde kaldırmamasına neden olan bir gerileme düzeltildi. (I5d443, b/189868637)
  • NavController'ın kök grafiği daha önce çıkarıldıktan sonra popBackStack() çağrılırken oluşan IllegalStateException düzeltildi. (I2a330, b/190265699)
  • by navArgs() için ProGuard kuralları artık navigation-common veya buna bağlı herhangi bir yapı kullanılırken düzgün şekilde uygulanıyor. (I68800, b/190082521)
  • İlk kez geri çağırma aldığında navigate() işlevini çağıran bir OnDestinationChangedListener, artık gittiği hedefle birlikte ikinci bir geri çağırma alır. (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ı olması nedeniyle 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. Gradle 7.0'ı kullanacak şekilde güncelleme yaparak bu sorunu çözebilirsiniz. (b/190739257)

Sürüm 2.4.0-alpha02

2 Haziran 2021

androidx.navigation:navigation-*:2.4.0-alpha02 yayınlandı. 2.4.0-alpha02 sürümü bu kayıtları içerir.

Yeni özellikler

  • Rotalar artık Etkinlik, Parça ve İletişim Kutusu hedeflerinin yanı sıra DynamicNavigation Kotlin DSL'de de destekleniyor. (Ib5544, Ia617b, I22f96, b/188914648, b/188901565)
  • NavigationUI, durumunuzun kaydedilmesini devre dışı bırakmanıza olanak tanımak için geçici olarak deneysel API'ler ekledi. Durumun her zaman kaydedilmesi doğru davranış olsa da, durumu kaydederken desteklenemeyen, desteği sonlandırılmış kitaplıklar (ör.saklanan parçalar) hâlâ kullanılmaktadır. Bu nedenle, uygulamalar desteklenmeyen API'lerden yavaş yavaş uzaklaşabilir. (Idf93c)
  • Navigasyon artık özel NavigationUI'ın uygulanmasına yardımcı olmak için kullanılabilecek findDestination() ve getHierarchy() API'leri sağlar. findDestination(), grafikte bir hedef bulacak NavGraph üzerinde bir uzantı işlevidir. getHierarchy(), belirli bir hedefin başka bir hedefin hiyerarşisinde olup olmadığını doğrulamak için kullanılabilecek NavDestination üzerinde bir işlevdir.(I2932f, b/188183365)

    val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }
    
  • BottomNavigationView alan NavigationUI yöntemleri, Material 1.4.0, NavigationBarView'de sunulan üst sınıfını alacak şekilde güncellendi. Bu sayede, bu yöntemler NavigationRailView ile kullanılabilir. (Ib0b36, b/182938895)

  • XML aracılığıyla bir <action> öğesini şişirirken animasyon özellikleri, app:enterAnim="?attr/transitionEnter" söz dizimini kullanarak temanızdan alınan özellikleri kullanabilir. (I07bc1, b/178291654)

API Değişiklikleri

  • Kimlik kullanan Kotlin DSL oluşturucular kullanımdan kaldırıldı ve bunların yerine rota kullanan oluşturucular kullanılmalıdır (I85b42, b/188816479) (I9f58f, b/188816479).

Hata Düzeltmeleri

  • DialogFragmentNavigator artık bir iletişim kutusu, sistem geri düğmesine basılarak veya iletişim kutusunun dışı tıklanarak kapatıldığında NavController öğesini bilgilendirmek için NavigatorState.pop() API'sini kullanıyor. Böylece NavController durumu her zaman Navigator'ın durumuyla senkronize oluyor. (I2ead9)
  • onDestinationChanged geri çağırma işlevinden OnDestinationChangedListeners listesini değiştirirken gezinme artık ConcurrentModificationException hatası vermiyor. (Ib1707, b/188860458)

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

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

  • findNode için 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, applicationIdTextResource kullanılıyor uyarısını artık görmezsiniz. (I6d67b, b/172824579)

Sürüm 2.4.0-alpha01

18 Mayıs 2021

androidx.navigation:navigation-*:2.4.0-alpha01 yayınlandı. 2.4.0-alpha01 sürümü bu taahhütleri içerir.

Yeni özellikler

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

Birden fazla eski yığın

NavController, hedeflerin eski yığınını yönetmekten, navigate() yaptığınızda hedefleri eski yığına eklemekten ve popBackStack() yöntemini ç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'indeki <action> girişlerine entegrasyon, eski yığının kaydedilmesini ve geri yüklenmesini destekleyecek şekilde genişletildi. (b/80029773)

Bu değişiklik kapsamında, onNavDestinationSelected(), BottomNavigationView.setupWithNavController() ve NavigationView.setupWithNavController()'nin NavigationUI yöntemleri artık çıkarılan hedeflerin durumunu otomatik olarak kaydedip geri yükleyerek herhangi bir kod değişikliği olmadan birden fazla eski yığın için destek sağlar. Parçalarla gezinme kullanılırken birden fazla eski yığınla entegrasyon için önerilen yöntem budur. (Ie07ca)

Durumu kaydetmek ve geri yüklemek için kullanılan temel API'ler, çeşitli yüzeyler aracılığıyla gösterilir:

  • Gezinme XML'inde <action> öğesi, app:popUpTo aracılığıyla açılan tüm hedeflerin durumunu kaydetmek ve app:destination olarak iletilen hedefle ilişkili durumu geri yüklemek için artık app:popUpToSaveState ve app:restoreState boole özelliklerini kullanabilir:

    <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 setRestoreState() ve ek bir saveState parametresi alan setPopUpTo() için 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 programatik çağrılar artık ek bir saveState parametresi içerebilir.

Her durumda NavController, gezinme hedefi kapsamındaki ViewModel örnekleri de dahil olmak üzere her NavBackStackEntry öğesinin durumunu kaydedip geri yükler. Navigator API'leri, her Navigator'nin kendi durumunu kaydetmeyi ve geri yüklemeyi desteklemesini sağlayacak şekilde güncellendi.

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

Navigasyon 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 sunar. (b/172823546)

Eskiden yalnızca kimlik alan tüm API'lerde artık rota String alan bir aşırı yükleme var. Bu ülkeler arasında navigate(), popBackStack(), popUpTo() ve getBackStackEntry() yer alır.

Bu durumun API'lerle ilgili bazı sonuçları oldu:

  • Kotlin DSL'deki popUpTo Kotlin özelliğinin desteği sonlandırıldı ve yerine popUpToId getirildi. (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 sürümüne yükseltme yapan geliştiriciler için bu, uzantı yöntemlerindeki aşağıdaki içe aktarma işlemlerinin 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şkeni, NavDestination üzerinde route özelliğiyle değiştirildi. Bu sayede navBackStackEntry.destination.route işlevini doğrudan çağırabilirsiniz.

API Değişiklikleri

  • Tüm Gezinme yapıları Kotlin'de yeniden yazıldı. Bu sayede, jenerik kullanan sınıfların (ör. NavType alt sınıfları) null değer alabilme özelliği iyileştirildi. Daha önce -ktx yapılarına ait olan tüm Kotlin uzantı işlevleri, ilgili ana yapılarına taşındı. -ktx yapıları yayınlanmaya devam edecek ancak tamamen boş olacak. (b/184292145)
  • NavDeepLinkBuilder artık oluşturulan eski yığına birden fazla farklı hedef eklemeyi destekliyor. (I3ee0d, b/147913689)
  • DynamicNavHostFragment için fabrika işlevleri ekleyin (Icd515, b/175222619)
  • NavBackStackEntry için benzersiz kimlik, artık herkese açık API'sinin bir parçası olarak gösteriliyor. (Ie033a)
  • NamedNavArgument öğesinin name ve argument alanları ile imha işlevleri artık herkese açık. (#174, b/181320559)
  • İlgili oluşturma 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 1.8.0'e 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 ve NavBackStackEntry Lifecycle'ı güncelleyen setGraph(), popBackStack(), navigateUp() ve navigate() yöntemlerini @MainThread olarak işaretler. Böylece Navigasyon, Lifecycle 2.3.0'da sunulan ana iş parçacığı zorunlu kılma özelliğiyle uyumlu hale gelir. (b/171125856)
  • Derin bağlantılardan Enum bağımsız değişkenlerini ayrıştırma işlemi artık büyük/küçük harfe duyarlı değildir. Bu sayede, http://www.example.com/red gibi bir derin bağlantı, enum RED değerine sahip olsa bile www.example.com/{color} derin bağlantısıyla eşleşebilir. (#152, b/135857840)

Compose uyumluluğu

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

Hata Düzeltmeleri

  • Sondaki bağımsız değişken yer tutucularının, eşleşen tam bir son eki olan derin bağlantılara göre ö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 Navigator'ları destekliyor. (Ib1c2c, b/175979140)
  • Aynı örnekle tekrar tekrar çağrıldığında sorun yaşanmaması için NavigatorProvider#addNavigator işlevinin davranışı iyileştirildi. (#176, b/187443146)

Harici Katkılar

  • Her NavArgs sınıfı için bir fromSavedStateHandle() yöntemi oluşturan Safe Args desteğini geliştirdiği için simonschiller'a teşekkür ederiz. (#122, b/136967621)
  • Derin bağlantılardan Enum bağımsız değişkenlerini ayrıştırmayı 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, eşleşen tam bir son eki olan derin bağlantılara göre öncelikli olmasına neden olan sorunu düzelttiği için osipxd'ye teşekkür ederiz. (#153, b/184072811)
  • Safe Args'ı KotlinPoet 1.8.0'e bağlı olacak şekilde güncellediği için tatocaster'a teşekkür ederiz. (#172, b/183990444)
  • name ve argument alanlarını ve NamedNavArgument'nin yapı sökme işlevlerini herkese açık hale getirdiği için jossiwolf'a teşekkür ederiz. (#174, b/181320559)
  • İlgili oluşturma yerellerine NavBackStackEntry sağlayan yeni bir NavBackStackEntry#provideToCompositionLocals uzantısı sunduğu için jossiwolf'a teşekkür ederiz. (#175, b/187229439)
  • Aynı örnekle tekrar tekrar çağrıldığında sorunlara neden olmaması için NavigatorProvider#addNavigator davranışını iyileştiren 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 yayınlandı. 1.0.0-alpha10 sürümü bu kayıtları içerir.

API Değişiklikleri

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

Hata Düzeltmeleri

  • NavHost artık OnBackPressedDispatcherOwner bulunamadığında bile çalışıyor. NavHost önizlemesi yapılırken bu durum geçerlidir. (I7d8b4)
  • Navigation Compose artık Navigation 2.3.5'a bağlıdır. Bu sayede, NavHost hedefinde BackHandler kullanılırken karşılaşılan sorun düzeltilmiştir. (I7e63b, b/182284739)

Sürüm 1.0.0-alpha09

10 Mart 2021

androidx.navigation:navigation-compose:1.0.0-alpha09 yayınlandı. 1.0.0-alpha09 sürümü bu kayıtları içerir.

API Değişiklikleri

  • LocalViewModelStoreOwner.current artık geçerli oluşturmada ViewModelStoreOwner olup olmadığını daha iyi belirlemek için null değer alabilen ViewModelStoreOwner döndürüyor. viewModel() ve NavHost gibi ViewModelStoreOwner gerektiren API'ler, ViewModelStoreOwner ayarlanmamışsa istisna oluşturmaya devam eder. (Idf39a)

Hata Düzeltmeleri

  • Navigation Compose artık grafik ayarlandıktan sonra aynı ViewModelStore nesnesini ayarlama girişimine yönelik düzeltmeyi içeren Navigation 2.3.4'e bağlıdır. (I65c24, b/177825470)

Sürüm 1.0.0-alpha08

24 Şubat 2021

androidx.navigation:navigation-compose:1.0.0-alpha08 yayınlandı. 1.0.0-alpha08 sürümü şu taahhütleri içerir:

Yeni özellikler

  • NavHost artık LocalSavedStateRegistryOwner CompositionLocal'ı bu hedefin NavBackStackEntry ile doldurarak doğrudan SavedStateRegistry içine kaydedilen tüm durumların hedefle birlikte kaydedilip geri yüklenmesini sağlar. (I435d7, b/179469431)

Sürüm 1.0.0-alpha07

10 Şubat 2021

androidx.navigation:navigation-compose:1.0.0-alpha07 yayınlandı. 1.0.0-alpha07 sürümü bu kayıtları 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 yayınlandı. 1.0.0-alpha06 sürümü şu taahhütleri 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 yayınlandı. 1.0.0-alpha05 sürümü bu kayıtları 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 yayınlandı. 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 yayınlandı. 1.0.0-alpha03 sürümü bu kayıtları 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() öğelerinin ç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 yayınlandı. 1.0.0-alpha02 sürümü bu kayıtları 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 parametreleri listesinde rotadan önce geliyor (Ie620e)
  • Artık NavHost composable'ının dışında bir başlangıç hedefi olarak rotayı kullanarak grafik oluşturabilirsiniz. (Iceb75)

Sürüm 1.0.0-alpha01

28 Ekim 2020

android.navigation:navigation-compose:1.0.0-alpha01 yayınlandı. 1.0.0-alpha01 sürümü bu kayıtları içerir.

Yeni özellikler

navigation-compose yapısı, Gezinme Bileşeni ile Jetpack Compose arasında entegrasyon sağlar. Uygulamanızda hedef olarak @Composable işlevlerini kullanır.

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

  • Kotlin DSL aracılığıyla gezinme grafiğinizi oluşturmanıza olanak tanıyan bir NavHost composable.
  • Yaşam döngüsü, ViewModel ve hatırlanan durumun hedef düzeyinde kapsamı.
  • Sistem 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.
  • Durumun yukarı taşınmasına ve NavController öğesinin NavHost dışındaki composable'lara (ör. alt gezinme çubuğu) bağlanmasına olanak tanımak için rememberNavController() ve currentBackStackEntryAsState() içinde Compose'a özel yardımcılar.

Daha fazla bilgi için Compose'da gezinme 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 yayınlandı. 2.3.5 sürümü bu 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 intent'i alarak hedefteki Uri, işlem ve MIME türüne erişebilirsiniz. Bu, harici derin bağlantı için zaten mevcut olan işlevi yansıtır. (I975c3, b/181521877)

Hata Düzeltmeleri

  • NavBackStackEntry, LifecycleOwner olarak ayarlanmış bir dağıtıcıya eklenen OnBackPressedCallbacks, etkinlik yaşam döngüsü STOPPED ve ardından STARTED olduğunda geri düğmesine basma işlemini artık 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ı olduğunu unutmayın. (#144, b/153829033)
  • Bir hedefin null değer alabilen birden fazla varsayılan bağımsız değişkeni olduğunda ve bu bağımsız değişkenlerin yalnızca bir alt kümesini geçersiz kılarak ilgili hedefe gittiğinizde ortaya çıkabilen 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ı

  • Derin bağlantı alan adı ayrıştırmayı büyük/küçük harfe duyarlı hale getiren pull isteği için bentrengrove'e 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 yayınlandı. 2.3.4 sürümü bu commit'leri içerir.

Yeni özellikler

  • ReferenceType bağımsız değişkenleri artık derin bağlantı URI'sinin bir parçası olarak gönderildiğinde doğru şekilde ayrıştırılabilir. Bu, hem ham tam sayı değerini hem de 0x ön ekine sahip 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 tam sayı varsayılan değerlerini destekliyor. Bu sayede, 0.0 yerine android:defaultValue="0" kullanabilirsiniz. (#117, b/173766247)

Hata Düzeltmeleri

  • Navigasyon'un dinamik özellikler desteği kullanılırken yükleme işleminin takılması sorunu düzeltildi. (Ib27a7, b/169636207)
  • Daha önce ayarlanmış olan aynı nesneyle setViewModelStore veya setLifecycleOwner çağrısı yapmak artık işlem yapmayacak (Idf491, b/177825470)
  • Safe-Args artık Java kullanırken uygun yöntemlere gizleme ek açıklamaları ekliyor. (I8fbc5, b/179463137)

Harici Katkılar

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

Sürüm 2.3.3

Sürüm 2.3.3

27 Ocak 2021

androidx.navigation:navigation-*:2.3.3 yayınlandı. 2.3.3 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • NavBackStackEntry, Lifecycle öğesi CREATED öğesine taşınmadan önce açıldığında artık kilitlenme yaşanmıyor. (Ie3ba3)
  • b/171364502 nedeniyle oluşan ve animasyon kaynak değeri 0 olan bir etkinliğe gidildiğinde ResourceNotFoundException hatasına yol açan gerileme düzeltildi. (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 yayınlandı. 2.3.2 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • NavigationUI sürümünde, onNavDestinationSelected ile <activity> hedefi kullanıldığında etkinliğe gidilememesine neden olan bir gerileme düzeltildi. (I22e34, b/171364502)
  • navigation-dynamic-features-fragment işleminin, yeni yüklenen hedefe birden çok kez gidilmesine neden olduğu 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 eski yığında yeni bir grafik örneği oluşturulmamasına neden olan sorun düzeltildi. (Ifc831)
  • Gezinme grafiğindeki son hedefi kaldıran bir popUpTo ile navigate() kullanıldığında gezinme grafiğinin hemen imha edilip eski yığından kaldırılmamasına neden olan sorun düzeltildi. (I910a3)
  • Navigation SafeArgs artık Kotlin'in açık API modu için destek ekleyen KotlinPoet 1.7.2 sürümünü kullanıyor. (I918b5)
  • NavHostFragment.findNavController(Fragment), Fragment hiyerarşisi ve Fragment'ın görünüm hiyerarşisiyle ilgili mevcut kontrollerin yanı sıra artık 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 yayınlandı. 2.3.1 sürümü bu commit'leri içerir.

Yeni özellikler

  • Varsayılan Animator kaynakları, Gezinme kullanıcı arayüzüne eklenmiştir ve varsayılan animasyon kaynakları yerine kullanılması önerilir. (b/167430145)
  • NavOptions artık hashcode ve equals yöntemlerini geçersiz kılıyor (b/161586466)
  • Gezinme artık "No destination with ID" IllegalArgumentException'da mevcut hedefi içeriyor. Bu sayede geliştiricilerin hata ayıklama deneyimi iyileştirilecek. (b/168311416)

Hata Düzeltmeleri

  • Safe Args, oluşturulan bağımsız değişken sınıfı adı 100 karakterden uzun olsa bile 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ırken bile çekmeceyi açabilir. (b/162253907)
  • Safe Args artık KotlinPoet 1.6.0'a bağlıdır (aosp/1435911).
  • Safe Args artık AGP 4.0.1'e bağlıdır (aosp/1442337).

Sürüm 2.3.0

Sürüm 2.3.0

24 Haziran 2020

androidx.navigation:navigation-*:2.3.0 yayınlandı. 2.3.0 sürümü bu commit'leri içerir.

2.2.0 sürümünden sonra 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 özellik modüllerinin yüklenmesini gerektiği gibi 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 Navigasyonu test etme bölümüne bakın.
  • 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 az miktarda kaydedilmiş durumu depolamaya uygun bir SavedStateHandle öğesine erişmenize olanak tanır. Daha fazla bilgi için Önceki hedefe sonuç döndürme bölümüne bakın.
  • Openable için NavigationUI desteği: NavigationUI içindeki tüm DrawerLayout kullanımları, CustomView 1.1.0'a eklenen ve DrawerLayout 1.1.0'ta 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 işlemine ek olarak app:action ve app:mimeType işlemlerini de destekleyecek şekilde genişletildi. NavController artık yeni NavDeepLinkRequest sınıfı aracılığıyla bu alanların herhangi bir kombinasyonuna göre 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 sunulmamaktadı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 yayınlandı. 2.3.0-rc01 sürümü bu 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 NullPointerException sorunu düzeltildi. (b/158006669)
  • NavController tarafından oluşturulan tüm destination is unknown istisnaları artık NavController durumunu belirlemeye yardımcı olacak ek hata ayıklama bilgileri içeriyor. (b/157764916)

Sürüm 2.3.0-beta01

20 Mayıs 2020

androidx.navigation:navigation-*:2.3.0-beta01 yayınlandı. 2.3.0-beta01 sürümü bu kayıtları 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)
  • setGraph() çağrılmadan önce kaydedilen OnDestinationChangedListener örnekleri, işlem sonlandırmadan sonra geri yüklenen hedefe artık düzgün ş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 yayınlandı. (2.3.0-alpha06 sürümü bu commit'leri içerir.)

Yeni özellikler

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

API Değişiklikleri

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

Hata Düzeltmeleri

  • İç içe yerleştirilmiş bir başlangıç hedefi kullanılırken derin bağlantı Intent'lerinin 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 yayınlandı. 2.3.0-alpha05 sürümü bu commit'leri içerir.

Yeni özellikler

  • <include-dynamic> kullanan dinamik grafik eklemeleri için artık app:graphPackage belirtmeniz gerekmez. Noktadan sonra applicationId öğesine moduleName son eki eklenerek varsayılan bir grafik kullanılır. graphPackage öğenizi özelleştirmeniz gerekiyorsa artık ${applicationId} yer tutucusu desteklenmektedir. (b/152696768)
  • Gezinme grafiği Kotlin DSL, artık işlemler için defaultArguments Map sunarak gezinme XML dosyalarındaki <action> öğelerinde varsayılan değerler ayarlama özelliğini yansıtır. (b/150345605)

Hata Düzeltmeleri

  • Navigation 2.2.2 sürümünden itibaren: Etkinliğinizde birden fazla NavHostFragment örneği varken grafiğinizin başlangıç hedefine derin bağlantı oluşturulduğunda ortaya çıkan IllegalStateException 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 yayınlandı. 2.3.0-alpha04 sürümü bu kayıtları içerir.

Yeni özellikler

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

API Değişiklikleri

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

Hata Düzeltmeleri

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

Bağımlılık Güncellemeleri

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

Sürüm 2.3.0-alpha03

4 Mart 2020

androidx.navigation:navigation-*:2.3.0-alpha03 yayınlandı. 2.3.0-alpha03 sürümü bu kayıtları içerir.

API Değişiklikleri

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

Hata Düzeltmeleri

  • navigation-common-ktx ProGuard kuralları artık tüm NavArgs örnekleri yerine yalnızca kullanılan NavArgs sınıflarını doğru şekilde saklar. (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ğlı. Bu sayede, Navigasyon Core 1.2.0'daki yeni API'lere bağlı olmadığında geliştiriciler daha yeni bir bağımlılığa geçmek zorunda kalmayacak.

Sürüm 2.3.0-alpha02

19 Şubat 2020

androidx.navigation:navigation-*:2.3.0-alpha02 yayınlandı. 2.3.0-alpha02 sürümü bu kayıtları içerir.

Yeni özellikler

  • NavBackStackEntry artık belirli bir eski yığın girişiyle ilişkilendirilmesi gereken az miktarda kaydedilmiş durumu depolamaya uygun bir SavedStateHandle öğesine erişmenize olanak tanır. Örnek kullanım alanı için Sonuç döndürme bölümüne bakın. (b/79672220)

API Değişiklikleri

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

Hata Düzeltmeleri

  • navigateUp() artık uygulamanızı kendi görev yığınında 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 yayınlandı. 2.3.0-alpha01 sürümü şu commit'leri içerir.

Yeni özellikler

  • Yeni navigation-testing yapısı, bir TestNavHostController sınıfı sağlar. Bu sınıf, gezinme test edilirken sahte bir NavController kullanmaya alternatif sunar. Bu sayede, mevcut hedefi ayarlayabilir ve gezinme işlemlerinden sonra eski yığını doğrulayabilirsiniz. (b/140884273)
  • Yeni navigation-dynamic-features-fragment (ve geçişli bağımlılığı navigation-dynamic-features-runtime), özellik modüllerinden hedefleri veya tüm gezinme grafiklerini (<include-dynamic> aracılığıyla) dahil etmenize olanak tanır. Böylece, bu hedeflere giderken 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 içermeyen derin bağlantılar, artık sorgu parametrelerini sondaki {argument} öğelerine eklemek veya derin bağlantıyla eşleştirmemek yerine doğru şekilde yoksayıyor. (b/147447512)
  • Navigation 2.2.1 sürümünden itibaren: DrawerArrowDrawable için navigation-ui ProGuard kuralları, android.enableJetifier=true öğesinin gerekli olmamasını sağlayacak şekilde 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ınlandı. 2.2.2 sürümü bu commit'leri içerir.

Hata Düzeltmeleri

  • Etkinliğinizde birden fazla NavHostFragment örneği varken grafiğinizin başlangıç hedefine derin bağlantı oluşturulduğunda ortaya çıkan IllegalStateException düzeltildi. (b/147378752)
  • NavigationUI artık boş etiketleri (ör. android:label=”” içeren bir hedef) yok saymı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 yayınlanmıştı. (b/148679860)
  • navigation-common-ktx ProGuard kuralları artık tüm NavArgs örnekleri yerine yalnızca kullanılan NavArgs sınıflarını doğru şekilde saklar. Bu özellik daha önce Navigation 2.3.0-alpha03 sürümünde 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 yayınlandı. 2.2.1 sürümü bu 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ştirmemek yerine doğru şekilde yoksayıyor. (b/147447512)
  • DrawerArrowDrawable için navigation-ui ProGuard kuralları, android.enableJetifier=true gerekli olmayacak şekilde 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 yayınlandı. 2.2.0 sürümü bu commit'leri içerir.

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

  • NavBackStackEntry: Artık eski yığındaki bir hedefin veya gezinme grafiğinin kimliğini ileterek NavController.getBackStackEntry() yöntemini çağırabilirsiniz. Döndürülen NavBackStackEntry, hedefi başlatmak için kullanılan bağımsız değişkenleri sağlamanın yanı sıra gezinme odaklı LifecycleOwner, ViewModelStoreOwner (NavController.getViewModelStoreOwner() tarafından döndürülenle aynı) ve SavedStateRegistryOwner sağlar.
  • Yaşam Döngüsü ViewModel SavedState Entegrasyonu: SavedStateViewModelFactory, by navGraphViewModels() veya ViewModelProvider oluşturucuyu NavController.getBackStackEntry() ya da NavController.getViewModelStoreOwner() tarafından döndürülen bir ViewModelStoreOwner ile kullanırken artık varsayılan fabrika olarak kullanılmaktadır.
  • Derin bağlantılar için sorgu parametresi desteği: Sorgu parametreleri içeren derin bağlantılar artık yeniden sıralanan sorgu parametrelerini destekler. Varsayılan değeri olan veya null değer alabilen bağımsız değişkenler artık derin bağlantılar eşleştirilirken isteğe bağlıdır.
  • İyileştirilmiş Animasyon Desteği: NavHostFragment artık Fragment 1.2.0'dan FragmentContainerView kullanıyor. Bu sayede animasyon z sıralaması sorunları ve Fragment'lara gönderilen pencere ekleri düzeltiliyor.

Sürüm 2.2.0-rc04

18 Aralık 2019

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

Hata düzeltmeleri

  • navigation-ui tarafından kullanılan varsayılan karartma animasyonları, Fragment 1.2.0-rc04'teki ayarlanmış karartma animasyonlarıyla eşleşecek şekilde ayarlandı. (b/145769814)

Sürüm 2.2.0-rc03

4 Aralık 2019

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

Hata düzeltmeleri

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

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

  • Gezinme 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'a bağlıdır.

Sürüm 2.2.0-rc02

7 Kasım 2019

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

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

  • Gezinme artık androidx.lifecycle 2.2.0-rc02'e 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 bu yana 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 yayınlandı. 2.2.0-beta01 sürümü şu commit'leri içerir.

Yeni özellikler

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

Davranış değişiklikleri

  • Derin bağlantılar eşleştirilirken ek sorgu parametreleri artık eşleşmenin başarısız olmasına neden olmak yerine yoksayılır. (b/141482822)

Hata düzeltmeleri

  • Sorgu parametreleri de belirtildiğinde derin bağlantı yolundaki bağımsız değişkenlerin yoksayılmasına neden olan sorun düzeltildi. (b/141505755)
  • Activity üzerindeki navArgs() Kotlin uzantısı artık ek öğe 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ırken NavigationUI, iki üst düzey hedef arasında geçiş yaparken metin değişikliğini artık animasyonlu olarak göstermez. (b/140848160)

Sürüm 2.2.0-alpha03

18 Eylül 2019

androidx.navigation:navigation-*:2.2.0-alpha03 yayınlandı. 2.2.0-alpha03 sürümü bu kayıtları içerir.

Davranış değişiklikleri

  • setGraph çağrıldıktan sonra setViewModelStore() çağrıldığında artık IllegalStateException hatası veriliyor. Tüm NavBackStackEntry örneklerinin ViewModel örnekleri için tutarlı bir depolama alanına sahip olmasını sağlamak amacıyla bu ayar, ilk kurulumun bir parçası olarak her zaman NavHost tarafından yapılmalıdır. (aosp/1111821)

Hata düzeltmeleri

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

Sürüm 2.2.0-alpha02

5 Eylül 2019

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

Yeni özellikler

  • Sorgu parametreleri içeren derin bağlantılar artık yeniden sıralanan sorgu parametrelerini destekliyor. Varsayılan değere sahip veya null değer alabilen bağımsız değişkenler artık derin bağlantılar eşleştirilirken isteğe bağlıdır. (b/133273839)
  • Artık eski yığındaki bir hedefin veya gezinme grafiğinin kimliğini ileterek NavController.getBackStackEntry() yöntemini çağırabilirsiniz. Döndürülen NavBackStackEntry, hedefi başlatmak için kullanılan bağımsız değişkenleri sağlamanın yanı sıra gezinme odaklı LifecycleOwner, ViewModelStoreOwner (NavController.getViewModelStoreOwner() tarafından döndürülenle aynı) ve SavedStateRegistryOwner sağlar. (aosp/1101691, aosp/1101710)

Hata düzeltmeleri

  • ViewPager2 için NavHostFragment ekleme işleminin IllegalArgumentException ile başarısız olmasına neden olan bir sorun düzeltildi. (b/133640271)
  • NavInflater artık getResourceName() yöntemini gereksiz yere çağırmıyor. Bu sayede, şişirme süresi %40'a kadar hızlanıyor. (b/139213740)

Sürüm 2.2.0-alpha01

7 Ağustos 2019

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

Yeni özellikler

  • SavedStateViewModelFactory, by navGraphViewModels() veya ViewModelProvider oluşturucuyu NavController.getViewModelStoreOwner() tarafından döndürülen bir ViewModelStoreOwner ile kullanırken kullanılan varsayılan fabrika oldu. (b/135716331)

API değişiklikleri

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

Hata düzeltmeleri

  • NavHostFragment artık FragmentContainerView kullanıyor. Bu sayede animasyon z sıralaması sorunları ve Fragment'lara gönderilen pencere ekleri 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 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

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

  • ViewModel'leri gezinme grafiği kapsamına alma: Artık -ktx kitaplıklarını kullanan Kotlin kullanıcıları için by navGraphViewModels() özellik temsilcisini veya NavController'e eklenen getViewModelStoreOwner() API'sini kullanarak gezinme grafiği düzeyinde kapsama alınan ViewModel'ler oluşturabilirsiniz. Daha fazla bilgi için Hedefler arasında kullanıcı arayüzüyle ilgili verileri paylaşma başlıklı makaleyi inceleyin.
  • İletişim kutusu hedefleri: Artık navigate yaptığınızda DialogFragment gösterecek <dialog> hedefleri oluşturabilirsiniz. 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 bir hedefe eklediğiniz <deepLink> öğesini kullanarak o hedefe gitmek için Uri ile navigate yapabilirsiniz. Daha fazla bilgi için URI kullanarak gezinme başlıklı makaleyi inceleyin.
  • NavHostController: Özel bir NavHost oluşturmak için özel olarak 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 yayınlandı. 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 üzerinde desteği sonlandırılan getViewModelStore() API'si kaldırıldı. (aosp/1091021)

Sürüm 2.1.0-beta02

19 Temmuz 2019

androidx.navigation:*:2.1.0-beta02 yayınlandı. 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 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Yeni özellikler

  • NavigationUI, setupWithNavController()'i Toolbar veya CollapsingToolbarLayout ile kullanırken Yukarı düğmesinin kaldırılmasını animasyonlu hale getirir. (b/131403621)

Hata düzeltmeleri

  • findNavController() ile aynı kapsayıcıya sahip birden fazla NavHostFragment kullanıldığında ortaya çıkan zamanlama sorunu düzeltildi. (b/136021571)

Sürüm 2.1.0-alpha06

2 Temmuz 2019

androidx.navigation:*:2.1.0-alpha06 yayınlandı. 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 yapısına 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, ViewModelStoreOwner döndüren yeni getViewModelStoreOwner() yöntemi lehine sonlandırıldı. (aosp/987010)
  • <dialog> hedefleri gibi kayan pencere hedeflerinin uygulanması, artık tüm <dialog> hedeflerinin uyguladığı bir işaretleyici arayüzü (FloatingWindow) olarak genelleştirildi. Üst uygulama çubuğuyla etkileşim kurmak için kullanılan NavigationUI yöntemleri artık FloatingWindow hedeflerini yoksayıyor. (b/133600763)

Davranış değişiklikleri

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

Hata düzeltmeleri

  • Navigasyon artık derin bağlantı işlenirken etkinliği yeniden oluşturma sırasında gerçekleşen animasyonu bastırarak görsel bir parlamayı düzeltiyor. (b/130362979)
  • İlk parça eklenirken bir parçanın çıkarılması durumunda gezinme eski yığınının senkronizasyonunun bozulmasına neden olan hata düzeltildi. (b/133832218)

Sürüm 2.1.0-alpha05

5 Haziran 2019

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

API değişiklikleri

  • NavController ile ilgili barındırma API'leri yeniden adlandırıldı ve NavController'nin yeni bir alt sınıfı olan NavHostController sınıfına taşındı. (aosp/966091)
  • NavController setHostOnBackPressedDispatcherOwner() yöntemi, NavHostController'nin setOnBackPressedDispatcher() yöntemiyle değiştirildi ve artık çağrılmadan önce setLifecycleOwner() yöntemini çağırmanız gerekiyor. (aosp/965409)
  • NavHostController artık daha önce setHostOnBackPressedDispatcherOwner() tarafından 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 gezinme sonrasında eski yığının doğru olmamasıyla ilgili sorun düzeltildi. (b/132509387)
  • NavController tarafından otomatik olarak işlenen derin bağlantılar artık yalnızca bir kez tetiklenir. (b/132754763)

Sürüm 2.1.0-alpha04

16 Mayıs 2019

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

Hata düzeltmeleri

  • NavHostFragment, sistem geri düğmesi etkinliklerini kesintiye uğratırken app:defaultNavHost değerini doğru şekilde dikkate alır ve Gezinme 2.1.0-alpha03'deki bir gerilemeyi düzeltir. 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 yayınlandı. Bu sürüme dahil edilen commit'leri burada bulabilirsiniz.

Bilinen Sorunlar

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

Yeni özellikler

  • Artık navigate yaptığınızda DialogFragment gösterecek <dialog> hedef oluşturabilirsiniz. NavHostFragment, varsayılan olarak iletişim kutusu hedeflerini destekler. b/80267254
  • navigate yöntemini bir kaynak kimliği veya NavDirections örneğiyle çağırmanın yanı sıra artık doğru hedefe gitmek için bir hedefe eklediğiniz <deepLink> öğesini kullanan Uri aracılığıyla da gezinebilirsiniz. b/110412864

Davranış değişiklikleri

  • NavigationUI tarafından sağlanan varsayılan animasyonlar, etkinliklerin ve parçaların varsayılan animasyon hızına uyacak şekilde 400 ms'den 220 ms'ye hızlandırıldı. b/130055522

API değişiklikleri

  • NavHostFragment sınıfının createFragmentNavigator() yöntemi kullanımdan kaldırıldı ve işlevi yeni onCreateNavController() yöntemine taşındı. Böylece, NavHostFragment sınıfının alt sınıfını oluştururken özel Gezginler eklemek için doğru giriş noktasının bu olduğu daha net bir şekilde belirtildi. b/122802849
  • NavDestination sınıfına, belirli bir Uri öğesinin ilgili hedef tarafından veya NavGraph söz konusu olduğunda gezinme grafiğindeki herhangi bir hedef tarafından işlenip işlenemeyeceğini kontrol etmenize olanak tanıyan 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 sistem geri etkinliklerini yakalıyor. Böylece bir parçaya geri dönerken parça yaşam döngüsü yöntemlerinde koşullu gezinme yaparken karşılaşılan sorun düzeltildi. b/111598096
  • Safe Args için, belirtilmemiş bir app:argType içeren android:defaultValue=”@null” artık düzgün bir şekilde string bağımsız değişkeni olarak yorumlanıyor. b/129629192

Sürüm 2.1.0-alpha02

3 Nisan 2019

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

Yeni özellikler

  • Artık Kotlin kullanıcıları için by navGraphViewModels() özellik temsilcisi aracılığıyla veya NavController öğesine eklenen getViewModelStore() API'yi kullanarak gezinme grafiği düzeyinde kapsamlı 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}" desteklenir. b/110975456

Hata düzeltmeleri

  • <activity> hedefleri için android:name, artık şişirme sırasında bir sınıfa 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, Navigasyon'un 2.1.0 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'e bağlıdır. Bu sürümde androidx.legacy:legacy-support-core-utils:1.0.0 bağımlılığı da kaldırılmıştır. b/128632612

API Değişiklikleri

  • Kaynak kimliği ve Bundle ile tıklama dinleyici 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'ları örneklendirmek için FragmentFactory kullanıyor. b/119054429

Hata Düzeltmeleri

  • Navigasyon, bir hedefe eklenmiş bağımsız değişkenler olduğunda artık boş bir Bundle göndermiyor. Bu sayede, android:defaultValue="@null" kullanılırken karşılaşılan bir sorun düzeltildi. b/128531879
  • Safe Args artık KotlinPoet 1.1.0'a bağlıdır ve son derece 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

Navigasyon 2.0.0, 2.0.0-rc02 sürümünden 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 sağlar 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ışıyla aynıdır ve 1.0.0-rc02'den güncelleme yapmak için kodunuzda değişiklik yapmanız gerekmez. Bağımlılıklarınızı yeni bağımlılıklarla eşleşecek şekilde güncellemeniz yeterlidir.

Navigation'ın 2.X sürümlerini kullanmak için projenizin AndroidX'e taşınmış olması gerekir. Navigation 1.0 kararlı sürümü, Destek Kitaplığı bağımlılıklarını kullanan son sürüm olacaktır. 1.0'dan sonraki tüm geliştirmeler AndroidX'i temel alacak ve 2.0 kararlı sürümünü temel alacaktır.

AndroidX Öncesi Bağımlılıklar

AndroidX öncesi Gezinme 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 üst düzey build.gradle dosyanıza 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

Navigasyon 1.0.0, 1.0.0-rc02 sürümünden 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ü için ikinci sürüm adayıdır. Bu sürümde çeşitli hata düzeltmeleri yapıldı.

Hata Düzeltmeleri

  • Kök grafiğin kimliği yoksa popBackStack() öğesinin yoksayılmasına neden olan sorun düzeltildi b/126251695
  • navigateUp(), FLAG_ACTIVITY_NEW_TASK olmadan bir derin bağlantıyı işledikten sonra çağrıldığında artık 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 R sınıfıyla ilişkili paket adındaki in ve fun gibi Kotlin anahtar kelimelerini düzgün bir ş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 bir sürüm adayıdır. Bu sürümde bir hata düzeltmesi yapılmıştır.

Hata Düzeltmeleri

  • Parçalar ve singleTop gezinme işlemleri kullanılırken karşılaşılan bir 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 yapıldı.

Yeni özellikler

  • Artık reference bağımsız değişkenleri için 0'i 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ılara göre önceliklidir. b/123969518

Hata Düzeltmeleri

  • popBackStack() ve navigateUp, eski yığındaki son hedefi çıkarırken artık false değerini doğru şekilde döndürüyor. Böylece 1.0.0-beta01 sürümünde ortaya çıkan bir gerileme düzeltildi. b/123933201
  • Gezinme, kaydedilen örnek durumunun geri yüklenmesi sırasında ClassLoader değerini doğru şekilde ayarlayarak Navigator kaydedilen durumunda veya NavDestination öğesine gönderilen bağımsız değişkenlerde özel sınıflar kullanılırken sorun yaşanmasını önler. b/123893858
  • Safe Args tarafından oluşturulan NavArgs sınıfları, kaydedilen örnek durumundan bir Parcelable[] bağımsız değişkenini geri yüklerken artık kilitlenmiyor. b/123963545
  • Safe Args artık gereksiz şekilde oluşturulan Kotlin sınıflarını düzgün bir şekilde temizliyor. b/124120883

Sürüm 1.0.0-beta01

4 Şubat 2019

Bu, Navigasyon'un ilk beta sürümüdür. Navigasyon API'sinin, kritik bir sorun olmadığı sürece bir sonraki sürüme kadar kararlı kalması beklenir. Bu sürümde bazı hata düzeltmeleri ve davranış değişiklikleri yapıldı.

Davranış değişiklikleri

  • Gezinme artık bağımsız değişken varsayılan değerlerinin çalışma zamanında ve Safe Args aracılığıyla aynı şekilde ele alınmasını sağlar. Sonuç olarak, yalnızca app:argType="reference" içeren bağımsız değişkenler başka bir kaynağı işaret eden varsayılan değere sahip olabilir (ör. @color/colorPrimary). Farklı bir app:argType ile referans varsayılan değer kullanmaya çalışmak, gezinme XML'i ayrıştırılırken 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 eklentisinin tüm sürümlerindeki kitaplık ve özellik modüllerinde kullanılabilir. b/121304903
  • Tek bir popBackStack() işleminin, bir seferde yalnızca tek bir hedef yerine bir hedefin tüm kopyalarını eski yığının en üstünden çıkarmasına neden olan bir gerileme düzeltildi. b/123552990
  • FragmentNavigator durumunun NavController durumuyla senkronizasyonunun bozulmasına ve eski yığın geri yüklenmeye çalışılırken IllegalStateException hatasına neden olan sorun düzeltildi. b/123803044
  • ProGuard, kod karartma ile kullanıldığında NavigationUI tarafından işlenen geri okunun görünmemesine neden olan sorun düzeltildi. b/123449431
  • Safe Args tarafından oluşturulan kod artık .OuterClass$InnerClass biçiminde statik bir iç sınıfa işaret eden app:argType kullanımını doğru ş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, Safe Args ile ilgili bir sorunu düzelten 1.0.0-alpha10 sürümünün 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() özellik temsilcisini kullanarak bir Activity veya Fragment içinde Safe Args tarafından oluşturulan bir NavArgs sınıfına referans alabilir. b/122603367
  • Safe Args artık androidx.navigation.safeargs.kotlin eklentisini uygulayarak Kotlin kodu oluşturmanıza olanak tanıyor. Kotlin kodu, ö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 sabit sınıflar kullanılarak yalnızca Kotlin modülleri için özel olarak oluşturulur. b/110263087

Davranış Değişiklikleri

  • Eşleşen derin bağlantılar artık en çok eşleşen bağımsız değişkene sahip derin bağlantıya yöneliktir. b/118393029
  • NavController üzerinde setGraph() çağrısı yapıldığında artık eski yığın sıfırlanacak. b/111450672
  • Bilinmeyen derin bağlantılar artık IllegalStateException hatası vermiyor, ancak yoksayılıyor. Böylece iç içe yerleştirilmiş veya birden fazla NavHostFragment ile ilgili sorunlar düzeltiliyor. b/121340440

Zarar Veren Değişiklikler

  • Bir etkinliğe pop animasyonları uygulamak için kullanılan NavOptions.applyPopAnimationsToPendingTransition() yöntemi ActivityNavigator yöntemine taşındı. b/122413117
  • Safe Args artık bağımsız değişken içermeyen işlemler için aynı sınıfları kopyalamı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ının artık herkese açık bir kurucusu yok. Yalnızca oluşturulan statik yöntemlerle etkileşim kurmanız gerekir. b/123031660
  • Safe Args tarafından oluşturulan NavDirections sınıflarının artık herkese açık bir kurucusu yok. 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() tarafından 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 işlemini artık doğru şekilde işliyor. b/120042732
  • NavController, iç içe yerleştirilmiş NavHostFragment veya eski yığın içeren diğer alt Fragment'lar kullanılırken popBackStack() işlemlerini artık doğru şekilde işliyor. b/122770335
  • NavigationUI, Yukarı düğmesinin içerik açıklamasını artık doğru şekilde ayarlıyor. b/120395362
  • Safe Args tarafından oluşturulan Directions sınıfları, artık bir hedefteki işlemle aynı kimliğe sahip genel işlemleri doğru şekilde işliyor. b/122962504
  • Safe Args tarafından oluşturulan NavDirections sınıfları, equals() doğru değerini döndürdüğünde artık doğru şekilde eşit hashCode() değerlerine sahip. b/123043662
  • NavHostFragment'nin FragmentManager öğesinde özel FragmentTransactions yapmaya çalışırsanız FragmentNavigator artık daha iyi bir hata mesajı gösterir. 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 yapısını geliştirmeye devam etmeme kararı aldık. NavController için dahili testlerde 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 Tek Etkinlik konuşmasında ayrıntılı olarak ele alınmıştır. Gezinme ile test etme konusunda ek dokümanlar üzerinde çalışacağız.

Yeni özellikler

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

Zarar Veren Değişiklikler

  • argType="reference" ile <argument> kullanıldığında Navigasyon artık referansı ayrıştırmaz, bunun yerine ham kaynak kimliğini sağlar. b/111736515
  • onNavDestinationSelected() artık varsayılan olarak gezinme grafiğinizin başlangıç hedefine geri dönerek setup yöntemleriyle tutarlı hale geliyor. Eski yığının açılmasını önlemek için menuCategory="secondary" öğesini MenuItem uygulamanıza ekleyin. aosp/852869
  • Oluşturulan Args sınıflarının fromBundle() yöntemleri artık null değer alabilen Bundle yerine null değer almayan Bundle kullanı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 uyumludur. 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

  • Hedef etiketleri, NavigationUI yöntemleriyle kullanıldığında artık android:label uygulamanızdaki {argName} örneklerini otomatik olarak doğru bağımsız değişkenle 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 bunlarla ilişkili yöntemler kaldırıldı. Tüm hedefleri eski yığından kaldırmak için grafiğinizin köküyle app:popUpTo kullanın. b/119628354
  • ActivityNavigator.Extras artık bir Builder kalıbı kullanıyor ve herhangi bir Intent.FLAG_ACTIVITY_ işaretini 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 yapıldı. 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
  • Fragment oluşturma işlemi FragmentNavigator sınıfına taşındı. Böylece Fragment oluşturma işlemini bir FragmentFactory sınıfına devretmek daha kolay hale geldi. b/119054429
  • NavGraphNavigator için oluşturucu artık Context almıyor aosp/835340
  • NavigatorProvider artık bir arayüz değil, sınıftır. getNavigatorProvider() tarafından döndürülen NavigatorProvider işlevinde değişiklik yapılmadı. aosp/830660
  • NavDestination.navigate() kaldırıldı. Bunun yerine Navigator üzerinde navigate() yöntemini çağırın. aosp/830663
  • Navigator önemli ölçüde yeniden düzenlendi. OnNavigatorNavigatedListener ihtiyacı ortadan kalktı ve bunun yerine navigate, gidilen NavDestination değerini döndürüyor.
  • Navigator örnekleri artık NavController için pop etkinlikleri gönderemez. Geri düğmesine basma işlemlerini yakalamak ve navController.popBackStack() yöntemini çağırmak için OnBackPressedCallback kullanabilirsiniz. aosp/833716

Hata Düzeltmeleri

  • popUpTo, hedef bir <navigation> öğesi olduğunda artık tutarlı bir şekilde çalışıyor b/116831650
  • İç içe yerleştirilmiş grafikler kullanılırken IllegalArgumentException hatasına neden olan bir dizi hata 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şkenleri dolduracak b/120161365

Safe Args

  • Safe Args, Enum değerleri de dahil olmak üzere Serializable nesneleri destekler. Enum türleri, sınıf adı olmadan enum değişmezi kullanılarak 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 hedefler olarak kabul edileceğini özelleştirmenize olanak tanır. Ayrıntılar için güncellenmiş belgelere bakı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şaretleri 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ğımlıdır. API, Kotlin kurallarıyla daha tutarlı olacak şekilde değiştirildi ancak Java'da yazılan testler için kullanmaya devam edebilirsiniz.
  • Meta veri manifestine kayıtlı 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 Gezginler kullanılırken yapılandırma değişikliklerinden sonra meydana gelen kilitlenme 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 talimatlar oluşturulabilir. b/117407555
  • <include> grafiği için yol tarifi oluşturmayla ilgili bir sorun düzeltildi. b/116542123

Sürüm 1.0.0-alpha06

20 Eylül 2018

Yeni özellikler

API Değişiklikleri

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

Hata Düzeltmeleri

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

Safe Args

  • Navigasyon hedefi Directions sınıfları artık varsa üst Directions sınıfını genişletiyor b/79871405
  • Directions ve Args sınıfları artık kullanışlı 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() yöntemindeki bir hata düzeltildi. b/111450897
  • Safe Args'deki bir derleme hatası düzeltildi. b/109409713
  • Kaynak tanımlayıcılarından Java adlarına dönüştürme işlemiyle ilgili bir sorunu düzeltme b/111602491
  • Safe Args eklentisinde null değer alabilme ile ilgili hata mesajlarını düzeltme
  • Eksik null değer alabilme ek açıklamalarını ekleyin.

Sürüm 1.0.0-alpha04

19 Temmuz 2018

Gezinme 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, geçerli Fragment'ı her zaman birincil gezinme fragment'ı olarak ayarlayarak dış NavController'dan önce alt fragment yöneticilerinin çıkarılmasını sağlar b/111345778

Safe Args

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

Hata Düzeltmeleri

  • Bir parça hedefine derin bağlantı oluşturulduktan sonra sistem geri düğmesiyle ilgili sorun düzeltildi b/111515685

Sürüm 1.0.0-alpha03

12 Temmuz 2018

Gezinme 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 bir NavigationUI.setupWithNavController yöntemi eklendi b/110887183
  • popBackStack() artık eski yığın boş olduğunda veya belirtilen hedef kimliği eski yığında olmadığında false değerini döndürüyor b/110893637
  • FragmentNavigator artık FragmentManager durumu kaydettikten sonra gezinme işlemlerini yoksayarak "onSaveInstanceState'ten sonra bu işlem gerçekleştirilemez" istisnalarını önlüyor b/110987825

Safe Args

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

Hata Düzeltmeleri

  • Fragment 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 çok kez gezinirken karşılaşılan sorunlar düzeltildi b/110178671
  • Grafikteki ilk hedefle setPopUpTo kullanılırken karşılaşılan sorunlar düzeltildi b/109909461
  • Tüm app:defaultValue değerlerinin dize olarak iletilmesiyle ilgili sorun düzeltildi b/110710788
  • Android Gradle Eklentisi 3.2 Beta 01 ile birlikte sunulan aapt2, artık Gezinme XML dosyalarındaki her android:name özelliği için saklama 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 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 gezinme çağrısı yapılırken oluşan IllegalStateException düzeltildi. b/79632233

  • Animasyonlar kullanılırken oluşan titremeyi düzeltmek için gezinme artık Destek Kitaplığı 27.1.1'e bağlıdır. b/80160903

  • defaultNavHost="true" alt parça olarak kullanılırken oluşan IllegalArgumentException düzeltildi. b/79656847

  • NavDeepLinkBuilder kullanılırken oluşan StackOverflowError düzeltildi. b/109653065

  • İç içe yerleştirilmiş bir grafiğe geri dönerken oluşan IllegalArgumentException düzeltildi. b/80453447

  • launchSingleTop kullanılırken parçaların çakışmasıyla ilgili sorun düzeltildi. b/79407969

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

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

API Değişiklikleri

  • İşlemler için clearTask özelliği ve NavOptions içindeki 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.