การนำทาง

Navigation เป็นเฟรมเวิร์กสำหรับการไปยังส่วนต่างๆ ระหว่าง "ปลายทาง" ภายในแอปพลิเคชัน Android ที่มี API ที่สอดคล้องกัน ไม่ว่าปลายทางจะติดตั้งใช้งานเป็น Fragment, Activity หรือคอมโพเนนต์อื่นๆ ก็ตาม
อัปเดตล่าสุด รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า รุ่นอัลฟ่า
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

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 และ 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: แก้ไข NavDestination NullPointerException เมื่ออัปเดต 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)
  • แก้ไข NavDestination NullPointerException เมื่ออัปเดต 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

ฟังก์ชันนี้ใช้ 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 มี LocalFragment CompositionLocal สำหรับเมธอด 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 ซึ่งรวมถึง NavGraph startDestinations ที่ฝังอยู่ด้วย (I0e0b5, b/109505019, b/188693139)

การเปลี่ยนแปลง API

  • เพิ่มคลาส CollectionNavType<T> นามธรรมใหม่ ซึ่งเป็นคลาสย่อยของ NavType<T> สำหรับอาร์กิวเมนต์ที่อิงตามคอลเล็กชัน เช่น รายการ อาร์เรย์ แผนที่ (Ic6d63, b/188693139)
  • ตอนนี้อาร์เรย์ NavType เริ่มต้นทั้งหมด (IntArrayType, LongArrayType, FloatArrayType, BoolArrayType และ StringArrayType) เป็นประเภท CollectionNavType (Idcf79, b/188693139)
  • ตอนนี้ NavType มี API valueEquals แบบเปิดใหม่ที่กำหนดว่าค่า 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)

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาในการนำทางที่ทำให้ NavGraph ViewModels เป็น DESTROYED เร็วเกินไปเนื่องจาก ViewModel ของรายการที่เชื่อมโยงไม่ได้เป็นส่วนหนึ่งของสถานะที่บันทึกไว้ (Ib6bb7, b/317581849)

การอัปเดตทรัพยากร Dependency

เวอร์ชัน 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 มีคอมมิตเหล่านี้

แก้ไขข้อบกพร่อง

  • ตอนนี้ฟังก์ชัน NavGraph equals() จะพิจารณาโหนดของกราฟอื่นๆ อย่างถูกต้อง แทนที่จะพิจารณาเฉพาะโหนดที่เรียกใช้ การดำเนินการนี้จะช่วยให้มั่นใจได้ว่ากราฟที่มีโหนดซึ่งมีรหัสต่างกันจะไม่ถือว่าเท่ากันอีกต่อไป (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 Callback RESUMED (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.DESTROYED ViewModel (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 และ ExitTransition lambda ที่สร้างขึ้นเป็นส่วนหนึ่งของ 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 ที่ว่างเปล่าโดยใช้ navDeepLink Kotlin DSL จะส่งผลให้เกิดคำเตือน Lint ที่ระบุว่า Deep Link ต้องมี URI, การดำเนินการ และ/หรือประเภท MIME จึงจะถูกต้อง

การเปลี่ยนแปลงที่สำคัญในการนำทางด้วย Fragment ตั้งแต่เวอร์ชัน 2.5.0

  • NavHostFragment จะไม่ขัดจังหวะปุ่มย้อนกลับของระบบอีกต่อไป ซึ่งจะช่วยให้ FragmentManager ที่สำคัญจัดการการย้อนกลับของระบบได้ ซึ่งจะช่วยให้ Fragment 1.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 ซึ่งหมายความว่าตอนนี้ NavBackStackEntry Lifecycle จะรอให้เอฟเฟกต์พิเศษของ Fragment ที่เข้าและออกทำงานเสร็จก่อนที่จะย้าย Lifecycle.State สุดท้าย
  • ตอนนี้ DialogFragmentNavigator จะใช้ API การเปลี่ยนผ่านเมื่อไปยังส่วนต่างๆ และแสดง NavBackStackEntries ซึ่งหมายความว่า NavBackStackEntry Lifecycle จะรอให้ DialogFragment Lifecycle ย้ายไปที่ 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 จะกลับไปที่ RESUMED Lifecycle.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.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

  • ตอนนี้โอเวอร์โหลด NavController navigate ทั้งหมดจะมีคำอธิบายประกอบเป็น @MainThread เพื่อให้แน่ใจว่ามีการเรียกใช้ในเทรดหลัก (I2c0b0, b/263427111)

แก้ไขข้อบกพร่อง

  • แก้ไขข้อขัดข้องเมื่อพยายามไปยังส่วนต่างๆ ขณะใช้การไปยังส่วนต่างๆ ของ Fragment แบบไดนามิก (I3ee29, b/268360479)
  • แก้ไขข้อบกพร่องที่การไปยังส่วนต่างๆ ของ Fragment อื่นผ่านปุ่มย้อนกลับของระบบไม่อัปเดตแถบด้านล่างเป็นรายการที่เลือกที่ถูกต้อง (If559f, b/269044426)

ปัญหาที่ทราบ

  • เมื่อใช้การนําทางกับ Fragment วงจรของ NavBackStackEntry จะไม่ถึง RESUMED เมื่อใช้ API Animation (b/269646882)
  • เมื่อใช้การนำทางกับ Fragment และนำทางด้วย BottomNavigation หากคุณพยายามกู้คืน Back Stack ที่มีหลายรายการ ระบบจะอัปเดต BottomMenuItem ไม่ถูกต้อง (b/270447657)
  • เมื่อใช้การนําทางกับ Fragment หลังจากคืนค่าสถานะแล้ว NavBackStackEntry Lifecycle จะไม่ได้รับ 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 ซึ่งหมายความว่าตอนนี้ NavBackStackEntry Lifecycle จะรอให้เอฟเฟกต์พิเศษของ Fragment ที่เข้าและออกทำงานเสร็จก่อนที่จะย้าย Lifecycle.State สุดท้าย (I3cb19, b/238686802)
  • ตอนนี้ DialogFragmentNavigator จะใช้ API การเปลี่ยนผ่านเมื่อไปยังส่วนต่างๆ และแสดง NavBackStackEntries ซึ่งหมายความว่า NavBackStackEntry Lifecycle จะรอให้ DialogFragment Lifecycle ย้ายไปที่ DESTROYED ก่อนที่จะย้ายไปที่ DESTROYED เอง (I53ee5, b/261213893)

การเปลี่ยนแปลง API

  • ตอนนี้ NavigatorState มี prepareForTransition API เพื่ออนุญาตให้ Navigator ย้าย NavBackStackEntries ไปยัง Lifecycle.State ระดับกลาง (I42c21, b/238686802)
  • ตอนนี้คุณสามารถเข้าถึง Back Stack ที่เชื่อมโยงกับ NavGraphNavigator หรือ ComposeNavigator ผ่านพร็อพเพอร์ตี้ backstack ได้แล้ว ตอนนี้ ComposeNavigator ยังแสดง Callback onTransitionComplete() เพื่อทำเครื่องหมาย NavBackStackEntry ที่ดำเนินการนำทางหรือการดำเนินการ popBackStack ว่าเสร็จสมบูรณ์แล้ว (I02062, I718db, b/257519195)

แก้ไขข้อบกพร่อง

  • ตอนนี้สถานะ Navigator จะไม่ทำงานเมื่อใช้ push/popWithTransition API และมีการจัดการรายการอยู่แล้ว (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 ที่ว่างเปล่าโดยใช้ navDeepLink Kotlin 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

เวอร์ชัน 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 ของ Lifecycle 2.5.0 ได้แล้ว

Navigation SafeArgs

  • Navigation Safe Args ได้อัปเกรดทรัพยากร Dependency ของ Android Gradle Plugin ให้ใช้ 7.0.4 ซึ่งทำให้ไม่สามารถใช้งานร่วมกับ AGP เวอร์ชันก่อน 7.0 ได้
  • เพิ่มการรองรับแอตทริบิวต์ build.gradle ของเนมสเปซเพื่อใช้แทน applicationId

การเปลี่ยนแปลงอื่นๆ

  • visibleEntries API ไม่ได้อยู่ในขั้นทดลองอีกต่อไป และมีฟังก์ชันในการดึงข้อมูลรายการทั้งหมดที่มีปลายทางที่มองเห็นได้ในปัจจุบันตาม 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)
  • ตอนนี้ visibleEntries StateFlow ที่ 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 ซึ่งเปิดตัวเป็นส่วนหนึ่งของ Lifecycle 2.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 ให้ใช้คลาสใหญ่สุดที่เปิดตัวใน Material 1.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 (ผ่าน API viewModel() ของ Lifecycle ViewModel Compose 2.4.0 หรือ hiltViewModel() ของ Hilt Navigation Compose 1.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” />
    
  • ใน navOptions Kotlin DSL คุณสามารถเพิ่มพร็อพเพอร์ตี้บูลีน restoreState และพร็อพเพอร์ตี้บูลีน saveState ใน popUpTo builder ได้ดังนี้

    // 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() ซึ่งเป็น เมธอดที่อัปเดต NavBackStackEntry Lifecycle เป็น @MainThread เพื่อปรับการนำทางให้สอดคล้องกับการบังคับใช้ เทรดหลักที่เปิดตัวใน Lifecycle 2.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

  • ตอนนี้ visibleEntries API อยู่ในขั้นทดลอง (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 อย่างถูกต้อง ซึ่งหมายความว่าการเรียกใช้ API dismiss() แบบอะซิงโครนัสด้วยตนเองสำหรับ 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 ที่มองเห็นได้ทั้งหมดผ่าน visibleEntries StateFlow (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

  • ตอนนี้ฟังก์ชัน navArgument Kotlin DSL เป็นส่วนหนึ่งของ navigation-common แทนที่จะเป็น navigation-compose ซึ่งจะต้องอัปเดตการนำเข้าเพื่อใช้ฟังก์ชันนี้ต่อไป (I1d095)

การเปลี่ยนแปลงพฤติกรรม

  • เมื่อสร้างอาร์กิวเมนต์ ตอนนี้ Safe Args จะวางพารามิเตอร์ที่ไม่มีค่าเริ่มต้นไว้ก่อนพารามิเตอร์ที่มีค่าเริ่มต้น (I89709, b/198493585)

แก้ไขข้อบกพร่อง

  • เมื่อใช้ Navigation Compose ระบบจะDESTROYED NavGraph ก็ต่อเมื่อDESTROYEDองค์ประกอบย่อยทั้งหมดแล้วเท่านั้น (I86552, b/198741720)
  • อาร์กิวเมนต์ NavDeepLink ที่เป็นค่า Null ได้ไม่จำเป็นต้องมีค่าเริ่มต้นอีกต่อไป (Ia14ef, b/198689811)
  • ตอนนี้การเรียกใช้ setGraph() ด้วยกราฟใหม่จะล้าง Back Stack ที่บันทึกไว้ด้วย นอกเหนือจากลักษณะการทำงานก่อนหน้านี้ในการแสดง Back Stack (I97f96)
  • แก้ไขปัญหาที่อินสแตนซ์ OnDestinationChangedListener และ currentBackStackEntryFlow ไม่ได้รับการแจ้งเตือนเมื่อใช้ launchSingleTop (Iaaebc)

การอัปเดตทรัพยากร Dependency

เวอร์ชัน 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 แล้ว ปลายทางของกล่องโต้ตอบเหล่านี้จะแสดงภายใน Composable Dialog ซึ่งลอยอยู่เหนือปลายทาง 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 ที่กำหนดเองสามารถใช้ API pushWithTransaction และ 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)’’ เมื่อใช้ Gradle 6.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 ได้รับการอัปเดตให้ใช้คลาสใหญ่สุดที่เปิดตัวใน Material 1.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 ใช้ API NavigatorState.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” />
    
  • ใน navOptions Kotlin DSL คุณสามารถเพิ่มพร็อพเพอร์ตี้บูลีน restoreState และพร็อพเพอร์ตี้บูลีน saveState ใน popUpTo builder ได้ดังนี้

    // 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 ดังนี้

  • เลิกใช้งานพร็อพเพอร์ตี้ popUpTo kotlin ใน 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() ซึ่งเป็น เมธอดที่อัปเดต NavBackStackEntry Lifecycle เป็น @MainThread เพื่อปรับการนำทางให้สอดคล้องกับการบังคับใช้ เทรดหลักที่เปิดตัวใน Lifecycle 2.3.0 (b/171125856)
  • ตอนนี้การแยกวิเคราะห์อาร์กิวเมนต์ Enum จาก Deep Link จะไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ ซึ่งช่วยให้ Deep Link เช่น http://www.example.com/red ตรงกับ Deep Link www.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)

เวอร์ชัน 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 จะป้อนข้อมูล LocalSavedStateRegistryOwner CompositionLocal ด้วย 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 เป็นปลายทางในแอปพลิเคชัน

โดยเวอร์ชันแรกนี้จะประกอบด้วยสิ่งต่อไปนี้

  • NavHost Composable ที่ช่วยให้คุณสร้างกราฟการนำทางผ่าน 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 ทั่วไปมากขึ้นซึ่งเพิ่มเข้ามาใน CustomView 1.1.0 และใช้งานโดย DrawerLayout ใน DrawerLayout 1.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

เวอร์ชัน 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 จะแสดง defaultArguments Map สำหรับการดำเนินการ ซึ่งสะท้อนถึงความสามารถในการตั้งค่าเริ่มต้นในองค์ประกอบ <action> ในไฟล์ XML ของการนำทาง (b/150345605)

แก้ไขข้อบกพร่อง

  • จาก Navigation 2.2.2: แก้ไข IllegalStateException เมื่อทำ Deep Link ไปยังปลายทางเริ่มต้นของกราฟเมื่อคุณมีอินสแตนซ์ NavHostFragment หลายรายการในกิจกรรม (b/147378752)

การอัปเดตทรัพยากร Dependency

เวอร์ชัน 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 อินเทอร์เฟซที่เปิดตัวใน CustomView 1.1.0-alpha02 (ซึ่ง DrawerLayout จะใช้ตั้งแต่ DrawerLayout 1.1.0-alpha04) ซึ่งช่วยให้คุณใช้การติดตั้งใช้งาน Openable ที่กำหนดเองกับ NavigationUI ได้ (b/129030452)

แก้ไขข้อบกพร่อง

  • ตอนนี้กฎ ProGuard ของ navigation-common-ktx จะเก็บเฉพาะคลาส NavArgs ที่ใช้เท่านั้นอย่างถูกต้อง แทนที่จะเก็บอินสแตนซ์ NavArgs ทั้งหมด (b/150213558)

การเปลี่ยนแปลงทรัพยากร Dependency

  • Navigation ได้เปลี่ยนกลับไปใช้ทรัพยากร Dependency ใน Core 1.2.0 และตอนนี้ขึ้นอยู่กับ Core 1.1.0 เพื่อหลีกเลี่ยงการบังคับให้นักพัฒนาแอปย้ายไปใช้ทรัพยากร Dependency ที่ใหม่กว่าเมื่อ Navigation ไม่ได้ขึ้นอยู่กับ API ใหม่ใน Core 1.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: กฎ ProGuard navigation-ui ข้อสำหรับ DrawerArrowDrawable ได้รับการอัปเดตเพื่อให้แน่ใจว่าไม่จำเป็นต้องใช้ android.enableJetifier=true (b/147610424)
  • จาก Navigation 2.2.1: ตอนนี้โมดูล navigation-common-ktx มีชื่อแพ็กเกจไฟล์ Manifest ที่ไม่ซ้ำกัน แทนที่จะใช้ชื่อแพ็กเกจไฟล์ Manifest เดียวกันกับ navigation-runtime-ktx (aosp/1141947)

การอัปเดตทรัพยากร Dependency

เวอร์ชัน 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

เวอร์ชัน 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

เวอร์ชัน 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 ใช้ให้ตรงกับภาพเคลื่อนไหวแบบเลือนที่ปรับแล้วใน Fragment 1.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 SavedState 1.0.0-rc03, Activity 1.1.0-rc03 และ Fragment 1.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)
  • เมื่อใช้ Toolbar NavigationUI จะไม่แสดงภาพเคลื่อนไหวของการเปลี่ยนแปลงข้อความอีกต่อไปเมื่อย้ายระหว่างปลายทางระดับบนสุด 2 แห่ง (b/140848160)

เวอร์ชัน 2.2.0-alpha03

18 กันยายน 2019

androidx.navigation:navigation-*:2.2.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.2.0-alpha03 มีคอมมิตเหล่านี้

การเปลี่ยนแปลงพฤติกรรม

  • ตอนนี้การเรียกใช้ setViewModelStore() หลังจากเรียกใช้ setGraph จะส่งผลให้เกิด IllegalStateException NavHost ควรตั้งค่านี้เสมอโดยเป็นส่วนหนึ่งของการตั้งค่าเริ่มต้น เพื่อให้แน่ใจว่าอินสแตนซ์ 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 หรือโดยใช้ API getViewModelStoreOwner() ที่เพิ่มลงใน 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 อย่างถูกต้องเมื่อสกัดกั้นเหตุการณ์ปุ่มย้อนกลับของระบบ ซึ่งแก้ไขการถดถอยใน Navigation 2.1.0-alpha03 b/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 ที่กำหนดเองเมื่อสร้างคลาสย่อย NavHostFragment b/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 ที่เพิ่มลงใน NavController b/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_TASK b/126082008
  • แก้ไขปัญหาที่ ActivityNavigator.applyPopAnimationsToPendingTransition ไม่ใช้ภาพเคลื่อนไหวเมื่อกดออกที่ถูกต้อง b/126237567
  • ตอนนี้โค้ด Kotlin ที่สร้างโดย Safe Args จะกำหนดอักขระหลีกสำหรับคีย์เวิร์ด Kotlin อย่างเหมาะสม เช่น in และ fun ในชื่อแพ็กเกจที่เชื่อมโยงกับคลาส R b/126020455

เวอร์ชัน 1.0.0-rc01

21 กุมภาพันธ์ 2019

นี่คือรุ่นที่อาจได้รับการเผยแพร่สำหรับเวอร์ชันเสถียร 1.0.0 ของ Navigation รุ่นนี้มีการแก้ไขข้อบกพร่อง 1 รายการ

แก้ไขข้อบกพร่อง

  • แก้ไขปัญหาเมื่อใช้ Fragment และการดำเนินการนำทาง singleTop b/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-beta01 b/123933201
  • ตอนนี้ Navigation จะตั้งค่า ClassLoader อย่างถูกต้องระหว่างการกู้คืนสถานะอินสแตนซ์ที่บันทึกไว้ เพื่อหลีกเลี่ยงปัญหาเมื่อใช้คลาสที่กำหนดเองในสถานะที่บันทึกไว้ของ Navigator หรือในอาร์กิวเมนต์ที่ส่งไปยัง NavDestination b/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 ที่สร้างขึ้นคือ NavDirections b/123233147
  • คลาส Directions ที่สร้างโดย Safe Args ไม่มีคอนสตรัคเตอร์สาธารณะอีกต่อไป คุณควรโต้ตอบกับเมธอดแบบคงที่ที่สร้างขึ้นเท่านั้น b/123031660
  • คลาส NavDirections ที่สร้างโดย Safe Args ไม่มีเมธอดคอนสตรัคเตอร์แบบสาธารณะอีกต่อไป โดยควรสร้างผ่านเมธอดแบบคงที่ในคลาส Directions ที่สร้างขึ้นเท่านั้น b/122963206
  • ตอนนี้ Bundle ที่ส่งคืนจาก getArguments() ของ NavDirections ได้รับการทำเครื่องหมายเป็น @NonNull แทนที่จะเป็น @Nullable b/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 อีกต่อไปเมื่อใช้กับเมธอด NavigationUI b/120104424
  • ตอนนี้ AppBarConfiguration ให้คุณตั้งค่าอินสแตนซ์ OnNavigateUpListener สำรองซึ่งจะถูกเรียกใช้เมื่อ navController.navigateUp() แสดงผล false b/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 ได้รับการกำหนดให้เป็น final aosp/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

ฟีเจอร์ใหม่

การเปลี่ยนแปลง 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 จะกลายเป็น setDemoControllerIndex b/79995048
    • เช่น action_show_settings จะกลายเป็น actionShowSettings b/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 ซ้อนทับกันเมื่อใช้ launchSingleTop b/79407969

  • ตอนนี้ Navigation จะสร้าง Back Stack สังเคราะห์ที่ถูกต้องสำหรับกราฟที่ฝัง b/79734195

  • ตอนนี้ NavigationUI จะไฮไลต์รายการที่ถูกต้องเมื่อใช้กราฟที่ฝังเป็น MenuItem b/109675998

การเปลี่ยนแปลง API

  • แอตทริบิวต์ clearTask สำหรับการดำเนินการและ API ที่เกี่ยวข้องใน NavOptions เลิกใช้งานแล้ว b/80338878

  • แอตทริบิวต์ launchDocument สำหรับการดำเนินการและ API ที่เกี่ยวข้องใน NavOptions เลิกใช้งานแล้ว b/109806636

เวอร์ชัน 1.0.0-alpha01

8 พฤษภาคม 2018

Navigation มีเฟรมเวิร์กสำหรับการสร้างการนำทางในแอป เวอร์ชันแรกนี้คือ 1.0.0-alpha01