อายุการใช้งาน
ตารางนี้แสดงอาร์ติแฟกต์ทั้งหมดในกลุ่ม androidx.lifecycle
| อาร์ติแฟกต์ | รุ่นที่เสถียร | รุ่นที่อาจได้รับการเผยแพร่ | รุ่นเบต้า | รุ่นอัลฟ่า |
|---|---|---|---|---|
| lifecycle-* | 2.11.1 | - | - | 2.12.0-alpha06 |
| lifecycle-viewmodel-navigation3 | 2.11.1 | - | - | 2.12.0-alpha06 |
การประกาศทรัพยากร Dependency
หากต้องการเพิ่มทรัพยากร Dependency ในวงจร คุณต้องเพิ่มที่เก็บ Maven ของ Google ลงในโปรเจ็กต์ อ่านข้อมูลเพิ่มเติมได้ที่ที่เก็บ Maven ของ Google
เพิ่มทรัพยากร Dependency สำหรับอาร์ติแฟกต์ที่ต้องการในไฟล์ build.gradle สำหรับแอปหรือโมดูล ดังนี้
Kotlin
Groovy
dependencies { def lifecycle_version = "2.11.0" def arch_version = "2.2.0" // ViewModel implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version" // ViewModel utilities for Compose implementation "androidx.lifecycle:lifecycle-viewmodel-compose:$lifecycle_version" // LiveData implementation "androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version" // Lifecycles only (without ViewModel or LiveData) implementation "androidx.lifecycle:lifecycle-runtime-ktx:$lifecycle_version" // Lifecycle utilities for Compose implementation "androidx.lifecycle:lifecycle-runtime-compose:$lifecycle_version" // Saved state module for ViewModel implementation "androidx.lifecycle:lifecycle-viewmodel-savedstate:$lifecycle_version" // ViewModel integration with Navigation3 implementation "androidx.lifecycle:lifecycle-viewmodel-navigation3:2.12.0-alpha04" // Annotation processor kapt "androidx.lifecycle:lifecycle-compiler:$lifecycle_version" // alternately - if using Java8, use the following instead of lifecycle-compiler implementation "androidx.lifecycle:lifecycle-common-java8:$lifecycle_version" // optional - helpers for implementing LifecycleOwner in a Service implementation "androidx.lifecycle:lifecycle-service:$lifecycle_version" // optional - ProcessLifecycleOwner provides a lifecycle for the whole application process implementation "androidx.lifecycle:lifecycle-process:$lifecycle_version" // optional - ReactiveStreams support for LiveData implementation "androidx.lifecycle:lifecycle-reactivestreams-ktx:$lifecycle_version" // optional - Test helpers for LiveData testImplementation "androidx.arch.core:core-testing:$arch_version" // optional - Test helpers for Lifecycle runtime testImplementation "androidx.lifecycle:lifecycle-runtime-testing:$lifecycle_version" }
Kotlin
dependencies { val lifecycle_version = "2.11.0" val arch_version = "2.2.0" // ViewModel implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version") // ViewModel utilities for Compose implementation("androidx.lifecycle:lifecycle-viewmodel-compose:$lifecycle_version") // LiveData implementation("androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version") // Lifecycles only (without ViewModel or LiveData) implementation("androidx.lifecycle:lifecycle-runtime-ktx:$lifecycle_version") // Lifecycle utilities for Compose implementation("androidx.lifecycle:lifecycle-runtime-compose:$lifecycle_version") // Saved state module for ViewModel implementation("androidx.lifecycle:lifecycle-viewmodel-savedstate:$lifecycle_version") // ViewModel integration with Navigation3 implementation("androidx.lifecycle:lifecycle-viewmodel-navigation3:2.12.0-alpha04") // Annotation processor kapt("androidx.lifecycle:lifecycle-compiler:$lifecycle_version") // alternately - if using Java8, use the following instead of lifecycle-compiler implementation("androidx.lifecycle:lifecycle-common-java8:$lifecycle_version") // optional - helpers for implementing LifecycleOwner in a Service implementation("androidx.lifecycle:lifecycle-service:$lifecycle_version") // optional - ProcessLifecycleOwner provides a lifecycle for the whole application process implementation("androidx.lifecycle:lifecycle-process:$lifecycle_version") // optional - ReactiveStreams support for LiveData implementation("androidx.lifecycle:lifecycle-reactivestreams-ktx:$lifecycle_version") // optional - Test helpers for LiveData testImplementation("androidx.arch.core:core-testing:$arch_version") // optional - Test helpers for Lifecycle runtime testImplementation ("androidx.lifecycle:lifecycle-runtime-testing:$lifecycle_version") }
Java
Groovy
dependencies { def lifecycle_version = "2.11.0" def arch_version = "2.2.0" // ViewModel implementation "androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version" // LiveData implementation "androidx.lifecycle:lifecycle-livedata:$lifecycle_version" // Lifecycles only (without ViewModel or LiveData) implementation "androidx.lifecycle:lifecycle-runtime:$lifecycle_version" // Saved state module for ViewModel implementation "androidx.lifecycle:lifecycle-viewmodel-savedstate:$lifecycle_version" // Annotation processor annotationProcessor "androidx.lifecycle:lifecycle-compiler:$lifecycle_version" // alternately - if using Java8, use the following instead of lifecycle-compiler implementation "androidx.lifecycle:lifecycle-common-java8:$lifecycle_version" // optional - helpers for implementing LifecycleOwner in a Service implementation "androidx.lifecycle:lifecycle-service:$lifecycle_version" // optional - ProcessLifecycleOwner provides a lifecycle for the whole application process implementation "androidx.lifecycle:lifecycle-process:$lifecycle_version" // optional - ReactiveStreams support for LiveData implementation "androidx.lifecycle:lifecycle-reactivestreams:$lifecycle_version" // optional - Test helpers for LiveData testImplementation "androidx.arch.core:core-testing:$arch_version" // optional - Test helpers for Lifecycle runtime testImplementation "androidx.lifecycle:lifecycle-runtime-testing:$lifecycle_version" }
Kotlin
dependencies { val lifecycle_version = "2.11.0" val arch_version = "2.2.0" // ViewModel implementation("androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version") // LiveData implementation("androidx.lifecycle:lifecycle-livedata:$lifecycle_version") // Lifecycles only (without ViewModel or LiveData) implementation("androidx.lifecycle:lifecycle-runtime:$lifecycle_version") // Saved state module for ViewModel implementation("androidx.lifecycle:lifecycle-viewmodel-savedstate:$lifecycle_version") // Annotation processor annotationProcessor("androidx.lifecycle:lifecycle-compiler:$lifecycle_version") // alternately - if using Java8, use the following instead of lifecycle-compiler implementation("androidx.lifecycle:lifecycle-common-java8:$lifecycle_version") // optional - helpers for implementing LifecycleOwner in a Service implementation("androidx.lifecycle:lifecycle-service:$lifecycle_version") // optional - ProcessLifecycleOwner provides a lifecycle for the whole application process implementation("androidx.lifecycle:lifecycle-process:$lifecycle_version") // optional - ReactiveStreams support for LiveData implementation("androidx.lifecycle:lifecycle-reactivestreams:$lifecycle_version") // optional - Test helpers for LiveData testImplementation("androidx.arch.core:core-testing:$arch_version") // optional - Test helpers for Lifecycle runtime testImplementation("androidx.lifecycle:lifecycle-runtime-testing:$lifecycle_version") }
ดูข้อมูลเพิ่มเติมเกี่ยวกับการขึ้นต่อกันได้ที่เพิ่มการขึ้นต่อกันของบิลด์
ความคิดเห็น
ความคิดเห็นของคุณช่วยปรับปรุง Jetpack ให้ดียิ่งขึ้น โปรดแจ้งให้เราทราบหากคุณพบปัญหาใหม่หรือมีแนวคิดในการปรับปรุงไลบรารีนี้ โปรดดูปัญหาที่มีอยู่ในคลังนี้ก่อนที่จะสร้างปัญหาใหม่ คุณสามารถโหวตปัญหาที่มีอยู่ได้โดยคลิกปุ่มดาว
ดูข้อมูลเพิ่มเติมได้ที่เอกสารประกอบของ Issue Tracker
เวอร์ชัน 2.12
เวอร์ชัน 2.12.0-alpha06
18 พฤศจิกายน 2569
androidx.lifecycle:lifecycle-*:2.12.0-alpha06 เผยแพร่แล้ว เวอร์ชัน 2.12.0-alpha06 มี คอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ย้ายข้อมูล
LocalLifecycleOwnerเพื่อใช้compositionLocalWithHostDefaultOfและLifecycleOwnerHostDefaultKeyโดยแยกออกจากการดึงข้อมูลโดยตรงเป็นส่วนหนึ่งของ View Tree นอก Android (I7c265)
แก้ไขข้อบกพร่อง
- จาก Lifecycle 2.11.1: พร็อพเพอร์ตี้
currentStateFlowของLifecycleRegistryจะแสดงผลอินสแตนซ์เดียวกันกับการเรียกใช้แต่ละครั้ง แทนที่จะสร้างอินสแตนซ์ใหม่ทุกครั้ง (I1ae01, b/579057749)
เวอร์ชัน 2.12.0-alpha05
21 ตุลาคม 2569
androidx.lifecycle:lifecycle-*:2.12.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 2.12.0-alpha05 มี Commit เหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้
SavedStateHandleมีฟังก์ชันที่ผสานรวมกับSavedStateContainerมีasContainer()เพื่อเปลี่ยนSavedStateHandleเป็นSavedStateContainer,getOrCreateContainer()เพื่อสร้างคอนเทนเนอร์ย่อยภายในแฮนเดิล และgetOrCreateSavedStateHandle()ซึ่งจะสร้างSavedStateHandleย่อยภายในคอนเทนเนอร์ปัจจุบัน การเปลี่ยนไปใช้SavedStateContainerยังทำให้การใช้getStateFlowและgetLiveDataร่วมกันในSavedStateHandleไม่ถูกต้องอีกต่อไป และการทำเช่นนั้นจะทำให้เกิดIllegalArgumentException(I62f36)
เวอร์ชัน 2.12.0-alpha04
23 กันยายน 2569
androidx.lifecycle:lifecycle-*:2.12.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.12.0-alpha04 มี คอมมิตเหล่านี้
เวอร์ชัน 2.12.0-alpha03
9 กันยายน 2026
androidx.lifecycle:lifecycle-*:2.12.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.12.0-alpha03 มี คอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- อัปเดต
compileSdkสำหรับไลบรารี Compose เป็น 37.1 แล้ว ซึ่งจะต้องอัปเดตcompileSdkแบบทรานซิทีฟสำหรับแอปและไลบรารีทั้งหมดที่ใช้ Compose (I05b0f)
เวอร์ชัน 2.12.0-alpha02
26 สิงหาคม 2026
androidx.lifecycle:lifecycle-*:2.12.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.12.0-alpha02 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
AutoRecreatedและrunOnNextRecreationเลิกใช้งานแล้วเพื่อใช้SavedStateProviderและSavedStateRestorerแทน (Iadc00)
เวอร์ชัน 2.12.0-alpha01
12 สิงหาคม 2569
androidx.lifecycle:lifecycle-*:2.12.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.12.0-alpha01 มี คอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- เลิกใช้งานอาร์ติแฟกต์โปรเซสเซอร์สำหรับคำอธิบายประกอบ
lifecycle-compilerโปรดเปลี่ยนไปใช้DefaultLifecycleObserverหรือLifecycleEventObserverแทนการใช้โปรเซสเซอร์สำหรับคำอธิบายประกอบ (Ibf571, b/541926513) - ตอนนี้
SavedStateViewModelFactoryและAbstractSavedStateViewModelFactoryจะหยุดทำงานทันทีหากSavedStateRegistryOwnerที่ระบุไม่ได้ใช้ViewModelStoreOwnerเพื่อป้องกันไม่ให้เกิดข้อขัดข้องที่ล่าช้าในระหว่างการสร้างคอมโพเนนต์ใหม่ (Icf317) - เพิ่มการติดตามของระบบไปยังการส่งเหตุการณ์
LifecycleRegistryรายการ (Ie1f92, b/112161409)
เวอร์ชัน 2.11
เวอร์ชัน 2.11.1
18 พฤศจิกายน 2569
androidx.lifecycle:lifecycle-*:2.11.1 เผยแพร่แล้ว เวอร์ชัน 2.11.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้พร็อพเพอร์ตี้
currentStateFlowของLifecycleRegistryจะแสดงผลอินสแตนซ์เดียวกันกับการเรียกใช้แต่ละครั้ง แทนที่จะสร้างอินสแตนซ์ใหม่ทุกครั้ง (I1ae01, b/579057749)
เวอร์ชัน 2.11.0
17 มิถุนายน 2026
androidx.lifecycle:lifecycle-*:2.11.0 เผยแพร่แล้ว เวอร์ชัน 2.11.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.10.0
ViewModel ที่กำหนดขอบเขตใน Compose - การเปิดตัว ViewModelStoreProvider, rememberViewModelStoreProvider และ rememberViewModelStoreOwner เพื่อเชื่อมโยง ViewModel กับขอบเขต UI ที่เฉพาะเจาะจง (เช่น หน้าเพจเจอร์) โดยจะคงอยู่แม้มีการเปลี่ยนแปลงการกำหนดค่า และจะล้างโดยอัตโนมัติเมื่อนำ Composable ออกจากลำดับชั้น
การรองรับ KMP - ตอนนี้ ViewModel-Compose และ ViewModel-Navigation3 รองรับเป้าหมาย Kotlin Multiplatform ทั้งหมดแล้ว
การผสานรวม Navigation3 - ตอนนี้ ViewModelStoreNavEntryDecorator ยอมรับ ViewModelStoreOwner เพื่อเผยแพร่ CreationExtras และโรงงานไปยัง ViewModel ที่ฝังอยู่ นอกจากนี้ คุณยังยกผู้ให้บริการโดยใช้โอเวอร์โหลด rememberViewModelStoreNavEntryDecorator ใหม่เพื่อรองรับ Back Stack หลายรายการได้ด้วย removeViewModelStoreOnPop เลิกใช้งานแล้ว
Lifecycle Utilities - เพิ่มส่วนขยาย ViewModelProvider.get<VM>(key) ที่ผ่านการตรวจสอบประเภท, Lifecycle.addObserver ที่ใช้ Lambda และส่วนขยายเริ่มต้นของโรงงานสำหรับ ViewModelStoreOwner ตอนนี้ ViewModel.onCleared มีคำอธิบายประกอบเป็น @EmptySuper แล้ว
การเปลี่ยนแปลงอื่นๆ - ตอนนี้ต้องใช้ Compose UI 1.7.0+ สำหรับ LocalLifecycleOwner เพื่อนำการใช้ Reflection เป็นทางเลือกสุดท้ายออก การอัปเดต Compose compileSdk ต้องใช้ AGP เวอร์ชัน 9.2.0 เป็นอย่างน้อย
เวอร์ชัน 2.11.0-rc01
3 มิถุนายน 2026
androidx.lifecycle:lifecycle-*:2.11.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.11.0-rc01 มี คอมมิตเหล่านี้
เวอร์ชัน 2.11.0-beta02
19 พฤษภาคม 2026
androidx.lifecycle:lifecycle-*:2.11.0-beta02 เผยแพร่แล้ว เวอร์ชัน 2.11.0-beta02 มี Commits เหล่านี้
การเปลี่ยนแปลง API
- เพิ่มโอเวอร์โหลด
rememberViewModelStoreNavEntryDecoratorที่ยอมรับViewModelStoreProviderซึ่งช่วยให้นักพัฒนาแอปสามารถยกผู้ให้บริการขึ้นเหนือขอบเขต Composition ของเดคอเรเตอร์ได้ ซึ่งจะช่วยให้สามารถใช้ Use Case ต่างๆ เช่น การรองรับ Back Stack หลายรายการที่มีรายการเดียวกันอยู่ในทั้ง 2 รายการแต่ต้องมีสถานะแยกกัน (Ibbbfe, b/503420425) - ป้องกันการล้าง
ViewModelsที่แชร์ก่อนเวลาอันควรเมื่อนำผู้ให้บริการที่เกี่ยวข้องออกจากองค์ประกอบ (Ib321a)
แก้ไขข้อบกพร่อง
- ต้องใช้ Compose UI 1.7.0 ขึ้นไปเพื่อใช้
LocalLifecycleOwnerการดำเนินการนี้จะนำการสำรองข้อมูลการสะท้อนภายในออก ซึ่งจะช่วยปรับปรุงประสิทธิภาพ แต่บังคับให้อัปเกรดทรัพยากร Dependency ที่เข้มงวดสำหรับไคลเอ็นต์ (I48e65) - ป้องกันการซ้ำกันของสัญลักษณ์กับเวอร์ชัน Fork ของ JetBrains ที่เก่ากว่าเมื่ออัปเกรดเป็น Compose Multiplatform 1.11.0 (Iccd64)
- แก้ไขปัญหาที่
ViewModelsถูกล้างอย่างไม่ถูกต้องระหว่างการจัดองค์ประกอบใหม่เมื่อใช้rememberViewModelStoreProviderกับพารามิเตอร์เริ่มต้นที่ไม่เสถียร ตอนนี้ผู้ให้บริการจะสร้างใหม่เฉพาะเมื่อเจ้าของหลักหรือคีย์ที่ระบุอย่างชัดเจนมีการเปลี่ยนแปลง (Ibe296, b/501792448)
เวอร์ชัน 2.11.0-beta01
22 เมษายน 2026
androidx.lifecycle:lifecycle-*:2.11.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.11.0-beta01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- แยก
rememberViewModelStoreOwnerและrememberViewModelStoreProviderออกเป็นฟังก์ชันแยกต่างหากสำหรับกรณีการใช้งานแบบมีคีย์และไม่มีคีย์ (Ifd154, b/500802788)
แก้ไขข้อบกพร่อง
- อัปเดต Compose
compileSdkเป็น API 37 แล้ว ซึ่งหมายความว่าต้องใช้ AGP เวอร์ชัน 9.2.0 เป็นอย่างน้อยเมื่อใช้ Compose (Id45cd, b/413674743)
เวอร์ชัน 2.11.0-alpha03
25 มีนาคม 2026
androidx.lifecycle:lifecycle-*:2.11.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.11.0-alpha03 มี Commit เหล่านี้
การเปลี่ยนแปลง API
- ทำให้
parentKeyเป็นพารามิเตอร์ที่ไม่บังคับในคอนสตรักเตอร์ViewModelStoreProviderโดยมีค่าเริ่มต้นเป็นnullและย้ายไปไว้หลังparentStoreหรือparentOwnerซึ่งจะช่วยให้การสร้างอินสแตนซ์ง่ายขึ้นเมื่อไม่จำเป็นต้องใช้คีย์ขอบเขตที่แชร์ (I66b67) - ตอนนี้
ViewModelStoreNavEntryDecoratorยอมรับViewModelStoreOwnerแทนViewModelStoreแล้ว ซึ่งช่วยให้ Navigation3 เผยแพร่CreationExtrasและViewModelProvider.Factoryเริ่มต้นของระดับบนไปยัง ViewModel ที่ฝังอยู่ได้ เพื่อให้มั่นใจว่ารองรับทรัพยากร Dependency ระดับแอปพลิเคชัน (Ia6018, b/434651920) - แยกสถานะ
ViewModelStoreProviderโดยใช้คีย์ที่ไม่ซ้ำกัน ซึ่งจะป้องกันไม่ให้ผู้ให้บริการที่อยู่ระดับเดียวกันล้าง ViewModel ของกันและกันโดยไม่ตั้งใจระหว่างการกำจัด (I59c0b, b/434651920) - เพิ่มฟังก์ชันส่วนขยาย
ViewModelProvider.get<VM>(key: String)ซึ่งช่วยให้นักพัฒนาแอปดึงข้อมูล ViewModels ได้อย่างเป็นระเบียบมากขึ้นโดยใช้keyที่กำหนดเองพร้อมพารามิเตอร์ประเภท Reified ของ Kotlin ซึ่งช่วยลดความจำเป็นในการส่งประเภทคลาสอย่างชัดเจน (Ic1f59) - เพิ่มการรองรับ
defaultArgsไปยังViewModelStoreProviderเพื่ออนุญาตให้เริ่มต้น ViewModels ด้วยค่าSavedStateเริ่มต้น (I1e933, b/434651920, b/165642391) - เลิกใช้งาน
removeViewModelStoreOnPopและViewModelStoreNavEntryDecoratorDefaultsที่เชื่อมโยง API นี้เป็นวิธีแก้ปัญหาชั่วคราวสำหรับการเปลี่ยนแปลงการกำหนดค่า ซึ่งตอนนี้ได้รับการจัดการภายในแล้ว ตอนนี้สถานะเดคอเรเตอร์ทั้งหมด รวมถึง ViewModel ต้องถูกล้างพร้อมกันเมื่อมีการแสดงป๊อปอัป หากต้องการเก็บสถานะเดคอเรเตอร์ไว้นอกเหนือจากเมื่อมีการส่ง Back Stack นั้นไปยัง NavDisplay ให้ใช้rememberDecoratedNavEntriesAPI (I852d9)
แก้ไขข้อบกพร่อง
- เพิ่ม
toString()ลงในCreationExtras.Keyเพื่อแสดงชื่อชั้นเรียน (I5de52)
เวอร์ชัน 2.11.0-alpha02
11 มีนาคม 2026
androidx.lifecycle:lifecycle-*:2.11.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.11.0-alpha02 มีคอมมิตเหล่านี้
ViewModel ที่กำหนดขอบเขต
รุ่นนี้เปิดตัว API เพื่อสร้างอินสแตนซ์
ViewModelStoreที่กำหนดขอบเขตใน Compose ซึ่งจะช่วยให้ViewModelsเชื่อมโยงกับขอบเขต UI ที่เฉพาะเจาะจงได้ (เช่น หน้าPagerแต่ละหน้าหรือรายการLazyList)ViewModelsเหล่านี้จะยังคงอยู่แม้จะมีการเปลี่ยนแปลงการกำหนดค่า และจะถูกล้างโดยอัตโนมัติเมื่อ Composable ที่เกี่ยวข้องถูกนำออกจากลำดับชั้นอย่างถาวร// Hoist the parent provider outside the Pager. val provider = rememberViewModelStoreProvider() val pagerState = rememberPagerState(pageCount = { 5 }) HorizontalPager(state = pagerState) { page -> // Create an owner scoped to the current page. val storeOwner = rememberViewModelStoreOwner(provider, key = page) // Provide the scoped owner to this composition. CompositionLocalProvider(LocalViewModelStoreOwner provides storeOwner) { // ViewModel is now scoped specifically to this page. val viewModel: PageViewModel = viewModel() } }
โปรดทราบว่า ViewModelStoreProvider พร้อมใช้งานนอก Compose และใช้กับกิจกรรม, Fragment และ/หรือมุมมองได้
ฟีเจอร์ใหม่
- เพิ่มการรองรับเป้าหมาย KMP ทั้งหมดลงใน ViewModel Navigation3 (I60fa5)
- เพิ่มฟังก์ชันแฟกทอรีสำหรับ
LifecycleOwner,ViewModelStoreOwnerและSavedStateRegistryOwnerเพื่อลดต้นแบบเมื่อเขียนคอมโพเนนต์เจ้าของที่กำหนดเอง (I9682c) - เพิ่มฟังก์ชันส่วนขยาย
Lifecycle.addObserverที่ใช้ Lambda เพื่ออนุญาตให้สังเกตเหตุการณ์ในวงจรโดยไม่ต้องสร้างอินสแตนซ์ออบเจ็กต์ที่ไม่ระบุชื่อ (I94f38) - เพิ่มส่วนขยาย
defaultViewModelProviderFactoryและdefaultViewModelCreationExtrasลงในViewModelStoreOwnerซึ่งจะช่วยให้เข้าถึงค่าเริ่มต้นได้อย่างปลอดภัยโดยไม่ต้องตรวจสอบประเภทกับHasDefaultViewModelProviderFactoryด้วยตนเอง (Ifa83d)
การเปลี่ยนแปลง API
- เพิ่ม
rememberViewModelStoreOwnerเพื่อสร้างViewModelStoreOwnerที่กำหนดขอบเขตใน Compose ได้อย่างง่ายดาย ฟังก์ชันนี้จะแสดงผลเจ้าของที่เชื่อมโยงกับวงจรของ Composable โดยจะล้าง ViewModel โดยอัตโนมัติเมื่อนำ Composable ออกจาก UI (I2a15b, b/165642391) - เพิ่ม
rememberViewModelStoreProviderเพื่ออนุญาตให้สร้างอินสแตนซ์ViewModelStoreที่กำหนดขอบเขตใน Compose ฟังก์ชันนี้จะลิงก์ Store ย่อยกับเจ้าของหลัก เพื่อให้มั่นใจว่า ViewModel จะยังคงอยู่เมื่อมีการเปลี่ยนแปลงการกำหนดค่า ขณะเดียวกันก็ล้าง ViewModel โดยอัตโนมัติเมื่อนำ Composable ออกจากลำดับชั้น (I0f57a, b/165642391) - เพิ่ม
ViewModelStoreProviderเพื่อจัดการอินสแตนซ์ViewModelStoreที่กำหนดขอบเขต คลาสนี้ช่วยให้สร้างขอบเขตย่อยที่ยังคงอยู่แม้จะมีการเปลี่ยนแปลงการกำหนดค่า แต่สามารถล้างข้อมูลได้อย่างอิสระ นอกจากนี้ยังมี WrapperViewModelStoreOwnerที่รับค่าโรงงานเริ่มต้นและส่วนเสริมการสร้างจากระดับบนด้วย (I87f4f, b/434651920)
เวอร์ชัน 2.11.0-alpha01
25 กุมภาพันธ์ 2026
androidx.lifecycle:lifecycle-*:2.11.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.11.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- รองรับเป้าหมาย Kotlin Multiplatform (KMP) ทั้งหมดใน ViewModel-Compose แยกการแก้ไขเจ้าของออกจาก
LocalViewเพื่อให้โฮสต์แพลตฟอร์มระบุViewModelStoreOwnerเริ่มต้นได้ ขณะเดียวกันก็ยังคงใช้LocalViewเป็นตัวเลือกสำรองที่ปลอดภัยใน Android (I09fab, b/434940570, Ic8526, b/478146897)
การเปลี่ยนแปลง API
- เพิ่มการติดตั้งใช้งาน
toStringลงในViewModelStoreซึ่งแสดงรายการคีย์ที่จัดเก็บไว้ทั้งหมดเพื่อช่วยปรับปรุงการแก้ไขข้อบกพร่อง (I0a6f4) - เพิ่มการใช้งานเริ่มต้นสำหรับ
HasDefaultViewModelProviderFactory.defaultViewModelProviderFactoryซึ่งหมายความว่าคุณไม่จำเป็นต้องลบล้างพร็อพเพอร์ตี้นี้อย่างชัดเจนอีกต่อไปเมื่อใช้งานอินเทอร์เฟซ (Ia7095) - ใส่คำอธิบายประกอบ
ViewModel.onClearedด้วย@EmptySuperเพื่อระบุอย่างชัดเจนว่าเมธอดที่ลบล้างไม่จำเป็นต้องเรียกใช้super.onCleared()(I8c226)
เวอร์ชัน 2.10
เวอร์ชัน 2.10.0
19 พฤศจิกายน 2025
androidx.lifecycle:lifecycle-*:2.10.0 เผยแพร่แล้ว เวอร์ชัน 2.10.0 มี Commit เหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.9.0:
เพิ่ม
rememberLifecycleOwnerComposable เพื่อเปิดใช้การสร้างวงจรที่กำหนดขอบเขตภายใน UI โดยตรง ซึ่งจะเป็นประโยชน์สำหรับคอมโพเนนต์ที่ต้องจัดการวงจรของตนเองอย่างอิสระ เช่นHorizontalPagerที่ต้องการทำให้หน้าปัจจุบันเป็นRESUMEDเท่านั้น หรือไลบรารีอย่าง Navigation3@Composable fun MyComposable() { // This LifecycleOwner is automatically moved to DESTROYED when // it leaves composition and its maxLifecycle is the maximum of either // the maxLifecycle you set or the Lifecycle.State of the parentLifecycleOwner val lifecycleOwner = rememberLifecycleOwner( maxLifecycle = RESUMED, parentLifecycleOwner = LocalLifecycleOwner.current, ) CompositionLocalProvider(LocalLifecycleOwner provides lifecycleOwner) { val childLifecycleOwner = LocalLifecycleOwner.current } }อาร์ติแฟกต์
lifecycle-viewmodel-navigation3มีการผสานรวมที่สร้างไว้ล่วงหน้าสำหรับ Navigation3 ซึ่งช่วยให้คุณเปิดใช้อินสแตนซ์ViewModelที่กำหนดขอบเขตไปยังหน้าจอแต่ละหน้าจอ ("รายการ") ได้โดยใช้ APIrememberViewModelStoreNavEntryDecorator()ดังนี้@Composable fun MyComposable() { NavDisplay( backStack = backStack, entryDecorators = listOf( rememberSaveableStateHolderNavEntryDecorator(), // Add this line to automatically scope ViewModels to each entry rememberViewModelStoreNavEntryDecorator(), ), entryProvider = entryProvider { // Add your entries here } } }เพิ่มฟังก์ชัน Builder Factory สำหรับ
CreationExtrasเพื่อให้ Kotlin API มีความสะดวกและเป็นสำนวนมากขึ้นoverride val defaultViewModelCreationExtras: CreationExtras // Use the CreationExtras builder to add in a custom value to the default // CreationExtras in your Activity or Fragment get() = super.defaultViewModelCreationExtras + CreationExtras { this[CustomKey] = "customValue" }เพิ่มการรองรับแบบเนทีฟสำหรับประเภทที่อนุญาตค่า Null ใน
SavedStateHandle.savedซึ่งช่วยให้บันทึกและกู้คืนพร็อพเพอร์ตี้ที่อนุญาตค่า Null ได้ง่ายขึ้นทำเครื่องหมายผู้ผลิต
SavedStateHandleรายเป็น@VisibleForTestingminSdk เปลี่ยนจาก API 21 เป็น API 23
เวอร์ชัน 2.10.0-rc01
5 พฤศจิกายน 2025
androidx.lifecycle:lifecycle-*:2.10.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.10.0-rc01 มีคอมมิตเหล่านี้
เวอร์ชัน 2.10.0-beta01
22 ตุลาคม 2025
androidx.lifecycle:lifecycle-*:2.10.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.10.0-beta01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
ViewModelStoreNavEntryDecoratorDefaultเปลี่ยนชื่อเป็นViewModelStoreNavEntryDecoratorDefaultsโดยมี "s" ต่อท้าย (I6d27b, b/444447434)
แก้ไขข้อบกพร่อง
rememberLifecycleOwnerจะไม่ขัดข้องอีกต่อไปหากเจ้าของได้รับเหตุการณ์Lifecycle.Event.ON_DESTROYก่อนที่จะย้ายไปยังLifeycle.State.CREATED(I6f98e, b/444594991)
เวอร์ชัน 2.10.0-alpha05
8 ตุลาคม 2025
androidx.lifecycle:lifecycle-*:2.10.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 2.10.0-alpha05 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้
removeViewModelStoreOnPopCallback()เป็นส่วนหนึ่งของออบเจ็กต์ViewModelStoreNavEntryDecoratorDefaultซึ่งเป็นตำแหน่งที่แพลตฟอร์มและการติดตั้งใช้งานอื่นๆ สามารถเรียกใช้ค่าเริ่มต้นได้ (Ia1f23, b/444447434) - เปลี่ยนโครงสร้างภายในโค้ด
ViewModelStoreNavEntryDecoratorจากฟังก์ชันเป็นคลาสเพื่อให้สอดคล้องกับฟังก์ชันการทำงานในฐานะโรงงานสำหรับNavEntryDecoratorได้ดียิ่งขึ้น และเปลี่ยนชื่อพารามิเตอร์shouldRemoveViewModelStoreของเดคอเรเตอร์เป็นremoveViewModelStoreOnPopเพื่อชี้แจงว่าระบบจะเรียกใช้ Callback นี้เฉพาะเมื่อมีการดึงรายการออกจากbackStackเท่านั้น (Iefdc5, b/444447434)
เวอร์ชัน 2.10.0-alpha04
24 กันยายน 2025
androidx.lifecycle:lifecycle-*:2.10.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.10.0-alpha04 มี คอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เปลี่ยนโครงสร้าง
LifecycleOwnerComposable เป็นrememberLifecycleOwnerตอนนี้ฟังก์ชันจะแสดงผลLifecycleOwnerโดยตรง หากต้องการระบุเจ้าของรายนี้ให้กับองค์ประกอบย่อย ให้ใช้CompositionLocalProvider(Ic57f0, b/444446629) - เพิ่มสตับ KMP ลงใน lifecycle-viewmodel-navigation3 เพื่อให้ JetBrains สามารถจัดหา Fork ที่เติมเต็มเป้าหมายเหล่านี้และรองรับ CMP (I44a4c)
เวอร์ชัน 2.10.0-alpha03
27 สิงหาคม 2025
androidx.lifecycle:lifecycle-*:2.10.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.10.0-alpha03 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- อัปเดต Compose เป็น 1.9.0 (I2b9de)
เวอร์ชัน 2.10.0-alpha02
13 สิงหาคม 2025
androidx.lifecycle:lifecycle-*:2.10.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.10.0-alpha02 มี Commit เหล่านี้
ฟีเจอร์ใหม่
ตอนนี้ Composable
LifecycleOwnerสามารถสร้างวงจรรากแบบสแตนด์อโลนได้แล้ว การตั้งค่าparent = null(อย่างชัดแจ้ง) จะทำให้วงจรใหม่ทำงานแยกจากโฮสต์ (เช่นActivity,FragmentหรือNavBackStackEntry) โดยจะเริ่มทันทีที่ Composable เข้าสู่ Composition และจะถูกทำลายโดยอัตโนมัติเมื่อออกจาก Composition (I8dfbe, b/433659048)@Composable fun IndependentComponent() { // Create a standalone lifecycle, not tied to the parent Activity/Fragment. LifecycleOwner(parent = null) { val rootLifecycle = LocalLifecycleOwner.current.lifecycle } }
การเปลี่ยนแปลง API
- ใน
LifecycleOwnercomposable พารามิเตอร์parentLifecycleOwnerได้เปลี่ยนชื่อเป็นparent(I080bc)
แก้ไขข้อบกพร่อง
- ตอนนี้
LifecycleOwnercomposable จะย้ายวงจรไปยังDESTROYEDอย่างถูกต้องเมื่อมีการกำจัด ซึ่งจะป้องกันการรั่วไหลที่อาจเกิดขึ้นสำหรับโค้ดภายนอกที่มีการอ้างอิงถึงวงจร (I9e5b7, b/433659048) - การย้าย minSdk เริ่มต้นจาก API 21 ไปยัง API 23 (Ibdfca, b/380448311, b/435705964, b/435705223)
การมีส่วนร่วมจากภายนอก
- นำฟิลด์สำรองภายในที่ไม่จำเป็นออกจาก
LifecycleOwnerขอขอบคุณ Jake Wharton สำหรับการมีส่วนร่วม (Ideddb)
เวอร์ชัน 2.10.0-alpha01
30 กรกฎาคม 2025
androidx.lifecycle:lifecycle-*:2.10.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.10.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
เพิ่ม
LifecycleOwnerComposable เพื่อเปิดใช้การสร้างวงจรที่กำหนดขอบเขตภายใน UI โดยตรง ซึ่งจะเป็นประโยชน์สำหรับคอมโพเนนต์ที่ต้องจัดการวงจรของตนเองอย่างอิสระ ดูตัวอย่างวิธีที่ Navigation3 ผสานรวม Composable ใหม่นี้ได้ที่ aosp/3708610 (76cbf7)@Composable fun MyComposable() { LifecycleOwner( maxLifecycle = RESUMED, parentLifecycleOwner = LocalLifecycleOwner.current, ) { val childLifecycleOwner = LocalLifecycleOwner.current } }
การเปลี่ยนแปลง API
- เพิ่มฟังก์ชัน Builder Factory สำหรับ
CreationExtrasเพื่อให้ Kotlin API มีความสะดวกและเป็นสำนวนมากขึ้น (Iab2bd) - เพิ่มการรองรับแบบเนทีฟสำหรับประเภทที่อนุญาตค่า Null ใน
SavedStateHandle.savedซึ่งช่วยให้บันทึกและกู้คืนพร็อพเพอร์ตี้ที่อนุญาตค่า Null ได้ง่ายขึ้น (I54d69, b/421325690) - ทำเครื่องหมายผู้ผลิต
SavedStateHandleรายเป็น@VisibleForTesting(Iff0e0, b/408002794)
เวอร์ชัน 2.9
เวอร์ชัน 2.9.4
17 กันยายน 2025
androidx.lifecycle:lifecycle-*:2.9.4 เผยแพร่แล้ว เวอร์ชัน 2.9.4 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อผิดพลาดที่ไม่ได้ใช้ปลั๊กอินคอมไพเลอร์ Compose ซึ่งทำให้ Lifecycle KMP Artifact เสียหาย (Ie95bc, b/443096483, b/443965665)
เวอร์ชัน 2.9.3
27 สิงหาคม 2025
androidx.lifecycle:lifecycle-*:2.9.3 เผยแพร่แล้ว เวอร์ชัน 2.9.3 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่มเป้าหมาย Kotlin Multiplatform (KMP) ใหม่ลงในอาร์ติแฟกต์ Lifecycle
*-composeตอนนี้ Lifecycle รองรับแพลตฟอร์มทั้งหมดต่อไปนี้ ได้แก่ JVM (Android และเดสก์ท็อป), เนทีฟ (Linux, iOS, watchOS, macOS, MinGW) และเว็บ (JavaScript, WasmJS) (I0a0e4)
แก้ไขข้อบกพร่อง
- อัปเดต
androidx.annotationเป็น 1.9.1 (Ic9e4f, b/397701294)
เวอร์ชัน 2.9.2
16 กรกฎาคม 2025
androidx.lifecycle:lifecycle-*:2.9.2 เผยแพร่แล้ว เวอร์ชัน 2.9.2 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- เพิ่มเป้าหมาย Kotlin Multiplatform (KMP) ใหม่ลงในอาร์ติแฟกต์วงจร ตอนนี้ Lifecycle รองรับแพลตฟอร์มทั้งหมดต่อไปนี้ ได้แก่ JVM (Android และเดสก์ท็อป), เนทีฟ (Linux, iOS, watchOS, macOS, MinGW) และเว็บ (JavaScript, WasmJS) โปรดทราบว่าไม่มีการเพิ่มเป้าหมาย KMP ใหม่ลงในอาร์ติแฟกต์
*-composeเนื่องจากขึ้นอยู่กับ Compose 1.9 เวอร์ชันเสถียร (I01cb8)
การอัปเดตทรัพยากร Dependency
- ตอนนี้ Lifecycle ขึ้นอยู่กับ Annotation
1.9.1เพื่อเปิดใช้การรองรับเป้าหมาย KMP ใหม่ (Ic9e4f, b/397701294)
เวอร์ชัน 2.9.1
4 มิถุนายน 2025
androidx.lifecycle:lifecycle-*:2.9.1 เผยแพร่แล้ว เวอร์ชัน 2.9.1 มี Commit เหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่
SavedStateHandle.remove(key)ไม่ล้างสถานะSavedStateHandle.getMutableStateFlow(key)(d5f939, b/418746333)
เวอร์ชัน 2.9.0
7 พฤษภาคม 2025
androidx.lifecycle:lifecycle-*:2.9.0 เผยแพร่แล้ว เวอร์ชัน 2.9.0 มี Commit เหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.8.0
- อาร์ติแฟกต์ KMP
androidx.lifecycle:lifecycle-viewmodel-testingใหม่พร้อมใช้งานแล้ว ซึ่งมีคลาสViewModelScenarioสำหรับทดสอบViewModelsแยกต่างหาก พร้อมรองรับonClearedและSavedStateHandleรวมถึงการทดสอบการสิ้นสุดการประมวลผลและการสร้างใหม่ผ่านrecreate() - เพิ่ม
getMutableStateFlowไปยังSavedStateHandleเพื่อแสดงผลMutableStateFlowฟังก์ชันใหม่นี้ใช้ได้เฉพาะกับคีย์เท่านั้น และใช้กับgetLiveDataไม่ได้ ระบบจะแสดงข้อยกเว้นหากคุณพยายามใช้ทั้ง 2 อย่างเพื่อเข้าถึงสถานะเดียวกัน - ตอนนี้
CreationExtrasมีโอเปอเรเตอร์โอเวอร์โหลดที่คล้ายกับแผนที่เพื่อเปิดใช้การจัดการเนื้อหาตามสำนวนใน Kotlin ซึ่งช่วยให้ใช้in,+=และ+กับCreationExtrasได้
การรองรับการแปลง KotlinX เป็นอนุกรม
ด้วยการรองรับ KotlinX Serialization ที่เพิ่มเข้ามาใน SavedState
1.3.0เราได้เปิดตัวsavedซึ่งเป็นตัวแทนพร็อพเพอร์ตี้แบบ Lazy เพื่อให้จัดเก็บคลาส@SerializableในSavedStateHandleได้ง่าย และให้คลาสเหล่านั้นได้รับการกู้คืนโดยอัตโนมัติเมื่อสิ้นสุดการประมวลผลและการสร้างใหม่ โปรดทราบว่าผู้รับมอบสิทธิ์savedเป็นแบบ Lazy และจะไม่เรียกใช้ Lambdainitหรือบันทึกสิ่งใดลงในSavedStateHandleจนกว่าจะมีการเข้าถึง@Serializable data class Person(val firstName: String, val lastName: String) class MyViewModel(handle: SavedStateHandle) : ViewModel() { var person by handle.saved { Person("John", "Doe") } fun onPersonChanged(person: Person) { this.person = person } }
Kotlin Multiplatform
- ตอนนี้โมดูล
lifecycle-testingเข้ากันได้กับ KMP แล้ว รวมถึง API เช่นTestLifecycleOwner - ตอนนี้โมดูล
lifecycle-viewmodel-savedstateเข้ากันได้กับ KMP แล้ว รวมถึง API เช่นSavedStateHandle - ตอนนี้
androidx.compose.ui.platform.LocalLifecycleOwnerพร้อมใช้งานในชุดซอร์สทั่วไปแล้ว - ตอนนี้
NewInstanceFactoryพร้อมใช้งานในเป้าหมาย JVM Desktop และ Android แล้ว
การเปลี่ยนแปลงพฤติกรรม
- สถานะ
Lifecycle.DESTROYEDเป็นสถานะสุดท้าย และความพยายามใดๆ ในการย้ายLifecycleจากสถานะนี้ไปยังสถานะอื่นจะส่งผลให้เกิดIllegalStateException SavedStateHandleจะไม่มีSavedStateProvider.saveState()ใดๆ อีกต่อไปในกรณีที่Bundleที่แสดงผลว่างเปล่า
เวอร์ชัน 2.9.0-rc01
23 เมษายน 2025
androidx.lifecycle:lifecycle-*:2.9.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.9.0-rc01 มีคอมมิตเหล่านี้
คำเตือนเกี่ยวกับความเข้ากันได้ของ Lint API
- JetBrains เปลี่ยน
KaCallableMemberCallจากคลาสเป็นอินเทอร์เฟซ ซึ่งทำให้ความเข้ากันได้ของไบนารีเสียหาย ซึ่งอาจทำให้เกิดข้อขัดข้องหากเวอร์ชัน AGP ของโปรเจ็กต์แตกต่างจากเวอร์ชันที่ใช้คอมไพล์การตรวจสอบ Lint การอัปเดตนี้ดำเนินการใน aosp/3577172 แต่ไม่มีในบันทึกประจำรุ่น เราจึงขอชี้แจงที่นี่ วิธีแก้ไขที่แนะนำ: อัปเดตเป็น AGP เวอร์ชันเสถียรล่าสุด หากอัปเดตทั้งหมดไม่ได้ ให้ใช้android.experimental.lint.versionเพื่อปรับการตรวจสอบ Lint ให้สอดคล้องกับเวอร์ชัน AGP ของคุณ ดูรายละเอียดได้ที่การเปลี่ยนแปลงลักษณะการทำงานของ Compose Runtime
เวอร์ชัน 2.9.0-beta01
9 เมษายน 2025
androidx.lifecycle:lifecycle-*:2.9.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.9.0-beta01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้
Lifecycle ViewModel Composeใช้การตั้งค่า Kotlin Multiplatform แบบเดียวกับ Compose Runtime 1.7.1 ขึ้นไป โดยตอนนี้ระบบได้นำอาร์ติแฟกต์-desktopออกแล้ว และเพิ่มอาร์ติแฟกต์-jvmStubsและ-linuxx64Stubsเข้ามา None of these targets are meant to be used, they are placeholders to help Jetbrains Compose efforts. (I5cb14, b/406592090)
การอัปเดตทรัพยากร Dependency
- ตอนนี้ไลบรารีนี้กำหนดเป้าหมายเป็นระดับภาษา Kotlin 2.0 และต้องใช้ KGP 2.0.0 ขึ้นไป (Idb6b5)
- ตอนนี้
Lifecycle ViewModel Composeต้องใช้ Compose 1.7.8 (I5cb14, b/406592090)
เวอร์ชัน 2.9.0-alpha13
26 มีนาคม 2025
androidx.lifecycle:lifecycle-*:2.9.0-alpha13 เปิดตัวโดยไม่มีการเปลี่ยนแปลงที่สำคัญต่อสาธารณะ เวอร์ชัน 2.9.0-alpha13 มีคอมมิตเหล่านี้
เวอร์ชัน 2.9.0-alpha12
12 มีนาคม 2025
androidx.lifecycle:lifecycle-*:2.9.0-alpha12 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha12 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เพิ่มคำอธิบายประกอบ
@MainThreadลงในViewModelProvider.getในแพลตฟอร์ม KMP ที่รองรับทั้งหมด (I7e8dd, b/397736115) - เปลี่ยนชื่อ
SavedState*Delegatesเป็นSavedState*Delegate(I8589b, b/399629301)
เวอร์ชัน 2.9.0-alpha11
26 กุมภาพันธ์ 2025
androidx.lifecycle:lifecycle-*:2.9.0-alpha11 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha11 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เพิ่มพารามิเตอร์
SavedStateConfigไปยังผู้รับมอบสิทธิ์saved()(I39b3a)
เวอร์ชัน 2.9.0-alpha10
12 กุมภาพันธ์ 2025
androidx.lifecycle:lifecycle-*:2.9.0-alpha10 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha10 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ย้าย
MutableStateSerializerไปยังsavedstate-composeจากlifecycle-viewmodel-compose(I4f690, b/378895074)
การมีส่วนร่วมจากภายนอก
- เพิ่มปัญหา Lint ใหม่สำหรับการเรียก
Lifecycle::currentStateในองค์ประกอบ โดยแนะนำให้ใช้currentStateAsalue().valueแทนเพื่อให้แน่ใจว่าการเปลี่ยนแปลงในสถานะวงจรชีวิตทำให้เกิดการจัดองค์ประกอบใหม่ได้อย่างถูกต้อง ขอบคุณ Steven Schoen (Iad484)
เวอร์ชัน 2.9.0-alpha09
29 มกราคม 2025
androidx.lifecycle:lifecycle-*:2.9.0-alpha09 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha09 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่ม
MutableStateSerializerสำหรับการจัดลำดับandroidx.compose.runtime.MutableState(Idfc48, b/378895074)
การเปลี่ยนแปลง API
- แทนที่ฟังก์ชันตัวแทน
SavedStateHandle.saved()ที่โอเวอร์โหลดด้วยพารามิเตอร์เริ่มต้น (Icd1c1) AbstractSavedStateViewModelFactoryเลิกใช้งานแล้วเนื่องจากสร้างSavedStateHandleสำหรับViewModelทุกรายการ ซึ่งทำให้เกิดค่าใช้จ่ายเพิ่มเติมโดยไม่จำเป็น ใช้ViewModelProvider.FactoryกับCreationExtras.createSavedStateHandleแทนเพื่อสร้างViewModelได้อย่างมีประสิทธิภาพมากขึ้น (Ia920b, b/388590327)
เวอร์ชัน 2.9.0-alpha08
11 ธันวาคม 2024
androidx.lifecycle:lifecycle-*:2.9.0-alpha08 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha08 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่ม
ViewModelScenario.recreateเพื่อจำลองการสิ้นสุดการประมวลผลของระบบที่สร้างViewModelที่อยู่ระหว่างการทดสอบและคอมโพเนนต์ที่เกี่ยวข้องทั้งหมดขึ้นมาใหม่ (Id6a69, b/381063087) - ตอนนี้อินสแตนซ์
LifecycleOwnerและViewModelStoreOwnerที่ดึงข้อมูลผ่าน APIfindViewTreeที่เกี่ยวข้องสามารถแก้ไขได้ผ่านองค์ประกอบหลักที่ไม่ต่อเนื่องกันของมุมมอง เช่นViewOverlayดูข้อมูลเพิ่มเติมเกี่ยวกับ Disjoint View Parent ได้ในบันทึกประจำรุ่นของ Core หรือเอกสารประกอบในViewTree.setViewTreeDisjointParent(I800f4)
การเปลี่ยนแปลง API
- ทำให้การตั้งชื่อและการจัดระเบียบแพ็กเกจสอดคล้องกับ
SavedStateRegistryOwnerDelegateมากขึ้น (I8c135, b/376026744)
แก้ไขข้อบกพร่อง
- ตอนนี้ไลบรารีนี้ใช้คำอธิบายประกอบ Nullness ของ JSpecify ซึ่งเป็นการใช้ประเภท นักพัฒนา Kotlin ควรใช้อาร์กิวเมนต์คอมไพเลอร์ต่อไปนี้เพื่อบังคับใช้การใช้งานที่ถูกต้อง:
-Xjspecify-annotations=strict(นี่เป็นค่าเริ่มต้นที่เริ่มตั้งแต่เวอร์ชัน 2.1.0 ของคอมไพเลอร์ Kotlin) (Ie4340, b/326456246) - ลำดับการล้างเอกสาร
ViewModel.onCleared(I586c7, b/363984116)
เวอร์ชัน 2.9.0-alpha07
13 พฤศจิกายน 2024
androidx.lifecycle:lifecycle-*:2.9.0-alpha07 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha07 มีคอมมิตเหล่านี้
ความเข้ากันได้ของ Kotlin Multiplatform
- ตอนนี้ Lifecycle
ViewModel SavedStateเข้ากันได้กับ KMP แล้ว ซึ่งจะช่วยให้คุณใช้SavedStateHandleในโค้ดทั่วไปได้ (Ib6394, b/334076622)
การรองรับการแปลง KotlinX เป็นอนุกรม
ด้วยการรองรับ KotlinX Serialization ที่เพิ่มเข้ามาใน SavedState
1.3.0-alpha05เราได้เปิดตัวsavedซึ่งเป็นตัวแทนพร็อพเพอร์ตี้แบบ Lazy เพื่อให้จัดเก็บคลาส@SerializableในSavedStateHandleได้ง่าย และให้คลาสเหล่านั้นได้รับการกู้คืนโดยอัตโนมัติเมื่อสิ้นสุดการประมวลผลและการสร้างใหม่ โปรดทราบว่าผู้รับมอบสิทธิ์savedเป็นแบบ Lazy และจะไม่เรียกใช้ Lambdainitหรือบันทึกสิ่งใดลงในSavedStateHandleจนกว่าจะมีการเข้าถึง (I47a88, b/376026744)@Serializable data class Person(val firstName: String, val lastName: String) class MyViewModel(handle: SavedStateHandle) : ViewModel() { var person by handle.saved { Person("John", "Doe") } fun onPersonChanged(person: Person) { this.person = person } }
การเปลี่ยนแปลง API
- เพิ่ม
getMutableStateFlowไปยังSavedStateHandleเพื่อแสดงผลMutableStateFlowฟังก์ชันใหม่นี้ใช้ได้เฉพาะกับคีย์เท่านั้น และใช้กับgetLiveDataไม่ได้ ระบบจะแสดงข้อยกเว้นหากคุณพยายามใช้ทั้ง 2 อย่างเพื่อเข้าถึงสถานะเดียวกัน (I04a4f, b/375408415)
เวอร์ชัน 2.9.0-alpha06
30 ตุลาคม 2024
androidx.lifecycle:lifecycle-*:2.9.0-alpha06 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha06 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงพฤติกรรม
- สถานะ
Lifecycle.DESTROYEDเป็นสถานะสุดท้าย และความพยายามใดๆ ในการย้ายLifecycleจากสถานะนี้ไปยังสถานะอื่นจะส่งผลให้เกิดIllegalStateException(I116c4, b/370577987) SavedStateHandleจะไม่มีSavedStateProvider.saveState()ใดๆ อีกต่อไปในกรณีที่Bundleที่แสดงผลว่างเปล่า (I910b5, b/370577987)
แก้ไขข้อบกพร่อง
Lifecycle.eventFlowจะเสร็จสมบูรณ์อย่างถูกต้องเมื่อLifecycleเป็นDESTROYED(I293b2, b/374043130)
เวอร์ชัน 2.9.0-alpha05
16 ตุลาคม 2024
androidx.lifecycle:lifecycle-*:2.9.0-alpha05 เปิดตัวโดยไม่มีการเปลี่ยนแปลงที่สำคัญ เวอร์ชัน 2.9.0-alpha05 มีคอมมิตเหล่านี้
เวอร์ชัน 2.9.0-alpha04
2 ตุลาคม 2024
androidx.lifecycle:lifecycle-*:2.9.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha04 มีคอมมิตเหล่านี้
Kotlin Multiplatform
- ตอนนี้โมดูล
lifecycle-viewmodel-savedstateได้รับการกำหนดค่าให้เข้ากันได้กับ KMP เพื่อเตรียมพร้อมสำหรับ API เช่นSavedStateHandleที่จะพร้อมใช้งานในชุดซอร์สทั่วไปในรุ่นต่อๆ ไป (I503ed, I48764, b/334076622)
เวอร์ชัน 2.9.0-alpha03
18 กันยายน 2024
androidx.lifecycle:lifecycle-*:2.9.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha03 มี คอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- จาก Lifecycle
2.8.6: ข้อผิดพลาด LintNullSafeMutableLiveDataได้ปรับปรุงการรองรับ Smart Cast เพื่อหลีกเลี่ยงผลบวกลวง (85fed6, b/181042665)
การอัปเดตทรัพยากร Dependency
- จาก Lifecycle
2.8.6: ตอนนี้ Lifecycle Runtime Compose ขึ้นอยู่กับ Compose Runtime1.7.1 - ตอนนี้รันไทม์ของวงจรขึ้นอยู่กับ ProfileInstaller
1.4.0
เวอร์ชัน 2.9.0-alpha02
4 กันยายน 2024
androidx.lifecycle:lifecycle-*:2.9.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha02 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- จาก Lifecycle
2.8.5: อัปเดตกฎ ProGuardandroidx.lifecycle.ReportFragmentเพื่ออนุญาตการสร้างความสับสน (ff898e1)
การมีส่วนร่วมจากภายนอก
- ย้าย
androidx.compose.ui.platform.LocalLifecycleOwnerไปยังชุดซอร์สทั่วไป (KMP) ขอขอบคุณ Ivan Matkov จาก JetBrains สำหรับการมีส่วนร่วม (8cd5d03) - จาก Lifecycle
2.8.5: ตัวแทนส่วนขยาย SavedStateHandle.saveable` รองรับค่าที่อนุญาตให้เป็น Null แล้ว ขอขอบคุณ Roman Kalukiewicz สำหรับการมีส่วนร่วม (0d78ea6)
เวอร์ชัน 2.9.0-alpha01
7 สิงหาคม 2024
androidx.lifecycle:lifecycle-*:2.9.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.9.0-alpha01 มีคอมมิตเหล่านี้
Kotlin Multiplatform
lifecycle-testingรองรับการใช้งาน KMP แล้ว (Iea41e)- เพิ่มการรองรับเป้าหมาย Kotlin Multiplatform
linuxArm64(I139d3, b/338268719)
ฟีเจอร์ใหม่
- อาร์ติแฟกต์ KMP ใหม่ของ
androidx.lifecycle:lifecycle-viewmodel-testingพร้อมใช้งานแล้ว ซึ่งมีคลาสViewModelScenarioสำหรับทดสอบ ViewModel แยกต่างหาก โดยรองรับonCleared(ทุกแพลตฟอร์ม) และSavedStateHandle(Android เท่านั้น) (337f68d, c9b3409, 9799a95c, b/264602919) - ตอนนี้การสร้าง
ViewModelด้วยViewModelProviderจะปลอดภัยต่อเทรดแล้ว และระบบได้นำคำอธิบายประกอบ@MainThreadออกแล้ว (Ifd978, b/237006831)
การเปลี่ยนแปลง API
- เพิ่มฟังก์ชันโรงงาน
CreationExtras.Key()เพื่อลดความซับซ้อนในการสร้างออบเจ็กต์CreationExtras.Keyที่ไม่ระบุชื่อ (I970ee) - ตอนนี้
CreationExtrasมีโอเปอเรเตอร์โอเวอร์โหลดที่คล้ายกับแผนที่เพื่อเปิดใช้การจัดการเนื้อหาตามสำนวนใน Kotlin ซึ่งช่วยให้ใช้in,+=และ+กับCreationExtrasได้ (Ib4353) - ตอนนี้
CreationExtrasจะใช้เมธอดequals,hashCodeและtoString(Ib4353) - ตอนนี้
NewInstanceFactoryพร้อมใช้งานในเป้าหมาย JVM Desktop และ Android แล้ว (d3d0892) - พร็อพเพอร์ตี้ส่วนขยายในบรรทัดเพื่อแสดงแอปพลิเคชันที่สำคัญอย่างปลอดภัยใน Kotlin Language เวอร์ชัน 2.0 (I39df2)
แก้ไขข้อบกพร่อง
- นำการจัดทำโครงร่างการเข้าถึง API ของแพลตฟอร์มใหม่ด้วยตนเองออก เนื่องจากจะเกิดขึ้นโดยอัตโนมัติผ่านการสร้างโมเดล API เมื่อใช้ R8 กับ AGP 7.3 ขึ้นไป (เช่น R8 เวอร์ชัน 3.3) และสำหรับบิลด์ทั้งหมดเมื่อใช้ AGP 8.1 ขึ้นไป (เช่น D8 เวอร์ชัน 8.1) เราขอแนะนำให้ลูกค้าที่ไม่ได้ใช้ AGP อัปเดตเป็น D8 เวอร์ชัน 8.1 ขึ้นไป ดูบทความนี้สำหรับรายละเอียดเพิ่มเติม (If6b4c, b/345472586)
เวอร์ชัน 2.8
เวอร์ชัน 2.8.7
30 ตุลาคม 2024
androidx.lifecycle:lifecycle-*:2.8.7 เผยแพร่แล้ว เวอร์ชัน 2.8.7 มี คอมมิตเหล่านี้
การเปลี่ยนแปลง API
androidx.compose.ui.platform.LocalLifecycleOwnerเผยแพร่แล้วในชุดซอร์สทั่วไป (KMP) (6a3f5b3)lifecycle-runtime-compose: นำอาร์ติแฟกต์desktopรายการออก และเพิ่มอาร์ติแฟกต์-jvmStubsและ-linuxx64Stubsรายการแล้ว None of these targets are meant to be used, they are placeholders to help Jetbrains Compose efforts. (6a3f5b3)
เวอร์ชัน 2.8.6
18 กันยายน 2024
androidx.lifecycle:lifecycle-*:2.8.6 เผยแพร่แล้ว เวอร์ชัน 2.8.6 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ข้อผิดพลาด Lint ของ
NullSafeMutableLiveDataได้ปรับปรุงการรองรับ Smart Cast เพื่อหลีกเลี่ยงผลบวกลวง (85fed6, b/181042665)
การอัปเดตทรัพยากร Dependency
- ตอนนี้ Lifecycle Runtime Compose จะขึ้นอยู่กับ Compose Runtime
1.7.1
เวอร์ชัน 2.8.5
4 กันยายน 2024
androidx.lifecycle:lifecycle-*:2.8.5 เผยแพร่แล้ว เวอร์ชัน 2.8.5 มี คอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- อัปเดตกฎ ProGuard ของ
androidx.lifecycle.ReportFragmentเพื่ออนุญาตการสร้างความสับสน (ff898e1)
การมีส่วนร่วมจากภายนอก
- ตอนนี้ผู้รับมอบสิทธิ์ส่วนขยาย
SavedStateHandle.saveableรองรับค่าที่เว้นว่างได้แล้ว ขอขอบคุณ Roman Kalukiewicz สำหรับการมีส่วนร่วม (0d78ea6)
เวอร์ชัน 2.8.4
24 กรกฎาคม 2024
androidx.lifecycle:lifecycle-*:2.8.4 เผยแพร่แล้ว เวอร์ชัน 2.8.4 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้
LiveData.asFlow()จะจัดการกรณีที่ Flow ที่แสดงผลเสร็จสมบูรณ์ทันทีหลังจากได้รับค่าที่ตั้งไว้แล้วในLiveData(เช่น เมื่อใช้take(1)) อย่างถูกต้อง (I9c566) - ตอนนี้การดำเนินการ
Lifecycle*Effectเสร็จสมบูรณ์แล้ว (กล่าวคือ หากมีการเรียกใช้onStopOrDisposeเนื่องจากวงจรหยุดทำงาน ระบบจะไม่เรียกใช้เป็นครั้งที่ 2 เมื่อมีการกำจัด เว้นแต่วงจรจะกลับไปที่STARTEDอีกครั้ง) (I5f607, b/352364595)
เวอร์ชัน 2.8.3
1 กรกฎาคม 2024
androidx.lifecycle:lifecycle-*:2.8.3 เผยแพร่แล้ว เวอร์ชัน 2.8.3 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาเกี่ยวกับความเข้ากันได้แบบย้อนหลังของ Lifecycle 2.8 กับ Compose 1.6.0 และต่ำกว่าเมื่อใช้การลดขนาดโค้ด (aosp/3133056, b/346808608)
เวอร์ชัน 2.8.2
12 มิถุนายน 2024
androidx.lifecycle:lifecycle-*:2.8.2 เผยแพร่แล้ว เวอร์ชัน 2.8.2 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อผิดพลาด
CompositionLocal LocalLifecycleOwner not presentเมื่อใช้ Lifecycle 2.8.X กับ Compose 1.6.X หรือเวอร์ชันก่อนหน้า ตอนนี้คุณสามารถใช้ Lifecycle 2.8.2 กับ Compose เวอร์ชันใดก็ได้โดยไม่ต้องใช้วิธีแก้ปัญหาชั่วคราว (aosp/3105647, b/336842920) ViewModelProviderจะไม่ขัดข้องอีกต่อไปเมื่อผสมทรัพยากร Dependency ของวงจรcompileOnlyเวอร์ชันก่อนหน้ากับเวอร์ชัน 2.8 ขึ้นไป ซึ่งจะช่วยแก้ไขปัญหาเกี่ยวกับไลบรารี เช่น LeakCanary (I80383, b/341792251)
เวอร์ชัน 2.8.1
29 พฤษภาคม 2024
androidx.lifecycle:lifecycle-*:2.8.1 เผยแพร่แล้ว เวอร์ชัน 2.8.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้
lifecycle-viewmodel-composeมีการขึ้นต่อกันทั่วไปกับcompose-runtimeเท่านั้น โดยนำการขึ้นต่อกันทั่วไปกับcompose-uiออก อาร์ติแฟกต์ Android จะยังคงใช้compose-uiเพื่อความเข้ากันได้ (aosp/3079334, b/339562627) - ตอนนี้การผสานรวม
saveableของViewModelโดยใช้ตัวแทนพร็อพเพอร์ตี้จะใช้ชื่อคลาสเป็นส่วนหนึ่งของคีย์ที่สร้างขึ้นโดยอัตโนมัติ เพื่อหลีกเลี่ยงความขัดแย้งหากหลายคลาสใช้SavedStateHandleเดียวกัน (aosp/3063463)
เวอร์ชัน 2.8.0
14 พฤษภาคม 2024
androidx.lifecycle:lifecycle-*:2.8.0 เผยแพร่แล้ว เวอร์ชัน 2.8.0 มี Commit เหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.7.0
LocalLifecycleOwnerได้ย้ายจาก Compose UI ไปยังlifecycle-runtime-composeเพื่อให้สามารถใช้ API ตัวช่วยที่ใช้ Compose นอก Compose UI ได้- ตอนนี้อาร์ติแฟกต์
lifecycle-runtime-composeมี APIdropUnlessResumedและdropUnlessStartedซึ่งช่วยให้คุณยกเลิกการคลิกหรือเหตุการณ์อื่นๆ ที่เกิดขึ้นได้แม้ว่าLifecycleOwnerจะลดลงต่ำกว่าLifecycle.Stateที่กำหนดไว้ ตัวอย่างเช่น คุณสามารถใช้ฟังก์ชันนี้กับ Navigation Compose เพื่อหลีกเลี่ยงการจัดการกิจกรรมการคลิกหลังจากที่การเปลี่ยนไปยังหน้าจออื่นเริ่มขึ้นแล้ว ดังนี้onClick: () -> Unit = dropUnlessResumed { navController.navigate(NEW_SCREEN) } ตอนนี้
ViewModel.viewModelScopeเป็นพารามิเตอร์ตัวสร้างที่ลบล้างได้ ซึ่งช่วยให้คุณแทรกผู้จัดส่งและSupervisorJob()ของคุณเอง หรือลบล้างค่าเริ่มต้นได้โดยใช้backgroundScopeที่มีอยู่ในrunTest(I2817c, b/264598574)class MyViewModel( // Make Dispatchers.Main the default, rather than Dispatchers.Main.immediate viewModelScope: CoroutineScope = Dispatchers.Main + SupervisorJob() ) : ViewModel(viewModelScope) { // Use viewModelScope as before, without any code changes } // Allows overriding the viewModelScope in a test fun Test() = runTest { val viewModel = MyViewModel(backgroundScope) }ViewModelได้รับการเขียนใหม่ใน Kotlin และตอนนี้ใช้AutoClosableแทนCloseableตอนนี้ระบบรองรับการเพิ่มออบเจ็กต์AutoCloseableที่มีkeyซึ่งช่วยให้ดึงข้อมูลออบเจ็กต์เหล่านั้นผ่านgetCloseable()ได้ตอนนี้การเรียกใช้
LifecycleStartEffectและLifecycleResumeEffectโดยไม่มีคีย์จะถือเป็นข้อผิดพลาด โดยเป็นไปตามรูปแบบเดียวกับDisposableEffectAPI ที่ API เหล่านี้จำลองมาเลิกใช้งาน
LiveDataReactiveStreams.toPublisher(lifecycleOwner, liveData)แล้วเปลี่ยนไปใช้LiveData.toPublisher(lifecycleOwner)แทนตอนนี้ส่วนขยาย kotlin ของ
lifecycle-livedata-core-ktxได้ย้ายไปยังโมดูลlifecycle-livedata-coreแล้วเราได้เปลี่ยนโครงสร้างภายในโค้ดของ
NullSafeMutableLiveDataเพื่อหลีกเลี่ยงผลบวกเท็จจำนวนมาก
ความเข้ากันได้ของ Lifecycle กับ Kotlin Multiplatform
ตอนนี้ Lifecycle API หลักใน Lifecycle, LifecycleOwner, LifecycleObserver, Lifecycle.State, Lifecycle.Event และ LifecycleRegistry จะจัดส่งในอาร์ติแฟกต์ที่เข้ากันได้กับ Kotlin Multiplatform
อาร์ติแฟกต์ที่ได้รับผลกระทบ:
lifecycle-commonย้าย API ส่วนใหญ่ไปยังcommonและรองรับ JVM และ iOS นอกเหนือจาก Androidlifecycle-runtimeย้าย API ส่วนใหญ่ไปยังcommonและรองรับ JVM และ iOS นอกเหนือจาก Android- ตอนนี้
lifecycle-runtime-ktxว่างเปล่าแล้ว เนื่องจาก API ทั้งหมดถูกย้ายไปยังlifecycle-runtime lifecycle-runtime-composeย้าย API ทั้งหมดไปยังcommonและจัดส่งอาร์ติแฟกต์ Android ซึ่งตรงกับการรองรับหลายแพลตฟอร์มของandroidx.compose
ความเข้ากันได้ของ ViewModel Kotlin Multiplatform
ตอนนี้อาร์ติแฟกต์ lifecycle-viewmodel และ API เช่น ViewModel, ViewModelStore, ViewModelStoreOwner และ ViewModelProvider จะจัดส่งในอาร์ติแฟกต์ที่เข้ากันได้กับ Kotlin Multiplatform
เพื่อรองรับการเปลี่ยนแปลงนี้ เมธอดต่างๆ เช่น เมธอดใน ViewModelProvider ที่ใช้ java.lang.Class<T> จะมีเมธอดที่เทียบเท่าซึ่งใช้ kotlin.reflect.KClass<T>
ความเข้ากันได้ของไบนารีใน Android ยังคงเหมือนเดิม แต่มีการเปลี่ยนแปลงที่สำคัญบางอย่างเมื่อเปรียบเทียบแพลตฟอร์ม Android API กับแพลตฟอร์ม API ทั่วไป ดังนี้
- ตอนนี้การสร้างอินสแตนซ์
ViewModelProviderจะดำเนินการผ่านเมธอดViewModelProvider.create()แทนการเรียกใช้ตัวสร้างโดยตรง ViewModelProvider.NewInstanceFactoryและViewModelProvider.AndroidViewModelFactoryพร้อมใช้งานใน Android เท่านั้น- เราขอแนะนำให้ขยาย Factory ที่กำหนดเองจาก
ViewModelProvider.Factoryและใช้เมธอดcreateที่ใช้CreationExtrasหรือใช้viewModelFactoryKotlin DSL
- เราขอแนะนำให้ขยาย Factory ที่กำหนดเองจาก
- การใช้
ViewModelProviderโดยไม่มีโรงงานที่กำหนดเองบนแพลตฟอร์มที่ไม่ใช่ JVM จะส่งผลให้เกิดUnsupportedOperationExceptionในแพลตฟอร์ม JVM ระบบจะรักษาความเข้ากันได้โดยใช้คอนสตรัคเตอร์ ViewModel ที่ไม่มีอาร์กิวเมนต์หากไม่มีการระบุโรงงานที่กำหนดเอง viewModelScopeจะเปลี่ยนกลับไปใช้EmptyCoroutineContextในแพลตฟอร์มที่Dispatchers.Mainไม่พร้อมใช้งาน (เช่น Linux)
อาร์ติแฟกต์ที่ได้รับผลกระทบ:
lifecycle-viewmodelย้าย API ส่วนใหญ่ไปยังcommonและรองรับ JVM และ iOS นอกเหนือจาก Android- ตอนนี้
lifecycle-viewmodel-ktxว่างเปล่าแล้ว เนื่องจาก API ทั้งหมดถูกย้ายไปยังlifecycle-viewmodel lifecycle-viewmodel-composeย้าย API ทั้งหมดไปยังcommonและจัดส่งอาร์ติแฟกต์ Android ซึ่งตรงกับการรองรับหลายแพลตฟอร์มของandroidx.compose
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้
InitializerViewModelFactory(รวมถึงฟังก์ชันเครื่องมือสร้างviewModelFactory) จะแสดงIllegalArgumentExceptionหากมีการเพิ่มinitializerที่มีclazz: KClass<VM : ViewModel>เดียวกันแล้ว (Ic3a36)
ปัญหาที่ทราบ
lifecycle-*:2.8.0ต้องใช้ Compose เวอร์ชัน 1.7.0-alpha05 (b/336842920) เป็นอย่างน้อย
เวอร์ชัน 2.8.0-rc01
1 พฤษภาคม 2024
androidx.lifecycle:lifecycle-*:2.8.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.8.0-rc01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ Baseline Profile สำหรับคลาส
lifecycle-commonไม่ได้รับการแพ็กเกจอย่างถูกต้อง ตอนนี้ไฟล์เหล่านี้จะอยู่ในแพ็กเกจlifecycle-runtimeAAR (aosp/3038274, b/322382422) - แก้ไขการเปลี่ยนแปลงการจัดลำดับโดยไม่ตั้งใจในวิธีล้างอินสแตนซ์
AutoCloseableที่แนบมากับ ViewModel โดยระบบได้กู้คืนลำดับก่อนหน้าของaddCloseable(String, AutoCloseable),addClosable(AutoCloseable)และonCleared()แล้ว (aosp/3041632) - ปรับปรุงลักษณะการทำงานเริ่มต้นของการสร้างสำหรับ
viewModelScopeสำหรับสภาพแวดล้อม JVM Desktop และแบบเนทีฟ (aosp/3039221)
การมีส่วนร่วมจากภายนอก
- ขอขอบคุณ Victor Kropp ที่ช่วยปรับปรุงการตรวจสอบเทรดหลักใน JVM Desktop (aosp/3037116)
เวอร์ชัน 2.8.0-beta01
17 เมษายน 2024
androidx.lifecycle:lifecycle-*:2.8.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.8.0-beta01 มี คอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้อาร์ติแฟกต์
lifecycle-runtime-composeเข้ากันได้กับ Kotlin Multiplatform แล้ว โดยย้ายโค้ดไปยังcommonและจัดส่งอาร์ติแฟกต์ Android ซึ่งตรงกับการรองรับหลายแพลตฟอร์มสำหรับandroidx.compose(If7a71, I4f4a0, b/331769623)
เวอร์ชัน 2.8.0-alpha04
3 เมษายน 2024
androidx.lifecycle:lifecycle-*:2.8.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha04 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้อาร์ติแฟกต์
lifecycle-viewmodel-composeเข้ากันได้กับ Kotlin Multiplatform แล้ว โดยย้ายโค้ดไปยังcommonและจัดส่งอาร์ติแฟกต์ Android ซึ่งตรงกับการรองรับหลายแพลตฟอร์มของandroidx.composeเพื่อรองรับการเปลี่ยนแปลงนี้ เมธอดviewModelที่ประกอบกันได้จะยอมรับKClassนอกเหนือจากjava.lang.Class(b/330323282)
แก้ไขข้อบกพร่อง
- เราได้เปลี่ยนโครงสร้างภายในโค้ดของ
NullSafeMutableLiveDataเพื่อหลีกเลี่ยงผลบวกเท็จจำนวนมาก (I2d8c1, Iafb18, I03463, I7ecef)
การอัปเดตทรัพยากร Dependency
- ตอนนี้อาร์ติแฟกต์
lifecycle-viewmodel-composeขึ้นอยู่กับ Compose 1.6.0 - ตอนนี้ Lifecycle ขึ้นอยู่กับ Profile Installer 1.3.1
เวอร์ชัน 2.8.0-alpha03
20 มีนาคม 2024
androidx.lifecycle:lifecycle-*:2.8.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha03 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
ตอนนี้
ViewModel.viewModelScopeเป็นพารามิเตอร์ตัวสร้างที่ลบล้างได้ ซึ่งช่วยให้คุณแทรกผู้จัดส่งและSupervisorJob()ของคุณเอง หรือลบล้างค่าเริ่มต้นได้โดยใช้backgroundScopeที่มีอยู่ในrunTest(I2817c, b/264598574)class MyViewModel( // Make Dispatchers.Main the default, rather than Dispatchers.Main.immediate viewModelScope: CoroutineScope = Dispatchers.Main + SupervisorJob() ) : ViewModel(viewModelScope) { // Use viewModelScope as before, without any code changes } // Allows overriding the viewModelScope in a test fun Test() = runTest { val viewModel = MyViewModel(backgroundScope) }
ความเข้ากันได้ของ Kotlin Multiplatform
ตอนนี้อาร์ติแฟกต์ lifecycle-viewmodel และ API เช่น ViewModel, ViewModelStore, ViewModelStoreOwner และ ViewModelProvider จะจัดส่งในอาร์ติแฟกต์ที่เข้ากันได้กับ Kotlin Multiplatform (b/214568825)
เพื่อรองรับการเปลี่ยนแปลงนี้ เมธอดต่างๆ เช่น เมธอดใน ViewModelProvider ที่ใช้ java.lang.Class<T> จะมีเมธอดที่เทียบเท่าซึ่งใช้ kotlin.reflect.KClass<T>
ความเข้ากันได้ของไบนารีใน Android ยังคงเหมือนเดิม แต่มีการเปลี่ยนแปลงที่สำคัญบางอย่างเมื่อเปรียบเทียบแพลตฟอร์ม Android API กับแพลตฟอร์ม API ทั่วไป ดังนี้
- ตอนนี้การสร้างอินสแตนซ์
ViewModelProviderจะดำเนินการผ่านเมธอดViewModelProvider.create()แทนการเรียกใช้ตัวสร้างโดยตรง ViewModelProvider.NewInstanceFactoryและViewModelProvider.AndroidViewModelFactoryพร้อมใช้งานใน Android เท่านั้น- เราขอแนะนำให้ขยาย Factory ที่กำหนดเองจาก
ViewModelProvider.Factoryและใช้เมธอดcreateที่ใช้CreationExtrasหรือใช้viewModelFactoryKotlin DSL
- เราขอแนะนำให้ขยาย Factory ที่กำหนดเองจาก
- การใช้
ViewModelProviderโดยไม่มีโรงงานที่กำหนดเองบนแพลตฟอร์มที่ไม่ใช่ JVM จะส่งผลให้เกิดUnsupportedOperationExceptionในแพลตฟอร์ม JVM ระบบจะรักษาความเข้ากันได้โดยใช้คอนสตรัคเตอร์ ViewModel ที่ไม่มีอาร์กิวเมนต์หากไม่มีการระบุโรงงานที่กำหนดเอง viewModelScopeจะเปลี่ยนกลับไปใช้EmptyCoroutineContextในแพลตฟอร์มที่Dispatchers.Mainไม่พร้อมใช้งาน (เช่น Linux)
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้
InitializerViewModelFactory(รวมถึงฟังก์ชันเครื่องมือสร้างviewModelFactory) จะแสดงIllegalArgumentExceptionหากมีการเพิ่มinitializerที่มีclazz: KClass<VM : ViewModel>เดียวกันแล้ว (Ic3a36)
แก้ไขข้อบกพร่อง
- ตอนนี้
ViewModel.getCloseableจะจัดการคีย์ที่ซ้ำกัน: หากkeyมีทรัพยากรAutoCloseableที่เชื่อมโยงอยู่แล้ว ระบบจะแทนที่และปิดทรัพยากรเก่าทันที (Ibeb67) - ตอนนี้การเข้าถึง
viewModelScopeของViewModelจะปลอดภัยจากเทรด (If4766, b/322407038)
การมีส่วนร่วมจากภายนอก
LocalLifecycleOwnerย้ายจาก Compose UI ไปยัง lifecycle-runtime-compose เพื่อให้สามารถใช้ API ตัวช่วยที่ใช้ Compose นอก Compose UI ได้ ขอขอบคุณ Jake Wharton สำหรับการมีส่วนร่วม (I6c41b, b/328263448)
เวอร์ชัน 2.8.0-alpha02
21 กุมภาพันธ์ 2024
androidx.lifecycle:lifecycle-*:2.8.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha02 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เราได้เพิ่ม API
dropUnlessResumedและdropUnlessStartedซึ่งช่วยให้คุณยกเลิกการคลิกหรือเหตุการณ์อื่นๆ ที่เกิดขึ้นได้แม้ว่าLifecycleOwnerจะลดลงต่ำกว่าLifecycle.Stateที่กำหนดไว้ ตัวอย่างเช่น สามารถใช้กับ Navigation Compose เพื่อหลีกเลี่ยงการจัดการกิจกรรมการคลิกหลังจากที่เริ่มเปลี่ยนไปใช้หน้าจออื่นแล้ว:onClick: () -> Unit = dropUnlessResumed { navController.navigate(NEW_SCREEN) }(Icba83, b/317230685)
การแปลง Kotlin
- ตอนนี้
ViewModelเขียนด้วย Kotlin แล้ว (I16f26, b/214568825) - ตอนนี้ส่วนขยาย kotlin
lifecycle-viewmodel-ktxได้ย้ายไปยังโมดูลวงจรพื้นฐานแล้ว (Id787b, b/274800183) - ตอนนี้ส่วนขยาย kotlin
lifecycle-runtime-ktxได้ย้ายไปยังโมดูลวงจรพื้นฐานแล้ว (Ic3686, b/274800183) - ตอนนี้ส่วนขยาย kotlin
lifecycle-livedata-core-ktxได้ย้ายไปยังโมดูลวงจรพื้นฐานแล้ว (I54a3d, b/274800183)
ความเข้ากันได้ของ Kotlin Multiplatform
- ตอนนี้ Lifecycle API หลักใน
Lifecycle,LifecycleOwner,LifecycleObserver,Lifecycle.State,Lifecycle.EventและLifecycleRegistryจะจัดส่งในอาร์ติแฟกต์ที่เข้ากันได้กับ Kotlin Multiplatform (b/317249252)
การเปลี่ยนแปลง API
- ตอนนี้การเรียกใช้
LifecycleStartEffectและLifecycleResumeEffectโดยไม่มีคีย์จะถือเป็นข้อผิดพลาด โดยเป็นไปตามรูปแบบเดียวกับDisposableEffectAPI ที่ API เหล่านี้จำลองมา (Ib0e0c, b/323518079) - ตอนนี้
ViewModelใช้AutoCloseableแทนCloseableแล้ว การเปลี่ยนแปลงนี้เข้ากันได้แบบย้อนหลัง (I27f8e, b/214568825) - เลิกใช้งาน
LiveDataReactiveStreams.toPublisher(lifecycleOwner, liveData)แล้วเปลี่ยนไปใช้LiveData.toPublisher(lifecycleOwner)แทน (Iabe29, b/262623005)
การมีส่วนร่วมจากภายนอก
- ขอขอบคุณ Ivan Matkov จาก Jetbrains ที่ช่วยย้ายวงจรไปยัง Kotlin Multiplatform (aosp/2926690, I0c5ac, If445d)
เวอร์ชัน 2.8.0-alpha01
24 มกราคม 2024
androidx.lifecycle:lifecycle-*:2.8.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.8.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้
ViewModelรองรับการเพิ่มออบเจ็กต์Closeableที่มีkeyซึ่งช่วยให้ดึงข้อมูลออบเจ็กต์เหล่านั้นผ่านgetCloseable()ได้ (I3cf63)
เวอร์ชัน 2.7
เวอร์ชัน 2.7.0
10 มกราคม 2024
androidx.lifecycle:lifecycle-*:2.7.0 เผยแพร่แล้ว เวอร์ชัน 2.7.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.6.0
- ตอนนี้
TestLifecycleOwnerมีฟังก์ชันการระงับsetCurrentState()ซึ่งช่วยให้มั่นใจว่าการเปลี่ยนแปลงสถานะและ CallbackLifecycleObserverทั้งหมดจะเสร็จสมบูรณ์ก่อนที่จะแสดงผล โดยเฉพาะอย่างยิ่ง การดำเนินการนี้จะไม่ใช้runBlockingซึ่งแตกต่างจากการตั้งค่าพร็อพเพอร์ตี้currentStateโดยตรง จึงปลอดภัยที่จะใช้ภายในโครูทีน เช่น โครูทีนที่runTestมีให้ - ตอนนี้ส่วนขยาย
LiveDataของmapและswitchMapจะเลียนแบบลักษณะการทำงานของdistinctUntilChangedหากLiveDataมีการตั้งค่าvalueระบบจะเรียกใช้ฟังก์ชันmap/switchMapทันทีเพื่อป้อนข้อมูลvalueของLiveDataที่แสดงผล ซึ่งจะช่วยให้มั่นใจได้ว่าระบบจะตั้งค่าเริ่มต้นเป็นส่วนหนึ่งของ Composition แรก (เมื่อใช้กับobserveAsState()) แต่จะไม่เปลี่ยนลักษณะการสังเกตการณ์ กล่าวคือ ค่าที่อัปเดตจากแหล่งที่มาLiveDataจะยังคงมีผลเมื่อคุณเริ่มสังเกตการณ์LiveDataเท่านั้น - รุ่นนี้แก้ไขปัญหาที่
SavedStateHandleไม่กู้คืนคลาสParcelableที่กำหนดเองอย่างถูกต้องหลังจากการสิ้นสุดการประมวลผลและการสร้างใหม่ เนื่องจากข้อมูลประเภทที่เฟรมเวิร์ก Android ทำหาย อาร์เรย์ของ Parcelable ที่กำหนดเองจึงต้องมีการดำเนินการเพิ่มเติม (สร้างอาร์เรย์ที่พิมพ์ของประเภทที่ถูกต้องด้วยตนเอง) และตอนนี้เอกสารประกอบเกี่ยวกับget,getLiveDataและgetStateFlowจะระบุข้อจำกัดนี้โดยเฉพาะ - นำกฎการเก็บ ProGuard ที่เชื่อมโยงกับ
LifecycleObserverออกแล้ว ซึ่งหมายความว่าโค้ดที่ผ่านการทำ ProGuard ที่ต้องการใช้ API ผ่านการสะท้อน (เช่น การใช้คำอธิบายประกอบ@OnLifecycleEventที่เลิกใช้งานไปนานแล้ว) จะต้องระบุกฎการเก็บรักษาของตนเองสำหรับ Use Case ที่เฉพาะเจาะจง
ความสามารถในการสังเกตเหตุการณ์ในวงจร
- คุณสามารถสังเกต
FlowของLifecycle.Eventผ่านเมธอดส่วนขยายLifecycle.asFlow()แทนการใช้LifecycleEventObserverได้แล้ว - ตอนนี้ผู้ใช้ Jetpack Compose สามารถใช้
LifecycleEventEffectเพื่อเรียกใช้ผลข้างเคียงของ Compose โดยอิงตามLifecycle.Eventได้แล้ว
@Composable
fun HomeScreen(viewModel: HomeViewModel = viewModel()) {
LifecycleEventEffect(Lifecycle.Event.ON_RESUME) {
viewModel.refreshData()
}
// …
}
- ผู้ใช้ Jetpack Compose สามารถใช้
LifecycleStartEffectและLifecycleResumeEffectเพื่อจัดการคู่เหตุการณ์ ซึ่งก็คือเริ่มถึงหยุดและกลับมาทำงานถึงหยุดชั่วคราวตามลำดับ API นี้จะจำลอง API ที่พบในDisposableEffectและเหมาะสำหรับกรณีที่การเปลี่ยนแปลงที่เกิดขึ้นเมื่อสถานะเพิ่มขึ้นจำเป็นต้องย้อนกลับเมื่อสถานะลดลง
fun HomeScreen(viewModel: HomeViewModel = viewModel()) {
LifecycleStartEffect(viewModel) {
val timeTracking = viewModel.startTrackingTimeOnScreen()
onStopOrDispose {
timeTracking.stopTrackingTimeOnScreen()
}
}
// …
}
ดูข้อมูลเพิ่มเติมได้ที่เรียกใช้โค้ดในเหตุการณ์ในวงจร
ความสามารถในการสังเกตสถานะวงจร
- ตอนนี้คุณสามารถสังเกต
Lifecycle.Stateปัจจุบันได้ผ่านพร็อพเพอร์ตี้Lifecycle.currentStateFlowซึ่งจะแสดงผลStateFlowโดยที่valueคือLifecycle.Stateปัจจุบัน - ผู้ใช้ Jetpack Compose สามารถใช้ส่วนขยาย
Lifecycle.currentStateAsState()เพื่อแสดงLifecycle.Stateเป็น ComposeStateได้โดยตรง ซึ่งเทียบเท่ากับ (และเป็นทางเลือกที่สั้นกว่า)lifecycle.currentStateFlow.collectAsState()
ดูข้อมูลเพิ่มเติมได้ที่รวบรวมสถานะวงจรด้วยโฟลว์
เวอร์ชัน 2.7.0-rc02
13 ธันวาคม 2023
androidx.lifecycle:lifecycle-*:2.7.0-rc02 เผยแพร่แล้ว เวอร์ชัน 2.7.0-rc02 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่
SavedStateHandleไม่กู้คืนคลาสParcelableที่กำหนดเองอย่างถูกต้องหลังจากการสิ้นสุดการประมวลผลและการสร้างใหม่ เนื่องจากข้อมูลประเภทที่เฟรมเวิร์ก Android ทำหาย อาร์เรย์ของ Parcelable ที่กำหนดเองจึงต้องมีการดำเนินการเพิ่มเติม (สร้างอาร์เรย์ที่พิมพ์ของประเภทที่ถูกต้องด้วยตนเอง) และตอนนี้เอกสารประกอบเกี่ยวกับget,getLiveDataและgetStateFlowจะระบุข้อจำกัดนี้โดยเฉพาะ (I0b55a)
เวอร์ชัน 2.7.0-rc01
15 พฤศจิกายน 2023
androidx.lifecycle:lifecycle-*:2.7.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.7.0-rc01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้
LifecycleStartEffectและLifecycleResumeEffectจะกำจัดและสร้างบล็อกเอฟเฟกต์ใหม่ได้อย่างถูกต้องหากมีการเปลี่ยนแปลงLifecycleOwner(Ia25c6)
เวอร์ชัน 2.7.0-beta01
1 พฤศจิกายน 2023
androidx.lifecycle:lifecycle-*:2.7.0-beta01 เผยแพร่โดยไม่มีการเปลี่ยนแปลง เวอร์ชัน 2.7.0-beta01 มีคอมมิตเหล่านี้
- การอัปเดตเวอร์ชันเบต้า ไม่มีการเปลี่ยนแปลงที่สำคัญในเวอร์ชันที่เผยแพร่นี้
เวอร์ชัน 2.7.0-alpha03
18 ตุลาคม 2023
androidx.lifecycle:lifecycle-*:2.7.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.7.0-alpha03 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้
lifecycle-runtime-testingมีการตรวจสอบ Lint ใหม่เพื่อหลีกเลี่ยงการตั้งค่าLifecycle.StateของTestLifecycleOwnerโดยใช้ช่องcurrentStateเมื่ออยู่ภายใน Coroutine ตอนนี้การตรวจสอบ Lint จะแนะนำให้ระงับsetCurrentStateซึ่งช่วยให้ตั้งค่าLifecycle.Stateได้โดยไม่ต้องบล็อก (Icf728, b/297880630)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาเกี่ยวกับ
LiveData.switchMapซึ่งการแสดงผลอินสแตนซ์LiveDataเดียวกันทั้งในการเรียกครั้งแรกและการเรียกครั้งต่อมาจะป้องกันไม่ให้เพิ่มอินสแตนซ์LiveDataเป็นแหล่งที่มา (Ibedcba7)
เวอร์ชัน 2.7.0-alpha02
6 กันยายน 2023
androidx.lifecycle:lifecycle-*:2.7.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.7.0-alpha02 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้
TestLifecycleOwnerมีฟังก์ชันการระงับsetCurrentState()เพื่อให้ผู้ใช้มีตัวเลือกในการใช้TestLifecycleOwnerจากภายใน Coroutine เช่น ฟังก์ชันที่runTestมีให้ (I329de, b/259344129)
การเปลี่ยนแปลง API
- ระบบได้ย้ายไฟล์ทั้งหมดจากโมดูล
lifecycle-livedata-ktxไปยังโมดูลlifecycle-livedataหลักแล้ว (I10c6f, b/274800183)
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้ส่วนขยาย
LiveData.map()และLiveData.switchMap()จะตั้งค่าvalueของLiveDataที่แสดงผลหากLiveDataก่อนหน้ามีการตั้งค่าไว้ เพื่อให้มั่นใจว่าการใช้ LiveData ที่ได้ใน Jetpack Compose มีสถานะที่ถูกต้องในคอมโพสิชันเริ่มต้น (I91d2b, b/269479952) - ตอนนี้
addCloseable()ของViewModelจะปิดCloseableทันทีหากViewModelได้รับการเรียกใช้onCleared()แล้ว (I4712e, b/280294730)
แก้ไขข้อบกพร่อง
- จาก Lifecycle
2.6.2: แก้ไขปัญหาที่SavedStateHandleไม่ได้รับการกู้คืนอย่างถูกต้องหลังจากการสิ้นสุดการประมวลผลหากมีการกู้คืนสถานะ ระบบจะเรียกใช้save()โดยไม่ได้บันทึกสถานะในSavedStateRegistryระดับบนจริงๆ จากนั้นจึงกู้คืนสถานะอีกครั้ง ซึ่งจะแก้ไขการโต้ตอบระหว่างrememberSaveableกับNavHostของ Navigation Compose (aosp/2729289)
เวอร์ชัน 2.7.0-alpha01
26 กรกฎาคม 2023
androidx.lifecycle:lifecycle-*:2.7.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.7.0-alpha01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้
Lifecycle.Stateสามารถสังเกตได้ผ่าน Compose โดยใช้Lifecycle.currentStateFlowซึ่งจะแสดงผลStateFlowโดยที่valueคือLifecycle.Stateปัจจุบัน (Ib212d, b/209684871) - ตอนนี้คุณสามารถสังเกต
Lifecycle.Eventเป็นFlowที่มีLifecycle.asFlow().ได้แล้ว (If2c0f, b/176311030) - เพิ่ม
LifecycleResumeEffectAPI เพื่อเรียกใช้SideEffectของ Compose โดยอิงตาม Callback ของเหตุการณ์ทั้งLifecycle.Event.ON_RESUMEและLifecycle.Event.ON_PAUSE(I60386, b/235529345) - เพิ่ม
LifecycleStartEffectAPI เพื่อเรียกใช้SideEffectของ Compose โดยอิงตาม Callback ของเหตุการณ์Lifecycle.Event.ON_STARTและLifecycle.Event.ON_STOPแล้ว (I5a8d1, b/235529345) - เพิ่ม
LifecycleEventEffectAPI เพื่อเรียกใช้SideEffectของ Compose โดยอิงตามLifecycle.Eventแล้ว (Ic9794, b/235529345) - เพิ่มส่วนขยาย
Lifecycle.collectAsState()เพื่อแสดงLifecycle.Stateเป็น ComposeStateโดยตรง ซึ่งเทียบเท่ากับ (และเป็นทางเลือกที่สั้นกว่า)lifecycle.currentStateFlow.collectAsState()(I11015, b/235529345)
แก้ไขข้อบกพร่อง
- ตอนนี้ส่วนขยาย
LiveData.distinctUntilChanged()จะตั้งค่าvalueของLiveDataที่แสดงผลหากLiveDataก่อนหน้ามีการตั้งค่าไว้ การดำเนินการนี้จะไม่เปลี่ยนลักษณะการสังเกตการณ์ โดยค่าที่อัปเดตจากแหล่งที่มาLiveDataจะยังคงมีผลเมื่อคุณเริ่มสังเกตการณ์LiveDataที่แสดงผลจากdistinctUntilChanged()เท่านั้น (Ib482f) - นำกฎการเก็บ ProGuard ที่เชื่อมโยงกับ
LifecycleObserverออกแล้ว ซึ่งหมายความว่าโค้ดที่ผ่านการทำ ProGuard ที่ต้องการใช้ API ผ่านการสะท้อนจะต้องระบุกฎการเก็บของตนเองสำหรับ Use Case ที่เฉพาะเจาะจง (Ia12fd)
เวอร์ชัน 2.6
เวอร์ชัน 2.6.2
6 กันยายน 2023
androidx.lifecycle:lifecycle-*:2.6.2 เผยแพร่แล้ว เวอร์ชัน 2.6.2 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่
SavedStateHandleไม่ได้รับการกู้คืนอย่างถูกต้องหลังจากการสิ้นสุดการประมวลผลหากมีการกู้คืนสถานะ ระบบจะเรียกใช้save()โดยไม่บันทึกสถานะในSavedStateRegistryหลักจริง และจากนั้นระบบจะกู้คืนสถานะอีกครั้ง ซึ่งจะแก้ไขการโต้ตอบระหว่างrememberSaveableกับNavHostของ Navigation Compose (aosp/2729289)
เวอร์ชัน 2.6.1
22 มีนาคม 2023
androidx.lifecycle:lifecycle-*:2.6.1 เผยแพร่แล้ว เวอร์ชัน 2.6.1 มีคอมมิตเหล่านี้
การอัปเดตทรัพยากร Dependency
- ตอนนี้
lifecycle-viewmodel-savedstateขึ้นอยู่กับ SavedState1.2.1(cd7251) - ตอนนี้วงจรขึ้นอยู่กับ ProfileInstaller
1.3.0(f9d30b)
เวอร์ชัน 2.6.0
8 มีนาคม 2023
androidx.lifecycle:lifecycle-*:2.6.0 เผยแพร่แล้ว เวอร์ชัน 2.6.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.5.0
- ตอนนี้
LiveDataมีพร็อพเพอร์ตี้isInitializedใหม่ที่ระบุว่ามีการตั้งค่าที่ชัดเจนในLiveDataหรือไม่ ซึ่งช่วยให้คุณแยกความแตกต่างระหว่างliveData.valueที่แสดงผลnullเนื่องจากไม่มีการตั้งค่าหรือค่าnullที่ชัดเจน - ตอนนี้
MediatorLiveDataมีตัวสร้างเพื่อตั้งค่าเริ่มต้นแล้ว - เพิ่มส่วนขยายใหม่ใน
StateFlowและFlowของcollectAsStateWithLifecycle()ซึ่งรวบรวมจากโฟลว์และแสดงค่าล่าสุดเป็นสถานะ Compose ในลักษณะที่รับรู้ถึงวงจร - เลิกใช้งานเมธอด
Lifecycle.launchWhenXและLifecycle.whenXแล้ว เนื่องจากการใช้ Dispatcher ที่หยุดชั่วคราวอาจทำให้ทรัพยากรสิ้นเปลืองในบางกรณี ขอแนะนำให้ใช้Lifecycle.repeatOnLifecycleดูข้อมูลเพิ่มเติมเกี่ยวกับการระงับการทำงานแบบครั้งเดียวได้ที่คำอธิบายนี้เกี่ยวกับสาเหตุที่การดำเนินการนี้ไม่ปลอดภัยโดยเนื้อแท้ - การแปลง Kotlin - คลาสวงจรจำนวนมากได้รับการแปลงเป็น Kotlin แล้ว คลาสที่แปลงแล้วทั้งหมดยังคงรักษาความเข้ากันได้แบบไบนารีกับเวอร์ชันก่อนหน้า คลาสต่อไปนี้มีการเปลี่ยนแปลงที่ไม่เข้ากันกับแหล่งที่มาสำหรับคลาสที่เขียนใน Kotlin:
ViewTreeLifecycleOwner,LiveDataReactiveStreams,HasDefaultViewModelProviderFactory,ViewTreeViewModelStoreOwner,Transformations,ViewModelStoreOwner,LifecycleOwner
ตารางด้านล่างแสดง Conversion แหล่งที่มาสำหรับวงจรเวอร์ชันใหม่
| Lifecycle 2.5 | Lifecycle 2.5 (KTX) | วงจร 2.6 |
|---|---|---|
Transformations.switchMap(liveData) {...} |
liveData.switchMap {...} |
liveData.switchMap {...} |
Transformations.map(liveData) {...} |
liveData.map {...} |
liveData.map {...} |
Transformations.distinctUntilChanged(liveData) {...} |
liveData.distinctUntilChanged{...} |
liveData.distinctUntilChanged{...} |
LiveDataReactiveStreams.fromPublisher(publisher) |
publisher.toLiveData() |
publisher.toLiveData() |
LiveDataReactiveStreams.toPublisher(lifecycleOwner, liveData) |
liveData.toPublisher(lifecycleOwner) |
liveData.toPublisher(lifecycleOwner) |
override fun getDefaultViewModelProviderFactory(): ViewModelProvider.Factory = factory |
override fun getDefaultViewModelProviderFactory(): ViewModelProvider.Factory = factory |
override val defaultViewModelProviderFactory = factory |
override fun getDefaultViewModelCreationExtras(): CreationExtras = extras |
override fun getDefaultViewModelCreationExtras(): CreationExtras = extras |
override val defaultViewModelProviderCreationExtras = extras |
ViewTreeLifecycleOwner.set(view, owner) |
ViewTreeLifecycleOwner.set(view, owner) |
view.setViewTreeLifecycleOwner(owner) |
ViewTreeLifecycleOwner.get(view) |
view.findViewTreeLifecycleOwner() |
view.findViewTreeLifecycleOwner() |
override fun getViewModelStore(): ViewModelStore = store |
override fun getViewModelStore(): ViewModelStore = store |
override val viewModelStore: ViewModelStore = store |
override fun getLifecycle(): Lifecycle = registry |
override fun getLifecycle(): Lifecycle = registry |
override val lifecycle: Lifecycle get() = registry |
- ตอนนี้ความสามารถในการเว้นว่างของเมธอด
onChangedของObserverที่สร้างใน Kotlin จะตรงกับความสามารถในการเว้นว่างของประเภททั่วไป หากต้องการให้Observer.onChanged()ยอมรับประเภทที่อนุญาตค่า Null คุณต้องสร้างอินสแตนซ์Observerด้วยประเภทที่อนุญาตค่า Null - นอกจากนี้ คลาสเหล่านี้ยังได้รับการแปลงเป็น Kotlin แต่ยังคงเข้ากันได้กับแหล่งที่มา:
DefaultLifecycleObserver,LifecycleEventObserver,Lifecycle,LifecycleRegistry,LifecycleObserver,ViewModelStore,AndroidViewModel,AbstractSavedStateViewModelFactory,LifecycleService,ServiceLifecycleDispatcherและProcessLifecycleOwner
เวอร์ชัน 2.6.0-rc01
22 กุมภาพันธ์ 2023
androidx.lifecycle:lifecycle-*:2.6.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.6.0-rc01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้ส่วนขยาย
LiveData.distinctUntilChanged()จะตั้งค่าvalueของLiveDataที่แสดงผลหากLiveDataก่อนหน้ามีการตั้งค่าไว้ การดำเนินการนี้จะไม่เปลี่ยนลักษณะการสังเกตการณ์ โดยค่าที่อัปเดตจากแหล่งที่มาLiveDataจะยังคงมีผลเมื่อคุณเริ่มสังเกตการณ์LiveDataที่แสดงผลจากdistinctUntilChanged()เท่านั้น (Ib482f)
เวอร์ชัน 2.6.0-beta01
8 กุมภาพันธ์ 2023
androidx.lifecycle:lifecycle-*:2.6.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.6.0-beta01 มีคอมมิตเหล่านี้
การแปลง Kotlin
- ตอนนี้
LifecycleOwnerเขียนด้วย Kotlin แล้ว นี่คือการเปลี่ยนแปลงที่เข้ากันไม่ได้กับแหล่งที่มาสำหรับคลาสที่เขียนใน Kotlin ซึ่งตอนนี้ต้องลบล้างพร็อพเพอร์ตี้lifecycleแทนการใช้ฟังก์ชันgetLifecycle()ก่อนหน้า (I75b4b, b/240298691) - ตอนนี้
ViewModelStoreOwnerอยู่ใน Kotlin แล้ว นี่คือการเปลี่ยนแปลงที่เข้ากันไม่ได้กับแหล่งที่มาสำหรับคลาสที่เขียนใน Kotlin ซึ่งตอนนี้ต้องลบล้างพร็อพเพอร์ตี้viewModelStoreแทนการใช้ฟังก์ชันgetViewModelStore()ก่อนหน้า (I86409, b/240298691) - ส่วนขยาย Kotlin ใน
LifecycleOwnerที่มีฟิลด์lifecycleScopeได้ย้ายไปยังอาร์ติแฟกต์lifecycle-commonจากlifecycle-runtime-ktxแล้ว (I41d78, b/240298691) - ส่วนขยาย Kotlin ใน
Lifecycleที่มีช่องcoroutineScopeได้ย้ายไปยังอาร์ติแฟกต์lifecycle-commonจากlifecycle-runtime-ktxแล้ว (Iabb91, b/240298691)
เวอร์ชัน 2.6.0-alpha05
25 มกราคม 2023
androidx.lifecycle:lifecycle-*:2.6.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha05 มีคอมมิตเหล่านี้
การแปลง Kotlin
- ตอนนี้
Transformationsเขียนด้วย Kotlin แล้ว นี่คือการเปลี่ยนแปลงที่เข้ากันไม่ได้กับแหล่งที่มาสำหรับคลาสที่เขียนใน Kotlin ซึ่งใช้ไวยากรณ์โดยตรง เช่นTransformations.map- ตอนนี้โค้ด Kotlin ต้องใช้ไวยากรณ์เมธอดส่วนขยาย Kotlin ซึ่งก่อนหน้านี้ใช้ได้เฉพาะเมื่อใช้lifecycle-livedata-ktxเท่านั้น เมื่อใช้ภาษาโปรแกรม Java เมธอดเวอร์ชันที่ใช้เมธอดandroidx.arch.core.util.Functionจะเลิกใช้งานและแทนที่ด้วยเวอร์ชันที่ใช้ KotlinFunction1การเปลี่ยนแปลงนี้จะรักษาความเข้ากันได้ของไบนารี (I8e14f) - ตอนนี้
ViewTreeViewModelStoreOwnerเขียนด้วย Kotlin แล้ว นี่คือการเปลี่ยนแปลงที่เข้ากันไม่ได้กับแหล่งที่มาสำหรับคลาสที่เขียนใน Kotlin คุณต้องนำเข้าและใช้เมธอดส่วนขยาย Kotlin โดยตรงในViewของandroidx.lifecycle.setViewTreeViewModelStoreOwnerและandroidx.lifecycle.findViewTreeViewModelStoreOwnerเพื่อตั้งค่าและค้นหาเจ้าของที่ตั้งค่าไว้ก่อนหน้านี้ ซึ่งเข้ากันได้กับไบนารีและยังคงเข้ากันได้กับแหล่งที่มาสำหรับการใช้งานที่เขียนด้วยภาษาโปรแกรม Java (Ia06d8, Ib22d8, b/240298691) - ตอนนี้อินเทอร์เฟซ
HasDefaultViewModelProviderFactoryเขียนด้วย Kotlin แล้ว นี่คือการเปลี่ยนแปลงที่เข้ากันไม่ได้กับแหล่งที่มาสำหรับคลาสที่เขียนใน Kotlin โดยตอนนี้คลาสเหล่านั้นต้องลบล้างพร็อพเพอร์ตี้defaultViewModelProviderFactoryและdefaultViewModelCreationExtrasแทนที่จะใช้ฟังก์ชันที่เกี่ยวข้องก่อนหน้านี้ (Iaed9c, b/240298691) - ตอนนี้
Observerเขียนด้วย Kotlin แล้ว ตอนนี้เมธอดonChanged()ใช้ชื่อvalueสำหรับพารามิเตอร์ (Iffef2, I4995e, b/240298691) AndroidViewModel,AbstractSavedStateViewModelFactory,LifecycleService,ServiceLifecycleDispatcherและProcessLifecycleOwnerเขียนด้วย Kotlin แล้ว (I2e771, Ibae40, I160d7, I08884, I1cda7, b/240298691)
เวอร์ชัน 2.6.0-alpha04
11 มกราคม 2023
androidx.lifecycle:lifecycle-*:2.6.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha04 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้
LiveDataมีพร็อพเพอร์ตี้isInitializedใหม่ที่ระบุว่ามีการตั้งค่าที่ชัดเจนในLiveDataหรือไม่ ซึ่งช่วยให้คุณแยกความแตกต่างระหว่างliveData.valueที่แสดงผลnullเนื่องจากไม่มีการตั้งค่าหรือค่าnullที่ชัดเจน (Ibd018)
การเปลี่ยนแปลง API
- API
collectAsStateWithLifecycle()รายการของlifecycle-runtime-composeไม่ได้อยู่ในสถานะทดลองอีกต่อไป (I09d42, b/258835424) - เลิกใช้งานเมธอด
Lifecycle.launchWhenXและLifecycle.whenXแล้ว เนื่องจากการใช้ Dispatcher ที่หยุดชั่วคราวอาจทำให้ทรัพยากรสิ้นเปลืองในบางกรณี ขอแนะนำให้ใช้Lifecycle.repeatOnLifecycle(Iafc54, b/248302832)
การแปลง Kotlin
- ตอนนี้
ViewTreeLifecycleOwnerเขียนด้วย Kotlin แล้ว นี่คือการเปลี่ยนแปลงที่เข้ากันไม่ได้กับแหล่งที่มาสำหรับคลาสที่เขียนใน Kotlin คุณต้องนำเข้าและใช้เมธอดส่วนขยาย Kotlin โดยตรงในViewของandroidx.lifecycle.setViewTreeLifecycleOwnerและandroidx.lifecycle.findViewTreeLifecycleOwnerเพื่อตั้งค่าและค้นหาเจ้าของที่ตั้งค่าไว้ก่อนหน้านี้ ซึ่งจะแทนที่ส่วนขยาย Kotlin ก่อนหน้าในlifecycle-runtime-ktxซึ่งเข้ากันได้กับไบนารีและยังคงเข้ากันได้กับแหล่งที่มาสำหรับการใช้งานที่เขียนด้วยภาษาโปรแกรม Java (I8a77a, I5234e, b/240298691) - ตอนนี้
LiveDataReactiveStreamsเขียนด้วย Kotlin แล้ว ส่วนขยาย Kotlin ที่ก่อนหน้านี้อยู่ในlifecycle-reactivestreams-ktxได้ย้ายไปยังโมดูลlifecycle-reactivestreamsและกลายเป็นแพลตฟอร์มหลักสำหรับโค้ดที่เขียนด้วย Kotlin นี่คือการเปลี่ยนแปลงที่เข้ากันไม่ได้กับแหล่งที่มาสำหรับโค้ดที่เขียนใน Kotlin หากคุณยังไม่ได้ใช้ API เมธอดส่วนขยาย Kotlin (I2b1b9, I95d22, b/240298691) - ตอนนี้
DefaultLifecycleObserver,LifecycleEventObserver,Lifecycle,LifecycleRegistry,LifecycleObserverและViewModelStoreเขียนด้วย Kotlin แล้ว (Iadffd, (I60034, I8c52c, I9593d, I01fe1, I59a23, b/240298691)
แก้ไขข้อบกพร่อง
SavedStateHandleจะไม่ขัดข้องด้วยClassCastExceptionอีกต่อไปเมื่อเรียกใช้get()ด้วยประเภทคลาสที่ไม่ถูกต้อง (I6ae7c)
เวอร์ชัน 2.6.0-alpha03
24 ตุลาคม 2022
androidx.lifecycle:lifecycle-*:2.6.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha03 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาเกี่ยวกับข้อจำกัดระหว่างโมดูลวงจรต่างๆ ที่ไม่ทำงานตามที่ต้องการ (I18d0d, b/249686765)
- ตอนนี้ข้อผิดพลาดที่เกิดจาก
LifecycleRegistry.moveToState()จะมีข้อความแสดงข้อผิดพลาดที่เป็นประโยชน์มากขึ้น ซึ่งจะแจ้งให้นักพัฒนาแอปทราบถึงคอมโพเนนต์ที่ทำให้เกิดข้อผิดพลาด (Idf4b2, b/244910446)
เวอร์ชัน 2.6.0-alpha02
7 กันยายน 2022
androidx.lifecycle:lifecycle-*:2.6.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha02 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้
MediatorLiveDataมีตัวสร้างเพื่อตั้งค่าเริ่มต้นแล้ว (Ib6cc5, b/151244085)
แก้ไขข้อบกพร่อง
- ตอนนี้อาร์ติแฟกต์
Lifecycleมีข้อจำกัดที่ช่วยให้มั่นใจว่าอาร์ติแฟกต์ Lifecycle ที่ต้องพึ่งพากันทั้งหมดใช้เวอร์ชันเดียวกัน โดยจะอัปเกรดทรัพยากร Dependency อื่นๆ โดยอัตโนมัติเมื่อมีการอัปเกรดทรัพยากร Dependency หนึ่ง b/242871265 - ตอนนี้
FlowLiveData.asFlow()จะสร้างcallbackFlowแทนที่จะใช้การติดตั้งใช้งานChannelของตัวเองเพื่อให้มั่นใจว่าเทรดจะปลอดภัยและรักษาบริบทไว้ได้ (I4a8b2, b/200596935) - ตอนนี้ฟังก์ชัน
asLiveDataของFlowLiveDataจะคงค่าเริ่มต้นของStateFlowไว้เมื่อสร้างออบเจ็กต์LiveDataใหม่ (I3f530, b/157380488) - จาก Lifecycle
2.5.1: การติดตั้งใช้งานAndroidViewModelFactoryที่กำหนดเองจะเรียกใช้ฟังก์ชันcreate(modelClass)อย่างถูกต้องเมื่อใช้คอนสตรัคเตอร์แบบเก็บสถานะกับLifecycle2.4 ขึ้นไป (I5b315, b/238011621)
เวอร์ชัน 2.6.0-alpha01
29 มิถุนายน 2022
androidx.lifecycle:lifecycle-*:2.6.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.6.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่มส่วนขยายใหม่ใน
StateFlowและFlowของcollectAsStateWithLifecycleที่รวบรวมจากโฟลว์และแสดงค่าล่าสุดเป็นสถานะ Compose ในลักษณะที่คำนึงถึงวงจรชีวิต ระบบจะรวบรวมการไหลและตั้งค่าการปล่อยก๊าซใหม่เป็นค่าของรัฐเมื่อวงจรชีวิตอยู่ในLifecycle.Stateที่กำหนดเป็นอย่างน้อย เมื่อวงจรต่ำกว่าLifecycle.Stateนั้น การรวบรวม Flow จะหยุดลงและค่าของ State จะไม่ได้รับการอัปเดต (I1856e, b/230557927)
เวอร์ชัน 2.5
เวอร์ชัน 2.5.1
27 กรกฎาคม 2022
androidx.lifecycle:lifecycle-*:2.5.1 เผยแพร่แล้ว เวอร์ชัน 2.5.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้การติดตั้งใช้งาน
AndroidViewModelFactoryที่กำหนดเองจะเรียกใช้ฟังก์ชันcreate(modelClass)อย่างถูกต้องเมื่อใช้คอนสตรัคเตอร์AndroidViewModelFactoryที่เก็บสถานะกับLifecycle2.4 ขึ้นไป (I5b315, b/238011621)
เวอร์ชัน 2.5.0
29 มิถุนายน 2022
androidx.lifecycle:lifecycle-*:2.5.0 เผยแพร่แล้ว เวอร์ชัน 2.5.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.4.0
ตอนนี้
SavedStateHandleมีgetStateFlow()API ที่แสดงผล KotlinStateFlowสำหรับตรวจสอบการเปลี่ยนแปลงค่าเป็นทางเลือกแทนการใช้LiveDataViewModel CreationExtras - เมื่อเขียน
ViewModelProvider.Factoryที่กำหนดเอง คุณไม่จำเป็นต้องขยายAndroidViewModelFactoryหรือAbstractSavedStateViewModelFactoryเพื่อเข้าถึงApplicationหรือSavedStateHandleตามลำดับอีกต่อไป แต่ระบบจะระบุฟิลด์เหล่านี้ให้กับคลาสย่อยViewModelProvider.Factoryทุกคลาสเป็นCreationExtrasผ่านการโอเวอร์โหลดใหม่ของcreate:create(Class<T>, CreationExtras)ข้อมูลเพิ่มเติมเหล่านี้จะมาจาก Activity หรือ Fragment โดยอัตโนมัติเมื่อใช้ Activity1.5.0และ Fragment1.5.0ตามลำดับclass CustomFactory : ViewModelProvider.Factory { override fun <T : ViewModel> create(modelClass: Class<T>, extras: CreationExtras): T { return when (modelClass) { HomeViewModel::class -> { // Get the Application object from extras val application = checkNotNull(extras[ViewModelProvider.AndroidViewModelFactory.APPLICATION_KEY]) // Pass it directly to HomeViewModel HomeViewModel(application) } DetailViewModel::class -> { // Create a SavedStateHandle for this ViewModel from extras val savedStateHandle = extras.createSavedStateHandle() DetailViewModel(savedStateHandle) } else -> throw IllegalArgumentException("Unknown class $modelClass") } as T } }ตอนนี้
lifecycle-viewmodelมีviewModelFactoryKotlin DSL ที่ช่วยให้คุณกำหนดViewModelProvider.Factoryในแง่ของตัวเริ่มต้น Lambda อย่างน้อย 1 รายการ โดย 1 รายการสำหรับคลาสViewModelแต่ละคลาสที่โรงงานที่กำหนดเองรองรับ โดยใช้CreationExtrasเป็นแหล่งข้อมูลหลักval customFactory = viewModelFactory { // The return type of the lambda automatically sets what class this lambda handles initializer { // Get the Application object from extras provided to the lambda val application = checkNotNull(get(ViewModelProvider.AndroidViewModelFactory.APPLICATION_KEY)) HomeViewModel(application) } initializer { val savedStateHandle = createSavedStateHandle() DetailViewModel(savedStateHandle) } }ตอนนี้
lifecycle-viewmodel-composeมี APIviewModel()ที่ใช้ Lambda Factory เพื่อสร้างอินสแตนซ์ViewModelโดยไม่ต้องสร้างViewModelProvider.Factoryที่กำหนดเอง// Within a @Composable, you can now skip writing a custom Factory // and instead write a lambda to do the initialization of your ViewModel val detailViewModel = viewModel { // This lambda is only called the first time the ViewModel is created // and all CreationExtras are available inside the lambda val savedStateHandle = createSavedStateHandle() DetailViewModel(savedStateHandle) }การผสานรวม Saver ของ Compose กับ SavedStateHandle - ตอนนี้อาร์ติแฟกต์
lifecycle-viewmodel-composeมี API เวอร์ชันทดลองใหม่ในSavedStateHandle.saveableซึ่งช่วยให้เกิดลักษณะการทำงานที่คล้ายกับrememberSaveableโดยได้รับการสนับสนุนจากSavedStateHandleของ `ViewModelclass ListScreenViewModel(handle: SavedStateHandle): ViewModel() { // This value survives both configuration changes and process death and recreation val editMode by handle.saveable { mutableStateOf(false) } }เพิ่ม API
addCloseable()และโอเวอร์โหลดคอนสตรัคเตอร์ใหม่ที่ช่วยให้คุณเพิ่มออบเจ็กต์Closeableอย่างน้อย 1 รายการลงในViewModelซึ่งจะปิดเมื่อล้างViewModelโดยไม่ต้องดำเนินการด้วยตนเองในonCleared()ตัวอย่างเช่น หากต้องการสร้างขอบเขต Coroutine ที่สามารถแทรกลงใน ViewModel แต่ควบคุมผ่านการทดสอบได้ คุณสามารถสร้าง
CoroutineScopeที่ใช้Closeableดังนี้class CloseableCoroutineScope( context: CoroutineContext = SupervisorJob() + Dispatchers.Main.immediate ) : Closeable, CoroutineScope { override val coroutineContext: CoroutineContext = context override fun close() { coroutineContext.cancel() } }ซึ่งสามารถใช้ในคอนสตรัคเตอร์
ViewModelของคุณได้โดยยังคงมีอายุการใช้งานเท่ากับviewModelScopeดังนี้class TestScopeViewModel( val customScope: CloseableCoroutineScope = CloseableCoroutineScope() ) : ViewModel(customScope) { // You can now use customScope in the same way as viewModelScope }
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้การพยายามย้าย
Lifecycle.StateจากINITIALIZEDไปยังDESTROYEDจะแสดงIllegalStateExceptionเสมอ ไม่ว่าLifecycleจะมี Observer ที่แนบมาหรือไม่ก็ตาม - ตอนนี้
LifecycleRegistryจะล้างผู้สังเกตการณ์เมื่อถึงสถานะDESTROYED
เวอร์ชัน 2.5.0-rc02
15 มิถุนายน 2022
androidx.lifecycle:lifecycle-*:2.5.0-rc02 เผยแพร่แล้ว เวอร์ชัน 2.5.0-rc02 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
ViewModelProviderจะไม่ขัดข้องอีกต่อไปเมื่อผสมทรัพยากร Dependency ของ Lifecycle แบบ compileOnly เวอร์ชันก่อนหน้ากับเวอร์ชัน 2.5 ขึ้นไป (I81a66, b/230454566)
เวอร์ชัน 2.5.0-rc01
11 พฤษภาคม 2022
androidx.lifecycle:lifecycle-*:2.5.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.5.0-rc01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
MediatorLiveData.addSource()จะแสดงNullPointerExceptionเมื่อส่งแหล่งที่มาnullแทนที่จะเผยแพร่แหล่งที่มาnullไปยังผู้สังเกตการณ์ (Ibd0fb, b/123085232)
เวอร์ชัน 2.5.0-beta01
20 เมษายน 2022
androidx.lifecycle:lifecycle-*:2.5.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.5.0-beta01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- เพิ่มผู้รับมอบสิทธิ์พร็อพเพอร์ตี้
SavedStateHandle.saveableเพื่อใช้ชื่อพร็อพเพอร์ตี้เป็นคีย์สำหรับการคงสถานะไว้ในSavedStateHandle(I8bb86, b/225014345)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่การฝัง
NavHostไว้ในNavHostอีกรายการในแท็บการไปยังส่วนต่างๆ ด้านล่างที่ไม่ใช่แท็บหลักจะทำให้เกิดIllegalStateExceptionเมื่อใช้ Back Stack หลายรายการ (I11bd5, b/228865698)
เวอร์ชัน 2.5.0-alpha06
6 เมษายน 2022
androidx.lifecycle:lifecycle-*:2.5.0-alpha06 เผยแพร่แล้ว เวอร์ชัน 2.5.0-alpha06 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่มการโอเวอร์โหลด
MutableStateเวอร์ชันทดลองลงในSavedStateHandle.saveableเพื่อให้เทียบเท่ากับrememberSaveable(I38cfe, b/224565154)
การเปลี่ยนแปลง API
- ตอนนี้
CreationExtrasเป็นแบบนามธรรมแทนที่จะเป็นแบบปิดผนึก (Ib8a7a)
แก้ไขข้อบกพร่อง
- แก้ไขข้อผิดพลาด
IllegalStateException: Already attached to lifecycleOwnerที่เกิดจากSavedStateHandleControllerแล้ว (I7ea47, b/215406268)
เวอร์ชัน 2.5.0-alpha05
23 มีนาคม 2022
androidx.lifecycle:lifecycle-*:2.5.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 2.5.0-alpha05 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้โมดูล
lifecycle-viewmodel-composeมีSavedStateHandleSaverซึ่งเป็น API เวอร์ชันทดลองที่ช่วยให้มั่นใจว่าค่าในSavedStateHandleจะผสานรวมอย่างถูกต้องกับสถานะอินสแตนซ์ที่บันทึกไว้เดียวกันกับที่rememberSaveableใช้ (Ia88b7, b/195689777)
การเปลี่ยนแปลง API
- แก้ไขปัญหาความเข้ากันได้กับ Lifecycle 2.3 และ Lifecycle เวอร์ชันใหม่ใน Java (I52c8a, b/219545060)
แก้ไขข้อบกพร่อง
- ตอนนี้
SavedStateViewFactoryรองรับการใช้CreationExtrasแม้ว่าจะเริ่มต้นด้วยSavedStateRegistryOwnerก็ตาม หากมีการระบุข้อมูลเพิ่มเติม ระบบจะไม่สนใจอาร์กิวเมนต์ที่เริ่มต้น (I6c43b, b/224844583)
เวอร์ชัน 2.5.0-alpha04
9 มีนาคม 2022
androidx.lifecycle:lifecycle-*:2.5.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.5.0-alpha04 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้
SavedStateHandleมีgetStateFlow()API ที่แสดงผล KotlinStateFlowสำหรับตรวจสอบการเปลี่ยนแปลงค่าเป็นทางเลือกแทนการใช้LiveData(Iad3ab, b/178037961)
เวอร์ชัน 2.5.0-alpha03
23 กุมภาพันธ์ 2022
androidx.lifecycle:lifecycle-*:2.5.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.5.0-alpha03 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่ม API
addCloseable()และโอเวอร์โหลดคอนสตรัคเตอร์ใหม่ที่ช่วยให้คุณเพิ่มออบเจ็กต์Closeableอย่างน้อย 1 รายการลงในViewModelซึ่งจะปิดเมื่อล้างViewModelโดยไม่ต้องดำเนินการใดๆ ด้วยตนเองในonCleared()(I55ea0) - ตอนนี้
lifecycle-viewmodelมีInitializerViewModelFactoryที่ช่วยให้คุณเพิ่ม Lambda สำหรับจัดการคลาสViewModelบางคลาสได้ โดยใช้CreationExtrasเป็นแหล่งข้อมูลหลัก (If58fc, b/216687549) - ตอนนี้
lifecycle-viewmodel-composeมี APIviewModel()ที่ใช้ Lambda Factory เพื่อสร้างอินสแตนซ์ViewModelโดยไม่ต้องสร้างViewModelProvider.Factoryที่กำหนดเอง (I97fbb, b/216688927)
การเปลี่ยนแปลง API
- ตอนนี้คุณสร้าง
ViewModelด้วยCreationExtrasผ่านlifecycle-viewmodel-composeได้แล้ว (I08887, b/216688927)
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้การพยายามย้าย
Lifecycle.StateจากINITIALIZEDไปยังDESTROYEDจะแสดงIllegalStateExceptionเสมอ ไม่ว่าLifecycleจะมี Observer ที่แนบมาหรือไม่ก็ตาม (I7c390, b/177924329) - ตอนนี้
LifecycleRegistryจะล้างผู้สังเกตการณ์เมื่อถึงสถานะDESTROYED(I4f8dd, b/142925860)
เวอร์ชัน 2.5.0-alpha02
9 กุมภาพันธ์ 2022
androidx.lifecycle:lifecycle-*:2.5.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.5.0-alpha02 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
SavedStateHandleและSavedStateViewModelFactoryได้รับการแปลงเป็น Kotlin แล้ว ซึ่งช่วยปรับปรุงความสามารถในการเป็นค่า Null ของ Generics ในทั้ง 2 คลาส (Ib6ce2, b/216168263, I9647a, b/177667711)- ตอนนี้พารามิเตอร์ฟังก์ชัน
LiveDataswitchMapสามารถมีเอาต์พุตที่ไม่มีค่าได้แล้ว (I40396, b/132923666) - ตอนนี้ส่วนขยาย
LiveData-ktx มีคำอธิบายประกอบเป็น@CheckResultเพื่อบังคับใช้ผลลัพธ์เมื่อเรียกใช้ฟังก์ชันเหล่านี้ (Ia0f05, b/207325134)
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้
SavedStateHandleจะจัดเก็บ defaultValue อย่างถูกต้องเมื่อไม่มีค่าสำหรับคีย์ที่ระบุ (I1c6ce, b/178510877)
แก้ไขข้อบกพร่อง
- จาก Lifecycle
2.4.1: อัปเดตlifecycle-processให้ขึ้นอยู่กับ Startup 1.1.1 เพื่อให้แน่ใจว่าการแก้ไขที่ป้องกันไม่ให้ProcessLifecycleInitializerแสดงStartupExceptionพร้อมใช้งานโดยค่าเริ่มต้น (Ib01df, b/216490724) - ตอนนี้มีข้อความแสดงข้อผิดพลาดที่ได้รับการปรับปรุงเมื่อคลาส
AndroidViewModelที่กำหนดเองมีพารามิเตอร์ในลำดับที่ไม่ถูกต้องและพยายามสร้างViewModel(I340f7, b/177667711) - ตอนนี้คุณสามารถสร้างโมเดลมุมมองผ่าน
CreationExtrasโดยใช้AndroidViewModelFactoryโดยไม่ต้องตั้งค่าแอปพลิเคชัน (I6ebef, b/217271656)
เวอร์ชัน 2.5.0-alpha01
26 มกราคม 2022
androidx.lifecycle:lifecycle-*:2.5.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.5.0-alpha01 มีคอมมิตเหล่านี้
ViewModel CreationExtras
การเปิดตัวครั้งนี้เป็นการวางรากฐานสำหรับการปรับโครงสร้างการสร้าง ViewModel เรากำลังเปลี่ยนไปใช้โรงงานแบบไม่เก็บสถานะที่อาศัยแนวคิดใหม่อย่าง CreationExtras แทนที่จะใช้ชุดคลาสย่อยที่เข้มงวดของ ViewModelProvider.Factory ซึ่งแต่ละคลาสจะเพิ่มฟังก์ชันการทำงานเพิ่มเติม (อนุญาตพารามิเตอร์ตัวสร้าง Application ผ่าน AndroidViewModelFactory, อนุญาตพารามิเตอร์ตัวสร้าง SavedStateHandle ผ่าน SavedStateViewModelFactory และ AbstractSavedStateViewModelFactory เป็นต้น) (Ia7343, b/188691010, b/188541057)
การเปลี่ยนแปลงนี้ทำให้ ViewModelProvider ไม่สามารถเรียกใช้เมธอด create(Class<T>) ของ ViewModelProvider.Factory โดยตรงได้อีกต่อไป แต่จะเรียกใช้โอเวอร์โหลดใหม่ของ create: create(Class<T>, CreationExtras) แทน ซึ่งหมายความว่าการติดตั้งใช้งานอินสแตนซ์ ViewModelProvider.Factory โดยตรงจะมีสิทธิ์เข้าถึง CreationExtras ใหม่แต่ละรายการต่อไปนี้
ViewModelProvider.NewInstanceFactory.VIEW_MODEL_KEY:Stringนี้ให้สิทธิ์เข้าถึงคีย์ที่กำหนดเองที่คุณส่งไปยังViewModelProvider.get()ViewModelProvider.AndroidViewModelFactory.APPLICATION_KEYให้สิทธิ์เข้าถึงชั้นเรียนApplicationSavedStateHandleSupport.SAVED_STATE_REGISTRY_OWNER_KEYให้สิทธิ์เข้าถึงSavedStateRegistryOwnerที่ใช้สร้าง ViewModel นี้SavedStateHandleSupport.VIEW_MODEL_STORE_OWNER_KEYให้สิทธิ์เข้าถึงViewModelStoreOwnerที่ใช้สร้าง ViewModel นี้SavedStateHandleSupport.DEFAULT_ARGS_KEYให้สิทธิ์เข้าถึงBundleของอาร์กิวเมนต์ที่ควรใช้เพื่อสร้างSavedStateHandle
ระบบจะจัดเตรียมข้อมูลเพิ่มเติมเหล่านี้ให้โดยค่าเริ่มต้นเมื่อใช้ Activity 1.5.0-alpha01, Fragment 1.5.0-alpha01 และ Navigation 2.5.0-alpha01 หากคุณใช้ไลบรารีเหล่านั้นเวอร์ชันก่อนหน้า CreationExtras จะว่างเปล่า เนื่องจากคลาสย่อยที่มีอยู่ทั้งหมดของ ViewModelProvider.Factory ได้รับการเขียนใหม่เพื่อรองรับทั้งเส้นทางการสร้างเดิมที่ใช้โดยไลบรารีเหล่านั้นเวอร์ชันก่อนหน้าและเส้นทาง CreationExtras ที่จะใช้ต่อไป
CreationExtrasเหล่านี้ช่วยให้คุณสร้าง ViewModelProvider.Factory ที่ส่งเฉพาะข้อมูลที่คุณต้องการไปยัง ViewModel แต่ละรายการได้โดยไม่ต้องพึ่งพาลำดับชั้นที่เข้มงวดของคลาสย่อย Factory ดังนี้
class CustomFactory : ViewModelProvider.Factory {
override fun <T : ViewModel> create(modelClass: Class<T>, extras: CreationExtras): T {
return when (modelClass) {
HomeViewModel::class -> {
// Get the Application object from extras
val application = checkNotNull(extras[ViewModelProvider.AndroidViewModelFactory.APPLICATION_KEY])
// Pass it directly to HomeViewModel
HomeViewModel(application)
}
DetailViewModel::class -> {
// Create a SavedStateHandle for this ViewModel from extras
val savedStateHandle = extras.createSavedStateHandle()
DetailViewModel(savedStateHandle)
}
else -> throw IllegalArgumentException("Unknown class $modelClass")
} as T
}
}
เราใช้ฟังก์ชันส่วนขยาย createSavedStateHandle() Kotlin ใน CreationExtras จาก SavedStateHandleSupport เพื่อสร้าง SavedStateHandle สำหรับ ViewModel รายการเดียวที่ต้องการเท่านั้น (Ia6654, b/188541057)
คุณสามารถระบุ CreationExtras ที่กำหนดเองได้โดยการลบล้าง getDefaultViewModelCreationExtras() ใน ComponentActivity หรือ Fragment ซึ่งจะทำให้ ViewModelProvider.Factory ที่กำหนดเองพร้อมใช้งานในรูปแบบการแทรกที่ได้รับความช่วยเหลือในตัว ส่วนเสริมเหล่านี้จะพร้อมใช้งานโดยอัตโนมัติสำหรับ Factory ที่กำหนดเองเมื่อใช้กับ ViewModelProvider โดยตรง หรือเมื่อใช้ส่วนขยายพร็อพเพอร์ตี้ Kotlin by viewModels() และ by activityViewModels() (I79f2b, b/207012584, b/207012585, b/207012490)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ค่าเริ่มต้นที่ระบุให้กับ
SavedStateHandleจะปรากฏขึ้นอีกครั้งหลังจากการสิ้นสุดการประมวลผลและการสร้างใหม่ แม้ว่าจะถูกนำออกจากSavedStateHandleโดยเฉพาะก็ตาม ด้วยเหตุนี้SavedStateHandleจะไม่ผสานค่าเริ่มต้นและค่าที่กู้คืนเข้าด้วยกันอีกต่อไป แต่จะใช้เฉพาะค่าที่กู้คืนเป็นแหล่งข้อมูลที่เชื่อถือได้เท่านั้น (I53a4b)
เวอร์ชัน 2.4
เวอร์ชัน 2.4.1
9 กุมภาพันธ์ 2022
androidx.lifecycle:lifecycle-*:2.4.1 เผยแพร่แล้ว เวอร์ชัน 2.4.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- พอร์ตย้อนหลังจาก Lifecycle
2.5.0-alpha01: แก้ไขปัญหาที่ค่าเริ่มต้นที่ระบุให้กับSavedStateHandleจะปรากฏขึ้นอีกครั้งหลังจากการสิ้นสุดการประมวลผลและการสร้างใหม่ แม้ว่าจะนำออกจากSavedStateHandleโดยเฉพาะแล้วก็ตาม ด้วยเหตุนี้SavedStateHandleจะไม่ผสานค่าเริ่มต้นและค่าที่กู้คืนเข้าด้วยกันอีกต่อไป แต่จะใช้เฉพาะค่าที่กู้คืนเป็นแหล่งข้อมูลที่เชื่อถือได้เท่านั้น (I53a4b) - ตอนนี้
lifecycle-processขึ้นอยู่กับ Androidx Startup 1.1.1 ซึ่งแก้ไขการถดถอยที่การใช้ProcessLifecycleInitializerจะทำให้เกิดStartupException(b/216490724)
เวอร์ชัน 2.4.0
27 ตุลาคม 2021
androidx.lifecycle:lifecycle-*:2.4.0 เผยแพร่แล้ว เวอร์ชัน 2.4.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.3.0
@OnLifecycleEventเลิกใช้งานแล้ว ควรใช้LifecycleEventObserverหรือDefaultLifecycleObserverแทน- เพิ่มคลัง
androidx.lifecycle:lifecycle-viewmodel-composeแล้ว โดยมีviewModel()Composable และLocalViewModelStoreOwner- การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบของแหล่งที่มา:
ViewModelProviderได้รับการเขียนใหม่ใน Kotlin เมธอดViewModelProvider.Factory.createไม่อนุญาตให้ใช้ Generic ที่เป็น Null ได้อีกต่อไป
- การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบของแหล่งที่มา:
- เพิ่ม Coroutines API ใหม่ลงใน
androidx.lifecycle:lifecycle-runtime-ktxแล้ว: Lifecycle.repeatOnLifecycle, API ที่เรียกใช้บล็อกโค้ดในโครูทีนเมื่อวงจรอยู่ในสถานะหนึ่งๆ เป็นอย่างน้อย การบล็อกจะยกเลิกและเปิดอีกครั้งเมื่อวงจรเข้าและออกจากสถานะเป้าหมายFlow.flowWithLifecycle, API ที่ปล่อยค่าจาก Flow ต้นทางเมื่อวงจรอยู่ในสถานะหนึ่งๆ เป็นอย่างน้อย- ย้าย
DefaultLifecycleObserverจากlifecycle.lifecycle-common-java8ไปยังlifecycle.lifecycle-commonแล้วlifecycle.lifecycle-common-java8ไม่มีฟังก์ชันการทำงานเพิ่มเติมใดๆ นอกเหนือจากlifecycle.lifecycle-commonดังนั้นคุณจึงใช้lifecycle.lifecycle-commonแทนการพึ่งพา ได้ - ย้าย API ที่ไม่ใช่ Coroutine จาก
lifecycle-viewmodel-ktxไปยังโมดูลlifecycle-viewmodelแล้ว ตอนนี้
lifecycle-processใช้androidx.startupเพื่อเริ่มต้นProcessLifecycleOwnerก่อนหน้านี้
androidx.lifecycle.ProcessLifecycleOwnerInitializerเป็นผู้ดำเนินการนี้หากคุณเคยใช้
tools:node="remove"ContentProviderเพื่อเริ่มต้นวงจรของกระบวนการในอดีต คุณจะต้องทำสิ่งต่อไปนี้แทน<provider android:name="androidx.startup.InitializationProvider" android:authorities=\"${applicationId}.androidx-startup" android:exported="false" tools:node=\"merge"> <!-- If you are using androidx.startup to initialize other components --> <meta-data android:name="androidx.lifecycle.ProcessLifecycleInitializer" android:value="androidx.startup" tools:node="remove" /> </provider>(หรือ)
<!-- If you want to disable androidx.startup completely. --> <provider android:name="androidx.startup.InitializationProvider" android:authorities="${applicationId}.androidx-startup" tools:node="remove"> </provider>
เวอร์ชัน 2.4.0-rc01
29 กันยายน 2021
androidx.lifecycle:lifecycle-*:2.4.0-rc01 เปิดตัวโดยไม่มีการเปลี่ยนแปลงจาก Lifecycle 2.4.0-beta01 เวอร์ชัน 2.4.0-rc01 มีคอมมิตเหล่านี้
เวอร์ชัน 2.4.0-beta01
15 กันยายน 2021
androidx.lifecycle:lifecycle-*:2.4.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.4.0-beta01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
@OnLifecycleEventเลิกใช้งานแล้ว ควรใช้LifecycleEventObserverหรือDefaultLifecycleObserverแทน (I5a8fa)- ย้าย DefaultLifecycleObserver จาก
androidx.lifecycle.lifecycle-common-java8ไปยังandroidx.lifecycle.lifecycle-commonแล้วandroidx.lifecycle.lifecycle-common-java8ไม่ได้มีฟังก์ชันการทำงานเพิ่มเติมใดๆ นอกเหนือจากandroidx.lifecycle.lifecycle-commonอีกต่อไป ดังนั้นคุณจึงใช้androidx.lifecycle.lifecycle-commonแทนทรัพยากร Dependency ของ ได้ (I021aa) - API ที่ไม่ใช่ Coroutine จาก
lifecycle-viewmodel-ktxได้ย้ายไปยังโมดูลlifecycle-viewmodelแล้ว (I6d5b2)
การมีส่วนร่วมจากภายนอก
เวอร์ชัน 2.4.0-alpha03
4 สิงหาคม 2021
androidx.lifecycle:lifecycle-*:2.4.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha03 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบของแหล่งที่มา: ViewModelProvider ได้รับการเขียนใหม่ใน Kotlin
เมธอด
ViewModelProvider.Factory.createไม่อนุญาตให้ใช้ Generic ที่เป็น Null ได้อีกต่อไป (I9b9f6)
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้ระบบจะเรียกใช้
Lifecycle.repeatOnLifecycle:blockแบบต่อเนื่องเสมอเมื่อดำเนินการซ้ำ (Ibab33)
การมีส่วนร่วมจากภายนอก
- ขอขอบคุณ chao2zhang ที่แก้ไขข้อมูลโค้ดในเอกสารประกอบของ
repeatOnLifecycle#205
เวอร์ชัน 2.4.0-alpha02
16 มิถุนายน 2021
androidx.lifecycle:lifecycle-*:2.4.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha02 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่มการตรวจสอบ Lint
RepeatOnLifecycleWrongUsageใหม่ในlifecycle-runtime-ktxซึ่งจะตรวจจับเมื่อมีการใช้repeateOnLifecycleอย่างไม่ถูกต้องในonStart()หรือonResume()(706078, b/187887400)
การเปลี่ยนแปลง API
- เรานำ
LifecycleOwner.addRepeatingJobAPI ออกเพื่อใช้Lifecycle.repeatOnLifecycleที่เคารพการทำงานพร้อมกันแบบมีโครงสร้างและเข้าใจได้ง่ายกว่า (I4a3a8) - ทำให้
ProcessLifecycleInitializerเป็นสาธารณะเพื่อให้androidx.startup.Initializerอื่นๆ ใช้เป็นทรัพยากร Dependency ได้ (I94c31)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาเกี่ยวกับการตรวจสอบ Lint ของ
NullSafeMutableLiveDataเมื่อช่องมีตัวแก้ไข (#147, b/183696616) - แก้ไขปัญหาอื่นเกี่ยวกับการตรวจสอบ Lint ของ
NullSafeMutableLiveDataเมื่อใช้ Generics (#161, b/184830263)
การมีส่วนร่วมจากภายนอก
- ขอขอบคุณ maxsav ที่ช่วยปรับปรุงการตรวจสอบ Lint ของ
NullSafeMutableLiveData(#147, b/183696616) - ขอขอบคุณ kozaxinan ที่ช่วยปรับปรุงการตรวจสอบ Lint ของ
NullSafeMutableLiveData(#161, b/184830263)
เวอร์ชัน 2.4.0-alpha01
24 มีนาคม 2021
androidx.lifecycle:lifecycle-*:2.4.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.4.0-alpha01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงพฤติกรรม
ตอนนี้
lifecycle-processใช้androidx.startupเพื่อเริ่มต้นProcessLifecycleOwnerก่อนหน้านี้
androidx.lifecycle.ProcessLifecycleOwnerInitializerเป็นผู้ดำเนินการนี้หากคุณเคยใช้
tools:node="remove"ContentProviderเพื่อเริ่มต้นวงจรของกระบวนการในอดีต คุณจะต้องทำสิ่งต่อไปนี้แทน<provider android:name="androidx.startup.InitializationProvider" android:authorities=\"${applicationId}.androidx-startup" android:exported="false" tools:node=\"merge"> <!-- If you are using androidx.startup to initialize other components --> <meta-data android:name="androidx.lifecycle.ProcessLifecycleInitializer" android:value="androidx.startup" tools:node="remove" /> </provider>(หรือ)
<!-- If you want to disable androidx.startup completely. --> <provider android:name="androidx.startup.InitializationProvider" android:authorities="${applicationId}.androidx-startup" tools:node="remove"> </provider>
การเปลี่ยนแปลง API
- เพิ่ม API
Flow.flowWithLifecycleที่ส่งค่าจาก Flow ต้นทางเมื่อวงจรอยู่ในสถานะหนึ่งๆ เป็นอย่างน้อยโดยใช้ APILifecycle.repeatOnLifecycleซึ่งเป็นทางเลือกนอกเหนือจากLifecycleOwner.addRepeatinJobAPI ใหม่ (I0f4cd)
แก้ไขข้อบกพร่อง
- จาก Lifecycle 2.3.1: ตอนนี้กฎ Lint
NonNullableMutableLiveDataสามารถแยกความแตกต่างระหว่างตัวแปรฟิลด์ที่มีความสามารถในการเป็นค่า Null ที่แตกต่างกันได้อย่างถูกต้อง (b/169249668)
Lifecycle Viewmodel Compose เวอร์ชัน 1.0.0
เวอร์ชัน 1.0.0-alpha07
16 มิถุนายน 2021
androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha07 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha07 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่ส่งผลต่อ API
- ตอนนี้
viewModel()จะใช้ViewModelStoreOwnerที่ไม่บังคับ ซึ่งช่วยให้ทำงานกับเจ้าของรายอื่นที่ไม่ใช่LocalViewModelStoreOwnerได้ง่ายขึ้น ตัวอย่างเช่น ตอนนี้คุณสามารถใช้viewModel(navBackStackEntry)เพื่อดึงข้อมูล ViewModel ที่เชื่อมโยงกับกราฟการนำทางที่เฉพาะเจาะจงได้แล้ว (I2628d, b/188693123)
เวอร์ชัน 1.0.0-alpha06
2 มิถุนายน 2021
androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha06 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha06 มีคอมมิตเหล่านี้
อัปเดตให้เข้ากันได้กับ Compose เวอร์ชัน 1.0.0-beta08
เวอร์ชัน 1.0.0-alpha05
18 พฤษภาคม 2021
androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha05 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- อัปเดตให้เข้ากันได้กับ Compose เวอร์ชัน
1.0.0-beta07
แก้ไขข้อบกพร่อง
- ตอนนี้ไฟล์ AndroidManifest จาก ui-test-manifest และ ui-tooling-data เข้ากันได้กับ Android 12 (I6f9de, b/184718994)
เวอร์ชัน 1.0.0-alpha04
7 เมษายน 2021
androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha04 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงทรัพยากร Dependency
- เวอร์ชันนี้ช่วยให้
androidx.hilt:hilt-navigation-composeและandroidx.navigation:navigation-composeซิงค์ทรัพยากร Dependency ในandroidx.compose.compiler:compiler:1.0.0-beta04และandroidx.compose.runtime:runtime:1.0.0-beta04ได้ สำหรับ 1.0.0 คอมไพเลอร์และรันไทม์ต้องตรงกัน
เวอร์ชัน 1.0.0-alpha03
10 มีนาคม 2021
androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha03 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha03 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้
LocalViewModelStoreOwner.currentจะแสดงผลViewModelStoreOwnerที่เป็นค่า Null ได้เพื่อระบุได้ดียิ่งขึ้นว่าViewModelStoreOwnerพร้อมใช้งานใน Composition ปัจจุบันหรือไม่ API ที่ต้องใช้ViewModelStoreOwnerเช่นviewModel()และNavHostจะยังคงแสดงข้อยกเว้นหากไม่ได้ตั้งค่าViewModelStoreOwner(Idf39a)
Lifecycle-Viewmodel-Compose เวอร์ชัน 1.0.0-alpha02
24 กุมภาพันธ์ 2021
androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha02 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้
LocalViewModelStoreOwnerมีฟังก์ชันprovidesที่ใช้กับCompositionLocalProviderได้ ซึ่งจะมาแทนที่asProvidableCompositionLocal()API (I45d24)
Lifecycle-Viewmodel-Compose เวอร์ชัน 1.0.0-alpha01
10 กุมภาพันธ์ 2021
androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- Composable
viewModel()และLocalViewModelStoreOwnerย้ายจากandroidx.compose.ui.viewinteropไปยังอาร์ติแฟกต์นี้ในแพ็กเกจandroidx.lifecycle.viewmodel.compose(I7a374)
เวอร์ชัน 2.3.1
Lifecycle เวอร์ชัน 2.3.1
24 มีนาคม 2021
androidx.lifecycle:lifecycle-*:2.3.1 เผยแพร่แล้ว เวอร์ชัน 2.3.1 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้กฎ Lint
NonNullableMutableLiveDataสามารถแยกความแตกต่างระหว่างตัวแปรฟิลด์ที่มีความสามารถในการเป็นค่า Null ที่แตกต่างกันได้อย่างถูกต้อง (b/169249668)
เวอร์ชัน 2.3.0
เวอร์ชัน 2.3.0
10 กุมภาพันธ์ 2021
androidx.lifecycle:lifecycle-*:2.3.0 เผยแพร่แล้ว เวอร์ชัน 2.3.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.2.0
- การรองรับ
SavedStateHandleสำหรับคลาสที่ไม่ใช่ Parcelable: ตอนนี้SavedStateHandleรองรับการทำให้อยู่ในรูปแบบอนุกรมแบบ Lazy โดยอนุญาตให้คุณเรียกใช้setSavedStateProvider()สำหรับคีย์ที่ระบุ ซึ่งจะให้SavedStateProviderที่จะได้รับการเรียกกลับไปยังsaveState()เมื่อระบบขอให้SavedStateHandleบันทึกสถานะ ดูการบันทึกคลาสที่ไม่ใช่ Parcelable - การบังคับใช้ลักษณะการทำงานของวงจร:
- ตอนนี้ LifecycleRegistry บังคับใช้
DESTROYEDเป็นสถานะเทอร์มินัล - ตอนนี้
LifecycleRegistryจะยืนยันว่ามีการเรียกใช้เมธอดในเทรดหลัก ซึ่งเป็นข้อกำหนดสำหรับวงจรของกิจกรรม, Fragment ฯลฯ เสมอมา การเพิ่มผู้สังเกตการณ์จากชุดข้อความที่ไม่ใช่ชุดข้อความหลักส่งผลให้เกิดข้อขัดข้องที่ตรวจจับได้ยากในรันไทม์ สำหรับออบเจ็กต์LifecycleRegistryที่คอมโพเนนต์ของคุณเป็นเจ้าของ คุณสามารถเลือกไม่รับการตรวจสอบอย่างชัดแจ้งได้โดยใช้LifecycleRegistry.createUnsafe(...)แต่คุณต้องตรวจสอบว่ามีการซิงค์ที่เหมาะสมเมื่อเข้าถึงLifecycleRegistryนี้จากชุดข้อความต่างๆ
- ตอนนี้ LifecycleRegistry บังคับใช้
- ตัวช่วยสถานะวงจรและเหตุการณ์: เพิ่มเมธอดตัวช่วยแบบคงที่ของ
downFrom(State),downTo(State),upFrom(State),upTo(State)ลงในLifecycle.Eventเพื่อสร้างEventโดยอิงตามStateและทิศทางการเปลี่ยนสถานะ เพิ่มเมธอดgetTargetState()ที่ให้Stateซึ่งวงจรจะเปลี่ยนไปใช้โดยตรงหลังจากEvent withStateAtLeast: เพิ่มLifecycle.withStateAtLeastAPI ที่รอสถานะวงจรและเรียกใช้บล็อกโค้ดที่ไม่ระงับพร้อมกัน ณ จุดที่มีการเปลี่ยนแปลงสถานะ จากนั้นจึงกลับมาทำงานต่อพร้อมผลลัพธ์ API เหล่านี้แตกต่างจากเมธอดwhen*ที่มีอยู่ เนื่องจากไม่อนุญาตให้เรียกใช้โค้ดที่ระงับและไม่ได้ใช้โปรแกรมจ่ายงานที่กำหนดเอง (aosp/1326081)- API ของ
ViewTree: API ใหม่ของViewTreeLifecycleOwner.get(View)และViewTreeViewModelStoreOwner.get(View)ช่วยให้คุณดึงข้อมูลLifecycleOwnerและViewModelStoreOwnerที่มีอยู่ได้ตามลำดับ โดยระบุอินสแตนซ์Viewคุณต้องอัปเกรดเป็น Activity1.2.0และ Fragment1.3.0รวมถึง AppCompat 1.3.0-alpha01 ขึ้นไปเพื่อป้อนข้อมูลนี้อย่างถูกต้อง ส่วนขยาย KotlinfindViewTreeLifecycleOwnerและfindViewTreeViewModelStoreOwnerพร้อมใช้งานในlifecycle-runtime-ktxและlifecycle-viewmodel-ktxตามลำดับ - การเลิกใช้งานส่วนขยาย Kotlin
LiveData.observe(): ส่วนขยาย KotlinLiveData.observe()ที่จำเป็นต่อการใช้ไวยากรณ์ Lambda เลิกใช้งานแล้ว เนื่องจากไม่จำเป็นเมื่อใช้ Kotlin 1.4
เวอร์ชัน 2.3.0-rc01
16 ธันวาคม 2020
androidx.lifecycle:lifecycle-*:2.3.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.3.0-rc01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้เมธอด
keys()ของSavedStateHandleจะสอดคล้องกันทั้งก่อนและหลังบันทึกสถานะ โดยตอนนี้จะมีคีย์ที่ใช้ก่อนหน้านี้กับsetSavedStateProvider()นอกเหนือจากคีย์ที่ใช้กับset()และgetLiveData()(aosp/1517919, b/174713653)
การมีส่วนร่วมจากภายนอก
- ตอนนี้ API สำหรับระงับ Coroutine ที่รับรู้ถึงวงจรจะจัดการการเรียกไปยัง
yield()ได้ดีขึ้น ขอขอบคุณ Nicklas Ansman Giertz (aosp/1430830, b/168777346)
เวอร์ชัน 2.3.0-beta01
1 ตุลาคม 2020
androidx.lifecycle:lifecycle-*:2.3.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.3.0-beta01 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ส่วนขยาย
LiveData.observe()Kotlin ที่จำเป็นต่อการใช้ไวยากรณ์ Lambda เลิกใช้งานแล้ว เนื่องจากไม่จำเป็นเมื่อใช้ Kotlin 1.4 (I40d3f)
แก้ไขข้อบกพร่อง
- อัปเกรด androidx เพื่อใช้ Kotlin 1.4 (Id6471, b/165307851, b/165300826)
การเปลี่ยนแปลงเอกสารประกอบ
- เครื่องมือสร้าง
liveDataและเอกสารasLiveData()ได้รับการอัปเดตให้มีรายละเอียดเกี่ยวกับการเปลี่ยนแปลงค่าระยะหมดเวลาที่ระบุ (aosp/1122324)
เวอร์ชัน 2.3.0-alpha07
19 สิงหาคม 2020
androidx.lifecycle:lifecycle-*:2.3.0-alpha07 เผยแพร่แล้ว เวอร์ชัน 2.3.0-alpha07 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาข้อขัดข้องในการตรวจสอบ Lint ของ
NullSafeMutableLiveData(aosp/1395367)
เวอร์ชัน 2.3.0-alpha06
22 กรกฎาคม 2020
androidx.lifecycle:lifecycle-*:2.3.0-alpha06 เผยแพร่แล้ว เวอร์ชัน 2.3.0-alpha06 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- เพิ่มเมธอดตัวช่วยแบบคงที่ของ
downFrom(State),downTo(State),upFrom(State),upTo(State)ลงในLifecycle.Eventเพื่อสร้างEventโดยอิงตามStateและทิศทางการเปลี่ยนผ่าน เพิ่มเมธอดgetTargetState()ที่ให้Stateซึ่งวงจรจะเปลี่ยนไปใช้โดยตรงหลังจากEvent(I00887) - เพิ่ม API
Lifecycle.withStateAtLeastที่รอสถานะวงจรและเรียกใช้บล็อกโค้ดที่ไม่ระงับแบบซิงโครนัส ณ จุดที่สถานะเปลี่ยนแปลง จากนั้นจึงกลับมาทำงานต่อพร้อมกับผลลัพธ์ API เหล่านี้แตกต่างจากเมธอดwhen*ที่มีอยู่ เนื่องจากไม่อนุญาตให้เรียกใช้โค้ดที่ระงับและไม่ได้ใช้โปรแกรมจ่ายงานที่กำหนดเอง (aosp/1326081)
การเปลี่ยนแปลงพฤติกรรม
- ตอนนี้ LifecycleRegistry บังคับใช้
DESTROYEDเป็นสถานะเทอร์มินัล (I00887) - ตอนนี้
LifecycleRegistryจะยืนยันว่ามีการเรียกใช้เมธอดในเทรดหลัก ซึ่งเป็นข้อกำหนดสำหรับวงจรของกิจกรรม, Fragment ฯลฯ เสมอมา การเพิ่มผู้สังเกตการณ์จากชุดข้อความที่ไม่ใช่ชุดข้อความหลักส่งผลให้เกิดข้อขัดข้องที่ตรวจจับได้ยากในรันไทม์ สำหรับออบเจ็กต์LifecycleRegistryที่คอมโพเนนต์ของคุณเป็นเจ้าของ คุณสามารถเลือกไม่ใช้การตรวจสอบอย่างชัดแจ้งได้โดยใช้LifecycleRegistry.createUnsafe(...)แต่คุณต้องตรวจสอบว่ามีการซิงค์ที่เหมาะสมเมื่อเข้าถึงLifecycleRegistryนี้จากเทรดต่างๆ (Ie7280, b/137392809)
แก้ไขข้อบกพร่อง
- แก้ไขข้อขัดข้องใน
NullSafeMutableLiveDataแล้ว (b/159987480) - แก้ไข
ObsoleteLintCustomCheckสำหรับการตรวจสอบ Lint ที่รวมมากับlifecycle-livedata-core-ktx(และNullSafeMutableLiveDataโดยเฉพาะ) (b/158699265)
เวอร์ชัน 2.3.0-alpha05
24 มิถุนายน 2020
androidx.lifecycle:lifecycle-*:2.3.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 2.3.0-alpha05 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- ตอนนี้
LiveDataจัดการกับเคสที่เกิดซ้ำได้ดีขึ้น โดยหลีกเลี่ยงการเรียกใช้onActive()หรือonInactive()ซ้ำ (b/157840298) - แก้ไขปัญหาที่การตรวจสอบ Lint ไม่ทำงานเมื่อใช้ Android Studio 4.1 Canary 6 ขึ้นไป (aosp/1331903)
เวอร์ชัน 2.3.0-alpha04
10 มิถุนายน 2020
androidx.lifecycle:lifecycle-*:2.3.0-alpha04 เผยแพร่แล้ว เวอร์ชัน 2.3.0-alpha04 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อขัดข้องในการตรวจสอบ Lint ของ
NonNullableMutableLiveData(b/157294666) - ตอนนี้การตรวจสอบ Lint ของ
NonNullableMutableLiveDataครอบคลุมกรณีต่างๆ มากขึ้นอย่างมาก โดยมีการตั้งค่าnullในMutableLiveDataที่มีพารามิเตอร์ประเภทที่ไม่ใช่ค่า Null (b/156002218)
เวอร์ชัน 2.3.0-alpha03
20 พฤษภาคม 2020
เผยแพร่ androidx.lifecycle:lifecycle-*:2.3.0-alpha03 แล้ว เวอร์ชัน 2.3.0-alpha03 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
- ตอนนี้
SavedStateHandleรองรับการทำซีเรียลไลเซชันแบบ Lazy โดยอนุญาตให้คุณเรียกใช้setSavedStateProvider()สำหรับคีย์ที่ระบุ ซึ่งจะให้SavedStateProviderที่จะได้รับการเรียกกลับไปยังsaveState()เมื่อระบบขอให้SavedStateHandleบันทึกสถานะ (b/155106862) ViewTreeViewModelStoreOwner.get(View)API ใหม่ช่วยให้คุณดึงข้อมูลViewModelStoreOwnerที่มีอยู่ได้เมื่อระบุอินสแตนซ์Viewคุณต้องอัปเกรดเป็น Activity1.2.0-alpha05, Fragment1.3.0-alpha05และ AppCompat1.3.0-alpha01เพื่อป้อนข้อมูลนี้อย่างถูกต้อง เพิ่มส่วนขยาย KotlinfindViewModelStoreOwner()ลงในlifecycle-viewmodel-ktxแล้ว (aosp/1295522)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่ทำให้การตรวจสอบ Lint ของ
MutableLiveDataที่เผยแพร่ใน Lifecycle2.3.0-alpha01ไม่ได้รับการเผยแพร่พร้อมกับอาร์ติแฟกต์lifecycle-livedata-core-ktx(b/155323109)
เวอร์ชัน 2.3.0-alpha02
29 เมษายน 2020
androidx.lifecycle:lifecycle-*:2.3.0-alpha02 เผยแพร่แล้ว เวอร์ชัน 2.3.0-alpha02 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
- ตอนนี้
SavedStateViewModelFactoryอนุญาตให้คุณส่งApplicationที่เป็น Null ไปยังคอนสตรักเตอร์เพื่อรองรับกรณีที่ไม่มี พร้อมใช้งานและไม่จำเป็นต้องรองรับAndroidViewModelได้ดียิ่งขึ้น (aosp/1285740)
แก้ไขข้อบกพร่อง
- ปรับปรุงประสิทธิภาพการเริ่มระบบแบบ Cold Start โดยหลีกเลี่ยงความล้มเหลวในการยืนยันคลาสในอุปกรณ์ API 28 และต่ำกว่า (aosp/1282118)
เวอร์ชัน 2.3.0-alpha01
4 มีนาคม 2020
androidx.lifecycle:lifecycle-*:2.3.0-alpha01 เผยแพร่แล้ว เวอร์ชัน 2.3.0-alpha01 มีคอมมิตเหล่านี้
ฟีเจอร์ใหม่
ViewTreeLifecycleOwner.get(View)API ใหม่ช่วยให้คุณดึงข้อมูลLifecycleOwnerที่มีอยู่ได้เมื่อระบุอินสแตนซ์Viewคุณต้องอัปเกรดเป็น Activity1.2.0-alpha01และ Fragment1.3.0-alpha01เพื่อป้อนข้อมูลนี้อย่างถูกต้อง ส่วนขยาย KotlinfindViewTreeLifecycleOwnerพร้อมให้ใช้งานในlifecycle-runtime-ktx(aosp/1182361, aosp/1182956)- เพิ่มการตรวจสอบ Lint ใหม่ที่จะเตือนคุณเมื่อตั้งค่า
nullในMutableLiveDataที่กำหนดไว้ใน Kotlin เป็นค่าที่ไม่ใช่ Null ซึ่งจะพร้อมใช้งานเมื่อใช้อาร์ติแฟกต์livedata-core-ktxหรือlivedata-ktx(aosp/1154723, aosp/1159092) - อาร์ติแฟกต์
lifecycle-runtime-testingใหม่พร้อมใช้งานแล้ว ซึ่งมีTestLifecycleOwnerที่ใช้LifecycleOwnerและมีLifecycleที่เปลี่ยนแปลงได้ซึ่งปลอดภัยต่อเธรด (aosp/1242438)
แก้ไขข้อบกพร่อง
- ตอนนี้อาร์ติแฟกต์
lifecycle-runtimeมีชื่อแพ็กเกจที่ไม่ซ้ำกันแล้ว (aosp/1187196)
เวอร์ชัน 2.2.0
ViewModel-Savedstate เวอร์ชัน 2.2.0
5 กุมภาพันธ์ 2020
androidx.lifecycle:lifecycle-viewmodel-savedstate:2.2.0 เผยแพร่แล้ว เวอร์ชัน 2.2.0 มีคอมมิตเหล่านี้
ตอนนี้ SavedState ของ ViewModel ในวงจรจะใช้เวอร์ชันเดียวกับอาร์ติแฟกต์อื่นๆ ในวงจร ลักษณะการทำงานของ 2.2.0 เหมือนกับลักษณะการทำงานของ 1.0.0
เวอร์ชัน 2.2.0
22 มกราคม 2020
androidx.lifecycle:lifecycle-*:2.2.0 เผยแพร่แล้ว เวอร์ชัน 2.2.0 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.1.0
- การผสานรวม Coroutine ของวงจร: อาร์ติแฟกต์
lifecycle-runtime-ktxใหม่จะเพิ่มการผสานรวมระหว่างวงจรและ Coroutine ของ Kotlin นอกจากนี้lifecycle-livedata-ktxยังได้รับการขยายเพื่อใช้ประโยชน์จากโครูทีนด้วย ดูรายละเอียดเพิ่มเติมได้ที่ใช้โครูทีน Kotlin กับคอมโพเนนต์สถาปัตยกรรม - การเลิกใช้งาน
ViewModelProviders.of(): เลิกใช้งานViewModelProviders.of()แล้ว คุณสามารถส่งFragmentหรือFragmentActivityไปยังตัวสร้างViewModelProvider(ViewModelStoreOwner)ใหม่เพื่อให้ได้ฟังก์ชันการทำงานเดียวกันเมื่อใช้ Fragment1.2.0 - การเลิกใช้งานอาร์ติแฟกต์
lifecycle-extensions: การเลิกใช้งานViewModelProviders.of()ข้างต้นทำให้การเปิดตัวนี้เป็นการเลิกใช้งาน API สุดท้ายในlifecycle-extensionsและตอนนี้ควรถือว่าอาร์ติแฟกต์นี้เลิกใช้งานทั้งหมดแล้ว เราขอแนะนำอย่างยิ่งให้ใช้ Lifecycle Artifact ที่เฉพาะเจาะจงซึ่งคุณต้องการ (เช่นlifecycle-serviceหากคุณใช้LifecycleServiceและlifecycle-processหากคุณใช้ProcessLifecycleOwner) แทนlifecycle-extensionsเนื่องจากจะไม่มีการเปิดตัว2.3.0ของlifecycle-extensionsในอนาคต - โปรเซสเซอร์สำหรับคำอธิบายประกอบแบบเพิ่มขึ้นของ Gradle: โปรเซสเซอร์สำหรับคำอธิบายประกอบของวงจรจะเป็นแบบเพิ่มขึ้นโดยค่าเริ่มต้น
หากแอปเขียนด้วยภาษาโปรแกรม Java 8 คุณสามารถใช้
DefautLifecycleObserverแทนได้ และหากเขียนด้วยภาษาโปรแกรม Java 7 คุณสามารถใช้LifecycleEventObserverได้
เวอร์ชัน 2.2.0-rc03
4 ธันวาคม 2019
androidx.lifecycle:lifecycle-*:2.2.0-rc03 เผยแพร่แล้ว เวอร์ชัน 2.2.0-rc03 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อผิดพลาดที่เกิดขึ้นเมื่อมีการจัดเก็บ
ViewModelจำลองไว้ในViewModelStoreและค้นหาในภายหลังด้วยโรงงานเริ่มต้น - แก้ไขการใช้
Dispatchers.Main.immediateในlaunchWhenCreatedและเมธอดที่คล้ายกันเพื่อให้เรียกใช้แบบซิงโครนัสระหว่างเหตุการณ์ในวงจรที่เกี่ยวข้อง (aosp/1156203)
การมีส่วนร่วมภายนอก
- ขอขอบคุณ Anders Järleberg ที่ช่วยแก้ไขปัญหานี้ (aosp/1156203)
- ขอขอบคุณ Vsevolod Tolstopyatov จาก Jetbrains ที่ตรวจสอบการใช้งานการดำเนินการแบบอินไลน์
การเปลี่ยนแปลงทรัพยากร Dependency
- ตอนนี้ Lifecycle Extensions ขึ้นอยู่กับ Fragment
1.2.0-rc03
เวอร์ชัน 2.2.0-rc02
7 พฤศจิกายน 2019
androidx.lifecycle:lifecycle-*:2.2.0-rc02 เผยแพร่แล้ว เวอร์ชัน 2.2.0-rc02 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขข้อบกพร่องในการตั้งค่า ProGuard ของไลบรารีที่ส่งผลต่ออุปกรณ์ที่ใช้ API 28 ขึ้นไป หาก API เป้าหมายต่ำกว่า 29 (b/142778206)
เวอร์ชัน 2.2.0-rc01
23 ตุลาคม 2019
androidx.lifecycle:lifecycle-*:2.2.0-rc01 เผยแพร่แล้ว เวอร์ชัน 2.2.0-rc01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่
launchWhenCreatedและเมธอดที่เกี่ยวข้องจะทำงานช้ากว่าเมธอดวงจรที่เกี่ยวข้อง 1 เฟรมเนื่องจากใช้Dispatchers.MainแทนDispatchers.Main.immediate(aosp/1145596)
การมีส่วนร่วมภายนอก
- ขอขอบคุณ Nicklas Ansman ที่ช่วยแก้ไข (aosp/1145596)
เวอร์ชัน 2.2.0-beta01
9 ตุลาคม 2019
androidx.lifecycle:lifecycle-*:2.2.0-beta01 เผยแพร่แล้ว เวอร์ชัน 2.2.0-beta01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขการถดถอยที่เกิดขึ้นใน Lifecycle 2.2.0-alpha05 ในการจัดลำดับของ
ProcessLifecycleOwnerและLifecycleOwnerของกิจกรรมที่เปลี่ยนเป็นเริ่มและกลับมาทำงานอีกครั้งในอุปกรณ์ Android 10 (aosp/1128132) - แก้ไขการถดถอยที่เกิดขึ้นใน Lifecycle
2.2.0-alpha05ซึ่งจะทำให้เกิดNullPointerExceptionเมื่อใช้เวอร์ชัน2.0.0หรือ2.1.0ของlifecycle-process(b/141536990)
เวอร์ชัน 2.2.0-alpha05
18 กันยายน 2019
androidx.lifecycle:lifecycle-*:2.2.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 2.2.0-alpha05 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขภาวะแข่งขันในเครื่องมือสร้าง LiveData ของ Coroutine b/140249349
เวอร์ชัน 2.2.0-alpha04
5 กันยายน 2019
androidx.lifecycle:lifecycle-*:2.2.0-alpha04 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
ฟีเจอร์ใหม่
lifecycleScope,whenCreated,whenStarted,whenResumed,viewModelScopeและการใช้งานเบื้องหลังของliveDataจะใช้Dispatchers.Main.immediateแทนDispatchers.Main(b/139740492)
การมีส่วนร่วมภายนอก
- ขอขอบคุณ Nicklas Ansman ที่ช่วยย้ายไปยัง
Dispatchers.Main.immediate(aosp/1106073)
เวอร์ชัน 2.2.0-alpha03
7 สิงหาคม 2019
androidx.lifecycle:lifecycle-*:2.2.0-alpha03 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
ฟีเจอร์ใหม่
- ตอนนี้การติดตั้งใช้งาน
ViewModelStoreOwnerสามารถเลือกติดตั้งใช้งานHasDefaultViewModelProviderFactoryเพื่อระบุViewModelProvider.Factoryเริ่มต้นได้ ซึ่งเราได้ดำเนินการนี้แล้วสำหรับ Activity1.1.0-alpha02, Fragment1.2.0-alpha02และ Navigation2.2.0-alpha01(aosp/1092370, b/135716331)
การเปลี่ยนแปลง API
- เลิกใช้งาน
ViewModelProviders.of()แล้ว คุณสามารถส่งFragmentหรือFragmentActivityไปยังคอนสตรัคเตอร์ViewModelProvider(ViewModelStoreOwner)ใหม่เพื่อให้ได้ฟังก์ชันการทำงานเดียวกัน (aosp/1009889)
เวอร์ชัน 2.2.0-alpha02
2 กรกฎาคม 2019
androidx.lifecycle:*:2.2.0-alpha02 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
การเปลี่ยนแปลง API
- แทนที่
LiveDataScope.initialValueด้วยLiveDataScope.latestValueซึ่งจะติดตามค่าที่ปล่อยออกมาในปัจจุบันของบล็อกliveData - เพิ่มโอเวอร์โหลดใหม่ลงในเครื่องมือสร้าง
liveDataที่รับพารามิเตอร์timeoutเป็นประเภทDuration
เวอร์ชัน 2.2.0-alpha01
7 พฤษภาคม 2019
androidx.lifecycle:*:2.2.0-alpha01 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
ฟีเจอร์ใหม่
- รุ่นนี้เพิ่มฟีเจอร์ใหม่ที่เพิ่มการรองรับโครูทีน Kotlin สำหรับ Lifecycle และ LiveData ดูเอกสารประกอบโดยละเอียดได้ที่นี่
ViewModel-SavedState เวอร์ชัน 1.0.0
เวอร์ชัน 1.0.0
22 มกราคม 2020
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0 เผยแพร่แล้ว เวอร์ชัน 1.0.0 มีคอมมิตเหล่านี้
ฟีเจอร์สำคัญในเวอร์ชัน 1.0.0
- เพิ่มคลาส SavedStateHandle ใหม่แล้ว ซึ่งจะช่วยให้คลาส
ViewModelของคุณเข้าถึงและมีส่วนร่วมในสถานะที่บันทึกไว้ได้ ออบเจ็กต์นี้สามารถรับได้ในคอนสตรัคเตอร์ของคลาสViewModelและโรงงานที่ Fragments และ AppCompatActivity มีให้โดยค่าเริ่มต้นจะแทรกSavedStateHandleโดยอัตโนมัติ - เพิ่ม AbstractSavedStateViewModelFactory แล้ว ซึ่งช่วยให้คุณสร้างโรงงานที่กำหนดเองสำหรับ
ViewModelและให้สิทธิ์เข้าถึงSavedStateHandleได้
ViewModel-Savedstate เวอร์ชัน 1.0.0-rc03
4 ธันวาคม 2019
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-rc03 เผยแพร่แล้ว เวอร์ชัน 1.0.0-rc03 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงทรัพยากร Dependency
- ตอนนี้ SavedState ของ ViewModel ในวงจรจะขึ้นอยู่กับวงจร
2.2.0-rc03
Viewmodel-Savedstate เวอร์ชัน 1.0.0-rc02
7 พฤศจิกายน 2019
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-rc02 เผยแพร่แล้ว เวอร์ชัน 1.0.0-rc02 มีคอมมิตเหล่านี้
การเปลี่ยนแปลงทรัพยากร Dependency
- ตอนนี้ขึ้นอยู่กับวงจร
2.2.0-rc02
ViewModel-SavedState เวอร์ชัน 1.0.0-rc01
23 ตุลาคม 2019
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-rc01 เปิดตัวโดยไม่มีการเปลี่ยนแปลงจาก 1.0.0-beta01 เวอร์ชัน 1.0.0-rc01 มีคอมมิตเหล่านี้
ViewModel-Savedstate เวอร์ชัน 1.0.0-beta01
9 ตุลาคม 2019
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-beta01 เผยแพร่แล้ว เวอร์ชัน 1.0.0-beta01 มีคอมมิตเหล่านี้
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่การเข้าถึง SavedState ViewModel เป็นครั้งแรกใน
Activity.onActivityResult()ส่งผลให้เกิดIllegalStateException(b/139093676) - แก้ไข
IllegalStateExceptionเมื่อใช้AbstractSavedStateViewModelFactory(b/141225984)
ViewModel-SavedState เวอร์ชัน 1.0.0-alpha05
18 กันยายน 2019
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha05 เผยแพร่แล้ว เวอร์ชัน 1.0.0-alpha05 มีคอมมิตเหล่านี้
การเปลี่ยนแปลง API
SavedStateViewModelFactoryไม่ขยายAbstractSavedStateViewModelFactoryอีกต่อไป และSavedStateHandleจะสร้างขึ้นสำหรับ ViewModel ที่ขอเท่านั้น (aosp/1113593)
ViewModel-SavedState เวอร์ชัน 1.0.0-alpha03
7 สิงหาคม 2019
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha03 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ
lifecycle-viewmodel-savedstateไม่ขึ้นอยู่กับfragmentอีกต่อไป และระบบได้นำคอนสตรัคเตอร์SavedStateViewModelFactory(Fragment)และSavedStateViewModelFactory(FragmentActivity)ที่เกี่ยวข้องออกแล้ว แต่ตอนนี้SavedStateViewModelFactoryเป็นค่าเริ่มต้นสำหรับ Activity1.1.0-alpha02, Fragment1.2.0-alpha02และ Navigation2.2.0-alpha01(b/135716331)
ViewModel-SavedState เวอร์ชัน 1.0.0-alpha02
2 กรกฎาคม 2019
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha02 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
ฟีเจอร์ใหม่
- เพิ่มโอเวอร์โหลด
SavedStateHandle.getLiveData()ซึ่งยอมรับค่าเริ่มต้น
การเปลี่ยนแปลง API
SavedStateVMFactoryเปลี่ยนชื่อเป็นSavedStateViewModelFactoryแล้วAbstractSavedStateVMFactoryเปลี่ยนชื่อเป็นAbstractSavedStateViewModelFactoryแล้ว
ViewModel-Savedstate เวอร์ชัน 1.0.0-alpha01
13 มีนาคม 2019
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha01 เผยแพร่แล้ว ดูบันทึกคอมมิตทั้งหมดสำหรับรุ่นแรกนี้ได้ที่นี่
ฟีเจอร์ใหม่
- ตอนนี้
ViewModelsสามารถมีส่วนร่วมใน savedstate ได้แล้ว โดยใช้ ViewModel FactorySavedStateVMFactoryที่เปิดตัวใหม่ และ ViewModel ควรมีคอนสตรัคเตอร์ที่รับออบเจ็กต์SavedStateHandleเป็นพารามิเตอร์
เวอร์ชัน 2.1.0
การเปลี่ยนแปลงที่สำคัญตั้งแต่เวอร์ชัน 2.0.0
- เพิ่ม
LifecycleEventObserverสำหรับกรณีที่จำเป็นต้องใช้สตรีมของเหตุการณ์ในวงจร ซึ่งเป็น API สาธารณะแทนคลาสGenericLifecycleObserverที่ซ่อนอยู่ - เพิ่มส่วนขยาย ktx สำหรับเมธอด
LiveData.observeและเมธอดTransformations.* - เพิ่ม
Transformations.distinctUntilChangedซึ่งจะสร้างออบเจ็กต์ LiveData ใหม่ที่ไม่แสดงค่าจนกว่าจะมีการเปลี่ยนแปลงค่าLiveDataของแหล่งที่มา - เพิ่มการรองรับ Coroutine ใน ViewModel โดยเพิ่มพร็อพเพอร์ตี้ส่วนขยาย
ViewModel.viewModelScope
เวอร์ชัน 2.1.0
5 กันยายน 2019
androidx.lifecycle:lifecycle-*:2.1.0 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
เวอร์ชัน 2.1.0-rc01
2 กรกฎาคม 2019
androidx.lifecycle:*:2.1.0-rc01 เปิดตัวโดยไม่มีการเปลี่ยนแปลงจาก androidx.lifecycle:*:2.1.0-beta01 ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
เวอร์ชัน 2.1.0-beta01
7 พฤษภาคม 2019
androidx.lifecycle:*:2.1.0-beta01 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
ฟีเจอร์ใหม่
- วงจรชีวิตได้รับการอัปเกรดเป็นเวอร์ชันเบต้า: API ที่เปิดตัวในเวอร์ชันอัลฟาก่อนหน้านี้ เช่น ฟังก์ชันส่วนขยาย
liveDataสำหรับการเปลี่ยนรูปแบบและการสังเกตการณ์, การเริ่มต้นViewModelด้วยการมอบสิทธิ์พร็อพเพอร์ตี้ และอื่นๆ มีความเสถียรและจะไม่เปลี่ยนแปลง
เวอร์ชัน 2.1.0-alpha04
3 เมษายน 2019
androidx.lifecycle:*:2.1.0-alpha04 เผยแพร่แล้ว ดูคอมมิตที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
การเปลี่ยนแปลง API
- การเปลี่ยนแปลงที่ส่งผลกับส่วนอื่นในระบบ: API พื้นฐานที่อยู่เบื้องหลัง
by viewModels()และby activityViewModels()ได้รับการเปลี่ยนแปลงเพื่อรองรับViewModelStoreโดยตรง แทนที่จะรองรับเฉพาะViewModelStoreOwner(aosp/932932)
เวอร์ชัน 2.1.0-alpha03
13 มีนาคม 2019
androidx.lifecycle:*:2.1.0-alpha03 เผยแพร่แล้ว ดูรายการคอมมิตทั้งหมดที่รวมอยู่ในเวอร์ชันนี้ได้ที่นี่
การเปลี่ยนแปลง API
- นำ
ViewModelProvider.KeyedFactoryออกแล้ว อินเทอร์เฟซที่ 2 นอกเหนือจากViewModelProvider.Factoryไม่สามารถทำงานร่วมกับฟีเจอร์ใหม่ๆ ได้ดีนัก เช่น การมอบสิทธิ์พร็อพเพอร์ตี้ใน Kotlinby viewmodels {}(aosp/914133)
เวอร์ชัน 2.1.0-alpha02
30 มกราคม 2019
androidx.lifecycle 2.1.0-alpha02 เผยแพร่แล้ว
การเปลี่ยนแปลง API
- ตอนนี้
LifecycleRegistryมีเมธอดsetCurrentState()ที่มาแทนที่เมธอดsetState()ที่เลิกใช้งานแล้ว (aosp/880715)
แก้ไขข้อบกพร่อง
- แก้ไขปัญหาที่อินสแตนซ์
ViewModelจำลองขัดข้องเมื่อล้างViewModelStoreที่มีอยู่ b/122273087
เวอร์ชัน 2.1.0-alpha01
17 ธันวาคม 2018
androidx.lifecycle 2.1.0-alpha01 เผยแพร่แล้ว
ฟีเจอร์ใหม่
- เพิ่ม
LifecycleEventObserverสำหรับกรณีที่จำเป็นต้องใช้สตรีมของเหตุการณ์ในวงจร ซึ่งเป็น API สาธารณะแทนที่จะเป็นคลาสGenericLifecycleObserverที่ซ่อนอยู่ - เพิ่มส่วนขยาย ktx สำหรับเมธอด
LiveData.observeและเมธอดTransformations.* - เพิ่มวิธีการ
Transformations.distinctUntilChangedแล้ว ซึ่งจะสร้างออบเจ็กต์LiveDataใหม่ที่ไม่แสดงค่าจนกว่าจะมีการเปลี่ยนแปลงค่า LiveData ต้นทาง - เพิ่มการรองรับ Coroutine ใน ViewModels: พร็อพเพอร์ตี้ส่วนขยาย
ViewModel.viewModelScope - เพิ่ม
ViewModelProvider.KeyedFactoryซึ่งเป็นโรงงานสำหรับ ViewModels ที่รับkeyและClassในเมธอดcreate
เวอร์ชัน 2.0.0
เวอร์ชัน 2.0.0
21 กันยายน 2018
Lifecycle 2.0.0 เปิดตัวพร้อมการแก้ไขข้อบกพร่อง 1 รายการจาก 2.0.0-rc01 ใน ViewModel
แก้ไขข้อบกพร่อง
- แก้ไขกฎ ProGuard ของ ViewModel ที่นำคอนสตรัคเตอร์ออกอย่างไม่ถูกต้อง b/112230489
เวอร์ชัน 2.0.0-beta01
2 กรกฎาคม 2018
แก้ไขข้อบกพร่อง
- แก้ไขกฎ ProGuard ของ LifecycleObserver เพื่อเก็บเฉพาะการใช้งาน ไม่ใช่อินเทอร์เฟซย่อย b/71389427
- แก้ไขกฎ ProGuard ของ ViewModel เพื่ออนุญาตให้มีการสร้างความสับสนและการลดขนาด
เวอร์ชันก่อน AndroidX
สำหรับ Lifecycle เวอร์ชันก่อน AndroidX ที่ตามมา ให้รวมทรัพยากร Dependency เหล่านี้
dependencies {
def lifecycle_version = "1.1.1"
// ViewModel and LiveData
implementation "android.arch.lifecycle:extensions:$lifecycle_version"
// alternatively - just ViewModel
implementation "android.arch.lifecycle:viewmodel:$lifecycle_version" // For Kotlin use viewmodel-ktx
// alternatively - just LiveData
implementation "android.arch.lifecycle:livedata:$lifecycle_version"
// alternatively - Lifecycles only (no ViewModel or LiveData).
// Support library depends on this lightweight import
implementation "android.arch.lifecycle:runtime:$lifecycle_version"
annotationProcessor "android.arch.lifecycle:compiler:$lifecycle_version" // For Kotlin use kapt instead of annotationProcessor
// alternately - if using Java8, use the following instead of compiler
implementation "android.arch.lifecycle:common-java8:$lifecycle_version"
// optional - ReactiveStreams support for LiveData
implementation "android.arch.lifecycle:reactivestreams:$lifecycle_version"
// optional - Test helpers for LiveData
testImplementation "android.arch.core:core-testing:$lifecycle_version"
}
เวอร์ชัน 1.1.1
21 มีนาคม 2018
มีการเปลี่ยนแปลงเล็กน้อยเพียงอย่างเดียวคือ android.arch.core.util.Function ย้ายจาก arch:runtime ไปยัง arch:common ซึ่งจะช่วยให้ใช้ได้โดยไม่ต้องมีทรัพยากร Dependency ของรันไทม์ เช่น ใน paging:common ด้านล่าง
lifecycle:common เป็นทรัพยากร Dependency ของ lifecycle:runtime ดังนั้นการเปลี่ยนแปลงนี้จึงไม่ส่งผลต่อ lifecycle:runtime โดยตรง แต่จะส่งผลต่อโมดูลที่ขึ้นอยู่กับ lifecycle:common โดยตรงเท่านั้น เช่นเดียวกับ Paging
เวอร์ชัน 1.1.0
22 มกราคม 2018
การเปลี่ยนแปลงแพ็กเกจ
ตอนนี้มีทรัพยากร Dependency ใหม่ที่มีขนาดเล็กลงมากเผยแพร่แล้ว ดังนี้
android.arch.lifecycle:livedata:1.1.0android.arch.lifecycle:viewmodel:1.1.0
การเปลี่ยนแปลง API
- ตอนนี้เราได้นำ
LifecycleActivityและLifecycleFragmentที่เลิกใช้งานแล้วออกแล้ว โปรดใช้FragmentActivity,AppCompatActivityหรือรองรับFragment - เพิ่มคำอธิบายประกอบ
@NonNullรายการในViewModelProvidersและViewModelStoresแล้ว - เลิกใช้งานตัวสร้าง
ViewModelProvidersแล้ว โปรดใช้เมธอดแบบคงที่โดยตรง ViewModelProviders.DefaultFactoryเลิกใช้งานแล้ว โปรดใช้ViewModelProvider.AndroidViewModelFactory- เราได้เพิ่มเมธอด
ViewModelProvider.AndroidViewModelFactory.getInstance(Application)แบบคงที่เพื่อดึงข้อมูลFactoryแบบคงที่ซึ่งเหมาะสำหรับการสร้างอินสแตนซ์ViewModelและAndroidViewModel