Жизненный цикл
В этой таблице перечислены все артефакты в группе androidx.lifecycle.
| Объект | Основная версия | Релиз-кандидат | Бета-версия | Альфа-версия |
|---|---|---|---|---|
| lifecycle-* | 2.11.1 | - | - | 2.12.0-alpha06 |
| lifecycle-viewmodel-navigation3 | 2.11.1 | - | - | 2.12.0-alpha06 |
Объявление зависимостей
Чтобы добавить зависимость от 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, используйте APIrememberDecoratedNavEntries. (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для отдельных экранов ("записей") с помощью APIrememberViewModelStoreNavEntryDecorator():@Composable fun MyComposable() { NavDisplay( backStack = backStack, entryDecorators = listOf( rememberSaveableStateHolderNavEntryDecorator(), // Add this line to automatically scope ViewModels to each entry rememberViewModelStoreNavEntryDecorator(), ), entryProvider = entryProvider { // Add your entries here } } }Добавлена функция фабрики построителя для
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).
Обновление зависимостей
- Lifecycle теперь зависит от Annotation
1.9.1, чтобы обеспечить поддержку новых целей KMP (Ic9e4f, b/397701294).
Версия 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, полученные через соответствующие APIfindViewTree, теперь можно разрешать через непересекающиеся родительские элементы представления, такие как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. В ошибке LintNullSafeMutableLiveDataулучшена поддержка умных приведений типов, что позволяет избегать ложных срабатываний. (85fed6, b/181042665)
Обновления зависимостей
- Из Lifecycle
2.8.6: Lifecycle Runtime Compose теперь зависит от Compose Runtime1.7.1. - Lifecycle Runtime теперь зависит от ProfileInstaller
1.4.0.
Версия 2.9.0-alpha02
4 сентября 2024 г.
Данные "androidx.lifecycle:lifecycle-*:2.9.0-alpha02" опубликованы. Версия 2.9.0-alpha02 содержит эти коммиты.
Исправление ошибок
- В разделе Жизненный цикл
2.8.5обновите правила ProGuard дляandroidx.lifecycle.ReportFragment, чтобы разрешить обфускацию . (ff898e1)
Внешний вклад
- Переместить
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)
Обновления зависимостей
- Lifecycle Runtime Compose теперь зависит от Compose Runtime
1.7.1.
Версия 2.8.5
4 сентября 2024 г.
Данные "androidx.lifecycle:lifecycle-*:2.8.5" опубликованы. Версия 2.8.5 содержит эти коммиты.
Исправление ошибок
- Обновите правила ProGuard для
androidx.lifecycle.ReportFragment, чтобы разрешить обфускацию . (ff898e1)
Внешний вклад
- Делегат расширения
SavedStateHandle.saveableтеперь поддерживает значения, допускающие 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теперь содержит APIdropUnlessResumedиdropUnlessStarted, которые позволяют отбрасывать клики и другие события, происходящие даже после того, какLifecycleOwnerопустился ниже заданногоLifecycle.State. Например, это можно использовать с Navigation Compose, чтобы избежать обработки событий кликов после того, как переход на другой экран уже начался:onClick: () -> Unit = dropUnlessResumed { navController.navigate(NEW_SCREEN) } ViewModel.viewModelScopeтеперь является переопределяемым параметром конструктора, что позволяет вам внедрить собственный диспетчер иSupervisorJob()или переопределить значение по умолчанию, используяbackgroundScope, доступный вrunTest. (I2817c, b/264598574)class MyViewModel( // Make Dispatchers.Main the default, rather than Dispatchers.Main.immediate viewModelScope: CoroutineScope = Dispatchers.Main + SupervisorJob() ) : ViewModel(viewModelScope) { // Use viewModelScope as before, without any code changes } // Allows overriding the viewModelScope in a test fun Test() = runTest { val viewModel = MyViewModel(backgroundScope) }ViewModelпереписан на Kotlin и теперь используетAutoClosableвместоCloseable. Теперь поддерживается добавление объектовAutoCloseableс помощьюkey, что позволяет получать их черезgetCloseable().Вызов
LifecycleStartEffectиLifecycleResumeEffectбез ключа теперь считается ошибкой, как и в случае сDisposableEffectAPI, который эти API дублируют.Прекращена поддержка функции
LiveDataReactiveStreams.toPublisher(lifecycleOwner, liveData). Вместо нее используйтеLiveData.toPublisher(lifecycleOwner).Расширения Kotlin
lifecycle-livedata-core-ktxперенесены в модульlifecycle-livedata-core.Мы провели рефакторинг
NullSafeMutableLiveData, чтобы избежать ложных срабатываний.
Совместимость Lifecycle с Kotlin Multiplatform
Основные 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, или использоватьviewModelFactoryKotlin 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. Чтобы учесть это изменение, метод ComposableviewModelтеперь принимает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, или использоватьviewModelFactoryKotlin 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без ключа теперь считается ошибкой, как и в случае сDisposableEffectAPI, который эти 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какStateCompose. Это эквивалентно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для запускаSideEffectCompose на основе обратных вызовов событийLifecycle.Event.ON_RESUMEиLifecycle.Event.ON_PAUSE. (I60386, b/235529345) - Добавлен API
LifecycleStartEffectдля запускаSideEffectCompose на основе обратных вызовов событийLifecycle.Event.ON_STARTиLifecycle.Event.ON_STOP. (I5a8d1, b/235529345) - Добавлен API
LifecycleEventEffectдля запускаSideEffectCompose на основеLifecycle.Event. (Ic9794, b/235529345) - Добавлено расширение
Lifecycle.collectAsState(), чтобы напрямую предоставлятьLifecycle.StateкакStateCompose. Это эквивалентно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 содержит эти коммиты.
Обновления зависимостей
lifecycle-viewmodel-savedstateтеперь зависит от SavedState1.2.1. (cd7251)- Теперь Lifecycle зависит от ProfileInstaller
1.3.0. (f9d30b)
Версия 2.6.0
8 марта 2023 г.
Данные "androidx.lifecycle:lifecycle-*:2.6.0" опубликованы. Версия 2.6.0 содержит эти коммиты.
Важные изменения, внесенные после версии 2.5.0
- В
LiveDataтеперь есть новое свойствоisInitialized, которое указывает, было ли когда-либо задано явное значение дляLiveData. Это позволяет различать, возвращает лиliveData.valueзначениеnull, потому что значение никогда не задавалось, или это явное значениеnull. - Теперь
MediatorLiveDataвключает конструктор для установки начального значения. - Добавлено новое расширение для
StateFlowиFlowизcollectAsStateWithLifecycle(), которое собирает данные из потоков и представляет их последнее значение в виде Compose 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, устарели и заменены версиями, которые принимают KotlinFunction1. Это изменение сохраняет двоичную совместимость. (I8e14f)ViewTreeViewModelStoreOwnerтеперь написан на Kotlin. Это изменение, несовместимое с исходным кодом для классов, написанных на Kotlin. Теперь вам нужно напрямую импортировать и использовать методы расширения Kotlin вViewизandroidx.lifecycle.setViewTreeViewModelStoreOwnerиandroidx.lifecycle.findViewTreeViewModelStoreOwner, чтобы задать и найти ранее заданного владельца. Она совместима на уровне двоичного кода и исходного кода для реализаций, написанных на языке программирования Java. (Ia06d8, Ib22d8, b/240298691)- Интерфейс
HasDefaultViewModelProviderFactoryтеперь написан на Kotlin. Это изменение, несовместимое с исходным кодом, для классов, написанных на Kotlin. Теперь они должны переопределять свойстваdefaultViewModelProviderFactoryиdefaultViewModelCreationExtras, а не реализовывать предыдущие соответствующие функции. (Iaed9c, b/240298691) Observerтеперь написан на Kotlin. В методеonChanged()теперь используется параметрvalue. (Iffef2, I4995e, b/240298691)AndroidViewModel,AbstractSavedStateViewModelFactory,LifecycleService,ServiceLifecycleDispatcherиProcessLifecycleOwnerтеперь написаны на Kotlin (I2e771, Ibae40, I160d7, I08884, I1cda7, b/240298691).
Версия 2.6.0-alpha04
11 января 2023 г.
Данные "androidx.lifecycle:lifecycle-*:2.6.0-alpha04" опубликованы. Версия 2.6.0-alpha04 содержит эти коммиты.
Новые функции
- В
LiveDataтеперь есть новое свойствоisInitialized, которое указывает, было ли когда-либо задано явное значение дляLiveData. Это позволяет различать, возвращает лиliveData.valueзначениеnull, потому что значение никогда не задавалось, или это явное значениеnull. (Ibd018)
Изменения в API
collectAsStateWithLifecycle()APIlifecycle-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)при использовании конструктора с отслеживанием состояния сLifecycle2.4+ (I5b315, b/238011621).
Версия 2.6.0-alpha01
29 июня 2022 г.
Данные "androidx.lifecycle:lifecycle-*:2.6.0-alpha01" опубликованы. Версия 2.6.0-alpha01 содержит эти коммиты.
Новые функции
- Добавлено новое расширение для
StateFlowиFlowизcollectAsStateWithLifecycle, которое собирает данные из потоков и представляет последнее значение в виде состояния Compose с учетом жизненного цикла. Поток собирается, и новое значение устанавливается в качестве значения состояния, когда жизненный цикл находится по крайней мере в определенномLifecycle.State. Когда жизненный цикл опускается нижеLifecycle.State, сбор потока останавливается и значение 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теперь есть APIgetStateFlow(), который возвращает KotlinStateFlowдля отслеживания изменений значений. Это альтернатива использованиюLiveData.ViewModel CreationExtras. При написании пользовательского
ViewModelProvider.Factoryбольше не требуется расширятьAndroidViewModelFactoryилиAbstractSavedStateViewModelFactory, чтобы получить доступ кApplicationилиSavedStateHandleсоответственно. Вместо этого они предоставляются каждому подклассуViewModelProvider.FactoryкакCreationExtrasчерез новую перегрузкуcreate:create(Class<T>, CreationExtras). Эти дополнительные данные автоматически предоставляются вашим объектом Activity или Fragment при использовании Activity1.5.0и Fragment1.5.0соответственно.class CustomFactory : ViewModelProvider.Factory { override fun <T : ViewModel> create(modelClass: Class<T>, extras: CreationExtras): T { return when (modelClass) { HomeViewModel::class -> { // Get the Application object from extras val application = checkNotNull(extras[ViewModelProvider.AndroidViewModelFactory.APPLICATION_KEY]) // Pass it directly to HomeViewModel HomeViewModel(application) } DetailViewModel::class -> { // Create a SavedStateHandle for this ViewModel from extras val savedStateHandle = extras.createSavedStateHandle() DetailViewModel(savedStateHandle) } else -> throw IllegalArgumentException("Unknown class $modelClass") } as T } }В
lifecycle-viewmodelтеперь естьviewModelFactoryKotlin DSL, который позволяет определитьViewModelProvider.Factoryс помощью одного или нескольких инициализаторов лямбда-выражений (по одному для каждого классаViewModel, поддерживаемого вашей пользовательской фабрикой), используяCreationExtrasв качестве основного источника данных.val customFactory = viewModelFactory { // The return type of the lambda automatically sets what class this lambda handles initializer { // Get the Application object from extras provided to the lambda val application = checkNotNull(get(ViewModelProvider.AndroidViewModelFactory.APPLICATION_KEY)) HomeViewModel(application) } initializer { val savedStateHandle = createSavedStateHandle() DetailViewModel(savedStateHandle) } }В
lifecycle-viewmodel-composeтеперь есть APIviewModel(), который использует лямбда-фабрику для создания экземпляра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, поддерживаемоеSavedStateHandleViewModel.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теперь предлагает APIgetStateFlow(), который возвращает KotlinStateFlowдля отслеживания изменений значений в качестве альтернативы использованиюLiveData. (Iad3ab, b/178037961)
Версия 2.5.0-alpha03
23 февраля 2022 г.
Данные "androidx.lifecycle:lifecycle-*:2.5.0-alpha03" опубликованы. Версия 2.5.0-alpha03 содержит эти коммиты.
Новые функции
- Добавлен API
addCloseable()и новая перегрузка конструктора, позволяющая добавлять один или несколько объектовCloseableвViewModel, которые будут закрыты при очисткеViewModelбез необходимости вручную выполнять какие-либо действия вonCleared(). (I55ea0) - Теперь в
lifecycle-viewmodelестьInitializerViewModelFactory, который позволяет добавлять лямбда-выражения для обработки определенных классовViewModel, используяCreationExtrasв качестве основного источника данных. (If58fc, b/216687549) - В
lifecycle-viewmodel-composeтеперь есть APIviewModel(), который принимает фабрику лямбда-выражений для создания экземпляра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)- Параметр функции
LiveDataswitchMapтеперь может иметь выходное значение 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)
Внешний вклад
Версия 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, когда жизненный цикл находится по крайней мере в определенном состоянии, с помощью APILifecycle.repeatOnLifecycle. Это альтернатива новому APILifecycleOwner.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возвращает допускающий значение NULLViewModelStoreOwner, чтобы было проще определить, доступен ли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из разных потоков.
- LifecycleRegistry теперь принудительно использует
- Вспомогательные методы для состояний и событий жизненного цикла. В класс
Lifecycle.Eventдобавлены статические вспомогательные методыdownFrom(State),downTo(State),upFrom(State)иupTo(State), которые генерируютEventна основеStateи направления перехода. Добавлен методgetTargetState(), который предоставляетState, к которому жизненный цикл перейдет сразу послеEvent. withStateAtLeastДобавлены APILifecycle.withStateAtLeast, которые ожидают состояния жизненного цикла и синхронно выполняют блок кода без приостановки в момент изменения состояния, а затем возобновляют работу с результатом. Эти API отличаются от существующих методовwhen*тем, что не позволяют выполнять приостанавливающий код и не используют пользовательский диспетчер. (aosp/1326081)- API
ViewTree. Новые APIViewTreeLifecycleOwner.get(View)иViewTreeViewModelStoreOwner.get(View)позволяют получать содержащие ихLifecycleOwnerиViewModelStoreOwnerсоответственно, если задан экземплярView. Чтобы заполнить его правильно, необходимо перейти на Activity1.2.0, Fragment1.3.0и AppCompat 1.3.0-alpha01 или более поздней версии. Расширения KotlinfindViewTreeLifecycleOwnerиfindViewTreeViewModelStoreOwnerдоступны вlifecycle-runtime-ktxиlifecycle-viewmodel-ktxсоответственно. - Прекращение поддержки расширения Kotlin
LiveData.observe(). Расширение KotlinLiveData.observe(), необходимое для использования синтаксиса лямбда-выражений, больше не поддерживается, поскольку оно не требуется при использовании Kotlin 1.4.
Версия 2.3.0-rc01
16 декабря 2020 г.
Данные "androidx.lifecycle:lifecycle-*:2.3.0-rc01" опубликованы. Версия 2.3.0-rc01 содержит эти коммиты.
Исправление ошибок
- Метод
keys()классаSavedStateHandleтеперь работает одинаково до и после сохранения состояния. Теперь он включает ключи, которые ранее использовались сsetSavedStateProvider(), а также ключи, используемые сset()иgetLiveData(). (aosp/1517919, b/174713653)
Внешний вклад
- API для приостановки сопрограмм, учитывающих жизненный цикл, теперь лучше обрабатывают вызовы
yield(). Спасибо, Никлас Ансман Гирц! (aosp/1430830, b/168777346)
Версия 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)
Исправление ошибок
- Обновление androidx для использования Kotlin 1.4 (Id6471, b/165307851, b/165300826).
Изменения в документации
- В конструктор
liveDataи документацию поasLiveData()добавлена информация о том, как изменить значения времени ожидания. (aosp/1122324)
Версия 2.3.0-alpha07
19 августа 2020 г.
Данные "androidx.lifecycle:lifecycle-*:2.3.0-alpha07" опубликованы. Версия 2.3.0-alpha07 содержит эти коммиты.
Исправление ошибок
- Исправлена ошибка, из-за которой происходил сбой при проверке
NullSafeMutableLiveDataLint. (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. Чтобы заполнить его правильно, необходимо перейти на Activity1.2.0-alpha05, Fragment1.3.0-alpha05и AppCompat1.3.0-alpha01. Вlifecycle-viewmodel-ktxдобавлено расширение KotlinfindViewModelStoreOwner(). (aosp/1295522)
Исправление ошибок
- Исправлена ошибка, из-за которой проверки Lint в
MutableLiveData, выпущенные в Lifecycle2.3.0-alpha01, не публиковались вместе с артефактомlifecycle-livedata-core-ktx. (b/155323109)
Версия 2.3.0-alpha02
29 апреля 2020 г.
Данные "androidx.lifecycle:lifecycle-*:2.3.0-alpha02" опубликованы. Версия 2.3.0-alpha02 содержит эти коммиты.
Изменения в API
- Теперь в конструктор
SavedStateViewModelFactoryможно передавать нулевое значениеApplication. Это позволяет лучше поддерживать случаи, когда значение недоступно и поддержка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. Чтобы заполнить его правильно, необходимо перейти на Activity1.2.0-alpha01и Fragment1.3.0-alpha01. Расширение KotlinfindViewTreeLifecycleOwnerдоступно в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()прекращена. Чтобы получить ту же функциональность при использовании Fragment1.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.0lifecycle-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" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.
Новые функции
- Реализации
ViewModelStoreOwnerтеперь могут дополнительно реализовыватьHasDefaultViewModelProviderFactory, чтобы предоставлятьViewModelProvider.Factoryпо умолчанию. Это было сделано для Activity1.1.0-alpha02, Fragment1.2.0-alpha02и Navigation2.2.0-alpha01. (aosp/1092370, b/135716331)
Изменения в API
- Поддержка
ViewModelProviders.of()прекращена. Чтобы получить ту же функциональность, вы можете передатьFragmentилиFragmentActivityв новый конструкторViewModelProvider(ViewModelStoreOwner). (aosp/1009889)
Версия 2.2.0-alpha02
2 июля 2019 г.
Данные "androidx.lifecycle:*:2.2.0-alpha02" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.
Изменения в API
LiveDataScope.initialValueзаменено наLiveDataScope.latestValue, которое будет отслеживать текущее значение, возвращаемое блокомliveData.- Добавлена новая перегрузка для конструктора
liveData, который получает параметрtimeoutкак типDuration.
Версия 2.2.0-alpha01
7 мая 2019 г.
Данные "androidx.lifecycle:*:2.2.0-alpha01" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.
Новые функции
- В этом выпуске добавлена поддержка сопрограмм Kotlin для Lifecycle и LiveData. Подробную документацию по ним можно найти здесь.
ViewModel-SavedState версии 1.0.0
Версия 1.0.0
22 января 2020 г.
Данные "androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0" опубликованы. Версия 1.0.0 содержит эти коммиты.
Важные функции в версии 1.0.0
- Добавлен новый класс SavedStateHandle. Это позволяет классам
ViewModelполучать доступ к сохраненному состоянию и вносить в него изменения. Этот объект можно получить в конструкторе классаViewModel, а фабрики, предоставляемые по умолчанию Fragments и AppCompatActivity, будут автоматически внедрятьSavedStateHandle. - Добавлен класс AbstractSavedStateViewModelFactory. Это позволяет создавать собственные фабрики для
ViewModelи предоставлять им доступ кSavedStateHandle.
ViewModel-Savedstate версии 1.0.0-rc03
4 декабря 2019 г.
Данные "androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-rc03" опубликованы. Версия 1.0.0-rc03 содержит эти коммиты.
Изменения в зависимостях
- 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– это фабрика по умолчанию для Activity1.1.0-alpha02, Fragment1.2.0-alpha02и Navigation2.2.0-alpha01. (b/135716331)
ViewModel-SavedState версии 1.0.0-alpha02
2 июля 2019 г.
Данные "androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha02" опубликованы. Фиксации, включенные в эту версию, можно найти здесь.
Новые функции
- Добавлена перегрузка
SavedStateHandle.getLiveData(), которая принимает значение по умолчанию.
Изменения в API
SavedStateVMFactoryпереименован вSavedStateViewModelFactory.AbstractSavedStateVMFactoryпереименован вAbstractSavedStateViewModelFactory.
ViewModel-Savedstate версии 1.0.0-alpha01
13 марта 2019 г.
Данные "androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha01" опубликованы. Полный журнал коммитов для этого выпуска можно найти здесь.
Новые функции
- Теперь
ViewModelsможет вносить вклад в savedstate. Для этого используйте новую фабрику ViewModelSavedStateVMFactory. У 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плохо сочетался с новыми функциями, такими как делегирование свойств в Kotlinby viewmodels {}. (aosp/914133)
Версия 2.1.0-alpha02
30 января 2019 г.
Данные "androidx.lifecycle 2.1.0-alpha02" опубликованы.
Изменения в API
- В
LifecycleRegistryтеперь есть методsetCurrentState(), который заменяет устаревший методsetState(). (aosp/880715)
Исправление ошибок
- Исправлена ошибка, из-за которой экземпляры макета
ViewModelаварийно завершали работу при очистке содержащего ихViewModelStore. b/122273087
Версия 2.1.0-alpha01
17 декабря 2018 г.
Данные "androidx.lifecycle 2.1.0-alpha01" опубликованы.
Новые функции
- Добавлен метод
LifecycleEventObserverдля случаев, когда требуется поток событий жизненного цикла. Это общедоступный API, а не скрытый классGenericLifecycleObserver. - Добавлены расширения KTX для методов
LiveData.observeиTransformations.*. - Добавлен метод
Transformations.distinctUntilChanged. Он создает новый объектLiveData, который не выдает значение, пока не изменится исходное значение LiveData. - Поддержка сопрограмм в 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.0android.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.