อายุการใช้งาน

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

ตารางนี้แสดงอาร์ติแฟกต์ทั้งหมดในกลุ่ม androidx.lifecycle

อาร์ติแฟกต์ รุ่นที่เสถียร รุ่นที่อาจได้รับการเผยแพร่ รุ่นเบต้า รุ่นอัลฟ่า
lifecycle-* 2.11.1 - - 2.12.0-alpha06
lifecycle-viewmodel-navigation3 2.11.1 - - 2.12.0-alpha06
คลังนี้ได้รับการอัปเดตล่าสุดเมื่อวันที่ 18 พฤศจิกายน 2026

การประกาศทรัพยากร 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 ให้ใช้ rememberDecoratedNavEntries API (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 ที่กำหนดขอบเขต คลาสนี้ช่วยให้สร้างขอบเขตย่อยที่ยังคงอยู่แม้จะมีการเปลี่ยนแปลงการกำหนดค่า แต่สามารถล้างข้อมูลได้อย่างอิสระ นอกจากนี้ยังมี Wrapper ViewModelStoreOwner ที่รับค่าโรงงานเริ่มต้นและส่วนเสริมการสร้างจากระดับบนด้วย (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:

  • เพิ่ม rememberLifecycleOwner Composable เพื่อเปิดใช้การสร้างวงจรที่กำหนดขอบเขตภายใน 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 ที่กำหนดขอบเขตไปยังหน้าจอแต่ละหน้าจอ ("รายการ") ได้โดยใช้ API rememberViewModelStoreNavEntryDecorator() ดังนี้

    @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 รายเป็น@VisibleForTesting

  • minSdk เปลี่ยนจาก 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

  • เปลี่ยนโครงสร้าง LifecycleOwner Composable เป็น 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

  • ใน LifecycleOwner composable พารามิเตอร์ parentLifecycleOwner ได้เปลี่ยนชื่อเป็น parent (I080bc)

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

  • ตอนนี้ LifecycleOwner composable จะย้ายวงจรไปยัง 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 มีคอมมิตเหล่านี้

ฟีเจอร์ใหม่

  • เพิ่ม LifecycleOwner Composable เพื่อเปิดใช้การสร้างวงจรที่กำหนดขอบเขตภายใน 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)

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

เวอร์ชัน 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 และจะไม่เรียกใช้ Lambda init หรือบันทึกสิ่งใดลงใน 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 ที่ดึงข้อมูลผ่าน API findViewTree ที่เกี่ยวข้องสามารถแก้ไขได้ผ่านองค์ประกอบหลักที่ไม่ต่อเนื่องกันของมุมมอง เช่น 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 และจะไม่เรียกใช้ Lambda init หรือบันทึกสิ่งใดลงใน 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: ข้อผิดพลาด Lint NullSafeMutableLiveData ได้ปรับปรุงการรองรับ Smart Cast เพื่อหลีกเลี่ยงผลบวกลวง (85fed6, b/181042665)

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

เวอร์ชัน 2.9.0-alpha02

4 กันยายน 2024

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

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

  • จาก Lifecycle 2.8.5: อัปเดตกฎ ProGuard androidx.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 มี API dropUnlessResumed และ 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 โดยไม่มีคีย์จะถือเป็นข้อผิดพลาด โดยเป็นไปตามรูปแบบเดียวกับ DisposableEffect API ที่ 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 นอกเหนือจาก Android
  • lifecycle-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 หรือใช้ viewModelFactory Kotlin DSL
  • การใช้ 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-runtime AAR (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 หรือใช้ viewModelFactory Kotlin DSL
  • การใช้ 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 โดยไม่มีคีย์จะถือเป็นข้อผิดพลาด โดยเป็นไปตามรูปแบบเดียวกับ DisposableEffect API ที่ 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() ซึ่งช่วยให้มั่นใจว่าการเปลี่ยนแปลงสถานะและ Callback LifecycleObserver ทั้งหมดจะเสร็จสมบูรณ์ก่อนที่จะแสดงผล โดยเฉพาะอย่างยิ่ง การดำเนินการนี้จะไม่ใช้ 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 เป็น Compose State ได้โดยตรง ซึ่งเทียบเท่ากับ (และเป็นทางเลือกที่สั้นกว่า) 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)
  • เพิ่ม LifecycleResumeEffect API เพื่อเรียกใช้ SideEffect ของ Compose โดยอิงตาม Callback ของเหตุการณ์ทั้ง Lifecycle.Event.ON_RESUME และ Lifecycle.Event.ON_PAUSE (I60386, b/235529345)
  • เพิ่ม LifecycleStartEffect API เพื่อเรียกใช้ SideEffect ของ Compose โดยอิงตาม Callback ของเหตุการณ์ Lifecycle.Event.ON_START และ Lifecycle.Event.ON_STOP แล้ว (I5a8d1, b/235529345)
  • เพิ่ม LifecycleEventEffect API เพื่อเรียกใช้ SideEffect ของ Compose โดยอิงตาม Lifecycle.Event แล้ว (Ic9794, b/235529345)
  • เพิ่มส่วนขยาย Lifecycle.collectAsState() เพื่อแสดง Lifecycle.State เป็น Compose State โดยตรง ซึ่งเทียบเท่ากับ (และเป็นทางเลือกที่สั้นกว่า) 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

เวอร์ชัน 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 จะเลิกใช้งานและแทนที่ด้วยเวอร์ชันที่ใช้ Kotlin Function1 การเปลี่ยนแปลงนี้จะรักษาความเข้ากันได้ของไบนารี (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) อย่างถูกต้องเมื่อใช้คอนสตรัคเตอร์แบบเก็บสถานะกับ Lifecycle 2.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 ที่เก็บสถานะกับ Lifecycle 2.4 ขึ้นไป (I5b315, b/238011621)

เวอร์ชัน 2.5.0

29 มิถุนายน 2022

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

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

  • ตอนนี้ SavedStateHandle มี getStateFlow() API ที่แสดงผล Kotlin StateFlow สำหรับตรวจสอบการเปลี่ยนแปลงค่าเป็นทางเลือกแทนการใช้ LiveData

  • ViewModel CreationExtras - เมื่อเขียน ViewModelProvider.Factory ที่กำหนดเอง คุณไม่จำเป็นต้องขยาย AndroidViewModelFactory หรือ AbstractSavedStateViewModelFactory เพื่อเข้าถึง Application หรือ SavedStateHandle ตามลำดับอีกต่อไป แต่ระบบจะระบุฟิลด์เหล่านี้ให้กับคลาสย่อย ViewModelProvider.Factory ทุกคลาสเป็น CreationExtras ผ่านการโอเวอร์โหลดใหม่ของ create: create(Class<T>, CreationExtras) ข้อมูลเพิ่มเติมเหล่านี้จะมาจาก Activity หรือ Fragment โดยอัตโนมัติเมื่อใช้ Activity 1.5.0 และ Fragment 1.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 มี viewModelFactory Kotlin 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 มี API viewModel() ที่ใช้ 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 ของ `ViewModel

    class 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 ที่แสดงผล Kotlin StateFlow สำหรับตรวจสอบการเปลี่ยนแปลงค่าเป็นทางเลือกแทนการใช้ 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 มี API viewModel() ที่ใช้ 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)
  • ตอนนี้พารามิเตอร์ฟังก์ชัน LiveData switchMap สามารถมีเอาต์พุตที่ไม่มีค่าได้แล้ว (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 ให้สิทธิ์เข้าถึงชั้นเรียน Application
  • SavedStateHandleSupport.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)

การมีส่วนร่วมจากภายนอก

  • ขอขอบคุณ dmitrilc ที่แก้ไขข้อผิดพลาดในการพิมพ์ในเอกสารประกอบของ ViewModel (#221)

เวอร์ชัน 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.addRepeatingJob API ออกเพื่อใช้ 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 ต้นทางเมื่อวงจรอยู่ในสถานะหนึ่งๆ เป็นอย่างน้อยโดยใช้ API Lifecycle.repeatOnLifecycle ซึ่งเป็นทางเลือกนอกเหนือจาก LifecycleOwner.addRepeatinJob API ใหม่ (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 นี้จากชุดข้อความต่างๆ
  • ตัวช่วยสถานะวงจรและเหตุการณ์: เพิ่มเมธอดตัวช่วยแบบคงที่ของ downFrom(State), downTo(State), upFrom(State), upTo(State) ลงใน Lifecycle.Event เพื่อสร้าง Event โดยอิงตาม State และทิศทางการเปลี่ยนสถานะ เพิ่มเมธอด getTargetState() ที่ให้ State ซึ่งวงจรจะเปลี่ยนไปใช้โดยตรงหลังจาก Event
  • withStateAtLeast: เพิ่ม Lifecycle.withStateAtLeast API ที่รอสถานะวงจรและเรียกใช้บล็อกโค้ดที่ไม่ระงับพร้อมกัน ณ จุดที่มีการเปลี่ยนแปลงสถานะ จากนั้นจึงกลับมาทำงานต่อพร้อมผลลัพธ์ API เหล่านี้แตกต่างจากเมธอด when* ที่มีอยู่ เนื่องจากไม่อนุญาตให้เรียกใช้โค้ดที่ระงับและไม่ได้ใช้โปรแกรมจ่ายงานที่กำหนดเอง (aosp/1326081)
  • API ของ ViewTree: API ใหม่ของ ViewTreeLifecycleOwner.get(View) และ ViewTreeViewModelStoreOwner.get(View) ช่วยให้คุณดึงข้อมูล LifecycleOwner และ ViewModelStoreOwner ที่มีอยู่ได้ตามลำดับ โดยระบุอินสแตนซ์ View คุณต้องอัปเกรดเป็น Activity 1.2.0 และ Fragment 1.3.0 รวมถึง AppCompat 1.3.0-alpha01 ขึ้นไปเพื่อป้อนข้อมูลนี้อย่างถูกต้อง ส่วนขยาย Kotlin findViewTreeLifecycleOwner และ findViewTreeViewModelStoreOwner พร้อมใช้งานใน lifecycle-runtime-ktx และ lifecycle-viewmodel-ktx ตามลำดับ
  • การเลิกใช้งานส่วนขยาย Kotlin LiveData.observe(): ส่วนขยาย Kotlin LiveData.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)

การมีส่วนร่วมจากภายนอก

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

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

การเปลี่ยนแปลงเอกสารประกอบ

  • เครื่องมือสร้าง 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 คุณต้องอัปเกรดเป็น Activity 1.2.0-alpha05, Fragment 1.3.0-alpha05 และ AppCompat 1.3.0-alpha01 เพื่อป้อนข้อมูลนี้อย่างถูกต้อง เพิ่มส่วนขยาย Kotlin findViewModelStoreOwner() ลงใน lifecycle-viewmodel-ktx แล้ว (aosp/1295522)

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

  • แก้ไขปัญหาที่ทำให้การตรวจสอบ Lint ของ MutableLiveData ที่เผยแพร่ใน Lifecycle 2.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 คุณต้องอัปเกรดเป็น Activity 1.2.0-alpha01 และ Fragment 1.3.0-alpha01 เพื่อป้อนข้อมูลนี้อย่างถูกต้อง ส่วนขยาย Kotlin findViewTreeLifecycleOwner พร้อมให้ใช้งานใน 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) ใหม่เพื่อให้ได้ฟังก์ชันการทำงานเดียวกันเมื่อใช้ Fragment 1.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 เริ่มต้นได้ ซึ่งเราได้ดำเนินการนี้แล้วสำหรับ Activity 1.1.0-alpha02, Fragment 1.2.0-alpha02 และ Navigation 2.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 เป็นค่าเริ่มต้นสำหรับ Activity 1.1.0-alpha02, Fragment 1.2.0-alpha02 และ Navigation 2.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 Factory SavedStateVMFactory ที่เปิดตัวใหม่ และ 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 ไม่สามารถทำงานร่วมกับฟีเจอร์ใหม่ๆ ได้ดีนัก เช่น การมอบสิทธิ์พร็อพเพอร์ตี้ใน Kotlin by 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.0
  • android.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