Жизненный цикл

Компоненты, учитывающие жизненный цикл, выполняют действия в ответ на изменение статуса жизненного цикла другого компонента, например действий и фрагментов. Эти компоненты помогают создавать более организованный и часто более легкий код, который проще поддерживать.

В этой таблице перечислены все артефакты в группе androidx.lifecycle.

Объект Основная версия Релиз-кандидат Бета-версия Альфа-версия
lifecycle-* 2.11.1 - - 2.12.0-alpha06
lifecycle-viewmodel-navigation3 2.11.1 - - 2.12.0-alpha06
Последнее обновление библиотеки: 18 ноября 2026 г.

Объявление зависимостей

Чтобы добавить зависимость от Lifecycle, необходимо добавить в проект репозиторий Google Maven. Подробную информацию можно найти в статье Репозиторий Google Maven.

Добавьте зависимости для нужных артефактов в файл build.gradle приложения или модуля:

Котлин

Классный

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

Котлин

    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

Классный

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

Котлин

    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. Если вы обнаружите новые проблемы или у вас появятся идеи по улучшению этой библиотеки, сообщите нам. Прежде чем сообщать о новых ошибках, изучите уже добавленные. Чтобы проголосовать за существующую проблему, нажмите на значок звездочки.

Как создать выпуск

Дополнительную информацию можно найти в документации по системе отслеживания ошибок.

Версия 2.12

Версия 2.12.0-alpha06

18 ноября 2026 г.

Данные "androidx.lifecycle:lifecycle-*:2.12.0-alpha06" опубликованы. Версия 2.12.0-alpha06 содержит эти коммиты.

Изменения в API

  • Перенесите LocalLifecycleOwner, чтобы использовать compositionLocalWithHostDefaultOf и LifecycleOwnerHostDefaultKey, отделив его от прямого извлечения в составе дерева представлений за пределами Android. (I7c265)

Исправление ошибок

  • Начиная с версии Lifecycle 2.11.1 свойство currentStateFlow класса LifecycleRegistry возвращает один и тот же экземпляр при каждом вызове, а не создает новый. (I1ae01, b/579057749)

Версия 2.12.0-alpha05

21 октября 2026 г.

Данные "androidx.lifecycle:lifecycle-*:2.12.0-alpha05" опубликованы. Версия 2.12.0-alpha05 содержит эти коммиты.

Изменения в API

  • В SavedStateHandle теперь есть функции для интеграции с SavedStateContainer. asContainer() преобразует SavedStateHandle в SavedStateContainer, getOrCreateContainer() создает дочерний контейнер внутри дескриптора, а getOrCreateSavedStateHandle() создает дочерний SavedStateHandle внутри текущего. В рамках перехода на SavedStateContainer больше нельзя использовать getStateFlow и getLiveData вместе в SavedStateHandle. Если вы попытаетесь это сделать, появится ошибка IllegalArgumentException (I62f36).

Версия 2.12.0-alpha04

23 сентября 2026 г.

Данные "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 августа 2026 г.

Данные "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 ноября 2026 г.

Данные "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

Ограниченные ViewModels в Compose. Представлены ViewModelStoreProvider, rememberViewModelStoreProvider и rememberViewModelStoreOwner для привязки ViewModels к определенным областям интерфейса (например, страницам Pager). Они сохраняются при изменении конфигурации и автоматически очищаются, когда Composable-функция удаляется из иерархии.

Поддержка KMP. ViewModel-Compose и ViewModel-Navigation3 теперь поддерживают все целевые платформы Kotlin Multiplatform.

Интеграция Navigation3. ViewModelStoreNavEntryDecorator теперь принимает ViewModelStoreOwner для распространения CreationExtras и фабрик на вложенные ViewModel. Вы также можете использовать новую перегрузку rememberViewModelStoreNavEntryDecorator, чтобы поддерживать несколько обратных стеков. removeViewModelStoreOnPop больше не поддерживается.

Lifecycle Utilities. Добавлено расширение ViewModelProvider.get<VM>(key), расширение Lifecycle.addObserver на основе лямбда-выражений и расширения фабрики по умолчанию для ViewModelStoreOwner. ViewModel.onCleared теперь аннотируется с помощью @EmptySuper.

Другие изменения. Теперь для LocalLifecycleOwner требуется Compose UI 1.7.0+, чтобы удалить резервные варианты отражения. Для обновления 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 содержит эти коммиты.

Изменения в API

  • Добавьте перегрузку rememberViewModelStoreNavEntryDecorator, которая принимает ViewModelStoreProvider. Это позволяет разработчикам поднимать поставщика над областью композиции декоратора, что дает возможность поддерживать несколько обратных стеков, в которых существует одна и та же запись, но требуется отдельное состояние. (Ibbbfe, b/503420425)
  • Предотвратите преждевременную очистку общего ViewModels, когда дочерний поставщик удаляется из композиции. (Ib321a)

Исправление ошибок

  • Для использования LocalLifecycleOwner требуется Compose UI 1.7.0 или более поздней версии. Это удаляет резервные варианты внутренней рефлексии, повышая производительность, но принудительно обновляя строгие зависимости для клиентов. (I48e65)
  • Предотвратите дублирование символов в старых версиях форка 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. Это означает, что при использовании Compose требуется минимальная версия AGP 9.2.0. (Id45cd, b/413674743)

Версия 2.11.0-alpha03

25 марта 2026 г.

Данные "androidx.lifecycle:lifecycle-*:2.11.0-alpha03" опубликованы. Версия 2.11.0-alpha03 содержит эти коммиты.

Изменения в API

  • Сделайте parentKey необязательным параметром в конструкторах ViewModelStoreProvider, по умолчанию задав значение null, и переместите его после parentStore или parentOwner. Это упрощает создание экземпляра, когда ключ общей области не нужен. (I66b67)
  • ViewModelStoreNavEntryDecorator теперь принимает ViewModelStoreOwner вместо ViewModelStore. Это позволяет Navigation3 распространять родительские значения CreationExtras и ViewModelProvider.Factory по умолчанию на вложенные ViewModel, обеспечивая поддержку зависимостей на уровне приложения. (Ia6018, b/434651920)
  • Изолируйте состояние ViewModelStoreProvider с помощью уникального ключа. Это предотвращает случайную очистку ViewModel друг друга во время удаления. (I59c0b, b/434651920)
  • Добавить функцию расширения ViewModelProvider.get<VM>(key: String). Это позволяет разработчикам более эффективно получать ViewModels, используя пользовательский key с материализованными параметрами типа Kotlin, устраняя необходимость явной передачи типа класса. (Ic1f59)
  • Добавлена поддержка defaultArgs для ViewModelStoreProvider, чтобы можно было инициализировать ViewModels со значениями SavedState по умолчанию. (I1e933, b/434651920, b/165642391)
  • Прекратить поддержку removeViewModelStoreOnPop и связанного с ним ViewModelStoreNavEntryDecoratorDefaults. Этот API был временным решением для изменений конфигурации, которые теперь обрабатываются внутри системы. Все состояния декоратора, включая ViewModel, теперь должны очищаться одновременно при извлечении. Чтобы сохранить состояние декоратора за пределами момента, когда обратный стек передается в NavDisplay, используйте API rememberDecoratedNavEntries. (I852d9)

Исправление ошибок

  • Добавьте toString() в CreationExtras.Key, чтобы показывать название курса. (I5de52)

Версия 2.11.0-alpha02

11 марта 2026 г.

Данные "androidx.lifecycle:lifecycle-*:2.11.0-alpha02" опубликованы. Версия 2.11.0-alpha02 содержит эти коммиты.

Scoped ViewModels

  • В этом выпуске представлены API для создания экземпляров ViewModelStore с ограниченной областью действия в Compose. Это позволяет связать ViewModels с определенными областями интерфейса (например, отдельными страницами 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 и может использоваться с действиями, фрагментами и/или представлениями.

Новые функции

  • Добавьте поддержку всех целей KMP в ViewModel Navigation3. (I60fa5)
  • Добавьте фабричные функции для LifecycleOwner, ViewModelStoreOwner и SavedStateRegistryOwner, чтобы сократить шаблонный код при создании пользовательских компонентов владельца. (I9682c)
  • Добавьте функцию расширения Lifecycle.addObserver на основе лямбда-выражения, чтобы отслеживать события жизненного цикла без создания экземпляра анонимного объекта. (I94f38)
  • Добавьте расширения defaultViewModelProviderFactory и defaultViewModelCreationExtras в кампанию ViewModelStoreOwner. Они обеспечивают безопасный доступ к значениям по умолчанию без необходимости вручную проверять типы в HasDefaultViewModelProviderFactory. (Ifa83d)

Изменения в API

  • Добавьте rememberViewModelStoreOwner, чтобы легко создавать ограниченные ViewModelStoreOwner в Compose. Эта функция возвращает владельца, связанного с жизненным циклом composable-функции, и автоматически очищает ее ViewModel, когда composable-функция удаляется из интерфейса. (I2a15b, b/165642391)
  • Добавьте rememberViewModelStoreProvider, чтобы разрешить создание экземпляров ViewModelStore с ограниченной областью действия в Compose. Эта функция связывает дочернее хранилище с родительским владельцем, обеспечивая сохранение ViewModel при изменении конфигурации и автоматическую очистку при удалении Composable из иерархии. (I0f57a, b/165642391)
  • Добавьте ViewModelStoreProvider, чтобы управлять экземплярами ViewModelStore в области видимости. Этот класс позволяет создавать дочерние области, которые сохраняются при изменении конфигурации, но могут быть очищены независимо. Он также предоставляет оболочки 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 содержит эти коммиты.

Важные изменения, внесенные в версию 2.9.0

  • Добавьте composable-функцию rememberLifecycleOwner, чтобы создавать жизненные циклы с ограниченной областью действия прямо в интерфейсе. Это полезно для компонентов, которым необходимо самостоятельно управлять своими жизненными циклами, например для 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
            }
        }
    }
    
  • Добавлена функция фабрики построителя для 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.

  • Минимальная версия SDK изменена с 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, чтобы было понятно, что этот обратный вызов выполняется, только когда запись извлекается из backStack. (Iefdc5, b/444447434)

Версия 2.10.0-alpha04

24 сентября 2025 г.

Данные "androidx.lifecycle:lifecycle-*:2.10.0-alpha04" опубликованы. Версия 2.10.0-alpha04 содержит эти коммиты.

Изменения в API

  • Проведите рефакторинг composable-функции LifecycleOwner в rememberLifecycleOwner. Теперь функция возвращает LifecycleOwner напрямую. Чтобы предоставить этого владельца подкомпозиции, используйте CompositionLocalProvider. (Ic57f0, b/444446629)
  • Добавьте заглушки KMP в lifecycle-viewmodel-navigation3, чтобы JetBrains могла предоставлять форки, которые заполняют эти цели и, таким образом, поддерживают 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 содержит эти коммиты.

Новые функции

  • Теперь composable-функция LifecycleOwner может создавать автономный корневой жизненный цикл. Если явно задать parent = null, новый жизненный цикл будет работать независимо от хоста (например, Activity, Fragment или NavBackStackEntry). Он начинается, как только composable-функция входит в композицию, и автоматически уничтожается, когда она выходит из нее. (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

  • В composable-функции LifecycleOwner параметр parentLifecycleOwner переименован в parent. (I080bc)

Исправление ошибок

  • Теперь composable-функция LifecycleOwner корректно переводит свой жизненный цикл в состояние 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 содержит эти коммиты.

Новые функции

  • Добавьте composable-функцию LifecycleOwner, чтобы создавать жизненные циклы с ограниченной областью действия прямо в интерфейсе. Это полезно для компонентов, которым необходимо самостоятельно управлять своими жизненными циклами. Пример интеграции этой новой composable-функции в Navigation3 можно найти на странице aosp/3708610. (76cbf7)

    @Composable
    fun MyComposable() {
        LifecycleOwner(
            maxLifecycle = RESUMED,
            parentLifecycleOwner = LocalLifecycleOwner.current,
        ) {
            val childLifecycleOwner = LocalLifecycleOwner.current
        }
    }
    

Изменения в API

  • Добавлена функция фабрики построителя для 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 Compiler, что приводило к сбою артефактов Lifecycle KMP. (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 и Desktop), Native (Linux, iOS, watchOS, macOS, MinGW) и Web (JavaScript, WasmJS). (I0a0e4)

Исправление ошибок

  • Обновление androidx.annotation до версии 1.9.1 (Ic9e4f, b/397701294)

Версия 2.9.2

16 июля 2025 г.

Данные "androidx.lifecycle:lifecycle-*:2.9.2" опубликованы. Версия 2.9.2 содержит эти коммиты.

Исправление ошибок

  • В артефакты Lifecycle добавлены новые целевые платформы Kotlin Multiplatform (KMP). Теперь Lifecycle поддерживает следующие платформы: JVM (Android и Desktop), Native (Linux, iOS, watchOS, macOS, MinGW) и Web (JavaScript, WasmJS). Обратите внимание, что в артефакты *-compose не были добавлены новые цели KMP, поскольку это зависит от стабильного выпуска Compose 1.9. (I01cb8).

Обновление зависимостей

Версия 2.9.1

4 июня 2025 г.

Данные "androidx.lifecycle:lifecycle-*:2.9.1" опубликованы. Версия 2.9.1 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой SavedStateHandle.remove(key) не очищал состояния SavedStateHandle.getMutableStateFlow(key). d5f939, b/418746333

Версия 2.9.0

7 мая 2025 г.

Данные "androidx.lifecycle:lifecycle-*:2.9.0" опубликованы. Версия 2.9.0 содержит эти коммиты.

Важные изменения, начиная с версии 2.8.0

  • Доступен новый артефакт KMP androidx.lifecycle:lifecycle-viewmodel-testing, который предоставляет класс ViewModelScenario для изолированного тестирования ViewModels с поддержкой onCleared и SavedStateHandle, а также для тестирования завершения и возобновления процесса с помощью recreate().
  • Добавьте getMutableStateFlow к SavedStateHandle, чтобы вернуть MutableStateFlow. Эта новая функция предназначена только для ключей и не может использоваться с getLiveData. Если вы попытаетесь использовать оба способа для доступа к одному и тому же состоянию, возникнет исключение.
  • В CreationExtras теперь есть перегрузки операторов, похожие на карты, которые позволяют манипулировать контентом в Kotlin. Она позволяет использовать in, += и + с CreationExtras.

Поддержка сериализации KotlinX

  • Благодаря поддержке KotlinX Serialization, добавленной в SavedState 1.3.0, мы представили делегат ленивого свойства saved, который упрощает хранение классов @Serializable в SavedStateHandle и их автоматическое восстановление после завершения и повторного создания процесса. Обратите внимание, что делегат saved является ленивым и не будет вызывать лямбду 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 содержит эти коммиты.

Предупреждение о совместимости API от Lint

  • Компания 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)

Обновления зависимостей

  • Теперь эта библиотека предназначена для 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, чтобы изменения в состоянии жизненного цикла правильно вызывали рекомпозицию. Спасибо, Стивен Шен! (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, что приводит к ненужным накладным расходам. Чтобы эффективнее создавать ViewModel, используйте ViewModelProvider.Factory с CreationExtras.createSavedStateHandle. (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. Дополнительную информацию о родительских элементах с непересекающимися представлениями можно найти в примечаниях к выпуску ядра или в документации по ViewTree.setViewTreeDisjointParent. (I800f4)

Изменения в API

  • Названия и структура пакетов стали более согласованными с SavedStateRegistryOwnerDelegate (I8c135, b/376026744).

Исправление ошибок

  • Теперь в этой библиотеке используются аннотации JSpecify nullness, которые относятся к типу type-use. Разработчикам, использующим 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, который упрощает хранение классов @Serializable в SavedStateHandle и их автоматическое восстановление после завершения и повторного создания процесса. Обратите внимание, что делегат saved является ленивым и не будет вызывать лямбду 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. Если вы попытаетесь использовать оба способа для доступа к одному и тому же состоянию, возникнет исключение. (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 улучшена поддержка умных приведений типов, что позволяет избегать ложных срабатываний. (85fed6, b/181042665)

Обновления зависимостей

Версия 2.9.0-alpha02

4 сентября 2024 г.

Данные "androidx.lifecycle:lifecycle-*:2.9.0-alpha02" опубликованы. Версия 2.9.0-alpha02 содержит эти коммиты.

Исправление ошибок

Внешний вклад

  • Переместить androidx.compose.ui.platform.LocalLifecycleOwner в общий набор исходных файлов (KMP). Благодарим Ивана Маткова из 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 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 версии 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 улучшена поддержка умных приведений, что позволяет избегать ложных срабатываний. (85fed6, b/181042665)

Обновления зависимостей

Версия 2.8.5

4 сентября 2024 г.

Данные "androidx.lifecycle:lifecycle-*:2.8.5" опубликованы. Версия 2.8.5 содержит эти коммиты.

Исправление ошибок

  • Обновите правила ProGuard для androidx.lifecycle.ReportFragment, чтобы разрешить обфускацию . (ff898e1)

Внешний вклад

  • Делегат расширения SavedStateHandle.saveable теперь поддерживает значения, допускающие null. Благодарим Романа Калукевича (Roman Kalukiewicz) за вклад в разработку. (0d78ea6)

Версия 2.8.4

24 июля 2024 г.

Данные "androidx.lifecycle:lifecycle-*:2.8.4" опубликованы. Версия 2.8.4 содержит эти коммиты.

Исправление ошибок

  • LiveData.asFlow() теперь правильно обрабатывает случаи, когда возвращенный поток завершается сразу после получения значения, уже заданного в 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 содержит эти коммиты.

Исправление ошибок

  • Исправлена проблема с обратной совместимостью 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 больше не будет аварийно завершать работу при смешивании предыдущих версий зависимостей жизненного цикла 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)
  • В интеграции ViewModel с saveable с использованием делегатов свойств теперь в качестве части автоматически созданного ключа используется название класса. Это позволяет избежать конфликтов, если несколько классов используют один и тот же SavedStateHandle. (aosp/3063463)

Версия 2.8.0

14 мая 2024 г.

Данные "androidx.lifecycle:lifecycle-*:2.8.0" опубликованы. Версия 2.8.0 содержит эти коммиты.

Важные изменения, внесенные в версию 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

Основные API жизненного цикла в 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 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.
    • Рекомендуется расширять пользовательские фабрики из ViewModelProvider.Factory и использовать метод create, который принимает CreationExtras, или использовать viewModelFactory Kotlin DSL.
  • Использование ViewModelProvider без пользовательской фабрики на платформах, отличных от JVM, приведет к UnsupportedOperationException. На платформах JVM совместимость сохраняется за счет использования конструктора ViewModel без аргументов, если не предоставлена пользовательская фабрика.
  • viewModelScope будет заменено на EmptyCoroutineContext на платформах, где Dispatchers.Main недоступно (например, Linux).

Затронутые объекты:

  • В 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)

Известные проблемы

  • Для 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 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой базовый профиль для классов lifecycle-common упаковывался неправильно. Теперь они упакованы в AAR-файл lifecycle-runtime. (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. Чтобы учесть это изменение, метод Composable viewModel теперь принимает KClass в дополнение к java.lang.Class. (b/330323282)

Исправление ошибок

  • Мы провели рефакторинг NullSafeMutableLiveData, чтобы избежать ложных срабатываний. (I2d8c1, Iafb18, I03463, I7ecef)

Обновление зависимостей

  • Артефакт 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.
    • Рекомендуется расширять пользовательские фабрики из 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

  • Основные 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)

Внешний вклад

  • Благодарим Ивана Матькова из Jetbrains за помощь в переносе Lifecycle в 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(), которая гарантирует, что изменение состояния и все обратные вызовы LifecycleObserver будут завершены до возврата. В отличие от непосредственной настройки свойства currentState, в этом случае не используется runBlocking, поэтому метод можно безопасно применять в сопрограмме, например предоставляемой runTest.
  • Расширения LiveData для map и switchMap теперь работают так же, как и distinctUntilChanged. Если для LiveData задано значение value, функция map/switchMap будет вызвана немедленно, чтобы заполнить value возвращенного LiveData. Это гарантирует, что начальное значение будет задано в рамках первой композиции (при использовании с observeAsState()), но не изменит поведение наблюдения – обновленные значения из источника LiveData по-прежнему будут применяться только после того, как вы начнете наблюдать за LiveData.
  • В этом выпуске исправлена ошибка, из-за которой SavedStateHandle не восстанавливал должным образом специальные классы Parcelable после завершения и повторного запуска процесса. Из-за того, что фреймворк Android теряет информацию о типах, для массивов пользовательских объектов Parcelable требуется дополнительная работа (вручную создать типизированный массив нужного типа). Теперь в документации по get, getLiveData и getStateFlow это ограничение указано отдельно.
  • Правила сохранения ProGuard, связанные с LifecycleObserver, удалены. Это означает, что для кода, обработанного ProGuard, который использует API через рефлексию (например, с помощью давно устаревшей аннотации @OnLifecycleEvent), нужно будет предоставить собственные правила сохранения для конкретного случая использования.

Наблюдаемость событий жизненного цикла

  • Вместо LifecycleEventObserver теперь можно отслеживать Flow для 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 аналогичен тому, который используется в 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 как State Compose. Это эквивалентно 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 is released with no changes. Версия 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 внутри сопрограммы. Теперь 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 в сопрограмме, например в 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).
  • Добавлен API LifecycleResumeEffect для запуска SideEffect Compose на основе обратных вызовов событий Lifecycle.Event.ON_RESUME и Lifecycle.Event.ON_PAUSE. (I60386, b/235529345)
  • Добавлен API LifecycleStartEffect для запуска SideEffect Compose на основе обратных вызовов событий Lifecycle.Event.ON_START и Lifecycle.Event.ON_STOP. (I5a8d1, b/235529345)
  • Добавлен API LifecycleEventEffect для запуска SideEffect Compose на основе Lifecycle.Event. (Ic9794, b/235529345)
  • Добавлено расширение Lifecycle.collectAsState(), чтобы напрямую предоставлять Lifecycle.State как State Compose. Это эквивалентно lifecycle.currentStateFlow.collectAsState(), но короче. (I11015, b/235529345)

Исправление ошибок

  • Расширение LiveData.distinctUntilChanged() теперь задает value возвращаемого LiveData, если для предыдущего LiveData было задано значение. Это не влияет на поведение наблюдения – обновленные значения из источника LiveData будут применяться только после того, как вы начнете наблюдать за LiveData, возвращенным из distinctUntilChanged(). (Ib482f)
  • Правила сохранения ProGuard, связанные с LifecycleObserver, удалены. Это означает, что для кода, обработанного ProGuard, в котором API используются через рефлексию, нужно будет предоставить собственные правила сохранения для конкретного случая использования. (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 содержит эти коммиты.

Обновления зависимостей

Версия 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 State с учетом жизненного цикла.
  • Методы Lifecycle.launchWhenX и Lifecycle.whenX устарели, поскольку использование диспетчера приостановки в некоторых случаях может привести к потере ресурсов. Рекомендуется использовать Lifecycle.repeatOnLifecycle. Подробнее о том, почему однократная приостановка работы небезопасна, читайте в этом объяснении.
  • Преобразование в Kotlin. Большое количество классов Lifecycle было преобразовано в Kotlin. Все преобразованные классы сохраняют двоичную совместимость с предыдущими версиями. Следующие классы имеют несовместимые с исходным кодом изменения для классов, написанных на Kotlin: ViewTreeLifecycleOwner, LiveDataReactiveStreams, HasDefaultViewModelProviderFactory, ViewTreeViewModelStoreOwner, Transformations, ViewModelStoreOwner, LifecycleOwner.

В таблице ниже приведены исходные конверсии для новой версии жизненного цикла.

Lifecycle 2.5 Lifecycle 2.5 (KTX) Lifecycle 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
  • Допустимость значения NULL для метода onChanged класса Observer, созданного в Kotlin, теперь соответствует допустимости значения NULL для универсального типа. Если вы хотите, чтобы 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

  • collectAsStateWithLifecycle() API lifecycle-runtime-compose больше не являются экспериментальными. (I09d42, b/258835424)
  • Методы Lifecycle.launchWhenX и Lifecycle.whenX устарели, поскольку использование диспетчера приостановки в некоторых случаях может привести к потере ресурсов. Рекомендуется использовать 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 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой ограничения между разными модулями 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 содержит эти коммиты.

Изменения в API

  • Теперь MediatorLiveData включает конструктор для установки начального значения. (Ib6cc5, b/151244085)

Исправление ошибок

  • Артефакты Lifecycle теперь включают ограничения, которые гарантируют, что все взаимозависимые артефакты Lifecycle используют одну и ту же версию, автоматически обновляя другие зависимости при обновлении одной из них. 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, сбор потока останавливается и значение 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 теперь есть API getStateFlow(), который возвращает 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 с помощью одного или нескольких инициализаторов лямбда-выражений (по одному для каждого класса 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(), который использует лямбда-фабрику для создания экземпляра 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 Compose Saver. Артефакт 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().

    Например, чтобы создать область сопрограммы, которую можно внедрить в 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.
  • Теперь LifecycleRegistry будет удалять наблюдателей при достижении состояния DESTROYED.

Версия 2.5.0-rc02

15 июня 2022 г.

Данные "androidx.lifecycle:lifecycle-*:2.5.0-rc02" опубликованы. Версия 2.5.0-rc02 содержит эти коммиты.

Исправление ошибок

  • ViewModelProvider больше не будет аварийно завершать работу при смешивании предыдущих версий зависимостей compileOnly Lifecycle с версиями 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 при использовании нескольких обратных стеков. (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 теперь предлагает API getStateFlow(), который возвращает 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 в ViewModel, которые будут закрыты при очистке ViewModel без необходимости вручную выполнять какие-либо действия в onCleared(). (I55ea0)
  • Теперь в lifecycle-viewmodel есть InitializerViewModelFactory, который позволяет добавлять лямбда-выражения для обработки определенных классов ViewModel, используя CreationExtras в качестве основного источника данных. (If58fc, b/216687549)
  • В lifecycle-viewmodel-compose теперь есть API viewModel(), который принимает фабрику лямбда-выражений для создания экземпляра ViewModel без необходимости создавать пользовательский ViewModelProvider.Factory. (I97fbb, b/216688927)

Изменения в API

  • Теперь вы можете создать ViewModel с помощью CreationExtras через lifecycle-viewmodel-compose. (I08887, b/216688927)

Изменения в поведении

  • Попытка переместить Lifecycle.State из INITIALIZED в DESTROYED теперь всегда будет вызывать IllegalStateException, независимо от того, прикреплен ли наблюдатель к Lifecycle. (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 для универсальных шаблонов в обоих классах. (Ib6ce2, b/216168263, I9647a, b/177667711)
  • Параметр функции LiveData switchMap теперь может иметь выходное значение NULL. (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)
  • Теперь при попытке создать ViewModel, если в пользовательских классах AndroidViewModel параметры указаны в неправильном порядке, появляется более понятное сообщение об ошибке. (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. Вместо жесткого набора подклассов ViewModelProvider.Factory, каждый из которых добавляет дополнительные функции (разрешает параметр конструктора Application через AndroidViewModelFactory, разрешает параметр конструктора SavedStateHandle через SavedStateViewModelFactory и AbstractSavedStateViewModelFactory и т. д.), мы переходим к фабрикам без отслеживания состояния, которые полагаются на новую концепцию – 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.

Эти дополнительные параметры по умолчанию предоставляются при использовании 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
    }
}

Мы используем функцию расширения Kotlin createSavedStateHandle() для CreationExtras из SavedStateHandleSupport, чтобы создать SavedStateHandle только для одной ViewModel, которой это нужно. (Ia6654, b/188541057)

Собственные CreationExtras можно предоставить, переопределив getDefaultViewModelCreationExtras() в ComponentActivity или Fragment. Таким образом они станут доступны для собственных ViewModelProvider.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". Она предоставляет composable-функцию viewModel() и LocalViewModelStoreOwner.
    • Критическое изменение в исходном коде. ViewModelProvider переписан на Kotlin. Метод ViewModelProvider.Factory.create больше не поддерживает обобщенный тип, допускающий значение NULL.
  • В androidx.lifecycle:lifecycle-runtime-ktx добавлены новые API сопрограмм:
  • Lifecycle.repeatOnLifecycle – API, который выполняет блок кода в сопрограмме, когда жизненный цикл находится по крайней мере в определенном состоянии. Блок будет отменен и перезапущен, когда жизненный цикл перейдет в целевое состояние и выйдет из него.
  • Flow.flowWithLifecycle – API, который передает значения из вышестоящего потока, когда жизненный цикл находится по крайней мере в определенном состоянии.
  • Объект "DefaultLifecycleObserver" перемещен из папки "lifecycle.lifecycle-common-java8" в папку "lifecycle.lifecycle-common". lifecycle.lifecycle-common-java8 больше не предоставляет дополнительных функций по сравнению с lifecycle.lifecycle-common, поэтому зависимость от него можно заменить на lifecycle.lifecycle-common.
  • API, не относящиеся к сопрограммам, перенесены из 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. (I021aa)
  • API, не относящиеся к сопрограммам, перенесены из 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 больше не допускает значение 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 содержит эти коммиты.

Новые функции

  • Добавлена новая проверка RepeatOnLifecycleWrongUsage в lifecycle-runtime-ktx, которая определяет, когда repeateOnLifecycle неправильно используется в onStart() или onResume(). (706078, b/187887400)

Изменения в API

  • API LifecycleOwner.addRepeatingJob удален в пользу Lifecycle.repeatOnLifecycle, который поддерживает структурированный параллелизм и более прост в использовании. (I4a3a8)
  • Сделайте ProcessLifecycleInitializer общедоступным, чтобы другие androidx.startup.Initializer могли использовать его в качестве зависимости. (I94c31)

Исправление ошибок

  • Исправлена ошибка, связанная с проверкой NullSafeMutableLiveData, когда у поля есть модификаторы. (#147, b/183696616)
  • Исправлена ещё одна проблема с проверкой NullSafeMutableLiveData при использовании универсальных шаблонов. (#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. Это альтернатива новому API LifecycleOwner.addRepeatinJob. (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 содержит эти коммиты.

Изменения в зависимостях

  • В этой версии 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 возвращает допускающий значение NULL ViewModelStoreOwner, чтобы было проще определить, доступен ли ViewModelStoreOwner в текущей композиции. 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 содержит эти коммиты.

Новые функции

  • Функция 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 содержит эти коммиты.

Исправление ошибок

  • Правило анализа NonNullableMutableLiveData теперь может правильно различать переменные полей с разной допустимостью значения NULL. (b/169249668)

Версия 2.3.0

Версия 2.3.0

10 февраля 2021 г.

Данные "androidx.lifecycle:lifecycle-*:2.3.0" опубликованы. Версия 2.3.0 содержит эти коммиты.

Основные изменения по сравнению с версией 2.2.0

  • Поддержка классов, не поддерживающих Parcelable, в SavedStateHandle. Теперь SavedStateHandle поддерживает отложенную сериализацию. Для этого вызовите setSavedStateProvider() для определенного ключа и укажите SavedStateProvider, который получит обратный вызов saveState(), когда SavedStateHandle потребуется сохранить свое состояние. Подробнее о сохранении классов, не поддерживающих Parcelable…
  • Принудительное применение поведения жизненного цикла:
    • LifecycleRegistry теперь принудительно использует DESTROYED в качестве конечного состояния.
    • Теперь LifecycleRegistry проверяет, вызываются ли его методы в основном потоке. Это всегда было требованием для жизненных циклов действий, фрагментов и т. д. Добавление наблюдателей из неосновных потоков приводило к трудноуловимым сбоям во время выполнения. Для объектов LifecycleRegistry, принадлежащих вашим компонентам, можно явно отключить проверки с помощью LifecycleRegistry.createUnsafe(...), но тогда вам нужно будет обеспечить надлежащую синхронизацию при доступе к этому объекту LifecycleRegistry из разных потоков.
  • Вспомогательные методы для состояний и событий жизненного цикла. В класс Lifecycle.Event добавлены статические вспомогательные методы downFrom(State), downTo(State), upFrom(State) и upTo(State), которые генерируют Event на основе State и направления перехода. Добавлен метод getTargetState(), который предоставляет State, к которому жизненный цикл перейдет сразу после Event.
  • withStateAtLeast Добавлены API Lifecycle.withStateAtLeast, которые ожидают состояния жизненного цикла и синхронно выполняют блок кода без приостановки в момент изменения состояния, а затем возобновляют работу с результатом. Эти 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(), необходимое для использования синтаксиса лямбда-выражений, больше не поддерживается, поскольку оно не требуется при использовании 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(), необходимое для использования синтаксиса лямбда-выражений, теперь устарело, поскольку оно не требуется при использовании 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 содержит эти коммиты.

Исправление ошибок

  • Исправлена ошибка, из-за которой происходил сбой при проверке NullSafeMutableLiveData Lint. (aosp/1395367)

Версия 2.3.0-alpha06

22 июля 2020 г.

Данные "androidx.lifecycle:lifecycle-*:2.3.0-alpha06" опубликованы. Версия 2.3.0-alpha06 содержит эти коммиты.

Новые функции

  • В Lifecycle.Event добавлены статические вспомогательные методы downFrom(State), downTo(State), upFrom(State), upTo(State) для создания Event на основе State и направления перехода. Добавлен метод getTargetState(), который предоставляет State, к которому жизненный цикл перейдет сразу после Event. (I00887)
  • Добавлены API Lifecycle.withStateAtLeast, которые ожидают состояния жизненного цикла и синхронно выполняют блок кода без приостановки в момент изменения состояния, а затем возобновляют работу с результатом. Эти API отличаются от существующих методов when* тем, что не позволяют выполнять приостанавливающий код и не используют пользовательский диспетчер. (aosp/1326081)

Изменения в поведении

  • LifecycleRegistry теперь принудительно использует DESTROYED в качестве конечного состояния. (I00887)
  • Теперь LifecycleRegistry проверяет, вызываются ли его методы в основном потоке. Это всегда было требованием для жизненных циклов действий, фрагментов и т. д. Добавление наблюдателей из неосновных потоков приводило к трудноуловимым сбоям во время выполнения. Для объектов 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 теперь поддерживает отложенную сериализацию, позволяя вызывать setSavedStateProvider() для заданного ключа, предоставляя SavedStateProvider, который получит обратный вызов saveState(), когда SavedStateHandle попросят сохранить свое состояние. (b/155106862)
  • Новый API ViewTreeViewModelStoreOwner.get(View) позволяет получить содержащийся ViewModelStoreOwner, используя экземпляр View. Чтобы заполнить его правильно, необходимо перейти на Activity 1.2.0-alpha05, Fragment 1.3.0-alpha05 и AppCompat 1.3.0-alpha01. В lifecycle-viewmodel-ktx добавлено расширение Kotlin findViewModelStoreOwner(). (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. Это позволяет лучше поддерживать случаи, когда значение недоступно и поддержка 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) позволяет получить содержащийся 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 определено как ненулевое. Доступно при использовании артефактов 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

Версия Lifecycle ViewModel SavedState теперь совпадает с версией других артефактов Lifecycle. Поведение 2.2.0 идентично поведению 1.0.0.

Версия 2.2.0

22 января 2020 г.

Данные "androidx.lifecycle:lifecycle-*:2.2.0" опубликованы. Коммиты, вошедшие в версию 2.2.0

Важные изменения, внесенные после версии 2.1.0

  • Интеграция сопрограмм жизненного цикла. Новый артефакт lifecycle-runtime-ktx добавляет интеграцию между жизненным циклом и сопрограммами Kotlin. Класс lifecycle-livedata-ktx также был расширен, чтобы использовать преимущества сопрограмм. Подробнее о том, как использовать сопрограммы Kotlin с компонентами архитектуры…
  • Прекращение поддержки ViewModelProviders.of(). Поддержка ViewModelProviders.of() прекращена. Чтобы получить ту же функциональность при использовании Fragment 1.2.0, вы можете передать Fragment или FragmentActivity в новый конструктор ViewModelProvider(ViewModelStoreOwner).
  • Прекращение поддержки артефакта lifecycle-extensions. В связи с прекращением поддержки ViewModelProviders.of() в этом выпуске прекращается поддержка последнего API в lifecycle-extensions. Теперь этот артефакт считается полностью устаревшим. Настоятельно рекомендуем использовать конкретные артефакты Lifecycle (например, lifecycle-service, если вы используете LifecycleService, и lifecycle-process, если вы используете ProcessLifecycleOwner), а не lifecycle-extensions, поскольку в будущем не планируется выпуск версии 2.3.0 для lifecycle-extensions.
  • Инкрементный инструмент обработки аннотаций Gradle. Инструмент обработки аннотаций Lifecycle по умолчанию является инкрементным. Если ваше приложение написано на языке программирования 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)
  • Благодарим Всеволода Толстопятова из Jetbrains за проверку реализации встроенного выполнения.

Изменения в зависимостях

  • Расширения жизненного цикла теперь зависят от фрагмента 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 и связанные методы выполнялись на один кадр позже, чем связанный метод жизненного цикла, поскольку использовался 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 сопрограммы. 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" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.

Новые функции

Изменения в 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 содержит эти коммиты.

Изменения в зависимостях

  • Lifecycle ViewModel SavedState теперь зависит от Lifecycle 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 содержит эти коммиты.

Изменения в зависимостях

  • Теперь зависит от жизненного цикла 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 SavedStateVMFactory. У ViewModel должен быть конструктор, который принимает объект SavedStateHandle в качестве параметра.

Версия 2.1.0

Важные изменения, внесенные в версию 2.0.0

  • Добавлен метод LifecycleEventObserver для случаев, когда требуется поток событий жизненного цикла. Теперь это общедоступный API, а не скрытый класс GenericLifecycleObserver.
  • Добавлены расширения KTX для методов LiveData.observe и Transformations.*.
  • Добавлен метод Transformations.distinctUntilChanged, который создает новый объект LiveData, не передающий значение, пока не изменится значение источника LiveData.
  • Добавлена поддержка сопрограмм в ViewModels за счет добавления свойства расширения 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(), теперь поддерживает не только ViewModelStoreOwner, но и ViewModelStore. (aosp/932932)

Версия 2.1.0-alpha03

13 марта 2019 г.

Данные "androidx.lifecycle:*:2.1.0-alpha03" опубликованы. Полный список коммитов, включенных в эту версию, можно найти здесь.

Изменения в API

  • Устройство "ViewModelProvider.KeyedFactory" удалено. Второй интерфейс в дополнение к 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.
  • Поддержка сопрограмм в ViewModels: добавлено свойство расширения ViewModel.viewModelScope.
  • Добавлена фабрика ViewModelProvider.KeyedFactory для ViewModels, которая получает key и Class в методе create.

Версия 2.0.0

Версия 2.0.0

21 сентября 2018 г.

Выпущена версия Lifecycle 2.0.0 с одним исправлением ошибки из 2.0.0-rc01 в ViewModel.

Исправление ошибок

  • Исправлено правило ProGuard для ViewModel, которое ошибочно удаляло конструкторы b/112230489.

Версия 2.0.0-beta01

2 июля 2018 г.

Исправление ошибок

  • Исправлено правило ProGuard для LifecycleObserver, чтобы сохранять только реализации, а не субинтерфейсы (b/71389427).
  • Исправлены правила ProGuard для ViewModel, чтобы разрешить обфускацию и сжатие.

Версии до AndroidX

Для версий Lifecycle, предшествующих AndroidX, включите следующие зависимости:

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. Это позволяет использовать его без зависимости от среды выполнения, например в paging:common ниже.

lifecycle:common – это зависимость lifecycle:runtime, поэтому изменение не влияет на lifecycle:runtime напрямую, а только на модули, которые напрямую зависят от lifecycle:common, как Paging.

Версия 1.1.0

22 января 2018 г.

Изменения в пакетах

Теперь доступны новые, гораздо меньшие зависимости:

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

Изменения в API

  • Устаревшие поля LifecycleActivity и LifecycleFragment удалены. Используйте FragmentActivity, AppCompatActivity или Fragment.
  • В аккаунты "ViewModelProviders" и "ViewModelStores" добавлено @NonNull аннотаций.
  • Конструктор ViewModelProviders больше не поддерживается. Используйте его статические методы.
  • Поддержка ViewModelProviders.DefaultFactory прекращена. Используйте ViewModelProvider.AndroidViewModelFactory.
  • Добавлен статический метод ViewModelProvider.AndroidViewModelFactory.getInstance(Application), который позволяет получить статический объект Factory, подходящий для создания экземпляров ViewModel и AndroidViewModel.