navigation3

  
Navigation 3 เป็นไลบรารีการนำทางใหม่ที่ออกแบบมาเพื่อทำงานร่วมกับ Compose
อัปเดตล่าสุด รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า รุ่นอัลฟ่า
4 พฤศจิกายน 2026 1.2.1 - - 1.3.0-alpha04

การประกาศทรัพยากร Dependency

หากต้องการเพิ่มทรัพยากร Dependency ใน navigation3 คุณต้องเพิ่มที่เก็บ Maven ของ Google ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมได้ที่ที่เก็บ Maven ของ Google

เพิ่มทรัพยากร Dependency สำหรับอาร์ติแฟกต์ที่ต้องการในไฟล์ build.gradle สำหรับแอปหรือโมดูล ดังนี้

Groovy

dependencies {
    implementation "androidx.navigation3:navigation3-runtime:1.3.0-alpha04"
    implementation "androidx.navigation3:navigation3-ui:1.3.0-alpha04"
}

Kotlin

dependencies {
    implementation("androidx.navigation3:navigation3-runtime:1.3.0-alpha04")
    implementation("androidx.navigation3:navigation3-ui:1.3.0-alpha04")
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับการขึ้นต่อกันได้ที่หัวข้อเพิ่มการขึ้นต่อกันของบิลด์

ความคิดเห็น

ความคิดเห็นของคุณช่วยปรับปรุง Jetpack ให้ดียิ่งขึ้น โปรดแจ้งให้เราทราบหากคุณพบปัญหาใหม่หรือมีแนวคิดในการปรับปรุงไลบรารีนี้ โปรดดูปัญหาที่มีอยู่ในคลังนี้ก่อนที่จะสร้างปัญหาใหม่ คุณสามารถโหวตปัญหาที่มีอยู่ได้โดยคลิกปุ่มดาว

สร้างปัญหาใหม่

ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของ Issue Tracker

เวอร์ชัน 1.3

เวอร์ชัน 1.3.0-alpha04

4 พฤศจิกายน 2026

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

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

  • แก้ไขปัญหาที่ NavEntry ที่แชร์ไม่แสดงผลบนหน้าจอเมื่อมีการแสดงขึ้นมาแล้วถูกพุชอีกครั้งก่อนที่การแสดงผลจะเสร็จสมบูรณ์ (I6a482)

เวอร์ชัน 1.3.0-alpha03

21 ตุลาคม 2569

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

ไม่มีการเปลี่ยนแปลงจาก 1.3.0-alpha02

เวอร์ชัน 1.3.0-alpha02

7 ตุลาคม 2569

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

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

  • คลาส SceneInfo ได้เพิ่มพร็อพเพอร์ตี้ title และ url ซึ่งระบบจะป้อนข้อมูลโดยอัตโนมัติจากข้อมูลเมตา NavEntry's ล่าสุดของฉาก ใช้ TitleMetadataKey และ UrlMetadataKey เพื่อกำหนดชื่อและ URL ปลายทางในข้อมูลเมตาของรายการ (I78a20, b/542693522)

เวอร์ชัน 1.3.0-alpha01

23 กันยายน 2569

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

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

  • แก้ไขการส่งต่อภาพเคลื่อนไหวของการย้อนกลับที่คาดการณ์ได้ใน NavDisplay โดยย้ายข้อมูลไปยัง DeferredAnimatedContent และแก้ไขปัญหาการส่งต่อการเปลี่ยนผ่าน I145eaedd b/430807423
    • DeferredAnimatedContent ใช้ DeferredTransition เพื่อแยกการเปลี่ยนภาพออกเป็นระยะที่เลื่อนออกไป (ผ่าน defer) ซึ่งจะใช้การเปลี่ยนรูปแบบด้วยตนเองระหว่างท่าทางสัมผัสการปัด และระยะอัตโนมัติ (ผ่าน animateTo) ซึ่งจะเรียกใช้การเปลี่ยนภาพเมื่อมีการปัด

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

  • ระบบจะแสดงผลองค์ประกอบที่ใช้ร่วมกันในฉากขาออกระหว่างการเปลี่ยนภาพแทนฉากขาเข้า (b/582354988)
  • องค์ประกอบที่แชร์จะไม่กรอในระหว่างระยะที่เลื่อนออกไป (ท่าทางสัมผัส)

เวอร์ชัน 1.2.1

4 พฤศจิกายน 2026

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

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

  • compileSdk ได้รับการดาวน์เกรดจาก 37 เป็น 36 เวอร์ชัน 1.2 ขึ้นอยู่กับ Compose 1.10 ซึ่งไม่จำเป็นต้องใช้ compileSdk 37

เวอร์ชัน 1.2.0

23 กันยายน 2569

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

1.2.0 เสถียรแล้ว

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

Result API

  • API ใหม่นี้ช่วยให้ส่งผลลัพธ์ระหว่าง NavEntries โดยใช้ ResultEventBus ที่ LocalResultEventBus และ ResultEventBusNavEntryDecorator มีให้ได้
  • เพิ่ม rememberResultEventBus เพื่อรองรับการยก ResultEventBus นอก ResultEventBusNavEntryDecorator และส่งไปยัง rememberResultEventBusNavEntryDecorator
  • ผลลัพธ์ที่ส่งเข้ามาสามารถเข้าถึงได้เป็นสถานะด้วย ResultEventBus#conflateAsState หรือรวบรวมเป็นโฟลว์ของผลลัพธ์ด้วย ResultEffect

Deep Link API

ตอนนี้ Navigation3 รองรับ Deep Link ของ Kotlin Multiplatform (KMP) ใน androidx.navigation3.runtime.deeplink ผ่าน DeepLinkRequest, DeepLinkUri และ DeepLinkMatcher แล้ว

  • DeepLinkRequest และ RequestExtras: แสดงคำขอ Deep Link ที่สร้างจาก DeepLinkUri, สตริง URI หรือ Intent ของ Android คุณสามารถแนบข้อมูลเมตาของคำขอเพิ่มเติมได้โดยใช้คอนเทนเนอร์ RequestExtras ที่ปลอดภัยในการกำหนดประเภท ซึ่งสร้างขึ้นด้วย requestExtras DSL และ RequestExtrasKey<T>
  • DeepLinkMatcher: แสดง Deep Link ที่จับคู่กับ DeepLinkRequest ได้ อินสแตนซ์ Matcher แต่ละรายการจะเชื่อมโยงกับคีย์การนําทางที่รองรับ Deep Link นี้ คีย์การนำทางสามารถเชื่อมโยงกับ Matcher ได้หลายรายการ การเรียกใช้ DeepLinkMatcher.match จะแสดงผล MatchResult ที่มีคีย์การนำทางที่เชื่อมโยงหากจับคู่สำเร็จ การใช้งาน DeepLinkMatcher เริ่มต้นมี 2 แบบ ได้แก่ UriDeepLinkMatcher สำหรับการจับคู่ Deep Link ตาม Uri และ StaticKeyDeepLinkMatcher สำหรับการจับคู่ Deep Link กับ DeepLinkMatcher.Filter เท่านั้นที่จับคู่ตามบูลีน
  • BackStackMatcher: DeepLinkMatcher เพื่อสร้าง Back Stack สังเคราะห์เมื่อจับคู่ Deep Link สำเร็จ คุณสร้าง BackStackMatcher ได้ผ่านฟังก์ชันส่วนขยาย DeepLinkMatcher.withBackStack

การจัดการการย้อนกลับที่คาดการณ์ได้

  • เพิ่ม NavigationBackHandler และ rememberNavigationEventState เพื่อให้เชื่อมต่อ SceneState กับการจัดการการย้อนกลับที่คาดการณ์ได้ (onBackCompleted และ onBackCancelled) ได้ง่ายขึ้น ซึ่งจะช่วยให้คอมโพเนนต์ UI ที่กำหนดเองรองรับการนำทางย้อนกลับมาตรฐานและท่าทางสัมผัสการย้อนกลับที่คาดการณ์ได้โดยไม่ต้องคำนวณเดลต้าของ Back Stack ด้วยตนเอง
  • ปรับปรุงการเปลี่ยนผ่านของการย้อนกลับที่คาดการณ์ได้ รวมถึงการรองรับท่าทางสัมผัสการย้อนกลับที่คาดการณ์ได้ซึ่งทริกเกอร์ระหว่างที่ภาพเคลื่อนไหวไปข้างหน้ากำลังทำงานอยู่

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

  • ตอนนี้ NavEntry.contentKey จะใช้ค่าเริ่มต้นเป็นองค์ประกอบของ key.toString() และ key::class.toString() เพื่อป้องกันไม่ให้คีย์ชนกันระหว่างคีย์ data object ที่ใช้ชื่อธรรมดาเดียวกันในอินเทอร์เฟซต่างๆ
  • ตอนนี้ EntryProvider จะจัดลำดับความสำคัญของการจับคู่ตามอินสแตนซ์คีย์มากกว่าประเภทคีย์
  • เพิ่มการตรวจสอบ Lint เพื่อให้แน่ใจว่าการติดตั้งใช้งาน Scene เป็น data class หรือติดตั้งใช้งาน equals และ hashCode

เวอร์ชัน 1.2.0-rc01

9 กันยายน 2569

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

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

  • ไม่อนุญาตให้ใช้ชื่อตัวยึดตำแหน่งที่ซ้ำกันในรูปแบบ URI ของ Deep Link (I8985c, b/522343165)

เวอร์ชัน 1.2.0-beta01

26 สิงหาคม 2026

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

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

  • เปลี่ยนโครงสร้างภายในโค้ด DeepLinkRequest.extras จาก Map<String, Any> เป็นคลาส RequestExtras ที่คล้ายแผนที่ซึ่งมีความปลอดภัยในการกำหนดประเภทใหม่ ซึ่งจัดเก็บคู่ของ RequestExtrasKey<T> ถึง T RequestExtras สามารถสร้างอินสแตนซ์ได้ด้วย requestExtras DSL (Ic929d, b/543883369)

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

  • แก้ไขปัญหาที่ท่าทางสัมผัสการย้อนกลับที่คาดการณ์ได้ซึ่งทริกเกอร์ระหว่างการเปลี่ยนไปข้างหน้าไม่เคลื่อนไหวเพื่อตอบสนองต่อความคืบหน้าของการปัด ตอนนี้การย้อนกลับที่คาดการณ์ได้จะแสดงภาพเคลื่อนไหวและทำงานอย่างถูกต้อง (Icdcb0, b/456218398)
  • เพิ่มการตรวจสอบ Lint เพื่อให้แน่ใจว่าการติดตั้งใช้งาน Scene เป็นคลาสข้อมูล หรือใช้ equals และ hashcode เพื่อให้แน่ใจว่ามีการใช้ Scene เดียวกันเมื่อเหมาะสม (Ibdf0d, b/542316099)
  • ตอนนี้ NavEntry.contentKey จะมีค่าเริ่มต้นเป็นองค์ประกอบของ key.toString() และ key::class.toString() วิธีนี้ช่วยให้มั่นใจได้ว่าออบเจ็กต์ข้อมูลที่ใช้ชื่อเดียวกันแต่ใช้อินเทอร์เฟซต่างกันจะไม่มี contentKey เดียวกันอีกต่อไป อย่างไรก็ตาม key::class ของแพลตฟอร์ม JS จะแสดงเฉพาะชื่อคลาสแบบง่ายแทนชื่อที่สมบูรณ์ในตัวเอง ดังนั้นแพลตฟอร์ม JS จึงควรใช้ contentKey ที่กำหนดเองสำหรับออบเจ็กต์ข้อมูลที่มีชื่อซ้ำกัน (I1fbbb, b/512534342)
  • แก้ไข IllegalArgumentException ที่เกิดจาก SaveableStateProvider สำหรับคีย์ที่ซ้ำกันซึ่งใช้ระหว่างการนำทางย้อนกลับอย่างรวดเร็วเมื่อมีการเปลี่ยนผ่านแบบป๊อปหลายรายการอยู่ระหว่างดำเนินการ (I4d728, b/516312097)

เวอร์ชัน 1.2.0-alpha07

29 กรกฎาคม 2569

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

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

  • เพิ่มคลาส WrappedMatchResult นามธรรมเพื่อรวม DeepLinkMatcher.MatchResult อื่น ซึ่งจะช่วยให้ผลการแข่งขันที่กำหนดเองแสดงซ้อนทับผลการแข่งขันอีกรายการหนึ่งได้ (I7d4dc, b/470282247)
  • เพิ่มคลาส BackStackMatcher ใหม่ซึ่งรับพารามิเตอร์ 2 รายการ ได้แก่ อินสแตนซ์ Matcher และ Lambda ของ Builder ที่ให้ผลลัพธ์การจับคู่ของ Matcher อินพุตและแสดงผล Back Stack เมื่อจับคู่สำเร็จ BackStackMatcher จะแสดงผล BackStackMatchResult ซึ่งขยาย WrappedMatchResult ที่มีผลการจับคู่เดิมพร้อมกับ Back Stack ที่สร้างด้วย Lambda BackStackMatcher จะสร้างได้ด้วยฟังก์ชันส่วนขยาย DeepLinkMatcher.withBackStack ใหม่เท่านั้น (Ibf987, b/470282247)

  • เพิ่มคลาส DeepLinkSerializer นามธรรมที่ขยาย KSerializer เพื่อเข้ารหัสและถอดรหัส value : T เป็น String DeepLinkSerializer สามารถใช้เพื่อจัดเรียงอาร์กิวเมนต์ Deep Link ที่ไม่ใช่แบบพื้นฐานได้ ใช้งานร่วมกับ rememberSaveable และ rememberNavBackStack ได้ (Id3c9f, b/470282247)

  • DeepLinkMatcher ได้เพิ่มพารามิเตอร์ประเภทที่ 2 out R : DeepLinkMatcher.MatchResult<T> เพื่อให้นักพัฒนาแอปเข้าถึงพร็อพเพอร์ตี้ของ MatchResult คลาสย่อยที่แสดงผลโดย DeepLinkMatcher.match() ได้โดยไม่ต้องแคสต์ประเภท (I693d3, b/470282247)

  • ขอบเขตบนของ DeepLinkMatcher.MatchResult's T เปลี่ยนจาก Any? เป็น Any (I6bf1a)

  • ตอนนี้ช่อง uri ของคอนสตรัคเตอร์ DeepLinkRequest มีค่าเริ่มต้นเป็น Null เปลี่ยนชื่อ uriString ของคอนสตรัคเตอร์รองเป็น uri แล้ว (Ia0f14, b/522194187)

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

  • ตอนนี้ ResultEffect ใช้ rememberUpdatedState เพื่อบันทึกแลมบ์ดา onResult ล่าสุด (I7d2a3, b/531709234)
  • แก้ไขการจับคู่ Deep Link สำหรับกลุ่มเส้นทางที่ว่างเปล่า หากประเภทอาร์กิวเมนต์เป็นสตริง ระบบจะถือว่าเส้นทางที่ว่างเปล่าเป็นค่าสตริงว่างเปล่า ไม่เช่นนั้น ระบบจะถือว่าเส้นทางที่ว่างเปล่าไม่มีค่าที่ระบุ และจะเปลี่ยนกลับไปใช้ค่าเริ่มต้น หากไม่มีค่าเริ่มต้น การจับคู่จะไม่สำเร็จ (I56575, b/535298128)
  • เพิ่มการรองรับค่าการค้นหาที่ว่างเปล่าใน DeepLinkRequest.uri หากอาร์กิวเมนต์เป็นประเภทสตริง ระบบจะถือว่าค่าว่างเป็นสตริงว่างตามตัวอักษร มิฉะนั้น ระบบจะถือว่าค่าที่ว่างเปล่าเป็นค่าที่ไม่ได้ระบุ และการจับคู่จะพยายามเปลี่ยนกลับไปใช้ค่าเริ่มต้น หากไม่มีค่าเริ่มต้น การจับคู่จะไม่สำเร็จ (I30343, b/535127459)
  • ตอนนี้ EntryProvider จะจัดลำดับความสำคัญของการจับคู่ตามอินสแตนซ์คีย์มากกว่าประเภทคีย์ (Ib5ec9, b/533331924)
  • ตอนนี้ SceneState จะคำนวณฉากก่อนหน้าอย่างถูกต้องโดยเริ่มจากฉากที่ไม่ใช่การวางซ้อนบนสุด (I91915, b/513630541)

เวอร์ชัน 1.2.0-alpha06

15 กรกฎาคม 2569

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

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

  • แก้ไขเอกสารประกอบ UriDeepLinkMatcher เกี่ยวกับส่วนย่อยของ URI เพื่อชี้แจงว่าส่วนย่อยที่มีไวลด์การ์ดจะตรงกับอินพุตใดๆ แต่อินพุตจะไม่ได้รับการดึงข้อมูลเป็นอาร์กิวเมนต์ (I5ad9b, b/524677091)
  • แก้ไขปัญหาที่ UriDeepLinkMatcher ไม่ตรงกับคำขอหากรูปแบบ URI ไม่มีสคีมหรือไม่ขึ้นต้นด้วยเครื่องหมายทับ 2 ตัว เช่น ตอนนี้ www.example.com/home จะจับคู่กับ http://www.example.com/home (Ia6b65, b/522791926)

เวอร์ชัน 1.2.0-alpha05

1 กรกฎาคม 2026

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

API ใหม่

  • เพิ่ม rememberResultEventBus API ซึ่งแสดงผล ResultEventBus ที่สามารถส่งไปยัง rememberResultEventBusNavEntryDecorator ได้ ซึ่งจะช่วยให้ยก ResultEventBus ออกจาก ResultEventBusNavEntryDecorator ได้ (Ia655b, b/516995400)

DeepLinkRequest

  • เพิ่มคอนสตรัคเตอร์ที่เข้ากันได้กับ KMP 2 รายการ ได้แก่ รายการที่ใช้ DeepLinkUri และรายการที่ใช้ URI สตริงดิบ (I3c088, b/513200887, b/522194187)
  • (Android เท่านั้น) เพิ่มคอนสตรักเตอร์ที่ใช้ Intent (Ia0498, b/513200887, b/522194187)
  • ตัวสร้างทั้งหมดมีช่อง extras เพิ่มเติมสำหรับ Map<String, Any> เพื่อแนบข้อมูลคำขอเพิ่มเติม (If81d5, b/513200887)
  • มีการเพิ่ม requestExtras dsl ใหม่เป็นวิธีที่ปลอดภัยในการกำหนดประเภทเพื่อสร้างแผนที่ของส่วนเสริม DSL มีฟังก์ชัน put เพื่อจัดเก็บคู่ของ RequestExtrasKey เป็น Any สามารถใช้ฟังก์ชันส่วนขยาย Map<String, Any>.get(key) เพื่ออ่านจากแผนที่ด้วย RequestExtrasKey(I5091c, b/513200887)
  • (Android เท่านั้น) เพิ่มฟังก์ชัน ActionExtrasKey และ actionExtra เพื่อสร้างแผนที่เพิ่มเติมด้วย ActionExtrasKey (Id0c90, [b/513200887]
  • เพิ่มฟังก์ชัน MimeTypeExtrasKey และ mimeTypeExtra เพื่อสร้างแผนที่เพิ่มเติมด้วย MimeTypeExtrasKey (I85131, b/513200887)

DeepLinkMatcher

  • เพิ่มฟังก์ชัน DeepLinkMatcher.mimeTypeFilter และ DeepLinkMatcher.actionFilter เพื่อสร้าง DeepLinkMatcher.Filters ที่กรอง DeepLinkRequest ตาม mimeType หรือ action (Android เท่านั้น) ตัวกรองทั้ง 2 รายการจะจับคู่ตามความเท่ากันของสตริงและไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ (Ie7e67, b/513191950)

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

DeepLinkRequest

  • นำฟังก์ชันโรงงาน fromAction ออก หากต้องการสร้างคำขอที่เชื่อมโยงกับการดำเนินการ ให้ใช้ช่อง DeepLinkRequest.extras ใหม่ (Id0c90, b/513200887)
  • นำฟังก์ชันโรงงาน fromMimeType ออกแล้ว หากต้องการสร้างคำขอที่เชื่อมโยงกับ mimeType ให้ใช้ช่อง DeepLinkRequest.extras ใหม่ (I85131, b/513200887)
  • (Android เท่านั้น) นำฟังก์ชันโรงงาน fromIntent ออกแล้ว แทนที่ด้วยตัวสร้างใหม่ที่ใช้ Intent และแมปเพิ่มเติม (Ia0498, b/513200887, b/522194187)
  • นำฟังก์ชันแฟกทอรี fromUri และ fromUriString ออกแล้ว แทนที่ด้วยตัวสร้างใหม่ที่ใช้ DeepLinkUri หรือ URI สตริงดิบ (Id5b6f, b/522194187)
  • ตอนนี้ DeepLinkMatcher, DeepLinkMatcher.MatchResult และคลาสย่อยจะใช้ T แบบ Covariant (out T) เพื่อให้คีย์แบบลำดับชั้นไม่จำเป็นต้องใช้การแคสต์ประเภทกับ Matcher (I1e453, b/525094876)
  • ตอนนี้พารามิเตอร์ตัวสร้าง UriMatchResult สำหรับแมปอาร์กิวเมนต์จะใช้ค่าเริ่มต้นเป็นแมปว่างเปล่า (I3acdd)
  • คลาสแอบสแตรกต์ DeepLinkMatcher.Filter เป็นอินเทอร์เฟซแบบฟังก์ชันแล้ว ระบบจะนำช่องตัวสร้าง filter ออก และควรส่งผ่านในคลาสย่อยโดยตรงแทน (I9eb7d, b/522194187)

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

  • แก้ไขปัญหารายการที่ป๊อปอัปหายไปทันทีเมื่อป๊อปอัปไปยังรายการที่มีข้อมูลเมตาที่ฝังอยู่ซึ่งมีค่า Lambda (Idb872, b/520494430)
  • แก้ไข UriDeepLinkMatcher เพื่อให้แสดงผล UriMatchResult เป็นค่าว่างแทนที่จะแสดง MissingFieldException เมื่อไม่มีอาร์กิวเมนต์ที่จำเป็นในระหว่างการจับคู่ (I5322f, b/524663005)
  • UriDeeplinkMatcher ที่มี URI ที่มีรูปแบบ https จะจับคู่ได้กับคำขอที่มีรูปแบบ https เท่านั้น (Ibfe22, b/522304329)
  • แก้ไข UriDeepLinkMatcher เพื่อระบุรูปแบบ http อย่างถูกต้องว่าตรงกับ https เมื่อจับคู่ DeepLinkRequest กับ UriDeepLinkMatcher (I3a62b, b/518804264)
  • ตอนนี้ตัวเปรียบเทียบ DeepLinkMatcher.MatchResult จะแสดงผลเป็น 0 โดยค่าเริ่มต้นเมื่อผลลัพธ์ 2 รายการเท่ากัน (I48ddb, b/518841353)
  • ตอนนี้ UriDeepLinkMatcher จะแสดงผล UriMatchResult เป็นค่าว่างแทนที่จะส่งข้อยกเว้นเมื่อคำขอที่ตรงกันไม่สำเร็จเนื่องจากไม่มีอาร์กิวเมนต์ที่จำเป็น (I669a7, b/470282247, b/512923412)

เวอร์ชัน 1.2.0-alpha04

3 มิถุนายน 2026

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

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

  • แก้ไขปัญหาภาพเคลื่อนไหวของภาพซ้อนทับที่ภาพซ้อนทับที่ฝังอยู่ เช่น ModalBottomSheet แสดงภาพเคลื่อนไหวซ้ำโดยไม่คาดคิดเมื่อภาพซ้อนทับด้านบนปรากฏขึ้น (Ia2b9e, b/502624496)

เวอร์ชัน 1.2.0-alpha03

19 พฤษภาคม 2026

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

ฟีเจอร์ใหม่

ตอนนี้ Navigation 3 รองรับ Deep Link ที่มี DeepLinkRequest และ DeepLinkMatcher แล้ว ดังนี้

  • DeepLinkRequest Deep Link ที่ขอซึ่งมี DeepLinkUri และ mimeType หรือการดำเนินการที่ไม่บังคับ (Android เท่านั้น) นอกจากคลาสใหม่แล้ว ยังมีฟังก์ชันที่ใช้ร่วมกันเพื่อสร้างอินสแตนซ์ด้วย uri, mimeType หรือ action แพลตฟอร์ม Android ยังมีตัวช่วยในการสร้างคำขอจาก Intent ด้วย (Iaaac9, b/470282247)

    val uriOnlyRequest = DeepLinkRequest.fromUriString("https://sampledeeplink.com/home")
    val uriAndMimeRequest = DeepLinkRequest.fromUriString(
      "https://sampledeeplink.com/user/profile?id=123",
      "image/png"
    )
    
  • DeepLinkMatcher แสดงถึง Deep Link ที่จับคู่กับ DeepLinkRequest ได้ อินสแตนซ์ Matcher แต่ละรายการจะเชื่อมโยงกับคีย์การนําทางที่รองรับ Deep Link นี้ คีย์การนำทางสามารถเชื่อมโยงกับ Matcher ได้หลายรายการ การเรียกใช้ DeepLinkMatcher.match จะแสดงผล MatchResult ที่มีคีย์การนำทางที่เชื่อมโยงหากจับคู่สำเร็จ การใช้งาน DeepLinkMatcher เริ่มต้นมี 2 แบบ ได้แก่ UriDeepLinkMatcher สำหรับการจับคู่ Deep Link ตาม URI และ StaticKeyDeepLinkMatcher สำหรับการจับคู่ Deep Link กับ DeepLinkMatcher.Filter ที่ตรงกันตาม Boolean เท่านั้น (I3798e, b/470282247)

  • UriDeepLinkMatcher การติดตั้งใช้งาน DeepLinkMatcher ที่มีความเห็นซึ่งจัดการ Deep Link โดยการจับคู่ DeepLinkUri กับคีย์การนำทางที่ทำให้เป็นอนุกรมได้ โดยรองรับอาร์กิวเมนต์ Deep Link ของประเภทพื้นฐานหรือคอลเล็กชันของประเภทพื้นฐาน เช่น รายการ อาร์เรย์ และชุด (I1520b, b/470282247)

    @Serializable
    data class UserKey(val id: Int): NavKey
    
    // declare a deep link supported by UserKey
    val userMatcher = UriDeepLinkMatcher(
      uriPattern = "www.sampledeeplink.com/user?userId={id}",
      serializer = serializer<UserKey>()
    )
    
    // handle a requested deep link with fallback key
    val key = userMatcher.match(deepLinkRequest)?.key ?: HomeKey
    
  • เพิ่ม DeepLinkUri ซึ่งเป็นเวอร์ชัน Kotlin Multiplatform ของ android.net.Uri (Id4725, b/470282247)

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

  • เพิ่มเป็น compileSdk 37 เพื่อให้ตรงกับ compileSdk ของ Compose

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

  • แก้ไข IllegalArgumentException ของ AnimatedBottomSheetSample เมื่อแสดงการวางซ้อนหลายรายการ ตอนนี้ SceneStrategy ตัวอย่างจะคำนวณ OverlayScene ที่ไม่ใช่รายการสุดท้ายอย่างถูกต้องและแสดงไว้ใต้ฉากซ้อนทับทั้งหมด (If2281, b/506733412)
  • เพิ่มทรัพยากร Dependency ของ NavigationEvent เป็น 1.1.1 ซึ่งจะนำ NavigationEventHandler ที่ไม่มีการดำเนินการออกเมื่ออยู่ในโหมดตรวจสอบเพื่อเปิดใช้การย้อนกลับที่คาดการณ์ได้ในตัวอย่างของ Android Studio (I487fd)

เวอร์ชัน 1.2.0-alpha02

22 เมษายน 2026

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

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

  • เปลี่ยนชื่อ onBack เป็น onBackCompleted และเพิ่ม onBackCancelled ลงใน NavigationBackHandler เพื่อรองรับการจัดการท่าทางสัมผัสเพื่อย้อนกลับที่ถูกยกเลิก (I92741)
  • เพิ่ม NavigationBackHandler เพื่อลดความซับซ้อนในการจัดการท่าทางสัมผัสเพื่อย้อนกลับและการย้อนกลับที่คาดการณ์ได้เมื่อใช้ SceneState ซึ่งช่วยให้นักพัฒนาแอปสร้างคอมโพเนนต์ UI ที่กำหนดเองซึ่งรองรับการนำทางย้อนกลับแบบมาตรฐานและท่าทางสัมผัสแบบคาดการณ์ได้ง่ายขึ้นโดยไม่ต้องคำนวณเดลต้าของ Back Stack ด้วยตนเอง (I6a055)
  • เพิ่ม rememberNavigationEventState เพื่อให้การเชื่อมต่อSceneStateกับการจัดการการย้อนกลับที่คาดการณ์ได้ง่ายขึ้น (Iae49c)

ฟีเจอร์ใหม่

  • เพิ่ม ResultEventBus API เพื่ออนุญาตให้ส่งผลลัพธ์ระหว่าง NavEntries ด้วย LocalResultEventBus ที่ได้จาก ResultEventBusNavEntryDecorator ใหม่ ผลลัพธ์ที่ส่งเข้ามาสามารถประเมินเป็นสถานะด้วย ResultEventBus#conflateAsState หรือเป็นโฟลว์ของผลลัพธ์ด้วย ResultEffect

เวอร์ชัน 1.2.0-alpha01

8 เมษายน 2026

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

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

  • การเข้าถึง LocalNavAnimatedContentScope จาก OverlayScene จะไม่ทำให้เกิด IllegalStateException อีกต่อไป เนื่องจากตอนนี้ OverlayScenes มี LocalAnimatedContentScope ที่ไม่มีการดำเนินการ (I2f00c, b/486067688)

เวอร์ชัน 1.1.7

26 สิงหาคม 2026

androidx.navigation3:navigation3-*:1.1.7 เผยแพร่แล้ว เวอร์ชัน 1.1.7 มี Commit เหล่านี้

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

  • แก้ไขปัญหาที่ท่าทางสัมผัสการย้อนกลับที่คาดการณ์ได้ซึ่งทริกเกอร์ระหว่างการเปลี่ยนไปข้างหน้าไม่เคลื่อนไหวเพื่อตอบสนองต่อความคืบหน้าของการปัด ตอนนี้การย้อนกลับที่คาดการณ์ได้จะแสดงภาพเคลื่อนไหวและทำงานอย่างถูกต้อง (Icdcb0, b/456218398)

เวอร์ชัน 1.1.6

12 สิงหาคม 2569

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

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

  • ตอนนี้ NavEntry.contentKey จะมีค่าเริ่มต้นเป็นองค์ประกอบของ key.toString() และ key::class.toString() วิธีนี้ช่วยให้มั่นใจได้ว่าออบเจ็กต์ข้อมูลที่ใช้ชื่อเดียวกันแต่ใช้อินเทอร์เฟซต่างกันจะไม่มี contentKey เดียวกันอีกต่อไป อย่างไรก็ตาม key::class ของแพลตฟอร์ม JS จะแสดงเฉพาะชื่อคลาสแบบง่ายแทนชื่อที่สมบูรณ์ในตัวเอง ดังนั้นแพลตฟอร์ม JS จึงควรใช้ contentKey ที่กำหนดเองสำหรับออบเจ็กต์ข้อมูลที่มีชื่อซ้ำกัน (I1fbbb, b/512534342)
  • แก้ไข IllegalArgumentException ที่แสดงโดย SaveableStateHolder สำหรับการใช้คีย์ซ้ำเมื่อมีการเปลี่ยนผ่านแบบป๊อปหลายรายการพร้อมกันเนื่องจากการป๊อปอย่างรวดเร็วจาก Back Stack (I4d728, b/516312097)

เวอร์ชัน 1.1.5

29 กรกฎาคม 2569

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

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

  • ตอนนี้ DSL ของ entryProvider จะให้ความสำคัญกับ NavEntry ที่สร้างขึ้นด้วยอินสแตนซ์คีย์ เช่น entry(key = userKey) { ... } มากกว่า NavEntry ที่สร้างขึ้นด้วยคลาสคีย์ เช่น entry<UserKey>{ ... } (Ib5ec9, b/533331924)

เวอร์ชัน 1.1.4

1 กรกฎาคม 2026

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

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

  • แก้ไขปัญหารายการที่ป๊อปอัปหายไปทันทีเมื่อป๊อปอัปไปยังรายการที่มีข้อมูลเมตาที่ฝังอยู่ซึ่งมีค่า Lambda (Idb872, b/520494430)

เวอร์ชัน 1.1.3

17 มิถุนายน 2026

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

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

  • แก้ไขปัญหาภาพเคลื่อนไหวของภาพซ้อนทับที่ภาพซ้อนทับที่ฝังอยู่ เช่น ModalBottomSheet แสดงภาพเคลื่อนไหวซ้ำโดยไม่คาดคิดเมื่อภาพซ้อนทับด้านบนปรากฏขึ้น (Ia2b9e, b/502624496)

  • เพิ่มทรัพยากร Dependency ของ NavigationEvent เป็น 1.1.2 ซึ่งนำ NavigationEventHandler ที่ไม่มีการดำเนินการออกเมื่ออยู่ในโหมดตรวจสอบเพื่อเปิดใช้การย้อนกลับที่คาดการณ์ได้ในตัวอย่างของ Android Studio

เวอร์ชัน 1.1.2

19 พฤษภาคม 2026

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

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

  • เพิ่มทรัพยากร Dependency NavigationEvent เป็น 1.1.1 ซึ่งนำ NavigationEventHandler ที่ไม่มีการดำเนินการออกเมื่ออยู่ในโหมดตรวจสอบเพื่อเปิดใช้การย้อนกลับที่คาดการณ์ได้ในตัวอย่างของ Android Studio

เวอร์ชัน 1.1.1

22 เมษายน 2026

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

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

  • การเข้าถึง LocalNavAnimatedContentScope จาก OverlayScene จะไม่ทำให้เกิด IllegalStateException อีกต่อไป เนื่องจากตอนนี้ OverlayScenes มี LocalAnimatedContentScope ที่ไม่มีการดำเนินการ (I2f00c, b/486067688)

เวอร์ชัน 1.1.0

8 เมษายน 2026

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

1.1.0 เสถียรแล้ว

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

องค์ประกอบที่ใช้ร่วมกันระหว่างฉาก - Navigation3 รองรับการจัดการฉากเป็นออบเจ็กต์องค์ประกอบที่ใช้ร่วมกันแล้ว ซึ่งหมายความว่าเมื่อฉากเปลี่ยนไป คุณจะมั่นใจได้ว่าการเปลี่ยนฉากจะเป็นไปอย่างราบรื่น คุณเปิดใช้ได้โดยส่ง SharedTransitionScope ไปยัง NavDisplay หรือ rememberSceneState

SceneDecoratorStrategy - การเปิดตัว SceneDecoratorStrategy เพื่อรองรับกรณีการใช้งาน เช่น การตกแต่งฉากด้วยคอมโพเนนต์ UI ทั่วไปหรือการแชร์สถานะในฉากต่างๆ

NavMetadata DSL - Navigation3 มี DSL ข้อมูลเมตาที่ปลอดภัยในการกำหนดประเภทใหม่แล้ว DSL ใช้อินเทอร์เฟซ MetadataKey ใหม่ที่ช่วยให้กำหนดประเภทคีย์และค่าที่ต้องการระบุให้กับแผนที่ข้อมูลเมตาได้ นอกจากนี้ยังเพิ่ม NavMetadataKeys ใหม่สำหรับการเปลี่ยน NavDisplay เพื่อให้ใช้กับ DSL ข้อมูลเมตาใหม่เพื่อเพิ่มการเปลี่ยนไปยัง NavDisplay ได้ด้วย

ภาพเคลื่อนไหว OverlayScene - อินเทอร์เฟซ OverlayScene มี Callback การระงับ onRemoved ใหม่ ระบบจะเรียกใช้ Callback นี้หลังจากนำคีย์ที่เชื่อมโยงกับฉากออกจาก Backstack แต่ก่อนที่จะออกจาก Composition ซึ่งจะช่วยให้ภาพเคลื่อนไหวทางออกที่เรียกใช้ภายใน onRemoved ทำงานจนเสร็จก่อนที่จะนำฉากซ้อนทับออกจากองค์ประกอบ

การเปลี่ยนแปลงอื่นๆ - ตอนนี้ NavDisplay และ rememberSceneState จะใช้ List<SceneStrategy> แทนพารามิเตอร์ SceneStrategy เดียวที่เชื่อมโยงกันด้วย infix then - ตอนนี้คุณสามารถเพิ่มข้อมูลเมตาแบบไดนามิกโดยพิจารณาคีย์รายการผ่าน EntryProvider DSL ได้แล้ว

เวอร์ชัน 1.1.0-rc01

25 มีนาคม 2026

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

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

  • ตอนนี้ NavDisplay จะตรวจสอบว่ารายการที่แสดงใต้โฆษณาซ้อนทับมี Lifecycle ไม่เกิน STARTED ซึ่งจะช่วยให้มั่นใจว่า API เช่น dropUnlessResumed จะยังคงทำงานต่อไปเมื่อใช้กล่องโต้ตอบ (If209f, b/483966071)
  • แก้ไขปัญหาใน NavDisplay ที่การไปยังหน้าจอเดียวกันไปมาและการขัดจังหวะภาพเคลื่อนไหวระหว่างหน้าจอทั้งสองอาจทำให้ลำดับ Z ของหน้าจอไม่ถูกต้อง (I4d491, b/459419800)

เวอร์ชัน 1.1.0-beta01

11 มีนาคม 2026

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

เวอร์ชัน 1.1.0-alpha05

25 กุมภาพันธ์ 2026

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

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

  • ตอนนี้ NavDisplay และ rememberSceneState จะใช้ List<SceneStrategy> แทนพารามิเตอร์ SceneStrategy เดียวที่ใช้ก่อนหน้านี้ซึ่งเชื่อมโยงกันด้วย then infix ซึ่งสอดคล้องกับList<SceneDecoratorStrategy<T>>ที่ API ทั้ง 2 รายการนี้ใช้อยู่แล้วมากขึ้น เราเลิกใช้งาน API ก่อนหน้านี้แล้ว (I78b2c, b/482108465)
  • เพิ่มโอเปอเรเตอร์ #contains ของข้อมูลเมตาเพื่อตรวจสอบว่าแผนที่ข้อมูลเมตามี NavMetadataKey ที่ระบุหรือไม่ (Ic30db, b/485311895)
  • เพิ่ม NavMetadataKey DialogKey สำหรับ DialogSceneStrategy เพื่อใช้กับ DSL ของข้อมูลเมตา (Ic7a26, b/483388817)

เวอร์ชัน 1.1.0-alpha04

11 กุมภาพันธ์ 2026

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

ฟีเจอร์ใหม่

  • ตอนนี้ Navigation3 มี DSL ข้อมูลเมตาที่ปลอดภัยในการกำหนดประเภทแบบใหม่ DSL ใช้อินเทอร์เฟซ MetadataKey ใหม่ที่ช่วยให้กำหนดประเภทคีย์และค่าที่ต้องการระบุให้กับแผนที่ข้อมูลเมตาได้ นอกจากนี้ยังเพิ่ม NavMetadataKey ใหม่สำหรับการเปลี่ยน NavDisplay เพื่อให้ใช้กับ DSL metadata ใหม่เพื่อเพิ่มการเปลี่ยนไปยัง NavDisplay ได้ (Ic10ef, Ic049c,b/476213928)

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

  • อินเทอร์เฟซ OverlayScene มี Callback การระงับ onRemoved ใหม่ ระบบจะเรียกใช้ Callback นี้หลังจากนำคีย์ที่เชื่อมโยงกับฉากออกจาก Backstack แต่ก่อนที่จะออกจาก Composition ซึ่งจะช่วยให้ภาพเคลื่อนไหวออกที่เรียกใช้ภายใน onRemoved ทำงานจนเสร็จก่อนที่จะนำฉากซ้อนทับออกจากองค์ประกอบ (I29a72, b/440558061)
  • SceneStrategy ได้แยกฟังก์ชันการตกแต่งออกเป็น SceneDecoratorStrategy ใหม่ อินเทอร์เฟซใหม่นี้คือสิ่งที่คุณควรใช้เพื่อตกแต่งฉาก มี API ใหม่สำหรับ NavDisplay และ rememberSceneState เพื่ออนุญาตให้เพิ่ม SceneDecoratorStrategies (If9385, b/477669607, b/477670333)

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

  • แก้ไขข้อผิดพลาดที่การส่ง SharedTransitionLayout ไปยัง NavDisplay หรือ rememberSceneState และการใช้ OverlayScene ใดๆ จะทำให้เกิดข้อขัดข้อง เนื่องจากการใช้ SharedTransitionLayout จะทำงานกับ NavEntries ที่แสดงผลเป็นส่วนหนึ่งของ AnimatedContent เท่านั้น และ OverlayScene จะแสดงผลในหน้าต่างของตนเองแยกต่างหาก (I1bb76, b/478664101)

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

  • จาก Navigation3 1.0.1: ตอนนี้ Navigation3 ขึ้นอยู่กับ NavigationEvent 1.0.2 การดำเนินการนี้จะแก้ไข IllegalStateException ที่เกิดจากการใช้ NavDisplay ระหว่างเวอร์ชันตัวอย่างของ AndroidStudio (Id7212, b/477149762)

เวอร์ชัน 1.1.0-alpha03

28 มกราคม 2026

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

ฟีเจอร์ใหม่

  • ตอนนี้คุณสามารถเพิ่มข้อมูลเมตาแบบไดนามิกโดยพิจารณาคีย์รายการผ่าน EntryProvider DSL ได้แล้ว (I942fb, b/474416976)

เวอร์ชัน 1.1.0-alpha02

14 มกราคม 2026

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

ฟีเจอร์ใหม่

  • ตอนนี้ SceneStrategy รองรับการฝังฉากผ่านฟังก์ชัน calculatedScene(Scene) ใหม่แล้ว ซึ่งหมายความว่าคุณสามารถปรับแต่ง SceneStrategy เพื่อให้มีฟังก์ชันการทำงานเพิ่มเติมสำหรับฉากอื่นๆ ได้ (I5df7c,b/440333896)

เวอร์ชัน 1.1.0-alpha01

3 ธันวาคม 2025

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

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

  • ตอนนี้ Navigation3 รองรับการจัดการฉากเป็นออบเจ็กต์องค์ประกอบที่แชร์แล้ว ซึ่งหมายความว่าเมื่อฉากเปลี่ยนไป คุณจะมั่นใจได้ว่าการเปลี่ยนฉากจะเป็นไปอย่างราบรื่น คุณเปิดใช้ได้โดยส่ง SharedTransitionScope ไปยัง NavDisplay หรือ rememberSceneState (I15868)

รุ่น 1.0

เวอร์ชัน 1.0.1

11 กุมภาพันธ์ 2026

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

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

  • ตอนนี้ Navigation3 ต้องใช้ NavigationEvent 1.0.2 การดำเนินการนี้จะแก้ไข IllegalStateException ที่เกิดจากการใช้ NavDisplay ระหว่างเวอร์ชันตัวอย่างของ AndroidStudio (Id7212, b/477149762)

เวอร์ชัน 1.0.0

19 พฤศจิกายน 2025

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

ขอแนะนำ Navigation3

เวอร์ชัน 1.0.0-rc01

5 พฤศจิกายน 2025

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

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

  • ตอนนี้ NavDisplay จะตั้งค่า LocalLifecycleOwner ที่ระดับ Scene ซึ่งช่วยให้ผู้เขียนฉากระบุได้ว่าการเปลี่ยนฉากทั้งหมดเสร็จสิ้นแล้วหรือไม่โดยตรวจสอบว่า Lifecycle.State เป็น RESUMED ลักษณะการทำงานของ LocalLifecycleOwner ที่ระดับ NavEntry จะไม่มีการเปลี่ยนแปลง โดยจะยังคงถูกจำกัดไว้ที่ STARTED หากมีการเปลี่ยนผ่านอยู่ และจะถูกจำกัดไว้ที่ CREATED เพิ่มเติมหาก NavEntry นั้นถูกนำออกจาก Back Stack และอยู่ในกระบวนการแสดงภาพเคลื่อนไหวออก (I03113, b/454045829)

เวอร์ชัน 1.0.0-beta01

22 ตุลาคม 2025

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

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

  • ตอนนี้ SceneStrategyScope มีเฉพาะคอนสตรักเตอร์สาธารณะที่ไม่มีอาร์กิวเมนต์ ซึ่งเหมาะสำหรับการทดสอบ SceneStrategy และ Scene ที่แสดงผลแยกต่างหาก สำหรับกรณีการใช้งานที่ซับซ้อนมากขึ้น โปรดใช้ rememberSceneState() (I8440c, b/451679047)

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

  • แก้ไขการวนซ้ำไม่สิ้นสุดเมื่อเชื่อมโยง SceneStrategy กับ then (Iba3f0, b/450323470)
  • แก้ไขปัญหาหน้าจอกะพริบเมื่อสลับ backStack ที่ส่งไปยัง NavDisplay และใช้ภาพเคลื่อนไหว (Ief7b5, b/450967248)

เวอร์ชัน 1.0.0-alpha11

8 ตุลาคม 2025

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

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

  • วิธีการ calculateScene ใน SceneStrategy ไม่@Composableอีกต่อไป แต่ให้พิจารณาย้ายงานนี้ไปที่การสร้างเมธอด SceneStrategy (เช่น ในเมธอด rememberMySceneStrategy()) ซึ่งช่วยให้คุณกำหนดอายุการใช้งานของค่า rememberSaveable หรือคำสั่ง remember หลักจากค่าที่ถูกต้องได้อย่างสมบูรณ์ (If1733, b/448709506)
  • พารามิเตอร์ onBack สำหรับ SceneStrategy.calculateScene ได้ย้ายไปยังขอบเขตตัวรับใหม่ของ SceneStrategyScope เพื่อให้ชัดเจนยิ่งขึ้นว่านี่เป็นพารามิเตอร์ที่ไม่บังคับ และเป็นจุดขยายสำหรับฟีเจอร์ Navigation3 ในอนาคต (I3aea3, b/448460407)
  • onBack lambda ที่ส่งไปยัง NavDisplay และ SceneStrategy ของคุณจะไม่ระบุพารามิเตอร์ count: Int เพื่อระบุว่าควรแสดงรายการหลายรายการเมื่อใดอีกต่อไป แต่ตอนนี้ระบบจะเรียกใช้ Lambda () -> Unit หลายครั้งติดต่อกันในกรณีที่เกิดขึ้นไม่บ่อยนักซึ่งฉากของคุณขอให้แสดงรายการหลายรายการ (Idedb5, b/446989346)
  • นำคลาส NavEntryWrapper ออกและแทนที่ฟังก์ชันการทำงานด้วยคลาส NavEntry สุดท้ายที่มีคอนสตรัคเตอร์รองใหม่ซึ่งใช้ NavEntry ที่มีเนื้อหาใหม่ ซึ่งจะช่วยให้ระบบรองรับการรวมรายการที่มีเนื้อหาใหม่ต่อไปได้ (I7da2a, b/444447130)
  • ฟังก์ชัน navEntryDecorator ซึ่งสร้างและแสดงผล NavEntryDecorator ถูกนำออกและแทนที่ด้วยคลาส NavEntryDecorator ซึ่งตอนนี้เป็นแบบสาธารณะและเปิดให้สร้างคลาสย่อยได้ (If81f8, b/444447434, b/447381176)
  • SavedStateNavEntryDecorator เปลี่ยนชื่อเป็น SaveableStateHolderNavEntryDecorator แล้วเนื่องจากตกแต่งรายการด้วย SaveableStateHolder นอกจากนี้ เรายังเปลี่ยนโครงสร้างภายในโค้ดของเดคอเรเตอร์จากฟังก์ชันเป็นคลาสด้วย เนื่องจากเดคอเรเตอร์ทำหน้าที่เป็นโรงงานสำหรับ NavEntryDecorator (Ie6013, b/447381176)
  • การแสดงผลที่กำหนดเองซึ่งใช้ SceneState เป็นทางเลือกแทนการใช้ NavDisplay ไม่จำเป็นต้องใช้ LocalEntriesToRenderInCurrentScene Composition Local อีกต่อไป ซึ่งตอนนี้เป็นแบบภายใน (Ic40ef, b/414668196)
  • นำ SceneSetupNavEntryDecorator และ rememberSceneSetupNavEntryDecorator() ออกจากแพลตฟอร์ม API สาธารณะแล้ว ตอนนี้ฟังก์ชันนี้จะรวมอยู่โดยค่าเริ่มต้นโดยที่คุณไม่ต้องรวมด้วยตนเอง (Ieae42, b/444479133)
  • ตอนนี้ NavEntry, DialogScene, SinglePaneScene และ SceneState ต่างก็ใช้เมธอด equals (I96121)
  • อินเทอร์เฟซฉากมีช่องข้อมูลเมตาใหม่เพื่อแนบข้อมูลเมตาเฉพาะฉากสำหรับ NavDisplay ซึ่งจะช่วยให้ฉากลบล้างข้อมูลเมตาใน NavDisplay ได้ เช่น ด้วยการเปลี่ยนฉาก (I1fd96, b/443955625)
  • ลดความซับซ้อนของลายเซ็น rememberNavBackStack โดยนำพารามิเตอร์ประเภททั่วไปที่ซ้ำซ้อนออก ตอนนี้ฟังก์ชันยอมรับ vararg elements: NavKey แล้ว (I03e45)
  • ตอนนี้ภาพเคลื่อนไหวเริ่มต้นสำหรับ NavDisplay เป็นส่วนหนึ่งของ API ทั่วไปแล้ว ซึ่งช่วยให้เรียกใช้ภาพเคลื่อนไหวจากทุกแพลตฟอร์มได้ (I71af9, b/447147159)
  • เปลี่ยนชื่อ EntryProviderBuilder เป็น EntryProviderScope เพื่อให้สอดคล้องกับความจริงที่ว่าคลาสนี้เป็น Kotlin DSL ที่ให้ขอบเขตในการสร้าง NavEntries (Ia7465)

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

  • ตอนนี้ rememberNavBackStack() บังคับใช้การจัดรูปแบบข้อมูลแบบ Polymorphic สำหรับ NavKey และต้องใช้ SavedStateConfiguration ที่กำหนดเองซึ่งได้รับการกำหนดค่าเพื่อให้แน่ใจว่ามีการกู้คืนสถานะที่ถูกต้อง KDoc ได้รับการอัปเดตเพื่อให้สอดคล้องกับข้อกำหนดที่ว่าประเภทย่อย NavKey ทั้งหมดต้องลงทะเบียนใน SerializersModule ที่ระบุ (I6de37,I782f2, b/446664383)

เวอร์ชัน 1.0.0-alpha10

24 กันยายน 2025

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

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

  • เพิ่มโอเวอร์โหลด NavDisplay ใหม่ที่ใช้รายการ NavEntry<T> ซึ่งตกแต่งโดย rememberDecoratedNavEntries (I4025b, b/441940314)
  • ย้าย DialogScene ไปยังแพ็กเกจใหม่แล้ว (Ia5840)
  • นำ API สาธารณะ DecorateNavEntry ออก แต่ให้ใช้ rememberDecoratedNavEntries เพื่อรวม NavEntry เข้ากับรายการเดคอเรเตอร์แทน (Id8c09)
  • ตอนนี้ UI ของ Navigation3 มีพร็อพเพอร์ตี้ transitionSpec เริ่มต้นใหม่แล้ว (Ibcabd)
  • เพิ่มออบเจ็กต์ SceneState ใหม่เพื่อช่วยจัดการฉาก นอกจากนี้ยังมีการโอเวอร์โหลด NavDisplay ใหม่ที่ใช้ SceneState และ NavigationEventState ด้วย (Idfb46, b/444479133)
  • ตอนนี้ NavDisplay ช่วยให้คุณปรับแต่งการเปลี่ยนหน้าได้ตามSceneที่คุณจะไปและมาจากหน้าใด โดยดูที่ currentState และ targetState ของ Transition (I906cc, b/443872322)
  • ตอนนี้ NavigationEventInfo เป็นabstract classแทนที่จะเป็นinterfaceแล้ว อัปเดตการติดตั้งใช้งานที่กำหนดเองทั้งหมดให้รับค่าจากคลาส (เช่น data class MyInfo : NavigationEventInfo()) (I1e59c, b/444734264)
  • อัปเดต API ของแฮนเดิล navigationevent-compose แล้ว ตอนนี้ NavigationEventHandler และ NavigationBackHandler (รวมถึงตัวแปร) รองรับการโอเวอร์โหลดใหม่ที่ยอมรับ NavigationEventState ที่ยกขึ้น ระบบจะเก็บรักษาโอเวอร์โหลดแบบง่าย (ซึ่งใช้ currentInfo) ไว้ และตอนนี้จะใช้โมเดลสถานะใหม่นี้ภายใน (Ic3251, b/444734264)
  • Scene API ทั้งหมดได้ย้ายออกจาก navigation3-ui ไปยัง navigation3-runtime แล้ว ซึ่งหมายความว่าตอนนี้ฟีเจอร์ดังกล่าวพร้อมใช้งานในทุกแพลตฟอร์มที่ navigation3-runtime รองรับแล้ว (I431d0, b/444449993)
  • เพิ่มโอเวอร์โหลด rememberDecoratedNavEntries ใหม่ที่ใช้รายการ NavEntry เพื่อตกแต่ง รายการอินพุตสามารถตกแต่งด้วยเครื่องมือตกแต่งรายการอื่นๆ ได้อยู่แล้ว (I5a034, b/444230270)
  • นำพารามิเตอร์ประเภทไวลด์การ์ด navigation3 ออก (I02540)
  • ปรับปรุงการจัดการ Generics สำหรับ entryProvider DSL หากก่อนหน้านี้คุณนำเข้า androidx.navigation3.runtime.entry คุณไม่จำเป็นต้องทำเช่นนั้นอีกต่อไป (I299fc)
  • จำกัดการโอเวอร์โหลด NavBackStackSerializer ที่อิงตามการสะท้อนไว้ที่ Android ซึ่งจะป้องกันความล้มเหลวในการจัดรูปแบบอนุกรมรันไทม์โดยนัยบนแพลตฟอร์มที่ไม่ใช่ Android โดยบังคับให้ใช้โอเวอร์โหลด SavedStateConfiguration ที่ชัดเจนในโค้ดแบบหลายแพลตฟอร์ม (I73313, b/420443609)
  • Make NavigationEvent's swipeEdge an @IntDef (Icee54, b/443950342)
  • จำกัดการจัดเรียงข้อมูล NavBackStack ไว้ใน Android ซึ่งจะช่วยป้องกันไม่ให้เกิดข้อผิดพลาดเกี่ยวกับรันไทม์ในแพลตฟอร์มที่ไม่ใช่ Android สำหรับการบันทึกสถานะแบบหลายแพลตฟอร์ม ให้ใช้โอเวอร์โหลด rememberNavBackStack กับ SavedStateConfiguration ที่ชัดเจน (I1e418, b/420443609)

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

  • แก้ไขข้อขัดข้องระหว่างการย้อนกลับที่คาดการณ์ได้เมื่อ NavDisplay ที่ฝังมีรายการย่อยรายการเดียว (I2cdc0, b/441933162)

เวอร์ชัน 1.0.0-alpha09

10 กันยายน 2025

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

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

  • DecoratedNavEntryProvider ถูกแทนที่ด้วย rememberDecoratedNavEntries ซึ่งสร้างและแสดงผล NavEntries ที่ตกแต่งด้วยรายการเดคอเรเตอร์ที่ระบุ (I0fe1c, b/441328236)
  • ตอนนี้ NavBackStack เป็นแบบทั่วไปเหนือประเภท NavKey ซึ่งช่วยให้แอปและไลบรารีสามารถกำหนดประเภทคีย์ที่กำหนดเองสำหรับ Back Stack ของตนได้ แทนที่จะถูกจำกัดให้ใช้ NavKey (I4d190,Iad2f4, b/420443609)
  • ตอนนี้ NavBackStack เปลี่ยนเป็น @kotlinx.serialization.Serializable แล้ว ซึ่งช่วยให้บันทึกและกู้คืนสถานะการนำทางได้ตลอดการสิ้นสุดการประมวลผลและการเปลี่ยนแปลงการกำหนดค่าโดยไม่ต้องใช้ต้นแบบเพิ่มเติม (I2c3cf, b/420443609)
  • RememberNavBackStack ได้ย้ายไปที่ commonMain เพื่อให้แน่ใจว่ามีการระบุไว้ในเป้าหมายแพลตฟอร์มทั้งหมด (Id69e7, b/420443609)

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

  • ตอนนี้ NavDisplay จะย้าย NavEntry แต่ละรายการไปยัง Lifecycle.State ที่ถูกต้องอย่างถูกต้อง (I30aac, b/440145700)
  • แก้ไขปัญหาที่ NavDisplay จะละเว้น NavigationEventDispatcherOwner ที่ฝังไว้ซึ่งตั้งค่าผ่าน LocalNavigationEventDispatcherOwner ของไลบรารี NavigationEvent (I6224a)

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

เวอร์ชัน 1.0.0-alpha08

27 สิงหาคม 2025

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

ฟีเจอร์ใหม่

  • เพิ่มเป้าหมาย Kotlin MultiPlatform (KMP) ใหม่ลงในอาร์ติแฟกต์ Navigation3 Runtime ตอนนี้ Navigation3 Runtime รองรับแพลตฟอร์มทั้งหมดต่อไปนี้ JVM (Android และเดสก์ท็อป), เนทีฟ (Linux, iOS, watchOS, macOS, MinGW) และเว็บ (JavaScript, WasmJS) (I55078, b/424410398, b/419294028, b/419046226) หมายเหตุ: การดำเนินการนี้ไม่ได้ให้เป้าหมาย KMP สำหรับอาร์ติแฟกต์ Navigation3 UI ในแพลตฟอร์มอื่นๆ คุณจะต้องติดตั้งใช้งาน NavDisplay ที่กำหนดเองของคุณเอง หากต้องการให้รองรับ โปรดโหวตปัญหา Jetbrains ที่นี่ และติดตามความคืบหน้าเพื่อรับการสนับสนุนเพิ่มเติมที่นั่น
  • ตอนนี้ออบเจ็กต์ NavDisplayInfo เป็นแบบสาธารณะแล้ว และสามารถใช้เพื่อดึงข้อมูลรายการที่มองเห็นได้จาก NavDisplay (Ibc91f)

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

  • เพิ่ม NavBackStackSerializer ใหม่เพื่อใช้ร่วมกับ rememberNavBackStack เพื่อทำการกู้คืนสถานะ ตอนนี้ rememberNavBackStack() ยังใช้ SavedStateConfiguration ซึ่งใช้เพื่อระบุการกำหนดค่าของคุณเองได้ด้วย (I2f4d2, I4cd58, b/420443609)

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

  • แก้ไขปัญหาที่การไปยังส่วนต่างๆ ทำให้เหตุการณ์ในวงจรเริ่มทำงานอย่างไม่ถูกต้อง (I8bf6d, b/425901162, b/434109022)

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

  • I8bf6d ทำให้เกิดข้อบกพร่องที่ทำให้วงจรชีวิตอิงตามฉากแทนที่จะเป็นรายการแต่ละรายการ ซึ่งทำให้วงจรชีวิตเสียหายในกรณีที่ key ที่ระบุให้กับ NavEntry ไม่ใช่ String หรือ NavEntry ไม่ได้ลบล้าง contentKey และตั้งค่าให้เท่ากับ key (โปรดทราบว่าการทำเช่นนี้จะบังคับให้บันทึกคีย์ของคุณลงใน Bundle ได้) ปัญหานี้ได้รับการแก้ไขแล้วสำหรับรุ่นถัดไป (b/440145700)

เวอร์ชัน 1.0.0-alpha07

13 สิงหาคม 2025

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

การอัปเดต MinSdk

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

  • ตอนนี้ SavedStateNavEntryDecorator ใช้ SaveableStateRegistry ที่มีอยู่ใน SaveableStateProvider เพื่อบันทึกและกู้คืนสถานะ (If8d9a)
  • ตอนนี้ predictivePopTransitionSpec จะมีขอบการปัดเป็นพารามิเตอร์ ซึ่งช่วยให้คุณปรับแต่งการเปลี่ยนภาพตามขอบที่ผู้ใช้เริ่มท่าทางสัมผัสการย้อนกลับที่คาดการณ์ได้ (I753a8)

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

  • แก้ไขปัญหาที่ทำให้ระบบคำนวณฉากที่กำหนดเองซ้ำอย่างไม่สิ้นสุดเนื่องจากระบบไม่จดจำฉากล่าสุด (I7ba84, b/418153031)

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

เวอร์ชัน 1.0.0-alpha06

30 กรกฎาคม 2025

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

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

เวอร์ชัน 1.0.0-alpha05

2 กรกฎาคม 2025

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

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

  • ตอนนี้สถานะของ NavEntry จะอิงตามรายการเดคอเรเตอร์ปัจจุบันที่ส่งไปยัง NavDisplay อย่างเคร่งครัด ซึ่งหมายความว่าควรสลับเดโคเรเตอร์ตาม Back Stack ในกรณีที่มี Back Stack หลายรายการเพื่อรักษาสถานะของ NavEntry ใน Back Stack ไม่เช่นนั้น ระบบจะล้างสถานะราวกับว่ารายการถูกนำออก (แทนที่จะเป็นการสลับ) (I7a759, b/428033667)

เวอร์ชัน 1.0.0-alpha04

18 มิถุนายน 2025

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

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

  • ตอนนี้ NavEntry.content เป็นแบบส่วนตัวแล้ว หากต้องการเรียกใช้เนื้อหา NavEntry ให้เรียกใช้ API NavEntry.Content() ใหม่ซึ่งไม่จำเป็นต้องใช้พารามิเตอร์ key เพื่อเรียกใช้อีกต่อไป (Icd0fd, b/420991203)
  • NavEntry.key เป็นช่องส่วนตัวแล้ว ควรระบุ NavEntry และสถานะที่เกี่ยวข้องด้วยช่อง contentKey ใหม่ซึ่งสร้างขึ้นจาก Lambda contentKeyFactory ใหม่ และค่าเริ่มต้นเป็นแฮชที่บันทึกได้ซึ่งสร้างขึ้นจาก NavEntry.key (I81a6c, b/422001357, b/420991203 I2d7d4, b/420991203, b/422841812)

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

  • ตอนนี้ Navigation3 ขึ้นอยู่กับอาร์ติแฟกต์ androidx.navigationevent.compose ใหม่

เวอร์ชัน 1.0.0-alpha03

4 มิถุนายน 2025

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

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

  • Navigation3 จะไม่ล้างสถานะของ Decorator สำหรับ backStacks ที่ถูกสลับออกและแทนที่ด้วยอินสแตนซ์ backStack อื่นอีกต่อไป (I28a42, b/415076044)

เวอร์ชัน 1.0.0-alpha02

23 พฤษภาคม 2025

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

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

  • แก้ไขปัญหาเกี่ยวกับ SavedStateNavEntryDecorator ซึ่งทำให้เกิดการชนกันของคลาสข้อมูลที่แตกต่างกันซึ่งมีค่าพร็อพเพอร์ตี้เดียวกัน (b/418070648, Iff4775)
  • แก้ไขปัญหาคลาสที่ขาดหายไปซึ่งจะทำให้เกิดข้อขัดข้องเมื่อเรียกใช้โดยไม่ประกาศทรัพยากร Dependency ที่ชัดเจน (b/419049149, I4b4ed)

เวอร์ชัน 1.0.0-alpha01

20 พฤษภาคม 2025

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

ฟีเจอร์ใหม่

Navigation3 เป็นไลบรารีการนำทางใหม่ที่สร้างขึ้นเพื่อจัดการการนำทางในแอป Jetpack Compose โดยเฉพาะ อาร์ติแฟกต์ androidx.navigation3.runtime มีองค์ประกอบพื้นฐาน ส่วนอาร์ติแฟกต์ androidx.navigation3.ui มีเลเยอร์ UI ผ่าน API NavDisplay นักพัฒนาแอปสามารถระบุสถานะของตนเองไปยังฟังก์ชันที่ประกอบกันได้ที่ชื่อ NavDisplay โดยตรง ซึ่งจะเปลี่ยนเนื้อหาตามการเปลี่ยนแปลงในสถานะของนักพัฒนาแอป

@Serialiable object Home : NavKey
@Serialiable object Chat : NavKey

val backStack = rememberNavBackStack(Home)

NavDisplay(backStack, entryProvider = entryProvider {
  entry<Home> {
    Column {
      Text(“Home”)
      Button(onClick = { backStack.add(Chat) } ) {
        Text(“Go to Chat”)
      } 
    }
  }
  entry<Chat> { /* My Composable Content */ }
})

ดูข้อมูลเพิ่มเติมได้ที่คู่มือ Navigation3