Gezinme
androidx.navigation
androidx.navigation.compose
androidx.navigation.dynamicfeatures
androidx.navigation.dynamicfeatures.fragment
androidx.navigation.dynamicfeatures.fragment.ui
androidx.navigation.fragment
androidx.navigation.fragment.compose
androidx.navigation.testing
androidx.navigation.ui
| 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.
Daha fazla bilgi için Issue Tracker belgelerine bakın.
Gezinme Sürüm 2.10
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.lifecyclebağı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
NavHostanimasyonları atladığında, beklenmedik kırpmaları önlemek içinsizeTransformde 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:
NavHostartık tahmin edilen geri gitme hareketi sırasında özel geçişe izin vermek içinpredictivePopEnterTransitionvepredictivePopExitTransitionparametrelerini 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 pakettesetPackageyöntemini kullanmanız gerekebilir.- Gezinme etkinlikleri sırasında eski yığın anlık görüntülerini göstermek için
NavBackStackEntryInfoeklendi. Bu sayede, daha zengin özel tahmin edilen geri gitme animasyonları kullanılabilir.
Ek Platform Desteği
navigation-common,navigation-runtimevenavigation-testingmodülleri;desktop,linux,macOS,iOS,javascript,WASM,watchosvetvosiç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
NavBackStackEntryInfokullanı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
handleDeepLinkdeğ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)FragmentNavigatoruygulamasında, işlemler optimize edildiğinde geçerli Fragment'larınIllegalArgumentExceptionhatası 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ı
NullPointerExceptionsorunlarına karşıNavHostiyileş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ı
watchosvetvoshedeflerinavigation-common,navigation-runtimevenavigation-testingmodüllerine eklendi (I60e46)DefaultNavTransitionsadlı öğ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
NavHostartık tahmin edilen geri gitme hareketi sırasında özel geçişe izin vermek içinpredictivePopEnterTransitionvepredictivePopExitTransitionparametrelerini kabul eden bir aşırı yükleme sağlar. (Iac9b0, b/478294569)
Min SDK Güncellemesi
- Varsayılan minSdk, diğer AndroidX kitaplıklarıyla birlikte API 21'den API 23'e yükseltildi. (Ibdfca, b/380448311, b/435705964, b/435705223)
Harici Katkı
navigation:navigation-common,navigation:navigation-runtimevenavigation:navigation-testingartı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ı
NullPointerExceptionsorunlarına karşıNavHostiyileş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
SavedStateHandleoluşturucusununList<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
SafeArgseklentisi, 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
SafeArgseklentisi, AGP 9.0.0-alpha04+ ile kullanıldığında artıkuseAndroidXö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
NavHostgeç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
NavControlleriçinde,OnDestinationChangedListenerskullanılırkenConcurrentModificationExceptionhatası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
NavTypeskullanılırken tip güvenli rotalarlaSavedStateHandletest edilirken oluşanMissingFieldExceptionhatası 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öğelerininLifecycle.Stateiç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
@CheckResultek açıklamasıyla oluşturuluyor.
SupportingPane arayüzü
- Özel Gezginler artık hedeflerini
SupportingPanearayü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 hedefRESUMED.
Compose Kotlin Multiplatform
- Gezinme artık
IntentyerineNavDeepLinkRequestalan yeni bir ortakNavController.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
NavUrisunuyor. 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
reifiedyöntemleri (ör. aracılığıyla erişilebilen tip güvenli API'lercomposable<YourScreen>artık doğrudan birKClassö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
parseStringAsNavUriiçin ortak API, dize alan birNavUrifabrika 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-testingmodülü artık Android'in yanı sıra masaüstü, Linux, macOS ve iOS'te de destekleniyor. (I2b770, b/398265336)NavTypeartı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ı
NavUrioluş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
saveStateyapmaya ç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
NavDeepLinkeş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
Intentile 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
@CheckResultek açıklamasıyla oluşturuluyor. (I14d4c, b/356323084)
Hata Düzeltmeleri
NavControlleriç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ğlananNavDestinationetiketleri, özelNavTypemantığına uyulmasını sağlamak içinNavType.getaracılığıyla ayrıştırılır. (I7ec2f, b/388100796) - Gezinme
2.8.6:dataPatternile etkinliğe giderkenActivityNavigatorartık bağımsız değişken değerini bağımsız değişkeninNavTypedeğ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
- Daha önce yalnızca
reifiedyöntemleri (ör. aracılığıyla erişilebilen tip güvenli API'lercomposable<YourScreen>artık doğrudan birKClassörneği alan somutlaştırılmamış sürümlere sahip.(Ia7eed, Id2879, Ibf244, I17d79, Id09d2, I54696, Ia47be, I93281, Ic1bf0, Iba4ee, If56a5, Icf969, I67644, I6f788, b/382094941, b/366291612, b/381938808)
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.setStartDestinationaşı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 tetiklenirseNavHost'ünPredictiveBackHandleriçinde bir istisna oluşturmasına neden olan sorun düzeltildi. (I1a429, b/375343407) - Gezinme
2.8.5bölümünden: Bir grafiğinstartDestinationgüncellenirkenNavDestinationNullPointerExceptiondüzeltildi. (I99421, b/361560785)
Harici Katkı
- Navigation
2.8.5: Navigation tip güvenliği, artık herhangi bir özelNavTypegerektirmeden bir rotanın bağımsız değişken türü olarakList<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 birLifecycleObserver, barındıranLifecycleOwner(ö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 birConcurrentModificationExceptiondü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
SupportingPanearayü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 hedefRESUMED. (Id5559) - Gezinme
2.8.3:@Serializableile doğru şekilde ek açıklama eklenmemiş, tür güvenli rotaları belirlemeye yardımcı olmak içinnavigation-common,navigation-runtimevenavigation-composemodüllerine yeni lint kontrolleri eklendi. Bu kontrol, tümNavGraphBuilderveNavDeepLinkBuilderuzantı işlevlerine uygulanır. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816) - Navigation
2.8.3:navigation-common,navigation-runtimevenavigation-composemodülleri için yeni lint kontrolleri eklendi. Bu kontroller,@Keepile 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ümNavGraphBuilderveNavDeepLinkBuilderuzantı işlevlerine uygulanır. (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)
Davranış Değişiklikleri
- Daha önce
DESTROYEDbirNavControllerkullanmaya çalışmak artıkIllegalStateExceptionhatasına neden olacak. (I520da, b/369616172)
Hata Düzeltmeleri
- Enum sınıfı sadeleştirilmiş derlemelerde silinirse
@Keepek 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ışırkenObsolete custom lint checkhatası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
NavDeepLinkeş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
Intentile 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
NavDestinationetiketleri, özelNavTypemantığına uyulmasını sağlamak içinNavType.getaracılığıyla ayrıştırılır. (Id366d, b/388100796) dataPatternile etkinliğe giderkenActivityNavigatorartık bağımsız değişken değerini bağımsız değişkeninNavTypedeğ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öğesininPredictiveBackHandleriçinde bir istisna oluşturmasına neden olan sorun düzeltildi. (I1a429, b/375343407) - Grafiğin
startDestinationdeğeri güncellenirkenNavDestinationNullPointerExceptiondü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 birLifecycleObserver, barındıranLifecycleOwner(ö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 birConcurrentModificationExceptiondüzeltildi. (Ia9494)
Harici Katkı
- Gezinme tip güvenliği, artık herhangi bir özel
NavTypegerektirmeden bir rotanın bağımsız değişken türü olarakList<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
- Navigation
2.9.0-alpha03: Navigation tür güvenliği artık değer sınıfını rota veya rotanın bağımsız değişken türü olarak destekliyor (I9344a, b/374347483).
Hata Düzeltmeleri
- Gezinme
2.9.0-alpha01: Daha önceDESTROYEDolan birNavControllerkullanmaya çalışmak artıkIllegalStateExceptionhatasına neden olur. (I520da, b/369616172)
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-runtimevenavigation-composemodülleri için yeni lint kontrolleri eklendi. Bu kontroller,@Serializableile doğru şekilde ek açıklama eklenmemiş tür güvenli rotaları belirlemeye yardımcı olur. Bu kontrol, tümNavGraphBuilderveNavDeepLinkBuilderuzantı işlevlerine uygulanır. (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816)@Keepile 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çinnavigation-common,navigation-runtimevenavigation-composemodüllerine yeni lint kontrolleri eklendi. Bu kontrol, tümNavGraphBuilderveNavDeepLinkBuilderuzantı 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ışırkenObsolete custom lint checkhatası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
NavTypegerektirmedenDouble,Double?,DoubleArray,DoubleArray?,List<Double>veList<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
NavTypeile 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
popBackStackyapmaya çalışırken somutlaştırılmış sınıf türü alanpopBackStackiş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öğesininstartDestinationöğ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
SeekableTransitionStateAPI'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,
NavHostFragmentiçinComposableNavHostFragmentalternatifi içeren yeni birnavigation-fragment-composeyapı eklendi. Hercomposablehedefi, tam nitelikli adı her hedefteandroid:nameözelliği olarak kullanılan üst düzey, bağımsız değişkensiz bir@Composableyö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 birCollectionNavType<T>sınıfı sunuyor. Tüm varsayılanNavTypedizileri (IntArrayType,LongArrayType,FloatArrayType,BoolArrayTypeveStringArrayType) artık bu yeni sınıftan devralınır. NavTypeartı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.EnumTypeeklendi. Bu,Enumtürlerinin artık özelNavTypegerektirmediği anlamına gelir.Enum'ninSerialNamedeğerinin varsayılan tam nitelikli ad olması gerektiğini unutmayın. (I66d22, b/346475493) - Navigation Safe Args,
Int?,Long?,Float?,Boolean?veEnum<*>?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öğesininstartDestinationbileşeni,NavGraphöğesine iletilenstartDestinationrotası tam olarakstartDestination.routedeğ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
WrongStartDestinationTypelint 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ş
NavGraphsaynıstartDestinationrotayı paylaştığında oluşansingleTopgezinme 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)SavedStateHandleFactorytest 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 zamanRESUMEDyaş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 soyutemptyCollection()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.serializeAsValueveserializeAsValuesile ilgili dokümanlar eklendi. (Ida6bd, b/344943214) - Boş bir
CollectionNavTypebağımsız değişkeniyletoRoute<T>çağrılırken oluşan kilitlenme düzeltildi. Boş birCollectionNavTypeile 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 yoksaemptyCollection()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 birNavTypeile kullanılırken oluşanClassCastExceptionkilitlenme 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 birtypeMapparametresi alıyor. (Ie39fb, b/339026523)- Kotlin Serializable nesnesinden
SavedStateHandleoluşturmak içinnavigation-testingsı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
- Kotlin Serileştirme'yi temel alan Navigation Compose ve Navigation Kotlin DSL kullanıcıları için derleme süresi tip güvenliğini destekleme çalışmaları tamamlandı ve daha önce deneysel olan API'ler artık kararlı hale geldi. (Iea94d, I0eb0d, I873b7, I3a64b, I6c3a2, I11f0b, Ic3032, I8d394, I95710, Ice060, Id0e55, I45f8b, Idcdaf, If5380, I08b23, Ia5c59, b/188693139)
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-composeyapısı artık birComposableFragmentiçindeki composable yöntemlere yerel birLocalFragmentoluşturma sağlıyor. (If35e5)NavTypeartı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
NavHostFragmentiçinComposableNavHostFragmentalternatifi içeren yeni birnavigation-fragment-composeyapısı ekler. Bu yapı, gezinme XML dosyalarınızacomposablehedefleri eklemenize olanak tanır. Hercomposablehedefi, tam nitelikli adı her hedefteandroid:nameözelliği olarak kullanılan üst düzey, bağımsız değişkensiz bir@Composableyö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
ExperimentalSafeArgsApiek 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
- Kotlin Serileştirme'ye dayalı bir yaklaşım kullanılarak Navigation Compose'da Safe Args desteği sunulmaya başlandı. Bu API'ler tamamlanmamıştır ve
ExperimentalSafeArgsApiek 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. (I644e7, I98896, I2a1c5, I43a51, I836a1, Ic5eec, I39407, I24e41, If9e14, Ibb13e, If44d3, Icb70f, I8972f, I1d432, Icf32b, I20a14, I262aa, I7de99, I35990, I1033d, b/188693139)
Hata Düzeltmeleri
NavHostartık varsayılan contentAlignment bağımsız değişkeni olarakAlignment.TopStartkullanıyor. Bu sayedeAnimatedContentiç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
NavHostartı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 kalmadanNavGraph'ınstartDestinationöğesine doğrudanstartDestinationrotasında bağımsız değişkenler iletebilirsiniz. Bu durum, iç içe yerleştirilmişNavGraphstartDestinationsiç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 soyutCollectionNavType<T>sınıfı eklendi. (Ic6d63, b/188693139) - Tüm varsayılan
NavTypedizileri (IntArrayType,LongArrayType,FloatArrayType,BoolArrayTypeveStringArrayType) artıkCollectionNavTypetüründe (Idcf79, b/188693139) NavTypeartık aynı türdeki iki değerin birbirine eşit olup olmadığını belirleyen yeni bir açıkvalueEqualsAPI'si sunuyor. (I6cb97, b/327229511)
Hata Düzeltmeleri
- Derin bağlantılardaki sorgu parametreleri artık dize tabanlı
NavTypesiç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) navigateveyapopBackStackgibi rotaları destekleyenNavControllerişlevleri artıkNavTypesdizisinin 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
SizeTranformdeğerini,composableve/veyanavigationiş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@MainThreadolarak işaretleniyor. (Ibb988, b/299523245)
Hata Düzeltmeleri
- Navigasyon'da, ilişkili girişin
ViewModelöğesi kaydedilen durumun bir parçası olmadığı içinNavGraphViewModels'ın çok erkenDESTROYEDolmasına neden olan bir sorun düzeltildi. (Ib6bb7, b/317581849)
Bağımlılık Güncellemesi
- Navigation Compose artık Compose 1.7.0-alpha03'e bağlıdır.
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
SeekableTransitionStateAPI'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ğiBackStackStatesızıntısı düzeltildi. (I598b0, b/309559751) - Uygulama çubuklarının başlığını doldurmak için
NavigationUIyardı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
NavigationUIyardı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 birNavBackStackEntryüzerinde birden fazlasaveState()çağrısının birden fazla durumun kaydedilmesine neden olduğu ancak yalnızca ilk kaydedilen durumun geri yüklenebildiğiBackStackStatesı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çinNavigationUIyardı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
NavigationUIyardı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
NavGraphequals()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
setGraphgibi ç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
setGraphyö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.visibleEntrieslistesine sızmayacak. (I67586, b/287969970) - Bir giriş açıldıktan sonra yapılandırma değişikliği yapıldığında,
saveStatedeğeri yanlışsa girişinViewModeldeğ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_TASKişareti ayarlandığındasetGraphçağrısı yapılıyorsaNavControlleröğ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ınViewModelö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
popUpToiç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
popUpToile bir gezinme işlemini başka bir gezinme işlemiyle kesintiye uğratmanınFragmentNavigatoruygulaması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) DialogFragmentyaşam döngüsü, üstündeki iletişim kutusu kapatıldığında artık düzgün bir şekildeRESUMEDdurumuna 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,
visibleEntrieslistesinin yanlış girişler içermesine neden olan bir sorun düzeltildi. (I5caa9, b/288520638) - Kayan pencere hedefinin (ör.
Dialogs,Bottomsheetsvb.) hiçbir zamanRESUMEDyaş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,rememberSaveableile Gezinme Oluşturma'nınNavHostarasındaki etkileşim düzeltilir. Bu etkileşim, hedeflerinrememberSaveabledurumunun veViewModel'e ait tümSavedStateHandleö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)
STARTEDdurumu yerineCREATEDYaş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
RESUMEDdurumuna geçmek yerineSTARTEDyaş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,
ScaffoldkullanılırkenLifecycle.State.DESTROYEDViewModelöğ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.0yerine Compose1.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
NavHostkapsamında oluşturulanEnterTransitionveExitTransitionlambda'larının,NavHostoluş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
IllegalArgumentExceptionhatası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,
popUpToseç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,ActivitySTOPPEDveRESUMEDolduktan 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.popUpToile 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'ınargumentsveOnDestinationChangedListener'ye iletilenarguments, 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şikliklerargumentsveya diğerOnDestinationChangedListenerörneklerine sonraki erişimlere yansıtılmaz.NavDeepLinkartı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.NavTypeartı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çinserializeAsValuedeğerini geçersiz kılabilir. Böylece hem serileştirme hem de serileştirmeyi geri alma (parseValuearacılığıyla) işlemleriNavTypesınıfında tamamen kapsüllenebilir.StringTypeartık bu yöntemi geçersiz kılarak belirli birStringüzerindeUri.encodeyöntemini çağırıyor.
2.5.0 sürümünden bu yana Navigation Compose'da yapılan önemli değişiklikler
NavHostile bir composable önizlenirken artık varsayılan olarak NavGraph'ınstartDestinationöğesi gösterilir.NavController.popBackStack(route),NavController.getBackStackEntry(route)veNavController.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.navDeepLinkKotlin DSL'yi kullanarak boş birNavDeepLinkoluş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
NavHostFragmentartık sistemin geri düğmesini kendisi engellemiyor. Bu sayede, temelFragmentManagersistem geri işlemini gerçekleştirebilir. Bu sayede Fragment1.7.0-alpha01ve 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 birFragmentTransactionişlemini manuel olarak yapmaya çalışmak artıkIllegalArgumentExceptionhatasına neden olur. Parçaları her zamannavigate()API'si üzerinden eklemeniz gerekir. - Bir gezinme XML dosyasının etkinlik öğesindeki
app:dataveapp:dataPatternözelliklerinde yer tutucu olarak tam dize${applicationId}kullanıldığında, yer tutucu, şişirme sırasında bağlamınpackageNameile otomatik olarak doldurulur. FragmentNavigatorartıkNavBackStackEntriesgezinirken ve açılırken geçiş API'lerini kullanıyor. Bu,NavBackStackEntryLifecycleöğesinin artık sonLifecycle.Stateöğesini taşımadan önce giriş ve çıkış parçası özel efektlerinin tamamlanmasını bekleyeceği anlamına gelir.DialogFragmentNavigatorartıkNavBackStackEntriesgezinirken ve açılırken geçiş API'lerini kullanıyor. Bu,NavBackStackEntryLifecycleadlı aracınDESTROYEDkonumuna geçmeden önceDialogFragmentLifecycleadlı aracınDESTROYEDkonumuna geçmesini bekleyeceği anlamına gelir.NavHostFragmentartıkNavControllerdeğerini yalnızcaonCreate()sonrasında değil,NavHostFragmentFragmentManageröğ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.Menuaracılığıyla) iletirkenNavigationUIartı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 yeniisTopLevelDestinationişlevi aracılığıyla kendi kodunuzda da kullanılabilir. NavigationUIuygulamasında üst uygulama çubuğuyla çalışmak için kullanılansetupWithNavControllerentegrasyonları, artıkandroid:labeluygulamanızda bulunanReferenceTypebağımsız değişkenleri içinR.stringdeğerlerini otomatik olarak oluşturulan kaynak tam sayısı yerine dize değerlerine ayrıştıracak.NavigationUI, seçilen birMenuItemü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,
popUpToile 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öntemindepopUpToile gezinme yoluyla bir parçanın kaldırılmasınınIllegalStateExceptionhatası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
NavBackStackEntryartık özel birtoStringuygulaması sunuyor. (Iff00b)
Hata Düzeltmeleri
- Parçalarla gezinme kullanılırken
FragmentManageröğesinin eski yığınına parça ekleyen birFragmentTransactionişlemini manuel olarak yapmaya çalışmak artıkIllegalArgumentExceptionhatasına neden olur. Parçaları her zamannavigate()API'si üzerinden eklemeniz gerekir. (I6d38e) - Aynı karede bir giriş ekleyen
navigateve bu girişi kaldıranpopBackStackolduğunda, eski yığındaki en üst giriş artık tutarlı bir şekildeRESUMEDLifecycle.Statedeğ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
NavDestinationnull değer alabilenNavArgumentiçeriyorsa bu hedefin rotası, null değer alabilenNavArgumentile aynı ada sahip bağımsız değişkenler için yer tutucular içermelidir. (Ic62bf, b/274697949) Action/MimeTypetabanlı derin bağlantı gezinmeleri, gezinme işlemindeAction/MimeTypeile eşleşenNavDestinationiçin gerekli olan ve null değer alabilen birNavArgumenteksikse 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 kaydetmedenonLaunchSingleTopkullanı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
NavHostFragmentartıkNavControllerdeğerini yalnızcaonCreate()sonrasında değil,NavHostFragmentFragmentManageröğ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
NullPointerExceptiondüzeltildi. (6b3581, b/249988437) popUpToile gezinme yaptıktan sonra sistem geri düğmesini kullandığınızdaNavControllerdurumu doğru girişe geçer. (I3a8ec, b/270447657)FragmentNavigator, eski yığın sistem geri düğmesi veyapopBackStack()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
- Gezinme artık Yaşam döngüsü
2.6.1'ne bağlıdır. (586fe7) - Gezinme artık SavedState
1.2.1'e bağlıdır. (078e4e) - Gezinme artık ProfileInstaller
1.3.0'a bağlıdır. (512f0c)
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,clearBackStackAPI 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öğesindenclearBackStack()ç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
BottomNavigationViewiçindeki yanlışMenuItemöğesinin vurgulanmasına neden olan bir gerileme düzeltildi. (I634f6, b/270447657) - 2.6.0-alpha06 sürümünde,
AnimationkullanılırkenNavBackStackEntryöğ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
NavHostile bir composable önizlenirken artık varsayılan olarak NavGraph'ınstartDestinationöğesi gösterilir. (I2b89f)
API Değişiklikleri
- Tüm
NavControllernavigateaşırı yüklemeleri, ana iş parçacığında çağrılmalarını sağlamak için artık@MainThreadile 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
AnimationAPI'leri kullanıldığındaNavBackStackEntryöğesinin yaşam döngüsüRESUMEDdeğerine ulaşamıyor. (b/269646882) - Fragment'lar ile gezinme özelliğini kullanırken ve
BottomNavigationile gezinirken birden fazla giriş içeren bir eski yığını geri yüklemeye çalışırsanızBottomMenuItemdoğru şekilde güncellenmez. (b/270447657) - Parçalarla gezinme kullanılırken durum geri yüklendikten sonra
NavBackStackEntryLifecycle, parçasıDESTROYEDolduğundaDESTROYEDolmaz. (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)veNavController.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)FragmentNavigatorartıkNavBackStackEntriesgezinirken ve açılırken geçiş API'lerini kullanıyor. Bu,NavBackStackEntryLifecycleöğesinin artık sonLifecycle.Stateöğesini taşımadan önce giriş ve çıkış parçası özel efektlerinin tamamlanmasını bekleyeceği anlamına gelir. (I3cb19, b/238686802)DialogFragmentNavigatorartıkNavBackStackEntriesgezinirken ve açılırken geçiş API'lerini kullanıyor. Bu,NavBackStackEntryLifecycleadlı aracınDESTROYEDkonumuna geçmeden önceDialogFragmentLifecycleadlı aracınDESTROYEDkonumuna geçmesini bekleyeceği anlamına gelir. (I53ee5, b/261213893)
API Değişiklikleri
NavigatorState,Navigator'lerinNavBackStackEntries'yi araLifecycle.State'lere taşımasına olanak tanımak içinprepareForTransitionAPI'yi sunuyor. (I42c21, b/238686802)- Artık
backstacközelliği aracılığıylaNavGraphNavigatorveyaComposeNavigatorile ilişkili eski yığına erişebilirsiniz.ComposeNavigatorartık bir gezinme veyapopBackStackişlemi gerçekleştirenNavBackStackEntryöğesini tamamlandı olarak işaretlemek içinonTransitionComplete()geri çağırma işlevini de kullanıma sunuyor. (I02062, I718db, b/257519195)
Hata Düzeltmeleri
push/popWithTransitionAPI'leri kullanılırken ve giriş zaten işlenirken Navigator durumu artık işlem yapmayacak. (Iadbfa, b/261213893)- İç içe yerleştirilmiş
NavGraphilelaunchSingleTopkullanıldığında, orijinal hedeften başlayıpstartDestinationhedefine kadar olan tüm hedefler, geri yığının en üstüne doğru şekilde eklenir. (Id4bea, b/253256629) - Gezinme,
launchSingleTopişareti "true" olarak ayarlanmış şekilde aynı hedefe giderkenDialogFragmentö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çinserializeAsValuedeğerini geçersiz kılabilir. Böylece hem serileştirme hem de serileştirmeyi geri alma (parseValuearacılığıyla) işlemleriNavTypesınıfında tamamen kapsüllenebilir.StringTypeartık bu yöntemi geçersiz kılarak belirli birStringüzerindeUri.encodeyöntemini çağırıyor. (Ie5213, b/247637434)NavigationUI, seçilen birMenuItemü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,Crossfadeiçin oluşturulacak bir hedef olmadığında artıkNoSuchElementExceptionhatası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.rememberSaveablekullanımları) unutulmamasına ve kaldırılmamasına neden olan sorun düzeltildi. (I64949)
Bağımlılık Güncellemeleri
- Gezinme artık Fragment
1.5.4'a bağlıdır. (Icd424)
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.Menuaracılığıyla) iletirkenNavigationUIartı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 yeniisTopLevelDestinationişlevi aracılığıyla kendi kodunuzda da kullanılabilir. (Ie936e, b/238496771)
Hata Düzeltmeleri
navigation:navigation-fragmentbileşeni artık Fragment1.5.2sürümüne bağlıdır. (I00ba4)- Seçili menü öğesi, iletişim kutusu gibi bir
FloatingWindowhedefine 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
NavigationUIuygulamasında üst uygulama çubuğuyla çalışmak için kullanılansetupWithNavControllerentegrasyonları, artıkandroid:labeluygulamanızda bulunanReferenceTypebağımsız değişkenleri içinR.stringdeğerlerini otomatik olarak oluşturulan kaynak tam sayısı yerine dize değerlerine ayrıştıracak. (I5f803, b/167959935)NavDeepLinkartı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.NavTypeartı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:dataveapp:dataPatternözelliklerinde yer tutucu olarak tam dize${applicationId}kullanıldığında, yer tutucu, şişirme sırasında bağlamınpackageNameile otomatik olarak doldurulur. (Iaabde, b/234223561) navDeepLinkKotlin DSL'yi kullanarak boş birNavDeepLinkoluş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 yeniNavDestinationuzantı işlevi eklendi.R.stringdeğerlerini dize değerlerine ayrıştırarakReferenceTypebağımsız değişkenlerini destekler. (I07d89, b/236269380)
Davranış Değişiklikleri
- NavBackStackEntry'nin
argumentsveOnDestinationChangedListeneröğesine iletilenargumentsartı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şikliklerargumentsveya diğerOnDestinationChangedListenerö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 velaunchSingleTopiş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 çıkanIllegalStateExceptionhatası 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,Crossfadeiçin oluşturulacak bir hedef olmadığında artıkNoSuchElementExceptionhatası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.
rememberSaveablekullanı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
launchSingleTopiş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
IllegalStateExceptiondüzeltildi. (I9f7cb, b/243778589)
Bağımlılık Güncellemesi
- Navigation
2.5.2artık Fragment1.5.2'ye bağlıdır. (aosp/2178734)
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,Bundleiç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
- Gezinme kitaplığı artık Lifecycle
2.5.1'a bağlıdır. (Ib4451) - Navigation kitaplığı artık Activity
1.5.1'e bağlıdır. (I3efe8) - Navigasyon kitaplığı artık Fragment
1.5.1'e bağlıdır. (I56177)
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 Lifecycle2.5.0'ınCreationExtrasaracılığıyla durum bilgisizViewModelProvider.Factorysağlayabilir.
Navigation SafeArgs
Navigation Safe Args,Android Gradle Pluginbağımlılığını7.0.4'ye bağlı olacak şekilde yükseltti ve7.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
visibleEntriesAPI artık deneysel değildir veNavControlleruyarı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
NavHostkullanılırken alt hedefler arasında hızlı geçiş yapıldığında oluşan kilitlenme sorunu düzeltildi. (I3979a, b/234054916) Navigation SafeArgs,applicationIdSuffixve ad alanı kullanılırkenapplicationIdyoksa veyaapplicationIdile ad alanı farklıysa artık kilitlenmeyecek. (I754b1, b/233119646)NavArgumentartık bağımsız değişkenin dahili değerlerini gösteren özel birtoString()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.xmldosyanı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
NavHostveDialogHostiç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
ArgumentsGenerationTaskiçindePathSensitivity.RELATIVEkullanıyor. Bu, önbellek girişinin artık bir CI derlemesinden yerel derlemeye yeniden kullanılabileceği anlamına gelir. (I5f67c, b/173420454) UnrememberedGetBackStackEntryDetectorlint kuralı,getBackStackEntry()çağrısını çevreleyenrememberçağrısının da anahtar olarak birNavBackStackEntrynesnesi 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ıkpopWithTransitionkullanıyor. Bu sayede,dialoghedefindeViewModelkullanırken sistem geri düğmesini kullanarak veya iletişim kutusunun dışına dokunarak iletişim kutusunu kapattığınızdaIllegalStateExceptionhatası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 birNavHost, başka birNavHostiçine yerleştirildiğinde oluşanIllegalStateExceptiondü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
visibleEntriesartık deneysel değil. (I4829f, b/225394514)
Hata Düzeltmeleri
- NavHost artık hangi girişlerin oluşturulacağını belirlemek için
NavControlleriçindekivisibleEntriesöğesine bağlıdır. Bu, iç içe yerleştirilmiş NavHost kullanıldığında içtekiNavHostöğesinin artık düzgün bir şekilde animasyonla çıkacağı anlamına gelir. (I4ba2b, b/225394514) NavControllertarafından sağlananvisibleEntriesStateFlowartı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)SavedStateViewFactoryartıkSavedStateRegistryOwnerile başlatılmış olsa bileCreationExtraskullanımını destekliyor. Ekstralar sağlanırsa başlatılan bağımsız değişkenler yoksayılır. (I6c43b, b/224844583)NavDeepLinkartı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 veAndroidManifest.xmlyokken 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
ViewModeloluşturmak içinCreationExtrasdeğeriniby navGraphViewModelsparametresine iletebilirsiniz. (I29217, b/217618359)
Hata Düzeltmeleri
NavDeepLinksartı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çinNavBackStackEntriesile kullanıldığında artık doğru şekilde çalışacak. (I69161, b/217617710)- Navigation Safe Args artık AndroidManifest'teki paket yerine
build.gradleiç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ıkOnBackPressedDispatcherdeğ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
NavBackStackEntryartık Lifecycle2.5.0-alpha01kapsamında sunulan ViewModel CreationExtras ile entegre oluyor. (Ib9fe2, b/207012490)
Hata Düzeltmeleri
- Bir parçanın
onCreate()yöntemindenby navGraphViewModels()aracılığıyla oluşturulan birViewModelöğesine erişirkenIllegalStateExceptionhatasıyla başarısız olmasına neden olan sorun düzeltildi. (I8a14d) NavDeepLinkartı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
- Navigasyon
2.5.0-alpha03'dan geriye doğru taşındı:NavDeepLinksartık rotalara/derin bağlantı URI'lerine yerleştirilmiş kodlanmış yeni satır karakterlerini düzgün şekilde destekliyor. (I513d1, b/217815060) - Navigation
2.5.0-alpha03sürümünden geriye doğru taşındı: Navigation SafeArgs artık AndroidManifest'teki paket yerinebuild.gradleiçinde tanımlanan ad alanının kullanılmasını destekliyor. (I659ef, b/217414933) - Navigasyon
2.5.0-alpha04'dan geriye dönük olarak taşındı:Navigation Safe Args, ad alanları kullanılırken veAndroidManifest.xmlyokken artık kilitlenmeyecek. (I17ccf, b/227229815) - Navigation
2.5.0-alpha04'dan geriye dönük olarak taşındı: Boş dize artık derin bağlantılarda geçerli bağımsız değişken olarak kabul ediliyor. (I70a0d, b/217399862)
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ırkenOnBackPressedDispatcherdeğ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'ınonCreate()öğesindenby navGraphViewModels()aracılığıyla oluşturulan bir ViewModel'e erişirkenIllegalStateExceptionhatasıyla başarısız olunmasına neden olan sorun düzeltildi. (I8a14d) - Gezinme
2.5.0-alpha01sü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.
NavTypealt sınıfları) null değer alabilme özelliği iyileştirildi. Daha önce-ktxyapılarına ait olan tüm Kotlin uzantı işlevleri, ilgili ana yapılarına taşındı.-ktxyapıları yayınlanmaya devam edecek ancak tamamen boş olacak. navigation-fragmentyapısı artık yeniAbstractListDetailFragmentaracı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 olarakNavHostFragmentkullanan bir ayrıntı penceresini yönetmek içinSlidingPaneLayoutkullanır.NavControllerüzerindekicurrentBackStackEntryAsFlow()yöntemi, mevcutNavBackStackEntryher değiştiğinde yayınlanan birFlowsağ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ürNavBackStackEntryörneklerinin listesiniStateFlowolarak alma imkanı sunuyor. - Artık özel NavType'lar oluşturmak için
NavTypesı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()vegetHierarchy()API'leri sağlar.findStartDestination(),NavGraphüzerinde bir uzantı işlevidir.startDestination, iç içe yerleştirilmiş birNavGrapholsa 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ılabilecekNavDestinationüzerinde bir işlevdir.val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }BottomNavigationViewalanNavigationUIyöntemleri, Material1.4.0,NavigationBarView'te sunulan üst sınıfını alacak şekilde güncellendi. Bu sayede, bu yöntemlerNavigationRailViewile 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
NavArgssınıfı için birfromSavedStateHandle()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
popUpToKotlin özelliği,popUpToIdlehine 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:
composablevedialoghedeflerini kullanarak Kotlin DSL aracılığıyla gezinme grafiğinizi oluşturmanıza olanak tanıyanNavHostcomposable. 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
Lifecyclekapsamı belirleme. Her hedef, yalnızca giriş geçişleri tamamlandığındaRESUMEDdurumuna ulaşır ve çıkış geçişleri başladığında hemenSTARTEDdurumuna düşer. Böylece, yalnızcaLifecycleRESUMEDolduğunda birnavigateçağrısı tetikleyerek tümIllegalStateExceptionve çoklu dokunma sorunlarını önleyebilirsiniz. - Hedef düzeyinde
ViewModelkapsamı (Lifecycle ViewModel Compose2.4.0'unviewModel()API'si veya Hilt Navigation Compose1.0.0'unhiltViewModel()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'inonCleared()öğesinde buNavBackStackEntryile ilişkili durumun kalıcı olarak silindiğini ve temizlendiğini belirten bir sinyal sağlar. rememberSaveabledurumunun 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
NavControllerve 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öğesininNavHostdışındaki composable'lara (ör. alt gezinme çubuğu) bağlanmasına olanak tanımak içinrememberNavController()vecurrentBackStackEntryAsState()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:popUpToaracılığıyla açılan tüm hedeflerin durumunu kaydetmek veapp:destinationolarak iletilen hedefle ilişkili durumu geri yüklemek için artıkapp:popUpToSaveStateveapp:restoreStateboole ö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” />navOptionsKotlin DSL'de,popUpTooluşturucusunarestoreStateboole özelliğini vesaveStateboole ö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.Builderaracılığıyla manuel olarak birNavOptionsnesnesi oluştururkensetRestoreState()ve ek birsaveStateparametresi alansetPopUpTo()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 birsaveStateparametresi içerebilir.popBackStack()veyapopUpToSaveStateile kaydedilen durumları temizlemek içinclearBackStack()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
NavDeepLinkBuilderartıkcreatePendingIntent()tarafından döndürülenPendingIntentdeğerinePendingIntent.FLAG_IMMUTABLEekleyerek 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 veNavBackStackEntryLifecycle'ı güncelleyensetGraph(),popBackStack(),navigateUp()venavigate()yöntemlerini@MainThreadolarak işaretler. Böylece Navigasyon, Lifecycle2.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)
Uriiçinde mevcut olduğunu doğrular. NavDeepLinkayrış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,
applicationIdTextResourcekullanılıyor uyarısını artık görmezsiniz.
Bilinen sorunlar
- Navigation
2.5.0-alpha01sürümünde düzeltildi: Bir Fragment'ınonCreate()öğesindenby navGraphViewModels()aracılığıyla oluşturulan birViewModelöğesine erişim,IllegalStateExceptionile 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
NavDeepLinkayrış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)
NavControllergeri yüklendikten sonra geçişler kullanılarak iç içe yerleştirilmiş bir hedef açıldığındaNavControllerartık kilitlenmeyecek. (I0f7c9, b/205021623)- Geçersiz bir
startDestinationkullanı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öğesindenViewModelalma girişiminin başarısız olmasına neden olan sorun düzeltildi. (I6b96d, b/206465487) - Navigation Compose'un
NavHostözelliğiyleactivityhedefleri 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
nulldeğ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
saveStateişaretini otomatik olarak ekler. BöyleceNavigationUI.setupWithNavControllergibi 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
NavHostdoğrudan etkinliğinsetContent()öğesine eklendiğinde,Lifecycle.State.STARTEDdurumuna geçtikten sonra NavBackStackEntries'inLifecycle.State.CREATEDdurumuna düşürülmesine neden olan sorun düzeltildi. (Ia5ac1, b/203536683)- İletişim kutusu gösterilmeden önce eski yığından bir
DialogFragmenthedefi çı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üzerindeonNavDestinationSelectedAPI'sinin, ilgili gezinme grafiğinenavigate()yapmasanız biletruedöndürmesine neden olan sorun düzeltildi. ArtıksetupWithNavControllertarafından dahili olarak kullanılan aynı mantığı kullanarak, hedefinhierarchydeğerini kullanarak yalnızca mevcut hedefle ilişkiliMenuItemdeğ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 navGraphViewModelkullanabilirsiniz. (I901e3, b/201446416)
API Değişiklikleri
visibleEntriesAPI 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 alabilenNavDeepLinkbağı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)
AbstractListDetailFragmentile ilgili bir sorun düzeltildi. Bu sorun,onCreateListPaneView()tarafından döndürülen liste bölmesindekilayout_widthvelayout_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,DialogFragmentiçin eşzamansızdismiss()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çinpopUpToveyapopBackStack()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
visibleEntriesStateFlow (Ia964e) aracılığıyla görünür tümNavBackStackEntryörneklerinin listesini alma imkanı sunuyor. rememberNavController()artık isteğe bağlı birNavigatorö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ülenNavControlleröğesine eklenir. (I4619e)
Hata Düzeltmeleri
- Etkinlik yeniden oluşturulduğunda Dinamik Gezinme artık kilitlenmeyecek. (Ifa6a3, b/197942869)
- Yalnızca
NavHostiç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()vefromSavedStateHandle()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()veyapopUpToSaveStateile kaydedilen durumları temizlemek içinclearBackStack()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
navArgumentKotlin DSL işlevi artıknavigation-composeyerinenavigation-commonkapsamı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
DESTROYEDolduğundaDESTROYEDolur. (I86552, b/198741720) - Boş değer atanabilir
NavDeepLinkbağı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)launchSingleTopkullanılırkenOnDestinationChangedListenerörneklerinin vecurrentBackStackEntryFlow'nin bilgilendirilmemesine neden olan sorun düzeltildi. (Iaaebc)
Bağımlılık Güncellemeleri
- Navigation Compose artık Activity Compose 1.3.1'e bağlıdır. (I05829)
- Navigation Compose artık Lifecycle ViewModel Compose
2.4.0-beta01'a bağlıdır. (Ib86a3)
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
NavTypesı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)
Uriiçinde mevcut olduğunu doğrular. (#204, b/185527157)
Hata Düzeltmeleri
getBackStackEntryvepreviousBackStackEntry,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=truekullanı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ıkArrayIndexOutOfBoundsExceptionoluş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)
Uriiç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)
NavHostartıkNavBackStackEntry'lerinLifecycle.Statedeğerindeki değişiklikleri gözlemliyor. Bu sayede, bir parçadaNavHostkullanı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)
DialogFragmentkapatıldığındaNavControllerdurumunun 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
toSavedStateHandleyöntemi oluşturuyor. Bu yöntem,ViewModelkodunuzu 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üzerindekirequireSlidingPaneLayout()verequireDetailPaneNavHostFragment()yöntemleri sırasıylagetSlidingPaneLayout()vegetDetailPaneNavHostFragment()olarak yeniden adlandırıldı. (I34a08)
Davranış Değişiklikleri
- Animasyonlarla (ör.
Crossfade) gezinirken yeni hedefinLifecycledeğeri artık yalnızca animasyon tamamlandığındaRESUMEDdeğ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
ClassCastExceptionhatasına neden olmaz. (If0543, b/172112072, b/194301889) Uriolmadan derin bağlantı eklerken ve bir rota veya derin bağlantı üzerinden gezinirken oluşanNullPointerExceptiondüzeltildi. (938a0c, b/193805425)- Navigation Compose'da, derin bağlantılı
NavBackStackEntryöğesininRESUMEDdurumuna 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
NavControllereski yığınını temizlemez. (I0b8db, b/175392262)
Hata Düzeltmeleri
- NavController'ın durumunda yapılan yeniden giriş güncellemeleri nedeniyle,
NavBackStackEntryöğesine ekli birLifecycleObserveriçindenpopBackStack()çağrılırken oluşanNoSuchElementExceptiondüzeltildi. (I64621) AbstractListDetailFragment,AbstractListDetailFragmentkullanılmadığındaSlidingPaneLayoutöğesinin APK'nızdan tamamen kaldırılmasına olanak tanır. (I611ad)NavGraphveNavDestinationartı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-fragmentyapısı artık yeniAbstractListDetailFragmentaracı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 olarakNavHostFragmentkullanan bir ayrıntı penceresini yönetmek içinSlidingPaneLayoutkullanır. (Iac4be, b/191276636)navigation-composeyapısınınNavHostözelliği artıkcomposablehedefin yanı sıradialoghedefi de destekliyor. Bu iletişim kutusu hedeflerinin her biri, mevcutcomposablehedefinin üzerinde yüzen bir ComposableDialogiç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
NavigatorStateiçindekiaddişlevi,pusholarak 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çinNavigatorStateüzerindepushWithTransactionvepopWithTransitionAPI'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
NavDeepLinkBuilderartıkcreatePendingIntent()tarafından döndürülenPendingIntentdeğerinePendingIntent.FLAG_IMMUTABLEekleyerek 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
@nullolan birstring[]bağımsız değişkeni kullanarak bir hedefe giderken oluşanNullPointerExceptiondüzeltildi. (I1fbe8) @Navigator.Nameiç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.0sürümünden öncekiKotlinsü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 hedefteykensetupActionBarWithNavController()'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şanIllegalStateExceptiondüzeltildi. (I2a330, b/190265699) by navArgs()için ProGuard kuralları artıknavigation-commonveya 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 birOnDestinationChangedListener, 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.0kullanılırkenUnable 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()vegetHierarchy()API'leri sağlar.findDestination(), grafikte bir hedef bulacakNavGraphüzerinde bir uzantı işlevidir.getHierarchy(), belirli bir hedefin başka bir hedefin hiyerarşisinde olup olmadığını doğrulamak için kullanılabilecekNavDestinationüzerinde bir işlevdir.(I2932f, b/188183365)val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }BottomNavigationViewalan NavigationUI yöntemleri, Material1.4.0,NavigationBarView'de sunulan üst sınıfını alacak şekilde güncellendi. Bu sayede, bu yöntemlerNavigationRailViewile 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
DialogFragmentNavigatorartık bir iletişim kutusu, sistem geri düğmesine basılarak veya iletişim kutusunun dışı tıklanarak kapatıldığındaNavControlleröğesini bilgilendirmek içinNavigatorState.pop()API'sini kullanıyor. BöyleceNavControllerdurumu her zaman Navigator'ın durumuyla senkronize oluyor. (I2ead9)onDestinationChangedgeri çağırma işlevindenOnDestinationChangedListenerslistesini değiştirirken gezinme artıkConcurrentModificationExceptionhatası 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
@IdResile doğru şekilde ek açıklama eklenmiş olduğundan yalnızca kaynak kimliklerini kabul eder. (I69b80)findNodeiçin int parametresi artıkresidyerineresId. (I7711d)
Bağımlılık Güncellemesi
- Safe-Args artık Android Gradle eklentisi 4.2.0'a bağlıdır. Bu durumda,
applicationIdTextResourcekullanı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üzerindekicurrentBackStackEntryAsFlow()yöntemi, mevcutNavBackStackEntryher değiştiğinde yayınlanan birFlowsağ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:popUpToaracılığıyla açılan tüm hedeflerin durumunu kaydetmek veapp:destinationolarak iletilen hedefle ilişkili durumu geri yüklemek için artıkapp:popUpToSaveStateveapp:restoreStateboole ö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” />navOptionsKotlin DSL'de,popUpTooluşturucusunarestoreStateboole özelliğini vesaveStateboole ö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.Builderaracılığıyla manuel olarak birNavOptionsnesnesi oluştururkensetRestoreState()ve ek birsaveStateparametresi alansetPopUpTo()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 birsaveStateparametresi 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
popUpToKotlin özelliğinin desteği sonlandırıldı ve yerinepopUpToIdgetirildi. (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.
NavTypealt sınıfları) null değer alabilme özelliği iyileştirildi. Daha önce-ktxyapılarına ait olan tüm Kotlin uzantı işlevleri, ilgili ana yapılarına taşındı.-ktxyapıları yayınlanmaya devam edecek ancak tamamen boş olacak. (b/184292145) NavDeepLinkBuilderartık oluşturulan eski yığına birden fazla farklı hedef eklemeyi destekliyor. (I3ee0d, b/147913689)DynamicNavHostFragmentiçin fabrika işlevleri ekleyin (Icd515, b/175222619)NavBackStackEntryiçin benzersiz kimlik, artık herkese açık API'sinin bir parçası olarak gösteriliyor. (Ie033a)NamedNavArgumentöğesininnameveargumentalanları ile imha işlevleri artık herkese açık. (#174, b/181320559)- İlgili oluşturma yerellerine
NavBackStackEntrysağlayan yeni birNavBackStackEntry#provideToCompositionLocalsuzantısı kullanıma sunuldu. (#175, b/187229439)
Safe Args
Safe Args artık her
NavArgssınıfı için birfromSavedStateHandle()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 veNavBackStackEntryLifecycle'ı güncelleyensetGraph(),popBackStack(),navigateUp()venavigate()yöntemlerini@MainThreadolarak işaretler. Böylece Navigasyon, Lifecycle2.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/redgibi bir derin bağlantı, enumREDdeğerine sahip olsa bilewww.example.com/{color}derin bağlantısıyla eşleşebilir. (#152, b/135857840)
Compose uyumluluğu
androidx.navigation:navigation-compose:2.4.0-alpha01yalnızca Compose1.0.0-beta07ve 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ılanDialogFragmentNavigatorile 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#addNavigatorişlevinin davranışı iyileştirildi. (#176, b/187443146)
Harici Katkılar
- Her
NavArgssınıfı için birfromSavedStateHandle()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) nameveargumentalanlarını veNamedNavArgument'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
NavBackStackEntrysağlayan yeni birNavBackStackEntry#provideToCompositionLocalsuzantı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#addNavigatordavranışını iyileştiren jossiwolf'a teşekkür ederiz. (#176, b/187443146)
Navigation Compose 1.0.0 sürümü
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
NavHostartık hedef composable'ları sarmalayan composable kapsayıcıya iletilen birModifierkabul ediyor. (I85aca, b/175125483)
Hata Düzeltmeleri
NavHostartıkOnBackPressedDispatcherOwnerbulunamadığı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,NavHosthedefindeBackHandlerkullanı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.currentartık geçerli oluşturmadaViewModelStoreOwnerolup olmadığını daha iyi belirlemek için null değer alabilenViewModelStoreOwnerdöndürüyor.viewModel()veNavHostgibiViewModelStoreOwnergerektiren API'ler,ViewModelStoreOwnerayarlanmamış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
NavHostartıkLocalSavedStateRegistryOwnerCompositionLocal'ı bu hedefinNavBackStackEntryile doldurarak doğrudanSavedStateRegistryiç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
- Navigation Compose,
composablehedeflerineviewModel()desteği sağlamak için artık Lifecycle ViewModel Compose 1.0.0-alpha01'e bağlıdır. (I7a374) NavHostartıkNavControllerüzerinde ayarlananOnBackPressedDispatcherdeğerini almak için Activity-Compose 1.3.0-alpha01'deki yeniLocalOnBackPressedDispatcherOwnerdeğerini kullanıyor. (I65b12)
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şkiliNavBackStackEntrydeğerini döndüren birgetBackStackEntry(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-alpha09ile 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()venavigateUp()öğ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
NavHostcomposable. - Yaşam döngüsü,
ViewModelve 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öğesininNavHostdışındaki composable'lara (ör. alt gezinme çubuğu) bağlanmasına olanak tanımak içinrememberNavController()vecurrentBackStackEntryAsState()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
NavDeepLinkRequestveyaUrikullanarak gezinirken artıkKEY_DEEP_LINK_INTENTaracılığıyla bağımsız değişkenlerden intent'i alarak hedeftekiUri, 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 eklenenOnBackPressedCallbacks, etkinlik yaşam döngüsüSTOPPEDve ardındanSTARTEDolduğ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, hemwww.example.comhem dewww.Example.comile 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
NullPointerExceptiondü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
ReferenceTypebağı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 de0xö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çinandroid:defaultValueartık tam sayı varsayılan değerlerini destekliyor. Bu sayede,0.0yerineandroid: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
setViewModelStoreveyasetLifecycleOwnerç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
ReferenceTypebağı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çinJvmName'e teşekkür ederiz. (#127, b/179166693)app:argType=”float”ile bir bağımsız değişken içindefaultValuedeğerine izin veren pull isteği içintatocaster'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öğesiCREATEDöğesine taşınmadan önce açıldığında artık kilitlenme yaşanmıyor. (Ie3ba3)- b/171364502 nedeniyle oluşan ve animasyon kaynak değeri
0olan bir etkinliğe gidildiğindeResourceNotFoundExceptionhatası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
NavigationUIsürümünde,onNavDestinationSelectedile<activity>hedefi kullanıldığında etkinliğe gidilememesine neden olan bir gerileme düzeltildi. (I22e34, b/171364502)navigation-dynamic-features-fragmentişleminin, yeni yüklenen hedefe birden çok kez gidilmesine neden olduğu sorun düzeltildi. (aosp/1486056, b/169636207)launchSingleTopkullanılırken varsayılan bağımsız değişkenlerinOnDestinationChangedListenerö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
popUpToilenavigate()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,FragmentScenarioveNavigation.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-uiartık DrawerLayout 1.1.1'e bağlıdır. Bu sayedeNavigationUI,LOCK_MODE_LOCKED_CLOSEDveyaLOCK_MODE_LOCKED_OPENkullanı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-runtimevenavigation-dynamic-features-fragmentyapı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-testingyapısı, mevcut hedefi ayarlamanıza ve gezinme işlemlerinden sonra eski yığını doğrulamanıza olanak tanıyan birTestNavHostControllersağ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 birSavedStateHandleöğesine erişmenize olanak tanır. Daha fazla bilgi için Önceki hedefe sonuç döndürme bölümüne bakın. OpenableiçinNavigationUIdesteği:NavigationUIiçindeki tümDrawerLayoutkullanımları, CustomView1.1.0'a eklenen ve DrawerLayout1.1.0'taDrawerLayouttarafından uygulanan daha genelOpenablearayü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:uriişlemine ek olarakapp:actionveapp:mimeTypeişlemlerini de destekleyecek şekilde genişletildi.NavControllerartık yeniNavDeepLinkRequestsı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
singleTopileNullPointerExceptionsorunu düzeltildi. (b/158006669) NavControllertarafından oluşturulan tümdestination is unknownistisnaları artıkNavControllerdurumunu 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öğesininLifecycledeğerinin düzgün şekilde güncellenmemesine neden olan sorun düzeltildi. (b/155218371) setGraph()çağrılmadan önce kaydedilenOnDestinationChangedListenerörnekleri, işlem sonlandırmadan sonra geri yüklenen hedefe artık düzgün şekilde gönderiliyor. (b/155218371)singleTopkullanılırkenNavBackStackEntryartık bağımsız değişkenlerini doğru şekilde güncelliyor ve güncellenen bağımsız değişkenler tümOnDestinationChangeListenerörneklerine gönderiliyor. (b/156545508)
Bağımlılık Güncellemeleri
NavigationUIyapısı artık CustomView1.1.0-rc01ve DrawerLayout1.1.0-rc01'a bağlıdır. (aosp/1309696)
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 olarakapp:actionveapp:mimeTypeözelliklerini de destekleyecek şekilde genişletildi. NavController artık yeniNavDeepLinkRequestsı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ıkapp:graphPackagebelirtmeniz gerekmez. Noktadan sonraapplicationIdöğesinemoduleNameson 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
defaultArgumentsMapsunarak 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 çıkanIllegalStateExceptiondüzeltildi. (b/147378752)
Bağımlılık güncellemeleri
- Gezinme artık Fragment
1.2.4'a bağlıdır. (aosp/1277325) - Dinamik gezinme artık Play Core
1.7.2'a bağlıdır. (aosp/1282257)
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
DynamicExtrassınıfı artık bir oluşturucu kalıbı kullanmıyor ve doğrudan oluşturulabiliyor. (aosp/1253671)DynamicActivityNavigatorartık oluşturucusundaActivityyerineContextalır. (aosp/1250252)
Hata Düzeltmeleri
NavigationUIartı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, somutDrawerLayoutsınıfına güvenmek yerine artık CustomView1.1.0-alpha02'te sunulanOpenablearayüzünü (DrawerLayout, DrawerLayout1.1.0-alpha04itibarıyla uygular) kullanır. Bu sayede,Openable'nin özel uygulamalarınıNavigationUIile kullanabilirsiniz. (b/129030452)
Hata Düzeltmeleri
navigation-common-ktxProGuard kuralları artık tümNavArgsörnekleri yerine yalnızca kullanılanNavArgssı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 Core1.1.0'ya bağlı. Bu sayede, Navigasyon Core1.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
NavBackStackEntryartık belirli bir eski yığın girişiyle ilişkilendirilmesi gereken az miktarda kaydedilmiş durumu depolamaya uygun birSavedStateHandleöğ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
NavBackStackEntryalmayı kolaylaştırmak amacıylagetCurrentBackStackEntry()vegetPreviousBackStackEntry()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 veKEY_DEEP_LINK_INTENTöğesini önceki hedefe iletiyor. (b/147456890)
Bağımlılık değişiklikleri
- Gezinme artık Core
1.2.0'a bağlıdır.
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-testingyapısı, birTestNavHostControllersınıfı sağlar. Bu sınıf, gezinme test edilirken sahte birNavControllerkullanmaya 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.1sürümünden itibaren:DrawerArrowDrawableiçinnavigation-uiProGuard kuralları,android.enableJetifier=trueöğesinin gerekli olmamasını sağlayacak şekilde güncellendi. (b/147610424) - Gezinme
2.2.1:navigation-common-ktxmodülü artıknavigation-runtime-ktxile aynı manifest paket adını paylaşmak yerine benzersiz bir manifest paket adına sahip. (aosp/1141947)
Bağımlılık güncellemeleri
- Navigation
2.2.1sürümünden itibaren: Navigation2.2.1artık Lifecycle ViewModel SavedState2.2.0ve Fragment1.2.1'e bağlıdır.
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 çıkanIllegalStateExceptiondüzeltildi. (b/147378752) NavigationUIartı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-ktxProGuard kuralları artık tümNavArgsörnekleri yerine yalnızca kullanılanNavArgssı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
- Gezinme artık Fragment
1.2.4'a bağlıdır. (aosp/1277325)
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) DrawerArrowDrawableiçinnavigation-uiProGuard kuralları,android.enableJetifier=truegerekli olmayacak şekilde güncellendi. (b/147610424)navigation-common-ktxmodülü artıknavigation-runtime-ktxile aynı manifest paket adını paylaşmak yerine benzersiz bir manifest paket adına sahip. (aosp/1141947)
Bağımlılık güncellemeleri
- Gezinme
2.2.1artık Yaşam Döngüsü ViewModel SavedState2.2.0ve Parça1.2.1'ya bağlıdır.
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ülenNavBackStackEntry, 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ı) veSavedStateRegistryOwnersağlar. - Yaşam Döngüsü ViewModel SavedState Entegrasyonu:
SavedStateViewModelFactory,by navGraphViewModels()veyaViewModelProvideroluşturucuyuNavController.getBackStackEntry()ya daNavController.getViewModelStoreOwner()tarafından döndürülen birViewModelStoreOwnerile 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:
NavHostFragmentartık Fragment 1.2.0'danFragmentContainerViewkullanı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-uitarafından kullanılan varsayılan karartma animasyonları, Fragment1.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
nullyerine"@null"aldığı bir sorun düzeltildi. (b/141613546) NavHostFragment,FragmentContainerViewile 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 SavedState1.0.0-rc03, Activity1.1.0-rc03ve Fragment1.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
NavDestinationve alt sınıfları, hata ayıklama sırasında daha faydalı bilgiler sağlamak için artıktoString()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üzerindekinavArgs()Kotlin uzantısı artık ek öğe olmadığında daha iyi bir hata mesajı gösteriyor. (b/141408999)- Safe Args tarafından oluşturulan
DirectionsJava sınıfları artık varsayılan değerler içeriyor. (b/141099045) - Safe Args tarafından oluşturulan
ArgsJava sınıfları artık varsayılan değerler içeriyor. (b/140123727) ToolbarkullanırkenNavigationUI, 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 sonrasetViewModelStore()çağrıldığında artıkIllegalStateExceptionhatası veriliyor. TümNavBackStackEntryörneklerininViewModelörnekleri için tutarlı bir depolama alanına sahip olmasını sağlamak amacıyla bu ayar, ilk kurulumun bir parçası olarak her zamanNavHosttarafı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şanConcurrentModificationExceptiondü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ülenNavBackStackEntry, 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ı) veSavedStateRegistryOwnersağlar. (aosp/1101691, aosp/1101710)
Hata düzeltmeleri
ViewPager2içinNavHostFragmentekleme işlemininIllegalArgumentExceptionile başarısız olmasına neden olan bir sorun düzeltildi. (b/133640271)NavInflaterartıkgetResourceName()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()veyaViewModelProvideroluşturucuyuNavController.getViewModelStoreOwner()tarafından döndürülen birViewModelStoreOwnerile kullanırken kullanılan varsayılan fabrika oldu. (b/135716331)
API değişiklikleri
- Gezinme
2.1.0-rc01'dan:2.1.0-alpha02sürümünde kullanıma sunulanNavControllerüzerindeki desteği sonlandırılmışgetViewModelStore()API'si kaldırıldı. (aosp/1091021)
Hata düzeltmeleri
NavHostFragmentartıkFragmentContainerViewkullanı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
-ktxkitaplıklarını kullanan Kotlin kullanıcıları içinby navGraphViewModels()özellik temsilcisini veyaNavController'e eklenengetViewModelStoreOwner()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
navigateyaptığınızdaDialogFragmentgö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çinUriilenavigateyapabilirsiniz. Daha fazla bilgi için URI kullanarak gezinme başlıklı makaleyi inceleyin. - NavHostController: Özel bir
NavHostoluşturmak için özel olarak kullanılan API'lerNavHostController'e taşındı. Böylece uygulamalar,NavController'lerini barındırmaLifecycleOwner,OnBackPressedDispatcherveViewModelStore'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-alpha02sürümünde kullanıma sunulan veNavControllerüzerinde desteği sonlandırılangetViewModelStore()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-beta01sü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()'iToolbarveyaCollapsingToolbarLayoutile 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ıknavigation-runtimeyapı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üzerindekigetViewModelStore()API'sinin desteği,ViewModelStoreOwnerdöndüren yenigetViewModelStoreOwner()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ıkFloatingWindowhedeflerini 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
NavControllerile ilgili barındırma API'leri yeniden adlandırıldı veNavController'nin yeni bir alt sınıfı olanNavHostControllersınıfına taşındı. (aosp/966091)NavControllersetHostOnBackPressedDispatcherOwner()yöntemi,NavHostController'ninsetOnBackPressedDispatcher()yöntemiyle değiştirildi ve artık çağrılmadan öncesetLifecycleOwner()yöntemini çağırmanız gerekiyor. (aosp/965409)NavHostControllerartık daha öncesetHostOnBackPressedDispatcherOwner()tarafından döndürülenNavHostOnBackPressedManagersınıfının yerini alan birenableOnBackPressed(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ırkenapp:defaultNavHostdeğerini doğru şekilde dikkate alır ve Gezinme2.1.0-alpha03'deki bir gerilemeyi düzeltir. b/132077777DialogFragmentNavigatorartıkpopBackStack()venavigateUp()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 restoresorunu 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
navigateyaptığınızdaDialogFragmentgösterecek<dialog>hedef oluşturabilirsiniz.NavHostFragment, varsayılan olarak iletişim kutusu hedeflerini destekler. b/80267254 navigateyöntemini bir kaynak kimliği veyaNavDirectionsörneğiyle çağırmanın yanı sıra artık doğru hedefe gitmek için bir hedefe eklediğiniz<deepLink>öğesini kullananUriaracı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
NavHostFragmentsınıfınıncreateFragmentNavigator()yöntemi kullanımdan kaldırıldı ve işlevi yenionCreateNavController()yöntemine taşındı. Böylece,NavHostFragmentsı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/122802849NavDestinationsınıfına, belirli birUriöğesinin ilgili hedef tarafından veyaNavGraphsöz konusu olduğunda gezinme grafiğindeki herhangi bir hedef tarafından işlenip işlenemeyeceğini kontrol etmenize olanak tanıyan birhasDeepLink()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 NavHostFragmentartıkOnBackPressedDispatcherkullanarak 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:argTypeiçerenandroid:defaultValue=”@null”artık düzgün bir şekildestringbağı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 veyaNavControlleröğesine eklenengetViewModelStore()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>hedefineapp:targetPackageekleyebilirsiniz. Paketi kendi uygulama kimliğinizle kısıtlamak içinapp:targetPackage="${applicationId}"desteklenir. b/110975456
Hata düzeltmeleri
<activity>hedefleri içinandroid: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.1veandroidx.fragment:fragment:1.1.0-alpha05'e bağlıdır. Bu sürümdeandroidx.legacy:legacy-support-core-utils:1.0.0bağı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.instantiateFragmentdesteği sonlandırıldı. Varsayılan uygulama artık Fragment'ları örneklendirmek içinFragmentFactorykullanıyor. b/119054429
Hata Düzeltmeleri
- Navigasyon, bir hedefe eklenmiş bağımsız değişkenler olduğunda artık boş bir
Bundlegö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_TASKolmadan 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/126082008ActivityNavigator.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
Rsınıfıyla ilişkili paket adındakiinvefungibi 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
singleTopgezinme 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
referencebağımsız değişkenleri için0'iandroid:defaultValueolarak 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()venavigateUp, eski yığındaki son hedefi çıkarırken artıkfalsedeğerini doğru şekilde döndürüyor. Böylece1.0.0-beta01sürümünde ortaya çıkan bir gerileme düzeltildi. b/123933201- Gezinme, kaydedilen örnek durumunun geri yüklenmesi sırasında
ClassLoaderdeğerini doğru şekilde ayarlayarakNavigatorkaydedilen durumunda veyaNavDestinationöğ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ı birapp:argTypeile 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 FragmentNavigatordurumununNavControllerdurumuyla senkronizasyonunun bozulmasına ve eski yığın geri yüklenmeye çalışılırkenIllegalStateExceptionhatasına neden olan sorun düzeltildi. b/123803044- ProGuard, kod karartma ile kullanıldığında
NavigationUItarafı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$InnerClassbiçiminde statik bir iç sınıfa işaret edenapp:argTypekullanı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 birActivityveyaFragmentiçinde Safe Args tarafından oluşturulan birNavArgssınıfına referans alabilir. b/122603367 - Safe Args artık
androidx.navigation.safeargs.kotlineklentisini uygulayarak Kotlin kodu oluşturmanıza olanak tanıyor. Kotlin kodu, öncekiandroidx.navigation.safeargseklentisi 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üzerindesetGraph()çağrısı yapıldığında artık eski yığın sıfırlanacak. b/111450672- Bilinmeyen derin bağlantılar artık
IllegalStateExceptionhatası vermiyor, ancak yoksayılıyor. Böylece iç içe yerleştirilmiş veya birden fazlaNavHostFragmentile ilgili sorunlar düzeltiliyor. b/121340440
Zarar Veren Değişiklikler
- Bir etkinliğe pop animasyonları uygulamak için kullanılan
NavOptions.applyPopAnimationsToPendingTransition()yöntemiActivityNavigatoryö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
NavDirectionssı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ülenBundleartık@Nullableyerine@NonNullolarak 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ıPendingIntentişlemini artık doğru şekilde işliyor. b/120042732NavController, iç içe yerleştirilmişNavHostFragmentveya eski yığın içeren diğer alt Fragment'lar kullanılırkenpopBackStack()işlemlerini artık doğru şekilde işliyor. b/122770335NavigationUI, 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
NavDirectionssınıfları,equals()doğru değerini döndürdüğünde artık doğru şekilde eşithashCode()değerlerine sahip. b/123043662 NavHostFragment'ninFragmentManageröğesinde özelFragmentTransactionsyapmaya çalışırsanızFragmentNavigatorartık daha iyi bir hata mesajı gösterir. Her zamangetChildFragmentManager()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çerenMenuItem,NavigationUIyöntemleriyle kullanıldığında artık eski yığını açmayacak. b/120104424AppBarConfigurationartıknavController.navigateUp(),falsedöndürdüğünde çağrılacak bir yedekOnNavigateUpListenerö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/111736515onNavDestinationSelected()artık varsayılan olarak gezinme grafiğinizin başlangıç hedefine geri dönereksetupyöntemleriyle tutarlı hale geliyor. Eski yığının açılmasını önlemek içinmenuCategory="secondary"öğesiniMenuItemuygulamanıza ekleyin. aosp/852869- Oluşturulan
ArgssınıflarınınfromBundle()yöntemleri artık null değer alabilenBundleyerine null değer almayanBundlekullanıyor aosp/845616
Hata Düzeltmeleri
- Bağımsız değişkenler artık her zaman dize olarak değil, doğru
argTypeolarak 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,
NavigationUIyöntemleriyle kullanıldığında artıkandroid:labeluygulamanı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,OnDestinationChangedListenerolarak yeniden adlandırıldı b/118670572OnDestinationChangedListenerartık bağımsız değişkenlerinBundledeğerini de iletiyor aosp/837142app:clearTaskveapp: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üyleapp:popUpTokullanın. b/119628354ActivityNavigator.Extrasartık birBuilderkalıbı kullanıyor ve herhangi birIntent.FLAG_ACTIVITY_işaretini ayarlama özelliği ekliyor aosp/828140NavController.onHandleDeepLink,handleDeepLinkolarak 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,NavDeepLinkBuilderveAppBarConfiguration)finalyapı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
FragmentNavigatorsınıfına taşındı. Böylece Fragment oluşturma işlemini birFragmentFactorysınıfına devretmek daha kolay hale geldi. b/119054429 NavGraphNavigatoriçin oluşturucu artıkContextalmıyor aosp/835340- NavigatorProvider artık bir arayüz değil, sınıftır.
getNavigatorProvider()tarafından döndürülenNavigatorProviderişlevinde değişiklik yapılmadı. aosp/830660 NavDestination.navigate()kaldırıldı. Bunun yerineNavigatorüzerindenavigate()yöntemini çağırın. aosp/830663Navigatorönemli ölçüde yeniden düzenlendi.OnNavigatorNavigatedListenerihtiyacı ortadan kalktı ve bunun yerinenavigate, gidilenNavDestinationdeğerini döndürüyor.Navigatorörnekleri artıkNavControlleriçin pop etkinlikleri gönderemez. Geri düğmesine basma işlemlerini yakalamak venavController.popBackStack()yöntemini çağırmak içinOnBackPressedCallbackkullanabilirsiniz. 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
IllegalArgumentExceptionhatasına neden olan bir dizi hata düzeltildi. b/118713731 b/113611083 b/113346925 b/113305559 <activity>hedeflerinindataPatternözelliği artıktoString()ç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
@Overrideek 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-ktxmodülü,navigation-testing artifactmodülüne dahil edildi ve artık yayınlanmayacak.navigation-testingyapı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
- Fragment ve Activity hedefleri için Paylaşılan Öğe Geçişleri artık destekleniyor b/79665225. Daha fazla bilgi için Gezinme Mimarisi Bileşeni ile gezinmeyi uygulama başlıklı makaleyi inceleyin.
NavigationViewuygulamasında bir öğe seçildiğinde, ilgili öğeyi içeren alt sayfa kapatılacak b/112158843
API Değişiklikleri
- Zarar Veren Değişiklik: Navigator
navigate()yöntemi artık birNavigator.Extrasparametresi alıyor. - NavController'ın
getGraph()yöntemi artıkNonNullb/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:argTypeolarak 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
NonNullek 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,setDemoControllerIndexolacak b/79995048 - Örneğin,
action_show_settings,actionShowSettingsolacak b/79642240
- Örneğin,
- 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:typeiç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()vehashCode()'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
setPopUpTokullanılırken karşılaşılan sorunlar düzeltildi b/109909461 - Tüm
app:defaultValuedeğ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
FragmentNavigatorartıksetReorderingAllowed(true)kullanıyor. b/109826220Gezinme 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
IllegalStateExceptiondüzeltildi. b/79632233Animasyonlar 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
IllegalArgumentExceptiondüzeltildi. b/79656847NavDeepLinkBuilder kullanılırken oluşan
StackOverflowErrordüzeltildi. b/109653065İç içe yerleştirilmiş bir grafiğe geri dönerken oluşan
IllegalArgumentExceptiondüzeltildi. b/80453447launchSingleTopkullanılırken parçaların çakışmasıyla ilgili sorun düzeltildi. b/79407969Gezinme 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
MenuItemolarak kullanırken artık doğru öğeyi vurgulayacak. b/109675998
API Değişiklikleri
İşlemler için
clearTasközelliği veNavOptionsiçindeki ilişkili API kullanımdan kaldırıldı. b/80338878İşlemler için
launchDocumentözelliği veNavOptionsiç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.