navigationevent
อัปเดตล่าสุด | รุ่นที่เสถียร | รุ่นที่อาจได้รับการเผยแพร่ | รุ่นเบต้า | รุ่นอัลฟ่า |
---|---|---|---|---|
2 กรกฎาคม 2025 | - | - | - | 1.0.0-alpha04 |
การประกาศทรัพยากร Dependency
หากต้องการเพิ่มทรัพยากร Dependency ใน NavigationEvent คุณต้องเพิ่มที่เก็บ Maven ของ Google ลงใน โปรเจ็กต์ อ่านข้อมูลเพิ่มเติมได้ที่ที่เก็บ Maven ของ Google
เพิ่มการอ้างอิงสำหรับอาร์ติแฟกต์ที่คุณต้องการในไฟล์ build.gradle
สำหรับแอปหรือโมดูลของคุณ
Groovy
dependencies { implementation "androidx.navigationevent:navigationevent:1.0.0-alpha04" }
Kotlin
dependencies { implementation("androidx.navigationevent:navigationevent:1.0.0-alpha04") }
ดูข้อมูลเพิ่มเติมเกี่ยวกับการพึ่งพาได้ที่เพิ่มการพึ่งพาบิลด์
ความคิดเห็น
ความคิดเห็นของคุณจะช่วยให้ Jetpack ทำงานได้ดียิ่งขึ้น โปรดแจ้งให้เราทราบหากพบปัญหาใหม่หรือมี ไอเดียในการปรับปรุงไลบรารีนี้ โปรดดูปัญหาที่มีอยู่ ในไลบรารีนี้ก่อนสร้างปัญหาใหม่ คุณสามารถโหวตปัญหาที่มีอยู่ได้โดย คลิกปุ่มดาว
ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของเครื่องมือติดตามปัญหา
ไม่มีบันทึกประจำรุ่นสำหรับอาร์ติแฟกต์นี้
รุ่น 1.0
เวอร์ชัน 1.0.0-alpha04
2 กรกฎาคม 2025
androidx.navigationevent:navigationevent-*:1.0.0-alpha04
ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha04 มีการเปลี่ยนแปลงเหล่านี้
การแก้ไขข้อบกพร่อง
- ใช้
implementedInJetBrainsFork
เพื่อnavigationevent-compose
และเพิ่มเป้าหมายcommonStubs
ให้ตรงกับรูปแบบของ Compose การเปลี่ยนแปลงที่ Ivan Matkov จาก JetBrains ขอ (f60c79) - แก้ไขการใช้ปลั๊กอินคอมไพเลอร์ Compose สำหรับ Kotlin/Native เพื่อให้มั่นใจว่ามีการสร้าง Stub ที่ถูกต้อง ไม่มีผลต่อ API สาธารณะหรือลักษณะการทำงาน (1890c9)
เวอร์ชัน 1.0.0-alpha03
18 มิถุนายน 2025
androidx.navigationevent:navigationevent-*:1.0.0-alpha03
ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha03 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เปิดตัว
navigationevent-compose
โมดูลใหม่เพื่อรองรับฟีเจอร์ Jetpack Compose ในไลบรารีnavigationevent
(980d78) NavigationEvent
Compose ได้เพิ่มLocalNavigationEventDispatcherOwner
การแต่งเพลงในพื้นที่ใหม่ โดยจะแสดงผลค่าที่อนุญาตให้เป็น Null เพื่อให้ระบุได้ดียิ่งขึ้นว่าค่าดังกล่าวพร้อมใช้งานในองค์ประกอบปัจจุบันหรือไม่ ตอนนี้NavigationEventHandler
จะแสดงข้อผิดพลาดหากไม่พบเจ้าของที่เกี่ยวข้อง (62ffda)NavigationEvent
Compose ได้เพิ่มNavigationEventHandler
Composable ใหม่เพื่อจัดการเหตุการณ์ (ท่าทางสัมผัสย้อนกลับแบบคาดการณ์) โดยจะแสดงFlow
ของออบเจ็กต์NavigationEvent
ที่ต้องรวบรวมใน Lambda ที่ระงับซึ่งคุณระบุ c42ba6 :
NavigationEventHandler { progress: Flow<NavigationEvent> ->
// This block is executed when the back gesture begins.
try {
progress.collect { backEvent ->
// Handle gesture progress updates here.
}
// This block is executed if the gesture completes successfully.
} catch (e: CancellationException) {
// This block is executed if the gesture is cancelled
throw e
} finally {
// This block is executed either the gesture is completed or cancelled
}
}
การเปลี่ยนแปลง API
- ตอนนี้คุณจะลงทะเบียน
NavigationEventCallback
แต่ละรายการกับNavigationEventDispatcher
ได้เพียงรายการเดียวในแต่ละครั้ง การเพิ่มลงในผู้จัดส่งหลายรายจะทำให้เกิดIllegalStateException
โปรดทราบว่าลักษณะการทำงานนี้แตกต่างจากOnBackPressedDispatcher
ซึ่งอนุญาตให้มีผู้จัดส่งหลายราย (e82c19) - ทำให้
isPassThrough
เป็นval
เพื่อป้องกันการเปลี่ยนแปลงระหว่างการนำทาง ซึ่งอาจทำให้การส่งของNavigationEvent
ทำงานไม่ได้ (I0b287)
เวอร์ชัน 1.0.0-alpha02
4 มิถุนายน 2025
androidx.navigationevent:navigationevent-*:1.0.0-alpha02
ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha02 มีการคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- แทนที่ตัวสร้างรองของ
NavigationEventDispatcher
ด้วยอาร์กิวเมนต์เริ่มต้น (I716a0) - นำพร็อพเพอร์ตี้ที่มีลำดับความสำคัญออกจาก
NavigationEventCallback
ส่งต่อลำดับความสำคัญไปยังNavigationEventDispatcher.addCallback()
แทน (I13cae)
การแก้ไขข้อบกพร่อง
- แก้ไข
ConcurrentModificationException
ที่อาจเกิดขึ้นเมื่อมีการเรียกใช้NavigationEventCallback.remove()
เนื่องจากการแก้ไขรายการภายในของรายการที่ปิดได้พร้อมกัน (b/420919815)
เวอร์ชัน 1.0.0-alpha01
20 พฤษภาคม 2025
androidx.navigationevent:navigationevent-*:1.0.0-alpha01
ได้รับการเผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha01 มีการเปลี่ยนแปลงเหล่านี้
ฟีเจอร์ใหม่
- ไลบรารี
androidx.navigationevent
มี API ที่เน้น KMP เป็นอันดับแรกสำหรับการจัดการการย้อนกลับของระบบและการย้อนกลับแบบคาดการณ์NavigationEventDispatcher
เป็น API ทั่วไปสําหรับการลงทะเบียนอินสแตนซ์NavigationEventCallback
อย่างน้อย 1 รายการเพื่อรับเหตุการณ์ย้อนกลับของระบบ - เลเยอร์นี้อยู่ใต้ API ที่เปิดตัวก่อนหน้านี้ใน
androidx.activity
และมีจุดมุ่งหมายเพื่อเป็นตัวแทนที่ยืดหยุ่นกว่าในการใช้ Activity API ในคอมโพเนนต์ระดับสูงขึ้น หรือใช้ API ของเฟรมเวิร์ก AndroidOnBackInvokedDispatcher
โดยตรง เราได้เขียน API ของandroidx.activity
ใหม่โดยใช้ Navigation Event API เป็นส่วนหนึ่งของ Activity 1.12.0-alpha01