چرخه زندگی

مولفه های آگاه از چرخه حیات، اقداماتی را در پاسخ به تغییر وضعیت چرخه حیات یک جزء دیگر، مانند فعالیت ها و قطعات، انجام می دهند. این مولفه ها به شما کمک می کنند کدی با سازماندهی بهتر و اغلب سبک تر تولید کنید که نگهداری آن آسان تر است.

این جدول تمام مصنوعات موجود در گروه androidx.lifecycle را فهرست می کند.

غیرواقعی، ساختگی انتشار پایدار نامزد انتشار نسخه بتا انتشار آلفا
چرخه زندگی-* 2.8.4 - - -
lifecycle-viewmodel-compose 2.8.4 - - -
آخرین به روز رسانی این کتابخانه در: 24 جولای 2024

اعلام وابستگی ها

برای افزودن وابستگی به Lifecycle، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر ، مخزن Maven Google را بخوانید.

وابستگی‌های مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

کاتلین

شیار

    dependencies {
        def lifecycle_version = "2.8.4"
        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"

        // 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"
    }

کاتلین

    dependencies {
        val lifecycle_version = "2.8.4"
        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")

        // 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")
    }

جاوا

شیار

    dependencies {
        def lifecycle_version = "2.8.4"
        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"
    }

کاتلین

    dependencies {
        val lifecycle_version = "2.8.4"
        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 کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. با کلیک کردن روی دکمه ستاره می توانید رای خود را به یک موضوع موجود اضافه کنید.

یک شماره جدید ایجاد کنید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه 2.8

نسخه 2.8.4

24 جولای 2024

androidx.lifecycle:lifecycle-*:2.8.4 منتشر شد. نسخه 2.8.4 حاوی این commit ها است.

رفع اشکال

  • اکنون LiveData.asFlow() به درستی مواردی را که در آن Flow برگشتی بلافاصله پس از دریافت مقداری که قبلاً در LiveData تنظیم شده است تکمیل می شود (به عنوان مثال، هنگام استفاده از take(1) ). ( I9c566 )
  • Lifecycle*Effect اکنون بی‌توان است (به عنوان مثال، اگر onStopOrDispose به دلیل توقف چرخه حیات فراخوانی شده باشد، برای بار دوم پس از دور ریختن فراخوانی نمی‌شود مگر اینکه چرخه حیات دوباره به STARTED برگردد). ( I5f607 , b/352364595 )

نسخه 2.8.3

1 ژوئیه 2024

androidx.lifecycle:lifecycle-*:2.8.3 منتشر شد. نسخه 2.8.3 شامل این commit ها است.

رفع اشکال

  • مشکل سازگاری رو به عقب 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 شامل این commit ها است.

رفع اشکال

  • رفع CompositionLocal LocalLifecycleOwner not present - اکنون می‌توانید از Lifecycle 2.8.2 با هر نسخه از Compose بدون هیچ راه‌حلی استفاده کنید. ( aosp/3105647 , b/336842920 )
  • هنگام مخلوط کردن نسخه‌های قبلی وابستگی‌های compileOnly Lifecycle با نسخه‌های 2.8+، ViewModelProvider دیگر خراب نمی‌شود و مشکلات کتابخانه‌هایی مانند LeakCanary را برطرف می‌کند. ( I80383 , b/341792251 )

نسخه 2.8.1

29 مه 2024

androidx.lifecycle:lifecycle-*:2.8.1 منتشر شد. نسخه 2.8.1 حاوی این commit ها است.

رفع اشکال

  • lifecycle-viewmodel-compose اکنون فقط یک وابستگی مشترک به compose-runtime دارد و وابستگی رایج آن به compose-ui حذف می‌شود. مصنوع اندرویدی 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) منسوخ شد.

  • پسوندهای lifecycle-livedata-core-ktx kotlin اکنون به ماژول lifecycle-livedata-core منتقل شده‌اند.

  • NullSafeMutableLiveData برای جلوگیری از بسیاری از موارد مثبت کاذب مجدداً اصلاح شده است.

سازگاری چند پلتفرمی کاتلین چرخه حیات

APIهای اصلی Lifecycle در Lifecycle ، LifecycleOwner ، LifecycleObserver ، Lifecycle.State ، Lifecycle.Event ، و LifecycleRegistry اکنون در مصنوعات سازگار با Kotlin Multiplatform ارسال می شوند.

مصنوعات تحت تاثیر:

  • lifecycle-common اکثر API ها را به common منتقل می کند و علاوه بر اندروید از jvm و iOS نیز پشتیبانی می کند.
  • lifecycle-runtime اکثر APIها را به common منتقل می کند و علاوه بر اندروید از jvm و iOS نیز پشتیبانی می کند.
  • lifecycle-runtime-ktx اکنون خالی است و همه API ها به lifecycle-runtime منتقل می شوند.
  • lifecycle-runtime-compose همه APIها را به common منتقل می‌کند و یک مصنوع Android را ارسال می‌کند که با پشتیبانی چند پلتفرمی androidx.compose مطابقت دارد.

سازگاری چند پلتفرمی ViewModel Kotlin

مصنوع lifecycle-viewmodel و APIهایی مانند ViewModel ، ViewModelStore ، ViewModelStoreOwner ، و ViewModelProvider اکنون در مصنوعات سازگار با Kotlin Multiplatform ارسال می شوند.

برای تطبیق با این تغییر، روش‌هایی مانند روش‌هایی در ViewModelProvider که java.lang.Class<T> را انتخاب کردند، اکنون یک متد معادل دارند که یک kotlin.reflect.KClass<T> می‌گیرد.

سازگاری باینری در Android حفظ شده است، اما در مقایسه سطح API Android با سطح API مشترک، چند تغییر قابل توجه وجود دارد:

  • ساختن یک نمونه ViewModelProvider اکنون از طریق متدهای ViewModelProvider.create() انجام می شود نه اینکه مستقیما سازنده آن را فراخوانی کند.
  • ViewModelProvider.NewInstanceFactory و ViewModelProvider.AndroidViewModelFactory فقط در Android در دسترس هستند.
    • سفارشی Factories توصیه می شود از ViewModelProvider.Factory گسترش یافته و از روش create استفاده کنند که یک CreationExtras می گیرد یا از viewModelFactory Kotlin DSL استفاده می کند.
  • استفاده از ViewModelProvider بدون کارخانه سفارشی در پلتفرم‌های غیر JVM منجر به UnsupportedOperationException می‌شود. در پلتفرم‌های JVM، اگر کارخانه سفارشی ارائه نشود، سازگاری با استفاده از سازنده ViewModel بدون args حفظ می‌شود.
  • viewModelScope به یک EmptyCoroutineContext در پلتفرم هایی که Dispatchers.Main در دسترس نیست (مثلاً لینوکس) بازگشتی خواهد داشت.

مصنوعات تحت تاثیر:

  • lifecycle-viewmodel اکثر API ها را به common منتقل می کند و علاوه بر اندروید از jvm و iOS نیز پشتیبانی می کند.
  • lifecycle-viewmodel-ktx اکنون خالی است و همه APIها به lifecycle-viewmodel منتقل می شوند.
  • lifecycle-viewmodel-compose همه APIها را به common منتقل می‌کند و یک مصنوع Android را ارسال می‌کند، که با پشتیبانی چند پلتفرمی androidx.compose مطابقت دارد.

تغییرات رفتار

  • InitializerViewModelFactory (شامل تابع سازنده viewModelFactory ) اکنون یک IllegalArgumentException ایجاد می کند اگر یک initializer با همان clazz: KClass<VM : ViewModel> قبلاً اضافه شده باشد. ( IC3a36 )

مشکلات شناخته شده

نسخه 2.8.0-rc01

1 مه 2024

androidx.lifecycle:lifecycle-*:2.8.0-rc01 منتشر شد. نسخه 2.8.0-rc01 حاوی این commit ها است.

رفع اشکال

  • مشکلی که در آن نمایه خط پایه برای کلاس‌های lifecycle-common به درستی بسته‌بندی نشده بود، برطرف شد. اینها اکنون در AAR lifecycle-runtime بسته بندی شده اند. ( aosp/3038274 , b/322382422 )
  • اصلاح یک تغییر سفارش ناخواسته در نحوه پاک شدن نمونه های AutoCloseable متصل به ViewModel - ترتیب قبلی addCloseable(String, AutoCloseable) و سپس addClosable(AutoCloseable) و سپس onCleared() بازیابی شده است. ( aosp/3041632 )
  • رفتار ایجاد پیش فرض را برای viewModelScope برای محیط های Native و 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 را ارسال می‌کند، مطابق با پشتیبانی از multiplatform برای androidx.compose . ( If7a71 , I4f4a0 , b/331769623 )

نسخه 2.8.0-alpha04

3 آوریل 2024

androidx.lifecycle:lifecycle-*:2.8.0-alpha04 منتشر شد. نسخه 2.8.0-alpha04 حاوی این commit ها است.

ویژگی های جدید

  • مصنوع lifecycle-viewmodel-compose اکنون با Kotlin Multiplatform سازگار است، کد آن را به common منتقل می‌کند و یک مصنوع Android را ارسال می‌کند، که با پشتیبانی چندپلتفرمی androidx.compose مطابقت دارد. برای تطبیق با این تغییر، روش Composable viewModel اکنون یک KClass علاوه بر یک java.lang.Class می پذیرد. ( b/330323282 )

رفع اشکال

  • NullSafeMutableLiveData برای جلوگیری از بسیاری از موارد مثبت کاذب مجدداً اصلاح شده است. ( I2d8c1 ، Iafb18 ، I03463 ، I7ecef )

به روز رسانی وابستگی

  • مصنوع lifecycle-viewmodel-compose اکنون به Compose 1.6.0 بستگی دارد.
  • چرخه حیات اکنون به Profile Installer 1.3.1 بستگی دارد.

نسخه 2.8.0-alpha03

20 مارس 2024

androidx.lifecycle:lifecycle-*:2.8.0-alpha03 منتشر شد. نسخه 2.8.0-alpha03 حاوی این commit ها است.

ویژگی های جدید

  • 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

مصنوع lifecycle-viewmodel و APIهایی مانند ViewModel ، ViewModelStore ، ViewModelStoreOwner ، و ViewModelProvider اکنون در مصنوعات سازگار با Kotlin Multiplatform ارسال می شوند. ( b/214568825 )

برای تطبیق با این تغییر، روش‌هایی مانند روش‌هایی در ViewModelProvider که java.lang.Class<T> را انتخاب کردند، اکنون یک متد معادل دارند که یک kotlin.reflect.KClass<T> می‌گیرد.

سازگاری باینری در Android حفظ شده است، اما در مقایسه سطح API Android با سطح API مشترک، چند تغییر قابل توجه وجود دارد:

  • ساختن یک نمونه ViewModelProvider اکنون از طریق متدهای ViewModelProvider.create() انجام می شود نه اینکه مستقیما سازنده آن را فراخوانی کند.
  • ViewModelProvider.NewInstanceFactory و ViewModelProvider.AndroidViewModelFactory فقط در Android در دسترس هستند.
    • سفارشی Factories توصیه می شود از ViewModelProvider.Factory گسترش یافته و از روش create استفاده کنند که یک CreationExtras می گیرد یا از viewModelFactory Kotlin DSL استفاده می کند.
  • استفاده از ViewModelProvider بدون کارخانه سفارشی در پلتفرم‌های غیر JVM منجر به UnsupportedOperationException می‌شود. در پلتفرم‌های JVM، اگر کارخانه سفارشی ارائه نشود، سازگاری با استفاده از سازنده ViewModel بدون args حفظ می‌شود.
  • viewModelScope به یک EmptyCoroutineContext در پلتفرم هایی که Dispatchers.Main در دسترس نیست (مثلاً لینوکس) بازگشتی خواهد داشت.

تغییرات رفتار

  • 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 استفاده شوند. با تشکر از جیک وارتون برای مشارکت. ( I6c41b , b/328263448 )

نسخه 2.8.0-alpha02

21 فوریه 2024

androidx.lifecycle:lifecycle-*:2.8.0-alpha02 منتشر شد. نسخه 2.8.0-alpha02 حاوی این commit ها است.

ویژگی های جدید

  • API‌های dropUnlessResumed و dropUnlessStarted اضافه شده‌اند که به شما امکان می‌دهند کلیک یا رویدادهای دیگری را که حتی پس از سقوط LifecycleOwner به زیر Lifecycle.State رخ می‌دهند، رها کنید. به عنوان مثال، این می تواند با Navigation Compose برای جلوگیری از مدیریت رویدادهای کلیک پس از اینکه انتقال به صفحه دیگری از قبل شروع شده است استفاده شود: onClick: () -> Unit = dropUnlessResumed { navController.navigate(NEW_SCREEN) } ( Icba83 , b/317230685 )

تبدیل کاتلین

  • ViewModel اکنون در Kotlin نوشته شده است ( I16f26 , b/214568825 )
  • پسوندهای lifecycle-viewmodel-ktx kotlin اکنون به ماژول چرخه حیات پایه منتقل شده‌اند. ( Id787b , b/274800183 )
  • الحاقات lifecycle-runtime-ktx kotlin اکنون به ماژول چرخه حیات پایه منتقل شده اند. ( IC3686 , b/274800183 )
  • پسوندهای lifecycle-livedata-core-ktx kotlin اکنون به ماژول چرخه حیات پایه منتقل شده‌اند. ( I54a3d , b/274800183 )

سازگاری چند پلتفرمی Kotlin

  • APIهای اصلی Lifecycle در 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 )

مشارکت خارجی

  • از ایوان ماتکوف از Jetbrains برای کمک به انتقال Lifecycle به چند پلتفرم Kotlin تشکر می کنیم. ( aosp/2926690 ، I0c5ac ، If445d )

نسخه 2.8.0-alpha01

24 ژانویه 2024

androidx.lifecycle:lifecycle-*:2.8.0-alpha01 منتشر شد. نسخه 2.8.0-alpha01 حاوی این commit ها است.

ویژگی های جدید

  • ViewModel اکنون از افزودن اشیای Closeable با key پشتیبانی می کند که امکان بازیابی آنها را از طریق getCloseable() فراهم می کند. ( I3cf63 )

نسخه 2.7

نسخه 2.7.0

10 ژانویه 2024

androidx.lifecycle:lifecycle-*:2.7.0 منتشر شد. نسخه 2.7.0 حاوی این commit ها است.

تغییرات مهم از 2.6.0

  • TestLifecycleOwner اکنون یک تابع تعلیق setCurrentState() را شامل می شود که تضمین می کند که تغییر حالت و تمام تماس های LifecycleObserver قبل از بازگشت کامل می شود. قابل‌توجه، برخلاف تنظیم مستقیم ویژگی currentState ، این ویژگی از runBlocking استفاده نمی‌کند و استفاده از آن را در برنامه‌های معمولی مانند آنچه توسط runTest ارائه می‌کند، ایمن می‌سازد.
  • پسوندهای LiveData map و switchMap اکنون رفتار distinctUntilChanged را منعکس می‌کنند - اگر LiveData دارای value تنظیم شده باشد، تابع map / switchMap فوراً برای پر کردن value LiveData برگشتی فراخوانی می‌شود. این تضمین می‌کند که مقدار اولیه به عنوان بخشی از اولین ترکیب تنظیم می‌شود (هنگامی که با observeAsState() استفاده می‌شود، اما رفتار مشاهده را تغییر نمی‌دهد - مقادیر به‌روزرسانی‌ها از منبع LiveData فقط زمانی اعمال می‌شوند که شروع به مشاهده LiveData کنید.
  • این نسخه مشکلی را برطرف می‌کند که در آن SavedStateHandle کلاس‌های سفارشی Parcelable را پس از مرگ فرآیند و بازیابی به درستی بازیابی نمی‌کند. با توجه به اطلاعات تایپی که توسط فریمورک اندروید از دست می‌رود، آرایه‌های Parcelables سفارشی به کار بیشتری نیاز دارند (ایجاد دستی آرایه‌ای تایپ‌شده از نوع مناسب) و مستندات get ، getLiveData و getStateFlow اکنون به‌طور خاص این محدودیت را فراخوانی می‌کنند.
  • قوانین حفظ حفاظت مرتبط با LifecycleObserver حذف شده است. این بدان معنی است که کد محافظت شده ای که می خواهد از API ها از طریق بازتاب استفاده کند (مانند استفاده از حاشیه نویسی @OnLifecycleEvent که مدت هاست منسوخ شده است) باید قوانین حفظ خود را برای مورد استفاده خاص خود ارائه دهد.

قابلیت مشاهده رویداد چرخه حیات

  • به عنوان جایگزینی برای استفاده از LifecycleEventObserver ، اکنون می توانید یک Flow of Lifecycle.Event از طریق متد توسعه Lifecycle.asFlow() مشاهده کنید.
  • کاربران 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 حاوی این commit ها است.

رفع اشکال

  • مشکلی را که در آن SavedStateHandle به درستی کلاس‌های Parcelable سفارشی را پس از مرگ فرآیند و بازیابی بازیابی نمی‌کرد، برطرف شد. با توجه به اطلاعات تایپی که توسط فریمورک اندروید از دست می‌رود، آرایه‌های Parcelables سفارشی به کار بیشتری نیاز دارند (ایجاد دستی آرایه‌ای تایپ‌شده از نوع مناسب) و مستندات get ، getLiveData و getStateFlow اکنون به‌طور خاص این محدودیت را فراخوانی می‌کنند. ( I0b55a )

نسخه 2.7.0-rc01

15 نوامبر 2023

androidx.lifecycle:lifecycle-*:2.7.0-rc01 منتشر شد. نسخه 2.7.0-rc01 حاوی این commit ها است.

رفع اشکال

  • 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 حاوی این commit ها است.

ویژگی های جدید

  • lifecycle-runtime-testing اکنون حاوی یک بررسی Lint جدید است تا از تنظیم Lifecycle.State TestLifecycleOwner با استفاده از فیلد currentState در داخل یک برنامه اجتناب شود. بررسی 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 حاوی این commit ها است.

ویژگی های جدید

  • TestLifecycleOwner اکنون شامل تابع تعلیق setCurrentState() است تا به کاربران این امکان را بدهد که از TestLifecycleOwner از درون برنامه‌ای مانند آنچه توسط 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 )
  • در صورتی که ViewModel قبلاً با onCleared() تماس گرفته باشد، اکنون addCloseable() ViewModel بلافاصله Closeable می بندد. ( 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 حاوی این commit ها است.

تغییرات API

  • Lifecycle.State اکنون از طریق Lifecycle.currentStateFlow قابل مشاهده است، که یک StateFlow را برمی‌گرداند که در آن value Lifecycle.State فعلی است. ( Ib212d , b/209684871 )
  • Lifecycle.Event s اکنون می تواند به عنوان یک Flow با Lifecycle.asFlow(). ( If2c0f , b/176311030 )
  • LifecycleResumeEffect API برای اجرای Compose SideEffect بر اساس تماس‌های رویداد Lifecycle.Event.ON_RESUME و Lifecycle.Event.ON_PAUSE اضافه شده است. ( I60386 , b/235529345 )
  • LifecycleStartEffect API برای اجرای Compose SideEffect بر اساس تماس‌های رویداد Lifecycle.Event.ON_START و Lifecycle.Event.ON_STOP اضافه شده است. ( I5a8d1 , b/235529345 )
  • LifecycleEventEffect API برای اجرای Compose SideEffect بر اساس 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 )
  • قوانین حفظ حفاظت مرتبط با LifecycleObserver حذف شده است. این بدان معنی است که کد محافظت شده ای که می خواهد از API ها از طریق بازتاب استفاده کند، باید قوانین نگهداری خود را برای مورد استفاده خاص خود ارائه دهد. ( Ia12fd )

نسخه 2.6

نسخه 2.6.2

6 سپتامبر 2023

androidx.lifecycle:lifecycle-*:2.6.2 منتشر شد. نسخه 2.6.2 حاوی این commit ها است.

رفع اشکال

  • مشکلی را برطرف کرد که در آن SavedStateHandle پس از مرگ پردازش، در صورت بازیابی وضعیت، به درستی بازیابی نمی‌شد، save() بدون ذخیره واقعی حالت در SavedStateRegistry والد فراخوانی شد و سپس وضعیت دوباره بازیابی شد. این کار تعامل بین rememberSaveable و NavHost Navigation Compose را برطرف می کند. ( aosp/2729289 )

نسخه 2.6.1

22 مارس 2023

androidx.lifecycle:lifecycle-*:2.6.1 منتشر شد. نسخه 2.6.1 حاوی این commit ها است.

به روز رسانی های وابستگی

نسخه 2.6.0

8 مارس 2023

androidx.lifecycle:lifecycle-*:2.6.0 منتشر شد. نسخه 2.6.0 حاوی این commit ها است.

تغییرات مهم از 2.5.0

  • LiveData اکنون دارای ویژگی isInitialized جدیدی است که نشان می‌دهد آیا یک مقدار صریح روی LiveData تنظیم شده است یا خیر، به شما این امکان را می‌دهد که بین liveData.value که null را برمی‌گرداند تمایز قائل شوید زیرا هیچ مقداری تا کنون تنظیم نشده است یا یک مقدار null صریح.
  • MediatorLiveData اکنون شامل یک سازنده برای تنظیم مقدار اولیه است.
  • یک برنامه افزودنی جدید در StateFlow و Flow of collectAsStateWithLifecycle() اضافه شده است که از جریان ها جمع آوری می شود و آخرین مقدار آن را به عنوان Compose State به شیوه ای آگاه از چرخه حیات نشان می دهد.
  • روش‌های Lifecycle.launchWhenX و Lifecycle.whenX منسوخ شده‌اند، زیرا استفاده از توزیع‌کننده مکث می‌تواند در برخی موارد منجر به هدر رفتن منابع شود. توصیه می شود از Lifecycle.repeatOnLifecycle استفاده کنید. برای اطلاعات بیشتر در مورد تعلیق یک بار کار، لطفاً به این توضیح در مورد اینکه چرا این کار ذاتاً ناامن است، مراجعه کنید.
  • تبدیل Kotlin - تعداد زیادی از کلاس های Lifecycle به Kotlin تبدیل شده اند. همه کلاس های تبدیل شده هنوز سازگاری باینری خود را با نسخه های قبلی حفظ می کنند. کلاس های زیر دارای تغییرات ناسازگار منبع برای کلاس های نوشته شده در Kotlin هستند: ViewTreeLifecycleOwner ، LiveDataReactiveStreams ، HasDefaultViewModelProviderFactory ، ViewTreeViewModelStoreOwner ، Transformations ، ViewModelStoreOwner ، LifecycleOwner

جدول زیر تبدیل های منبع را برای نسخه جدید چرخه حیات ارائه می دهد.

چرخه حیات 2.5 چرخه زندگی 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() یک نوع nullable را بپذیرد، باید Observer را با یک نوع nullable نمونه سازی کنید.
  • این کلاس‌ها نیز به Kotlin تبدیل شدند، اما سازگار با منبع باقی ProcessLifecycleOwner : DefaultLifecycleObserver ، LifecycleEventObserver ، Lifecycle ، LifecycleRegistry ، LifecycleObserver ، ViewModelStore ، AndroidViewModel ، AbstractSavedStateViewModelFactory ، LifecycleService ، و ServiceLifecycleDispatcher

نسخه 2.6.0-rc01

22 فوریه 2023

androidx.lifecycle:lifecycle-*:2.6.0-rc01 منتشر شد. نسخه 2.6.0-rc01 حاوی این commit ها است.

رفع اشکال

  • پسوند 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 حاوی این تعهدات است.

تبدیل کاتلین

  • 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-runtime-ktx به آرتیفکت lifecycle-common منتقل شده است. ( Iabb91 , b/240298691 )

نسخه 2.6.0-alpha05

25 ژانویه 2023

androidx.lifecycle:lifecycle-*:2.6.0-alpha05 منتشر شد. نسخه 2.6.0-alpha05 حاوی این commit ها است.

تبدیل کاتلین

  • Transformations اکنون در Kotlin نوشته شده است. این یک تغییر منبع ناسازگار برای کلاس‌هایی است که در Kotlin نوشته شده‌اند که مستقیماً از نحو استفاده می‌کردند، مانند Transformations.map - کد Kotlin اکنون باید از نحو روش پسوند Kotlin استفاده کند که قبلاً فقط هنگام استفاده از lifecycle-livedata-ktx در دسترس بود. هنگام استفاده از زبان برنامه‌نویسی جاوا، نسخه‌های این روش‌ها که از روش androidx.arch.core.util.Function استفاده می‌کنند منسوخ می‌شوند و با نسخه‌هایی که Function1 Kotlin1 هستند جایگزین می‌شوند. این تغییر سازگاری باینری را حفظ می کند. ( I8e14f )
  • ViewTreeViewModelStoreOwner اکنون در Kotlin نوشته شده است. این یک تغییر منبع ناسازگار برای کلاس‌هایی است که در Kotlin نوشته شده‌اند - اکنون باید مستقیماً روش‌های افزودنی Kotlin را در View of androidx.lifecycle.setViewTreeViewModelStoreOwner و androidx.lifecycle.findViewTreeViewModelStoreOwner وارد کرده و از آنها استفاده کنید تا یک مالک از قبل تنظیم شده را تنظیم و پیدا کنید. این باینری سازگار است و برای پیاده سازی های نوشته شده در زبان برنامه نویسی جاوا سازگار با منبع باقی می ماند. ( 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 , I1cda1949 , I18884

نسخه 2.6.0-alpha04

11 ژانویه 2023

androidx.lifecycle:lifecycle-*:2.6.0-alpha04 منتشر شد. نسخه 2.6.0-alpha04 حاوی این commit ها است.

ویژگی های جدید

  • LiveData اکنون دارای ویژگی isInitialized جدیدی است که نشان می‌دهد آیا یک مقدار صریح روی LiveData تنظیم شده است یا خیر، به شما این امکان را می‌دهد که بین liveData.value که null را برمی‌گرداند تمایز قائل شوید زیرا هیچ مقداری تا کنون تنظیم نشده است یا یک مقدار null صریح. ( Ibd018 )

تغییرات API

  • APIهای collectAsStateWithLifecycle() lifecycle-runtime-compose دیگر در وضعیت آزمایشی نیستند. ( I09d42 , b/258835424 )
  • روش‌های Lifecycle.launchWhenX و Lifecycle.whenX منسوخ شده‌اند، زیرا استفاده از توزیع‌کننده مکث می‌تواند در برخی موارد منجر به هدر رفتن منابع شود. توصیه می شود از Lifecycle.repeatOnLifecycle استفاده کنید. ( Iafc54 , b/248302832 )

تبدیل کاتلین

  • ViewTreeLifecycleOwner اکنون در Kotlin نوشته شده است. این یک تغییر منبع ناسازگار برای کلاس‌هایی است که در Kotlin نوشته شده‌اند - اکنون باید مستقیماً روش‌های افزودنی Kotlin را در View of androidx.lifecycle.setViewTreeLifecycleOwner و androidx.lifecycle.findViewTreeLifecycleOwner وارد کرده و از آنها استفاده کنید تا یک مالک از قبل تنظیم شده را تنظیم و پیدا کنید. این جایگزین پسوند قبلی Kotlin در lifecycle-runtime-ktx می شود. این باینری سازگار است و برای پیاده سازی های نوشته شده در زبان برنامه نویسی جاوا سازگار با منبع باقی می ماند. ( 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 , 230,129 /159 )

رفع اشکال

  • هنگام فراخوانی get() با نوع کلاس نادرست، SavedStateHandle دیگر با ClassCastException خراب نمی شود. ( I6ae7c )

نسخه 2.6.0-alpha03

24 اکتبر 2022

androidx.lifecycle:lifecycle-*:2.6.0-alpha03 منتشر شد. نسخه 2.6.0-alpha03 حاوی این commit ها است.

رفع اشکال

  • مشکل مربوط به محدودیت‌های بین ماژول‌های مختلف Lifecycle که طبق برنامه کار نمی‌کردند برطرف شد. ( 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 حاوی این commit ها است.

تغییرات API

  • MediatorLiveData اکنون شامل یک سازنده برای تنظیم مقدار اولیه است. ( Ib6cc5 , b/151244085 )

رفع اشکال

  • مصنوعات Lifecycle اکنون شامل محدودیت‌هایی هستند که تضمین می‌کنند تمام مصنوعات چرخه حیاتی وابسته به هم از یک نسخه استفاده می‌کنند و به طور خودکار سایر وابستگی‌ها را هنگام ارتقاء ارتقا می‌دهند. ب/242871265
  • FlowLiveData.asFlow() اکنون یک callbackFlow ایجاد می کند تا اینکه از اجرای Channel خود برای اطمینان از ایمنی رشته و حفظ بافت استفاده کند. ( I4a8b2 , b/200596935 )
  • تابع asLiveData FlowLiveData اکنون مقدار اولیه StateFlow را هنگام ایجاد شی LiveData جدید حفظ می کند. ( I3f530 , b/157380488 )
  • از Lifecycle 2.5.1 : پیاده‌سازی‌های سفارشی AndroidViewModelFactory اکنون هنگام استفاده از سازنده stateful با Lifecycle 2.4+ ( I5b315 ، b/238011621 )، تابع create(modelClass) به درستی فراخوانی می‌کند.

نسخه 2.6.0-alpha01

29 ژوئن 2022

androidx.lifecycle:lifecycle-*:2.6.0-alpha01 منتشر می شود. نسخه 2.6.0-alpha01 شامل این تعهدات است.

ویژگی های جدید

  • افزودنی جدید در StateFlow و Flow collectAsStateWithLifecycle که از جریان جمع می شود و آخرین مقدار آن را به عنوان حالت آهنگسازی به روش آگاه از چرخه عمر نشان می دهد. جریان جمع آوری می شود و انتشار جدید بر روی مقدار حالت تنظیم می شود که چرخه عمر حداقل در یک Lifecycle.State خاص باشد. هنگامی که چرخه عمر زیر آن Lifecycle.State قرار می گیرد. محل ، مجموعه جریان متوقف می شود و مقدار حالت به روز نمی شود. ( i1856e ، b/230557927 )

نسخه 2.5

نسخه 2.5.1

27 جولای 2022

androidx.lifecycle:lifecycle-*:2.5.1 منتشر می شود. نسخه 2.5.1 شامل این تعهدات است.

رفع اشکال

  • اجرای سفارشی AndroidViewModelFactory اکنون به طور صحیح با استفاده از سازنده AndroidViewModelFactory با Lifecycle 2.4+ ، عملکرد create(modelClass) را فراخوانی می کند. ( i5b315 ، b/238011621 )

نسخه 2.5.0

29 ژوئن 2022

androidx.lifecycle:lifecycle-*:2.5.0 منتشر می شود. نسخه 2.5.0 شامل این تعهدات است.

تغییرات مهم از 2.4.0

  • SavedStateHandle اکنون یک API getStateFlow() را ارائه می دهد که یک StateFlow Kotlin را برای نظارت بر تغییرات ارزش به عنوان جایگزینی برای استفاده از LiveData باز می گرداند.

  • ViewModel CreationExtras - هنگام نوشتن یک ViewModelProvider.Factory ، دیگر نیازی به گسترش AndroidViewModelFactory یا AbstractSavedStateViewModelFactory نیست تا به ترتیب دسترسی به یک Application یا SavedStateHandle را بدست آورید. در عوض ، این زمینه ها به هر ViewModelProvider.Factory Subclass به عنوان CreationExtras از طریق اضافه بار جدید create : create(Class<T>, CreationExtras) ارائه می شود. این موارد اضافی به ترتیب توسط فعالیت یا قطعه شما هنگام استفاده از فعالیت 1.5.0 و قطعه 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 را تعریف کنید. از نظر یک یا چند اولیه اولیه لامبدا ، یکی برای هر کلاس 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 را برای ایجاد یک نمونه 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)
}

  • SavedStateHandle یکپارچه سازی Saver را تشکیل می دهد- Artifact 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 را به 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()
   }
}

    که می تواند ضمن حفظ همان عمر viewModelScope در سازنده ViewModel شما استفاده شود:

    class TestScopeViewModel(
    val customScope: CloseableCoroutineScope = CloseableCoroutineScope()
) : ViewModel(customScope) {
    // You can now use customScope in the same way as viewModelScope
}

تغییر رفتار

  • تلاش برای جابجایی Lifecycle.State از INITIALIZED به DESTROYED ، اکنون بدون در نظر گرفتن اینکه Lifecycle دارای یک ناظر متصل است ، همیشه یک IllegalStateException را پرتاب می کند.
  • LifecycleRegistry اکنون هنگام رسیدن به وضعیت DESTROYED ، ناظران خود را پاک می کند.

نسخه 2.5.0-RC02

15 ژوئن 2022

androidx.lifecycle:lifecycle-*:2.5.0-rc02 منتشر می شود. نسخه 2.5.0-RC02 شامل این تعهدات است.

رفع اشکال

  • ViewModelProvider هنگام مخلوط کردن نسخه های قبلی وابستگی های چرخه عمر کامپایلون با نسخه های 2.5+ دیگر خراب نمی شود. ( i81a66 ، b/230454566 )

نسخه 2.5.0-RC01

11 مه 2022

androidx.lifecycle:lifecycle-*:2.5.0-rc01 منتشر می شود. نسخه 2.5.0-RC01 شامل این تعهدات است.

رفع اشکال

  • MediatorLiveData.addSource() اکنون به جای انتشار null null NullPointerException منتقل می کند. ( 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 است. ( 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 تغییر می کند

  • یک مسئله سازگاری با چرخه عمر 2.3 و نسخه های چرخه عمر جدید در جاوا را برطرف کرد. ( 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 اکنون یک API getStateFlow() را ارائه می دهد که یک StateFlow Kotlin را برای نظارت بر تغییرات ارزش به عنوان جایگزینی برای استفاده از LiveData باز می گرداند. ( IAD3AB ، b/178037961 )

نسخه 2.5.0-alpha03

23 فوریه 2022

androidx.lifecycle:lifecycle-*:2.5.0-alpha03 منتشر می شود. نسخه 2.5.0-alpha03 شامل این تعهدات است.

ویژگی های جدید

  • یک API addCloseable() و یک اضافه بار سازنده جدید اضافه کرد که به شما امکان می دهد یک یا چند شیء Closeable را به ViewModel اضافه کنید که هنگام پاک شدن ViewModel بدون نیاز به کار دستی در onCleared() بسته می شود. ( i55EA0 )
  • lifecycle-viewmodel اکنون یک InitializerViewModelFactory را ارائه می دهد که به شما امکان می دهد Lambda را برای دستیابی به کلاسهای خاص ViewModel اضافه کنید ، با استفاده از CreationExtras به عنوان منبع اصلی داده. ( IF58FC ، B/216687549 )
  • lifecycle-viewmodel-compose اکنون یک API viewModel() را ارائه می دهد که یک کارخانه Lambda را برای ایجاد یک نمونه ViewModel می گیرد بدون اینکه نیاز به ایجاد یک ViewModelProvider.Factory داشته باشد. ( I97FBB ، B/216688927 )

API تغییر می کند

  • اکنون می توانید از طریق ViewModel از طریق CreationExtras از طریق lifecycle-viewmodel-compose ایجاد کنید. ( I08887 ، b/216688927 )

تغییر رفتار

  • تلاش برای جابجایی Lifecycle.State از INITIALIZED به DESTROYED ، اکنون بدون در نظر گرفتن اینکه Lifecycle دارای یک ناظر متصل است ، همیشه یک IllegalStateException را پرتاب می کند. ( 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 به کوتلین تبدیل شده اند. این امر باعث افزایش باطل شدن ژنرال ها در هر دو کلاس شده است. ( ib6ce2 ، b/216168263 ، i9647a ، b/177667711 )
  • پارامتر عملکرد LiveData switchMap اکنون می تواند خروجی قابل تهی داشته باشد. ( i40396 ، b/132923666 )
  • پسوندهای LiveData -KTX اکنون با @CheckResult حاشیه نویسی شده اند تا بتوانند نتیجه را هنگام فراخوانی این توابع استفاده کنند. ( IA0F05 ، B/207325134 )

تغییر رفتار

  • SavedStateHandle اکنون به درستی پیش فرض Value را ذخیره می کند وقتی که هیچ مقدار برای کلید مشخص شده وجود ندارد. ( i1c6ce ، b/178510877 )

رفع اشکال

  • از چرخه عمر 2.4.1 : lifecycle-process به روز شده به استارتاپ 1.1.1 بستگی دارد تا اطمینان حاصل شود که رفع هایی که مانع از پرتاب ProcessLifecycleInitializer StartupException ، به طور پیش فرض در دسترس هستند. ( IB01DF ، B/216490724 )
  • اکنون وقتی کلاس های AndroidViewModel سفارشی پارامترهایی را به ترتیب اشتباه دارند و سعی در ایجاد یک ViewModel دارند ، یک پیام خطای بهبود یافته وجود دارد. ( i340f7 ، b/177667711 )
  • اکنون می توانید با استفاده از AndroidViewModelFactory بدون تنظیم یک برنامه ، یک مدل نمایش را از طریق CreationExtras ایجاد کنید. ( i6ebef ، b/217271656 )

نسخه 2.5.0-alpha01

26 ژانویه 2022

androidx.lifecycle:lifecycle-*:2.5.0-alpha01 منتشر می شود. نسخه 2.5.0-alpha01 شامل این تعهدات است.

ViewModel CreationExtras

با این نسخه ، ما زمینه را برای بازسازی نحوه ساخت یک ViewModel در حال انجام هستیم. به جای مجموعه ای سفت و سخت از زیر کلاسهای ViewModelProvider.Factory که هرکدام عملکرد اضافی را اضافه می کنند (اجازه می دهد تا یک پارامتر سازنده Application از طریق AndroidViewModelFactory ، اجازه یک پارامتر سازنده SavedStateHandle از طریق SavedStateViewModelFactory و AbstractSavedStateViewModelFactory ، و غیره) را انجام دهیم) ، ما در حال حرکت به Whato Water Whato Water Water هستیم. در مورد یک مفهوم جدید ، CreationExtras . ( 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 استفاده شود ، فراهم می کند.

این موارد اضافی به طور پیش فرض هنگام استفاده از فعالیت 1.5.0-alpha01 ، قطعه 1.5.0-alpha01 و ناوبری 2.5.0-alpha01 ارائه می شود. If you use an earlier version of those libraries, your CreationExtras will be empty - all of the existing subclasses of ViewModelProvider.Factory have been rewritten to support both the legacy creation path used by earlier versions of those libraries and the CreationExtras path which will be used پیش رفتن.

این CreationExtras به شما امکان می دهد یک ViewModelProvider.Factory را بسازید که فقط اطلاعات مورد نیاز شما به هر ViewModel را بدون تکیه بر یک سلسله مراتب دقیق از زیر کلاسهای کارخانه منتقل می کند:

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() در CreationExtras از SavedStateHandleSupport برای ساخت یک SavedStateHandle فقط برای یک ViewModel که به آن نیاز دارد استفاده می کنیم. ( IA6654 ، b/188541057 )

Custom CreationExtras را می توان با غلبه بر getDefaultViewModelCreationExtras() در ComponentActivity یا Fragment خود ارائه داد ، بنابراین آنها را در دسترس ViewModelProvider.Factory قرار می دهد. Fective به عنوان ساخته شده در قالب تزریق کمک شده. این موارد اضافی به طور خودکار در هنگام استفاده مستقیم با ViewModelProvider یا هنگام استفاده by viewModels() و by activityViewModels() پسوندهای خاصیت Kotlin در دسترس کارخانه سفارشی شما قرار می گیرند. ( 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 شامل این تعهدات است.

رفع اشکال

  • پشتوانه از چرخه عمر 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 در کوتلین بازنویسی شده است. ViewModelProvider.Factory.create Method دیگر اجازه نمی دهد که Generic قابل تهی باشد.
  • API جدید Coroutines به androidx.lifecycle:lifecycle-runtime-ktx :
  • Lifecycle.repeatOnLifecycle ، API که وقتی چرخه عمر حداقل در یک حالت خاص قرار دارد ، یک کد کد را در یک Coroutine اجرا می کند. با حرکت چرخه عمر در داخل و خارج از حالت هدف ، این بلوک لغو و دوباره راه اندازی می شود.
  • Flow.flowWithLifecycle ، API که مقادیر جریان بالادست را هنگام استفاده از چرخه عمر حداقل در یک حالت خاص منتشر می کند.
  • DefaultLifecycleObserver از lifecycle.lifecycle-common-java8 به lifecycle.lifecycle-common . lifecycle.lifecycle-common lifecycle.lifecycle-common-java8 هیچ گونه عملکرد دیگری را در بالای lifecycle.lifecycle-common ارائه نمی دهد.
  • API غیر Coroutines از 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 بدون تغییر در چرخه حیات 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 جایگزین کرد. ( i021aa )
  • API غیر Coroutines از lifecycle-viewmodel-ktx به ماژول lifecycle-viewmodel منتقل شده است. ( i6d5b2 )

سهم خارجی

نسخه 2.4.0-alpha03

4 آگوست 2021

androidx.lifecycle:lifecycle-*:2.4.0-alpha03 منتشر می شود. نسخه 2.4.0-alpha03 شامل این تعهدات است.

API تغییر می کند

  • تغییر منبع : ViewModelProvider در کوتلین بازنویسی شده است. ViewModelProvider.Factory.create Method دیگر اجازه نمی دهد که Generic قابل تهی باشد. ( 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 شامل این تعهدات است.

ویژگی های جدید

  • یک بررسی جدید RepeatOnLifecycleWrongUsage را به lifecycle-runtime-ktx اضافه کرد که تشخیص می دهد وقتی repeateOnLifecycle شود به طور نادرست در onStart() یا onResume() استفاده می شود. ( 706078 ، b/187887400 )

API تغییر می کند

  • API LifecycleOwner.addRepeatingJob به نفع Lifecycle.repeatOnLifecycle که به همزمانی ساختاری احترام می گذارد و استدلال در مورد آن آسان تر است. ( i4a3a8 )
  • ProcessLifecycleInitializer عمومی کنید تا سایر androidx.startup.Initializer S بتوانند از اینها به عنوان وابستگی استفاده کنند. ( 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 اضافه شده است که مقادیر از جریان بالادست را منتشر می کند وقتی که چرخه حیات حداقل در یک حالت خاص با استفاده از Lifecycle.repeatOnLifecycle باشد. API Repeatonlifecycle. این یک گزینه جایگزین برای API جدید LifecycleOwner.addRepeatinJob است. ( i0f4cd )

رفع اشکال

  • از چرخه عمر 2.3.1 : قانون Lint NonNullableMutableLiveData اکنون می تواند به درستی بین متغیرهای میدانی با قابلیت تهی متفاوت متفاوت باشد. ( b/169249668 )

ViewModel ViewModel نسخه 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 شامل این تعهدات است.

به روز شده تا با آهنگسازی نسخه 1.0.0-beta08 سازگار باشد.

نسخه 1.0.0-alpha05

18 مه 2021

androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha05 منتشر می شود. نسخه 1.0.0-alpha05 شامل این تعهدات است.

ویژگی های جدید

  • به روز شده برای سازگار با نسخه نسخه 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 شامل این تعهدات است.

تغییر وابستگی

  • این نسخه به androidx.hilt:hilt-navigation-compose و androidx.navigation:navigation-compose با همگام سازی وابستگی به 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 قابل تهی را برمی گرداند تا بهتر تعیین کند که آیا یک ViewModelStoreOwner در ترکیب فعلی موجود است یا خیر. API هایی که به ViewModelStoreOwner نیاز دارند ، مانند viewModel() و NavHost ، اگر یک ViewModelStoreOwner تنظیم نشده باشد ، هنوز یک استثنا را پرتاب می کنند. ( IDF39a )

نسخه حیات-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 استفاده شود و API asProvidableCompositionLocal() جایگزین می کند. ( i45d24 )

نسخه حیات-ViewModel-Compose نسخه 1.0.0-alpha01

10 فوریه 2021

androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha01 منتشر می شود. نسخه 1.0.0-alpha01 شامل این تعهدات است.

ویژگی های جدید

  • viewModel() Composable و LocalViewModelStoreOwner از androidx.compose.ui.viewinterop به این مصنوعی در بسته androidx.lifecycle.viewmodel.compose منتقل شدند. ( i7a374 )

نسخه 2.3.1

نسخه چرخه عمر 2.3.1

24 مارس 2021

androidx.lifecycle:lifecycle-*:2.3.1 منتشر می شود. نسخه 2.3.1 شامل این تعهدات است.

رفع اشکال

  • قانون LINT NonNullableMutableLiveData اکنون می تواند به درستی بین متغیرهای میدانی با باطل بودن متفاوت تفاوت قائل شود. ( b/169249668 )

نسخه 2.3.0

نسخه 2.3.0

10 فوریه 2021

androidx.lifecycle:lifecycle-*:2.3.0 منتشر می شود. نسخه 2.3.0 شامل این تعهدات است.

تغییرات اساسی از 2.2.0

  • پشتیبانی SavedStateHandle برای کلاسهای غیر قابل قبول : SavedStateHandle اکنون با اجازه دادن به setSavedStateProvider() برای یک کلید خاص ، از سریال سازی تنبل پشتیبانی می کند ، ارائه یک SavedStateProvider که در صورت درخواست از SavedStateHandle ، برای نجات وضعیت خود saveState() دریافت می کند. به صرفه جویی در کلاسهای غیر parcelable مراجعه کنید.
  • اجرای رفتار چرخه عمر :
    • زندگی در حال حاضر به عنوان یک کشور ترمینال DESTROYED شده است.
    • LifecycleRegistry اکنون تأیید می کند که روش های آن در موضوع اصلی خوانده می شود. این همیشه الزامی برای حیات فعالیت ها ، قطعات و غیره بود. علاوه بر این از ناظران از موضوعات غیر اصلی منجر به تصادف در زمان اجرا شد. برای اشیاء LifecycleRegistry که متعلق به مؤلفه های شخصی شما هستند ، می توانید صریحاً با استفاده از LifecycleRegistry.createUnsafe(...) از چک ها خودداری کنید ، اما پس از آن باید اطمینان حاصل کنید که هماهنگ سازی مناسب در صورت دسترسی این LifecycleRegistry از موضوعات مختلف وجود دارد.
  • یاران حالت چرخه عمر : روشهای یاور استاتیک اضافه شده از downFrom(State) ، State downTo(State) ، upFrom(State) Event upTo(State) به Lifecycle.Event . روش getTargetState() را اضافه کرد که به این State ارائه می دهد که چرخه عمر به طور مستقیم به دنبال این Event منتقل می شود.
  • withStateAtLeast : API های Lifecycle.withStateAtLeast که در انتظار حالت چرخه عمر هستند و یک بلوک غیر تعلیق کد را همزمان در نقطه تغییر حالت اجرا می کنند ، سپس با نتیجه از سر می گیرند. این API ها با روش when* موجود در صورت عدم امکان اجرای کد تعلیق و استفاده از توزیع کننده سفارشی متفاوت هستند. ( AOSP/1326081 )
  • ViewTree APIS : یک ViewTreeLifecycleOwner.get(View) و ViewTreeViewModelStoreOwner.get(View) API به شما امکان می دهد به ترتیب با توجه به نمونه ای View ، دارای LifecycleOwner حاوی و ViewModelStoreOwner را بازیابی کنید. شما باید به فعالیت 1.2.0 و قطعه 1.3.0 و APPCOMPAT 1.3.0-alpha01 یا بالاتر ارتقا دهید تا این موضوع را به درستی جمع کنید. پسوندهای findViewTreeLifecycleOwner و findViewTreeViewModelStoreOwner Kotlin به ترتیب در lifecycle-runtime-ktx و lifecycle-viewmodel-ktx در دسترس هستند.
  • LiveData.observe() استهلاک Kotlin : The LiveData.observe() پسوند Kotlin لازم برای استفاده از نحو 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 تغییر می کند

  • پسوند Kotlin LiveData.observe() لازم برای استفاده از نحو Lambda اکنون کاهش یافته است زیرا هنگام استفاده از Kotlin 1.4 لازم نیست. ( i40d3f )

رفع اشکال

تغییر مستندات

  • اسناد liveData Builder و 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 )

تغییرات رفتار

  • زندگی در حال حاضر به عنوان یک کشور ترمینال DESTROYED شده است. ( i00887 )
  • LifecycleRegistry اکنون تأیید می کند که روش های آن در موضوع اصلی خوانده می شود. این همیشه الزامی برای حیات فعالیت ها ، قطعات و غیره بود. علاوه بر این از ناظران از موضوعات غیر اصلی منجر به تصادف در زمان اجرا شد. برای اشیاء LifecycleRegistry که متعلق به مؤلفه های شخصی شما هستند ، می توانید با استفاده از LifecycleRegistry.createUnsafe(...) از چک ها خودداری کنید ، اما پس از آن باید اطمینان حاصل کنید که یک هماهنگ سازی مناسب در صورت دسترسی به این LifecycleRegistry از موضوعات مختلف وجود دارد ( IE7280 ، b/137392809 )

رفع اشکال

  • تصادف در NullSafeMutableLiveData را برطرف کرد. ( b/159987480 )
  • یک ObsoleteLintCustomCheck را برای چک های خط بسته بندی شده با 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 اکنون بهتر است موارد retentrant را کنترل کند و از تماس های تکراری به onActive() یا onInactive() جلوگیری کند. ( b/157840298 )
  • مشکلی را برطرف کرد که در هنگام استفاده از Android Studio 4.1 Canary 6 یا بالاتر ، چک های LINT اجرا نمی شود. ( AOSP/1331903 )

نسخه 2.3.0-alpha04

10 ژوئن 2020

androidx.lifecycle:lifecycle-*:2.3.0-alpha04 منتشر می شود. نسخه 2.3.0-alpha04 شامل این تعهدات است.

رفع اشکال

  • تصادف را در بررسی NonNullableMutableLiveData بررسی کرد. ( b/157294666 )
  • بررسی LINT NonNullableMutableLiveData ، موارد قابل توجهی بیشتر را در بر می گیرد که مقدار null در یک MutableLiveData با یک پارامتر از نوع غیر تهی تنظیم شده است. ( b/156002218 )

نسخه 2.3.0-alpha03

20 مه 2020

androidx.lifecycle:lifecycle-*:2.3.0-alpha03 منتشر می شود. نسخه 2.3.0-alpha03 شامل این تعهدات است.

ویژگی های جدید

  • SavedStateHandle اکنون با اجازه دادن به setSavedStateProvider() برای یک کلید معین ، از سریال سازی تنبل پشتیبانی می کند ، و یک SavedStateProvider را فراهم می کند که هنگام تماس با SavedStateHandle از شما خواسته saveState() شود تا وضعیت خود را نجات دهد. ( b/155106862 )
  • API جدید ViewTreeViewModelStoreOwner.get(View) به شما امکان می دهد با توجه به نمونه View ، ViewModelStoreOwner را بازیابی کنید. شما باید به فعالیت 1.2.0-alpha05 ، قطعه 1.3.0-alpha05 و AppCompat 1.3.0-alpha01 ارتقا دهید تا این موضوع را به درستی جمع کنید. یک پسوند Kotlin findViewModelStoreOwner() به lifecycle-viewmodel-ktx اضافه شده است. ( AOSP/1295522 )

رفع اشکال

  • مسئله ای را که باعث شد چک های LINT MutableLiveData که در چرخه عمر 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 تهی را به سازنده خود منتقل کنید تا مواردی را که در آن به راحتی در دسترس نیست پشتیبانی کنید و پشتیبانی از AndroidViewModel مورد نیاز نیست. ( AOSP/1285740 )

رفع اشکال

  • با جلوگیری از خرابی تأیید کلاس در دستگاه های API 28 و پایین ، عملکرد شروع سرما را بهبود بخشید. ( AOSP/1282118 )

نسخه 2.3.0-alpha01

4 مارس 2020

androidx.lifecycle:lifecycle-*:2.3.0-alpha01 منتشر می شود. نسخه 2.3.0-alpha01 شامل این تعهدات است.

ویژگی های جدید

  • API جدید ViewTreeLifecycleOwner.get(View) به شما امکان می دهد با توجه به نمونه ای View LifecycleOwner موجود را بازیابی کنید. شما باید به فعالیت 1.2.0-alpha01 و قطعه 1.3.0-alpha01 ارتقا دهید تا این موضوع را به درستی جمع کنید. پسوند Kotlin findViewTreeLifecycleOwner در lifecycle-runtime-ktx در دسترس است. ( AOSP/1182361 ، AOSP/1182956 )
  • یک بررسی جدید اضافه کرد که هنگام تنظیم مقدار null در یک MutableLiveData که در کوتلین به عنوان غیر تهی تعریف شده است ، به شما هشدار می دهد. این در هنگام استفاده از آثار باستانی livedata-core-ktx یا livedata-ktx در دسترس است. ( AOSP/1154723 ، AOSP/1159092 )
  • یک مصنوعات جدید lifecycle-runtime-testing در دسترس است که یک TestLifecycleOwner را فراهم می کند که دارای LifecycleOwner است و یک Lifecycle قابل تغییر را در اختیار شما قرار می دهد. ( AOSP/1242438 )

رفع اشکال

  • Artifact 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 شامل این تعهدات است .

ViewModel SaveDstate اکنون نسخه مشابه سایر مصنوعات چرخه عمر را به اشتراک می گذارد. رفتار 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 ادغام بین چرخه عمر و کورتلین را می افزاید. برای استفاده از Coroutines نیز lifecycle-livedata-ktx استفاده شده است. برای اطلاعات بیشتر به استفاده از Coroutines Kotlin با اجزای معماری مراجعه کنید.
  • ViewModelProviders.of() استهلاک : ViewModelProviders.of() کاهش یافته است. شما می توانید یک Fragment یا قطعه قطعه قطعه قطعه قطعه قطعه قطعه قطعه قطعه قطعه قطعه قطعه قطعه قطعه قطعه قطعه قطعه قطعه قطعه قطعه ViewModelProvider(ViewModelStoreOwner) را می توانید یک قطعه یا FragmentActivity کنید تا هنگام استفاده از قطعه 1.2.0 به همان عملکرد دست یابید.
  • استهلاک آثار lifecycle-extensions : با استهلاک فوق از ViewModelProviders.of() ، این نسخه استهلاک آخرین API در lifecycle-extensions را نشان می دهد و این مصنوعات اکنون باید به طور کامل در نظر گرفته شود. ما به شدت توصیه می کنیم بسته به مصنوعات خاص چرخه عمر مورد نیاز شما (مانند lifecycle-service در صورت استفاده از LifecycleService و lifecycle-process در صورت استفاده از ProcessLifecycleOwner ) به جای اینکه lifecycle-extensions وجود داشته باشد ، زیرا نسخه آینده 2.3.0 وجود نخواهد داشت. از lifecycle-extensions .
  • Gradle Incremental Annotation Processor : Lifecycle's annotation processor is incremental by default. If your app is written in the Java 8 programming language you can use DefautLifecycleObserver instead; and if it's written in the Java 7 programming language you can use LifecycleEventObserver .

Version 2.2.0-rc03

4 دسامبر 2019

androidx.lifecycle:lifecycle-*:2.2.0-rc03 is released. Version 2.2.0-rc03 contains these commits .

رفع اشکال

  • Fixed a failure occurring when a mocked ViewModel was stored in ViewModelStore and queried later with default factory.
  • Fix a usage of Dispatchers.Main.immediate in launchWhenCreated and similar methods to be called synchronously during corresponding lifecycle event. ( aosp/1156203 )

External contributions

  • Thanks to Anders Järleberg for contributing the fix! ( aosp/1156203 )
  • Thanks to Vsevolod Tolstopyatov from Jetbrains for reviewing an implementation of inlined execution.

Dependency changes

  • Lifecycle Extensions now depends on Fragment 1.2.0-rc03 .

Version 2.2.0-rc02

7 نوامبر 2019

androidx.lifecycle:lifecycle-*:2.2.0-rc02 is released. Version 2.2.0-rc02 contains these commits .

رفع اشکال

  • Fixed a bug in the proguard setup of the library that affected devices running API 28+ if the target API is below 29. ( b/142778206 )

Version 2.2.0-rc01

23 اکتبر 2019

androidx.lifecycle:lifecycle-*:2.2.0-rc01 is released. Version 2.2.0-rc01 contains these commits .

رفع اشکال

  • Fixed an issue where launchWhenCreated and related methods would run one frame later than the associated lifecycle method due to its use of Dispatchers.Main instead of Dispatchers.Main.immediate . ( aosp/1145596 )

External contributions

  • Thanks to Nicklas Ansman for contributing the fix! ( aosp/1145596 )

Version 2.2.0-beta01

9 اکتبر 2019

androidx.lifecycle:lifecycle-*:2.2.0-beta01 is released. Version 2.2.0-beta01 contains these commits .

رفع اشکال

  • Fixed a regression introduced in Lifecycle 2.2.0-alpha05 in the ordering of ProcessLifecycleOwner and the activity's LifecycleOwner moving to started and resumed on Android 10 devices. ( aosp/1128132 )
  • Fixed a regression introduced in Lifecycle 2.2.0-alpha05 which would cause a NullPointerException when using version 2.0.0 or 2.1.0 of lifecycle-process . ( b/141536990 )

Version 2.2.0-alpha05

18 سپتامبر 2019

androidx.lifecycle:lifecycle-*:2.2.0-alpha05 is released. Version 2.2.0-alpha05 contains these commits .

رفع اشکال

  • Fixed a race condition in coroutine livedata builder. b/140249349

Version 2.2.0-alpha04

5 سپتامبر 2019

androidx.lifecycle:lifecycle-*:2.2.0-alpha04 is released. The commits included in this version can be found here .

ویژگی های جدید

  • lifecycleScope , whenCreated , whenStarted , whenResumed , viewModelScope , and the underlying implementation of liveData now use Dispatchers.Main.immediate instead of Dispatchers.Main . ( b/139740492 )

External contributions

  • Thanks to Nicklas Ansman for contributing the move to Dispatchers.Main.immediate ! ( aosp/1106073 )

Version 2.2.0-alpha03

7 آگوست 2019

androidx.lifecycle:lifecycle-*:2.2.0-alpha03 is released. The commits included in this version can be found here .

ویژگی های جدید

API changes

  • ViewModelProviders.of() has been deprecated. You can pass a Fragment or FragmentActivity to the new ViewModelProvider(ViewModelStoreOwner) constructor to achieve the same functionality. ( aosp/1009889 )

Version 2.2.0-alpha02

2 جولای 2019

androidx.lifecycle:*:2.2.0-alpha02 is released. The commits included in this version can be found here .

API changes

  • Replaced LiveDataScope.initialValue with LiveDataScope.latestValue which will track the current emitted value of the liveData block.
  • Added a new overload to the liveData builder that receives timeout parameter as type Duration

Version 2.2.0-alpha01

7 مه 2019

androidx.lifecycle:*:2.2.0-alpha01 is released. The commits included in this version can be found here .

ویژگی های جدید

  • This release adds new features that adds support for Kotlin coroutines for Lifecycle and LiveData. Detailed documentation on them can be found here .

ViewModel-SavedState Version 1.0.0

نسخه 1.0.0

22 ژانویه 2020

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0 is released. Version 1.0.0 contains these commits .

Important features in 1.0.0

  • New SavedStateHandle class was added. It enables your ViewModel classes to access and to contribute to the saved state. This object can be received in constructor of ViewModel class and factories provided by default by Fragments and AppCompatActivity will inject SavedStateHandle automatically.
  • AbstractSavedStateViewModelFactory was added. It allows you to create custom factories for your ViewModel and provide them access to SavedStateHandle .

ViewModel-Savedstate Version 1.0.0-rc03

4 دسامبر 2019

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-rc03 is released. Version 1.0.0-rc03 contains these commits .

Dependency changes

  • Lifecycle ViewModel SavedState now depends on Lifecycle 2.2.0-rc03 .

Viewmodel-Savedstate Version 1.0.0-rc02

7 نوامبر 2019

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-rc02 is released. Version 1.0.0-rc02 contains these commits .

Dependency changes

  • Now depends on lifecycle 2.2.0-rc02 .

ViewModel-SavedState Version 1.0.0-rc01

23 اکتبر 2019

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-rc01 is released with no changes from 1.0.0-beta01 . Version 1.0.0-rc01 contains these commits .

ViewModel-Savedstate Version 1.0.0-beta01

9 اکتبر 2019

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-beta01 is released. Version 1.0.0-beta01 contains these commits .

رفع اشکال

  • Fixed an issue where accessing a SavedState ViewModel for the first time in Activity.onActivityResult() would result in an IllegalStateException . ( b/139093676 )
  • Fixed an IllegalStateException when using AbstractSavedStateViewModelFactory . ( b/141225984 )

ViewModel-SavedState Version 1.0.0-alpha05

18 سپتامبر 2019

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha05 is released. Version 1.0.0-alpha05 contains these commits .

API changes

  • SavedStateViewModelFactory no longer extends AbstractSavedStateViewModelFactory and SavedStateHandle is created only for ViewModels that requested have it ( aosp/1113593 )

ViewModel-SavedState Version 1.0.0-alpha03

7 آگوست 2019

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha03 is released. The commits included in this version can be found here .

Breaking Changes

ViewModel-SavedState Version 1.0.0-alpha02

2 جولای 2019

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha02 is released. The commits included in this version can be found here .

ویژگی های جدید

  • Added SavedStateHandle.getLiveData() overload which accepts a default value.

API Changes

  • SavedStateVMFactory is renamed to SavedStateViewModelFactory .
  • AbstractSavedStateVMFactory is renamed to AbstractSavedStateViewModelFactory .

ViewModel-Savedstate Version 1.0.0-alpha01

13 مارس 2019

androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha01 is released. The full commit log for this initial release can be found here .

ویژگی های جدید

  • Now ViewModels can contribute to savedstate. To do that you use newly introduced viewmodel's factory SavedStateVMFactory and your ViewModel should have a constructor that receives SavedStateHandle object as a parameter.

نسخه 2.1.0

Important changes since 2.0.0

  • Added LifecycleEventObserver for the cases when a stream of lifecycle events is needed. It is a public API instead of a hidden GenericLifecycleObserver class.
  • Added ktx extensions for LiveData.observe methods and Transformations.* methods.
  • Added Transformations.distinctUntilChanged , which creates a new LiveData object that does not emit a value until the source LiveData value has been changed.
  • Added coroutine support in ViewModels by adding the extension property ViewModel.viewModelScope .

نسخه 2.1.0

5 سپتامبر 2019

androidx.lifecycle:lifecycle-*:2.1.0 is released. The commits included in this version can be found here .

Version 2.1.0-rc01

2 جولای 2019

androidx.lifecycle:*:2.1.0-rc01 is released with no changes from androidx.lifecycle:*:2.1.0-beta01 . The commits included in this version can be found here .

Version 2.1.0-beta01

7 مه 2019

androidx.lifecycle:*:2.1.0-beta01 is released. The commits included in this version can be found here .

ویژگی های جدید

  • Lifecycles are graduated to beta: api introduced in previous alphas such as liveData extension functions for transformations and observations, ViewModel initialisation with property delegation and others are stabilised and not going to change.

Version 2.1.0-alpha04

3 آوریل 2019

androidx.lifecycle:*:2.1.0-alpha04 is released. The commits included in this version can be found here .

API changes

  • Breaking change: the underlying API behind by viewModels() and by activityViewModels() has been changed to support a ViewModelStore directly, rather than only a ViewModelStoreOwner . ( aosp/932932 )

Version 2.1.0-alpha03

13 مارس 2019

androidx.lifecycle:*:2.1.0-alpha03 is released. The full list of commits included in this version can be found here .

API changes

  • ViewModelProvider.KeyedFactory was removed. Second interface in addition to ViewModelProvider.Factory didn't compose well with new features as property delegation in Kotlin by viewmodels {} . ( aosp/914133 )

Version 2.1.0-alpha02

30 ژانویه 2019

androidx.lifecycle 2.1.0-alpha02 is released.

API changes

  • LifecycleRegistry now contains a setCurrentState() method that replaces the now deprecated setState() method. ( aosp/880715 )

رفع اشکال

  • Fixed an issue where mock ViewModel instances would crash when the containing ViewModelStore was cleared. b/122273087

نسخه 2.1.0-alpha01

17 دسامبر 2018

androidx.lifecycle 2.1.0-alpha01 is released.

ویژگی های جدید

  • Added LifecycleEventObserver for the cases when a stream of lifecycle events is needed. It is a public api instead of a hidden GenericLifecycleObserver class.
  • Added ktx extensions for LiveData.observe methods and Transformations.* methods.
  • Method Transformations.distinctUntilChanged was added. It creates a new LiveData object that does not emit a value until the source LiveData value has been changed.
  • Coroutine support in ViewModels: extension property ViewModel.viewModelScope was added.
  • Added ViewModelProvider.KeyedFactory , a factory for ViewModels that receives key and Class in create method.

نسخه 2.0.0

نسخه 2.0.0

21 سپتامبر 2018

Lifecycle 2.0.0 is released with one bugfix from 2.0.0-rc01 in ViewModel.

Bug Fixes

  • Fixed a ViewModel proguard rule that incorrectly removed constructors b/112230489

Version 2.0.0-beta01

2 جولای 2018

Bug Fixes

  • Fixed LifecycleObserver proguard rule to keep only implementations, not subinterfaces b/71389427
  • Fixed ViewModel proguard rules to allow obfuscation and shrinking

Pre-AndroidX Versions

For the pre-AndroidX versions of Lifecycle that follow, include these dependencies:

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"
}

Version 1.1.1

March 21, 2018

Only one small change: android.arch.core.util.Function is moved from arch:runtime to arch:common . This allows it to be used without the runtime dependency, eg in paging:common below.

lifecycle:common is a dependency of lifecycle:runtime , so this change doesn't affect lifecycle:runtime directly, only modules that depend directly on lifecycle:common , as Paging does.

Version 1.1.0

22 ژانویه 2018

Packaging Changes

New, much smaller dependencies are now available:

  • android.arch.lifecycle:livedata:1.1.0
  • android.arch.lifecycle:viewmodel:1.1.0

API Changes

  • The deprecated LifecycleActivity and LifecycleFragment have now been removed - please use FragmentActivity , AppCompatActivity or support Fragment .
  • @NonNull annotations have been added to ViewModelProviders and ViewModelStores
  • ViewModelProviders constructor has been deprecated - please use its static methods directly
  • ViewModelProviders.DefaultFactory has been deprecated - please use ViewModelProvider.AndroidViewModelFactory
  • The static ViewModelProvider.AndroidViewModelFactory.getInstance(Application) method has been added to retrieve a static Factory suitable for creating ViewModel and AndroidViewModel instances.