การนำทาง
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
| อัปเดตล่าสุด | รุ่นที่เสถียร | รุ่นที่อาจได้รับการเผยแพร่ | รุ่นเบต้า | รุ่นอัลฟ่า |
|---|---|---|---|---|
| 23 กันยายน 2569 | 2.10.2 | - | - | - |
การประกาศทรัพยากร Dependency
หากต้องการเพิ่มทรัพยากร Dependency ในการนำทาง คุณต้องเพิ่มที่เก็บ Maven ของ Google ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมได้ที่ที่เก็บ Maven ของ Google
เพิ่มทรัพยากร Dependency สำหรับอาร์ติแฟกต์ที่ต้องการในไฟล์ build.gradle สำหรับแอปหรือโมดูล ดังนี้
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
หากต้องการเพิ่ม Safe Args
ลงในโปรเจ็กต์ ให้ใส่ classpath ต่อไปนี้ในไฟล์ build.gradle ระดับบนสุด
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") } }
นอกจากนี้ คุณยังต้องใช้ปลั๊กอินที่มีให้ 2 รายการนี้ด้วย
หากต้องการสร้างโค้ดภาษา Java ที่เหมาะสำหรับโมดูล Java หรือโมดูล Java และ Kotlin แบบผสม ให้เพิ่มบรรทัดต่อไปนี้ลงในไฟล์ build.gradle แอปหรือโมดูล
Groovy
plugins { id 'androidx.navigation.safeargs' }
Kotlin
plugins { id("androidx.navigation.safeargs") }
หรือหากต้องการสร้างโค้ด Kotlin ที่เหมาะสำหรับโมดูล Kotlin เท่านั้น ให้เพิ่ม
Groovy
plugins { id 'androidx.navigation.safeargs.kotlin' }
Kotlin
plugins { id("androidx.navigation.safeargs.kotlin") }
คุณต้องมี android.useAndroidX=true ในไฟล์ gradle.properties ตามการย้ายข้อมูลไปยัง AndroidX
ดูข้อมูลเกี่ยวกับการใช้ส่วนขยาย Kotlin ได้ที่เอกสารประกอบ ktx
ดูข้อมูลเพิ่มเติมเกี่ยวกับการขึ้นต่อกันได้ที่เพิ่มการขึ้นต่อกันของบิลด์
ความคิดเห็น
ความคิดเห็นของคุณช่วยปรับปรุง Jetpack ให้ดียิ่งขึ้น โปรดแจ้งให้เราทราบหากคุณพบปัญหาใหม่หรือมีแนวคิดในการปรับปรุงไลบรารีนี้ โปรดดูปัญหาที่มีอยู่ในคลังนี้ก่อนที่จะสร้างปัญหาใหม่ คุณสามารถโหวตปัญหาที่มีอยู่ได้โดยคลิกปุ่มดาว
ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของ Issue Tracker
การนำทางเวอร์ชัน 2.10
เวอร์ชัน 2.10.2
23 กันยายน 2569
androidx.navigation:navigation-*:2.10.2 เผยแพร่แล้ว เวอร์ชัน 2.10.2 มีคอมมิตเหล่านี้
การอัปเดตทรัพยากร Dependency
- อัปเดตทรัพยากร Dependency ของ
androidx.lifecycleเป็นเวอร์ชัน 2.10.0 แล้ว I4505a9f9a
เวอร์ชัน 2.10.1
9 กันยายน 2026
androidx.navigation:navigation-*:2.10.1 เผยแพร่แล้ว เวอร์ชัน 2.10.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ในกรณีที่
NavHostข้ามภาพเคลื่อนไหว ตอนนี้ระบบจะพิจารณาsizeTransformเป็นส่วนหนึ่งของภาพเคลื่อนไหวที่ข้ามด้วยเพื่อป้องกันไม่ให้เกิดการตัดภาพที่ไม่คาดคิด (I4f995, b/550924680)
เวอร์ชัน 2.10.0
26 สิงหาคม 2026
androidx.navigation:navigation-*:2.10.0 เผยแพร่แล้ว เวอร์ชัน 2.10.0 มี Commit เหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.9.0:
- ตอนนี้
NavHostมีการโอเวอร์โหลดที่ยอมรับพารามิเตอร์predictivePopEnterTransitionและpredictivePopExitTransitionเพื่ออนุญาตให้มีการเปลี่ยนที่กำหนดเองระหว่างท่าทางสัมผัสการย้อนกลับที่คาดการณ์ได้ handleDeepLinkได้รับการแก้ไขเพื่อให้แน่ใจว่าระบบจะจัดการเฉพาะ Deep Link ที่รู้จักเท่านั้น และจะไม่สนใจ Deep Link อื่นๆ ทั้งหมด หากวิธีนี้ทำให้เกิดข้อผิดพลาดในแอป ให้พิจารณาความเป็นไปได้ในการเปลี่ยนไปใช้การไปยังส่วนต่างๆ ผ่าน Deep Link ที่กำหนดไว้ในกราฟการนำทาง สำหรับการทดสอบ Robolectric คุณอาจต้องใช้เมธอดsetPackageกับแพ็กเกจที่เชื่อถือได้- เพิ่ม
NavBackStackEntryInfoเพื่อแสดงภาพรวมของ Back Stack ในระหว่างเหตุการณ์การนำทาง ซึ่งจะช่วยให้ภาพเคลื่อนไหวของการย้อนกลับที่คาดการณ์ได้แบบกำหนดเองมีความสมบูรณ์ยิ่งขึ้น
การรองรับแพลตฟอร์มเพิ่มเติม
- โมดูล
navigation-common,navigation-runtimeและnavigation-testingเพิ่มการรองรับdesktop,linux,macOS,iOS,javascript,WASM,watchosและtvos
เวอร์ชัน 2.10.0-rc01
12 สิงหาคม 2569
androidx.navigation:navigation-*:2.10.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.10.0-rc01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงพฤติกรรม
- SDK ขั้นต่ำสำหรับการนำทางได้ย้ายไปยัง API 24 พร้อมกับไลบรารี AndroidX ที่เหลือ (I972da, b/474169350)
เวอร์ชัน 2.10.0-beta01
29 กรกฎาคม 2569
androidx.navigation:navigation-*:2.10.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.10.0-beta01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เปิดตัว
NavBackStackEntryInfoเพื่อแสดงสแนปชอต Back Stack ระหว่างเหตุการณ์การนำทาง ซึ่งจะช่วยให้ภาพเคลื่อนไหวของการย้อนกลับที่คาดการณ์ได้ซึ่งกำหนดเองมีความสมบูรณ์ยิ่งขึ้น (Icb3b8)
เวอร์ชัน 2.10.0-alpha06
1 กรกฎาคม 2026
androidx.navigation:navigation-*:2.10.0-alpha06 เผยแพร่แล้ว เวอร์ชัน 2.10.0-alpha06 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไข
handleDeepLinkเพื่อให้แน่ใจว่าระบบจะจัดการเฉพาะ Deep Link ที่รู้จักเท่านั้น (Id4fe3, b/509640056) - เปลี่ยน
ComposableFragmentให้ใช้ชื่อที่สมบูรณ์ในตัวเองจากปลายทางแทนอาร์กิวเมนต์ Fragment เพื่อขยายฟังก์ชันที่ประกอบกันได้ (I65ded, b/509640586) - แก้ไขข้อขัดข้องใน
FragmentNavigatorที่ทำให้ Fragment ที่ถูกต้องแสดงIllegalArgumentExceptionเมื่อมีการเพิ่มประสิทธิภาพการดำเนินการ (I093b0, b/340202276) - แก้ไขข้อผิดพลาดในการนําทางด้วย Fragment ซึ่งการตั้งค่ากราฟแบบเป็นโปรแกรมจะกู้คืนไม่ถูกต้อง (I41251, b/321147435)
เวอร์ชัน 2.10.0-alpha05
19 พฤษภาคม 2026
androidx.navigation:navigation-*:2.10.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 2.10.0-alpha05 มีคอมมิตเหล่านี้
เวอร์ชัน 2.10.0-alpha04
6 พฤษภาคม 2026
androidx.navigation:navigation-*:2.10.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.10.0-alpha04 มี คอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ปรับปรุง
NavHostเพื่อป้องกันNullPointerExceptionที่อาจเกิดขึ้นจากภาวะแข่งขันด้วยการย้อนกลับที่คาดการณ์ได้ (Ie36c6, b/500945998)
เวอร์ชัน 2.10.0-alpha03
22 เมษายน 2026
androidx.navigation:navigation-*:2.10.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.10.0-alpha03 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- อัปเดต Compose
compileSdkเป็น API 37 แล้ว ซึ่งหมายความว่าต้องใช้ AGP เวอร์ชัน 9.2.0 เป็นอย่างน้อยเมื่อใช้ Compose (Id45cd, b/413674743)
การมีส่วนร่วมจากภายนอก
- เพิ่มเป้าหมาย
watchosและtvosลงในโมดูลnavigation-common,navigation-runtimeและnavigation-testing(I60e46) - ทำให้
DefaultNavTransitionsเป็นสาธารณะ (Ide293)
เวอร์ชัน 2.10.0-alpha02
25 มีนาคม 2026
androidx.navigation:navigation-*:2.10.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.10.0-alpha02 มี Commit เหล่านี้
เวอร์ชัน 2.10.0-alpha01
11 มีนาคม 2026
androidx.navigation:navigation-*:2.10.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.10.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้
NavHostมีการโอเวอร์โหลดที่ยอมรับพารามิเตอร์predictivePopEnterTransitionและpredictivePopExitTransitionเพื่ออนุญาตให้มีการเปลี่ยนที่กำหนดเองระหว่างท่าทางสัมผัสการย้อนกลับที่คาดการณ์ได้ (Iac9b0, b/478294569)
การอัปเดต SDK ขั้นต่ำ
- minSdk เริ่มต้นเปลี่ยนจาก API 21 เป็น API 23 พร้อมกับไลบรารี AndroidX ที่เหลือ (Ibdfca, b/380448311, b/435705964, b/435705223)
การมีส่วนร่วมจากภายนอก
- ตอนนี้
navigation:navigation-common,navigation:navigation-runtimeและnavigation:navigation-testingรองรับเดสก์ท็อป, Linux, macOS, iOS, JavaScript และ WASM นอกเหนือจาก Android แล้ว ขอขอบคุณ Konstantin Tskhovrebov (I035d9, Iec624, I1615d)
เวอร์ชัน 2.9
เวอร์ชัน 2.9.8
22 เมษายน 2026
androidx.navigation:navigation-*:2.9.8 เผยแพร่แล้ว เวอร์ชัน 2.9.8 มี คอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ปรับปรุง
NavHostเพื่อป้องกันNullPointerExceptionที่อาจเกิดขึ้นจากภาวะแข่งขันด้วยการย้อนกลับที่คาดการณ์ได้ (Ie36c6, b/500945998)
เวอร์ชัน 2.9.7
28 มกราคม 2026
androidx.navigation:navigation-*:2.9.7 เผยแพร่แล้ว เวอร์ชัน 2.9.7 มี คอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- Navigation
SafeArgsไม่มีปัญหาการแคชการกำหนดค่าอีกต่อไปเมื่อใช้กับบริการของ Google (I57cda, b/458071608) - แก้ไขตัวสร้าง
SavedStateHandleทดสอบในการทดสอบการนำทางที่ไม่ถอดรหัสList<String>(I26aac,b/454180135)
เวอร์ชัน 2.9.6
5 พฤศจิกายน 2025
androidx.navigation:navigation-*:2.9.6 เผยแพร่แล้ว เวอร์ชัน 2.9.6 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ปลั๊กอิน Navigation
SafeArgsได้ย้ายข้อมูลไปยัง API ของปลั๊กอิน Android Gradle เวอร์ชันใหม่แล้ว ซึ่งจะช่วยให้มั่นใจได้ว่าปลั๊กอินจะเข้ากันได้กับ AGP 8.4.2 ขึ้นไปทุกรุ่น การเปลี่ยนแปลงเหล่านี้ส่งผลให้ไดเรกทอรีเอาต์พุตสำหรับไฟล์ที่สร้างโดยปลั๊กอินเปลี่ยนไปเป็นตำแหน่งเริ่มต้นที่ AGP ระบุ (Ie09d6, I7c431, b/203559535, b/293920476, b/269532448, b/443261197) - ปลั๊กอิน
SafeArgsของ Navigation จะไม่จำเป็นต้องตั้งค่าพร็อพเพอร์ตี้useAndroidXอีกต่อไปเมื่อใช้กับ AGP 9.0.0-alpha04 ขึ้นไป (I6c3a4, b/444746731, b/443106400)
เวอร์ชัน 2.9.5
24 กันยายน 2025
androidx.navigation:navigation-*:2.9.5 เผยแพร่แล้ว เวอร์ชัน 2.9.5 มี คอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้ Navigation Safe Args สามารถจัดการการรองรับ Kotlin ในตัวของ AGP 9.0 ได้แล้ว (I1d9d76)
การอัปเดตทรัพยากร Dependency
- ตอนนี้ปลั๊กอิน Navigation Safe Args จะขึ้นอยู่กับปลั๊กอิน Android Gradle เวอร์ชัน 8.4.2 (b/431847270, I5932a)
เวอร์ชัน 2.9.4
10 กันยายน 2025
androidx.navigation:navigation-*:2.9.4 เผยแพร่แล้ว เวอร์ชัน 2.9.4 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ป้องกันไม่ให้แอปขัดข้องเมื่อมีการส่งเหตุการณ์การย้อนกลับที่คาดการณ์ได้ในช่วงกลางเฟรมหลังจากปิดใช้แฮนเดิลในการเปลี่ยนผ่าน
NavHost(I5667c, b/384186542)
เวอร์ชัน 2.9.3
30 กรกฎาคม 2025
androidx.navigation:navigation-*:2.9.3 เผยแพร่แล้ว เวอร์ชัน 2.9.3 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อผิดพลาดใน
NavControllerที่ทำให้เกิดConcurrentModificationExceptionเมื่อใช้OnDestinationChangedListeners(If7406, b/417784831) - แก้ไขข้อผิดพลาดเมื่อใช้
navigate(uri, navOptions,navigationExtras)โดยที่ระบบละเว้นส่วนเสริม (I67fb7, b/430336813)
เวอร์ชัน 2.9.2
16 กรกฎาคม 2025
androidx.navigation:navigation-*:2.9.2 เผยแพร่แล้ว เวอร์ชัน 2.9.2 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่รายการไม่กลับมาทำงานอีกครั้งเมื่อปิดกล่องโต้ตอบเหนือรายการ (Idb20e, b/418746335)
- แก้ไขข้อผิดพลาด
MissingFieldExceptionเมื่อทดสอบSavedStateHandleด้วยเส้นทางที่ปลอดภัยในการกำหนดประเภทขณะใช้NavTypesที่กำหนดเอง (I2f843, b/421002511)
เวอร์ชัน 2.9.1
2 กรกฎาคม 2025
androidx.navigation:navigation-*:2.9.1 เผยแพร่แล้ว เวอร์ชัน 2.9.1 มี Commit เหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ทำให้
NavEntriesซึ่งสร้างอินสแตนซ์โดยใช้ Single Top ไม่เคยเกิน CREATED ในLifecycle.State(I043ba, b/421095236)
เวอร์ชัน 2.9.0
7 พฤษภาคม 2025
androidx.navigation:navigation-*:2.9.0 เผยแพร่แล้ว เวอร์ชัน 2.9.0 มี Commit เหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.8.0
- ตอนนี้ระบบจะสร้างการดำเนินการ Navigation Safe Args ด้วยคำอธิบายประกอบ
@CheckResultเพื่อให้มั่นใจว่ามีการใช้งาน
อินเทอร์เฟซ SupportingPane
- ตอนนี้ Custom Navigator สามารถทำเครื่องหมายปลายทางว่าใช้อินเทอร์เฟซ
SupportingPaneซึ่งจะระบุให้NavControllerทราบว่าปลายทางเหล่านี้จะแสดงควบคู่ไปกับปลายทางอื่นๆ ตัวอย่างเช่น การใช้อินเทอร์เฟซนี้จะช่วยให้คุณRESUMEDปลายทางหลายแห่งพร้อมกันได้
Compose Kotlin Multiplatform
- ตอนนี้การนำทางมีฟังก์ชัน
NavController.handleDeepLink()ทั่วไปใหม่ที่ใช้NavDeepLinkRequestแทนIntentซึ่งจะช่วยให้แพลตฟอร์มอื่นๆ นอกเหนือจาก Android จัดการ Deep Link ได้อย่างเหมาะสม ขอขอบคุณ Konstantin Tskhovrebov - ตอนนี้ Navigation มี
NavUriซึ่งเป็นฟังก์ชันโปรแกรมแยกวิเคราะห์ทั่วไปใหม่ที่เป็น API ที่เข้ากันได้กับ URI ของ Android ในแพลตฟอร์มอื่นๆ ซึ่งจะช่วยให้สร้าง URI ในลักษณะที่ไม่ขึ้นอยู่กับแพลตฟอร์มได้ ขอขอบคุณ Konstantin Tskhovrebov
ฟังก์ชัน Type Safe
- API ที่ปลอดภัยในการกำหนดประเภทซึ่งก่อนหน้านี้เข้าถึงได้ผ่านเมธอด
reifiedเท่านั้น เช่น ตอนนี้composable<YourScreen>มีเวอร์ชันที่ไม่ใช่ Reified ซึ่งใช้อินสแตนซ์KClassโดยตรง - ตอนนี้ความปลอดภัยในการกำหนดประเภทการนำทางรองรับคลาสค่าเป็นเส้นทางหรือเป็นประเภทอาร์กิวเมนต์ของเส้นทางแล้ว
เวอร์ชัน 2.9.0-rc01
23 เมษายน 2025
androidx.navigation:navigation-*:2.9.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.9.0-rc01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- นำเป้าหมายแพลตฟอร์มที่ไม่ใช่ Android ทั้งหมดออกจาก Jetpack Navigation เนื่องจากเป้าหมายเหล่านั้นใช้งานไม่ได้จริง ตอนนี้เรามีสตับสำหรับแพลตฟอร์มต่างๆ แทนแล้ว (I2877d)
เวอร์ชัน 2.9.0-beta01
9 เมษายน 2025
androidx.navigation:navigation-*:2.9.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.9.0-beta01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- API ทั่วไปของ
parseStringAsNavUriเปลี่ยนเป็นฟังก์ชันแฟกทอรีNavUriที่ใช้สตริง (I4db6e, b/403616316)
การอัปเดตทรัพยากร Dependency
- ตอนนี้ไลบรารีนี้กำหนดเป้าหมายเป็นระดับภาษา Kotlin 2.0 และต้องใช้ KGP 2.0.0 ขึ้นไป (Idb6b5)
เวอร์ชัน 2.9.0-alpha09
26 มีนาคม 2025
androidx.navigation:navigation-*:2.9.0-alpha09 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha09 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้โมดูล
navigation-testingรองรับเดสก์ท็อป, Linux, macOS และ iOS นอกเหนือจาก Android แล้ว (I2b770, b/398265336) - ตอนนี้
NavTypeรองรับการใช้งานบนเดสก์ท็อป, Linux, macOS และ iOS นอกเหนือจาก Android แล้ว (I297d8)
เวอร์ชัน 2.9.0-alpha08
12 มีนาคม 2025
androidx.navigation:navigation-*:2.9.0-alpha08 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha08 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- จาก Navigation
2.8.9: แก้ไขการถดถอยที่พบใน Navigation 2.8.8 ซึ่งกำหนดให้ Deep Link ต้องตรงกับช่องทั้งหมดของคำขอหรือ Intent ของ Deep Link ทุกประการจึงจะถือว่าตรงกัน ซึ่งทำให้ Deep Link ที่มีการจับคู่ฟิลด์บางส่วนและไม่มีฟิลด์อื่นๆ ใช้งานไม่ได้อีกต่อไป (Ie5e36, b/399826566)
การมีส่วนร่วมจากภายนอก
- ฟังก์ชันโปรแกรมแยกวิเคราะห์ทั่วไปใหม่เพื่อสร้าง
NavUriขอขอบคุณ Konstantin Tskhovrebov (If0a6a)
เวอร์ชัน 2.9.0-alpha07
26 กุมภาพันธ์ 2025
androidx.navigation:navigation-*:2.9.0-alpha07 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha07 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่การพยายาม
saveStateด้วยป๊อปอัปที่ไม่ครอบคลุมจะส่งผลให้เกิด savedState ที่เป็นค่าว่าง ซึ่งอาจทำให้เกิดข้อขัดข้องในการกู้คืน (I9f3e8, b/395091644) - ตั้งแต่ Navigation 2.8.8: การจับคู่
NavDeepLinkได้รับการแก้ไขแล้ว โดยที่ Deep Link และคำขอ Deep Link ต้องตรงกันทุกประการทั้งในส่วน URI, การดำเนินการ และ MIME ระบบจะไม่อนุญาตให้จับคู่หากมีฟิลด์ที่ตรงกันเพียง 1 หรือ 2 ฟิลด์ (I3b029, b/395712033) - จาก Navigation 2.8.8: แก้ไขข้อบกพร่องที่เส้นทางที่มีเส้นทางไวลด์การ์ดไม่ตรงกับ Deep Link ที่เพิ่ม (I7ea92, b/389970341)
การมีส่วนร่วมจากภายนอก
- แยก API ของ navigation-common, navigation-runtime และ navigation-compose ไปยังแพลตฟอร์มทั่วไป ขอขอบคุณ Konstantin Tskhovrebov (I1e626, Ica76f, Idf479)
ปัญหาที่ทราบ
- เนื่องจากงานที่ต้องทำเพื่อแก้ไข b/395712033 ระบบจึงกำหนดให้ Deep Link ต้องมีช่องทั้งหมดเหมือนกับคำขอ Deep Link และ/หรือ
Intentอย่างไม่ถูกต้อง Deep Link ควรต้องตรงกับช่องที่มีเท่านั้น และควรละเว้นช่องที่ไม่ได้รวมไว้ ปัญหานี้ได้รับการแก้ไขแล้วสำหรับรุ่นที่ใหม่กว่าซึ่งเป็นส่วนหนึ่งของ b/399826566
เวอร์ชัน 2.9.0-alpha06
12 กุมภาพันธ์ 2025
androidx.navigation:navigation-*:2.9.0-alpha06 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha06 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้ระบบจะสร้างการดำเนินการ Navigation Safe Args ด้วยคำอธิบายประกอบ
@CheckResultเพื่อให้มั่นใจว่ามีการใช้งาน (I14d4c, b/356323084)
แก้ไขข้อบกพร่อง
- แก้ไขข้อผิดพลาดใน
NavControllerซึ่งระบบพยายามกู้คืนสถานะ backStack เป็นอาร์เรย์อย่างไม่ถูกต้องเมื่อบันทึกสถานะเหล่านั้นลงในรายการ (Idfb9b) - จาก Navigation
2.8.7: ตอนนี้ Navigation Safe Args รองรับปลายทาง Composable แล้ว (I35320, b/362791955)
เวอร์ชัน 2.9.0-alpha05
29 มกราคม 2025
androidx.navigation:navigation-*:2.9.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha05 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ทำให้เกิดภาพเคลื่อนไหวการปรับขนาดที่ไม่คาดคิดเมื่อใช้ Navigation Compose (I480f4, b/353294030)
- จากการนำทาง
2.8.6: ป้ายกำกับNavDestinationที่ระบุผ่าน XML จะได้รับการแยกวิเคราะห์ผ่านNavType.getเพื่อให้แน่ใจว่าระบบจะปฏิบัติตามตรรกะNavTypeที่กำหนดเอง (I7ec2f, b/388100796) - จาก Navigation
2.8.6: เมื่อไปยังกิจกรรมที่มีdataPatternตอนนี้ActivityNavigatorจะพยายามเข้ารหัสค่าอาร์กิวเมนต์ด้วยNavTypeของอาร์กิวเมนต์ (I16376, b/383616432) - จากการนำทาง
2.8.5: แก้ไขปัญหาที่ทำให้เกิดภาพเคลื่อนไหวปรับขนาดที่ไม่คาดคิดเมื่อใช้ Navigation Compose และเรียกใช้การนำทางในเฟรมเดียวกับที่ภาพเคลื่อนไหวปัจจุบันกำลังจะสิ้นสุด (I26cb1, b/353294030)
เวอร์ชัน 2.9.0-alpha04
11 ธันวาคม 2024
androidx.navigation:navigation-*:2.9.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha04 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- API ที่ปลอดภัยในการกำหนดประเภทซึ่งก่อนหน้านี้เข้าถึงได้ผ่านเมธอด
reifiedเท่านั้น เช่นcomposable<YourScreen>ตอนนี้มีเวอร์ชันที่ไม่ใช่ Reified ซึ่งรับอินสแตนซ์KClassโดยตรง (Ia7eed, Id2879, Ibf244, I17d79, Id09d2, I54696, Ia47be, I93281, Ic1bf0, Iba4ee, If56a5, Icf969, I67644, I6f788, b/382094941, b/366291612, b/381938808)
ตารางด้านล่างแสดง API ของ Reified และ KClass
| reified | 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
- โอเวอร์โหลด
NavGraph.setStartDestinationเฉพาะ Kotlin สำหรับความปลอดภัยในการกำหนดประเภทจะซ่อนจากแหล่งที่มาของ Java (Ic640c, b/364634035)
แก้ไขข้อบกพร่อง
- จาก Navigation
2.8.5: แก้ไขปัญหาที่NavHostอาจแสดงข้อยกเว้นภายในPredictiveBackHandlerหาก Back Stack ถูกป๊อปอัปเหลือ 1 รายการและมีการทริกเกอร์การย้อนกลับของระบบในเฟรมเดียวกัน (I1a429, b/375343407) - จากการนําทาง
2.8.5: แก้ไขNavDestinationNullPointerExceptionเมื่ออัปเดตstartDestinationของกราฟ (I99421, b/361560785)
การมีส่วนร่วมจากภายนอก
- จากการนำทาง
2.8.5: ความปลอดภัยในการกำหนดประเภทการนำทางรองรับList<Enum>เป็นประเภทอาร์กิวเมนต์ของเส้นทางแล้วโดยไม่ต้องใช้NavTypeที่กำหนดเอง ขอขอบคุณ Csaba Kozák (GH-725, b/375559962)
เวอร์ชัน 2.9.0-alpha03
13 พฤศจิกายน 2024
androidx.navigation:navigation-*:2.9.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha03 มี คอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้ความปลอดภัยในการกำหนดประเภทการนำทางรองรับคลาสค่าเป็นเส้นทางหรือเป็นประเภทอาร์กิวเมนต์ของเส้นทางแล้ว (I9344a, b/374347483)
แก้ไขข้อบกพร่อง
- แก้ไข
ConcurrentModificationExceptionที่อาจเกิดขึ้นเมื่อLifecycleObserverที่แนบมากับNavBackStackEntryทริกเกอร์การเปลี่ยนแปลง Back Stack เมื่อโฮสต์LifecycleOwnerเช่น Activity หรือ Fragment ที่มีอยู่เปลี่ยนสถานะวงจร (Ia9494)
เวอร์ชัน 2.9.0-alpha02
30 ตุลาคม 2024
androidx.navigation:navigation-*:2.9.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha02 มีคอมมิตเหล่านี้
การมีส่วนร่วมจากภายนอก
- เมธอด
NavController.handleDeepLink(request: NavDeepLinkRequest)ทั่วไปใหม่ ขอขอบคุณ Konstantin Tskhovrebov (I3e228)
เวอร์ชัน 2.9.0-alpha01
16 ตุลาคม 2024
androidx.navigation:navigation-*:2.9.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้ Custom Navigator สามารถทำเครื่องหมายปลายทางว่าใช้อินเทอร์เฟซ
SupportingPaneซึ่งจะระบุให้NavControllerทราบว่าปลายทางเหล่านี้จะแสดงควบคู่ไปกับปลายทางอื่นๆ ตัวอย่างเช่น การใช้อินเทอร์เฟซนี้จะช่วยให้คุณRESUMEDปลายทางหลายแห่งพร้อมกันได้ (Id5559) - จาก Navigation
2.8.3: เพิ่มการตรวจสอบ Lint ใหม่สำหรับโมดูลnavigation-common,navigation-runtimeและnavigation-composeเพื่อช่วยระบุเส้นทางที่ปลอดภัยในการกำหนดประเภทซึ่งไม่ได้ใส่คำอธิบายประกอบอย่างถูกต้องด้วย@Serializableการตรวจสอบนี้ใช้กับฟังก์ชันส่วนขยายNavGraphBuilderและNavDeepLinkBuilderทั้งหมด (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816) - จากการนำทาง
2.8.3: เพิ่มการตรวจสอบ Lint ใหม่สำหรับโมดูลnavigation-common,navigation-runtimeและnavigation-composeเพื่อช่วยระบุเส้นทางที่ปลอดภัยต่อประเภทซึ่งมีอาร์กิวเมนต์ Enum ที่ไม่ได้ใส่คำอธิบายประกอบอย่างถูกต้องด้วย@Keepการตรวจสอบนี้ใช้กับฟังก์ชันส่วนขยายNavGraphBuilderและNavDeepLinkBuilderทั้งหมด (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)
การเปลี่ยนแปลงพฤติกรรม
- การพยายามใช้
NavControllerที่DESTROYEDไปก่อนหน้านี้จะทำให้เกิดIllegalStateException(I520da, b/369616172)
แก้ไขข้อบกพร่อง
- อัปเดตข้อยกเว้นไม่พบคลาส Enum เพื่อแนะนำให้ใช้คำอธิบายประกอบ
@Keepในกรณีที่คลาส Enum ถูกลบในบิลด์ที่ลดขนาด (I90e79, b/358137294)
ปัญหาที่ทราบ
- มีปัญหาเกี่ยวกับกฎ Lint ใหม่ที่เพิ่มเข้ามาใน
Navigation 2.8.*ซึ่งทำให้เกิดข้อผิดพลาดObsolete custom lint checkเมื่อพยายามเรียกใช้ Lint ด้วยปลั๊กอิน Android Gradle 8.4 ขึ้นไป (b/368070326, b/371463741)
เวอร์ชัน 2.8
เวอร์ชัน 2.8.9
12 มีนาคม 2025
androidx.navigation:navigation-*:2.8.9 เผยแพร่แล้ว เวอร์ชัน 2.8.9 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขการถดถอยที่พบใน Navigation 2.8.8 ซึ่งกำหนดให้ Deep Link ต้องตรงกับช่องทั้งหมดของคำขอหรือ Intent ของ Deep Link ทุกประการจึงจะถือว่าตรงกัน ซึ่งทำให้ Deep Link ที่มีการจับคู่ฟิลด์บางส่วนและไม่มีฟิลด์อื่นๆ ใช้งานไม่ได้อีกต่อไป (Ie5e36, b/399826566)
เวอร์ชัน 2.8.8
26 กุมภาพันธ์ 2025
androidx.navigation:navigation-*:2.8.8 เผยแพร่แล้ว เวอร์ชัน 2.8.8 มี คอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่เส้นทางที่มีเส้นทางไวลด์การ์ดไม่ตรงกับ Deep Link ที่เพิ่ม (I7ea92, b/389970341)
- แก้ไขการจับคู่
NavDeepLinkแล้ว โดยที่ Deep Link และคำขอ Deep Link ต้องตรงกันทุกประการใน URI, การดำเนินการ และ MIME ระบบจะไม่อนุญาตให้จับคู่หากมีฟิลด์ที่ตรงกันเพียง 1 หรือ 2 ฟิลด์ (I3227f, b/395712033)
ปัญหาที่ทราบ
- เนื่องจากงานที่ต้องทำเพื่อแก้ไข b/395712033 ระบบจึงกำหนดให้ Deep Link ต้องมีช่องทั้งหมดเหมือนกับคำขอ Deep Link และ/หรือ
Intentอย่างไม่ถูกต้อง Deep Link ควรต้องตรงกับช่องที่มีเท่านั้น และควรละเว้นช่องที่ไม่ได้รวมไว้ ปัญหานี้ได้รับการแก้ไขแล้วสำหรับรุ่นที่ใหม่กว่าซึ่งเป็นส่วนหนึ่งของ b/399826566
เวอร์ชัน 2.8.7
12 กุมภาพันธ์ 2025
androidx.navigation:navigation-*:2.8.7 เผยแพร่แล้ว เวอร์ชัน 2.8.7 มี คอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้ Navigation Safe Args รองรับปลายทางที่ประกอบกันได้แล้ว (I35320, b/362791955)
เวอร์ชัน 2.8.6
29 มกราคม 2025
androidx.navigation:navigation-*:2.8.6 เผยแพร่แล้ว เวอร์ชัน 2.8.6 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ระบบจะแยกวิเคราะห์ป้ายกำกับ
NavDestinationที่ระบุผ่าน XML ผ่านNavType.getเพื่อให้แน่ใจว่าระบบจะปฏิบัติตามตรรกะNavTypeที่กำหนดเอง (Id366d, b/388100796) - เมื่อไปยังกิจกรรมด้วย
dataPatternตอนนี้ActivityNavigatorจะพยายามเข้ารหัสค่าอาร์กิวเมนต์ด้วยNavTypeของอาร์กิวเมนต์ (I1a71d, b/383616432)
เวอร์ชัน 2.8.5
11 ธันวาคม 2024
androidx.navigation:navigation-*:2.8.5 เผยแพร่แล้ว เวอร์ชัน 2.8.5 มี คอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่
NavHostอาจแสดงข้อยกเว้นภายในPredictiveBackHandlerหาก Back Stack ถูกป๊อปอัปเหลือ 1 รายการและมีการเรียกใช้การย้อนกลับของระบบในเฟรมเดียวกัน (I1a429, b/375343407) - แก้ไข
NavDestinationNullPointerExceptionเมื่ออัปเดตstartDestinationของกราฟ (I99421, b/361560785) - แก้ไขปัญหาที่ทำให้เกิดภาพเคลื่อนไหวการปรับขนาดที่ไม่คาดคิดเมื่อใช้ Navigation Compose และเรียกใช้การไปยังส่วนต่างๆ ในเฟรมเดียวกันกับที่ภาพเคลื่อนไหวปัจจุบันกำลังจะสิ้นสุด (I26cb1, b/353294030)
- แก้ไข
ConcurrentModificationExceptionที่อาจเกิดขึ้นเมื่อLifecycleObserverที่แนบมากับNavBackStackEntryทริกเกอร์การเปลี่ยนแปลง Back Stack เมื่อโฮสต์LifecycleOwnerเช่น Activity หรือ Fragment ที่มีอยู่เปลี่ยนสถานะวงจร (Ia9494)
การมีส่วนร่วมจากภายนอก
- ตอนนี้ความปลอดภัยในการกำหนดประเภทการนำทางรองรับ
List<Enum>เป็นประเภทอาร์กิวเมนต์ของเส้นทางโดยไม่ต้องใช้NavTypeที่กำหนดเอง ขอขอบคุณ Csaba Kozák (GH-725, b/375559962)
เวอร์ชัน 2.8.4
13 พฤศจิกายน 2024
androidx.navigation:navigation-*:2.8.4 เผยแพร่แล้ว เวอร์ชัน 2.8.4 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- จาก Navigation
2.9.0-alpha03: ตอนนี้ความปลอดภัยในการกำหนดประเภทของการนำทางรองรับคลาสค่าเป็นเส้นทางหรือเป็นประเภทอาร์กิวเมนต์ของเส้นทาง (I9344a, b/374347483)
แก้ไขข้อบกพร่อง
- จาก Navigation
2.9.0-alpha01: การพยายามใช้NavControllerที่เคยDESTROYEDมาก่อนจะทำให้เกิดIllegalStateException(I520da, b/369616172)
เวอร์ชัน 2.8.3
16 ตุลาคม 2024
androidx.navigation:navigation-*:2.8.3 เผยแพร่แล้ว เวอร์ชัน 2.8.3 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่มการตรวจสอบ Lint ใหม่สำหรับโมดูล
navigation-common,navigation-runtimeและnavigation-composeเพื่อช่วยระบุเส้นทางที่ปลอดภัยในการกำหนดประเภทซึ่งไม่ได้ใส่คำอธิบายประกอบอย่างถูกต้องด้วย@Serializableการตรวจสอบนี้ใช้กับฟังก์ชันส่วนขยายNavGraphBuilderและNavDeepLinkBuilderทั้งหมด (I4a259, I95402, Ie601a, Id8c6e, I28bda, b/362725816) - เพิ่มการตรวจสอบ Lint ใหม่สำหรับโมดูล
navigation-common,navigation-runtimeและnavigation-composeเพื่อช่วยระบุเส้นทางที่ปลอดภัยในการกำหนดประเภทซึ่งมีอาร์กิวเมนต์ Enum ที่ไม่ได้ใส่คำอธิบายประกอบอย่างถูกต้องด้วย@Keepการตรวจสอบนี้ใช้กับฟังก์ชันส่วนขยายNavGraphBuilderและNavDeepLinkBuilderทั้งหมด (I4a259, I95402, Ie601a, Id8c6e, I2b46f, b/358687142)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่กฎ Lint ใหม่ที่เพิ่มใน
Navigation 2.8.*ทำให้เกิดข้อผิดพลาดObsolete custom lint checkเมื่อพยายามเรียกใช้ Lint ด้วยปลั๊กอิน Android Gradle 8.4 ขึ้นไป (I1be3d, b/368070326, b/371463741)
ปัญหาที่ทราบ
- Navigation Lint จะแสดงข้อผิดพลาด "Obsolete custom lint check" เมื่อพยายามเรียกใช้ Lint ด้วย Lint 16 (AGP 8.7) ขึ้นไป (b/371926651)
เวอร์ชัน 2.8.2
2 ตุลาคม 2024
androidx.navigation:navigation-*:2.8.2 เผยแพร่แล้ว เวอร์ชัน 2.8.2 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้ความปลอดภัยในการกำหนดประเภทการนำทางรองรับคลาสที่ทำให้เป็นอนุกรมได้ซึ่งรวมถึง
Double,Double?,DoubleArray,DoubleArray?,List<Double>และList<Double>?โดยไม่ต้องใช้NavTypeที่กำหนดเอง (I570eb, Ibc4c0, I37461, I5bed4, b/359245753)
แก้ไขข้อบกพร่อง
- ปรับปรุงข้อความแสดงข้อผิดพลาดเมื่อการนําทางไม่สามารถแมปอาร์กิวเมนต์ของเส้นทางกับ
NavTypeข้อความแสดงข้อผิดพลาดใหม่จะมีชื่ออาร์กิวเมนต์ ชื่อที่สมบูรณ์ของอาร์กิวเมนต์ และชื่อที่สมบูรณ์ของเส้นทาง (Id8416, b/346264232)
เวอร์ชัน 2.8.1
18 กันยายน 2024
androidx.navigation:navigation-*:2.8.1 เผยแพร่แล้ว เวอร์ชัน 2.8.1 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่มกฎ Lint ใหม่เพื่อให้แน่ใจว่ามีการใช้ฟังก์ชัน
popBackStackที่ใช้ประเภทคลาสที่ได้รับการตรวจสอบเมื่อพยายามpopBackStackโดยใช้ API ที่ปลอดภัยในการกำหนดประเภท (Ief161, b/358095343)
แก้ไขข้อบกพร่อง
- ตอนนี้การนำทางกำหนดให้เส้นทางที่ส่งไปยัง
startDestinationของNavGraphต้องมีค่าสำหรับอาร์กิวเมนต์ที่จำเป็นทั้งหมด ซึ่งรวมถึงอาร์กิวเมนต์ที่ไม่มีค่า Null และไม่มีค่าเริ่มต้น (I18e74, b/362594265) - Navigation Safe Args ได้เพิ่มการรองรับสตริงที่ไม่มีค่า Null เพื่อให้ระบบแยกวิเคราะห์ค่า "Null" และจัดเก็บไว้ใน Bundle ตามที่เป็นอยู่ ซึ่งแตกต่างจากลักษณะการทำงานเดิมที่ระบบจะแยกวิเคราะห์ค่า "Null" เป็นออบเจ็กต์ Null การเปลี่ยนแปลงนี้มีผลกับประเภทสตริงที่ไม่มีค่า Null เท่านั้น สตริงที่อนุญาตค่า Null จะยังคงเหมือนเดิม (I08b4a, b/348936238)
NavDestinationจะไม่สามารถทำ Deep Link ได้อีกต่อไป ยกเว้นผ่าน Deep Link ที่เพิ่มลงในปลายทางอย่างชัดแจ้ง ซึ่งหมายความว่าคุณจะไปยังเส้นทางของปลายทางได้ด้วยโอเวอร์โหลดของฟังก์ชันการนำทางที่ใช้เส้นทางสตริงเท่านั้น การดำเนินการนี้จะแก้ไขช่องโหว่ที่ทำให้สามารถทำ Deep Link ไปยังปลายทางที่อาจได้รับการปกป้องได้ (Ie30e6)
การอัปเดตทรัพยากร Dependency
- ตอนนี้ Navigation Safe Args จะขึ้นอยู่กับ Kotlin 1.9.24 แทน Kotlin 2.X เพื่อให้นักพัฒนาแอปไม่ต้องอัปเดต (a4129a)
- ตอนนี้ Navigation Compose จะขึ้นอยู่กับ Compose
1.7.2
เวอร์ชัน 2.8.0
4 กันยายน 2024
androidx.navigation:navigation-*:2.8.0 เผยแพร่แล้ว เวอร์ชัน 2.8.0 มี Commit เหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.7.0
ความปลอดภัยในการกำหนดประเภท DSL ของ Kotlin สำหรับการนำทาง
- ตอนนี้ Navigation มีความปลอดภัยในการกำหนดประเภทสำหรับ Kotlin DSL (ใช้โดย Navigation Compose) โดยใช้ Kotlin Serialization เพื่อให้คุณกำหนดปลายทางในกราฟการนำทางผ่านออบเจ็กต์และคลาสข้อมูลที่ปลอดภัยในการกำหนดประเภทได้ ดังนี้
// 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)
}
}
ดูข้อมูลเพิ่มเติมได้ที่บล็อกโพสต์ Navigation Compose meet Type Safety
การย้อนกลับที่คาดการณ์ได้ของ Navigation Compose
- ตอนนี้ Navigation Compose รองรับการย้อนกลับในแอปที่คาดการณ์ได้ผ่าน API
SeekableTransitionStateใหม่จาก compose-animation ซึ่งจะช่วยให้คุณใช้ท่าทางสัมผัสสำหรับการย้อนกลับเพื่อดูปลายทางก่อนหน้าด้วยการเปลี่ยนที่กำหนดเองก่อนที่จะตัดสินใจว่าจะยืนยันธุรกรรมผ่านท่าทางสัมผัสที่เสร็จสมบูรณ์หรือยกเลิก
Fragment Composable สำหรับการนำทาง
- เพิ่มอาร์ติแฟกต์
navigation-fragment-composeใหม่ที่มีทางเลือกComposableNavHostFragmentแทนNavHostFragmentซึ่งช่วยให้คุณเพิ่มปลายทาง Composable ลงในไฟล์ XML ของการนำทาง ปลายทางcomposableแต่ละรายการต้องแสดงเป็นเมธอด@Composableระดับบนสุดที่ไม่มีอาร์กิวเมนต์ ซึ่งใช้ชื่อที่สมบูรณ์ในตัวเองเป็นแอตทริบิวต์android:nameในปลายทางแต่ละรายการ เมื่อไปยังปลายทางเหล่านี้ ระบบจะสร้าง Fragment ที่มีเพื่อแสดงเนื้อหา Composable
// 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" />
การเปลี่ยนแปลงอื่นๆ
- ตอนนี้ Navigation Compose จะขึ้นอยู่กับ Compose 1.7.0
- ตอนนี้การนำทางมีคลาส
CollectionNavType<T>ใหม่ ซึ่งเป็นคลาสย่อยของNavType<T>สำหรับอาร์กิวเมนต์ที่อิงตามคอลเล็กชัน เช่น รายการ อาร์เรย์ แผนที่ ตอนนี้อาร์เรย์NavTypeเริ่มต้นทั้งหมด (IntArrayType,LongArrayType,FloatArrayType,BoolArrayTypeและStringArrayType) จะรับค่าจากคลาสใหม่นี้ - ตอนนี้
NavTypeมีการรองรับในตัวสำหรับรายการ Int, String, Boolean, Float และ Long
เวอร์ชัน 2.8.0-rc01
21 สิงหาคม 2024
androidx.navigation:navigation-*:2.8.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.8.0-rc01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อขัดข้องในการนำทางเมื่อส่งคลาส Enum ระดับบนสุดเป็นอาร์กิวเมนต์ที่ปลอดภัยในการกำหนดประเภท (I0ba76, b/358137294)
- ตอนนี้ Navigation 2.8 ทำงานร่วมกับ SDK 34 ได้อย่างถูกต้องแล้ว และจะไม่เปลี่ยนไปใช้ SDK 35 จนกว่าจะมีการเปิดตัวเวอร์ชัน 2.9 พร้อมกับไลบรารี AndroidX ที่เหลือ (b/358798728)
เวอร์ชัน 2.8.0-beta07
7 สิงหาคม 2024
androidx.navigation:navigation-*:2.8.0-beta07 เผยแพร่แล้ว เวอร์ชัน 2.8.0-beta07 มีคอมมิตเหล่านี้
ปัญหาที่ทราบ
- เนื่องจาก b/358137294 ระบบจึงรองรับเฉพาะ Enum ที่ฝังอยู่ในคลาสอื่นตั้งแต่แกะกล่อง ระบบจะรองรับ Enum ระดับบนสุดในรุ่นถัดไป
แก้ไขข้อบกพร่อง
- เมื่อไปยังจุดหมายที่ซ้ำกันหรือจุดหมายที่แชร์ การนำทางจะให้ความสำคัญกับการไปยังจุดหมายที่ตรงกันซึ่งอยู่ใกล้ที่สุดจากตำแหน่งปัจจุบันในกราฟ (Ic89a4, b/352006850)
- ตอนนี้การนำทางใน Safe Args ได้เพิ่ม
NavType.EnumTypeใหม่แล้ว ซึ่งหมายความว่าEnumประเภทไม่จำเป็นต้องใช้NavTypeที่กำหนดเองอีกต่อไป โปรดทราบว่าSerialNameของEnumต้องเป็นชื่อที่สมบูรณ์ในตัวเองตามค่าเริ่มต้น (I66d22, b/346475493) - Navigation ใน Safe Args ได้เพิ่มการรองรับในตัวสำหรับประเภทอาร์กิวเมนต์ที่อนุญาตค่า Null ซึ่งรวมถึง
Int?,Long?,Float?,Boolean?และEnum<*>?(I32d13,I1c580,Ifba66,I978b0,Ide076 , b/351994237) - ตอนนี้
startDestinationของNavGraphจะใช้ค่าอาร์กิวเมนต์เริ่มต้นหากเส้นทางstartDestinationที่ส่งไปยังNavGraphเท่ากับstartDestination.routeทุกประการ (I13762, b/354046047)
เวอร์ชัน 2.8.0-beta06
24 กรกฎาคม 2024
androidx.navigation:navigation-*:2.8.0-beta06 เผยแพร่แล้ว เวอร์ชัน 2.8.0-beta06 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่การตรวจสอบ Lint ของ
WrongStartDestinationTypeไม่ได้ตรวจสอบออบเจ็กต์ Companion ในประเภทคลาสที่ส่งเข้ามา ซึ่งทำให้ Lint ตรวจไม่พบข้อผิดพลาด (I92b09)
เวอร์ชัน 2.8.0-beta05
10 กรกฎาคม 2024
androidx.navigation:navigation-*:2.8.0-beta05 เผยแพร่แล้ว เวอร์ชัน 2.8.0-beta05 มี Commit เหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อขัดข้องในการนำทาง
singleTopเมื่อNavGraphsที่ฝังอยู่แชร์เส้นทางstartDestinationเดียวกัน (I17b94, b/294408596)
เวอร์ชัน 2.8.0-beta04
26 มิถุนายน 2024
androidx.navigation:navigation-*:2.8.0-beta04 เผยแพร่แล้ว เวอร์ชัน 2.8.0-beta04 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้การนำทางรองรับการนำทางด้วยสตริงว่างในอาร์กิวเมนต์เส้นทางแล้ว (Ic5dbd, b/339481310)
- ปรับปรุงข้อความแสดงข้อผิดพลาดสำหรับ Serializer ที่กำหนดเองซึ่งประกาศโดยตรงในฟิลด์คลาสผ่าน
@Serializable(with =...)เพื่อชี้แจงว่าปัจจุบันฟีเจอร์นี้ยังไม่รองรับ (I052b0, b/341319151) - ตอนนี้คุณสามารถใช้ API ทดสอบ
SavedStateHandleFactoryในการทดสอบที่ไม่ใช่ Android ได้แล้ว แต่จะต้องใช้ Robolectric เพื่อรองรับการแยกวิเคราะห์อาร์กิวเมนต์ด้วย Bundle (I76cdc, b/340966212) - แก้ไขข้อขัดข้องจากการกู้คืนสถานะเมื่อกลับมาใช้แอปอีกครั้งหลังจากการสิ้นสุดการประมวลผลด้วยการใช้การนําทางที่ปลอดภัยต่อประเภทใน Compose (Ia8f38, b/341801005)
- แก้ไขปัญหาใน Navigation Compose ที่หลังจากยกเลิกท่าทางสัมผัสการย้อนกลับที่คาดการณ์ได้แล้ว
NavBackStackEntryที่ผู้ใช้กลับไปจะไม่กลับไปที่สถานะวงจรRESUMEDนอกจากนี้ยังช่วยให้มั่นใจว่าปลายทางที่กลับมาจะแสดงภาพเคลื่อนไหวกลับเข้ามาอย่างถูกต้องแทนที่จะดีดกลับเข้าที่หลังจากเหวี่ยง (I97a0c, b/346608857) - เมื่อใช้การย้อนกลับที่คาดการณ์ได้กับ Navigation Compose ปลายทางที่แสดงขึ้นมาจะมีลำดับ Z ที่เหมาะสม ซึ่งจะแสดงภาพเคลื่อนไหวที่ด้านบนของปลายทางขาเข้าอย่างถูกต้อง (I2077b, b/345993681)
เวอร์ชัน 2.8.0-beta03
12 มิถุนายน 2024
androidx.navigation:navigation-*:2.8.0-beta03 เผยแพร่แล้ว เวอร์ชัน 2.8.0-beta03 มี คอมมิตเหล่านี้
การเปลี่ยนแปลง API
CollectionNavTypeมีเมธอดemptyCollection()แบบนามธรรมใหม่ ลบล้างค่านี้เพื่อจัดการคอลเล็กชันว่างเปล่าที่ส่งผ่านเป็นอาร์กิวเมนต์ (Ie4d84, b/341723133)
แก้ไขข้อบกพร่อง
- เพิ่มเอกสารประกอบเกี่ยวกับ
NavType.serializeAsValueและserializeAsValuesเพื่อไฮไลต์ว่าเอาต์พุตสุดท้ายควรเข้ารหัส URI (Ida6bd, b/344943214) - แก้ไขข้อขัดข้องเมื่อเรียกใช้
toRoute<T>ด้วยอาร์กิวเมนต์CollectionNavTypeที่เป็นค่า Null เมื่อไปยังส่วนต่างๆ ด้วยCollectionNavTypeที่เป็น Null อาร์กิวเมนต์เอาต์พุตจะเป็นค่าเริ่มต้นที่ประกาศในคลาส Serializable หรือค่าที่แสดงผลของemptyCollection()หากไม่มีค่าเริ่มต้น (I84158, Id630f, b/342672856)
เวอร์ชัน 2.8.0-beta02
29 พฤษภาคม 2024
androidx.navigation:navigation-*:2.8.0-beta02 เผยแพร่แล้ว เวอร์ชัน 2.8.0-beta02 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อขัดข้องของ
ClassCastExceptionเมื่อใช้NavBackStackEntry.toRouteกับNavTypeที่กำหนดเองซึ่งเป็นค่า Null ได้ (I1c29b, b/342239473) - แก้ไขปัญหาการกู้คืนสถานะ Back Stack ของการนําทางที่เกิดขึ้นเมื่อพยายามกู้คืนรายการ Back Stack ที่เข้าถึงไม่ได้ผ่านรหัสจากปลายทางปัจจุบัน เนื่องจากเส้นทางได้รับการสนับสนุนโดยรหัส ปลายทางที่สร้างด้วยเส้นทางจึงได้รับผลกระทบด้วย นอกจากนี้ยังแก้ไขข้อขัดข้องที่เกิดจากการเรียกใช้
clearBackStack()ซึ่งมีปัญหาเบื้องหลังเดียวกันด้วย (I423c3, b/339908057)
เวอร์ชัน 2.8.0-beta01
14 พฤษภาคม 2024
androidx.navigation:navigation-*:2.8.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.8.0-beta01 มี คอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้
SavedStateHandle.toRoute()จะใช้พารามิเตอร์typeMapสำหรับประเภทอาร์กิวเมนต์ที่กำหนดเอง (Ie39fb, b/339026523) - เพิ่ม API ทดสอบลงใน
navigation-testingเพื่อสร้างSavedStateHandleจากออบเจ็กต์ Kotlin Serializable (Id4867, b/339080702)
แก้ไขข้อบกพร่อง
- เพิ่มเอกสารพารามิเตอร์ที่ขาดหายไปสำหรับฟังก์ชัน DSL ของ Kotlin สำหรับการนำทางแล้ว (I26a36)
เวอร์ชัน 2.8.0-alpha08
1 พฤษภาคม 2024
androidx.navigation:navigation-*:2.8.0-alpha08 เผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha08 มี คอมมิตเหล่านี้
Safe Args ใน Navigation Compose
- การทำงานเพื่อรองรับความปลอดภัยในการกำหนดประเภทเวลาคอมไพล์สำหรับ Navigation Compose และผู้ใช้ Navigation Kotlin DSL ที่อิงตาม Kotlin Serialization เสร็จสมบูรณ์แล้ว และ API เวอร์ชันทดลองก่อนหน้านี้ก็เสถียรแล้ว (Iea94d, I0eb0d, I873b7, I3a64b, I6c3a2, I11f0b, Ic3032, I8d394, I95710, Ice060, Id0e55, I45f8b, Idcdaf, If5380, I08b23, Ia5c59, b/188693139)
ฟังก์ชันนี้ใช้ Kotlin Serialization เพื่อให้คุณกำหนดปลายทางในกราฟการนำทางผ่านออบเจ็กต์และคลาสข้อมูลที่ปลอดภัยในการกำหนดประเภทได้ ดังนี้
// 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)
}
}
ดูข้อมูลเพิ่มเติมได้ที่บล็อกโพสต์ Navigation Compose meet Type Safety
ฟีเจอร์ใหม่
- ตอนนี้อาร์ติแฟกต์
navigation-fragment-composeมีLocalFragmentCompositionLocal สำหรับเมธอด Composable ภายในComposableFragment(If35e5) - ตอนนี้
NavTypeมีการรองรับในตัวสำหรับรายการ Int, String, Boolean, Float และ Long (I4b6dd, Ia914c, b/188693139)
เวอร์ชัน 2.8.0-alpha07
17 เมษายน 2024
androidx.navigation:navigation-*:2.8.0-alpha07 เผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha07 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
เพิ่มอาร์ติแฟกต์
navigation-fragment-composeใหม่ที่มีทางเลือกComposableNavHostFragmentแทนNavHostFragmentซึ่งช่วยให้คุณเพิ่มปลายทางcomposableลงในไฟล์ XML ของการนําทางได้ ปลายทางcomposableแต่ละรายการต้องแสดงเป็นเมธอด@Composableระดับบนสุดที่ไม่มีอาร์กิวเมนต์ ซึ่งใช้ชื่อที่สมบูรณ์ในตัวเองเป็นแอตทริบิวต์android:nameในปลายทางแต่ละรายการ เมื่อไปยังปลายทางเหล่านี้ ระบบจะสร้าง Fragment ที่มีเพื่อแสดงเนื้อหา Composable (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
- การรองรับ Safe Args ใน Navigation Compose โดยใช้แนวทางที่อิงตาม Kotlin Serialization ยังคงดำเนินต่อไป API เหล่านี้ยังไม่เสร็จสมบูรณ์และมีคำอธิบายประกอบ
ExperimentalSafeArgsApiกำกับอยู่ ระบบจะนำคำอธิบายประกอบนี้ออกเมื่อแพลตฟอร์ม API ทั้งหมดเสร็จสมบูรณ์ในรุ่นต่อๆ ไป (Iefd95, I409c8, I5b5ac, I7e753, I960f8, I3eabd, I8ed5a, Ied2c9, I9b73c, I554db, Ib3aba, Ia668d, b/188693139)
เวอร์ชัน 2.8.0-alpha06
3 เมษายน 2024
androidx.navigation:navigation-*:2.8.0-alpha06 เผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha06 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เราได้เริ่มรองรับ Safe Args ใน Navigation Compose โดยใช้แนวทางที่อิงตาม Kotlin Serialization แล้ว API เหล่านี้ยังไม่เสร็จสมบูรณ์และมีคำอธิบายประกอบ
ExperimentalSafeArgsApiกำกับอยู่ ระบบจะนำคำอธิบายประกอบนี้ออกเมื่อแพลตฟอร์ม API ทั้งหมดเสร็จสมบูรณ์ในรุ่นต่อๆ ไป (I644e7, I98896, I2a1c5, I43a51, I836a1, Ic5eec, I39407, I24e41, If9e14, Ibb13e, If44d3, Icb70f, I8972f, I1d432, Icf32b, I20a14, I262aa, I7de99, I35990, I1033d, b/188693139)
แก้ไขข้อบกพร่อง
- ตอนนี้
NavHostใช้Alignment.TopStartเป็นอาร์กิวเมนต์ contentAlignment เริ่มต้นแล้ว ซึ่งจะทำให้สอดคล้องกับค่าเริ่มต้นสำหรับAnimatedContentและแก้ไขบางกรณีของขนาดที่ไม่คาดคิดจากการเปลี่ยนภาพจากตรงกลาง (I09e72, b/330111602) - เมื่อปัดท่าทางสัมผัสการย้อนกลับที่คาดการณ์ได้ขณะใช้ Navigation Compose ตอนนี้
NavHostจะทำการเปลี่ยนที่กำหนดเองให้เสร็จสมบูรณ์อย่างถูกต้องแทนที่จะเสร็จสิ้นทันที (I99017, b/327292110)
เวอร์ชัน 2.8.0-alpha05
20 มีนาคม 2024
androidx.navigation:navigation-*:2.8.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha05 มี คอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้คุณสามารถส่งอาร์กิวเมนต์ไปยัง
startDestinationของNavGraphได้โดยตรงในเส้นทางstartDestinationโดยไม่ต้องอาศัยdefaultValueซึ่งรวมถึงNavGraphstartDestinationsที่ฝังอยู่ด้วย (I0e0b5, b/109505019, b/188693139)
การเปลี่ยนแปลง API
- เพิ่มคลาส
CollectionNavType<T>นามธรรมใหม่ ซึ่งเป็นคลาสย่อยของNavType<T>สำหรับอาร์กิวเมนต์ที่อิงตามคอลเล็กชัน เช่น รายการ อาร์เรย์ แผนที่ (Ic6d63, b/188693139) - ตอนนี้อาร์เรย์
NavTypeเริ่มต้นทั้งหมด (IntArrayType,LongArrayType,FloatArrayType,BoolArrayTypeและStringArrayType) เป็นประเภทCollectionNavType(Idcf79, b/188693139) - ตอนนี้
NavTypeมี APIvalueEqualsแบบเปิดใหม่ที่กำหนดว่าค่า 2 ค่าที่เป็นประเภทเดียวกันเท่ากันหรือไม่ (I6cb97, b/327229511)
แก้ไขข้อบกพร่อง
- ตอนนี้พารามิเตอร์การค้นหาใน Deep Link อนุญาตให้ใช้ค่าในรูปแบบวงเล็บปีกการอบชื่ออาร์กิวเมนต์ (เช่น
{argName}) เป็นค่าที่ถูกต้องสำหรับNavTypesที่อิงตามสตริง ซึ่งจะช่วยแก้ไขปัญหาที่ระบบถือว่าค่าดังกล่าวไม่ถูกต้อง (หรือไม่มีค่า) สำหรับทุกประเภท (I18302, b/327274038) - ตอนนี้ฟังก์ชัน
NavControllerที่รองรับเส้นทาง เช่นnavigateหรือpopBackStackสามารถจับคู่เส้นทางที่เต็มไปด้วยอาร์กิวเมนต์ของอาร์เรย์NavTypesได้อย่างถูกต้องแล้ว (Iea805, b/327229511)
เวอร์ชัน 2.8.0-alpha04
6 มีนาคม 2024
androidx.navigation:navigation-*:2.8.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha04 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้คุณสามารถระบุ
SizeTranformสำหรับการเปลี่ยนใน Navigation Compose ได้โดยกำหนดให้เป็นส่วนหนึ่งของการเริ่มต้นสำหรับฟังก์ชันcomposableและ/หรือnavigation(I91062, b/296912651)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่
NavHostใน Compose Navigation ไม่แสดงการเปลี่ยนอย่างถูกต้องเมื่อใช้ปุ่มย้อนกลับของระบบโดยไม่มีท่าทางสัมผัส (Iceeae, b/325998468)
เวอร์ชัน 2.8.0-alpha03
21 กุมภาพันธ์ 2024
androidx.navigation:navigation-*:2.8.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha03 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้ระบบทำเครื่องหมาย
NavBackStackEntry.savedStateHandleเป็น@MainThreadเนื่องจากใช้โค้ดที่ต้องอยู่ในเทรดหลักอยู่แล้ว (Ibb988, b/299523245)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาในการนำทางที่ทำให้
NavGraphViewModels เป็นDESTROYEDเร็วเกินไปเนื่องจากViewModelของรายการที่เชื่อมโยงไม่ได้เป็นส่วนหนึ่งของสถานะที่บันทึกไว้ (Ib6bb7, b/317581849)
การอัปเดตทรัพยากร Dependency
- ตอนนี้ Navigation Compose จะขึ้นอยู่กับ Compose 1.7.0-alpha03
เวอร์ชัน 2.8.0-alpha02
7 กุมภาพันธ์ 2024
androidx.navigation:navigation-*:2.8.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha02 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้ Navigation Compose รองรับการย้อนกลับในแอปที่คาดการณ์ได้ผ่าน API
SeekableTransitionStateใหม่จาก compose-animation ซึ่งจะช่วยให้คุณใช้ท่าทางสัมผัสสำหรับการย้อนกลับเพื่อดูปลายทางก่อนหน้าด้วยการเปลี่ยนที่กำหนดเองก่อนที่จะตัดสินใจว่าจะยืนยันธุรกรรมผ่านท่าทางสัมผัสที่เสร็จสมบูรณ์หรือยกเลิก (I8b8e9)
เวอร์ชัน 2.8.0-alpha01
24 มกราคม 2024
androidx.navigation:navigation-*:2.8.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขการรั่วไหลของ
BackStackStateซึ่งการเรียกsaveStateหลายครั้งในปลายทางจะส่งผลให้มีการบันทึกหลายสถานะ แต่จะกู้คืนได้เฉพาะสถานะแรกเท่านั้น (I598b0, b/309559751) - แก้ไขปัญหาที่อาร์กิวเมนต์ที่ไม่ใช่สตริงแสดงไม่ถูกต้องเมื่อใช้ตัวช่วย
NavigationUIเพื่อป้อนชื่อแถบแอป (#636, b/316676794)
การอัปเดตทรัพยากร Dependency
- ตอนนี้ Navigation Compose จะขึ้นอยู่กับ Compose
1.7.0-alpha01ซึ่งจะแก้ไขปัญหาที่อาจทำให้เกิดภาพเคลื่อนไหวปรับขนาดที่ไม่คาดคิด (b/297258205)
การมีส่วนร่วมจากภายนอก
- ขอขอบคุณ SimonMarquis ที่แก้ไขปัญหาการแสดงผลสำหรับอาร์กิวเมนต์ที่ไม่ใช่สตริงเมื่อใช้ตัวช่วย
NavigationUIเพื่อสร้างชื่อแถบแอป
เวอร์ชัน 2.7.7
เวอร์ชัน 2.7.7
7 กุมภาพันธ์ 2024
androidx.navigation:navigation-*:2.7.7 เผยแพร่แล้ว เวอร์ชัน 2.7.7 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- พอร์ตย้อนหลังจาก Navigation
2.8.0-alpha01: แก้ไขการรั่วไหลของBackStackStateที่การเรียกsaveState()หลายครั้งในNavBackStackEntryรายการเดียวจะส่งผลให้มีการบันทึกหลายสถานะ แต่จะกู้คืนได้เฉพาะสถานะแรกที่บันทึกไว้เท่านั้น (I598b0, b/309559751) - พอร์ตย้อนหลังจากการนำทาง
2.8.0-alpha01: แก้ไขปัญหาที่อาร์กิวเมนต์ที่ไม่ใช่สตริงแสดงไม่ถูกต้องเมื่อใช้ตัวช่วยNavigationUIเพื่อป้อนข้อมูลชื่อของแถบแอป (#636, b/316676794)
การมีส่วนร่วมจากภายนอก
- ขอขอบคุณ SimonMarquis ที่แก้ไขปัญหาการแสดงผลสำหรับอาร์กิวเมนต์ที่ไม่ใช่สตริงเมื่อใช้ตัวช่วย
NavigationUIเพื่อสร้างชื่อแถบแอป
เวอร์ชัน 2.7.6
เวอร์ชัน 2.7.6
13 ธันวาคม 2023
androidx.navigation:navigation-*:2.7.6 เผยแพร่แล้ว เวอร์ชัน 2.7.6 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้ฟังก์ชัน
NavGraphequals()จะพิจารณาโหนดของกราฟอื่นๆ อย่างถูกต้อง แทนที่จะพิจารณาเฉพาะโหนดที่เรียกใช้ การดำเนินการนี้จะช่วยให้มั่นใจได้ว่ากราฟที่มีโหนดซึ่งมีรหัสต่างกันจะไม่ถือว่าเท่ากันอีกต่อไป (I401cb, b/311414915)
เวอร์ชัน 2.7.5
เวอร์ชัน 2.7.5
1 พฤศจิกายน 2023
androidx.navigation:navigation-*:2.7.5 เผยแพร่แล้ว เวอร์ชัน 2.7.5 มีคอมมิตเหล่านี้
การปรับปรุงประสิทธิภาพ
- ปรับปรุงประสิทธิภาพ (ทั้งในแง่ของเวลาและจำนวนการจัดสรร) ของการเปรียบเทียบกราฟ 2 รายการอย่างมาก ซึ่งหมายความว่าการเรียกใช้ เช่น
setGraphซึ่งเปรียบเทียบกราฟใหม่กับกราฟที่มีอยู่ภายในจะทำงานได้เร็วขึ้นมากและส่งผลให้เฟรมที่ข้ามไปมีจำนวนน้อยลง ขอขอบคุณ Michał Z สำหรับการวิเคราะห์อย่างละเอียดซึ่งนำไปสู่การปรับปรุงนี้ (I6ad62) - ตอนนี้
NavHostจะแสดงผลปลายทางเริ่มต้นในการส่งผ่าน Composition ครั้งแรกแทนที่จะต้องรอการส่งผ่านครั้งที่ 2 เพื่ออ่านสถานะที่อัปเดต (I439a7, b/304852206)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ระบบจะแสดง Back Stack หากคุณเรียกใช้
setGraphมากกว่า 1 ครั้งด้วยกราฟเดียวกันทุกประการ เฉพาะในกรณีที่มีปลายทางในกราฟซึ่งมีการดำเนินการที่ลิงก์ปลายทาง 2 แห่ง (Ieaed7) - กล่องโต้ตอบที่มีการไปยังส่วนต่างๆ และปิดอย่างรวดเร็วจะไม่รั่วไหลไปยังรายการ
NavController.visibleEntriesอีกต่อไป (I67586, b/287969970) - เมื่อรายการถูกนำออกตามด้วยการเปลี่ยนแปลงการกำหนดค่า ระบบจะล้าง
ViewModelของรายการอย่างถูกต้องหากsaveStateเป็นเท็จ (Idf242, b/298164648) - แก้ไขปัญหาที่
NavControllerสามารถจัดการ Deep Link เดียวกันได้มากกว่า 1 ครั้งหาก Back Stack ว่างเปล่าทั้งหมดก่อนการเปลี่ยนแปลงการกำหนดค่าหรือการเรียกใช้setGraphเฉพาะเมื่อ Intent ขาเข้ามีการตั้งค่าแฟล็กFLAG_ACTIVITY_NEW_TASKไว้ (I73c7f)
การอัปเดตทรัพยากร Dependency
- ตอนนี้การนำทางด้วย Fragment จะขึ้นอยู่กับ Fragment 1.6.2 ซึ่งช่วยแก้ไขปัญหาที่อินสแตนซ์
ViewModelของ Fragment ที่ฝังอยู่จะไม่ถูกล้างเมื่อเรียกใช้clearBackStack
เวอร์ชัน 2.7.4
เวอร์ชัน 2.7.4
4 ตุลาคม 2023
androidx.navigation:navigation-*:2.7.4 เผยแพร่แล้ว เวอร์ชัน 2.7.4 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่มการรองรับ
popUpToเพื่อใช้เส้นทางที่มีอาร์กิวเมนต์เพื่อให้สามารถย้อนกลับไปยังรายการที่เฉพาะเจาะจงซึ่งใช้อาร์กิวเมนต์เหล่านั้นได้ โดยตรงกับการรองรับที่พบในpopBackStack(I731f4, b/299255572)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่การขัดจังหวะการนำทางด้วยการนำทางอื่นด้วย
popUpToจะทำให้FragmentNavigatorขัดข้อง (I3c848, b/301887045) - แก้ไขปัญหาที่การกดปุ่มย้อนกลับของระบบทำให้
currentDestinationไม่ได้รับการอัปเดตอย่างถูกต้องเพื่อให้ตรงกับ Fragment ที่แสดง (Id0d6c, b/289877514) - ตอนนี้วงจร
DialogFragmentจะย้ายไปยังสถานะRESUMEDอย่างถูกต้องเมื่อปิดกล่องโต้ตอบด้านบน (I88f0d, b/301811387)
เวอร์ชัน 2.7.3
เวอร์ชัน 2.7.3
20 กันยายน 2023
androidx.navigation:navigation-*:2.7.3 เผยแพร่แล้ว เวอร์ชัน 2.7.3 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาในการนําทางด้วย Fragment ที่ทําให้รายการ
visibleEntriesมีรายการที่ไม่ถูกต้อง (I5caa9, b/288520638) - แก้ไขปัญหาที่ทำให้ปลายทางหน้าต่างลอย (เช่น
Dialogs,Bottomsheetsฯลฯ) ไม่ได้รับ Lifecycle CallbackRESUMED(I3b866, b/287505132)
เวอร์ชัน 2.7.2
เวอร์ชัน 2.7.2
6 กันยายน 2023
androidx.navigation:navigation-*:2.7.2 เผยแพร่แล้ว เวอร์ชัน 2.7.2 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้การนำทางจะขึ้นอยู่กับ Lifecycle
2.6.2ซึ่งจะแก้ไขการโต้ตอบระหว่างrememberSaveableกับNavHostของ Navigation Compose ที่จะทำให้สถานะrememberSaveableของปลายทางและอินสแตนซ์SavedStateHandleที่ViewModelเป็นเจ้าของไม่ได้รับการกู้คืนอย่างถูกต้องหลังจากที่การสิ้นสุดการประมวลผลและการสร้างใหม่ (b/298059596, b/289436035) - แก้ไขปัญหาเมื่อแสดงกล่องโต้ตอบหลายรายการใน Navigation Compose พร้อมกัน โดยกล่องโต้ตอบที่ถูกบดบังบางส่วน (เช่น ไม่ใช่กล่องโต้ตอบบนสุด) จะอยู่ในสถานะวงจร
CREATEDแทนที่จะเป็นสถานะSTARTED(aosp/2728520, b/289257213) - แก้ไขปัญหาเมื่อแสดงกล่องโต้ตอบหลายรายการใน Navigation Compose พร้อมกัน ซึ่งการปิดกล่องโต้ตอบบนสุดจะทำให้กล่องโต้ตอบบนสุดใหม่ค้างอยู่ในสถานะวงจร
STARTEDแทนที่จะย้ายไปยังRESUMEDอย่างถูกต้อง (aosp/2629401, b/286371387) - Navigation Safe Args จะไม่สร้างอินสแตนซ์ของงานอย่างรวดเร็วอีกต่อไปหากไม่ได้ดำเนินการจริง (I0e385, b/260322841)
การอัปเดตทรัพยากร Dependency
- ตอนนี้ Navigation Compose ขึ้นอยู่กับ Compose 1.5.1
เวอร์ชัน 2.7.1
เวอร์ชัน 2.7.1
23 สิงหาคม 2023
androidx.navigation:navigation-*:2.7.1 เผยแพร่แล้ว เวอร์ชัน 2.7.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาในการนำทางด้วย Compose ซึ่งเมื่อใช้
Scaffoldอาจเกิดข้อผิดพลาดในการพยายามเข้าถึงLifecycle.State.DESTROYEDViewModel(I1dc11, b/268422136)
เวอร์ชัน 2.7.0
เวอร์ชัน 2.7.0
9 สิงหาคม 2023
androidx.navigation:navigation-*:2.7.0 เผยแพร่แล้ว เวอร์ชัน 2.7.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.6.0
ภาพเคลื่อนไหวจาก Accompanist
ตอนนี้ AnimatedContent มีความเสถียรแล้ว เราจึงย้ายโค้ดจาก Accompanist Navigation Animation กลับไปยัง Navigation Compose ได้
ซึ่งหมายความว่าการรองรับทั้งหมดสำหรับการตั้งค่าการเปลี่ยนที่กำหนดเองซึ่งมีอยู่ใน AnimatedNavHost จะได้รับการรองรับโดยตรงใน NavHost
จะไม่มีการเปลี่ยนแปลงเพิ่มเติมใน Accompanist Navigation Animation และเราจะเลิกใช้งานอย่างเป็นทางการในเร็วๆ นี้ พร้อมกับคำแนะนำเกี่ยวกับวิธีย้ายข้อมูลกลับไปยัง Navigation Compose เอง แต่จะตรงกันข้ามกับคำแนะนำในการย้ายข้อมูล โดยไม่จำเป็นต้องเปลี่ยนแปลง API อื่นๆ หากคุณใช้ Accompanist เวอร์ชันอัลฟ่าล่าสุด (0.31.2-alpha) อยู่แล้ว (b/197140101)
แก้ไขข้อบกพร่อง
- ตอนนี้ NavHost ใน Navigation Compose จะขัดจังหวะการเรียกกลับของระบบได้อย่างถูกต้องแม้ว่ากิจกรรมจะหยุดและกลับมาทำงานอีกครั้งแล้วก็ตาม (Icb6de, b/279118447)
การอัปเดตทรัพยากร Dependency
- ตอนนี้การนำทางจะขึ้นอยู่กับ Compose
1.5.0ซึ่งเพิ่มขึ้นจาก1.1.0
เวอร์ชัน 2.7.0-rc01
26 กรกฎาคม 2023
androidx.navigation:navigation-*:2.7.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.7.0-rc01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่
EnterTransitionและExitTransitionlambda ที่สร้างขึ้นเป็นส่วนหนึ่งของNavHostอาจยังคงอยู่ในหน่วยความจำแม้ว่าจะนำNavHostออกจากองค์ประกอบแล้วก็ตาม (I893d0)
ปัญหาที่ทราบ
- มีปัญหาจาก Navigation 2.6.x ที่เมื่อไปยังส่วนต่างๆ ด้วย popUpTo อาจทำให้เกิด
IllegalArgumentExceptionคุณอาจหลีกเลี่ยงข้อยกเว้นนี้ได้โดยการปรับโครงสร้างกราฟให้คล้ายกับคำแนะนำที่ระบุไว้ที่นี่ (b/287133013)
เวอร์ชัน 2.7.0-beta02
28 มิถุนายน 2566
androidx.navigation:navigation-*:2.7.0-beta02 เผยแพร่แล้ว เวอร์ชัน 2.7.0-beta02 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้ Navigation Compose มีลำดับ Z ที่ถูกต้องสำหรับการเปลี่ยนที่กำหนดเองซึ่งใช้การนำทางด้วยตัวเลือก
popUpTo(/Ib1c3a, b/285153947)
เวอร์ชัน 2.7.0-beta01
7 มิถุนายน 2023
androidx.navigation:navigation-*:2.7.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.7.0-beta01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้
NavHostใน Navigation Compose จะขัดจังหวะการเรียกใช้ปุ่มย้อนกลับของระบบได้อย่างถูกต้อง แม้ว่าActivityจะได้รับการSTOPPEDและRESUMEDแล้วก็ตาม (Icb6de, b/279118447)
เวอร์ชัน 2.7.0-alpha01
24 พฤษภาคม 2023
androidx.navigation:navigation-*:2.7.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.7.0-alpha01 มีคอมมิตเหล่านี้
ภาพเคลื่อนไหวจาก Accompanist
ตอนนี้ AnimatedContent มีความเสถียรแล้ว เราจึงย้ายโค้ดจาก Accompanist Navigation Animation กลับไปยัง Navigation Compose ได้
ซึ่งหมายความว่าการรองรับทั้งหมดสำหรับการตั้งค่าการเปลี่ยนที่กำหนดเองซึ่งมีอยู่ใน AnimatedNavHost จะได้รับการรองรับโดยตรงใน NavHost
จะไม่มีการเปลี่ยนแปลงเพิ่มเติมใน Accompanist Navigation Animation และเราจะเลิกใช้งานอย่างเป็นทางการในเร็วๆ นี้ พร้อมกับคำแนะนำเกี่ยวกับวิธีย้ายข้อมูลกลับไปยัง Navigation Compose เอง แต่จะตรงกันข้ามกับคำแนะนำในการย้ายข้อมูล โดยไม่จำเป็นต้องเปลี่ยนแปลง API อื่นๆ หากคุณใช้ Accompanist เวอร์ชันอัลฟ่าล่าสุด (0.31.2-alpha) อยู่แล้ว (b/197140101)
แก้ไขข้อบกพร่อง
- จาก Navigation
2.6.0-rc02: แก้ไขปัญหาเกี่ยวกับการนำทางใน Fragment ซึ่งการนำทางด้วยpopUpToและการนำ Fragment ออกจาก Back Stack โดยไม่สร้างมุมมองใหม่จะทำให้การย้อนกลับของระบบหยุดทำงาน (Ieb8d4, b/281726455)
การอัปเดตทรัพยากร Dependency
- ตอนนี้การนำทางจะขึ้นอยู่กับ Compose
1.5.0-beta01
เวอร์ชัน 2.6.0
เวอร์ชัน 2.6.0
7 มิถุนายน 2023
androidx.navigation:navigation-*:2.6.0 เผยแพร่แล้ว เวอร์ชัน 2.6.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญในการนำทางตั้งแต่เวอร์ชัน 2.5.0
argumentsของNavBackStackEntryและargumentsที่ส่งไปยังOnDestinationChangedListenerจะเป็นเพียงสำเนาของอาร์กิวเมนต์ที่เปลี่ยนแปลงไม่ได้ซึ่งสร้างขึ้นเมื่อคุณไปยังปลายทางเท่านั้น ซึ่งหมายความว่าการเปลี่ยนแปลงใดๆ ที่เกิดขึ้นกับแพ็กเกจเหล่านั้นจะไม่แสดงในการเข้าถึงargumentsหรืออินสแตนซ์OnDestinationChangedListenerอื่นๆ ในภายหลัง- ตอนนี้
NavDeepLinkรองรับค่าเริ่มต้นสำหรับอาร์เรย์ ซึ่งช่วยให้รองรับพารามิเตอร์การค้นหาซ้ำๆ ที่จะจับคู่กับประเภทอาร์เรย์ของอาร์กิวเมนต์ ตอนนี้NavTypeยังมีเมธอดเริ่มต้นซึ่งสามารถลบล้างเพื่อรวมค่าที่แยกวิเคราะห์ 2 ค่าเข้าด้วยกันได้ - ตอนนี้คลาสย่อยที่กำหนดเองของ
NavTypeสามารถลบล้างserializeAsValueเพื่อแปลงค่าเป็นสตริงได้แล้ว ซึ่งช่วยให้ทั้งการแปลงเป็นอนุกรมและการดีซีเรียลไลซ์ (ผ่านparseValue) รวมอยู่ในคลาสNavTypeทั้งหมด ตอนนี้StringTypeจะลบล้างเมธอดนี้เพื่อเรียกใช้Uri.encodeในStringที่ระบุ
การเปลี่ยนแปลงที่สำคัญใน Navigation Compose ตั้งแต่เวอร์ชัน 2.5.0
- เมื่อแสดงตัวอย่าง Composable ด้วย
NavHostตอนนี้ระบบจะแสดงstartDestinationของ NavGraph โดยค่าเริ่มต้น - ตอนนี้
NavController.popBackStack(route),NavController.getBackStackEntry(route),NavController.clearBackStack(route)รองรับเส้นทางทั้งหมดที่มีอาร์กิวเมนต์ที่กรอกข้อมูลบางส่วนหรือทั้งหมด โปรดทราบว่าอาร์กิวเมนต์ต้องตรงกับอาร์กิวเมนต์ของรายการทุกประการ - ตอนนี้การพยายามสร้าง
NavDeepLinkที่ว่างเปล่าโดยใช้navDeepLinkKotlin DSL จะส่งผลให้เกิดคำเตือน Lint ที่ระบุว่า Deep Link ต้องมี URI, การดำเนินการ และ/หรือประเภท MIME จึงจะถูกต้อง
การเปลี่ยนแปลงที่สำคัญในการนำทางด้วย Fragment ตั้งแต่เวอร์ชัน 2.5.0
NavHostFragmentจะไม่ขัดจังหวะปุ่มย้อนกลับของระบบอีกต่อไป ซึ่งจะช่วยให้FragmentManagerที่สำคัญจัดการการย้อนกลับของระบบได้ ซึ่งจะช่วยให้ Fragment1.7.0-alpha01ขึ้นไปแสดงภาพเคลื่อนไหวของการย้อนกลับที่คาดการณ์ได้ในแอปบนอุปกรณ์ Android U- เมื่อใช้การนําทางด้วย Fragment การพยายามทํา
FragmentTransactionด้วยตนเองซึ่งเพิ่ม Fragment ลงใน Back Stack ของFragmentManagerจะแสดงIllegalArgumentExceptionคุณควรเพิ่ม Fragment ผ่านnavigate()API เสมอ - เมื่อใช้สตริง
${applicationId}เป็นตัวยึดตำแหน่งในแอตทริบิวต์app:dataและapp:dataPatternในองค์ประกอบกิจกรรมของไฟล์ XML การนำทาง ระบบจะป้อนตัวยึดตำแหน่งด้วยpackageNameของบริบทโดยอัตโนมัติเมื่อมีการขยาย - ตอนนี้
FragmentNavigatorจะใช้ API การเปลี่ยนผ่านเมื่อไปยังส่วนต่างๆ และแสดงNavBackStackEntriesซึ่งหมายความว่าตอนนี้NavBackStackEntryLifecycleจะรอให้เอฟเฟกต์พิเศษของ Fragment ที่เข้าและออกทำงานเสร็จก่อนที่จะย้ายLifecycle.Stateสุดท้าย - ตอนนี้
DialogFragmentNavigatorจะใช้ API การเปลี่ยนผ่านเมื่อไปยังส่วนต่างๆ และแสดงNavBackStackEntriesซึ่งหมายความว่าNavBackStackEntryLifecycleจะรอให้DialogFragmentLifecycleย้ายไปที่DESTROYEDก่อนที่จะย้ายไปที่DESTROYEDเอง - ตอนนี้
NavHostFragmentช่วยให้คุณดึงข้อมูลNavControllerได้ทันทีที่แนบNavHostFragmentกับFragmentManagerแทนที่จะดึงข้อมูลได้หลังจากonCreate()เท่านั้น - ตอนนี้การรองรับโมดูลฟีเจอร์แบบไดนามิกของ Navigation จะขึ้นอยู่กับไลบรารีการนำส่งฟีเจอร์ Play แบบละเอียด
- ตอนนี้ Navigation Safe Args ขึ้นอยู่กับปลั๊กอิน Android Gradle เวอร์ชัน 7.3.0 ซึ่งหมายความว่าตอนนี้จะใช้ได้กับเวอร์ชัน 7.3.0 ขึ้นไปเท่านั้น
การเปลี่ยนแปลงที่สำคัญใน NavigationUI ตั้งแต่เวอร์ชัน 2.5.0
- เมื่อส่งรหัสของกราฟการนำทางไปยัง
AppBarConfiguration(เช่น ผ่านMenu) ตอนนี้NavigationUIจะพิจารณาเฉพาะปลายทางเริ่มต้นของกราฟการนำทางนั้นเป็นปลายทางระดับบนสุด แทนที่จะทำเครื่องหมายปลายทางทุกแห่งภายในกราฟเป็นปลายทางระดับบนสุดอย่างไม่ถูกต้อง ลักษณะการทำงานของการส่งรหัสของปลายทางแต่ละรายการจะไม่มีการเปลี่ยนแปลง ฟังก์ชันการทำงานเดียวกันนี้พร้อมใช้งานสำหรับโค้ดของคุณเองผ่านฟังก์ชันisTopLevelDestinationใหม่ในAppBarConfiguration - ตอนนี้การผสานรวม
setupWithNavControllerในNavigationUIสำหรับการทำงานกับแถบแอปด้านบนจะแยกวิเคราะห์ค่าR.stringสำหรับอาร์กิวเมนต์ReferenceTypeที่พบในandroid:labelเป็นค่าสตริงแทนการแสดงผลจำนวนเต็มของทรัพยากรที่สร้างขึ้นโดยอัตโนมัติ - ตอนนี้
NavigationUIจะแสดงบันทึกเมื่อไปยังส่วนต่างๆ ผ่านMenuItemที่เลือกไม่สำเร็จ
เวอร์ชัน 2.6.0-rc02
24 พฤษภาคม 2023
androidx.navigation:navigation-*:2.6.0-rc02 เผยแพร่แล้ว เวอร์ชัน 2.6.0-rc02 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาเกี่ยวกับการนําทางใน Fragment ซึ่งการนําทางด้วย
popUpToและการนํา Fragment ออกจาก Back Stack โดยไม่สร้างมุมมองใหม่จะทําให้ระบบหยุดทํางาน (Ieb8d4, b/281726455)
เวอร์ชัน 2.6.0-rc01
10 พฤษภาคม 2023
androidx.navigation:navigation-*:2.6.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.6.0-rc01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาในการนำทางด้วย Fragment ซึ่งการนำ Fragment ออกผ่านการนำทางด้วย
popUpToใน Lifecycle Callback ของonResume()จะทำให้เกิดIllegalStateException(I21884, b/279644470)
เวอร์ชัน 2.6.0-beta01
19 เมษายน 2023
androidx.navigation:navigation-*:2.6.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.6.0-beta01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้
NavBackStackEntryมีการติดตั้งใช้งานtoStringที่กำหนดเองแล้ว (Iff00b)
แก้ไขข้อบกพร่อง
- เมื่อใช้การนําทางด้วย Fragment การพยายามทํา
FragmentTransactionด้วยตนเองซึ่งเพิ่ม Fragment ลงใน Back Stack ของFragmentManagerจะแสดงIllegalArgumentExceptionคุณควรเพิ่ม Fragment ผ่านnavigate()API เสมอ (I6d38e) - เมื่อมี
navigateที่เพิ่มรายการและpopBackStackที่นำรายการออกในเฟรมเดียวกัน รายการบนสุดที่ได้ใน Back Stack จะกลับไปที่RESUMEDLifecycle.Stateอย่างสม่ำเสมอ (Id8067, b/276495952)
เวอร์ชัน 2.6.0-alpha09
5 เมษายน 2023
androidx.navigation:navigation-*:2.6.0-alpha09 เผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha09 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขการตรวจสอบเส้นทางที่ไม่ถูกต้องเพื่อให้หาก
NavDestinationมีNavArgumentที่เป็นค่า Null ไม่ได้ เส้นทางของปลายทางนี้ต้องมีตัวยึดตำแหน่งสำหรับอาร์กิวเมนต์ที่มีชื่อเดียวกับNavArgumentที่เป็นค่า Null ไม่ได้ (Ic62bf, b/274697949) - ตอนนี้การไปยังส่วนต่างๆ ของ Deep Link ที่อิงตาม
Action/MimeTypeจะดำเนินการไม่สำเร็จหากการดำเนินการไปยังส่วนต่างๆ ไม่มีNavArgumentที่ไม่สามารถเป็นค่า Null ซึ่งจำเป็นสำหรับNavDestinationที่Action/MimeTypeตรงกัน (Ibfa17, b/271777424) - เมื่อ
NavControllerตั้งค่ากราฟที่มีเส้นทางและปลายทางเดียวกันกับกราฟก่อนหน้า ตอนนี้ระบบจะแทนที่โหนดกราฟปัจจุบันและปลายทาง Back Stack ด้วยอินสแตนซ์ใหม่อย่างถูกต้อง การดำเนินการนี้จะแก้ไขข้อขัดข้องเมื่อใช้onLaunchSingleTopโดยไม่บันทึกสถานะใน Navigation Compose นอกจากนี้ยังแก้ไขข้อผิดพลาดที่การไปยังปลายทางที่เชื่อมโยงกับกราฟรูทสร้าง Back Stack ที่ไม่ถูกต้อง (I5bc58, b/275258161, b/275407804)
เวอร์ชัน 2.6.0-alpha08
22 มีนาคม 2023
androidx.navigation:navigation-*:2.6.0-alpha08 เผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha08 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้
NavHostFragmentช่วยให้คุณดึงข้อมูลNavControllerได้ทันทีที่แนบNavHostFragmentกับFragmentManagerแทนที่จะดึงข้อมูลได้หลังจากonCreate()เท่านั้น (Ic6382, b/220186282)
แก้ไขข้อบกพร่อง
- แก้ไข
NullPointerExceptionเมื่อแสดงกราฟที่ซ้อนกันซึ่งมีอาร์กิวเมนต์ที่ไม่มีค่า Null (6b3581, b/249988437) - เมื่อใช้การย้อนกลับของระบบหลังจากไปยังส่วนต่างๆ ด้วย
popUpToสถานะของNavControllerจะแสดงรายการที่ถูกต้อง (I3a8ec, b/270447657) - ตอนนี้
FragmentNavigatorจะแสดงรายการอย่างถูกต้องเมื่อแสดง Back Stack ผ่านการย้อนกลับของระบบหรือpopBackStack()และไม่ว่าธุรกรรมจะใช้เอฟเฟกต์สำหรับ Fragment หรือไม่ก็ตาม (I81bdf) - การเพิ่ม Fragment ลงใน
FragmentManagerของFragmentNavigatorโดยไม่ใช้การนําทางจะไม่ทําให้เกิดข้อขัดข้องอีกต่อไป (b17204, b/274167493)
การอัปเดตทรัพยากร Dependency
- ตอนนี้การนําทางจะขึ้นอยู่กับวงจร
2.6.1(586fe7) - ตอนนี้การนำทางจะขึ้นอยู่กับ SavedState
1.2.1(078e4e) - ตอนนี้การนำทางจะขึ้นอยู่กับ ProfileInstaller
1.3.0(512f0c)
เวอร์ชัน 2.6.0-alpha07
8 มีนาคม 2023
androidx.navigation:navigation-*:2.6.0-alpha07 เผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha07 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตัวแปร API
getBackStackEntry,popBackStack,clearBackStackที่ใช้เส้นทางจะใช้รูปแบบเส้นทางที่มีอาร์กิวเมนต์ที่อนุญาตค่า Null และพารามิเตอร์การค้นหาที่อนุญาตค่า Null (I22294, b/269302500) - แก้ไขปัญหาที่การเรียก
clearBackStack()จากNavControllerไม่ล้างสถานะที่บันทึกไว้ใน Fragment Manager ที่เชื่อมโยงกับ Back Stack ที่ล้างแล้ว (Ic1cce, b/271190202) - แก้ไขการถดถอยใน 2.6.0-alpha06 ที่ทำให้ไฮไลต์
MenuItemผิดในBottomNavigationViewเมื่อใช้การย้อนกลับของระบบระหว่างแท็บ (I634f6, b/270447657) - แก้ไขการถดถอยใน 2.6.0-alpha06 ที่ทำให้
NavBackStackEntryไม่ย้ายไปยังสถานะ RESUMED เมื่อใช้Animation(Ib3589, b/269646882)
เวอร์ชัน 2.6.0-alpha06
22 กุมภาพันธ์ 2023
androidx.navigation:navigation-*:2.6.0-alpha06 เผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha06 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เมื่อแสดงตัวอย่าง Composable ด้วย
NavHostตอนนี้ระบบจะแสดงstartDestinationของ NavGraph โดยค่าเริ่มต้น (I2b89f)
การเปลี่ยนแปลง API
- ตอนนี้โอเวอร์โหลด
NavControllernavigateทั้งหมดจะมีคำอธิบายประกอบเป็น@MainThreadเพื่อให้แน่ใจว่ามีการเรียกใช้ในเทรดหลัก (I2c0b0, b/263427111)
แก้ไขข้อบกพร่อง
- แก้ไขข้อขัดข้องเมื่อพยายามไปยังส่วนต่างๆ ขณะใช้การไปยังส่วนต่างๆ ของ Fragment แบบไดนามิก (I3ee29, b/268360479)
- แก้ไขข้อบกพร่องที่การไปยังส่วนต่างๆ ของ Fragment อื่นผ่านปุ่มย้อนกลับของระบบไม่อัปเดตแถบด้านล่างเป็นรายการที่เลือกที่ถูกต้อง (If559f, b/269044426)
ปัญหาที่ทราบ
- เมื่อใช้การนําทางกับ Fragment วงจรของ
NavBackStackEntryจะไม่ถึงRESUMEDเมื่อใช้ APIAnimation(b/269646882) - เมื่อใช้การนำทางกับ Fragment และนำทางด้วย
BottomNavigationหากคุณพยายามกู้คืน Back Stack ที่มีหลายรายการ ระบบจะอัปเดตBottomMenuItemไม่ถูกต้อง (b/270447657) - เมื่อใช้การนําทางกับ Fragment หลังจากคืนค่าสถานะแล้ว
NavBackStackEntryLifecycleจะไม่ได้รับDESTROYEDเมื่อ Fragment เป็นDESTROYED(b/270610768)
เวอร์ชัน 2.6.0-alpha05
8 กุมภาพันธ์ 2023
androidx.navigation:navigation-*:2.6.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha05 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้
NavController.popBackStack(route),NavController.getBackStackEntry(route),NavController.clearBackStack(route)รองรับเส้นทางทั้งหมดที่มีอาร์กิวเมนต์ที่กรอกข้อมูลบางส่วนหรือทั้งหมด โปรดทราบว่าอาร์กิวเมนต์ต้องตรงกับอาร์กิวเมนต์ของรายการทุกประการ (Iebd28, Ic678c, I3b37b, b/257514373) - ตอนนี้
FragmentNavigatorจะใช้ API การเปลี่ยนผ่านเมื่อไปยังส่วนต่างๆ และแสดงNavBackStackEntriesซึ่งหมายความว่าตอนนี้NavBackStackEntryLifecycleจะรอให้เอฟเฟกต์พิเศษของ Fragment ที่เข้าและออกทำงานเสร็จก่อนที่จะย้ายLifecycle.Stateสุดท้าย (I3cb19, b/238686802) - ตอนนี้
DialogFragmentNavigatorจะใช้ API การเปลี่ยนผ่านเมื่อไปยังส่วนต่างๆ และแสดงNavBackStackEntriesซึ่งหมายความว่าNavBackStackEntryLifecycleจะรอให้DialogFragmentLifecycleย้ายไปที่DESTROYEDก่อนที่จะย้ายไปที่DESTROYEDเอง (I53ee5, b/261213893)
การเปลี่ยนแปลง API
- ตอนนี้
NavigatorStateมีprepareForTransitionAPI เพื่ออนุญาตให้Navigatorย้ายNavBackStackEntriesไปยังLifecycle.Stateระดับกลาง (I42c21, b/238686802) - ตอนนี้คุณสามารถเข้าถึง Back Stack ที่เชื่อมโยงกับ
NavGraphNavigatorหรือComposeNavigatorผ่านพร็อพเพอร์ตี้backstackได้แล้ว ตอนนี้ComposeNavigatorยังแสดง CallbackonTransitionComplete()เพื่อทำเครื่องหมายNavBackStackEntryที่ดำเนินการนำทางหรือการดำเนินการpopBackStackว่าเสร็จสมบูรณ์แล้ว (I02062, I718db, b/257519195)
แก้ไขข้อบกพร่อง
- ตอนนี้สถานะ Navigator จะไม่ทำงานเมื่อใช้
push/popWithTransitionAPI และมีการจัดการรายการอยู่แล้ว (Iadbfa, b/261213893) - เมื่อใช้
launchSingleTopกับNavGraphที่ฝังอยู่ ปลายทางทั้งหมดที่เริ่มต้นจากปลายทางเดิมไปยังstartDestinationจะเพิ่มลงในด้านบนของ Backstack อย่างถูกต้องเท่านั้น (Id4bea, b/253256629) - ตอนนี้การนำทางจะแทนที่อินสแตนซ์
DialogFragmentอย่างถูกต้องเมื่อนำทางไปยังปลายทางเดียวกันโดยตั้งค่าแฟล็กlaunchSingleTopเป็น "จริง" (I45b5a, b/149572817) - Navigation SafeArgs จะไม่ทำให้เกิดข้อผิดพลาดในการคอมไพล์อีกต่อไปเมื่อใช้อาร์กิวเมนต์ที่มีความยาว 19 อักขระพอดี (Id60bc, b/257110095)
เวอร์ชัน 2.6.0-alpha04
9 พฤศจิกายน 2022
androidx.navigation:navigation-*:2.6.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha04 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้คลาสย่อยที่กำหนดเองของ
NavTypeสามารถลบล้างserializeAsValueเพื่อแปลงค่าเป็นสตริงได้แล้ว ซึ่งช่วยให้ทั้งการแปลงเป็นอนุกรมและการดีซีเรียลไลซ์ (ผ่านparseValue) รวมอยู่ในคลาสNavTypeทั้งหมด ตอนนี้StringTypeจะลบล้างเมธอดนี้เพื่อเรียกใช้Uri.encodeในStringที่ระบุ (Ie5213, b/247637434) - ตอนนี้
NavigationUIจะแสดงบันทึกเมื่อไปยังส่วนต่างๆ ผ่านMenuItemที่เลือกไม่สำเร็จ (I2af5a, b/247730357)
แก้ไขข้อบกพร่อง
- ตอนนี้ระบบจะแยกวิเคราะห์ Deep Link การนําทางแบบ Lazy แทนที่จะแยกวิเคราะห์ในการเริ่มต้นกราฟ ซึ่งอาจช่วยปรับปรุงประสิทธิภาพของแอปเมื่อเริ่มต้นระบบ (Iab0ab)
- แก้ไขข้อขัดข้องที่เกิดจากการไปยังส่วนต่างๆ หลังจากทำ Deep Link ไปยังปลายทางที่มีอาร์กิวเมนต์เริ่มต้นเป็น Null (I51c24, b/243183636)
การอัปเดตทรัพยากร Dependency
- ตอนนี้การรองรับโมดูลฟีเจอร์แบบไดนามิกของ Navigation จะขึ้นอยู่กับไลบรารีการนำส่งฟีเจอร์ Play แบบละเอียด (Ib4ddc)
- ตอนนี้ Navigation Safe Args ขึ้นอยู่กับปลั๊กอิน Android Gradle เวอร์ชัน 7.3.0 ซึ่งหมายความว่าตอนนี้จะใช้ได้กับเวอร์ชัน 7.3.0 ขึ้นไปเท่านั้น (I47e49)
เวอร์ชัน 2.6.0-alpha03
24 ตุลาคม 2022
androidx.navigation:navigation-*:2.6.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha03 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- จากการนำทาง
2.5.3:NavHostจะไม่ทำให้เกิดNoSuchElementExceptionอีกต่อไปเมื่อไม่มีปลายทางที่พร้อมใช้งานสำหรับCrossfadeในการเขียน ตอนนี้ระบบจะข้ามการคอมโพสิชันไปเลย (Ieb46e, b/253299416) - จากการนำทาง
2.5.3: แก้ไขปัญหาที่ระบบไม่ลืมและไม่นำสถานะ Compose ที่บันทึกไว้ (เช่น การใช้งานrememberSaveable) ออกเมื่อมีการนำปลายทางออกจาก Back Stack (I64949)
การอัปเดตทรัพยากร Dependency
- ตอนนี้การนำทางจะขึ้นอยู่กับ Fragment
1.5.4(Icd424)
เวอร์ชัน 2.6.0-alpha02
5 ตุลาคม 2022
androidx.navigation:navigation-*:2.6.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha02 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงพฤติกรรม
- เมื่อส่งรหัสของกราฟการนำทางไปยัง
AppBarConfiguration(เช่น ผ่านMenu) ตอนนี้NavigationUIจะพิจารณาเฉพาะปลายทางเริ่มต้นของกราฟการนำทางนั้นเป็นปลายทางระดับบนสุด แทนที่จะทำเครื่องหมายปลายทางทุกแห่งภายในกราฟเป็นปลายทางระดับบนสุดอย่างไม่ถูกต้อง ลักษณะการทำงานของการส่งรหัสของปลายทางแต่ละรายการจะไม่มีการเปลี่ยนแปลง ฟังก์ชันการทำงานเดียวกันนี้พร้อมใช้งานสำหรับโค้ดของคุณเองผ่านฟังก์ชันisTopLevelDestinationใหม่ในAppBarConfiguration(Ie936e, b/238496771)
แก้ไขข้อบกพร่อง
- ตอนนี้คอมโพเนนต์
navigation:navigation-fragmentขึ้นอยู่กับ Fragment เวอร์ชัน1.5.2แล้ว (I00ba4) - ระบบจะไม่อัปเดตรายการเมนูที่เลือกอีกต่อไปเมื่อไปยังปลายทาง
FloatingWindowเช่น กล่องโต้ตอบ (I4cde8, b/240308330)
เวอร์ชัน 2.6.0-alpha01
7 กันยายน 2022
androidx.navigation:navigation-*:2.6.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้การผสานรวม
setupWithNavControllerในNavigationUIสำหรับการทำงานกับแถบแอปด้านบนจะแยกวิเคราะห์ค่าR.stringสำหรับอาร์กิวเมนต์ReferenceTypeที่พบในandroid:labelเป็นค่าสตริงแทนการแสดงผลจำนวนเต็มของทรัพยากรที่สร้างขึ้นโดยอัตโนมัติ (I5f803, b/167959935) - ตอนนี้
NavDeepLinkรองรับค่าเริ่มต้นสำหรับอาร์เรย์ ซึ่งช่วยให้รองรับพารามิเตอร์การค้นหาซ้ำๆ ที่จะจับคู่กับประเภทอาร์เรย์ของอาร์กิวเมนต์ ตอนนี้NavTypeยังมีเมธอดเริ่มต้นซึ่งสามารถลบล้างเพื่อรวมค่าที่แยกวิเคราะห์ 2 ค่าเข้าด้วยกันได้ (Id68c3, b/209977108) - เมื่อใช้สตริง
${applicationId}เป็นตัวยึดตำแหน่งในแอตทริบิวต์app:dataและapp:dataPatternในองค์ประกอบกิจกรรมของไฟล์ XML การนำทาง ระบบจะป้อนตัวยึดตำแหน่งด้วยpackageNameของบริบทโดยอัตโนมัติเมื่อมีการขยาย (Iaabde, b/234223561) - ตอนนี้การพยายามสร้าง
NavDeepLinkที่ว่างเปล่าโดยใช้navDeepLinkKotlin DSL จะส่งผลให้เกิดคำเตือน Lint ที่ระบุว่า Deep Link ต้องมี URI, การดำเนินการ และ/หรือประเภท MIME จึงจะถูกต้อง (I08d2f, b/154038883)
การเปลี่ยนแปลง API
- เพิ่มฟังก์ชันส่วนขยาย
NavDestinationใหม่เพื่อแยกวิเคราะห์ป้ายกำกับแบบไดนามิกที่มีอาร์กิวเมนต์ในรูปแบบandroid:label="{arg}"เป็นสตริง รองรับอาร์กิวเมนต์ReferenceTypeโดยแยกวิเคราะห์ค่าR.stringเป็นค่าสตริง (I07d89, b/236269380)
การเปลี่ยนแปลงพฤติกรรม
argumentsของ NavBackStackEntry และargumentsที่ส่งไปยังOnDestinationChangedListenerจะเป็นเพียงสำเนาของอาร์กิวเมนต์ที่เปลี่ยนแปลงไม่ได้ซึ่งสร้างขึ้นเมื่อคุณไปยังปลายทางเท่านั้น ซึ่งหมายความว่าการเปลี่ยนแปลงใดๆ ที่เกิดขึ้นกับแพ็กเกจเหล่านั้นจะไม่แสดงในการเข้าถึงargumentsหรืออินสแตนซ์OnDestinationChangedListenerอื่นๆ ในภายหลัง (I676f5)
แก้ไขข้อบกพร่อง
- จากการนำทาง
2.5.2: ตอนนี้การนำทางแบบไดนามิกจะพยายามติดตั้งปลายทางของกิจกรรมจากโมดูลอื่นๆ อย่างเหมาะสมก่อนที่จะนำทางไปยังปลายทางเหล่านั้น (Ia2c16, b/240292838) - จาก Navigation
2.5.2: ตอนนี้ Navigation จะแทนที่อินสแตนซ์ Fragment อย่างถูกต้องเมื่อไปยังปลายทางเดียวกันและตั้งค่าแฟล็กlaunchSingleTopเป็น "จริง" (I5a2f1, b/237374580) - จากการนำทาง
2.5.2: แก้ไขIllegalStateExceptionที่เกิดจากการนำทางไปยังกราฟที่ซ้อนกัน 2 ชั้นซึ่งแชร์ระดับบนกับปลายทางเริ่มต้นที่แสดงขึ้นใหม่ (I9f7cb, b/243778589)
เวอร์ชัน 2.5
เวอร์ชัน 2.5.3
24 ตุลาคม 2022
androidx.navigation:navigation-*:2.5.3 เผยแพร่แล้ว เวอร์ชัน 2.5.3 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
NavHostจะไม่ทำให้เกิดNoSuchElementExceptionอีกต่อไปเมื่อไม่มีปลายทางที่พร้อมใช้งานสำหรับCrossfadeในการเขียน ตอนนี้ระบบจะข้ามการคอมโพสิชันไปเลย (Ieb46e, b/253299416)- แก้ไขปัญหาที่ระบบไม่ลืมและไม่นำสถานะ Compose ที่บันทึกไว้ (เช่น การใช้งาน
rememberSaveable) ออกเมื่อมีการนำปลายทางออกจาก Back Stack (I64949)
เวอร์ชัน 2.5.2
7 กันยายน 2022
androidx.navigation:navigation-*:2.5.2 เผยแพร่แล้ว เวอร์ชัน 2.5.2 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้การนำทางแบบไดนามิกจะพยายามติดตั้งปลายทางของกิจกรรมจากโมดูลอื่นๆ อย่างถูกต้องก่อนที่จะนำทางไปยังปลายทางเหล่านั้น (Ia2c16, b/240292838)
- ตอนนี้การนําทางจะแทนที่อินสแตนซ์ Fragment อย่างถูกต้องเมื่อนําทางไปยังปลายทางเดียวกันและตั้งค่าแฟล็ก
launchSingleTopเป็น "จริง" (I5a2f1, b/237374580) - แก้ไข
IllegalStateExceptionที่เกิดจากการไปยังกราฟที่ซ้อนกัน 2 ชั้นซึ่งแชร์ระดับบนกับปลายทางเริ่มต้นที่แสดงขึ้นใหม่ (I9f7cb, b/243778589)
การอัปเดตทรัพยากร Dependency
- ตอนนี้ Navigation
2.5.2ขึ้นอยู่กับ Fragment1.5.2(aosp/2178734)
เวอร์ชัน 2.5.1
27 กรกฎาคม 2022
androidx.navigation:navigation-*:2.5.1 เผยแพร่แล้ว เวอร์ชัน 2.5.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
Navigation Safe Argsจะไม่ทำให้เกิดคำเตือนการเลิกใช้งานในคลาสที่สร้างขึ้นอีกต่อไปเมื่อใช้ประเภทอาร์กิวเมนต์ที่กำหนดเองซึ่งบันทึกไว้ในBundle(Id86ed, b/237725966)
การอัปเดตทรัพยากร Dependency
- ตอนนี้ไลบรารีการนําทางจะขึ้นอยู่กับ Lifecycle
2.5.1(Ib4451) - ตอนนี้ไลบรารีการนําทางจะขึ้นอยู่กับ Activity
1.5.1(I3efe8) - ตอนนี้ไลบรารีการนําทางขึ้นอยู่กับ Fragment
1.5.1(I56177)
เวอร์ชัน 2.5.0
29 มิถุนายน 2022
androidx.navigation:navigation-*:2.5.0 เผยแพร่แล้ว เวอร์ชัน 2.5.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.4.0
- การผสานรวม CreationExtras - ตอนนี้
NavigationสามารถจัดเตรียมViewModelProvider.Factoryแบบไม่เก็บสถานะผ่านCreationExtrasของ Lifecycle2.5.0ได้แล้ว
Navigation SafeArgs
Navigation Safe Argsได้อัปเกรดทรัพยากร Dependency ของAndroid Gradle Pluginให้ใช้7.0.4ซึ่งทำให้ไม่สามารถใช้งานร่วมกับ AGP เวอร์ชันก่อน7.0ได้- เพิ่มการรองรับแอตทริบิวต์ build.gradle ของเนมสเปซเพื่อใช้แทน applicationId
การเปลี่ยนแปลงอื่นๆ
visibleEntriesAPI ไม่ได้อยู่ในขั้นทดลองอีกต่อไป และมีฟังก์ชันในการดึงข้อมูลรายการทั้งหมดที่มีปลายทางที่มองเห็นได้ในปัจจุบันตามNavController
เวอร์ชัน 2.5.0-rc02
15 มิถุนายน 2022
androidx.navigation:navigation-*:2.5.0-rc02 เผยแพร่แล้ว เวอร์ชัน 2.5.0-rc02 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อขัดข้องที่เกิดจากการสลับอย่างรวดเร็วระหว่างปลายทางด้านล่างเมื่อใช้ Navigation Compose
NavHost(I3979a, b/234054916) Navigation SafeArgsจะไม่ขัดข้องอีกต่อไปเมื่อใช้applicationIdSuffixและเนมสเปซที่ไม่มีapplicationIdหรือเมื่อapplicationIdและเนมสเปซแตกต่างกัน (I754b1, b/233119646)- ตอนนี้
NavArgumentมีฟังก์ชันtoString()ที่กำหนดเองเพื่อแสดงค่าภายในของอาร์กิวเมนต์ (I900a8)
เวอร์ชัน 2.5.0-rc01
11 พฤษภาคม 2022
androidx.navigation:navigation-*:2.5.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.5.0-rc01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่มกฎ Lint ใหม่เพื่อเตือนไม่ให้วางองค์ประกอบ
<deeplink>ไว้ในองค์ประกอบ<activity>ในไฟล์navigation.xml(Ic15a5, b/178403185)
แก้ไขข้อบกพร่อง
- ตอนนี้ขอบเขตที่ประกอบได้ใน
NavHostและDialogHostจะถูกกำจัดตามลำดับที่คาดไว้ กล่าวคือ Composable ภายในจะถูกกำจัดก่อน Composable ภายนอก (I157e6) - ตอนนี้ Navigation SafeArgs ใช้
PathSensitivity.RELATIVEในArgumentsGenerationTaskเพื่อให้ย้ายตำแหน่งแคชได้ ซึ่งหมายความว่าตอนนี้คุณสามารถนำรายการแคชกลับมาใช้ซ้ำได้ตั้งแต่บิลด์ CI ไปจนถึงบิลด์ในเครื่อง (I5f67c, b/173420454) - อัปเดตกฎ Lint
UnrememberedGetBackStackEntryDetectorเพื่อให้แน่ใจว่าการเรียกrememberที่อยู่รอบๆ การเรียกgetBackStackEntry()จะส่งผ่านออบเจ็กต์NavBackStackEntryเป็นคีย์ด้วย (Ib7081, b/227382831)
เวอร์ชัน 2.5.0-beta01
20 เมษายน 2022
androidx.navigation:navigation-*:2.5.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.5.0-beta01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้
DialogNavigatorจะใช้popWithTransitionเมื่อทำการเรียกdismiss()ซึ่งจะแก้ไขภาวะแข่งขันเมื่อใช้ViewModelภายในปลายทางdialogที่จะทำให้เกิดIllegalStateExceptionเมื่อปิดกล่องโต้ตอบโดยใช้การย้อนกลับของระบบหรือแตะนอกกล่องโต้ตอบเพื่อออก (Id7376, b/226552301)
การอัปเดตทรัพยากร Dependency
- ตอนนี้การนำทางจะขึ้นอยู่กับ Lifecycle
2.5.0-beta01ซึ่งจะแก้ไขIllegalStateExceptionเมื่อฝังNavHostไว้ในNavHostอื่นในแท็บแถบการไปยังส่วนต่างๆ ด้านล่างที่ไม่ใช่แท็บหลักเมื่อใช้ Back Stack หลายรายการ
เวอร์ชัน 2.5.0-alpha04
6 เมษายน 2022
androidx.navigation:navigation-*:2.5.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.5.0-alpha04 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
visibleEntriesไม่ได้อยู่ในขั้นทดลองอีกต่อไป (I4829f, b/225394514)
แก้ไขข้อบกพร่อง
- ตอนนี้ NavHost จะขึ้นอยู่กับ
visibleEntriesจากNavControllerเพื่อกำหนดรายการที่จะเขียน ซึ่งหมายความว่าเมื่อใช้ NavHost ที่ซ้อนกันNavHostด้านในควรแสดงภาพเคลื่อนไหวออกอย่างถูกต้องแล้ว (I4ba2b, b/225394514) - ตอนนี้
visibleEntriesStateFlowที่NavControllerระบุจะอิงตามสถานะวงจรสูงสุดของรายการแทนสถานะวงจรปัจจุบัน ซึ่งหมายความว่าแม้ว่าวงจรโฮสต์ของnavControllerจะต่ำกว่า STARTED รายการที่มองเห็นได้จะยังคงเหมือนเดิม (I9e2a8, b/225394514) - ตอนนี้
SavedStateViewFactoryรองรับการใช้CreationExtrasแม้ว่าจะเริ่มต้นด้วยSavedStateRegistryOwnerก็ตาม หากมีการระบุข้อมูลเพิ่มเติม ระบบจะไม่สนใจอาร์กิวเมนต์ที่เริ่มต้น (I6c43b, b/224844583) - ตอนนี้
NavDeepLinkสามารถแยกวิเคราะห์ URI ที่มีพารามิเตอร์การค้นหาเดียวที่ไม่มีค่าได้แล้ว (I0efe8, b/148905489) - ตอนนี้ระบบจะถือว่าสตริงว่างเป็นอาร์กิวเมนต์ที่ถูกต้องใน Deep Link (I70a0d, b/217399862)
Navigation Safe Argsจะไม่ขัดข้องอีกต่อไปเมื่อใช้เนมสเปซและไม่มีAndroidManifest.xmlอยู่ (I17ccf, b/227229815)
เวอร์ชัน 2.5.0-alpha03
23 กุมภาพันธ์ 2022
androidx.navigation:navigation-*:2.5.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.5.0-alpha03 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้คุณสามารถส่ง
CreationExtrasไปยังby navGraphViewModelsเพื่อสร้างViewModelได้แล้ว (I29217, b/217618359)
แก้ไขข้อบกพร่อง
- ตอนนี้
NavDeepLinksรองรับอักขระขึ้นบรรทัดใหม่ที่เข้ารหัสซึ่งฝังอยู่ใน URI ของเส้นทาง/Deep Link อย่างถูกต้องแล้ว (I513d1, b/217815060) - ตอนนี้
CreationExtrasจะทำงานอย่างถูกต้องเมื่อใช้กับNavBackStackEntriesเพื่อสร้าง ViewModel (I69161, b/217617710) - ตอนนี้ Navigation Safe Args รองรับการใช้เนมสเปซที่กำหนดใน
build.gradleแทนแพ็กเกจใน AndroidManifest แล้ว (I659ef, b/217414933)
เวอร์ชัน 2.5.0-alpha02
9 กุมภาพันธ์ 2022
androidx.navigation:navigation-*:2.5.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.5.0-alpha02 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- จากการนําทาง
2.4.1: ตอนนี้NavHostFragmentจะตั้งค่าOnBackPressedDispatcherอย่างถูกต้องเมื่อใช้ ViewBinding กับกราฟที่ฝังอยู่ (Ifbb51, b/214577959) - จากการนำทาง
2.4.1: เมื่อทำ Deep Link ผ่านNavGraphที่ฝังซ้อนกันหลายรายการ ตอนนี้ Back Stack จะรวมปลายทางเริ่มต้นระดับกลางอย่างเหมาะสม (I504c0, b/214383060)
เวอร์ชัน 2.5.0-alpha01
26 มกราคม 2022
androidx.navigation:navigation-*:2.5.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.5.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้
NavBackStackEntryผสานรวมกับ ViewModel CreationExtras ซึ่งเปิดตัวเป็นส่วนหนึ่งของ Lifecycle2.5.0-alpha01(Ib9fe2, b/207012490)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่การเข้าถึง
ViewModelที่สร้างผ่านby navGraphViewModels()จากonCreate()ของ Fragment ไม่สำเร็จพร้อมข้อผิดพลาดIllegalStateException(I8a14d) NavDeepLinkจะไม่ถอดรหัสอาร์กิวเมนต์ 2 ครั้งโดยไม่จำเป็นอีกต่อไป ซึ่งหมายความว่าระบบจะส่งอาร์กิวเมนต์ที่ถูกต้องไปยังปลายทางสุดท้ายของคุณแล้ว (I31b0a, b/210711399)
Safe Args
- ตอนนี้ Safe Args ขึ้นอยู่กับปลั๊กอิน Android Gradle เวอร์ชัน 7.0.4 ซึ่งหมายความว่า Navigation Safe Args จะใช้กับ Android Studio เวอร์ชันก่อน 7.0 ไม่ได้อีกต่อไป แต่ตอนนี้ใช้กับปลั๊กอิน Android Gradle เวอร์ชัน 7.1.0 ขึ้นไปได้แล้ว (I41c88, b/213086135, b/207670704)
เวอร์ชัน 2.4.2
เวอร์ชัน 2.4.2
6 เมษายน 2022
androidx.navigation:navigation-*:2.4.2 เผยแพร่แล้ว เวอร์ชัน 2.4.2 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- พอร์ตย้อนหลังจาก Navigation
2.5.0-alpha03: ตอนนี้NavDeepLinksรองรับอักขระขึ้นบรรทัดใหม่ที่เข้ารหัสซึ่งฝังอยู่ใน URI ของเส้นทาง/Deep Link อย่างถูกต้องแล้ว (I513d1, b/217815060) - พอร์ตย้อนหลังจาก Navigation
2.5.0-alpha03: ตอนนี้ Navigation SafeArgs รองรับการใช้เนมสเปซที่กำหนดในbuild.gradleแทนแพ็กเกจใน AndroidManifest แล้ว (I659ef, b/217414933) - พอร์ตย้อนหลังจาก Navigation
2.5.0-alpha04:Navigation Safe Argsจะไม่ขัดข้องอีกต่อไปเมื่อใช้เนมสเปซและไม่มีAndroidManifest.xmlอยู่ (I17ccf, b/227229815) - พอร์ตย้อนหลังจาก Navigation
2.5.0-alpha04: ตอนนี้ระบบจะถือว่าสตริงว่างเป็นอาร์กิวเมนต์ที่ถูกต้องใน Deep Link (I70a0d, b/217399862)
เวอร์ชัน 2.4.1
เวอร์ชัน 2.4.1
9 กุมภาพันธ์ 2022
androidx.navigation:navigation-*:2.4.1 เผยแพร่แล้ว เวอร์ชัน 2.4.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้
NavHostFragmentจะตั้งค่าOnBackPressedDispatcherอย่างถูกต้องเมื่อใช้ View Binding กับกราฟที่ฝังอยู่ (Ifbb51, b/214577959) - เมื่อทำ Deep Link ผ่าน
NavGraphที่ซ้อนกันหลายรายการ ตอนนี้ Back Stack จะรวมปลายทางเริ่มต้นระดับกลางอย่างถูกต้อง (I504c0, b/214383060) - พอร์ตย้อนหลังจาก Navigation
2.5.0-alpha01: แก้ไขปัญหาที่การเข้าถึง ViewModel ที่สร้างผ่านby navGraphViewModels()จากonCreate()ของ Fragment จะไม่สำเร็จพร้อมข้อผิดพลาดIllegalStateException(I8a14d) - พอร์ตย้อนกลับจากการนำทาง
2.5.0-alpha01:NavDeepLinks ไม่ถอดรหัสอาร์กิวเมนต์ 2 ครั้งโดยไม่จำเป็นอีกต่อไป ซึ่งหมายความว่าระบบจะส่งอาร์กิวเมนต์ที่ถอดรหัสอย่างถูกต้องไปยังปลายทางสุดท้ายแล้ว (I31b0a, b/210711399) - พอร์ตย้อนหลังจาก Navigation
2.5.0-alpha01: ตอนนี้ Safe Args ขึ้นอยู่กับปลั๊กอิน Android Gradle เวอร์ชัน 7.0.4 ซึ่งหมายความว่า Navigation Safe Args จะใช้กับ Android Studio เวอร์ชันก่อน 7.0 ไม่ได้อีกต่อไป แต่ตอนนี้ใช้กับปลั๊กอิน Android Gradle เวอร์ชัน 7.1.0 ขึ้นไปได้แล้ว (I41c88, b/213086135, b/207670704)
เวอร์ชัน 2.4.0
เวอร์ชัน 2.4.0
26 มกราคม 2022
androidx.navigation:navigation-*:2.4.0 เผยแพร่แล้ว เวอร์ชัน 2.4.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.3.0
- อาร์ติแฟกต์การนําทางทั้งหมดได้รับการเขียนใหม่ใน Kotlin ซึ่งช่วยปรับปรุงความสามารถในการเป็นค่า Null ของคลาสที่ใช้ Generics (เช่น คลาสย่อย
NavType) ฟังก์ชันส่วนขยาย Kotlin ทั้งหมดที่เคยเป็นส่วนหนึ่งของอาร์ติแฟกต์-ktxได้ย้ายไปยังอาร์ติแฟกต์หลักที่เกี่ยวข้องแล้ว ระบบจะยังคงเผยแพร่อาร์ติแฟกต์-ktxต่อไป แต่จะไม่มีข้อมูลใดๆ เลย - ตอนนี้อาร์ติแฟกต์
navigation-fragmentมีการติดตั้งใช้งานเลย์เอาต์ 2 แผงที่สร้างไว้ล่วงหน้าผ่านAbstractListDetailFragmentใหม่ Fragment นี้ใช้SlidingPaneLayoutเพื่อจัดการแผงรายการ (ซึ่งคลาสย่อยของคุณมีให้) และแผงรายละเอียด ซึ่งใช้NavHostFragmentเป็นการติดตั้งใช้งาน ดังที่เห็นในตัวอย่างการติดตั้งใช้งาน - เมธอด
currentBackStackEntryAsFlow()ในNavControllerจะให้Flowที่ส่งออกเมื่อใดก็ตามที่NavBackStackEntryปัจจุบันมีการเปลี่ยนแปลง คุณสามารถใช้ขั้นตอนนี้เป็นทางเลือกแทนการจัดการOnDestinationChangedListenerด้วยตนเอง - ตอนนี้ NavController มีความสามารถในการดึงข้อมูลรายการอินสแตนซ์
NavBackStackEntryที่มองเห็นได้ทั้งหมดเป็นStateFlowผ่านพร็อพเพอร์ตี้visibleEntriesเวอร์ชันทดลอง - ตอนนี้คุณสามารถขยายคลาส
NavTypeเพื่อสร้าง NavType ที่กำหนดเองได้แล้ว ระบบรองรับประเภทที่กำหนดเองเฉพาะเมื่อสร้างกราฟการนำทางแบบเป็นโปรแกรม เช่น ผ่าน Navigation Graph Kotlin DSL ตอนนี้ Navigation มี API
findStartDestination()และgetHierarchy()ที่ใช้เพื่อช่วยติดตั้งใช้งาน NavigationUI ที่กำหนดเองได้findStartDestination()เป็นฟังก์ชันส่วนขยายในNavGraphซึ่งจะค้นหาปลายทางเริ่มต้นจริงที่จะแสดงเมื่อคุณไปยังกราฟ แม้ว่าstartDestinationจะเป็นNavGraphที่ฝังอยู่ก็ตามgetHierarchy()เป็นฟังก์ชันในNavDestinationที่ใช้เพื่อยืนยันว่าปลายทางที่ระบุอยู่ภายในลำดับชั้นของปลายทางอื่นหรือไม่val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }อัปเดตเมธอด
NavigationUIที่ใช้BottomNavigationViewให้ใช้คลาสใหญ่สุดที่เปิดตัวใน Material1.4.0,NavigationBarViewแทน ซึ่งจะช่วยให้ใช้วิธีการเหล่านี้กับNavigationRailViewได้เมื่อขยายองค์ประกอบ
<action>ผ่าน XML แอตทริบิวต์ภาพเคลื่อนไหวจะใช้แอตทริบิวต์ที่ดึงมาจากธีมโดยใช้ไวยากรณ์app:enterAnim="?attr/transitionEnter"ได้ตอนนี้ Safe Args จะสร้างเมธอด
fromSavedStateHandle()สำหรับคลาสNavArgsแต่ละคลาส (#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) }
เส้นทางการนำทางและ Kotlin DSL
Navigation เวอร์ชันก่อนหน้าอาศัยปลายทางแต่ละแห่งที่มีรหัสจำนวนเต็มคงที่ซึ่งจะระบุปลายทางนั้นๆ โดยไม่ซ้ำกับปลายทางที่เกี่ยวข้อง และช่วยให้คุณnavigate()ไปยังปลายทางนั้นได้โดยตรงหรือผ่านการดำเนินการ แม้ว่าวิธีนี้จะยังคงใช้ได้และมีประโยชน์ โดยเฉพาะในกรณีที่คุณกำหนดกราฟการนำทางใน XML และสามารถใช้ค่าคงที่ R.id ที่สร้างขึ้นโดยอัตโนมัติหรือ Safe Args (ซึ่งใช้ค่าคงที่เหล่านั้นเพื่อสร้างโค้ดในเวลาบิลด์) แต่ระบบจำนวนเต็มที่ไม่ซ้ำกันนี้ไม่ได้จับความหมายเชิงความหมายและความสามารถในการแสดงออกที่จำเป็นต่อการรองรับกราฟแบบไดนามิกเต็มรูปแบบที่สร้างขึ้นแบบเป็นโปรแกรมที่รันไทม์ผ่าน Navigation Kotlin DSL
รุ่นนี้เปิดตัวตัวเลือกใหม่สำหรับการระบุปลายทางในกราฟการนำทางโดยไม่ซ้ำกันด้วยเส้นทาง เส้นทางคือ String ที่กำหนดเส้นทางที่ไม่ซ้ำกันไปยังจุดหมาย ตอนนี้เมธอด Kotlin DSL ทั้งหมดที่ใช้รหัสปลายทางเลิกใช้งานแล้ว และแทนที่ด้วย API ที่เทียบเท่าซึ่งใช้เส้นทาง
แต่ละเส้นทางควรได้รับการพิจารณาเป็นส่วน "เส้นทาง" ของ Uri ที่กำหนดปลายทางนั้น เช่น home, profile/{userId}, profile/{userId}/friends เป็นต้น เมื่อข้อมูลระบุตัวตนของปลายทางเชื่อมโยงกับเนื้อหาที่เฉพาะเจาะจง อาร์กิวเมนต์แบบไดนามิกเหล่านั้นควรเป็นส่วนหนึ่งของเส้นทาง โดยเป็นไปตามกฎเดียวกันกับ Implicit Deep Link
ตอนนี้ NavController API ทั้งหมดที่เคยใช้เฉพาะรหัสมีการโอเวอร์โหลดที่ใช้เส้นทาง String ซึ่งรวมถึง navigate(), popBackStack(), popUpTo() และ getBackStackEntry()
ซึ่งส่งผลต่อ API ดังนี้
- เลิกใช้งานพร็อพเพอร์ตี้ Kotlin
popUpToใน Kotlin DSL แล้วเพื่อใช้popUpToIdแทน - เราได้เลิกใช้งาน
getStartDestination()API แล้วเพื่อเปลี่ยนไปใช้getStartDestinationId()
การไปยังส่วนต่างๆ ตามเส้นทางจะแตกต่างจากการไปยังส่วนต่างๆ ตามรหัส โดยจะเป็นไปตามกฎเดียวกันกับ Implicit Deep Link ตรงที่คุณสามารถไปยังปลายทางใดก็ได้ในกราฟที่ฝังอยู่โดยตรง ซึ่งช่วยให้มั่นใจได้ว่าเส้นทางเหล่านี้จะใช้ได้ในโปรเจ็กต์แบบหลายโมดูลโดยไม่ต้องเพิ่ม Deep Link ที่มองเห็นได้จากภายนอกไปยังปลายทางแต่ละแห่งอย่างชัดเจน
Navigation Compose
อาร์ติแฟกต์ navigation-compose ช่วยผสานรวมระหว่างคอมโพเนนต์การนำทางกับ Jetpack Compose โดยใช้ฟังก์ชัน @Composable เป็นปลายทางในแอปพลิเคชัน
โดยรุ่นนี้มีรายละเอียดดังต่อไปนี้
- Composable
NavHostที่ช่วยให้คุณสร้างกราฟการนำทางผ่าน Kotlin DSL โดยใช้ปลายทางcomposableและdialogรวมถึงรองรับ Navigator ที่ไม่บังคับ เช่น Navigator จาก Accompanist Navigation Material - ต้องรองรับการครอสเฟดระหว่างปลายทาง คุณใช้ Accompanist Navigation Animation เพื่อควบคุมการเปลี่ยนผ่านเข้าและออกโดยใช้ Compose API เวอร์ชันทดลองได้
- การกำหนดขอบเขตของ
Lifecycleไปยังปลายทาง Composable แต่ละแห่ง ปลายทางแต่ละแห่งจะเข้าสู่สถานะRESUMEDเมื่อการเปลี่ยนสถานะขาเข้าเสร็จสิ้น และจะเปลี่ยนเป็นSTARTEDทันทีเมื่อการเปลี่ยนสถานะขาออกเริ่มต้นขึ้น ซึ่งจะช่วยให้คุณหลีกเลี่ยงปัญหาIllegalStateExceptionและการแตะหลายครั้งได้โดยการเรียกใช้navigateเมื่อLifecycleเป็นRESUMEDเท่านั้น - การกำหนดขอบเขตของ
ViewModel(ผ่าน APIviewModel()ของ Lifecycle ViewModel Compose2.4.0หรือhiltViewModel()ของ Hilt Navigation Compose1.0.0ที่ระดับปลายทาง ซึ่งให้ขอบเขตที่คงอยู่หลังจากการเปลี่ยนแปลงการกำหนดค่าและอยู่ใน Back Stack (เมื่อเนื้อหา Composable ถูกกำจัดไปแล้ว) และสัญญาณในonCleared()ของ ViewModel ที่บ่งบอกถึงการกำจัดและการล้างสถานะที่เชื่อมโยงกับNavBackStackEntryนั้นอย่างถาวร - การกำหนดขอบเขตของสถานะ
rememberSaveableที่ระดับปลายทาง เพื่อให้มั่นใจว่าสถานะ Composable ทั้งหมดจะได้รับการบันทึกและกู้คืนโดยอัตโนมัติเมื่อคุณกลับไปยังปลายทาง - รองรับการบันทึกและกู้คืนสถานะของ
NavControllerและสถานะของปลายทางอย่างเต็มรูปแบบหลังจากสิ้นสุดการประมวลผลและการสร้างใหม่ - การผสานรวมอัตโนมัติกับปุ่มย้อนกลับของระบบ
รองรับการส่งอาร์กิวเมนต์ การแนบ Deep Link ไปยังปลายทาง และการแสดงผลลัพธ์ไปยังปลายทางก่อนหน้า
ตัวช่วยเฉพาะของ Compose ใน
rememberNavController()และcurrentBackStackEntryAsState()เพื่ออนุญาตสถานะการโฮสต์และการเชื่อมต่อNavControllerกับ Composable นอกNavHost(เช่น แถบการนำทางด้านล่าง)
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()
}
}
}
ดูข้อมูลเพิ่มเติมได้ที่คู่มือการนำทางใน Compose
Back Stack หลายรายการ
NavController มีหน้าที่จัดการ Back Stack ของปลายทาง โดยเพิ่มปลายทางลงใน Back Stack เมื่อคุณnavigate()ไปยังปลายทางเหล่านั้น และนำออกเมื่อคุณเรียกใช้ popBackStack() หรือเรียกให้ปุ่มย้อนกลับของระบบทำงาน คลาส NavOptions ที่มีอยู่และการผสานรวมเข้ากับองค์ประกอบ <action> ใน XML ของกราฟการนำทางได้รับการขยายเพื่อรองรับการบันทึกและการกู้คืน Back Stack
การเปลี่ยนแปลงนี้จะทำให้เมธอด NavigationUI ของ onNavDestinationSelected(), BottomNavigationView.setupWithNavController() และ NavigationView.setupWithNavController() บันทึกและกู้คืนสถานะของปลายทางที่แสดงขึ้นโดยอัตโนมัติ ซึ่งจะช่วยรองรับ Back Stack หลายรายการโดยไม่ต้องเปลี่ยนแปลงโค้ด เมื่อใช้การนําทางกับ Fragment วิธีนี้เป็นวิธีที่แนะนําในการผสานรวมกับ Back Stack หลายรายการ
API พื้นฐานสำหรับการบันทึกและกู้คืนสถานะจะแสดงผ่านแพลตฟอร์มต่างๆ ดังนี้
ใน Navigation XML ตอนนี้องค์ประกอบ
<action>สามารถใช้แอตทริบิวต์บูลีนของapp:popUpToSaveStateและapp:restoreStateเพื่อบันทึกสถานะของปลายทางที่แสดงผ่านapp:popUpToและกู้คืนสถานะที่เชื่อมโยงกับปลายทางที่ส่งเป็นapp:destinationได้แล้ว<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 คุณสามารถเพิ่มพร็อพเพอร์ตี้บูลีนrestoreStateและพร็อพเพอร์ตี้บูลีนsaveStateในpopUpTobuilder ได้ดังนี้// 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ด้วยตนเองผ่านNavOptions.Builderคุณสามารถใช้setRestoreState()และโอเวอร์โหลดใหม่เพื่อsetPopUpTo()ซึ่งใช้พารามิเตอร์saveStateเพิ่มเติม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()แบบเป็นโปรแกรมสามารถรวมพารามิเตอร์saveStateเพิ่มเติมได้แล้วคุณสามารถใช้เมธอด
clearBackStack()เพื่อล้างสถานะที่บันทึกไว้ด้วยpopBackStack()หรือpopUpToSaveState
ในทุกกรณี NavController จะบันทึกและกู้คืนสถานะของ NavBackStackEntry แต่ละรายการ รวมถึงอินสแตนซ์ ViewModel ที่กำหนดขอบเขตปลายทางการนำทาง API ของ Navigator ได้รับการอัปเดตเพื่อให้ Navigator แต่ละรายการรองรับการบันทึกและกู้คืนสถานะของตนเอง
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้
NavDeepLinkBuilderจะเพิ่มPendingIntent.FLAG_IMMUTABLEลงในPendingIntentที่แสดงผลโดยcreatePendingIntent()เพื่อให้มั่นใจว่า API นี้จะทำงานตามที่คาดไว้เมื่อกำหนดเป้าหมายเป็น Android 12 - ตอนนี้การนำทางจะขึ้นอยู่กับ
Lifecycle
2.3.1และตอนนี้จะทำเครื่องหมายsetGraph(),popBackStack(),navigateUp()และnavigate()ซึ่งเป็น เมธอดที่อัปเดตNavBackStackEntryLifecycleเป็น@MainThreadเพื่อปรับการนำทางให้สอดคล้องกับการบังคับใช้ เทรดหลักที่เปิดตัวใน Lifecycle2.3.0 - ตอนนี้ Deep Link จะยืนยันว่าอาร์กิวเมนต์ที่จำเป็นทั้งหมด (อาร์กิวเมนต์ที่ไม่มีค่าเริ่มต้น) อยู่ใน
Uri - ตอนนี้อาร์กิวเมนต์ที่แยกวิเคราะห์แล้วของ
NavDeepLinkจะพิจารณาเครื่องหมายปอนด์ในลักษณะเดียวกับเครื่องหมายคำถามเป็นตัวคั่นระหว่างกลุ่มเส้นทาง เพื่อป้องกันไม่ให้อาร์กิวเมนต์ขยายข้ามเครื่องหมายปอนด์ - เมื่อสร้างการดำเนินการ ตอนนี้โค้ด Kotlin ที่สร้างจาก Safe Args จะใส่อาร์กิวเมนต์ที่ไม่มีค่าเริ่มต้นไว้ก่อนอาร์กิวเมนต์ที่มีค่าเริ่มต้นเป็นพารามิเตอร์
- เมื่อสร้างอาร์กิวเมนต์ ตอนนี้ Safe Args จะวางพารามิเตอร์ที่ไม่มีค่าเริ่มต้นไว้ก่อนพารามิเตอร์ที่มีค่าเริ่มต้น
- ตอนนี้ Safe-Args ขึ้นอยู่กับปลั๊กอิน Android Gradle 4.2.0 ซึ่งหมายความว่าคุณจะไม่ได้รับคำเตือนว่ากำลังใช้
applicationIdTextResourceอีกต่อไป
ปัญหาที่ทราบ
- แก้ไขแล้วใน Navigation
2.5.0-alpha01: การเข้าถึงViewModelที่สร้างผ่านby navGraphViewModels()จากonCreate()ของ Fragment จะไม่สำเร็จพร้อมข้อผิดพลาดIllegalStateException(b/213504272) - แก้ไขแล้วใน Navigation
2.5.0-alpha01: Safe Args 2.4.0 ใช้ร่วมกับปลั๊กอิน Android Gradle 7.1.0 ขึ้นไปไม่ได้ (b/213086135) - การทำ Deep Link ด้วยกราฟการนำทางที่ซ้อนกันหลายรายการสร้าง Back Stack แบบเต็มไม่ถูกต้อง (b/214383060)
เวอร์ชัน 2.4.0-rc01
15 ธันวาคม 2021
androidx.navigation:navigation-*:2.4.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.4.0-rc01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้อาร์กิวเมนต์ที่แยกวิเคราะห์แล้วของ
NavDeepLinkจะพิจารณาเครื่องหมายปอนด์ในลักษณะเดียวกับเครื่องหมายคำถามเป็นตัวคั่นระหว่างอาร์กิวเมนต์ (I21309, b/180042703)
แก้ไขข้อบกพร่อง
- Deep Link จะไม่ละเว้นอาร์กิวเมนต์ที่มีค่าเหมือนกับชื่อของตัวยึดตำแหน่งอีกต่อไป (If8017, b/207389470)
NavControllerจะไม่ขัดข้องอีกต่อไปเมื่อแสดงปลายทางที่ฝังอยู่โดยใช้การเปลี่ยนหลังจากกู้คืนNavControllerแล้ว (I0f7c9, b/205021623)- ตอนนี้ข้อความแสดงข้อผิดพลาดเมื่อใช้
startDestinationที่ไม่ถูกต้องจะเปลี่ยนเป็นเส้นทางของจุดเริ่มต้นโดยค่าเริ่มต้น หากมี (I86b9d, b/208041894)
การแก้ไขข้อบกพร่องของ Navigation Compose
- แก้ไขข้อขัดข้องที่อาจเกิดขึ้นจากการสลับอย่างรวดเร็วระหว่างปลายทางเริ่มต้นกับปลายทางอื่นโดยใช้รายการเมนูการนำทางด้านล่าง (Ic8976, b/208887901)
- ตอนนี้ระบบจะกู้คืนปลายทางของกล่องโต้ตอบที่ด้านบนของหน้าจออย่างถูกต้องหลังจากการเปลี่ยนแปลงการกำหนดค่าหรือการสิ้นสุดการประมวลผล (I4c0dc, b/207386169)
- แก้ไขปัญหาที่การพยายามดึงข้อมูล
ViewModelจากNavBackStackEntryของกล่องโต้ตอบไม่สำเร็จเมื่อปิดกล่องโต้ตอบ (I6b96d, b/206465487) - แก้ไขปัญหาเมื่อใช้ปลายทาง
activityกับNavHostของ Navigation Compose ซึ่งจะส่งผลให้เกิดการจัดองค์ประกอบใหม่แบบไม่สิ้นสุด (I8f64c) - แก้ไขการรั่วไหลใน Navigation Compose ซึ่งเก็บการอ้างอิงกิจกรรมเก่าไว้หลังจากการเปลี่ยนแปลงการกำหนดค่าหรือการสิ้นสุดการประมวลผล (I4efcb, b/204905432)
การแก้ไขข้อบกพร่องของ Safe Args
SafeArgsไม่ขัดข้องอีกต่อไปเมื่อพยายามกู้คืนอาร์เรย์ Parcelable ที่กำหนดเองหลังจากการสิ้นสุดการประมวลผล (I618e8, b/207315994)- แก้ไขข้อบกพร่องใน Safe Args ที่ไม่อนุญาตให้อาร์เรย์บูลีนมีค่า
null(I8c396, b/174787525)
เวอร์ชัน 2.4.0-beta02
3 พฤศจิกายน 2021
androidx.navigation:navigation-*:2.4.0-beta02 เผยแพร่แล้ว เวอร์ชัน 2.4.0-beta02 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้การจัดการทั้ง Explicit Deep Link และ Implicit Deep Link จะเพิ่มแฟล็ก
saveStateโดยอัตโนมัติเมื่อไปยังกราฟอื่น เพื่อให้มั่นใจว่าโค้ด เช่นNavigationUI.setupWithNavControllerและโค้ดที่ใช้ Back Stack หลายรายการจะทำงานตามที่คาดไว้ (Ic8807)
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้ระบบจะคอมไพล์รูปแบบ Deep Link แบบ Lazy ใน NavDeepLink แทนที่จะคอมไพล์ระหว่างการสร้างอินสแตนซ์ ซึ่งจะช่วยปรับปรุงเวลาในการสร้างกราฟการนําทางที่มี Deep Link (b8d257, b/184149935)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ NavBackStackEntries ถูกพุชลงไปที่
Lifecycle.State.CREATEDหลังจากย้ายไปยังLifecycle.State.STARTEDเมื่อมีการเพิ่มNavHostลงในsetContent()ของกิจกรรมโดยตรง (Ia5ac1, b/203536683) - แก้ไขภาวะแข่งขันที่การนำปลายทาง
DialogFragmentออกจาก Back Stack ก่อนที่กล่องโต้ตอบจะแสดงขึ้นจริงไม่ได้ปิดกล่องโต้ตอบจริงๆ ซึ่งส่งผลให้เกิดข้อขัดข้องเมื่อผู้ใช้ปิดกล่องโต้ตอบที่ผิดพลาดด้วยตนเอง (I687e5) - แก้ไขปัญหาที่ API
onNavDestinationSelectedในNavigationUIแสดงผลtrueแม้ว่าคุณจะไม่ได้navigate()ไปยังกราฟการนำทางนั้นจริงๆ ตอนนี้ระบบจะใช้ตรรกะเดียวกันกับที่setupWithNavControllerใช้ภายในเพื่อเลือกเฉพาะMenuItemที่เชื่อมโยงกับปลายทางปัจจุบันโดยใช้hierarchyของปลายทาง (I2b053)
เวอร์ชัน 2.4.0-beta01
27 ตุลาคม 2021
androidx.navigation:navigation-*:2.4.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.4.0-beta01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้คุณสามารถใช้
by navGraphViewModelกับเส้นทางแทนการใช้รหัสเพื่อรองรับการใช้ Navigation Kotlin DSL กับ Fragment ได้ดียิ่งขึ้น (I901e3, b/201446416)
การเปลี่ยนแปลง API
- ตอนนี้
visibleEntriesAPI อยู่ในขั้นทดลอง (I93f6f)
แก้ไขข้อบกพร่อง
- ระบบจะไม่ทำลาย ViewModel อีกต่อไปเมื่อการเปลี่ยนถูกขัดจังหวะด้วยการไปยังหน้าจอเดียวกันไปมา (Id52d8, b/200817333)
- อาร์กิวเมนต์
NavDeepLinkที่เป็น Null ได้ไม่จำเป็นต้องมีค่าเริ่มต้นอีกต่อไปเมื่อเพิ่ม Deep Link ลงในNavDestination(I5aad4, b/201320030) - ตอนนี้ NavBackStackEntries ที่มีวงจรต่างกันจะไม่ถือว่าเท่ากันอีกต่อไป ซึ่งหมายความว่า NavHost จะจัดองค์ประกอบปลายทางทั้งหมดใหม่ได้อย่างเหมาะสมเมื่อทำการนำทางด้วย singleTop และเมื่อเลือกรายการเมนูด้านล่างอีกครั้ง (I1b351, b/196997433)
- แก้ไขปัญหาเกี่ยวกับ
AbstractListDetailFragmentที่ทำให้แอตทริบิวต์layout_widthและlayout_weightในแผงรายการที่onCreateListPaneView()แสดงผลได้รับการจัดการอย่างไม่ถูกต้องหรือถูกละเว้น (f5fbf3) - ตอนนี้สถานะภาพของปลายทางกล่องโต้ตอบจะซิงค์กับสถานะของ
DialogFragmentNavigatorอย่างถูกต้อง ซึ่งหมายความว่าการเรียกใช้ APIdismiss()แบบอะซิงโครนัสด้วยตนเองสำหรับDialogFragmentจะล้างปลายทางของกล่องโต้ตอบทั้งหมดที่อยู่เหนือกล่องโต้ตอบที่ปิดไปแล้วได้อย่างถูกต้อง ซึ่งจะไม่ส่งผลต่อกรณีที่คุณใช้popUpToหรือpopBackStack()เพื่อปิดกล่องโต้ตอบ (I77ba2) - ตอนนี้
AbstractAppBarOnDestinationChangedListenerมีข้อความแสดงข้อผิดพลาดที่ชัดเจนยิ่งขึ้นสำหรับonDestinationChanged()(Ie742d)
เวอร์ชัน 2.4.0-alpha10
29 กันยายน 2021
androidx.navigation:navigation-*:2.4.0-alpha10 เผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha10 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้ NavController มีความสามารถในการดึงข้อมูลรายการอินสแตนซ์
NavBackStackEntryที่มองเห็นได้ทั้งหมดผ่านvisibleEntriesStateFlow (Ia964e) - ตอนนี้
rememberNavController()จะใช้ชุดอินสแตนซ์Navigatorที่ไม่บังคับซึ่งจะเพิ่มลงในNavControllerที่แสดงผลเพื่อรองรับ Navigator ที่ไม่บังคับได้ดียิ่งขึ้น เช่น Navigator จาก Accompanist Navigation Material (I4619e)
แก้ไขข้อบกพร่อง
- การนําทางแบบไดนามิกจะไม่ขัดข้องอีกต่อไปเมื่อมีการสร้างกิจกรรมขึ้นมาใหม่ (Ifa6a3, b/197942869)
- แก้ไขปัญหาเกี่ยวกับปุ่มย้อนกลับของระบบซึ่งเกิดขึ้นหลังจากกลับไปยังปลายทางที่ประกอบกันได้ซึ่งมี
NavHostเท่านั้น (3ed148, b/195668143) - ตอนนี้ SafeArgs จะสร้างอาร์กิวเมนต์สำหรับ
fromBundle()และfromSavedStateHandle()ตามลำดับพารามิเตอร์ที่เหมาะสม (I824a8, b/200059831)
เวอร์ชัน 2.4.0-alpha09
15 กันยายน 2021
androidx.navigation:navigation-*:2.4.0-alpha09 เผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha09 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้คุณสามารถใช้เมธอด
clearBackStack()เพื่อล้างสถานะที่บันทึกไว้ด้วยpopBackStack()หรือpopUpToSaveStateได้แล้ว (I80a0f) - ตอนนี้คุณสามารถส่งรายการอาร์กิวเมนต์และ/หรือ Deep Link ไปยังเครื่องมือสร้างกราฟการนําทางที่ฝังอยู่ได้แล้ว และระบบจะเพิ่มรายการเหล่านั้นลงในกราฟที่ได้โดยอัตโนมัติ (I8a470, b/182545357)
การเปลี่ยนแปลง API
- ตอนนี้ฟังก์ชัน
navArgumentKotlin DSL เป็นส่วนหนึ่งของnavigation-commonแทนที่จะเป็นnavigation-composeซึ่งจะต้องอัปเดตการนำเข้าเพื่อใช้ฟังก์ชันนี้ต่อไป (I1d095)
การเปลี่ยนแปลงพฤติกรรม
- เมื่อสร้างอาร์กิวเมนต์ ตอนนี้ Safe Args จะวางพารามิเตอร์ที่ไม่มีค่าเริ่มต้นไว้ก่อนพารามิเตอร์ที่มีค่าเริ่มต้น (I89709, b/198493585)
แก้ไขข้อบกพร่อง
- เมื่อใช้ Navigation Compose ระบบจะ
DESTROYEDNavGraph ก็ต่อเมื่อDESTROYEDองค์ประกอบย่อยทั้งหมดแล้วเท่านั้น (I86552, b/198741720) - อาร์กิวเมนต์
NavDeepLinkที่เป็นค่า Null ได้ไม่จำเป็นต้องมีค่าเริ่มต้นอีกต่อไป (Ia14ef, b/198689811) - ตอนนี้การเรียกใช้
setGraph()ด้วยกราฟใหม่จะล้าง Back Stack ที่บันทึกไว้ด้วย นอกเหนือจากลักษณะการทำงานก่อนหน้านี้ในการแสดง Back Stack (I97f96) - แก้ไขปัญหาที่อินสแตนซ์
OnDestinationChangedListenerและcurrentBackStackEntryFlowไม่ได้รับการแจ้งเตือนเมื่อใช้launchSingleTop(Iaaebc)
การอัปเดตทรัพยากร Dependency
- ตอนนี้ Navigation Compose จะขึ้นอยู่กับ Activity Compose 1.3.1 (I05829)
- ตอนนี้ Navigation Compose จะขึ้นอยู่กับ Lifecycle ViewModel Compose
2.4.0-beta01(Ib86a3)
เวอร์ชัน 2.4.0-alpha08
1 กันยายน 2021
androidx.navigation:navigation-*:2.4.0-alpha08 เผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha08 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้คุณสามารถขยายคลาส
NavTypeเพื่อสร้าง NavType ที่กำหนดเองได้แล้ว ระบบรองรับประเภทที่กำหนดเองเฉพาะเมื่อสร้างกราฟการนำทางแบบเป็นโปรแกรม เช่น ผ่าน Navigation Graph Kotlin DSL (I78440, b/196871885)
การเปลี่ยนแปลงพฤติกรรม
- เมื่อสร้างการดำเนินการ ตอนนี้โค้ด Kotlin ที่สร้างจาก Safe Args จะใส่อาร์กิวเมนต์ที่ไม่มีค่าเริ่มต้นไว้ก่อนอาร์กิวเมนต์ที่มีค่าเริ่มต้นเป็นพารามิเตอร์ (Idb697, b/188855904)
- ตอนนี้ Deep Link จะยืนยันว่าอาร์กิวเมนต์ที่จำเป็นทั้งหมด (อาร์กิวเมนต์ที่ไม่มีค่าเริ่มต้น) อยู่ใน
Uri(#204, b/185527157)
แก้ไขข้อบกพร่อง
- การใช้
getBackStackEntryและpreviousBackStackEntryภายใน composable() ร่วมกับremember()จะไม่ทำให้เกิดข้อยกเว้นสำหรับกรณีที่ไม่มีปลายทางใน Back Stack อีกต่อไป (I75138, b/194313238) - ตอนนี้ Navigation Compose จะจัดองค์ประกอบใหม่ได้อย่างถูกต้องเมื่อเปลี่ยนอาร์กิวเมนต์ Back Stack และใช้
launchSingleTop=true(Iebd69, b/186392337) - จะไม่มี
ArrayIndexOutOfBoundsExceptionอีกต่อไปเมื่อเรียกใช้setGraphด้วยกราฟที่มีปลายทาง 13 หรือ 29 แห่ง (I1a9f1, b/195171984) - เครื่องมือสร้าง SafeArgs Java ไม่ควรทำให้เกิดคำเตือน Lint อีกต่อไปเมื่อสร้างคลาส Args (I1a666, b/185843837)
การมีส่วนร่วมจากภายนอก
- ขอขอบคุณ ospixd ที่ช่วยตรวจสอบว่า Deep Link ยืนยันว่าอาร์กิวเมนต์ที่จำเป็นทั้งหมด (อาร์กิวเมนต์ที่ไม่มีค่าเริ่มต้น) มีอยู่ใน
Uri(#204, b/185527157)
เวอร์ชัน 2.4.0-alpha07
18 สิงหาคม 2021
androidx.navigation:navigation-*:2.4.0-alpha07 เผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha07 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้ Navigation Compose จะบันทึกสถานะอย่างถูกต้องหลังจากเปลี่ยนแปลงการกำหนดค่าและเมื่อเปลี่ยนกราฟขณะใช้ฟีเจอร์ Back Stack หลายรายการ (If5a3d, b/195141957)
- การเลือกแท็บเดิมอีกครั้งเมื่อใช้การเขียนการนำทางที่มี Back Stack หลายรายการจะไม่ทำให้เกิดหน้าจอว่างเปล่าอีกต่อไป (I860dc, b/194925622)
- ตอนนี้
NavHostจะสังเกตการเปลี่ยนแปลงในLifecycle.StateของNavBackStackEntryซึ่งหมายความว่าการใช้NavHostใน Fragment จะได้รับการจัดองค์ประกอบใหม่ตามการเปลี่ยนแปลงวงจรอย่างเหมาะสม แทนที่จะส่งผลให้หน้าจอว่างเปล่า (I4eb85, b/195864489) - แก้ไขปัญหาที่การปิด
DialogFragmentไม่อัปเดตสถานะNavControllerอย่างถูกต้องหลังจากสร้างกิจกรรมอีกครั้ง (เช่น หลังจากเปลี่ยนการกำหนดค่า) (Icd72b) - แก้ไขปัญหาที่การแสดงปลายทางของกล่องโต้ตอบไม่อัปเดตการจัดการปุ่มย้อนกลับของระบบของ NavController ซึ่งอาจทำให้ NavController สกัดกั้นปุ่มย้อนกลับแม้ว่าจะไม่มี Back Stack ให้แสดงก็ตาม (If3b34)
- ตอนนี้ Safe-args จะสร้างเมธอด
toSavedStateHandleโดยอัตโนมัติสำหรับอาร์กิวเมนต์ที่ใช้ทดสอบโค้ดViewModelได้ (If1e2d, b/193353880)
เวอร์ชัน 2.4.0-alpha06
4 สิงหาคม 2021
androidx.navigation:navigation-*:2.4.0-alpha06 เผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha06 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เมธอด
requireSlidingPaneLayout()และrequireDetailPaneNavHostFragment()ในAbstractListDetailFragmentได้เปลี่ยนชื่อเป็นgetSlidingPaneLayout()และgetDetailPaneNavHostFragment()ตามลำดับ (I34a08)
การเปลี่ยนแปลงพฤติกรรม
- เมื่อไปยังส่วนต่างๆ ด้วยภาพเคลื่อนไหว (เช่น
Crossfade)Lifecycleของปลายทางใหม่จะเข้าถึงRESUMEDได้ก็ต่อเมื่อภาพเคลื่อนไหวเสร็จสมบูรณ์เท่านั้น (If0543, b/172112072, b/194301889) - ตอนนี้
NavHostของ Navigation Compose จะตั้งค่ากราฟเป็นส่วนหนึ่งของ Composition แรก (Ieb7be)
แก้ไขข้อบกพร่อง
- การแสดงปลายทางสุดท้ายของกราฟการนำทางจะไม่แสดง
ClassCastExceptionอีกต่อไป (If0543, b/172112072, b/194301889) - แก้ไข
NullPointerExceptionที่จะเกิดขึ้นเมื่อเพิ่ม Deep Link โดยไม่มีUriและไปยังส่วนต่างๆ ผ่านเส้นทางหรือ Deep Link (938a0c, b/193805425) - แก้ไขปัญหาใน Navigation Compose ที่
NavBackStackEntryที่ทำ Deep Link ไม่ถึงสถานะRESUMED(I192c5) - แก้ไขปัญหาที่การแสดงปลายทางของกล่องโต้ตอบไม่อัปเดตการจัดการปุ่มย้อนกลับของระบบของ NavController ซึ่งอาจทำให้ NavController สกัดกั้นปุ่มย้อนกลับแม้ว่าจะไม่มี Back Stack ให้แสดงก็ตาม (aosp/1782668)
เวอร์ชัน 2.4.0-alpha05
21 กรกฎาคม 2021
androidx.navigation:navigation-*:2.4.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha05 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้
NavHostของ Navigation Compose จะใช้การครอสเฟดเสมอเมื่อไปยังปลายทางต่างๆ (I07049, b/172112072) - ตอนนี้คุณสามารถทำการเปลี่ยนแปลงกราฟของ NavHost ได้แล้ว กราฟที่มี startDestination และปลายทางเดียวกันในกราฟจะถือว่าเท่ากันและจะไม่ล้าง Back Stack ของ
NavController(I0b8db, b/175392262)
แก้ไขข้อบกพร่อง
- แก้ไข
NoSuchElementExceptionเมื่อเรียกใช้popBackStack()จากภายในLifecycleObserverที่แนบกับNavBackStackEntryซึ่งเกิดจากการอัปเดตสถานะของ NavController ซ้ำ (I64621) - ตอนนี้
AbstractListDetailFragmentอนุญาตให้ตัดSlidingPaneLayoutออกจาก APK โดยสมบูรณ์เมื่อไม่ได้ใช้AbstractListDetailFragment(I611ad) - ตอนนี้
NavGraphและNavDestinationจะลบล้างเมธอด equals เพื่อให้ระบบถือว่าออบเจ็กต์ 2 รายการที่มีค่าเหมือนกันเท่ากัน (I166eb, b/175392262)
เวอร์ชัน 2.4.0-alpha04
1 กรกฎาคม 2021
androidx.navigation:navigation-*:2.4.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha04 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้อาร์ติแฟกต์
navigation-fragmentมีการติดตั้งใช้งานเลย์เอาต์ 2 แผงที่สร้างไว้ล่วงหน้าผ่านAbstractListDetailFragmentใหม่ Fragment นี้ใช้SlidingPaneLayoutเพื่อจัดการแผงรายการ (ซึ่งคลาสย่อยของคุณมีให้) และแผงรายละเอียด ซึ่งใช้NavHostFragmentเป็นการติดตั้งใช้งาน ดังที่เห็นในตัวอย่างการติดตั้งใช้งาน (Iac4be, b/191276636) - ตอนนี้
NavHostของอาร์ติแฟกต์navigation-composeรองรับปลายทางdialogนอกเหนือจากปลายทางcomposableแล้ว ปลายทางของกล่องโต้ตอบเหล่านี้จะแสดงภายใน ComposableDialogซึ่งลอยอยู่เหนือปลายทางcomposableปัจจุบัน (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
- เปลี่ยนชื่อฟังก์ชัน
addในNavigatorStateเป็นpushแล้ว การเรียกadd()ทั้งหมดในปัจจุบันจะต้องเปลี่ยนเป็น push() (Ie89fc, b/172112072) - ตอนนี้อินสแตนซ์
Navigatorที่กำหนดเองสามารถใช้ APIpushWithTransactionและpopWithTransitionในNavigatorStateเพื่อพุชหรือป๊อปปลายทางแบบไม่พร้อมกันได้แล้ว โปรดทราบว่า API นี้ยังไม่ได้ใช้โดยเนวิเกเตอร์ที่รวมอยู่ (Ic4d7c, b/172112072)
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้
NavDeepLinkBuilderจะเพิ่มPendingIntent.FLAG_IMMUTABLEลงในPendingIntentที่แสดงผลโดยcreatePendingIntent()เพื่อให้มั่นใจว่า API นี้จะทำงานตามที่คาดไว้เมื่อกำหนดเป้าหมายเป็น Android 12 (If8c52)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาเกี่ยวกับ
<include-dynamic>ที่อาร์กิวเมนต์ที่ส่งไปยังกราฟจะไม่ส่งไปยังกราฟที่รวมแบบไดนามิกอย่างถูกต้อง (I3e115) - แก้ไข
NullPointerExceptionเมื่อไปยังปลายทางโดยใช้อาร์กิวเมนต์string[]ที่มีค่าเริ่มต้นเป็น@null(I1fbe8) - เพิ่มกฎ ProGuard สำหรับ
@Navigator.Nameเพื่อแก้ไขปัญหาเมื่อใช้โหมดเต็มรูปแบบของ R8 3.1 (I2add9, b/191654433) - SafeArgs จะไม่ทำงานล้มเหลวอีกต่อไปเมื่อสร้างแอปด้วย
Kotlinเวอร์ชันก่อน1.5.0(Icd1ff, b/190739257)
เวอร์ชัน 2.4.0-alpha03
16 มิถุนายน 2021
androidx.navigation:navigation-*:2.4.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha03 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ต้องใช้การเรียก
navigate()2 ครั้งเพื่อไปยังกราฟแบบไดนามิกที่รวมอยู่ (I7785c, b/188859835) - แก้ไขการถดถอยที่เกิดขึ้นในการนำทาง
2.4.0-alpha01โดยที่setupActionBarWithNavController()จะไม่นำไอคอนขึ้นออกอย่างถูกต้องเมื่อคุณอยู่ที่ปลายทางระดับบนสุด (I5d443, b/189868637) - แก้ไข
IllegalStateExceptionเมื่อเรียกใช้popBackStack()หลังจากที่ก่อนหน้านี้แสดงกราฟรูทของ NavController (I2a330, b/190265699) - ตอนนี้กฎ ProGuard สำหรับ
by navArgs()จะมีผลอย่างถูกต้องเมื่อใช้navigation-commonหรืออาร์ติแฟกต์ใดๆ ที่ขึ้นอยู่กับกฎดังกล่าว (I68800, b/190082521) - ตอนนี้
OnDestinationChangedListenerที่เรียกใช้navigate()ในครั้งแรกที่ได้รับการเรียกกลับจะได้รับการเรียกกลับครั้งที่ 2 อย่างถูกต้องพร้อมกับปลายทางที่ไปยังส่วนต่างๆ (Ie5f9e, b/190228815) - Safe Args จะไม่ขัดข้องอีกต่อไปเมื่อใช้กับโมดูลฟีเจอร์แบบไดนามิกและ AGP 7.0 ขึ้นไป (I69518, b/189966576)
ปัญหาที่ทราบ
- Safe Args จะดำเนินการไม่สำเร็จและมีข้อผิดพลาด
Unable to find method ‘’java.lang.String kotlin.text.CarsKt.titleCase(char, java.util.Locale)’’เมื่อใช้ Gradle6.7.0เนื่องจากขึ้นอยู่กับ Kotlin เวอร์ชันเก่า ซึ่งแก้ไขได้โดยอัปเดตไปใช้ Gradle 7.0 (b/190739257)
เวอร์ชัน 2.4.0-alpha02
2 มิถุนายน 2021
androidx.navigation:navigation-*:2.4.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha02 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้ระบบรองรับเส้นทางสำหรับปลายทาง Activity, Fragment และ Dialog รวมถึง DynamicNavigation Kotlin DSL ทั้งหมดแล้ว (Ib5544, Ia617b, I22f96, b/188914648, b/188901565)
NavigationUIได้เพิ่ม API เวอร์ชันทดลองเป็นการชั่วคราวเพื่อให้เลือกไม่บันทึกสถานะได้ แม้ว่าการบันทึกสถานะจะเป็นลักษณะการทำงานที่ถูกต้องเสมอ แต่ก็ยังมีการใช้ไลบรารีที่เลิกใช้งานแล้ว (เช่น ส่วนย่อยที่เก็บไว้) ซึ่งไม่สามารถรองรับได้เมื่อบันทึกสถานะ ดังนั้นจึงเปิดโอกาสให้แอปค่อยๆ เปลี่ยนไปใช้ API ที่ไม่รองรับ (Idf93c)ตอนนี้ Navigation มี API
findDestination()และgetHierarchy()ที่ใช้เพื่อช่วยติดตั้งใช้งาน NavigationUI ที่กำหนดเองได้findDestination()เป็นฟังก์ชันส่วนขยายในNavGraphที่จะค้นหาปลายทางภายในกราฟgetHierarchy()เป็นฟังก์ชันในNavDestinationที่ใช้ตรวจสอบได้ว่าปลายทางที่ระบุอยู่ในลำดับชั้นของปลายทางอื่นหรือไม่ (I2932f, b/188183365)val matchingRoute: Boolean = destination.hierarchy.any { it.route == routeToFind }เมธอด NavigationUI ที่ใช้
BottomNavigationViewได้รับการอัปเดตให้ใช้คลาสใหญ่สุดที่เปิดตัวใน Material1.4.0,NavigationBarViewแทน ซึ่งจะช่วยให้ใช้วิธีการเหล่านี้กับNavigationRailViewได้ (Ib0b36, b/182938895)เมื่อขยายองค์ประกอบ
<action>ผ่าน XML แอตทริบิวต์ภาพเคลื่อนไหวจะใช้แอตทริบิวต์ที่ดึงมาจากธีมได้โดยใช้ไวยากรณ์app:enterAnim="?attr/transitionEnter"(I07bc1, b/178291654)
การเปลี่ยนแปลง API
- เลิกใช้งาน Kotlin DSL Builder ที่ใช้รหัสแล้ว และควรแทนที่ด้วย Builder ที่ใช้เส้นทาง (I85b42, b/188816479) (I9f58f, b/188816479)
แก้ไขข้อบกพร่อง
- ตอนนี้
DialogFragmentNavigatorใช้ APINavigatorState.pop()เพื่อแจ้งNavControllerเมื่อกล่องโต้ตอบถูกปิดโดยการกดปุ่มย้อนกลับของระบบหรือคลิกนอกกล่องโต้ตอบ เพื่อให้แน่ใจว่าสถานะNavControllerจะซิงค์กับสถานะของ Navigator เสมอ (I2ead9) การนำทางจะไม่แสดง
ConcurrentModificationExceptionอีกต่อไปเมื่อใช้การจัดการรายการOnDestinationChangedListenersจากการเรียกกลับonDestinationChanged(Ib1707, b/188860458)Safe Args ไม่ขัดข้องอีกต่อไปเมื่อพยายามสร้างพร็อพเพอร์ตี้ทิศทางใน Kotlin (Id2416, b/188564435)
ตอนนี้เมธอด setId ใน NavDestination มีคำอธิบายประกอบที่ถูกต้องด้วย
@IdResจึงยอมรับเฉพาะรหัสทรัพยากรเท่านั้น (I69b80)ตอนนี้พารามิเตอร์ int ของ
findNodeคือresIdแทนที่จะเป็นresid(I7711d)
การอัปเดตทรัพยากร Dependency
- ตอนนี้ Safe-Args ขึ้นอยู่กับปลั๊กอิน Android Gradle 4.2.0 ซึ่งหมายความว่าคุณจะไม่ได้รับคำเตือนว่ากำลังใช้
applicationIdTextResourceอีกต่อไป (I6d67b, b/172824579)
เวอร์ชัน 2.4.0-alpha01
18 พฤษภาคม 2021
androidx.navigation:navigation-*:2.4.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เมธอด
currentBackStackEntryAsFlow()ในNavControllerจะให้Flowที่ส่งออกเมื่อใดก็ตามที่NavBackStackEntryปัจจุบันมีการเปลี่ยนแปลง คุณสามารถใช้ขั้นตอนนี้เป็นทางเลือกแทนการจัดการOnDestinationChangedListenerด้วยตนเอง (I19c4a, #89, b/163947280)
Back Stack หลายรายการ
NavController มีหน้าที่จัดการ Back Stack ของปลายทาง โดยเพิ่มปลายทางลงใน Back Stack เมื่อคุณnavigate()ไปยังปลายทางเหล่านั้น และนำออกเมื่อคุณเรียกใช้ popBackStack() หรือเรียกให้ปุ่มย้อนกลับของระบบทำงาน คลาส NavOptions ที่มีอยู่และการผสานรวมเข้ากับรายการ <action> ใน XML ของกราฟการนําทางได้รับการขยายเพื่อรองรับการบันทึกและการกู้คืน Back Stack (b/80029773)
การเปลี่ยนแปลงนี้จะทำให้เมธอด NavigationUI ของ onNavDestinationSelected(), BottomNavigationView.setupWithNavController() และ NavigationView.setupWithNavController() บันทึกและกู้คืนสถานะของปลายทางที่แสดงขึ้นโดยอัตโนมัติ ซึ่งจะช่วยรองรับ Back Stack หลายรายการโดยไม่ต้องเปลี่ยนแปลงโค้ด เมื่อใช้การนําทางกับ Fragment วิธีนี้เป็นวิธีที่แนะนําในการผสานรวมกับ Back Stack หลายรายการ (Ie07ca)
API พื้นฐานสำหรับการบันทึกและกู้คืนสถานะจะแสดงผ่านแพลตฟอร์มต่างๆ ดังนี้
ใน Navigation XML ตอนนี้องค์ประกอบ
<action>สามารถใช้แอตทริบิวต์บูลีนของapp:popUpToSaveStateและapp:restoreStateเพื่อบันทึกสถานะของปลายทางที่แสดงผ่านapp:popUpToและกู้คืนสถานะที่เชื่อมโยงกับปลายทางที่ส่งเป็นapp:destinationได้แล้ว<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 คุณสามารถเพิ่มพร็อพเพอร์ตี้บูลีนrestoreStateและพร็อพเพอร์ตี้บูลีนsaveStateในpopUpTobuilder ได้ดังนี้// Use the navigate() method that takes a navOptions DSL Builder navController.navigate(selectedBottomNavRoute) { launchSingleTop = true restoreState = true popUpTo(navController.graph.startDestinationId) { saveState = true } }ในการสร้างออบเจ็กต์
NavOptionsด้วยตนเองผ่านNavOptions.Builderคุณสามารถใช้setRestoreState()และโอเวอร์โหลดใหม่เพื่อsetPopUpTo()ซึ่งใช้พารามิเตอร์saveStateเพิ่มเติมNavOptions navOptions = new NavOptions.Builder() .setLaunchSingleTop(true) .setRestoreState(true) .setPopUpTo(navController.getGraph().getStartDestinationId(), false, // inclusive true) // saveState .build(); navController.navigate(selectedBottomNavId, null, navOptions);ตอนนี้การเรียกใช้
popBackStack()แบบเป็นโปรแกรมสามารถรวมพารามิเตอร์saveStateเพิ่มเติมได้แล้ว
ในทุกกรณี NavController จะบันทึกและกู้คืนสถานะของ NavBackStackEntry แต่ละรายการ รวมถึงอินสแตนซ์ ViewModel ที่กำหนดขอบเขตปลายทางการนำทาง API ของ Navigator ได้รับการอัปเดตเพื่อให้ Navigator แต่ละรายการรองรับการบันทึกและกู้คืนสถานะของตนเอง
ComposeNavigator ที่ใช้สำหรับปลายทาง composable ใน Navigation Compose และ FragmentNavigator และ DynamicFragmentNavigator ที่ใช้สำหรับปลายทาง <fragment> ใน Navigation with Fragments ได้รับการอัปเดตให้ใช้ Navigator API ใหม่และรองรับการบันทึกและกู้คืนสถานะ
เส้นทางการนำทาง
เส้นทางคือ String ที่ระบุปลายทางโดยไม่ซ้ำกัน แม้ว่าก่อนหน้านี้จะใช้เฉพาะใน Navigation Compose แต่ตอนนี้แนวคิดนี้ได้กลายเป็นส่วนหนึ่งของ Navigation API หลักแล้ว ซึ่งเป็นทางเลือกแทนการใช้รหัสจำนวนเต็มเมื่อสร้างกราฟผ่าน Navigation Kotlin DSL (b/172823546)
ตอนนี้ API ทั้งหมดที่เคยใช้เฉพาะรหัสจะมีโอเวอร์โหลดที่ใช้เส้นทาง String ซึ่งรวมถึง navigate(), popBackStack(), popUpTo() และ getBackStackEntry()
ซึ่งส่งผลต่อ API ดังนี้
- เลิกใช้งานพร็อพเพอร์ตี้
popUpTokotlin ใน Kotlin DSL แล้วเพื่อใช้popUpToIdแทน (I59c73, b/172823546) - เราได้เลิกใช้งาน
getStartDestination()API แล้วเพื่อเปลี่ยนไปใช้getStartDestinationId()(I0887f, b/172823546)
สำหรับนักพัฒนาแอปที่อัปเกรดจาก Navigation Compose เวอร์ชันก่อนหน้าเป็น Navigation Compose 2.4.0-alpha01 หมายความว่าไม่จำเป็นต้องนำเข้าเมธอดส่วนขยายต่อไปนี้อีกต่อไปและควรนำออก
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 ถูกแทนที่ด้วยพร็อพเพอร์ตี้ route ใน NavDestination ซึ่งช่วยให้คุณเรียกใช้ navBackStackEntry.destination.route ได้โดยตรง
การเปลี่ยนแปลง API
- อาร์ติแฟกต์การนําทางทั้งหมดได้รับการเขียนใหม่ใน Kotlin ซึ่งช่วยปรับปรุงความสามารถในการเป็นค่า Null ของคลาสที่ใช้ Generics (เช่น คลาสย่อย
NavType) ฟังก์ชันส่วนขยาย Kotlin ทั้งหมดที่เคยเป็นส่วนหนึ่งของอาร์ติแฟกต์-ktxได้ย้ายไปยังอาร์ติแฟกต์หลักที่เกี่ยวข้องแล้ว ระบบจะยังคงเผยแพร่อาร์ติแฟกต์-ktxต่อไป แต่จะไม่มีข้อมูลใดๆ เลย (b/184292145) - ตอนนี้
NavDeepLinkBuilderรองรับการเพิ่มปลายทางที่แตกต่างกันหลายรายการลงใน Back Stack ที่สร้างขึ้น (I3ee0d, b/147913689) - เพิ่มฟังก์ชันโรงงานสำหรับ
DynamicNavHostFragment(Icd515, b/175222619) - ตอนนี้รหัสที่ไม่ซ้ำกันของ
NavBackStackEntryจะแสดงเป็นส่วนหนึ่งของ API สาธารณะ (Ie033a) - ตอนนี้ช่อง
nameและargumentรวมถึงฟังก์ชันการแยกโครงสร้างของNamedNavArgumentเป็นแบบสาธารณะแล้ว (#174, b/181320559) - เปิดตัวส่วนขยาย
NavBackStackEntry#provideToCompositionLocalsใหม่ที่ให้NavBackStackEntryแก่ Composition Local ที่เกี่ยวข้อง (#175, b/187229439)
Safe Args
ตอนนี้ Safe Args จะสร้างเมธอด
fromSavedStateHandle()สำหรับคลาสNavArgsแต่ละคลาส (#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(#172, b/183990444)
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้การนำทางจะขึ้นอยู่กับ
Lifecycle
2.3.1และตอนนี้จะทำเครื่องหมายsetGraph(),popBackStack(),navigateUp()และnavigate()ซึ่งเป็น เมธอดที่อัปเดตNavBackStackEntryLifecycleเป็น@MainThreadเพื่อปรับการนำทางให้สอดคล้องกับการบังคับใช้ เทรดหลักที่เปิดตัวใน Lifecycle2.3.0(b/171125856) - ตอนนี้การแยกวิเคราะห์อาร์กิวเมนต์ Enum จาก Deep Link จะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ ซึ่งช่วยให้ Deep Link เช่น
http://www.example.com/redตรงกับ Deep Linkwww.example.com/{color}แม้ว่า Enum จะมีค่าเป็นREDก็ตาม (#152, b/135857840)
ความเข้ากันได้ของ Compose
androidx.navigation:navigation-compose:2.4.0-alpha01ใช้ได้กับ Compose เวอร์ชัน1.0.0-beta07ขึ้นไปเท่านั้น
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ตัวยึดตำแหน่งอาร์กิวเมนต์ต่อท้ายมีความสำคัญเหนือกว่า Deep Link ที่มีคำต่อท้ายที่ตรงกันทุกประการ (#153, b/184072811)
- ตอนนี้
NavHostFragmentรองรับ Navigator ที่กำหนดเองซึ่งใช้@Navigator.Name("dialog")เดียวกับDialogFragmentNavigatorเริ่มต้นแล้ว (Ib1c2c, b/175979140) - ปรับปรุงลักษณะการทำงานของ
NavigatorProvider#addNavigatorเพื่อให้มั่นใจว่าการเรียกใช้ซ้ำๆ ด้วยอินสแตนซ์เดียวกันจะไม่ทำให้เกิดปัญหา (#176, b/187443146)
การมีส่วนร่วมจากภายนอก
- ขอขอบคุณ simonschiller ที่สร้างการรองรับ Safe Args ซึ่งสร้างเมธอด
fromSavedStateHandle()สำหรับคลาสNavArgsแต่ละคลาส (#122, b/136967621) - ขอขอบคุณ Bradleycorn ที่ทำให้การแยกวิเคราะห์อาร์กิวเมนต์ Enum จาก Deep Link ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ (#152, b/135857840)
- ขอขอบคุณ osipxd ที่แก้ไขปัญหาที่ตัวยึดตำแหน่งอาร์กิวเมนต์ต่อท้ายมีความสำคัญเหนือกว่า Deep Link ที่มีคำต่อท้ายตรงกันทุกประการ (#153, b/184072811)
- ขอขอบคุณ tatocaster ที่อัปเดต Safe Args ให้ขึ้นอยู่กับ KotlinPoet
1.8.0(#172, b/183990444) - ขอขอบคุณ jossiwolf ที่ทำให้ช่อง
nameและargumentรวมถึงฟังก์ชันการแยกโครงสร้างของNamedNavArgumentเป็นแบบสาธารณะ (#174, b/181320559) - ขอขอบคุณ jossiwolf ที่แนะนำส่วนขยาย
NavBackStackEntry#provideToCompositionLocalsใหม่ซึ่งให้NavBackStackEntryแก่ Composition Local ที่เกี่ยวข้อง (#175, b/187229439) - ขอขอบคุณ jossiwolf ที่ปรับปรุงลักษณะการทำงานของ
NavigatorProvider#addNavigatorเพื่อให้มั่นใจว่าการเรียกใช้ซ้ำๆ ด้วยอินสแตนซ์เดียวกันจะไม่ทำให้เกิดปัญหา (#176, b/187443146)
Navigation Compose เวอร์ชัน 1.0.0
เวอร์ชัน 1.0.0-alpha10
7 เมษายน 2021
androidx.navigation:navigation-compose:1.0.0-alpha10 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha10 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้
NavHostยอมรับModifierซึ่งส่งต่อไปยังคอนเทนเนอร์ Composable ที่รวม Composable ปลายทาง (I85aca, b/175125483)
แก้ไขข้อบกพร่อง
NavHostจะทำงานได้แม้ว่าจะไม่พบOnBackPressedDispatcherOwnerเช่นในกรณีที่แสดงตัวอย่างNavHost(I7d8b4)- ตอนนี้ Navigation Compose จะขึ้นอยู่กับ Navigation
2.3.5ซึ่งจะแก้ไขปัญหาเมื่อใช้BackHandlerภายในปลายทางNavHost(I7e63b, b/182284739)
เวอร์ชัน 1.0.0-alpha09
10 มีนาคม 2021
androidx.navigation:navigation-compose:1.0.0-alpha09 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha09 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้
LocalViewModelStoreOwner.currentจะแสดงผลViewModelStoreOwnerที่เป็นค่า Null ได้เพื่อระบุได้ดียิ่งขึ้นว่าViewModelStoreOwnerพร้อมใช้งานใน Composition ปัจจุบันหรือไม่ API ที่ต้องใช้ViewModelStoreOwnerเช่นviewModel()และNavHostจะยังคงแสดงข้อยกเว้นหากไม่ได้ตั้งค่าViewModelStoreOwner(Idf39a)
แก้ไขข้อบกพร่อง
- ตอนนี้ Navigation Compose ขึ้นอยู่กับ Navigation 2.3.4 ซึ่งรวมถึงการแก้ไขสำหรับการพยายามตั้งค่าออบเจ็กต์ ViewModelStore เดียวกันหลังจากตั้งค่ากราฟแล้ว (I65c24, b/177825470)
เวอร์ชัน 1.0.0-alpha08
24 กุมภาพันธ์ 2021
androidx.navigation:navigation-compose:1.0.0-alpha08 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha08 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้
NavHostจะป้อนข้อมูลLocalSavedStateRegistryOwnerCompositionLocal ด้วยNavBackStackEntryของปลายทางนั้น เพื่อให้มั่นใจว่าสถานะใดๆ ที่บันทึกไว้ในSavedStateRegistryโดยตรงจะได้รับการบันทึกและกู้คืนพร้อมกับปลายทาง (I435d7, b/179469431)
เวอร์ชัน 1.0.0-alpha07
10 กุมภาพันธ์ 2021
androidx.navigation:navigation-compose:1.0.0-alpha07 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha07 มีคอมมิตเหล่านี้
การอัปเดตทรัพยากร Dependency
- ตอนนี้ Navigation Compose จะขึ้นอยู่กับ Lifecycle ViewModel Compose 1.0.0-alpha01 เพื่อให้การรองรับ
viewModel()สำหรับปลายทางcomposable(I7a374) - ตอนนี้
NavHostใช้LocalOnBackPressedDispatcherOwnerใหม่จาก Activity-Compose 1.3.0-alpha01 เพื่อรับOnBackPressedDispatcherที่ตั้งค่าไว้ในNavController(I65b12)
เวอร์ชัน 1.0.0-alpha06
28 มกราคม 2021
androidx.navigation:navigation-compose:1.0.0-alpha06 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha06 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เพิ่มเมธอดส่วนขยาย
getBackStackEntry(route: String)ในNavControllerที่แสดงผลNavBackStackEntryที่เชื่อมโยง (If8931)
เวอร์ชัน 1.0.0-alpha05
13 มกราคม 2021
androidx.navigation:navigation-compose:1.0.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha05 มีคอมมิตเหล่านี้
อัปเดตให้ขึ้นอยู่กับ Compose 1.0.0-alpha10
เวอร์ชัน 1.0.0-alpha04
16 ธันวาคม 2020
androidx.navigation:navigation-compose:1.0.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha04 มีคอมมิตเหล่านี้
- อัปเดตเพื่อความเข้ากันได้กับ Compose
1.0.0-alpha09
เวอร์ชัน 1.0.0-alpha03
2 ธันวาคม 2020
androidx.navigation:navigation-compose:1.0.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha03 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่
popBackStack()และnavigateUp()ไม่ทำงานหลังจากการเปลี่ยนแปลงการกำหนดค่าหรือการสิ้นสุดการประมวลผลและการสร้างใหม่ (Icea47, b/173281473) - การไปยังกราฟที่ฝังอยู่ภายใน NavHost ทำงานได้อย่างถูกต้องแล้ว (I0948d, b/173647694)
เวอร์ชัน 1.0.0-alpha02
11 พฤศจิกายน 2020
androidx.navigation:navigation-compose:1.0.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha02 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้ Navigation Compose รองรับ NavOptions สำหรับการใช้การดำเนินการ popUpTo และ launchSingleTop (If96c3, b/171468994)
- เพิ่มฟังก์ชันการนําทางที่ใช้เส้นทางแทนรหัสซึ่งช่วยให้คุณสร้างกราฟที่ฝังใน DSL ของ Navigation Compose ได้ (I1661d)
- ตอนนี้ startDestination จะอยู่ก่อนเส้นทางในรายการพารามิเตอร์สำหรับ NavHost (Ie620e)
- ตอนนี้คุณสามารถสร้างกราฟโดยใช้เส้นทางเป็นจุดหมายเริ่มต้นนอก NavHost Composable ได้แล้ว (Iceb75)
เวอร์ชัน 1.0.0-alpha01
28 ตุลาคม 2020
android.navigation:navigation-compose:1.0.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
อาร์ติแฟกต์ navigation-compose ช่วยผสานรวมคอมโพเนนต์การนำทางกับ Jetpack Compose โดยใช้ฟังก์ชัน @Composable เป็นปลายทางในแอปพลิเคชัน
โดยเวอร์ชันแรกนี้จะประกอบด้วยสิ่งต่อไปนี้
NavHostComposable ที่ช่วยให้คุณสร้างกราฟการนำทางผ่าน Kotlin DSL ได้- การกำหนดขอบเขตของวงจร,
ViewModelและสถานะที่จดจำไว้ที่ระดับปลายทาง - การผสานรวมอัตโนมัติกับปุ่มย้อนกลับของระบบ
- รองรับการส่งอาร์กิวเมนต์ การแนบ Deep Link ไปยังปลายทาง และการแสดงผลลัพธ์ไปยังปลายทางก่อนหน้า
- ตัวช่วยเฉพาะของ Compose ใน
rememberNavController()และcurrentBackStackEntryAsState()เพื่ออนุญาตสถานะการโฮสต์และการเชื่อมต่อNavControllerกับ Composable นอกNavHost(เช่น แถบการนำทางด้านล่าง)
ดูข้อมูลเพิ่มเติมได้ที่คู่มือการนำทางใน Compose
เวอร์ชัน 2.3.5
เวอร์ชัน 2.3.5
7 เมษายน 2021
androidx.navigation:navigation-*:2.3.5 เผยแพร่แล้ว เวอร์ชัน 2.3.5 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เมื่อไปยังส่วนต่างๆ โดยใช้
NavDeepLinkRequestหรือUriตอนนี้คุณสามารถเข้าถึงUri, การดำเนินการ และประเภท MIME ในปลายทางที่ได้โดยรับ Intent จากอาร์กิวเมนต์ผ่านKEY_DEEP_LINK_INTENTซึ่งจะจำลองฟังก์ชันการทำงานที่มีอยู่แล้วสำหรับการทำ Deep Link ภายนอก (I975c3, b/181521877)
แก้ไขข้อบกพร่อง
OnBackPressedCallbacksที่เพิ่มลงใน Dispatcher โดยมีNavBackStackEntryเป็น LifecycleOwner จะสกัดกั้นการย้อนกลับอย่างถูกต้องหลังจากวงจรกิจกรรมเป็นSTOPPEDแล้วตามด้วยSTARTED(Iff94f, b/182284739)- ตอนนี้การแยกวิเคราะห์โดเมน Deep Link จะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ เพื่อให้
www.example.comตรงกับทั้งwww.example.comและwww.Example.comโปรดทราบว่าชื่อพารามิเตอร์การค้นหายังคงคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ (#144, b/153829033) - แก้ไข
NullPointerExceptionที่อาจเกิดขึ้นเมื่อปลายทางมีอาร์กิวเมนต์เริ่มต้นที่ไม่มีค่า Null หลายรายการ และคุณไปยังปลายทางนั้นขณะที่ลบล้างเฉพาะชุดย่อยของอาร์กิวเมนต์เหล่านั้น (aosp/1644827)
การอัปเดตทรัพยากร Dependency
- ตอนนี้ปลั๊กอิน Navigation Safe Args Gradle จะขึ้นอยู่กับปลั๊กอิน Kotlin Gradle 1.4.31 (aosp/1661058, b/181156413)
การมีส่วนร่วมจากภายนอก
- ขอขอบคุณ
bentrengroveสำหรับ Pull Request ที่ทำให้การแยกวิเคราะห์โดเมน Deep Link ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ (#144, b/153829033)
เวอร์ชัน 2.3.4
เวอร์ชัน 2.3.4
10 มีนาคม 2021
androidx.navigation:navigation-*:2.3.4 เผยแพร่แล้ว เวอร์ชัน 2.3.4 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้ระบบจะแยกวิเคราะห์อาร์กิวเมนต์
ReferenceTypeได้อย่างถูกต้องเมื่อส่งเป็นส่วนหนึ่งของ URI ของ Deep Link ซึ่งรองรับทั้งค่าจำนวนเต็มดิบและค่าฐานสิบหกที่ขึ้นต้นด้วย0x(#127, b/179166693) android:defaultValueสำหรับอาร์กิวเมนต์ที่มีapp:argType="float"รองรับค่าเริ่มต้นที่เป็นจำนวนเต็มแล้ว ซึ่งช่วยให้คุณใช้android:defaultValue="0"แทนการกำหนดให้ใช้0.0ได้ (#117, b/173766247)
แก้ไขข้อบกพร่อง
- แก้ไขความคืบหน้าในการติดตั้งที่ค้างอยู่เมื่อใช้การรองรับฟีเจอร์แบบไดนามิกของ Navigation (Ib27a7, b/169636207)
- การเรียกใช้
setViewModelStoreหรือsetLifecycleOwnerด้วยออบเจ็กต์เดียวกันที่ตั้งค่าไว้แล้วจะไม่มีผลใดๆ (Idf491, b/177825470) - ตอนนี้ Safe-Args จะเพิ่มคำอธิบายประกอบการระงับในเมธอดที่เหมาะสมเมื่อใช้ Java (I8fbc5, b/179463137)
การมีส่วนร่วมจากภายนอก
- ขอขอบคุณ
JvmNameสำหรับ Pull Request เพื่อให้แน่ใจว่าตอนนี้ระบบจะแยกวิเคราะห์อาร์กิวเมนต์ReferenceTypeได้อย่างถูกต้องเมื่อส่งเป็นส่วนหนึ่งของ URI ของ Deep Link (#127, b/179166693) - ขอขอบคุณ
tatocasterสำหรับ Pull Request ที่อนุญาตให้defaultValueสำหรับอาร์กิวเมนต์ที่มีapp:argType=”float”รองรับค่าเริ่มต้นที่เป็นจำนวนเต็มแล้ว (#117, b/173766247)
เวอร์ชัน 2.3.3
เวอร์ชัน 2.3.3
27 มกราคม 2021
androidx.navigation:navigation-*:2.3.3 เผยแพร่แล้ว เวอร์ชัน 2.3.3 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แอปจะไม่ขัดข้องอีกต่อไปเมื่อเปิด
NavBackStackEntryก่อนที่Lifecycleจะย้ายไปยังCREATED(Ie3ba3) - แก้ไขการถดถอยที่เกิดจาก b/171364502 ซึ่งการไปยังกิจกรรมที่มีค่าทรัพยากรภาพเคลื่อนไหวเป็น
0ทำให้เกิดResourceNotFoundException(I7aedb, b/176819931)
เวอร์ชัน 2.3.2
เวอร์ชัน 2.3.2
2 ธันวาคม 2020
androidx.navigation:navigation-*:2.3.2 เผยแพร่แล้ว เวอร์ชัน 2.3.2 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อถดถอยใน
NavigationUIซึ่งการใช้ปลายทาง<activity>กับonNavDestinationSelectedจะไปยังกิจกรรมไม่สำเร็จ (I22e34, b/171364502) - แก้ไขปัญหาที่
navigation-dynamic-features-fragmentจะส่งผลให้มีการไปยังปลายทางที่ติดตั้งใหม่หลายครั้ง (aosp/1486056, b/169636207) - แก้ไขปัญหาที่ระบบไม่ส่งอาร์กิวเมนต์เริ่มต้นไปยังอินสแตนซ์
OnDestinationChangedListenerเมื่อใช้launchSingleTop(I2c5cb) - แก้ไขปัญหาที่การไปยังกราฟการนำทางที่ฝังอยู่ไม่สร้างอินสแตนซ์กราฟใหม่ใน Back Stack (Ifc831)
- แก้ไขปัญหาที่การใช้
navigate()กับpopUpToซึ่งนำปลายทางสุดท้ายในกราฟการนำทางออกจะไม่ทำลายและนำกราฟการนำทางออกจาก Back Stack ทันที (I910a3) - ตอนนี้ Navigation SafeArgs ใช้ KotlinPoet เวอร์ชัน 1.7.2 ซึ่งเพิ่มการรองรับโหมด API ที่ชัดเจนของ Kotlin (I918b5)
- ตอนนี้
NavHostFragment.findNavController(Fragment)จะตรวจสอบมุมมองการตกแต่งรูทของ DialogFragment ด้วย นอกเหนือจากการตรวจสอบที่มีอยู่ของลำดับชั้น Fragment และลำดับชั้นการแสดงผลของ Fragment ซึ่งจะช่วยให้คุณทดสอบส่วนย่อยของกล่องโต้ตอบที่ใช้การนำทางด้วยFragmentScenarioและNavigation.setViewNavController()ได้ (I69e0d)
เวอร์ชัน 2.3.1
เวอร์ชัน 2.3.1
14 ตุลาคม 2020
androidx.navigation:navigation-*:2.3.1 เผยแพร่แล้ว เวอร์ชัน 2.3.1 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- มีการเพิ่มทรัพยากร Animator เริ่มต้นลงใน UI การนำทาง และเราขอแนะนำให้ใช้ทรัพยากรเหล่านี้แทนทรัพยากรภาพเคลื่อนไหวเริ่มต้น (b/167430145)
- ตอนนี้ NavOptions จะลบล้างเมธอด hashcode และ equals (b/161586466)
- ตอนนี้การนำทางจะรวมปลายทางปัจจุบันไว้ใน IllegalArgumentException "ไม่มีปลายทางที่มีรหัส" ซึ่งจะช่วยปรับปรุงประสบการณ์การแก้ไขข้อบกพร่องของนักพัฒนาแอป (b/168311416)
แก้ไขข้อบกพร่อง
- Safe Args จะไม่ตัดบรรทัดผลลัพธ์อีกต่อไป แม้ว่าชื่อคลาสอาร์กิวเมนต์ที่สร้างขึ้นจะยาวกว่า 100 อักขระก็ตาม (b/168584987)
การเปลี่ยนแปลงทรัพยากร Dependency
- ตอนนี้
navigation-uiขึ้นอยู่กับ DrawerLayout 1.1.1 ซึ่งช่วยให้NavigationUIเปิดลิ้นชักได้แม้จะใช้LOCK_MODE_LOCKED_CLOSEDหรือLOCK_MODE_LOCKED_OPEN(b/162253907) - ตอนนี้ Safe Args ขึ้นอยู่กับ KotlinPoet 1.6.0 (aosp/1435911)
- ตอนนี้ Safe Args ขึ้นอยู่กับ AGP 4.0.1 (aosp/1442337)
เวอร์ชัน 2.3.0
เวอร์ชัน 2.3.0
24 มิถุนายน 2020
androidx.navigation:navigation-*:2.3.0 เผยแพร่แล้ว เวอร์ชัน 2.3.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.2.0
- การผสานรวมโมดูลฟีเจอร์: อาร์ติแฟกต์
navigation-dynamic-features-runtimeและnavigation-dynamic-features-fragmentช่วยให้คุณไปยังปลายทางที่กำหนดไว้ในโมดูลฟีเจอร์ได้ โดยจะจัดการการติดตั้งโมดูลฟีเจอร์โดยอัตโนมัติตามความจำเป็น ดูข้อมูลเพิ่มเติมได้ที่ไปยังส่วนต่างๆ ด้วยโมดูลฟีเจอร์ - การทดสอบการนำทาง: อาร์ติแฟกต์
navigation-testingมีTestNavHostControllerที่ช่วยให้คุณตั้งค่าปลายทางปัจจุบันและยืนยัน Back Stack หลังจากการดำเนินการนำทางได้ ดูข้อมูลเพิ่มเติมได้ที่ทดสอบการนำทาง - การแสดงผลลัพธ์:
NavBackStackEntryที่เชื่อมโยงกับปลายทางแต่ละแห่งใน Back Stack ของการนำทางช่วยให้คุณเข้าถึงSavedStateHandleที่เหมาะสำหรับการจัดเก็บสถานะที่บันทึกไว้จำนวนเล็กน้อยซึ่งควรเชื่อมโยงกับรายการ Back Stack หนึ่งๆ ได้แล้ว ดูข้อมูลเพิ่มเติมได้ที่การแสดงผลลัพธ์ไปยังปลายทางก่อนหน้า - การรองรับ
OpenableของNavigationUI: การใช้งานDrawerLayoutทั้งหมดในNavigationUIถูกแทนที่ด้วยอินเทอร์เฟซOpenableทั่วไปมากขึ้นซึ่งเพิ่มเข้ามาใน CustomView1.1.0และใช้งานโดยDrawerLayoutใน DrawerLayout1.1.0 - การรองรับการดำเนินการและประเภท MIME ใน Deep Link: เราได้ขยายการทำ Deep Link เพื่อรองรับ
app:actionและapp:mimeTypeนอกเหนือจากapp:uriที่มีอยู่ก่อนหน้านี้ ตอนนี้NavControllerรองรับการไปยังส่วนต่างๆ โดยใช้ช่องเหล่านี้ร่วมกันผ่านคลาสNavDeepLinkRequestใหม่ ดูข้อมูลเพิ่มเติมได้ที่ไปยังส่วนต่างๆ โดยใช้ NavDeepLinkRequest
ปัญหาที่ทราบ
- Manifest Merger ยังไม่รองรับการดำเนินการของ Deep Link และประเภท MIME จนกว่างานดังกล่าวจะเสร็จสมบูรณ์ องค์ประกอบ
<intent-filter>ที่สร้างขึ้นจากองค์ประกอบ<nav-graph>ในไฟล์ Manifest จะไม่รวมประเภท MIME ไว้ในองค์ประกอบ<data>หรือ<action>ที่กำหนดเอง คุณต้องเพิ่ม<intent-filter>ที่เหมาะสมลงในไฟล์ Manifest ด้วยตนเอง
เวอร์ชัน 2.3.0-rc01
10 มิถุนายน 2020
androidx.navigation:navigation-*:2.3.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.3.0-rc01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไข
NullPointerExceptionเมื่อแทนที่อินสแตนซ์ของปลายทางที่ไม่มีอาร์กิวเมนต์ด้วยอินสแตนซ์อื่นที่มีอาร์กิวเมนต์ด้วยsingleTop(b/158006669) - ตอนนี้ข้อยกเว้น
destination is unknownทั้งหมดที่เกิดจากNavControllerมีข้อมูลการแก้ไขข้อบกพร่องเพิ่มเติมเพื่อช่วยระบุสถานะของNavController(b/157764916)
เวอร์ชัน 2.3.0-beta01
20 พฤษภาคม 2020
เผยแพร่ androidx.navigation:navigation-*:2.3.0-beta01 แล้ว เวอร์ชัน 2.3.0-beta01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่
LifecycleของNavBackStackEntryไม่ได้รับการอัปเดตอย่างถูกต้องหลังจากการสิ้นสุดการประมวลผล (b/155218371) - ตอนนี้ระบบจะส่งอินสแตนซ์
OnDestinationChangedListenerที่ลงทะเบียนก่อนเรียกใช้setGraph()ไปยังปลายทางที่กู้คืนอย่างถูกต้องหลังจากการสิ้นสุดการประมวลผล (b/155218371) - เมื่อใช้
singleTopตอนนี้NavBackStackEntryมีอาร์กิวเมนต์ที่อัปเดตอย่างถูกต้อง และระบบจะส่งอาร์กิวเมนต์ที่อัปเดตไปยังอินสแตนซ์OnDestinationChangeListenerทั้งหมด (b/156545508)
การอัปเดตทรัพยากร Dependency
- ตอนนี้อาร์ติแฟกต์
NavigationUIขึ้นอยู่กับ CustomView1.1.0-rc01และ DrawerLayout1.1.0-rc01(aosp/1309696)
เวอร์ชัน 2.3.0-alpha06
29 เมษายน 2020
androidx.navigation:navigation-*:2.3.0-alpha06 เผยแพร่แล้ว (เวอร์ชัน 2.3.0-alpha06 มีคอมมิตเหล่านี้)
ฟีเจอร์ใหม่
- เราได้ขยายการทำ Deep Link เพื่อรองรับ
app:actionและapp:mimeTypeนอกเหนือจากapp:uriที่มีอยู่ก่อนหน้านี้ ตอนนี้ NavController รองรับการนำทางด้วยชุดข้อมูลที่ไม่ซ้ำกันเหล่านี้ที่รวมเข้าด้วยกันผ่านคลาสNavDeepLinkRequestใหม่ (b/136573074, b/135334841)
การเปลี่ยนแปลง API
- ขยายการรองรับ Kotlin DSL สำหรับปลายทางการนำทางแบบไดนามิกอย่างมาก (b/148969800)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ระบบละเว้น Intent ของ Deep Link เมื่อใช้ปลายทางการเริ่มต้นที่ซ้อนกัน (b/154532067)
เวอร์ชัน 2.3.0-alpha05
15 เมษายน 2020
androidx.navigation:navigation-*:2.3.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 2.3.0-alpha05 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- สำหรับการรวมกราฟแบบไดนามิกที่ใช้
<include-dynamic>คุณไม่จำเป็นต้องระบุapp:graphPackageอีกต่อไป และระบบจะใช้กราฟเริ่มต้นโดยเพิ่มส่วนต่อท้ายmoduleNameลงในapplicationIdหลังจุด หากต้องการปรับแต่งgraphPackageตอนนี้ระบบรองรับตัวยึดตำแหน่ง${applicationId}แล้ว (b/152696768) - ตอนนี้ Navigation Graph Kotlin DSL จะแสดง
defaultArgumentsMapสำหรับการดำเนินการ ซึ่งสะท้อนถึงความสามารถในการตั้งค่าเริ่มต้นในองค์ประกอบ<action>ในไฟล์ XML ของการนำทาง (b/150345605)
แก้ไขข้อบกพร่อง
- จาก Navigation 2.2.2: แก้ไข
IllegalStateExceptionเมื่อทำ Deep Link ไปยังปลายทางเริ่มต้นของกราฟเมื่อคุณมีอินสแตนซ์NavHostFragmentหลายรายการในกิจกรรม (b/147378752)
การอัปเดตทรัพยากร Dependency
- ตอนนี้การนำทางจะขึ้นอยู่กับ Fragment
1.2.4(aosp/1277325) - ตอนนี้ Dynamic Navigation จะขึ้นอยู่กับ Play Core
1.7.2(aosp/1282257)
เวอร์ชัน 2.3.0-alpha04
18 มีนาคม 2020
androidx.navigation:navigation-*:2.3.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.3.0-alpha04 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่มการรองรับกิจกรรมโมดูลฟีเจอร์และปลายทาง Fragment ใน Navigation Kotlin DSL (b/148969800)
การเปลี่ยนแปลง API
- คลาส
DynamicExtrasไม่ใช้รูปแบบ Builder อีกต่อไป และตอนนี้สามารถสร้างได้โดยตรง (aosp/1253671) - ตอนนี้
DynamicActivityNavigatorจะใช้Contextในเครื่องมือสร้างแทนActivity(aosp/1250252)
แก้ไขข้อบกพร่อง
NavigationUIจะไม่ละเว้นป้ายกำกับที่ว่างเปล่า (เช่น ปลายทางที่มีandroid:label=””) อีกต่อไป และตอนนี้จะตั้งค่าชื่อเป็นสตริงว่างอย่างถูกต้อง (b/148679860)
การอัปเดตทรัพยากร Dependency
- ตอนนี้อาร์ติแฟกต์ฟีเจอร์แบบไดนามิกของการนำทางจะขึ้นอยู่กับ Play Core
1.6.5(b/149556401)
เวอร์ชัน 2.3.0-alpha03
4 มีนาคม 2020
androidx.navigation:navigation-*:2.3.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.3.0-alpha03 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- แทนที่จะใช้คลาส
DrawerLayoutที่เป็นรูปธรรมAppBarConfigurationจะใช้Openableอินเทอร์เฟซที่เปิดตัวใน CustomView1.1.0-alpha02(ซึ่งDrawerLayoutจะใช้ตั้งแต่ DrawerLayout1.1.0-alpha04) ซึ่งช่วยให้คุณใช้การติดตั้งใช้งานOpenableที่กำหนดเองกับNavigationUIได้ (b/129030452)
แก้ไขข้อบกพร่อง
- ตอนนี้กฎ ProGuard ของ
navigation-common-ktxจะเก็บเฉพาะคลาสNavArgsที่ใช้เท่านั้นอย่างถูกต้อง แทนที่จะเก็บอินสแตนซ์NavArgsทั้งหมด (b/150213558)
การเปลี่ยนแปลงทรัพยากร Dependency
- Navigation ได้เปลี่ยนกลับไปใช้ทรัพยากร Dependency ใน Core
1.2.0และตอนนี้ขึ้นอยู่กับ Core1.1.0เพื่อหลีกเลี่ยงการบังคับให้นักพัฒนาแอปย้ายไปใช้ทรัพยากร Dependency ที่ใหม่กว่าเมื่อ Navigation ไม่ได้ขึ้นอยู่กับ API ใหม่ใน Core1.2.0
เวอร์ชัน 2.3.0-alpha02
19 กุมภาพันธ์ 2020
androidx.navigation:navigation-*:2.3.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.3.0-alpha02 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้
NavBackStackEntryช่วยให้คุณเข้าถึงSavedStateHandleที่เหมาะสำหรับการจัดเก็บสถานะที่บันทึกไว้จำนวนเล็กน้อยซึ่งควรเชื่อมโยงกับรายการ Back Stack หนึ่งๆ ได้ ดูตัวอย่างกรณีการใช้งานได้ที่การแสดงผลลัพธ์ (b/79672220)
การเปลี่ยนแปลง API
- เราได้เพิ่มเมธอดอำนวยความสะดวกของ
getCurrentBackStackEntry()และgetPreviousBackStackEntry()เพื่อให้ดึงข้อมูลNavBackStackEntryสำหรับปลายทางปัจจุบันและก่อนหน้าได้ง่ายขึ้น (b/79672220)
แก้ไขข้อบกพร่อง
- ตอนนี้
navigateUp()จะส่งอาร์กิวเมนต์ของปลายทางปัจจุบันและKEY_DEEP_LINK_INTENTไปยังปลายทางก่อนหน้าเมื่อเปิดแอปในสแต็กงานของคุณเอง (b/147456890)
การเปลี่ยนแปลงทรัพยากร Dependency
- ตอนนี้การนำทางจะขึ้นอยู่กับ Core
1.2.0
เวอร์ชัน 2.3.0-alpha01
5 กุมภาพันธ์ 2020
androidx.navigation:navigation-*:2.3.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.3.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- อาร์ติแฟกต์
navigation-testingใหม่มีคลาสTestNavHostControllerคลาสนี้เป็นทางเลือกแทนการใช้NavControllerจำลองเมื่อทดสอบการนำทาง ซึ่งช่วยให้คุณตั้งค่าปลายทางปัจจุบันและยืนยัน Back Stack หลังจากการดำเนินการนำทางได้ (b/140884273) navigation-dynamic-features-fragmentใหม่ (และการขึ้นต่อกันแบบสกรรมกริยาnavigation-dynamic-features-runtime) ช่วยให้คุณรวมปลายทางที่รวมหรือกราฟการนำทางทั้งหมด (ผ่าน<include-dynamic>) จากโมดูลฟีเจอร์ได้ ซึ่งจะช่วยให้ติดตั้งโมดูลฟีเจอร์แบบออนดีมานด์ได้อย่างราบรื่นเมื่อไปยังปลายทางเหล่านั้น ดูข้อมูลเพิ่มเติมได้ที่ไปยังส่วนต่างๆ ด้วยโมดูลฟีเจอร์ (b/132170186)
แก้ไขข้อบกพร่อง
- จากการนำทาง
2.2.1: ตอนนี้ Deep Link ที่ไม่มีพารามิเตอร์การค้นหาจะละเว้นพารามิเตอร์การค้นหาอย่างถูกต้อง แทนที่จะเพิ่มต่อท้ายองค์ประกอบ{argument}หรือไม่ตรงกับ Deep Link (b/147447512) - จาก Navigation
2.2.1: กฎ ProGuardnavigation-uiข้อสำหรับDrawerArrowDrawableได้รับการอัปเดตเพื่อให้แน่ใจว่าไม่จำเป็นต้องใช้android.enableJetifier=true(b/147610424) - จาก Navigation
2.2.1: ตอนนี้โมดูลnavigation-common-ktxมีชื่อแพ็กเกจไฟล์ Manifest ที่ไม่ซ้ำกัน แทนที่จะใช้ชื่อแพ็กเกจไฟล์ Manifest เดียวกันกับnavigation-runtime-ktx(aosp/1141947)
การอัปเดตทรัพยากร Dependency
- จาก Navigation
2.2.1: ตอนนี้ Navigation2.2.1ขึ้นอยู่กับ Lifecycle ViewModel SavedState2.2.0และ Fragment1.2.1
เวอร์ชัน 2.2.2
เวอร์ชัน 2.2.2
15 เมษายน 2020
เผยแพร่ androidx.navigation:navigation-*:2.2.2 แล้ว เวอร์ชัน 2.2.2 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไข
IllegalStateExceptionเมื่อทำ Deep Link ไปยังปลายทางเริ่มต้นของกราฟเมื่อคุณมีอินสแตนซ์NavHostFragmentหลายรายการในกิจกรรม (b/147378752) NavigationUIจะไม่ละเว้นป้ายกำกับที่ว่างเปล่า (เช่น ปลายทางที่มีandroid:label=””) อีกต่อไป และตอนนี้จะตั้งค่าชื่อเป็นสตริงว่างอย่างถูกต้อง ก่อนหน้านี้ฟีเจอร์นี้เปิดตัวใน Navigation 2.3.0-alpha04 (b/148679860)- ตอนนี้กฎ ProGuard ของ
navigation-common-ktxจะเก็บเฉพาะคลาสNavArgsที่ใช้เท่านั้นอย่างถูกต้อง แทนที่จะเก็บอินสแตนซ์NavArgsทั้งหมด ฟีเจอร์นี้เปิดตัวไปก่อนหน้านี้ใน Navigation 2.3.0-alpha03 (b/150213558
การอัปเดตทรัพยากร Dependency
- ตอนนี้การนำทางจะขึ้นอยู่กับ Fragment
1.2.4(aosp/1277325)
เวอร์ชัน 2.2.1
เวอร์ชัน 2.2.1
5 กุมภาพันธ์ 2020
androidx.navigation:navigation-*:2.2.1 เผยแพร่แล้ว เวอร์ชัน 2.2.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้ Deep Link ที่ไม่มีพารามิเตอร์การค้นหาจะละเว้นพารามิเตอร์การค้นหาอย่างถูกต้อง แทนที่จะเพิ่มต่อท้ายองค์ประกอบ
{argument}หรือไม่จับคู่กับ Deep Link (b/147447512) - กฎ ProGuard
navigation-uiข้อสำหรับDrawerArrowDrawableได้รับการอัปเดตเพื่อให้แน่ใจว่าไม่จำเป็นต้องใช้android.enableJetifier=true(b/147610424) - ตอนนี้โมดูล
navigation-common-ktxมีชื่อแพ็กเกจไฟล์ Manifest ที่ไม่ซ้ำกันแทนที่จะใช้ชื่อแพ็กเกจไฟล์ Manifest เดียวกันกับnavigation-runtime-ktx(aosp/1141947)
การอัปเดตทรัพยากร Dependency
- ตอนนี้ Navigation
2.2.1ขึ้นอยู่กับ Lifecycle ViewModel SavedState2.2.0และ Fragment1.2.1
เวอร์ชัน 2.2.0
เวอร์ชัน 2.2.0
22 มกราคม 2020
androidx.navigation:navigation-*:2.2.0 เผยแพร่แล้ว เวอร์ชัน 2.2.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.1.0
- NavBackStackEntry: ตอนนี้คุณสามารถเรียกใช้
NavController.getBackStackEntry()โดยส่งรหัสของปลายทางหรือกราฟการนำทางใน Back Stack ได้แล้วNavBackStackEntryที่แสดงผลจะให้LifecycleOwner,ViewModelStoreOwnerที่ขับเคลื่อนด้วยการนำทาง (เหมือนกับที่แสดงผลโดยNavController.getViewModelStoreOwner()) และSavedStateRegistryOwnerนอกเหนือจากการระบุอาร์กิวเมนต์ที่ใช้ในการเริ่มปลายทางนั้น - การผสานรวม SavedState ของ ViewModel ในวงจร: ตอนนี้
SavedStateViewModelFactoryเป็นโรงงานเริ่มต้นที่ใช้เมื่อใช้by navGraphViewModels()หรือคอนสตรัคเตอร์ViewModelProviderกับViewModelStoreOwnerที่แสดงผลโดยNavController.getBackStackEntry()หรือNavController.getViewModelStoreOwner() - การรองรับพารามิเตอร์การค้นหาสำหรับ Deep Link: ตอนนี้ Deep Link ที่มีพารามิเตอร์การค้นหารองรับพารามิเตอร์การค้นหาที่จัดเรียงใหม่แล้ว ตอนนี้อาร์กิวเมนต์ที่มีค่าเริ่มต้นหรือเป็นค่า Null ได้จะเป็นตัวเลือกที่ไม่บังคับเมื่อจับคู่ Deep Link
- ปรับปรุงการรองรับภาพเคลื่อนไหว: ตอนนี้
NavHostFragmentใช้FragmentContainerViewจาก Fragment 1.2.0 ซึ่งช่วยแก้ไขปัญหาการจัดลำดับ Z ของภาพเคลื่อนไหวและการส่งส่วนแทรกของหน้าต่างไปยัง Fragment
เวอร์ชัน 2.2.0-rc04
18 ธันวาคม 2019
androidx.navigation:navigation-*:2.2.0-rc04 เผยแพร่แล้ว เวอร์ชัน 2.2.0-rc04 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ปรับภาพเคลื่อนไหวแบบเลือนเริ่มต้นที่
navigation-uiใช้ให้ตรงกับภาพเคลื่อนไหวแบบเลือนที่ปรับแล้วใน Fragment1.2.0-rc04(b/145769814)
เวอร์ชัน 2.2.0-rc03
4 ธันวาคม 2019
androidx.navigation:navigation-*:2.2.0-rc03 เผยแพร่แล้ว เวอร์ชัน 2.2.0-rc03 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาเกี่ยวกับการแยกวิเคราะห์ Deep Link เมื่อใช้พารามิเตอร์การค้นหาและอาร์กิวเมนต์เป็นส่วนสุดท้ายของเส้นทาง ซึ่งทำให้ไม่สามารถแยกวิเคราะห์อาร์กิวเมนต์เส้นทางสุดท้ายได้มากกว่า 1 อักขระ (b/144554689)
- แก้ไขปัญหาเกี่ยวกับการแยกวิเคราะห์ Deep Link ซึ่งพารามิเตอร์ที่ไม่บังคับจะได้รับ
"@null"แทนที่จะเป็นnull(b/141613546) - ตอนนี้
NavHostFragmentจะกู้คืนกราฟอย่างถูกต้องหลังจากการเปลี่ยนแปลงการกำหนดค่าเมื่อใช้กับFragmentContainerView(b/143752103)
การเปลี่ยนแปลงทรัพยากร Dependency
- ตอนนี้การนำทางจะขึ้นอยู่กับ Lifecycle
2.2.0-rc03, Lifecycle ViewModel SavedState1.0.0-rc03, Activity1.1.0-rc03และ Fragment1.2.0-rc03ตามความเหมาะสม
เวอร์ชัน 2.2.0-rc02
7 พฤศจิกายน 2019
androidx.navigation:navigation-*:2.2.0-rc02 เผยแพร่แล้ว เวอร์ชัน 2.2.0-rc02 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงทรัพยากร Dependency
- ตอนนี้ Navigation ขึ้นอยู่กับ androidx.lifecycle
2.2.0-rc02
เวอร์ชัน 2.2.0-rc01
23 ตุลาคม 2019
androidx.navigation:navigation-*:2.2.0-rc01 เปิดตัวโดยไม่มีการเปลี่ยนแปลงตั้งแต่ 2.2.0-beta01 เวอร์ชัน 2.2.0-rc01 มีคอมมิตเหล่านี้
เวอร์ชัน 2.2.0-beta01
9 ตุลาคม 2019
androidx.navigation:navigation-*:2.2.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.2.0-beta01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้
NavDestinationและคลาสย่อยจะลบล้างtoString()เพื่อให้ข้อมูลที่เป็นประโยชน์มากขึ้นเมื่อแก้ไขข้อบกพร่อง (b/141264986)
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้ระบบจะไม่สนใจพารามิเตอร์การค้นหาเพิ่มเติมเมื่อจับคู่ Deep Link แทนที่จะทำให้การจับคู่ไม่สำเร็จ (b/141482822)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ระบบจะละเว้นอาร์กิวเมนต์ในเส้นทางของ Deep Link หากมีการระบุพารามิเตอร์การค้นหาด้วย (b/141505755)
- ตอนนี้ส่วนขยาย Kotlin
navArgs()ในActivityมีข้อความแสดงข้อผิดพลาดที่ดีขึ้นเมื่อไม่มีส่วนเสริม (b/141408999) - ตอนนี้คลาส Java
Directionsที่สร้างโดย Safe Args มีค่าเริ่มต้นแล้ว (b/141099045) - ตอนนี้คลาส Java
Argsที่สร้างโดย Safe Args มีค่าเริ่มต้นแล้ว (b/140123727) - เมื่อใช้
ToolbarNavigationUIจะไม่แสดงภาพเคลื่อนไหวของการเปลี่ยนแปลงข้อความอีกต่อไปเมื่อย้ายระหว่างปลายทางระดับบนสุด 2 แห่ง (b/140848160)
เวอร์ชัน 2.2.0-alpha03
18 กันยายน 2019
androidx.navigation:navigation-*:2.2.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.2.0-alpha03 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้การเรียกใช้
setViewModelStore()หลังจากเรียกใช้setGraphจะส่งผลให้เกิดIllegalStateExceptionNavHostควรตั้งค่านี้เสมอโดยเป็นส่วนหนึ่งของการตั้งค่าเริ่มต้น เพื่อให้แน่ใจว่าอินสแตนซ์NavBackStackEntryทั้งหมดมีพื้นที่เก็บข้อมูลที่สอดคล้องกันสำหรับอินสแตนซ์ViewModel(aosp/1111821)
แก้ไขข้อบกพร่อง
- แก้ไข
ConcurrentModificationExceptionเมื่อใช้อินสแตนซ์ViewModelที่แนบมากับอินสแตนซ์ViewModelStoreที่กำหนดขอบเขตของกราฟการนำทางที่แตกต่างกันหลายรายการ (aosp/1112257)
เวอร์ชัน 2.2.0-alpha02
5 กันยายน 2019
androidx.navigation:navigation-*:2.2.0-alpha02 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
ฟีเจอร์ใหม่
- ตอนนี้ Deep Link ที่มีพารามิเตอร์การค้นหารองรับพารามิเตอร์การค้นหาที่จัดเรียงใหม่แล้ว และตอนนี้อาร์กิวเมนต์ที่มีค่าเริ่มต้นหรือเป็นค่า Null ได้จะเป็นตัวเลือกที่ไม่บังคับเมื่อจับคู่ Deep Link (b/133273839)
- ตอนนี้คุณสามารถเรียกใช้
NavController.getBackStackEntry()โดยส่งรหัสของปลายทางหรือกราฟการนำทางใน Back Stack ได้แล้วNavBackStackEntryที่แสดงผลจะให้LifecycleOwner,ViewModelStoreOwnerที่ขับเคลื่อนด้วยการนำทาง (เหมือนกับที่แสดงผลโดยNavController.getViewModelStoreOwner()) และSavedStateRegistryOwnerนอกเหนือจากการระบุอาร์กิวเมนต์ที่ใช้ในการเริ่มปลายทางนั้น (aosp/1101691, aosp/1101710)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่การเพิ่ม
NavHostFragmentไปยังViewPager2ไม่สำเร็จเนื่องจากเกิดข้อผิดพลาดIllegalArgumentException(b/133640271) - ตอนนี้
NavInflaterจะหลีกเลี่ยงการเรียกใช้getResourceName()โดยไม่จำเป็น ซึ่งช่วยเร่งเวลาการสร้างออบเจ็กต์ได้สูงสุด 40% (b/139213740)
เวอร์ชัน 2.2.0-alpha01
7 สิงหาคม 2019
androidx.navigation:navigation-*:2.2.0-alpha01 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
ฟีเจอร์ใหม่
- ตอนนี้
SavedStateViewModelFactoryเป็นโรงงานเริ่มต้นที่ใช้เมื่อใช้by navGraphViewModels()หรือตัวสร้างViewModelProviderที่มีViewModelStoreOwnerซึ่งแสดงผลโดยNavController.getViewModelStoreOwner()(b/135716331)
การเปลี่ยนแปลง API
- จากการนำทาง
2.1.0-rc01: ระบบได้นำgetViewModelStore()API ที่เลิกใช้งานแล้วในNavControllerซึ่งเปิดตัวใน2.1.0-alpha02ออกแล้ว (aosp/1091021)
แก้ไขข้อบกพร่อง
- ตอนนี้
NavHostFragmentใช้FragmentContainerViewซึ่งช่วยแก้ไขปัญหาการจัดลำดับ Z ของภาพเคลื่อนไหวและการส่ง Window Inset ไปยัง Fragment (b/137310379)
เวอร์ชัน 2.1.0
เวอร์ชัน 2.1.0
5 กันยายน 2019
androidx.navigation:navigation-*:2.1.0 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.0.0
- การกำหนดขอบเขต ViewModel ให้กับกราฟการนำทาง: ตอนนี้คุณสามารถสร้าง ViewModel ที่กำหนดขอบเขตที่ระดับกราฟการนำทางได้โดยใช้ผู้รับมอบสิทธิ์พร็อพเพอร์ตี้
by navGraphViewModels()สำหรับผู้ใช้ Kotlin ที่ใช้ไลบรารี-ktxหรือโดยใช้ APIgetViewModelStoreOwner()ที่เพิ่มลงในNavControllerดูข้อมูลเพิ่มเติมได้ที่แชร์ข้อมูลที่เกี่ยวข้องกับ UI ระหว่างปลายทาง - ปลายทางของกล่องโต้ตอบ: ตอนนี้คุณสามารถสร้างปลายทาง
<dialog>ที่จะแสดงDialogFragmentเมื่อคุณnavigateไปยังปลายทางเหล่านั้นได้แล้วNavHostFragmentรองรับปลายทางของกล่องโต้ตอบโดยค่าเริ่มต้น ดูข้อมูลเพิ่มเติมได้ที่สร้างปลายทางจาก DialogFragment - การไปยังส่วนต่างๆ ด้วย URI: ตอนนี้คุณสามารถ
navigateโดยใช้Uriซึ่งใช้<deepLink>ที่คุณเพิ่มลงในปลายทางเพื่อไปยังส่วนต่างๆ ได้แล้ว ดูข้อมูลเพิ่มเติมได้ที่ไปยังส่วนต่างๆ โดยใช้ URI - NavHostController: API ที่ใช้สำหรับการสร้าง
NavHostที่กำหนดเองโดยเฉพาะได้ย้ายไปที่NavHostControllerแล้ว ซึ่งช่วยให้การติดตั้งใช้งานสามารถเชื่อมต่อNavControllerกับLifecycleOwner,OnBackPressedDispatcherและViewModelStoreที่โฮสต์ได้
เวอร์ชัน 2.1.0-rc01
7 สิงหาคม 2019
androidx.navigation:navigation-*:2.1.0-rc01 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
การเปลี่ยนแปลง API
- เราได้นำ
getViewModelStore()API ที่เลิกใช้งานแล้วในNavControllerซึ่งเปิดตัวใน2.1.0-alpha02ออกแล้ว (aosp/1091021)
เวอร์ชัน 2.1.0-beta02
19 กรกฎาคม 2019
androidx.navigation:*:2.1.0-beta02 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
แก้ไขข้อบกพร่อง
- นำทรัพยากร Dependency ของ jacoco ที่ไม่ได้ตั้งใจซึ่งเปิดตัวใน
2.1.0-beta01ออก (b/137782950)
เวอร์ชัน 2.1.0-beta01
17 กรกฎาคม 2019
androidx.navigation:*:2.1.0-beta01 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
ฟีเจอร์ใหม่
- ตอนนี้
NavigationUIจะแสดงภาพเคลื่อนไหวของการนำปุ่มขึ้นออกเมื่อใช้setupWithNavController()กับToolbarหรือCollapsingToolbarLayout(b/131403621)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาด้านเวลาเมื่อใช้ NavHostFragment หลายรายการกับคอนเทนเนอร์เดียวกันด้วย
findNavController()(b/136021571)
เวอร์ชัน 2.1.0-alpha06
2 กรกฎาคม 2019
androidx.navigation:*:2.1.0-alpha06 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
ฟีเจอร์ใหม่
- ตอนนี้แอตทริบิวต์
app:navGraphที่ NavHostFragment ใช้ได้ย้ายไปยังอาร์ติแฟกต์navigation-runtimeแล้ว เนวิเกเตอร์ที่กำหนดเองซึ่งเพิ่มผ่าน XML ได้ควรใช้แอตทริบิวต์นี้เพื่อผสานรวมกับแผงโฮสต์ของเครื่องมือแก้ไขการนำทาง (b/133880955)
การเปลี่ยนแปลง API
getViewModelStore()API ในNavControllerเลิกใช้งานแล้วเพื่อสนับสนุนเมธอดgetViewModelStoreOwner()ใหม่ที่แสดงผลViewModelStoreOwner(aosp/987010)- การใช้งานปลายทางของหน้าต่างแบบลอย เช่น ปลายทาง
<dialog>ได้รับการปรับให้เป็นอินเทอร์เฟซมาร์กเกอร์FloatingWindowซึ่งปลายทาง<dialog>ทั้งหมดใช้งานอยู่ในขณะนี้ ตอนนี้เมธอด NavigationUI สำหรับการโต้ตอบกับแถบแอปด้านบนจะละเว้นปลายทางFloatingWindow(b/133600763)
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้การนำทางจะซิงค์สถานะกับสิ่งที่เห็นบนหน้าจออย่างถูกต้องเมื่อใช้ปลายทาง
<dialog>ด้วยเหตุนี้ Navigation จึงแสดงปลายทาง<dialog>โดยอัตโนมัติเมื่อคุณไปยังปลายทางที่ไม่ใช่กล่องโต้ตอบและไม่ใช่กิจกรรม เช่น ปลายทาง<fragment>(b/134089818)
แก้ไขข้อบกพร่อง
- ตอนนี้การนําทางจะระงับภาพเคลื่อนไหวที่เกิดขึ้นเมื่อสร้างกิจกรรมอีกครั้งเมื่อจัดการ Deep Link ซึ่งจะช่วยแก้ไขภาพกะพริบ (b/130362979)
- แก้ไขข้อบกพร่องที่ Back Stack ของการนําทางไม่ซิงค์กันเมื่อแสดง Fragment ขณะที่เพิ่ม Fragment เริ่มต้น (b/133832218)
เวอร์ชัน 2.1.0-alpha05
5 มิถุนายน 2019
androidx.navigation:*:2.1.0-alpha05 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
การเปลี่ยนแปลง API
- API ที่เกี่ยวข้องกับโฮสต์ใน
NavControllerได้รับการเปลี่ยนชื่อและย้ายไปยังคลาสย่อยใหม่ของNavController,NavHostController(aosp/966091) - เมธอด
setHostOnBackPressedDispatcherOwner()ของNavControllerถูกแทนที่ด้วยเมธอดsetOnBackPressedDispatcher()ของNavHostControllerและตอนนี้คุณต้องเรียกใช้setLifecycleOwner()ก่อนที่จะเรียกใช้เมธอดดังกล่าว (aosp/965409) - ตอนนี้
NavHostControllerมีเมธอดenableOnBackPressed(boolean)ที่แทนที่คลาสNavHostOnBackPressedManagerซึ่งก่อนหน้านี้แสดงผลโดยsetHostOnBackPressedDispatcherOwner()(aosp/966091)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ Back Stack ไม่ถูกต้องหลังจากไปยังส่วนต่างๆ ด้วย URI (b/132509387)
- ตอนนี้ Deep Link ที่ NavController จัดการโดยอัตโนมัติจะทริกเกอร์เพียงครั้งเดียวเท่านั้น (b/132754763)
เวอร์ชัน 2.1.0-alpha04
16 พฤษภาคม 2019
androidx.navigation:*:2.1.0-alpha04 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
แก้ไขข้อบกพร่อง
NavHostFragmentเคารพapp:defaultNavHostอย่างถูกต้องเมื่อสกัดกั้นเหตุการณ์ปุ่มย้อนกลับของระบบ ซึ่งแก้ไขการถดถอยใน Navigation2.1.0-alpha03b/132077777- ตอนนี้
DialogFragmentNavigatorจัดการการดำเนินการpopBackStack()และnavigateUp()ได้อย่างถูกต้องแล้ว b/132576764 - แก้ไขปัญหา
IllegalStateException: unknown destination during restoreเมื่อไปยังส่วนต่างๆ ระหว่างกราฟที่ซ้อนกันซ้ำๆ b/131733658
เวอร์ชัน 2.1.0-alpha03
7 พฤษภาคม 2019
androidx.navigation:*:2.1.0-alpha03 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
ปัญหาที่ทราบ
- NavHostFragment ยังคงขัดขวางปุ่มย้อนกลับของระบบแม้ว่าจะใช้
app:defaultNavHost="false"b/132077777 ก็ตาม
ฟีเจอร์ใหม่
- ตอนนี้คุณสามารถสร้างจุดหมาย
<dialog>ที่จะแสดงDialogFragmentเมื่อคุณnavigateไปยังจุดหมายดังกล่าวได้แล้วNavHostFragmentรองรับปลายทางของกล่องโต้ตอบโดยค่าเริ่มต้น b/80267254 - นอกจากการเรียก
navigateด้วยรหัสทรัพยากรหรืออินสแตนซ์NavDirectionsตอนนี้คุณสามารถไปยังส่วนต่างๆ ผ่านUriซึ่งใช้<deepLink>ที่คุณเพิ่มลงในปลายทางเพื่อไปยังปลายทางที่ถูกต้อง b/110412864
การเปลี่ยนแปลงพฤติกรรม
- ภาพเคลื่อนไหวเริ่มต้นที่ NavigationUI มีให้ได้รับการเร่งความเร็วจาก 400 มิลลิวินาทีเป็น 220 มิลลิวินาทีเพื่อให้ตรงกับความเร็วภาพเคลื่อนไหวเริ่มต้นของกิจกรรมและ Fragment b/130055522
การเปลี่ยนแปลง API
- เราเลิกใช้งานเมธอด
createFragmentNavigator()ของNavHostFragmentแล้ว และย้ายฟังก์ชันการทำงานไปยังเมธอดonCreateNavController()ใหม่เพื่อให้ชัดเจนยิ่งขึ้นว่านี่คือจุดแรกเข้าที่ถูกต้องในการเพิ่ม Navigator ที่กำหนดเองเมื่อสร้างคลาสย่อยNavHostFragmentb/122802849 - เพิ่มเมธอด
hasDeepLink()ลงในNavDestinationเพื่อให้คุณตรวจสอบได้ว่าUriที่ระบุสามารถจัดการโดยปลายทางนั้นได้หรือไม่ หรือในกรณีของNavGraphปลายทางใดก็ได้ในกราฟการนำทาง b/117437718
แก้ไขข้อบกพร่อง
- ตอนนี้ระบบจะส่งอาร์กิวเมนต์เริ่มต้นไปยังอินสแตนซ์
OnDestinationChangedListenerอย่างถูกต้องแล้ว b/130630686 - ตอนนี้
NavHostFragmentจะขัดจังหวะเหตุการณ์การย้อนกลับของระบบโดยใช้OnBackPressedDispatcherซึ่งจะช่วยแก้ไขปัญหาเมื่อทำการนำทางแบบมีเงื่อนไขในเมธอดวงจรของ Fragment เมื่อกลับไปยัง Fragment b/111598096 - สำหรับ Safe Args ตอนนี้ระบบจะอนุมาน
android:defaultValue=”@null”ที่มีapp:argTypeที่ไม่ได้ระบุเป็นอาร์กิวเมนต์stringอย่างถูกต้อง b/129629192
เวอร์ชัน 2.1.0-alpha02
3 เมษายน 2019
androidx.navigation:*:2.1.0-alpha02 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
ฟีเจอร์ใหม่
- ตอนนี้คุณสามารถสร้าง ViewModel ที่กำหนดขอบเขตในระดับกราฟการนำทางผ่านผู้รับมอบสิทธิ์พร็อพเพอร์ตี้
by navGraphViewModels()สำหรับผู้ใช้ Kotlin หรือโดยใช้getViewModelStore()API ที่เพิ่มลงในNavControllerb/111614463
การเปลี่ยนแปลง API
- ตอนนี้คุณสามารถเพิ่ม
app:targetPackageลงในปลายทาง<activity>เพื่อจำกัดชื่อแพ็กเกจที่ตรงกันได้แล้ว รองรับapp:targetPackage="${applicationId}"สำหรับการจำกัดแพ็กเกจไว้เฉพาะรหัสแอปพลิเคชันของคุณเอง b/110975456
แก้ไขข้อบกพร่อง
- ระบบจะไม่แยกวิเคราะห์
android:nameสำหรับปลายทาง<activity>เป็นคลาสในเวลาที่ขยายอีกต่อไป ซึ่งจะช่วยป้องกัน ClassNotFoundExceptions เมื่อใช้ฟีเจอร์แบบไดนามิก b/124538597
เวอร์ชัน 2.1.0-alpha01
19 มีนาคม 2019
นี่เป็น Navigation 2.1.0 เวอร์ชันอัลฟ่ารุ่นแรก
การเปลี่ยนแปลงทรัพยากร Dependency
- ตอนนี้การนำทางจะขึ้นอยู่กับ
androidx.core:core:1.0.1และandroidx.fragment:fragment:1.1.0-alpha05นอกจากนี้ เวอร์ชันนี้ยังนำทรัพยากร Dependency ในandroidx.legacy:legacy-support-core-utils:1.0.0ออกด้วย b/128632612
การเปลี่ยนแปลง API
- เพิ่มเมธอด
Navigation.createNavigateOnClickListener(NavDirections)ใหม่เป็นทางเลือกในการสร้างฟังก์ชันรอคลิกด้วยรหัสทรัพยากรและ Bundle b/127631752 FragmentNavigator.instantiateFragmentเลิกใช้งานแล้ว ตอนนี้การติดตั้งใช้งานเริ่มต้นใช้FragmentFactoryเพื่อสร้างอินสแตนซ์ Fragment b/119054429
แก้ไขข้อบกพร่อง
- Navigation จะไม่ส่ง
Bundleที่เป็นค่า Null อีกต่อไปเมื่อมีอาร์กิวเมนต์ที่แนบมากับปลายทาง ซึ่งจะช่วยแก้ไขปัญหาเมื่อใช้android:defaultValue="@null"b/128531879 - ตอนนี้ Safe Args ขึ้นอยู่กับ KotlinPoet 1.1.0 ซึ่งแก้ไขปัญหาเกี่ยวกับชื่อแพ็กเกจที่ยาวมาก b/123654948
เวอร์ชัน 2.0.0
เวอร์ชัน 2.0.0
14 มีนาคม 2019
Navigation 2.0.0 เปิดตัวโดยไม่มีการเปลี่ยนแปลงจาก 2.0.0-rc02
เวอร์ชัน 2.0.0-rc02
6 มีนาคม 2019
Navigation 2.0.0-rc02 มีอาร์ติแฟกต์ใหม่ที่มีรหัสกลุ่ม androidx.navigation และเปลี่ยนทรัพยากร Dependency เป็น AndroidX ที่เทียบเท่า
ลักษณะการทำงานของ 2.0.0-rc02 เหมือนกับลักษณะการทำงานของ Navigation 1.0.0-rc02 และไม่จำเป็นต้องเปลี่ยนแปลงโค้ดเพื่ออัปเดตจาก 1.0.0-rc02 นอกเหนือจากการอัปเดตทรัพยากร Dependency ให้ตรงกับทรัพยากร Dependency ใหม่
โปรเจ็กต์ของคุณต้องย้ายข้อมูลไปยัง AndroidX เพื่อใช้ Navigation เวอร์ชัน 2.X Navigation 1.0 เวอร์ชันเสถียรจะเป็นรุ่นสุดท้ายที่ใช้ทรัพยากร Dependency ของ Support Library โดยการพัฒนาในอนาคตทั้งหมดที่นอกเหนือจาก 1.0 จะอิงตาม AndroidX และต่อยอดจากรุ่นเสถียร 2.0
ทรัพยากร Dependency ก่อน AndroidX
สำหรับ Navigation เวอร์ชันก่อน AndroidX ให้รวมทรัพยากร Dependency ต่อไปนี้
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 ให้เพิ่ม classpath ต่อไปนี้ในไฟล์ build.gradle ระดับบนสุด
buildscript {
repositories {
google()
}
dependencies {
classpath "android.arch.navigation:navigation-safe-args-gradle-plugin:1.0.0"
}
}
เวอร์ชัน 1.0.0
เวอร์ชัน 1.0.0
14 มีนาคม 2019
Navigation 1.0.0 เปิดตัวโดยไม่มีการเปลี่ยนแปลงจาก 1.0.0-rc02
เวอร์ชัน 1.0.0-rc02
26 กุมภาพันธ์ 2019
นี่เป็นรุ่นที่อาจได้รับการเผยแพร่รุ่นที่ 2 สำหรับเวอร์ชันเสถียร 1.0.0 ของ Navigation รุ่นนี้มีการแก้ไขข้อบกพร่องหลายรายการ
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ระบบจะละเว้น
popBackStack()หากกราฟรูทไม่มีรหัส b/126251695 - ตอนนี้
navigateUp()จัดการการกลับไปยังงานของแอปได้อย่างถูกต้องเมื่อมีการเรียกใช้หลังจากจัดการ Deep Link โดยไม่มีFLAG_ACTIVITY_NEW_TASKb/126082008 - แก้ไขปัญหาที่
ActivityNavigator.applyPopAnimationsToPendingTransitionไม่ใช้ภาพเคลื่อนไหวเมื่อกดออกที่ถูกต้อง b/126237567 - ตอนนี้โค้ด Kotlin ที่สร้างโดย Safe Args จะกำหนดอักขระหลีกสำหรับคีย์เวิร์ด Kotlin อย่างเหมาะสม เช่น
inและfunในชื่อแพ็กเกจที่เชื่อมโยงกับคลาสRb/126020455
เวอร์ชัน 1.0.0-rc01
21 กุมภาพันธ์ 2019
นี่คือรุ่นที่อาจได้รับการเผยแพร่สำหรับเวอร์ชันเสถียร 1.0.0 ของ Navigation รุ่นนี้มีการแก้ไขข้อบกพร่อง 1 รายการ
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาเมื่อใช้ Fragment และการดำเนินการนำทาง
singleTopb/124294805
เวอร์ชัน 1.0.0-beta02
12 กุมภาพันธ์ 2019
รุ่นนี้มีการปรับปรุงเล็กน้อยและการแก้ไขข้อบกพร่องที่สำคัญหลายรายการ
ฟีเจอร์ใหม่
- ตอนนี้คุณสามารถใช้
0เป็นandroid:defaultValueสำหรับอาร์กิวเมนต์referenceได้แล้ว b/124248602
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้ระบบจะให้ความสำคัญกับ Deep Link ที่ตรงกันทุกประการมากกว่า Deep Link ที่มี
.*หรืออาร์กิวเมนต์ที่ตรงกัน b/123969518
แก้ไขข้อบกพร่อง
- ตอนนี้
popBackStack()และnavigateUpจะแสดงผลfalseอย่างถูกต้องเมื่อแสดงปลายทางสุดท้ายใน Back Stack ซึ่งแก้ไขการถดถอยที่เกิดขึ้นใน1.0.0-beta01b/123933201 - ตอนนี้ Navigation จะตั้งค่า
ClassLoaderอย่างถูกต้องระหว่างการกู้คืนสถานะอินสแตนซ์ที่บันทึกไว้ เพื่อหลีกเลี่ยงปัญหาเมื่อใช้คลาสที่กำหนดเองในสถานะที่บันทึกไว้ของNavigatorหรือในอาร์กิวเมนต์ที่ส่งไปยังNavDestinationb/123893858 - คลาส NavArgs ที่ Safe Args สร้างขึ้นจะไม่ขัดข้องอีกต่อไปเมื่อกู้คืนอาร์กิวเมนต์
Parcelable[]จากสถานะอินสแตนซ์ที่บันทึกไว้ b/123963545 - ตอนนี้ Safe Args จะล้างคลาส Kotlin ที่สร้างขึ้นโดยไม่จำเป็นอย่างเหมาะสม b/124120883
เวอร์ชัน 1.0.0-beta01
4 กุมภาพันธ์ 2019
นี่เป็น Navigation เวอร์ชันเบต้ารุ่นแรก โดย Navigation API คาดว่าจะยังคงเสถียรจนกว่าจะถึงเวอร์ชันถัดไป เว้นแต่จะมีปัญหาร้ายแรง รุ่นนี้มีการแก้ไขข้อบกพร่องและการเปลี่ยนแปลงลักษณะการทำงานบางอย่าง
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้การนำทางจะช่วยให้มั่นใจได้ว่าค่าเริ่มต้นของอาร์กิวเมนต์จะได้รับการจัดการเหมือนกันทั้งในรันไทม์และผ่าน Safe Args ด้วยเหตุนี้ เฉพาะอาร์กิวเมนต์ที่มี
app:argType="reference"เท่านั้นที่จะมีค่าเริ่มต้นที่ชี้ไปยังทรัพยากรอื่นได้ (เช่น@color/colorPrimary) การพยายามใช้ค่าเริ่มต้นของการอ้างอิงกับapp:argTypeอื่นจะส่งผลให้เกิดข้อยกเว้นเมื่อแยกวิเคราะห์ XML การนำทาง b/123551990 - ตอนนี้ Safe Args ต้องใช้ปลั๊กอิน Android Gradle 3.3.0 aosp/888413
- ตอนนี้ Safe Args ขึ้นอยู่กับ Kotlin 1.3.20 aosp/888414
แก้ไขข้อบกพร่อง
- ตอนนี้คุณสามารถใช้ Safe Args ในโมดูลไลบรารีและโมดูลฟีเจอร์ในปลั๊กอิน Android Gradle ทุกเวอร์ชันได้แล้ว b/121304903
- แก้ไขการถดถอยที่ทำให้การดำเนินการ
popBackStack()ครั้งเดียวแสดงสำเนาทั้งหมดของปลายทางที่ด้านบนของ Back Stack แทนที่จะเป็นปลายทางเดียวในแต่ละครั้ง b/123552990 - แก้ไขปัญหาที่สถานะ
FragmentNavigatorไม่ซิงค์กับสถานะของNavControllerทำให้เกิดIllegalStateExceptionเมื่อพยายามกู้คืน Back Stack b/123803044 - แก้ไขปัญหาที่ลูกศรย้อนกลับที่จัดการโดย
NavigationUIไม่ปรากฏเมื่อใช้ ProGuard กับการสร้างความสับสน b/123449431 - ตอนนี้โค้ดที่สร้างโดย Safe Args จะจัดการการใช้
app:argTypeที่ชี้ไปยังคลาสภายในแบบคงที่ในรูปแบบ.OuterClass$InnerClassได้อย่างถูกต้อง b/123736741 - ตอนนี้โค้ด Java ที่สร้างโดย Safe Args จะจัดการการดำเนินการส่วนกลางและปลายทางที่ซ้อนกันหลายระดับได้อย่างถูกต้อง b/123347762
เวอร์ชัน 1.0.0-alpha11
23 มกราคม 2019
นี่เป็นรุ่น Hotfix ของ 1.0.0-alpha10 ที่แก้ไขปัญหาเกี่ยวกับ Safe Args
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ Safe Args ไม่สามารถนำเข้าคลาส Directions ที่เชื่อมโยงกับการทำงานส่วนกลาง b/123307342
เวอร์ชัน 1.0.0-alpha10
23 มกราคม 2019
ปัญหาที่ทราบ
- Safe Args นำเข้าคลาส Directions ที่เชื่อมโยงกับการดำเนินการส่วนกลางไม่สำเร็จ b/123307342
รุ่นนี้มีการเปลี่ยนแปลง API ที่ส่งผลกับส่วนอื่นในระบบ โปรดดูส่วนการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบด้านล่าง
ฟีเจอร์ใหม่
- ตอนนี้ผู้ใช้ Kotlin สามารถใช้ผู้รับมอบสิทธิ์พร็อพเพอร์ตี้
by navArgs()เพื่อรับการอ้างอิงไปยังคลาสNavArgsที่สร้างโดย Safe Args ในActivityหรือFragmentแบบ Lazy ได้ b/122603367 - ตอนนี้ Safe Args ช่วยให้คุณสร้างโค้ด Kotlin ได้โดยใช้ปลั๊กอิน
androidx.navigation.safeargs.kotlinโค้ด Kotlin สร้างขึ้นสำหรับโมดูล Kotlin เท่านั้น โดยใช้อาร์กิวเมนต์เริ่มต้นและคลาสที่เปลี่ยนแปลงไม่ได้แทนรูปแบบ Builder ที่ยังคงใช้ได้ผ่านปลั๊กอินandroidx.navigation.safeargsก่อนหน้า b/110263087
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้ Deep Link ที่ตรงกันจะให้น้ำหนักกับ Deep Link ที่มีอาร์กิวเมนต์ที่ตรงกันมากที่สุด b/118393029
- ตอนนี้การเรียกใช้
setGraph()ในNavControllerจะรีเซ็ต Back Stack b/111450672 - Deep Link ที่ไม่รู้จักจะไม่แสดง
IllegalStateExceptionอีกต่อไป แต่จะ ถูกละเว้น ซึ่งจะช่วยแก้ไขปัญหาเกี่ยวกับNavHostFragmentที่ซ้อนกันหรือมีหลายรายการ b/121340440
การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
- ย้ายเมธอด
NavOptions.applyPopAnimationsToPendingTransition()สำหรับการใช้ภาพเคลื่อนไหวแบบป๊อปกับกิจกรรมไปยังActivityNavigatorแล้ว b/122413117 - ตอนนี้ Safe Args จะหลีกเลี่ยงการสร้างคลาสที่เหมือนกันซ้ำสำหรับการดำเนินการที่ไม่มีอาร์กิวเมนต์ ตอนนี้ประเภทการแสดงผลสำหรับเมธอดที่ไม่มีอาร์กิวเมนต์ในคลาส NavDirections ที่สร้างขึ้นคือ
NavDirectionsb/123233147 - คลาส Directions ที่สร้างโดย Safe Args ไม่มีคอนสตรัคเตอร์สาธารณะอีกต่อไป คุณควรโต้ตอบกับเมธอดแบบคงที่ที่สร้างขึ้นเท่านั้น b/123031660
- คลาส
NavDirectionsที่สร้างโดย Safe Args ไม่มีเมธอดคอนสตรัคเตอร์แบบสาธารณะอีกต่อไป โดยควรสร้างผ่านเมธอดแบบคงที่ในคลาส Directions ที่สร้างขึ้นเท่านั้น b/122963206 - ตอนนี้
Bundleที่ส่งคืนจากgetArguments()ของNavDirectionsได้รับการทำเครื่องหมายเป็น@NonNullแทนที่จะเป็น@Nullableb/123243957
แก้ไขข้อบกพร่อง
- ตอนนี้
NavDeepLinkBuilderจะจัดการPendingIntentหลายรายการที่เกิดขึ้นพร้อมกันไปยังปลายทางเดียวกันได้อย่างถูกต้องโดยใช้อาร์กิวเมนต์ที่คุณส่งเข้ามาเพื่อระบุความไม่ซ้ำกัน b/120042732 - ตอนนี้
NavControllerจัดการการดำเนินการpopBackStack()ได้อย่างถูกต้องเมื่อใช้NavHostFragmentที่ฝังอยู่หรือ Fragment ย่อยอื่นๆ ที่มี Back Stack b/122770335 - ตอนนี้
NavigationUIตั้งค่าคำอธิบายเนื้อหาของปุ่มขึ้นได้อย่างถูกต้องแล้ว b/120395362 - ตอนนี้คลาส Directions ที่สร้างโดย Safe Args จะจัดการการดำเนินการส่วนกลางที่มีรหัสเดียวกับการดำเนินการในปลายทางได้อย่างถูกต้องแล้ว b/122962504
- ตอนนี้คลาส
NavDirectionsที่สร้างโดย Safe Args มีค่าhashCode()เท่ากันอย่างถูกต้องเมื่อequals()แสดงผลเป็นจริง b/123043662 - ตอนนี้
FragmentNavigatorจะแสดงข้อความแสดงข้อผิดพลาดที่ดีขึ้นหากคุณพยายามทำFragmentTransactionsที่กำหนดเองในFragmentManagerของNavHostFragmentคุณควรใช้getChildFragmentManager()เสมอ b/112927148
เวอร์ชัน 1.0.0-alpha09
18 ธันวาคม 2018
รุ่นนี้มีการเปลี่ยนแปลง API ที่ส่งผลกับส่วนอื่นในระบบ โปรดดูส่วนการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบด้านล่าง
เราเลือกที่จะไม่พัฒนาอาร์ติแฟกต์ android.arch.navigation:navigation-testing ต่อ แม้ว่าวิธีนี้จะมีประโยชน์
สำหรับการทดสอบภายในของ NavController แต่เราขอแนะนำอย่างยิ่ง
ให้ใช้กลยุทธ์การทดสอบอื่น เช่น การจำลองอินสแตนซ์ NavController
เพื่อยืนยันว่ามีการเรียกใช้ navigate() ที่ถูกต้อง แนวทางนี้มีการพูดถึงอย่างละเอียดในการพูดคุยเรื่องกิจกรรมเดียวที่ AndroidDevSummit 2018 และเราจะจัดทำเอกสารประกอบเพิ่มเติมเกี่ยวกับการทดสอบด้วยการนำทางโดยเฉพาะ
ฟีเจอร์ใหม่
MenuItemที่มีmenuCategory="secondary"จะไม่แสดง Back Stack อีกต่อไปเมื่อใช้กับเมธอดNavigationUIb/120104424- ตอนนี้
AppBarConfigurationให้คุณตั้งค่าอินสแตนซ์OnNavigateUpListenerสำรองซึ่งจะถูกเรียกใช้เมื่อnavController.navigateUp()แสดงผลfalseb/79993862 b/120690961
การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
- เมื่อใช้
<argument>กับargType="reference"การนำทางจะไม่แยกวิเคราะห์การอ้างอิงอีกต่อไป แต่จะระบุรหัสทรัพยากรดิบแทน b/111736515 onNavDestinationSelected()จะกลับไปที่ปลายทางเริ่มต้นของกราฟการนำทางโดยค่าเริ่มต้น เพื่อให้สอดคล้องกับเมธอดsetupเพิ่มmenuCategory="secondary"ลงในMenuItemเพื่อหลีกเลี่ยงการแสดง Back Stack aosp/852869- ตอนนี้เมธอด
fromBundle()ของคลาสArgsที่สร้างขึ้นจะใช้Bundleที่ไม่ใช่ค่า Null แทนBundleที่เป็นค่า Null ได้ aosp/845616
แก้ไขข้อบกพร่อง
- ตอนนี้ระบบจะแยกวิเคราะห์อาร์กิวเมนต์จาก Deep Link เป็น
argTypeที่ถูกต้องอย่างเหมาะสมแทนที่จะเป็นสตริงเสมอ b/110273284 - ตอนนี้ Navigation ส่งออกทรัพยากรสาธารณะได้อย่างถูกต้องแล้ว b/121059552
- ตอนนี้ Safe Args เข้ากันได้กับปลั๊กอิน Android Gradle 3.4 Canary 4 ขึ้นไป b/119662045
เวอร์ชัน 1.0.0-alpha08
6 ธันวาคม 2018
รุ่นนี้มีการเปลี่ยนแปลง API ที่ส่งผลกับส่วนอื่นในระบบ โปรดดูส่วนการเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบด้านล่าง
ฟีเจอร์ใหม่
- ตอนนี้ป้ายกำกับปลายทางเมื่อใช้กับเมธอด
NavigationUIจะแทนที่อินสแตนซ์{argName}ในandroid:labelด้วยอาร์กิวเมนต์ที่ถูกต้องโดยอัตโนมัติ b/80267266 - ตอนนี้การนำทางขึ้นอยู่กับ Support Library 28.0.0 b/120293333
การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
OnNavigatedListenerเปลี่ยนชื่อเป็นOnDestinationChangedListenerแล้ว b/118670572- ตอนนี้
OnDestinationChangedListenerยังส่งBundleของอาร์กิวเมนต์ด้วย aosp/837142 - แอตทริบิวต์
app:clearTaskและapp:launchDocumentรวมถึงเมธอดที่เกี่ยวข้องถูกนำออกแล้ว ใช้app:popUpToกับรูทของกราฟเพื่อนำปลายทางทั้งหมดออกจาก Back Stack b/119628354 - ตอนนี้
ActivityNavigator.Extrasใช้รูปแบบBuilderและเพิ่มความสามารถในการตั้งค่าแฟล็กIntent.FLAG_ACTIVITY_ใดก็ได้ aosp/828140 NavController.onHandleDeepLinkเปลี่ยนชื่อเป็นhandleDeepLinkแล้ว aosp/836063- คลาสและเมธอดจำนวนมากที่ไม่ได้มีไว้สำหรับการสร้างคลาสย่อย เช่น
NavOptions,NavInflater,NavDeepLinkBuilderและAppBarConfigurationได้รับการกำหนดให้เป็นfinalaosp/835681 - นำเมธอด
NavHostFragment.setGraph()ที่เลิกใช้งานแล้วออก aosp/835684 - นำเมธอด
NavigationUI.navigateUp(DrawerLayout, NavController)ที่เลิกใช้งานแล้วออก aosp/835684 - การสร้าง Fragment ได้ย้ายไปที่
FragmentNavigatorแล้ว ซึ่งช่วยให้มอบสิทธิ์การสร้าง Fragment ให้กับFragmentFactoryได้ง่ายขึ้น b/119054429 - ตัวสร้างสำหรับ
NavGraphNavigatorไม่ใช้Contextอีกต่อไป aosp/835340 - ตอนนี้ NavigatorProvider เป็นคลาส ไม่ใช่อินเทอร์เฟซ
NavigatorProviderที่แสดงผลโดยgetNavigatorProvider()ไม่ได้เปลี่ยนฟังก์ชันการทำงาน aosp/830660 NavDestination.navigate()ถูกลบออกไปแล้ว ให้เรียกใช้navigate()ในNavigatorแทน aosp/830663- การเปลี่ยนโครงสร้างภายในโค้ดที่สำคัญของ
Navigatorซึ่งช่วยลดความจำเป็นในการใช้OnNavigatorNavigatedListenerและให้navigateแสดงผลNavDestinationที่ไปยังส่วนต่างๆ แทน - อินสแตนซ์
Navigatorจะส่งเหตุการณ์ POP ไปยังNavControllerไม่ได้อีกต่อไป ลองใช้OnBackPressedCallbackเพื่อสกัดกั้นการกดปุ่มย้อนกลับและเรียกใช้navController.popBackStack()aosp/833716
แก้ไขข้อบกพร่อง
popUpToทำงานอย่างสอดคล้องกันเมื่อปลายทางเป็นองค์ประกอบ<navigation>b/116831650- แก้ไขข้อบกพร่องหลายรายการที่ส่งผลให้เกิด
IllegalArgumentExceptionเมื่อใช้กราฟที่ซ้อนกัน b/118713731 b/113611083 b/113346925 b/113305559 - ตอนนี้แอตทริบิวต์
dataPatternของปลายทาง<activity>จะป้อนอาร์กิวเมนต์จากอาร์กิวเมนต์ที่ไม่ใช่สตริงโดยการเรียกใช้toString()b/120161365
Safe Args
- Safe Args รองรับออบเจ็กต์ที่ทำให้เป็นอนุกรมได้ ซึ่งรวมถึงค่า Enum ประเภท Enum
สามารถตั้งค่าเริ่มต้นได้โดยใช้ลิเทอรัล Enum โดยไม่มีชื่อคลาส
(เช่น
app:defaultValue="READ") b/111316353 - Safe Args รองรับอาร์เรย์ของประเภทที่รองรับทั้งหมด b/111487504
- ตอนนี้ Safe Args จะละเว้นโฟลเดอร์ย่อยของไดเรกทอรีทรัพยากร b/117893516
- Safe Args เพิ่มคำอธิบายประกอบ
@Overrideตามความเหมาะสม b/117145301
เวอร์ชัน 1.0.0-alpha07
29 ตุลาคม 2018
ฟีเจอร์ใหม่
- คลาส AppBarConfiguration ใหม่ช่วยให้คุณปรับแต่งปลายทางที่ถือว่าเป็นปลายทางระดับบนสุดได้ ดูรายละเอียดได้ในเอกสารประกอบที่อัปเดตแล้ว b/117333663
- ตอนนี้คุณสามารถส่งอาร์กิวเมนต์ไปยังปลายทางเริ่มต้นของกราฟได้แล้ว b/110300470
- ตอนนี้ Deep Link รองรับรูปแบบที่กำหนดเองซึ่งมีจุด เครื่องหมายขีดกลาง และเครื่องหมายบวกแล้ว b/112806402
การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
- โมดูล
navigation-testing-ktxได้รวมเข้ากับnavigation-testing artifactแล้ว และจะไม่มีการเผยแพร่อีกต่อไป - ตอนนี้อาร์ติแฟกต์
navigation-testingมีทรัพยากร Dependency ในไลบรารีมาตรฐาน Kotlin API มีการเปลี่ยนแปลงเพื่อให้สอดคล้องกับรูปแบบของ Kotlin มากขึ้น แต่คุณยังคงใช้ API นี้สำหรับการทดสอบที่เขียนด้วย Java ต่อไปได้ - ระบบไม่รองรับกราฟการนำทางที่ลงทะเบียนด้วยไฟล์ Manifest ของข้อมูลเมตาอีกต่อไป b/118355937
- แนบการดำเนินการกับปลายทาง <activity> ไม่ได้อีกต่อไป aosp/785539
แก้ไขข้อบกพร่อง
- ตอนนี้ Deep Link แยกวิเคราะห์พารามิเตอร์การค้นหาได้อย่างถูกต้องแล้ว b/110057514
- ตอนนี้ปลายทางกิจกรรมใช้ภาพเคลื่อนไหวสำหรับการเข้าและออกทั้งหมดอย่างถูกต้องแล้ว b/117145284
- แก้ไขข้อขัดข้องที่เกิดขึ้นหลังจากการเปลี่ยนแปลงการกำหนดค่าเมื่อใช้ Navigator ที่กำหนดเอง b/110763345
Safe Args
- ตอนนี้ Safe Args มีทรัพยากร Dependency แบบคงที่ในปลั๊กอิน Android Gradle 3.2.1 b/113167627
- ตอนนี้คุณสามารถสร้างเส้นทางสำหรับคลาสภายในได้แล้ว b/117407555
- แก้ไขปัญหาเกี่ยวกับการสร้างเส้นทางไปยังกราฟ <include> b/116542123
เวอร์ชัน 1.0.0-alpha06
20 กันยายน 2018
ฟีเจอร์ใหม่
- ตอนนี้ระบบรองรับองค์ประกอบแบบใช้ร่วมกันในการเปลี่ยนภาพสำหรับปลายทาง Fragment และ Activity แล้ว b/79665225 ดูข้อมูลเพิ่มเติมได้ที่ใช้การนําทางด้วยคอมโพเนนต์สถาปัตยกรรมการนําทาง
- การเลือกรายการใน
NavigationViewจะปิด Bottom Sheet ที่มีอยู่ b/112158843
การเปลี่ยนแปลง API
- การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ: ตอนนี้เมธอด Navigator
navigate()จะใช้พารามิเตอร์Navigator.Extras - เมธอด
getGraph()ของ NavController เปลี่ยนเป็นNonNullแล้ว b/112243286
แก้ไขข้อบกพร่อง
NavigationUI.setupWithNavController()จะไม่ทำให้ข้อมูลรั่วไหลอีกต่อไปหากใช้กับข้อมูลพร็อพเพอร์ตี้จากปลายทางแต่ละรายการ b/111961977- ตอนนี้ Navigator
onSaveState()จะเรียกใช้เพียงครั้งเดียว b/112627079
Safe Args
- ตอนนี้คลาส Directions ของจุดหมายการนำทางจะขยายคลาส Directions ของระดับบนหากมี b/79871405
- ตอนนี้คลาส Directions และ Args มีการใช้งาน
toString()ที่เป็นประโยชน์ b/111843389
เวอร์ชัน 1.0.0-alpha05
10 สิงหาคม 2018
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องที่ทำให้เกิดลักษณะการทำงานของ Backstack ที่ไม่ถูกต้อง b/111907708
- แก้ไขข้อบกพร่องใน
equals()ของคลาส Generated Args b/111450897 - แก้ไขข้อผิดพลาดในการสร้างใน Safe Args b/109409713
- แก้ไขการแปลงจากตัวระบุทรัพยากรเป็นชื่อ Java b/111602491
- แก้ไขข้อความแสดงข้อผิดพลาดเกี่ยวกับความสามารถในการเป็นค่า Null ในปลั๊กอิน Safe Args
- เพิ่มคำอธิบายประกอบความสามารถในการเป็นค่า Null ที่ขาดหายไป
เวอร์ชัน 1.0.0-alpha04
19 กรกฎาคม 2018
Navigation 1.0.0-alpha04 และปลั๊กอิน Safe Args Gradle ที่เกี่ยวข้องมีการเปลี่ยนแปลง API, การเปลี่ยนแปลงลักษณะการทำงาน และการแก้ไขข้อบกพร่องหลายรายการ
การเปลี่ยนแปลง API/ลักษณะการทำงาน
- NavHostFragment จะตั้งค่า Fragment ปัจจุบันเป็น Fragment การนำทางหลักเสมอ เพื่อให้มั่นใจว่า Fragment Manager ย่อยจะปรากฏขึ้นก่อนที่ NavController ภายนอกจะปรากฏขึ้น b/111345778
Safe Args
- การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ:
app:typeเปลี่ยนเป็นapp:argTypeเพื่อหลีกเลี่ยงความขัดแย้งกับไลบรารีอื่นๆ เช่น ConstraintLayout 2.0.0-alpha1 b/111110548 - ข้อความแสดงข้อผิดพลาดจาก Safe Args คลิกได้แล้ว b/111534438
- ตอนนี้คลาส Args จะยืนยันว่าแอตทริบิวต์
NonNullไม่ใช่ค่า Null จริงๆ b/111451769 - เพิ่มคำอธิบายประกอบ
NonNullเพิ่มเติมลงในคลาสที่สร้างขึ้น NavDirections และ Args b/111455455 b/111455456
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาเกี่ยวกับปุ่มย้อนกลับของระบบหลังจากทำ Deep Link ไปยังปลายทาง Fragment b/111515685
เวอร์ชัน 1.0.0-alpha03
12 กรกฎาคม 2018
Navigation 1.0.0-alpha03 และปลั๊กอิน Safe Args Gradle ที่เกี่ยวข้องมีการเปลี่ยนแปลง API, การเปลี่ยนแปลงลักษณะการทำงาน และการแก้ไขข้อบกพร่องหลายรายการ
การเปลี่ยนแปลง API/ลักษณะการทำงาน
- เพิ่มเมธอด NavigationUI.setupWithNavController สำหรับแถบเครื่องมือแล้ว b/109868820
- เพิ่มเมธอด NavigationUI.setupWithNavController สำหรับ CollapsingToolbarLayout แล้ว b/110887183
- ตอนนี้ popBackStack() จะแสดงผลเป็นเท็จเมื่อ Back Stack ว่างเปล่าหรือเมื่อรหัสปลายทางที่ระบุไม่อยู่ใน Back Stack b/110893637
- ตอนนี้ FragmentNavigator จะละเว้นการดำเนินการนำทางหลังจาก FragmentManager บันทึกสถานะแล้ว เพื่อหลีกเลี่ยงข้อยกเว้น "ไม่สามารถดำเนินการนี้หลังจาก onSaveInstanceState" b/110987825
Safe Args
- การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ: อักขระที่ไม่ใช่ตัวอักษรและตัวเลขคละกันในชื่อการดำเนินการและอาร์กิวเมนต์จะถูกแทนที่ด้วยการเขียนแบบ Camel Case ในชื่อเมธอด NavDirections ที่เกี่ยวข้อง
- เช่น
DemoController.indexจะกลายเป็นsetDemoControllerIndexb/79995048 - เช่น
action_show_settingsจะกลายเป็นactionShowSettingsb/79642240
- เช่น
- การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ: ตอนนี้ระบบจะถือว่าอาร์กิวเมนต์เป็นค่าที่ไม่ใช่ Null โดยค่าเริ่มต้น หากต้องการอนุญาตค่า Null ในอาร์กิวเมนต์สตริงและ Parcelable ให้เพิ่ม
app:nullable="true"b/79642307 - ตอนนี้คุณสามารถใช้
app:type="long"กับ defaultValues ในรูปแบบ "123L" b/79563966 ได้แล้ว - ตอนนี้ระบบรองรับอาร์กิวเมนต์ Parcelable แล้ว โดยใช้ชื่อคลาสที่สมบูรณ์ในตัวเองสำหรับ
app:typeค่าเริ่มต้นเดียวที่รองรับคือ"@null"b/79563966 - ตอนนี้คลาส Args จะใช้
equals()และhashCode()b/79642246 - ตอนนี้คุณสามารถใช้ปลั๊กอิน Safe Args กับโปรเจ็กต์ไลบรารีได้แล้ว b/80036553
- ตอนนี้คุณสามารถใช้ปลั๊กอิน Safe Args กับโปรเจ็กต์ฟีเจอร์ได้แล้ว b/110011752
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาเมื่อไปยังส่วนต่างๆ ระหว่างเมธอดวงจรของ Fragment b/109916080
- แก้ไขปัญหาเมื่อไปยังส่วนต่างๆ ของกราฟที่ซ้อนกันหลายครั้ง b/110178671
- แก้ไขปัญหาเมื่อใช้
setPopUpToกับปลายทางแรกในกราฟ b/109909461 - แก้ไขปัญหาที่ระบบส่งค่า
app:defaultValueทั้งหมดเป็นสตริง b/110710788 - ตอนนี้ aapt2 ที่มาพร้อมกับปลั๊กอิน Android Gradle 3.2 เบต้า 01 จะเพิ่มกฎการเก็บรักษาสำหรับแอตทริบิวต์
android:nameทุกรายการในไฟล์ XML การนำทาง b/79874119 - แก้ไขหน่วยความจำรั่วไหลเมื่อแทนที่ FragmentNavigator เริ่มต้น b/110900142
เวอร์ชัน 1.0.0-alpha02
7 มิถุนายน 2018
การเปลี่ยนแปลงพฤติกรรม
ตอนนี้
FragmentNavigatorใช้setReorderingAllowed(true)แล้ว b/109826220ตอนนี้การนําทางจะถอดรหัส URL ของอาร์กิวเมนต์ที่แยกวิเคราะห์จาก URL ของ Deep Link b/79982454
แก้ไขข้อบกพร่อง
แก้ไข
IllegalStateExceptionเมื่อเรียกใช้การนำทางจากเมธอดวงจรของ Fragment b/79632233ตอนนี้การนำทางจะขึ้นอยู่กับ Support Library 27.1.1 เพื่อแก้ไขการกะพริบเมื่อใช้ภาพเคลื่อนไหว b/80160903
แก้ไข
IllegalArgumentExceptionเมื่อใช้ defaultNavHost="true" เป็น Fragment ย่อย b/79656847แก้ไข
StackOverflowErrorเมื่อใช้ NavDeepLinkBuilder b/109653065แก้ไข
IllegalArgumentExceptionเมื่อกลับไปยังกราฟที่ซ้อนกัน b/80453447แก้ไขปัญหา Fragment ซ้อนทับกันเมื่อใช้
launchSingleTopb/79407969ตอนนี้ Navigation จะสร้าง Back Stack สังเคราะห์ที่ถูกต้องสำหรับกราฟที่ฝัง b/79734195
ตอนนี้ NavigationUI จะไฮไลต์รายการที่ถูกต้องเมื่อใช้กราฟที่ฝังเป็น
MenuItemb/109675998
การเปลี่ยนแปลง API
แอตทริบิวต์
clearTaskสำหรับการดำเนินการและ API ที่เกี่ยวข้องในNavOptionsเลิกใช้งานแล้ว b/80338878แอตทริบิวต์
launchDocumentสำหรับการดำเนินการและ API ที่เกี่ยวข้องในNavOptionsเลิกใช้งานแล้ว b/109806636
เวอร์ชัน 1.0.0-alpha01
8 พฤษภาคม 2018
Navigation มีเฟรมเวิร์กสำหรับการสร้างการนำทางในแอป เวอร์ชันแรกนี้คือ 1.0.0-alpha01