Жизненный цикл
В этой таблице перечислены все артефакты группы androidx.lifecycle
.
Артефакт | Стабильный выпуск | Релиз-кандидат | Бета-версия | Альфа-релиз |
---|---|---|---|---|
жизненный цикл-* | 2.8.4 | - | - | 2.9.0-альфа01 |
жизненный цикл-представление-модель-составление | 2.8.4 | - | - | 2.9.0-альфа01 |
Объявление зависимостей
Чтобы добавить зависимость от Lifecycle, вам необходимо добавить в свой проект репозиторий Google Maven. Для получения дополнительной информации прочтите репозиторий Google Maven .
Добавьте зависимости для нужных вам артефактов в файл build.gradle
для вашего приложения или модуля:
Kotlin
Groovy
dependencies { def lifecycle_version = "2.8.4" def arch_version = "2.2.0" // ViewModel implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version" // ViewModel utilities for Compose implementation "androidx.lifecycle:lifecycle-viewmodel-compose:$lifecycle_version" // LiveData implementation "androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version" // Lifecycles only (without ViewModel or LiveData) implementation "androidx.lifecycle:lifecycle-runtime-ktx:$lifecycle_version" // Lifecycle utilities for Compose implementation "androidx.lifecycle:lifecycle-runtime-compose:$lifecycle_version" // Saved state module for ViewModel implementation "androidx.lifecycle:lifecycle-viewmodel-savedstate:$lifecycle_version" // Annotation processor kapt "androidx.lifecycle:lifecycle-compiler:$lifecycle_version" // alternately - if using Java8, use the following instead of lifecycle-compiler implementation "androidx.lifecycle:lifecycle-common-java8:$lifecycle_version" // optional - helpers for implementing LifecycleOwner in a Service implementation "androidx.lifecycle:lifecycle-service:$lifecycle_version" // optional - ProcessLifecycleOwner provides a lifecycle for the whole application process implementation "androidx.lifecycle:lifecycle-process:$lifecycle_version" // optional - ReactiveStreams support for LiveData implementation "androidx.lifecycle:lifecycle-reactivestreams-ktx:$lifecycle_version" // optional - Test helpers for LiveData testImplementation "androidx.arch.core:core-testing:$arch_version" // optional - Test helpers for Lifecycle runtime testImplementation "androidx.lifecycle:lifecycle-runtime-testing:$lifecycle_version" }
Kotlin
dependencies { val lifecycle_version = "2.8.4" val arch_version = "2.2.0" // ViewModel implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version") // ViewModel utilities for Compose implementation("androidx.lifecycle:lifecycle-viewmodel-compose:$lifecycle_version") // LiveData implementation("androidx.lifecycle:lifecycle-livedata-ktx:$lifecycle_version") // Lifecycles only (without ViewModel or LiveData) implementation("androidx.lifecycle:lifecycle-runtime-ktx:$lifecycle_version") // Lifecycle utilities for Compose implementation("androidx.lifecycle:lifecycle-runtime-compose:$lifecycle_version") // Saved state module for ViewModel implementation("androidx.lifecycle:lifecycle-viewmodel-savedstate:$lifecycle_version") // Annotation processor kapt("androidx.lifecycle:lifecycle-compiler:$lifecycle_version") // alternately - if using Java8, use the following instead of lifecycle-compiler implementation("androidx.lifecycle:lifecycle-common-java8:$lifecycle_version") // optional - helpers for implementing LifecycleOwner in a Service implementation("androidx.lifecycle:lifecycle-service:$lifecycle_version") // optional - ProcessLifecycleOwner provides a lifecycle for the whole application process implementation("androidx.lifecycle:lifecycle-process:$lifecycle_version") // optional - ReactiveStreams support for LiveData implementation("androidx.lifecycle:lifecycle-reactivestreams-ktx:$lifecycle_version") // optional - Test helpers for LiveData testImplementation("androidx.arch.core:core-testing:$arch_version") // optional - Test helpers for Lifecycle runtime testImplementation ("androidx.lifecycle:lifecycle-runtime-testing:$lifecycle_version") }
Java
Groovy
dependencies { def lifecycle_version = "2.8.4" def arch_version = "2.2.0" // ViewModel implementation "androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version" // LiveData implementation "androidx.lifecycle:lifecycle-livedata:$lifecycle_version" // Lifecycles only (without ViewModel or LiveData) implementation "androidx.lifecycle:lifecycle-runtime:$lifecycle_version" // Saved state module for ViewModel implementation "androidx.lifecycle:lifecycle-viewmodel-savedstate:$lifecycle_version" // Annotation processor annotationProcessor "androidx.lifecycle:lifecycle-compiler:$lifecycle_version" // alternately - if using Java8, use the following instead of lifecycle-compiler implementation "androidx.lifecycle:lifecycle-common-java8:$lifecycle_version" // optional - helpers for implementing LifecycleOwner in a Service implementation "androidx.lifecycle:lifecycle-service:$lifecycle_version" // optional - ProcessLifecycleOwner provides a lifecycle for the whole application process implementation "androidx.lifecycle:lifecycle-process:$lifecycle_version" // optional - ReactiveStreams support for LiveData implementation "androidx.lifecycle:lifecycle-reactivestreams:$lifecycle_version" // optional - Test helpers for LiveData testImplementation "androidx.arch.core:core-testing:$arch_version" // optional - Test helpers for Lifecycle runtime testImplementation "androidx.lifecycle:lifecycle-runtime-testing:$lifecycle_version" }
Kotlin
dependencies { val lifecycle_version = "2.8.4" val arch_version = "2.2.0" // ViewModel implementation("androidx.lifecycle:lifecycle-viewmodel:$lifecycle_version") // LiveData implementation("androidx.lifecycle:lifecycle-livedata:$lifecycle_version") // Lifecycles only (without ViewModel or LiveData) implementation("androidx.lifecycle:lifecycle-runtime:$lifecycle_version") // Saved state module for ViewModel implementation("androidx.lifecycle:lifecycle-viewmodel-savedstate:$lifecycle_version") // Annotation processor annotationProcessor("androidx.lifecycle:lifecycle-compiler:$lifecycle_version") // alternately - if using Java8, use the following instead of lifecycle-compiler implementation("androidx.lifecycle:lifecycle-common-java8:$lifecycle_version") // optional - helpers for implementing LifecycleOwner in a Service implementation("androidx.lifecycle:lifecycle-service:$lifecycle_version") // optional - ProcessLifecycleOwner provides a lifecycle for the whole application process implementation("androidx.lifecycle:lifecycle-process:$lifecycle_version") // optional - ReactiveStreams support for LiveData implementation("androidx.lifecycle:lifecycle-reactivestreams:$lifecycle_version") // optional - Test helpers for LiveData testImplementation("androidx.arch.core:core-testing:$arch_version") // optional - Test helpers for Lifecycle runtime testImplementation("androidx.lifecycle:lifecycle-runtime-testing:$lifecycle_version") }
Дополнительные сведения о зависимостях см. в разделе Добавление зависимостей сборки .
Обратная связь
Ваши отзывы помогают сделать Jetpack лучше. Дайте нам знать, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете добавить свой голос к существующей проблеме, нажав кнопку со звездочкой.
Дополнительную информацию см. в документации по системе отслеживания проблем .
Версия 2.8
Версия 2.8.4
24 июля 2024 г.
Выпущен androidx.lifecycle:lifecycle-*:2.8.4
. Версия 2.8.4 содержит эти коммиты .
Исправление ошибок
-
LiveData.asFlow()
теперь корректно обрабатывает случаи, когда возвращаемый Flow немедленно завершается после получения значения, уже установленного вLiveData
(например, при использованииtake(1)
). ( I9c566 ) - Завершение
Lifecycle*Effect
теперь идемпотентно (т. е. если методonStopOrDispose
был вызван из-за остановки жизненного цикла, он не будет вызываться второй раз после удаления, если жизненный цикл снова не вернется кSTARTED
). ( I5f607 , б/352364595 )
Версия 2.8.3
1 июля 2024 г.
Выпущен androidx.lifecycle:lifecycle-*:2.8.3
. Версия 2.8.3 содержит эти коммиты .
Исправление ошибок
- Исправлена проблема с обратной совместимостью Lifecycle 2.8 с Compose 1.6.0 и более ранними версиями при использовании сжатия кода. ( аосп/3133056 , б/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 без каких-либо обходных путей. ( аосп/3105647 , б/336842920 ) -
ViewModelProvider
больше не будет аварийно завершать работу при смешивании предыдущих версий зависимостей жизненного циклаcompileOnly
с версиями 2.8+, что устраняет проблемы с такими библиотеками, как LeakCanary. ( I80383 , б/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
для совместимости. ( аосп/3079334 , б/339562627 ) -
saveable
интеграцияViewModel
с использованием делегатов свойств теперь использует имя класса как часть автоматически сгенерированного ключа, что позволяет избежать конфликтов, если несколько классов используют один и тот жеSavedStateHandle
. ( аосп/3063463 )
Версия 2.8.0
14 мая 2024 г.
Выпущен androidx.lifecycle:lifecycle-*:2.8.0
. Версия 2.8.0 содержит эти коммиты .
Важные изменения с версии 2.7.0
-
LocalLifecycleOwner
был перенесен из пользовательского интерфейса Compose вlifecycle-runtime-compose
, чтобы его вспомогательные API на основе Compose можно было использовать за пределами пользовательского интерфейса Compose. - Артефакт
lifecycle-runtime-compose
теперь содержит APIdropUnlessResumed
иdropUnlessStarted
, которые позволяют отбрасывать клики или другие события, которые происходят даже после того, какLifecycleOwner
опустился ниже заданногоLifecycle.State
. Например, это можно использовать с Navigation Compose, чтобы избежать обработки событий щелчка после того, как переход на другой экран уже начался:onClick: () -> Unit = dropUnlessResumed { navController.navigate(NEW_SCREEN) }
ViewModel.viewModelScope
теперь является переопределяемым параметром конструктора, позволяющим вам внедрить собственный диспетчер иSupervisorJob()
или переопределить значение по умолчанию, используяbackgroundScope
, доступный вrunTest
. ( I2817c , б / 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
без ключа теперь является ошибкой в соответствии с тем же соглашением, что и APIDisposableEffect
, который отражают эти API.LiveDataReactiveStreams.toPublisher(lifecycleOwner, liveData)
устарел в пользуLiveData.toPublisher(lifecycleOwner)
.Расширения kotlin
lifecycle-livedata-core-ktx
теперь перенесены в модульlifecycle-livedata-core
.NullSafeMutableLiveData
был переработан, чтобы избежать множества ложных срабатываний.
Многоплатформенная совместимость с жизненным циклом Kotlin
Основные API жизненного цикла в Lifecycle
, LifecycleOwner
, LifecycleObserver
, Lifecycle.State
, Lifecycle.Event
и LifecycleRegistry
теперь поставляются в виде артефактов, совместимых с Kotlin Multiplatform.
Затронутые артефакты:
-
lifecycle-common
переводит большинство API вcommon
и поддерживает jvm и iOS в дополнение к Android. -
lifecycle-runtime
переводит большинство API вcommon
и поддерживает jvm и iOS в дополнение к Android. -
lifecycle-runtime-ktx
теперь пуст, и все API перенесены вlifecycle-runtime
. -
lifecycle-runtime-compose
перемещает все API вcommon
и отправляет артефакт Android, соответствующий многоплатформенной поддержкеandroidx.compose
.
Многоплатформенная совместимость ViewModel Kotlin
Артефакт lifecycle-viewmodel
и API-интерфейсы, такие как ViewModel
, ViewModelStore
, ViewModelStoreOwner
и ViewModelProvider
, теперь поставляются в виде артефактов, совместимых с Kotlin Multiplatform.
Чтобы учесть это изменение, такие методы, как методы ViewModelProvider
, которые принимали java.lang.Class<T>
, теперь имеют эквивалентный метод, который принимает kotlin.reflect.KClass<T>
.
Бинарная совместимость на Android сохранена, но есть несколько заметных изменений при сравнении поверхности Android API с общей поверхностью API:
- Создание экземпляра
ViewModelProvider
теперь выполняется с помощью методовViewModelProvider.create()
, а не непосредственного вызова его конструктора. -
ViewModelProvider.NewInstanceFactory
иViewModelProvider.AndroidViewModelFactory
доступны только на Android.- Пользовательские фабрики рекомендуется расширять из
ViewModelProvider.Factory
и использовать методcreate
, который принимаетCreationExtras
, или использоватьviewModelFactory
Kotlin DSL.
- Пользовательские фабрики рекомендуется расширять из
- Использование
ViewModelProvider
без специальной фабрики на платформах, отличных от JVM, приведет к исключениюUnsupportedOperationException
. На платформах JVM совместимость сохраняется за счет использования конструктора ViewModel без аргументов, если пользовательская фабрика не указана. -
viewModelScope
вернется кEmptyCoroutineContext
на платформах, гдеDispatchers.Main
недоступен (например, Linux).
Затронутые артефакты:
-
lifecycle-viewmodel
переводит большинство API вcommon
и поддерживает jvm и iOS в дополнение к Android. -
lifecycle-viewmodel-ktx
теперь пуст, и все API перенесены вlifecycle-viewmodel
. -
lifecycle-viewmodel-compose
перемещает все API вcommon
и отправляет артефакт Android, соответствующий многоплатформенной поддержкеandroidx.compose
.
Изменения поведения
-
InitializerViewModelFactory
(включая функцию построенияviewModelFactory
) теперь будет выдаватьIllegalArgumentException
еслиinitializer
с тем жеclazz: KClass<VM : ViewModel>
уже добавлен. ( Ic3a36 )
Известные вопросы
-
lifecycle-*:2.8.0
требует минимальной версии Compose 1.7.0-alpha05 ( b/336842920 ).
Версия 2.8.0-rc01
1 мая 2024 г.
Выпущен androidx.lifecycle:lifecycle-*:2.8.0-rc01
. Версия 2.8.0-rc01 содержит эти коммиты .
Исправление ошибок
- Исправлена проблема, из-за которой базовый профиль для
lifecycle-common
не был должным образом упакован. Теперь они упакованы в AARlifecycle-runtime
. ( аосп/3038274 , б/322382422 ) - Исправлено непреднамеренное изменение порядка очистки экземпляров
AutoCloseable
, прикрепленных к ViewModel: был восстановлен предыдущий порядокaddCloseable(String, AutoCloseable)
, затемaddClosable(AutoCloseable)
иonCleared()
. ( аосп/3041632 ) - Улучшите поведение создания по умолчанию для
viewModelScope
для собственных сред и сред рабочего стола JVM. ( аосп/3039221 )
Внешний вклад
- Спасибо Виктору Кроппу за улучшение проверки основного потока на JVM Desktop. ( аосп/3037116 )
Версия 2.8.0-бета01
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-альфа04
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
. ( б/330323282 )
Исправление ошибок
-
NullSafeMutableLiveData
был переработан, чтобы избежать множества ложных срабатываний. ( I2d8c1 , Iafb18 , I03463 , I7ecef )
Обновление зависимостей
- Артефакт
lifecycle-viewmodel-compose
теперь зависит от Compose 1.6.0. - Жизненный цикл теперь зависит от установщика профиля 1.3.1 .
Версия 2.8.0-альфа03
20 марта 2024 г.
Выпущен androidx.lifecycle:lifecycle-*:2.8.0-alpha03
. Версия 2.8.0-alpha03 содержит эти коммиты .
Новые возможности
ViewModel.viewModelScope
теперь является переопределяемым параметром конструктора, позволяющим вам внедрить собственный диспетчер иSupervisorJob()
или переопределить значение по умолчанию, используяbackgroundScope
, доступный вrunTest
. ( I2817c , б / 264598574 )class MyViewModel( // Make Dispatchers.Main the default, rather than Dispatchers.Main.immediate viewModelScope: CoroutineScope = Dispatchers.Main + SupervisorJob() ) : ViewModel(viewModelScope) { // Use viewModelScope as before, without any code changes } // Allows overriding the viewModelScope in a test fun Test() = runTest { val viewModel = MyViewModel(backgroundScope) }
Мультиплатформенная совместимость Kotlin
Артефакт lifecycle-viewmodel
и API-интерфейсы, такие как ViewModel
, ViewModelStore
, ViewModelStoreOwner
и ViewModelProvider
, теперь поставляются в виде артефактов, совместимых с Kotlin Multiplatform. ( б/214568825 )
Чтобы учесть это изменение, такие методы, как методы ViewModelProvider
, которые принимали java.lang.Class<T>
, теперь имеют эквивалентный метод, который принимает kotlin.reflect.KClass<T>
.
Бинарная совместимость на Android сохранена, но есть несколько заметных изменений при сравнении поверхности Android API с общей поверхностью API:
- Создание экземпляра
ViewModelProvider
теперь выполняется с помощью методовViewModelProvider.create()
, а не непосредственного вызова его конструктора. -
ViewModelProvider.NewInstanceFactory
иViewModelProvider.AndroidViewModelFactory
доступны только на Android.- Пользовательские фабрики рекомендуется расширять из
ViewModelProvider.Factory
и использовать методcreate
, который принимаетCreationExtras
, или использоватьviewModelFactory
Kotlin DSL.
- Пользовательские фабрики рекомендуется расширять из
- Использование
ViewModelProvider
без специальной фабрики на платформах, отличных от JVM, приведет к исключениюUnsupportedOperationException
. На платформах JVM совместимость сохраняется за счет использования конструктора ViewModel без аргументов, если пользовательская фабрика не указана. -
viewModelScope
вернется кEmptyCoroutineContext
на платформах, гдеDispatchers.Main
недоступен (например, Linux).
Изменения поведения
-
InitializerViewModelFactory
(включая функцию построенияviewModelFactory
) теперь будет выдаватьIllegalArgumentException
еслиinitializer
с тем жеclazz: KClass<VM : ViewModel>
уже добавлен. ( Ic3a36 )
Исправление ошибок
-
ViewModel.getCloseable
теперь обрабатывает дублированные ключи: если сkey
уже связан ресурсAutoCloseable
, старый ресурс будет заменен и немедленно закрыт. ( Ибеб67 ) - Доступ
viewModelScope
ViewModel
теперь является потокобезопасным. ( Если4766 , б/322407038 )
Внешний вклад
-
LocalLifecycleOwner
перешел из пользовательского интерфейса Compose в пользовательский интерфейс жизненного цикла, чтобы его вспомогательные API на основе Compose можно было использовать за пределами пользовательского интерфейса Compose. Спасибо Джейку Уортону за вклад. ( I6c41b , б/328263448 )
Версия 2.8.0-альфа02
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 )
Котлин-преобразования
-
ViewModel
теперь написана на Kotlin ( I16f26 , b/214568825 ). - Расширения kotlin
lifecycle-viewmodel-ktx
теперь перенесены в базовый модуль жизненного цикла. ( Id787b , b/274800183 ) - Расширения kotlin
lifecycle-runtime-ktx
теперь перенесены в базовый модуль жизненного цикла. ( Ic3686 , б/274800183 ) - Расширения kotlin
lifecycle-livedata-core-ktx
теперь перенесены в базовый модуль жизненного цикла. ( I54a3d , б/274800183 )
Мультиплатформенная совместимость Kotlin
- Основные API жизненного цикла в
Lifecycle
,LifecycleOwner
,LifecycleObserver
,Lifecycle.State
,Lifecycle.Event
иLifecycleRegistry
теперь поставляются в виде артефактов, совместимых с Kotlin Multiplatform. ( б/317249252 )
Изменения API
- Вызов
LifecycleStartEffect
иLifecycleResumeEffect
без ключа теперь является ошибкой в соответствии с тем же соглашением, что и APIDisposableEffect
, который отражают эти API. ( Ib0e0c , б/323518079 ) -
ViewModel
теперь используетAutoCloseable
вместоCloseable
. Это обратно совместимое изменение. ( I27f8e , б / 214568825 ) -
LiveDataReactiveStreams.toPublisher(lifecycleOwner, liveData)
устарел в пользуLiveData.toPublisher(lifecycleOwner)
. ( Ябе29 , б/262623005 )
Внешний вклад
- Спасибо Ивану Маткову из Jetbrains за помощь в переносе Lifecycle на мультиплатформу Kotlin. ( aosp/2926690 , I0c5ac , If445d )
Версия 2.8.0-альфа01
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, массивы пользовательских Parcelables требуют дополнительной работы (создание типизированного массива нужного типа вручную), и документация поget
,getLiveData
иgetStateFlow
теперь специально устраняет это ограничение. - Правила хранения proguard, связанные с
LifecycleObserver
были удалены. Это означает, что защищенный код, который хочет использовать 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 отражает API, найденный вDisposableEffect
, и подходит для случаев, когда изменение, внесенное при повышении состояния, необходимо отменить при понижении состояния.
fun HomeScreen(viewModel: HomeViewModel = viewModel()) {
LifecycleStartEffect(viewModel) {
val timeTracking = viewModel.startTrackingTimeOnScreen()
onStopOrDispose {
timeTracking.stopTrackingTimeOnScreen()
}
}
// …
}
Дополнительные сведения см. в разделе Запуск кода при событиях жизненного цикла .
Наблюдаемость за состоянием жизненного цикла
- Текущий
Lifecycle.State
теперь можно наблюдать через свойствоLifecycle.currentStateFlow
, которое возвращаетStateFlow
, гдеvalue
является текущийLifecycle.State
. - Пользователи Jetpack Compose могут использовать расширение
Lifecycle.currentStateAsState()
, чтобы напрямую предоставлятьLifecycle.State
как ComposeState
. Это эквивалент (и более короткая альтернатива)lifecycle.currentStateFlow.collectAsState()
.
Дополнительные сведения см. в разделе Сбор состояния жизненного цикла с помощью потоков .
Версия 2.7.0-rc02
13 декабря 2023 г.
Выпущен androidx.lifecycle:lifecycle-*:2.7.0-rc02
. Версия 2.7.0-rc02 содержит эти коммиты.
Исправление ошибок
- Исправлена проблема, из-за которой
SavedStateHandle
не восстанавливал должным образом пользовательские классыParcelable
после смерти и воссоздания процесса. Из-за того, что информация о типе теряется платформой Android, массивы пользовательских Parcelables требуют дополнительной работы (создание типизированного массива нужного типа вручную), и документация по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-бета01
1 ноября 2023 г.
androidx.lifecycle:lifecycle-*:2.7.0-beta01
выпущен без изменений. Версия 2.7.0-beta01 содержит эти коммиты.
- Обновление бета-версии, никаких серьезных изменений в этой версии нет.
Версия 2.7.0-альфа03
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 , б/297880630 )
Исправление ошибок
- Исправлена проблема с
LiveData.switchMap
, из-за которой возврат одного и того же экземпляраLiveData
как при первоначальном вызове, так и при последующем вызове препятствовал добавлению экземпляраLiveData
в качестве источника. ( Ibedcba7 )
Версия 2.7.0-альфа02
6 сентября 2023 г.
Выпущен androidx.lifecycle:lifecycle-*:2.7.0-alpha02
. Версия 2.7.0-alpha02 содержит эти коммиты.
Новые возможности
-
TestLifecycleOwner
теперь включает в себя функцию приостановкиsetCurrentState()
чтобы дать пользователям возможность использоватьTestLifecycleOwner
из сопрограммы, например, предоставленнойrunTest
. ( I329de , б / 259344129 )
Изменения API
- Все файлы из модулей
lifecycle-livedata-ktx
были перемещены в основной модульlifecycle-livedata
. ( I10c6f , б / 274800183 )
Изменения поведения
- Расширения
LiveData.map()
иLiveData.switchMap()
теперь устанавливаютvalue
возвращаемогоLiveData
если для предыдущегоLiveData
было установлено значение, гарантируя, что использование результирующего LiveData в Jetpack Compose имеет правильное состояние при исходной композиции. . ( I91d2b , б/269479952 ) - Функция
addCloseable()
ViewModel
теперь немедленно закрываетCloseable
еслиViewModel
уже получила вызовonCleared()
. ( I4712e , б / 280294730 )
Исправление ошибок
- Из жизненного цикла
2.6.2
: исправлена проблема, из-за которойSavedStateHandle
не восстанавливался правильно после смерти процесса, если состояние было восстановлено,save()
вызывался без фактического сохранения состояния в родительскомSavedStateRegistry
, а затем состояние восстанавливалось снова. Это исправляет взаимодействие междуrememberSaveable
иNavHost
Navigation Compose. ( аосп/2729289 )
Версия 2.7.0-альфа01
26 июля 2023 г.
Выпущен androidx.lifecycle:lifecycle-*:2.7.0-alpha01
. Версия 2.7.0-alpha01 содержит эти коммиты.
Изменения API
-
Lifecycle.State
теперь доступен для наблюдения Compose черезLifecycle.currentStateFlow
, который возвращаетStateFlow
, гдеvalue
является текущийLifecycle.State
. ( Ib212d , б/209684871 ) -
Lifecycle.Event
теперь можно наблюдать какFlow
с помощьюLifecycle.asFlow().
( If2c0f , b/176311030 ) - Был добавлен API
LifecycleResumeEffect
для запуска ComposeSideEffect
на основе обратных вызовов событийLifecycle.Event.ON_RESUME
иLifecycle.Event.ON_PAUSE
. ( I60386 , б / 235529345 ) - Был добавлен API
LifecycleStartEffect
для запуска ComposeSideEffect
на основе обратных вызовов событийLifecycle.Event.ON_START
иLifecycle.Event.ON_STOP
. ( I5a8d1 , б/235529345 ) - Был добавлен API
LifecycleEventEffect
для запуска ComposeSideEffect
на основеLifecycle.Event
. ( Ic9794 , б/235529345 ) - Было добавлено расширение
Lifecycle.collectAsState()
, позволяющее напрямую предоставлятьLifecycle.State
как ComposeState
. Это эквивалент (и более короткая альтернатива)lifecycle.currentStateFlow.collectAsState()
. ( I11015 , б / 235529345 )
Исправление ошибок
- Расширение
LiveData.distinctUntilChanged()
теперь устанавливаетvalue
возвращаемогоLiveData
, если для предыдущегоLiveData
было установлено значение. Это не меняет поведение наблюдения — обновленные значения из исходногоLiveData
по-прежнему будут применяться только после того, как вы начнете наблюдатьLiveData
, возвращаемым изdistinctUntilChanged()
. ( Ib482f ) - Правила хранения proguard, связанные с
LifecycleObserver
были удалены. Это означает, что защищенный код, желающий использовать 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. ( аосп/2729289 )
Версия 2.6.1
22 марта 2023 г.
Выпущен androidx.lifecycle:lifecycle-*:2.6.1
. Версия 2.6.1 содержит эти коммиты.
Обновления зависимостей
-
lifecycle-viewmodel-savedstate
теперь зависит от SavedState1.2.1
. ( cd7251 ) - Жизненный цикл теперь зависит от ProfileInstaller
1.3.0
. ( f9d30b )
Версия 2.6.0
8 марта 2023 г.
Выпущен androidx.lifecycle:lifecycle-*:2.6.0
. Версия 2.6.0 содержит эти коммиты.
Важные изменения с версии 2.5.0
-
LiveData
теперь включает в себя новое свойствоisInitialized
, которое указывает, было ли когда-либо установлено явное значение дляLiveData
, что позволяет вам различатьliveData.value
, возвращающий значениеnull
поскольку значение никогда не было установлено, или явноеnull
значение. -
MediatorLiveData
теперь включает конструктор для установки начального значения. - Добавлено новое расширение для
StateFlow
иFlow
методаcollectAsStateWithLifecycle()
, которое собирает данные из потоков и представляет их последнее значение как Compose State с учетом жизненного цикла. - Методы
Lifecycle.launchWhenX
иLifecycle.whenX
признаны устаревшими, поскольку использование диспетчера приостановки в некоторых случаях может привести к пустой трате ресурсов. Рекомендуется использоватьLifecycle.repeatOnLifecycle
. Для получения дополнительной информации о однократной приостановке работы см. объяснение того, почему это по своей сути небезопасно. - Преобразование Kotlin . Большое количество классов жизненного цикла было преобразовано в Kotlin. Все преобразованные классы по-прежнему сохраняют двоичную совместимость с предыдущими версиями. Следующие классы имеют несовместимые с исходным кодом изменения для классов, написанных на Kotlin:
ViewTreeLifecycleOwner
,LiveDataReactiveStreams
,HasDefaultViewModelProviderFactory
,ViewTreeViewModelStoreOwner
,Transformations
,ViewModelStoreOwner
,LifecycleOwner
В таблице ниже представлены исходные преобразования для новой версии жизненного цикла.
Жизненный цикл 2.5 | Жизненный цикл 2.5 (KTX) | Жизненный цикл 2.6 |
---|---|---|
Transformations.switchMap(liveData) {...} | liveData.switchMap {...} | liveData.switchMap {...} |
Transformations.map(liveData) {...} | liveData.map {...} | liveData.map {...} |
Transformations.distinctUntilChanged(liveData) {...} | liveData.distinctUntilChanged{...} | liveData.distinctUntilChanged{...} |
LiveDataReactiveStreams.fromPublisher(publisher) | publisher.toLiveData() | publisher.toLiveData() |
LiveDataReactiveStreams.toPublisher(lifecycleOwner, liveData) | liveData.toPublisher(lifecycleOwner) | liveData.toPublisher(lifecycleOwner) |
override fun getDefaultViewModelProviderFactory(): ViewModelProvider.Factory = factory | override fun getDefaultViewModelProviderFactory(): ViewModelProvider.Factory = factory | override val defaultViewModelProviderFactory = factory |
override fun getDefaultViewModelCreationExtras(): CreationExtras = extras | override fun getDefaultViewModelCreationExtras(): CreationExtras = extras | override val defaultViewModelProviderCreationExtras = extras |
ViewTreeLifecycleOwner.set(view, owner) | ViewTreeLifecycleOwner.set(view, owner) | view.setViewTreeLifecycleOwner(owner) |
ViewTreeLifecycleOwner.get(view) | view.findViewTreeLifecycleOwner() | view.findViewTreeLifecycleOwner() |
override fun getViewModelStore(): ViewModelStore = store | override fun getViewModelStore(): ViewModelStore = store | override val viewModelStore: ViewModelStore = store |
override fun getLifecycle(): Lifecycle = registry | override fun getLifecycle(): Lifecycle = registry | override val lifecycle: Lifecycle get() = registry |
- Обнуляемость метода
onChanged
Observer
, созданного в Kotlin, теперь соответствует обнуляемости универсального типа. Если вы хотите, чтобыObserver.onChanged()
принимал тип, допускающий значение 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-бета01
8 февраля 2023 г.
Выпущен androidx.lifecycle:lifecycle-*:2.6.0-beta01
. Версия 2.6.0-beta01 содержит эти коммиты.
Котлин-преобразования
-
LifecycleOwner
теперь написан на Kotlin. Это изменение, несовместимое с исходным кодом, для классов, написанных на Kotlin — теперь они должны переопределять свойствоlifecycle
, а не реализовывать предыдущую функциюgetLifecycle()
. ( I75b4b , б/240298691 ) -
ViewModelStoreOwner
теперь находится в Kotlin. Это изменение, несовместимое с исходным кодом, для классов, написанных на Kotlin — теперь они должны переопределить свойствоviewModelStore
, а не реализовывать предыдущую функциюgetViewModelStore()
. ( I86409 , б / 240298691 ) - Расширение Kotlin для
LifecycleOwner
, предоставляющее полеlifecycleScope
, было перенесено вlifecycle-common
артефакт изlifecycle-runtime-ktx
. ( I41d78 , б/240298691 ) - Расширение Kotlin для
Lifecycle
, предоставляющее полеcoroutineScope
, было перенесено вlifecycle-common
артефакт изlifecycle-runtime-ktx
. ( Ябб91 , б/240298691 )
Версия 2.6.0-альфа05
25 января 2023 г.
Выпущен androidx.lifecycle:lifecycle-*:2.6.0-alpha05
. Версия 2.6.0-alpha05 содержит эти коммиты.
Котлин-преобразования
-
Transformations
теперь написаны на Котлине. Это изменение, несовместимое с исходным кодом для тех классов, написанных на 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 , б/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-альфа04
11 января 2023 г.
Выпущен androidx.lifecycle:lifecycle-*:2.6.0-alpha04
. Версия 2.6.0-alpha04 содержит эти коммиты.
Новые возможности
-
LiveData
теперь включает в себя новое свойствоisInitialized
, которое указывает, было ли когда-либо установлено явное значение дляLiveData
, что позволяет вам различатьliveData.value
, возвращающий значениеnull
поскольку значение никогда не было установлено, или явноеnull
значение. ( Там же018 )
Изменения API
- API-интерфейсы
collectAsStateWithLifecycle()
дляlifecycle-runtime-compose
больше не находятся в экспериментальном состоянии. ( I09d42 , б / 258835424 ) - Методы
Lifecycle.launchWhenX
иLifecycle.whenX
признаны устаревшими, поскольку использование диспетчера приостановки в некоторых случаях может привести к пустой трате ресурсов. Рекомендуется использоватьLifecycle.repeatOnLifecycle
. ( Iafc54 , б/248302832 )
Котлин-преобразования
-
ViewTreeLifecycleOwner
теперь написан на Kotlin. Это изменение, несовместимое с исходным кодом для классов, написанных на Kotlin — теперь вы должны напрямую импортировать и использовать методы расширения Kotlin вView
androidx.lifecycle.setViewTreeLifecycleOwner
иandroidx.lifecycle.findViewTreeLifecycleOwner
, чтобы установить и найти ранее установленного владельца. Это заменяет предыдущее расширение Kotlin вlifecycle-runtime-ktx
. Он совместим на двоичном уровне и остается совместимым с исходным кодом для реализаций, написанных на языке программирования Java. ( I8a77a , I5234e , б/240298691 ) -
LiveDataReactiveStreams
теперь написан на Kotlin. Расширения Kotlin, ранее существовавшие вlifecycle-reactivestreams-ktx
были перенесены в модульlifecycle-reactivestreams
и стали основной поверхностью для кода, написанного на Kotlin. Это изменение, несовместимое с исходным кодом, для кода, написанного на Kotlin, если вы еще не использовали API-интерфейсы метода расширения Kotlin. ( I2b1b9 , I95d22 , б/240298691 ) -
DefaultLifecycleObserver
,LifecycleEventObserver
,Lifecycle
,LifecycleRegistry
,LifecycleObserver
иViewModelStore
теперь написаны на Kotlin ( Iadffd , ( I60034 , I8c52c , I9593d , I01fe1 , I59a23 , b/240298691 )
Исправление ошибок
-
SavedStateHandle
больше не завершается сбоем из-заClassCastException
при вызовеget()
с неправильным типом класса. ( I6ae7c )
Версия 2.6.0-альфа03
24 октября 2022 г.
Выпущен androidx.lifecycle:lifecycle-*:2.6.0-alpha03
. Версия 2.6.0-alpha03 содержит эти коммиты.
Исправление ошибок
- Исправлена проблема, из-за которой ограничения между различными модулями жизненного цикла не работали должным образом. ( I18d0d , б / 249686765 )
- Ошибки, вызываемые
LifecycleRegistry.moveToState()
, теперь включают более полезные сообщения об ошибках, которые информируют разработчиков о компоненте, вызывающем ошибку. ( Idf4b2 , б/244910446 )
Версия 2.6.0-альфа02
7 сентября 2022 г.
Выпущен androidx.lifecycle:lifecycle-*:2.6.0-alpha02
. Версия 2.6.0-alpha02 содержит эти коммиты.
Изменения API
-
MediatorLiveData
теперь включает конструктор для установки начального значения. ( Ib6cc5 , б/151244085 )
Исправление ошибок
- Артефакты
Lifecycle
теперь включают ограничения , которые гарантируют, что все взаимозависимые артефакты жизненного цикла используют одну и ту же версию, автоматически обновляя другие зависимости при обновлении одной из них. б/242871265 -
FlowLiveData.asFlow()
теперь создаетcallbackFlow
вместо использования собственной реализацииChannel
для обеспечения потокобезопасности и сохранения контекста. ( I4a8b2 , б/200596935 ) - Функция
asLiveData
FlowLiveData
теперь сохраняет исходное значениеStateFlow
при создании нового объектаLiveData
. ( I3f530 , б/157380488 ) - Из жизненного цикла
2.5.1
: пользовательские реализацииAndroidViewModelFactory
теперь правильно вызывают функциюcreate(modelClass)
при использовании конструктора с отслеживанием состояния вLifecycle
2.4+ ( I5b315 , b/238011621 ).
Версия 2.6.0-альфа01
29 июня 2022 г.
Выпущен androidx.lifecycle:lifecycle-*:2.6.0-alpha01
. Версия 2.6.0-alpha01 содержит эти коммиты.
Новые возможности
- Добавлено новое расширение для
StateFlow
иFlow
дляcollectAsStateWithLifecycle
, которое собирает данные из потоков и представляет свое последнее значение как Compose State с учетом жизненного цикла. Поток собирается, и для новой эмиссии устанавливается значение состояния, когда жизненный цикл находится как минимум в определенномLifecycle.State
. Когда жизненный цикл падает ниже этогоLifecycle.State
, сбор потока останавливается и значение State не обновляется. ( I1856e , б / 230557927 )
Версия 2.5
Версия 2.5.1
27 июля 2022 г.
Выпущен androidx.lifecycle:lifecycle-*:2.5.1
. Версия 2.5.1 содержит эти коммиты.
Исправление ошибок
- Пользовательские реализации
AndroidViewModelFactory
теперь правильно вызовут функциюcreate(modelClass)
при использовании конструктораAndroidViewModelFactory
с 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)
. Эти дополнения предоставляются автоматически вашей деятельностью или фрагментом при использовании активности1.5.0
и фрагмента1.5.0
соответственно.class CustomFactory : ViewModelProvider.Factory { override fun <T : ViewModel> create(modelClass: Class<T>, extras: CreationExtras): T { return when (modelClass) { HomeViewModel::class -> { // Get the Application object from extras val application = checkNotNull(extras[ViewModelProvider.AndroidViewModelFactory.APPLICATION_KEY]) // Pass it directly to HomeViewModel HomeViewModel(application) } DetailViewModel::class -> { // Create a SavedStateHandle for this ViewModel from extras val savedStateHandle = extras.createSavedStateHandle() DetailViewModel(savedStateHandle) } else -> throw IllegalArgumentException("Unknown class $modelClass") } as T } }
lifecycle-viewmodel
теперь предоставляетviewModelFactory
Kotlin DSL, который позволяет вам определить свойViewModelProvider.Factory
с точки зрения одного или нескольких инициализаторов Lambda, один для каждого конкретного классаViewModel
, которые ваши пользовательские заводские опоры с использованиемCreationExtras
в качестве основного источника данных.val customFactory = viewModelFactory { // The return type of the lambda automatically sets what class this lambda handles initializer { // Get the Application object from extras provided to the lambda val application = checkNotNull(get(ViewModelProvider.AndroidViewModelFactory.APPLICATION_KEY)) HomeViewModel(application) } initializer { val savedStateHandle = createSavedStateHandle() DetailViewModel(savedStateHandle) } }
lifecycle-viewmodel-compose
теперь предлагает APIviewModel()
, который занимает фабрику Lambda для создания экземпляра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 Integration -Артефакт
lifecycle-viewmodel-compose
теперь содержит новые экспериментальные API вSavedStateHandle.saveable
, который позволяетrememberSaveable
как поведение, поддерживаемое сохраненнымSavedStateHandle
of `ViewModel.class ListScreenViewModel(handle: SavedStateHandle): ViewModel() { // This value survives both configuration changes and process death and recreation val editMode by handle.saveable { mutableStateOf(false) } }
Добавлено API
addCloseable()
и новая перегрузка конструктора, которая позволяет вам добавлять один или несколькоCloseable
объектов вViewModel
, которые будут закрыты, когдаViewModel
очищена, не требуя никакой ручной работы вonCleared()
.Например, чтобы создать прицел из -за корзины, который вы можете ввести в ViewModel, но управляйте через тестирование, вы можете создать
CoroutineScope
, который реализуетCloseable
:class CloseableCoroutineScope( context: CoroutineContext = SupervisorJob() + Dispatchers.Main.immediate ) : Closeable, CoroutineScope { override val coroutineContext: CoroutineContext = context override fun close() { coroutineContext.cancel() } }
Который затем может быть использован в вашем конструкторе
ViewModel
, сохраняя при этом ту же срок службы, что иviewModelScope
:class TestScopeViewModel( val customScope: CloseableCoroutineScope = CloseableCoroutineScope() ) : ViewModel(customScope) { // You can now use customScope in the same way as viewModelScope }
Изменения в поведении
- Попытка переместить
Lifecycle.State
отINITIALIZED
вDESTROYED
теперь всегда бросаетIllegalStateException
независимо от того, имеет лиLifecycle
прикрепленный наблюдатель. -
LifecycleRegistry
теперь очистит своих наблюдателей, когда они достигнутDESTROYED
состояния.
Версия 2.5.0-RC02
15 июня 2022 года
androidx.lifecycle:lifecycle-*:2.5.0-rc02
выпускается. Версия 2.5.0-RC02 содержит эти коммиты.
Исправление ошибок
-
ViewModelProvider
больше не будет сбои при смешивании предыдущих версий зависимостей для жизненного цикла компонента с версиями 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-бета01
20 апреля 2022 г.
androidx.lifecycle:lifecycle-*:2.5.0-beta01
выпускается. Версия 2.5.0-бета01 содержит эти коммиты.
Изменения API
- Добавлены делегаты
SavedStateHandle.saveable
Property для использования имен свойств в качестве ключей для постоянного состояния вSavedStateHandle
( I8BB86 , B/225014345 )
Исправление ошибок
- Исправлена проблема, в которой гнездовывание одного
NavHost
в другомNavHost
на неприимкой вкладке нижней навигации приведет кIllegalStateException
при использовании нескольких стеков задних. ( I11bd5 , b/228865698 )
Версия 2.5.0-Alpha06
6 апреля 2022 года
androidx.lifecycle:lifecycle-*:2.5.0-alpha06
выпускается. Версия 2.5.0-Alpha06 содержит эти коммиты.
Новые возможности
- Добавьте экспериментальную перегрузку
MutableState
вSavedStateHandle.saveable
для паритета сrememberSaveable
( i38cfe , B/224565154 )
Изменения API
-
CreationExtras
теперь абстрактно, а не герметично. ( IB8A7A )
Исправление ошибок
- Исправлена
IllegalStateException: Already attached to lifecycleOwner
вызваннойSavedStateHandleController
. ( I7ea47 , b/215406268 )
Версия 2.5.0-Alpha05
23 марта 2022 г.
androidx.lifecycle:lifecycle-*:2.5.0-alpha05
выпускается. Версия 2.5.0-Alpha05 содержит эти коммиты.
Новые возможности
- Модуль
lifecycle-viewmodel-compose
теперь предоставляетSavedStateHandleSaver
, экспериментальный API, который обеспечивает значения вSavedStateHandle
правильно интегрированы с тем же сохраненным состоянием экземпляра, котороеrememberSaveable
применение. ( IA88B7 , B/195689777 )
Изменения API
- Исправлена проблема совместимости с жизненным циклом 2.3 и более новыми версиями жизненного цикла в 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()
, который занимает фабрику Lambda для создания экземпляра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
были преобразованы в Котлин. Это улучшило нулясь дженериков в обоих классах. ( IB6CE2 , B/216168263 , I9647A , B/177667711 ) - Параметр функции
switchMap
LiveData
теперь может иметь нулевой выход. ( I40396 , B/132923666 ) - Расширения
LiveData
-Ktx теперь аннотируются@CheckResult
, чтобы обеспечить соблюдение того, что результат используется при вызове этих функций. ( IA0F05 , B/207325134 )
Изменения в поведении
-
SavedStateHandle
теперь правильно хранит defaultValue, когда нет значения для указанного ключа. ( I1c6ce , b/178510877 )
Исправление ошибок
- От жизненного цикла
2.4.1
: обновленныйlifecycle-process
чтобы зависеть от запуска 1.1.1 , чтобы гарантировать, что исправления, которые предотвращаютProcessLifecycleInitializer
от выбросаStartupException
, доступны по умолчанию. ( IB01DF , B/216490724 ) - Теперь существует улучшенное сообщение об ошибке, когда пользовательские классы
AndroidViewModel
имеют параметры в неправильном порядке и пытаются создатьViewModel
. ( I340f7 , b/177667711 ) - Теперь вы можете создать модель представления через
CreationExtras
используяAndroidViewModelFactory
без установки приложения. ( I6ebef , b/217271656 )
Версия 2.5.0-Alpha01
26 января 2022 года
androidx.lifecycle:lifecycle-*:2.5.0-alpha01
. Версия 2.5.0-Alpha01 содержит эти коммиты.
ViewModel CreationExtras
С помощью этого выпуска мы закладываем основу для реструктуризации, как строится ViewModel
. Вместо жесткого набора подклассов 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
.
Эти дополнения предоставляются по умолчанию при использовании активности 1.5.0-alpha01
, фрагмент 1.5.0-alpha01
и навигация 2.5.0-alpha01
. Если вы используете более раннюю версию этих библиотек, ваши CreationExtras
будут пустыми - все существующие подклассы ViewModelProvider.Factory
были переписаны для поддержки обоих путей создания устаревшего CreationExtras
идти вперед.
Эти CreationExtras
позволяют вам построить ViewModelProvider.Factory
, который передает только информацию, необходимую для каждой ViewModel
, не полагаясь на строгую иерархию заводских подклассов:
class CustomFactory : ViewModelProvider.Factory {
override fun <T : ViewModel> create(modelClass: Class<T>, extras: CreationExtras): T {
return when (modelClass) {
HomeViewModel::class -> {
// Get the Application object from extras
val application = checkNotNull(extras[ViewModelProvider.AndroidViewModelFactory.APPLICATION_KEY])
// Pass it directly to HomeViewModel
HomeViewModel(application)
}
DetailViewModel::class -> {
// Create a SavedStateHandle for this ViewModel from extras
val savedStateHandle = extras.createSavedStateHandle()
DetailViewModel(savedStateHandle)
}
else -> throw IllegalArgumentException("Unknown class $modelClass")
} as T
}
}
Мы используем функцию расширения createSavedStateHandle()
на CreationExtras
от SavedStateHandleSupport
, чтобы построить SavedStateHandle
только для одной ViewModel, которая нуждается в этом. ( IA6654 , B/188541057 )
Пользовательские CreationExtras
могут быть предоставлены, переопределяя getDefaultViewModelCreationExtras()
в вашей ComponentActivity
или Fragment
, что делает их доступными для вашего пользовательского ViewModelProvider.Factory
в качестве встроенной формы вспомогательной инъекции. Эти дополнения будут автоматически доступны для вашей пользовательской заводской завод при непосредственном использовании с ViewModelProvider
или при использовании by viewModels()
и by activityViewModels()
расширения свойств Kotlin. ( I79f2b , b/207012584 , b/207012585 , b/207012490 )
Исправление ошибок
- Исправлена проблема, в которой значение по умолчанию, предоставленное для
SavedStateHandle
, появится после смерти и отдыха процесса, даже если оно было специально удалено изSavedStateHandle
. Как следствие этого,SavedStateHandle
больше не будет объединять значения по умолчанию и восстанавливать значения вместе, вместо этого используя только восстановленные значения в качестве источника истины. ( I53a4b )
Версия 2.4
Версия 2.4.1
9 февраля 2022 года
androidx.lifecycle:lifecycle-*:2.4.1
выпущен. Версия 2.4.1 содержит эти коммиты.
Исправление ошибок
- Перекурированный из жизненного цикла
2.5.0-alpha01
: Исправлена проблема, в которой значение по умолчанию, предоставленное дляSavedStateHandle
будет повторно применять после смерти процесса и отдыха, даже если оно было специально удалено изSavedStateHandle
. Как следствие этого,SavedStateHandle
больше не будет объединять значения по умолчанию и восстанавливать значения вместе, вместо этого используя только восстановленные значения в качестве источника истины. ( I53a4b ) -
lifecycle-process
теперь зависит от стартапа Androidx 1.1.1 , который установил регрессию в том случае, где использованиеProcessLifecycleInitializer
может привестиStartupException
. ( B/216490724 )
Версия 2.4.0
27 октября 2021 г.
androidx.lifecycle:lifecycle-*:2.4.0
выпущен. Версия 2.4.0 содержит эти коммиты.
Важные изменения с 2.3.0
-
@OnLifecycleEvent
был устарел. Вместо этого следует использоватьLifecycleEventObserver
илиDefaultLifecycleObserver
. -
androidx.lifecycle:lifecycle-viewmodel-compose
. Он предоставляетviewModel()
Composable иLocalViewModelStoreOwner
.- Изменение источника :
ViewModelProvider
был переписан в Котлин.ViewModelProvider.Factory.create
Метод больше не допускает общий общий.
- Изменение источника :
- Новые API Coroutines были добавлены в
androidx.lifecycle:lifecycle-runtime-ktx
: -
Lifecycle.repeatOnLifecycle
, API, который выполняет блок кода в коратике, когда жизненный цикл, по крайней мере, в определенном состоянии. Блок отменит и повторно запускается, когда жизненный цикл движется в целевом состоянии и выходит из целевого состояния; -
Flow.flowWithLifecycle
, API, который излучает значения из восходящего потока, когда жизненный цикл, по крайней мере, в определенном состоянии. -
DefaultLifecycleObserver
был перемещен изlifecycle.lifecycle-common-java8
вlifecycle.lifecycle-common
.lifecycle.lifecycle-common-java8
больше не предоставляет никаких дополнительных функциональных возможностей на вершинеlifecycle.lifecycle-common
lifecycle.lifecycle-common
- Non Coroutines 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
выпускается без изменений из жизненного цикла 2.4.0-бета01. Версия 2.4.0-RC01 содержит эти коммиты.
Версия 2.4.0-бета01
15 сентября 2021 г.
androidx.lifecycle:lifecycle-*:2.4.0-beta01
выпускается. Версия 2.4.0-бета01 содержит эти коммиты.
Изменения 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 ) - Non Coroutines 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 был переписан в Котлин.
ViewModelProvider.Factory.create
Метод больше не допускает общий общий. ( I9b9f6 )
Изменения поведения
-
Lifecycle.repeatOnLifecycle
:block
теперь всегда используется последовательно при повторении выполнения. ( IBAB33 )
Внешний вклад
- Спасибо Chao2zhang за исправление фрагментов кода в документации
repeatOnLifecycle
. #205 .
Версия 2.4.0-Alpha02
16 июня 2021 г.
androidx.lifecycle:lifecycle-*:2.4.0-alpha02
выпускается. Версия 2.4.0-Alpha02 содержит эти коммиты.
Новые возможности
- Добавлена новая проверка Lint
RepeatOnLifecycleWrongUsage
вlifecycle-runtime-ktx
, который обнаруживает, когдаrepeateOnLifecycle
неправильно используется вonStart()
илиonResume()
. ( 706078 , b/187887400 )
Изменения API
- API
LifecycleOwner.addRepeatingJob
удаляется в пользуLifecycle.repeatOnLifecycle
. ( I4a3a8 ) - Сделайте
ProcessLifecycleInitializer
Public, чтобы другойandroidx.startup.Initializer
S может использовать их в качестве зависимостей. ( I94C31 )
Исправление ошибок
- Исправлена проблема с проверкой LINT
NullSafeMutableLiveData
, когда в поле есть модификаторы. ( #147 , b/183696616 ) - Исправлена еще одна проблема с проверкой Lint
NullSafeMutableLiveData
Lint при использовании дженериков. ( #161 , b/184830263 )
Внешний вклад
- Спасибо Maxsav за улучшение чека
NullSafeMutableLiveData
Lint. ( #147 , b/183696616 ) - Спасибо Kozaxinan за улучшение чека
NullSafeMutableLiveData
Lint. ( #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
, который излучает значения из потока вверх по течению, когда жизненный цикл, по крайней мере, в определенном состоянии с использованием APILifecycle.repeatOnLifecycle
. Это альтернатива также новойLifecycleOwner.addRepeatinJob
API. ( I0f4cd )
Исправление ошибок
- Из жизненного цикла 2.3.1 : правило Lint
NonNullableMutableLiveData
теперь может правильно различаться между полевыми переменными с различной нулямицией. ( B/169249668 )
Жизненный цикл ViewModel Compose Version 1.0.0
Версия 1.0.0-альфа07
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-альфа06
2 июня 2021 года
androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha06
. Версия 1.0.0-alpha06 содержит эти коммиты.
Обновлено, чтобы быть совместимым с Compose Version 1.0.0-beta08
.
Версия 1.0.0-альфа05
18 мая 2021 г.
androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha05
. Версия 1.0.0-alpha05 содержит эти коммиты.
Новые возможности
- Обновлено, чтобы быть совместимым с Compose Version
1.0.0-beta07
.
Исправление ошибок
- Файлы AndroidManifest из UI-test-Manifest и UI-Tooling-Data в настоящее время совместимы с Android 12 ( i6f9de , b/184718994 )
Версия 1.0.0-альфа04
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-альфа03
10 марта 2021 г.
androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha03
. Версия 1.0.0-alpha03 содержит эти коммиты.
Изменения API
-
LocalViewModelStoreOwner.current
теперь возвращает нулевойViewModelStoreOwner
чтобы лучше определить, доступен лиViewModelStoreOwner
в текущей композиции. API, которые требуютViewModelStoreOwner
, например,viewModel()
иNavHost
, все еще бросают исключение, если не установленViewModelStoreOwner
. ( IDF39a )
Версия 1.0.0.0.0.0.0.0.0.0.0.0.0.0.02
24 февраля 2021 г.
androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha02
. Версия 1.0.0-alpha02 содержит эти коммиты.
Изменения API
-
LocalViewModelStoreOwner
теперь имеетprovides
функции, которые можно использовать сCompositionLocalProvider
, заменив APIasProvidableCompositionLocal()
. ( I45d24 )
Жизненный цикл Viewmodel-Compose версии 1.0.0-Alpha01
10 февраля 2021 г.
androidx.lifecycle:lifecycle-viewmodel-compose:1.0.0-alpha01
. Версия 1.0.0-alpha01 содержит эти коммиты.
Новые возможности
- Composable и
LocalViewModelStoreOwner
viewModel()
были перемещены изandroidx.compose.ui.viewinterop
этого артефакта в пакетеandroidx.lifecycle.viewmodel.compose
. ( I7a374 )
Версия 2.3.1
Жизненный цикл версии 2.3.1
24 марта 2021 г.
androidx.lifecycle:lifecycle-*:2.3.1
выпущен. Версия 2.3.1 содержит эти коммиты.
Исправление ошибок
- Правило Lint
NonNullableMutableLiveData
теперь может должным образом различать переменные поля с различной нулямицией. ( B/169249668 )
Версия 2.3.0
Версия 2.3.0
10 февраля 2021 г.
androidx.lifecycle:lifecycle-*:2.3.0
выпущен. Версия 2.3.0 содержит эти коммиты.
Основные изменения с 2.2.0
- Поддержка
SavedStateHandle
для неразовых классов :SavedStateHandle
теперь поддерживает ленивую сериализацию, позволяя вам позвонить вsetSavedStateProvider()
для данного ключа, предоставляяSavedStateProvider
, который получит обратный вызов дляsaveState()
, когдаSavedStateHandle
просят сохранить его состояние. См. Сохранение не-ласковых классов . - Содействие поведению жизненного цикла :
- LifeCyclereGistry в настоящее время обеспечивает
DESTROYED
как терминальное государство. -
LifecycleRegistry
теперь проверяет, что ее методы вызываются в основной поток. Это всегда было требованием для жизненных циклов деятельности, фрагментов и т. Д. Добавление наблюдателей из неэ-мэльных потоков привело к трудностям в сбоях во время выполнения. Для объектовLifecycleRegistry
, которые принадлежат вашим собственным компонентам, вы можете явно отказаться от чеков, используяLifecycleRegistry.createUnsafe(...)
, но затем вы должны убедиться, что правильная синхронизация введена, когда доступна к этойLifecycleRegistry
.
- LifeCyclereGistry в настоящее время обеспечивает
- Помогатели жизни и события жизненного цикла : добавлены статические вспомогательные методы
downFrom(State)
,downTo(State)
,upFrom(State)
,upTo(State)
вLifecycle.Event
для созданияEvent
с учетомState
и направления перехода. Добавлен методgetTargetState()
, который предоставляетState
, что жизненный цикл будет переходить непосредственно послеEvent
. -
withStateAtLeast
: Добавлен APILifecycle.withStateAtLeast
, которые ожидают состояния жизненного цикла и запускают не подвижный блок кодового синхронного в точке состояния, а затем возобновите с результатом. Эти API отличаются отwhen*
методов, поскольку они не разрешают запуск приостановленного кода и не используют пользовательский диспетчер. ( AOSP/1326081 ) - API
ViewTree
: новыйViewTreeLifecycleOwner.get(View)
иViewTreeViewModelStoreOwner.get(View)
API позволяет получить содержащийLifecycleOwner
иViewModelStoreOwner
, соответственно, с учетом экземпляраView
. Вы должны перейти на действие1.2.0
и фрагмент1.3.0
, а также AppCompat 1.3.0-Alpha01 или выше, чтобы правильно заполнить это.findViewTreeLifecycleOwner
иfindViewTreeViewModelStoreOwner
Kotlin расширения доступны вlifecycle-runtime-ktx
иlifecycle-viewmodel-ktx
, соответственно. -
LiveData.observe()
Увеличение удлинения котлина : расширениеLiveData.observe()
Kotlin, необходимое для использования синтаксиса Lambda, теперь устарело, поскольку это не требуется при использовании Kotlin 1.4.
Версия 2.3.0-RC01
16 декабря 2020 г.
androidx.lifecycle:lifecycle-*:2.3.0-rc01
выпускается. Версия 2.3.0-RC01 содержит эти коммиты.
Исправление ошибок
- Метод
keys()
SavedStateHandle
теперь согласован до и после сохранения состояния - теперь он включает в себя клавиши, ранее используемые сsetSavedStateProvider()
в дополнение к ключам, используемым сset()
иgetLiveData()
. ( AOSP/1517919 , B/174713653 )
Внешний вклад
- API, чтобы приостановить коратики с учетом жизненного цикла, теперь лучше обрабатывают вызовы
yield()
. Спасибо Никлас Ансман Джурц! ( AOSP/1430830 , B/168777346 )
Версия 2.3.0-бета01
1 октября 2020 г.
androidx.lifecycle:lifecycle-*:2.3.0-beta01
выпускается. Версия 2.3.0-бета01 содержит эти коммиты.
Изменения API
- Расширение Kotlin
LiveData.observe()
, необходимое для использования синтаксиса Lambda, теперь устарело, поскольку это не требуется при использовании Kotlin 1.4. ( I40d3f )
Исправление ошибок
- Обновление Androidx для использования Kotlin 1.4 ( ID6471 , B/165307851 , B/165300826 )
КОМЕНТАЦИЯ ИЗМЕНЕНИЯ
- Документы
liveData
Builder иasLiveData()
были обновлены, чтобы включить подробности об изменении заданных значений тайм -аута. ( AOSP/1122324 )
Версия 2.3.0-Alpha07
19 августа 2020 г.
androidx.lifecycle:lifecycle-*:2.3.0-alpha07
выпускается. Версия 2.3.0-Alpha07 содержит эти коммиты.
Исправление ошибок
- Исправлена проблема с аварией в чек на
NullSafeMutableLiveData
lint. ( AOSP/1395367 )
Версия 2.3.0-Alpha06
22 июля 2020 г.
androidx.lifecycle:lifecycle-*:2.3.0-alpha06
выпускается. Версия 2.3.0-Alpha06 содержит эти коммиты.
Новые возможности
- Добавлены статические вспомогательные методы
downFrom(State)
,State
downTo(State)
,upFrom(State)
,upTo(State)
Event
Lifecycle.Event
. Добавлен метод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
для чеков с ворсом, связанными с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
теперь охватывает значительно больше случаев, когда наMutableLiveData
было установлено значениеnull
значения с параметрам не нулевого типа. ( б/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
. Вы должны перейти на активность1.2.0-alpha05
, фрагмент1.3.0-alpha05
и Appcompat1.3.0-alpha01
чтобы правильно заполнить это. Расширение KotlinfindViewModelStoreOwner()
было добавлено вlifecycle-viewmodel-ktx
. ( AOSP/1295522 )
Исправление ошибок
- Исправлена проблема, которая привела к тому, что чеки Lint
MutableLiveData
, выпущенные в жизненном цикле2.3.0-alpha01
были опубликованы вместе с артефактомlifecycle-livedata-core-ktx
. ( B/155323109 )
Версия 2.3.0-Alpha02
29 апреля 2020 г.
androidx.lifecycle:lifecycle-*:2.3.0-alpha02
выпускается. Версия 2.3.0-Alpha02 содержит эти коммиты.
Изменения API
-
SavedStateViewModelFactory
теперь позволяет вам передавать нулевоеApplication
к своему конструктору для лучшей поддержки случаев, когда кто -то недоступен, и поддержкаAndroidViewModel
не нужна. ( AOSP/1285740 )
Исправление ошибок
- Улучшенная производительность холодного запуска, избегая сбоя проверки класса на API 28 и нижних устройствах. ( AOSP/1282118 )
Версия 2.3.0-Alpha01
4 марта 2020 г.
androidx.lifecycle:lifecycle-*:2.3.0-alpha01
выпускается. Версия 2.3.0-Alpha01 содержит эти коммиты.
Новые возможности
- Новый API
ViewTreeLifecycleOwner.get(View)
позволяет получить содержащийLifecycleOwner
учитывая экземплярView
. Вы должны перейти на действие1.2.0-alpha01
и фрагмент1.3.0-alpha01
чтобы правильно заполнить это.findViewTreeLifecycleOwner
Kotlin Extension доступен вlifecycle-runtime-ktx
. ( AOSP/1182361 , AOSP/1182956 ) - Добавлена новая проверка Lint, которая предупреждает вас при установлении
null
значения наMutableLiveData
, которая была определена в Котлине как не нулевой. Это доступно при использовании артефактов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 SaveState теперь имеет ту же версию, что и другие артефакты жизненного цикла. Поведение 2.2.0
идентично поведению 1.0.0
.
Версия 2.2.0
22 января 2020 г.
androidx.lifecycle:lifecycle-*:2.2.0
выпущен. Версия 2.2.0 содержит эти коммиты .
Важные изменения с 2,1,0
- Интеграция жизненного цикла Coroutine : Новый артефакт
lifecycle-runtime-ktx
добавляет интеграцию между жизненным циклом и коратиками Kotlin.lifecycle-livedata-ktx
также был расширен, чтобы воспользоваться CORUTINES. См. Используйте коратики Kotlin с компонентами архитектуры для получения более подробной информации. -
ViewModelProviders.of()
Tempercation :ViewModelProviders.of()
устарел. Вы можете передатьFragment
илиFragmentActivity
конструктору NewViewModelProvider(ViewModelStoreOwner)
для достижения той же функциональности при использовании фрагмента1.2.0
. - Исключение артефактов
lifecycle-extensions
: с приведенной выше устаревшейViewModelProviders.of()
этот выпуск знаменует собой снижение последнего API вlifecycle-extensions
, и этот артефакт теперь следует считать в его полной ситуации. Мы настоятельно рекомендуем в зависимости от конкретных артефактов жизненного цикла, которые вам нужны (например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 содержит эти коммиты .
Исправление ошибок
- Исправлена сбой, возникающий, когда в
ViewModelStore
хранился издевательнаяViewModel
и запрашивалась позже на фабрике по умолчанию. - Исправьте использование
Dispatchers.Main.immediate
вlaunchWhenCreated
. ( AOSP/1156203 )
Внешние взносы
- Спасибо Андерсу Ярлебергу за то, что внесли свой вклад! ( AOSP/1156203 )
- Благодаря Vsevolod tolstopyatov из Jetbrains за просмотр реализации вставленного выполнения.
Изменения зависимости
- Расширения жизненного цикла теперь зависит от фрагмента
1.2.0-rc03
.
Версия 2.2.0-RC02
7 ноября 2019 г.
androidx.lifecycle:lifecycle-*:2.2.0-rc02
выпущен. Версия 2.2.0-RC02 содержит эти коммиты .
Исправление ошибок
- Исправлена ошибка в настройке прогарда библиотеки, которая затронула устройства, управляющие API 28+, если целевой API ниже 29. ( B/142778206 )
Версия 2.2.0-RC01
23 октября 2019 г.
androidx.lifecycle:lifecycle-*:2.2.0-rc01
выпускается. Версия 2.2.0-RC01 содержит эти коммиты .
Исправление ошибок
- Fixed an issue where
launchWhenCreated
and related methods would run one frame later than the associated lifecycle method due to its use ofDispatchers.Main
instead ofDispatchers.Main.immediate
. ( aosp/1145596 )
External contributions
- Thanks to Nicklas Ansman for contributing the fix! ( aosp/1145596 )
Version 2.2.0-beta01
9 октября 2019 г.
androidx.lifecycle:lifecycle-*:2.2.0-beta01
is released. Version 2.2.0-beta01 contains these commits .
Исправление ошибок
- Fixed a regression introduced in Lifecycle 2.2.0-alpha05 in the ordering of
ProcessLifecycleOwner
and the activity'sLifecycleOwner
moving to started and resumed on Android 10 devices. ( aosp/1128132 ) - Fixed a regression introduced in Lifecycle
2.2.0-alpha05
which would cause aNullPointerException
when using version2.0.0
or2.1.0
oflifecycle-process
. ( b/141536990 )
Version 2.2.0-alpha05
September 18, 2019
androidx.lifecycle:lifecycle-*:2.2.0-alpha05
is released. Version 2.2.0-alpha05 contains these commits .
Исправление ошибок
- Fixed a race condition in coroutine livedata builder. b/140249349
Version 2.2.0-alpha04
5 сентября 2019 г.
androidx.lifecycle:lifecycle-*:2.2.0-alpha04
is released. The commits included in this version can be found here .
Новые возможности
-
lifecycleScope
,whenCreated
,whenStarted
,whenResumed
,viewModelScope
, and the underlying implementation ofliveData
now useDispatchers.Main.immediate
instead ofDispatchers.Main
. ( b/139740492 )
External contributions
- Thanks to Nicklas Ansman for contributing the move to
Dispatchers.Main.immediate
! ( aosp/1106073 )
Version 2.2.0-alpha03
August 7, 2019
androidx.lifecycle:lifecycle-*:2.2.0-alpha03
is released. The commits included in this version can be found here .
Новые возможности
- Implementations of
ViewModelStoreOwner
can now optionally implementHasDefaultViewModelProviderFactory
to provide a defaultViewModelProvider.Factory
. This has been done for Activity1.1.0-alpha02
, Fragment1.2.0-alpha02
, and Navigation2.2.0-alpha01
. ( aosp/1092370 , b/135716331 )
API changes
-
ViewModelProviders.of()
has been deprecated. You can pass aFragment
orFragmentActivity
to the newViewModelProvider(ViewModelStoreOwner)
constructor to achieve the same functionality. ( aosp/1009889 )
Version 2.2.0-alpha02
July 2, 2019
androidx.lifecycle:*:2.2.0-alpha02
is released. The commits included in this version can be found here .
API changes
- Replaced
LiveDataScope.initialValue
withLiveDataScope.latestValue
which will track the current emitted value of theliveData
block. - Added a new overload to the
liveData
builder that receivestimeout
parameter as typeDuration
Version 2.2.0-alpha01
7 мая 2019 г.
androidx.lifecycle:*:2.2.0-alpha01
is released. The commits included in this version can be found here .
Новые возможности
- This release adds new features that adds support for Kotlin coroutines for Lifecycle and LiveData. Detailed documentation on them can be found here .
ViewModel-SavedState Version 1.0.0
Версия 1.0.0
22 января 2020 г.
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0
is released. Version 1.0.0 contains these commits .
Important features in 1.0.0
- New SavedStateHandle class was added. It enables your
ViewModel
classes to access and to contribute to the saved state. This object can be received in constructor ofViewModel
class and factories provided by default by Fragments and AppCompatActivity will injectSavedStateHandle
automatically. - AbstractSavedStateViewModelFactory was added. It allows you to create custom factories for your
ViewModel
and provide them access toSavedStateHandle
.
ViewModel-Savedstate Version 1.0.0-rc03
4 декабря 2019 г.
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-rc03
is released. Version 1.0.0-rc03 contains these commits .
Dependency changes
- Lifecycle ViewModel SavedState now depends on Lifecycle
2.2.0-rc03
.
Viewmodel-Savedstate Version 1.0.0-rc02
7 ноября 2019 г.
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-rc02
is released. Version 1.0.0-rc02 contains these commits .
Dependency changes
- Now depends on lifecycle
2.2.0-rc02
.
ViewModel-SavedState Version 1.0.0-rc01
23 октября 2019 г.
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-rc01
is released with no changes from 1.0.0-beta01
. Version 1.0.0-rc01 contains these commits .
ViewModel-Savedstate Version 1.0.0-beta01
9 октября 2019 г.
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-beta01
is released. Version 1.0.0-beta01 contains these commits .
Исправление ошибок
- Fixed an issue where accessing a SavedState ViewModel for the first time in
Activity.onActivityResult()
would result in anIllegalStateException
. ( b/139093676 ) - Fixed an
IllegalStateException
when usingAbstractSavedStateViewModelFactory
. ( b/141225984 )
ViewModel-SavedState Version 1.0.0-alpha05
September 18, 2019
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha05
is released. Version 1.0.0-alpha05 contains these commits .
API changes
-
SavedStateViewModelFactory
no longer extendsAbstractSavedStateViewModelFactory
andSavedStateHandle
is created only for ViewModels that requested have it ( aosp/1113593 )
ViewModel-SavedState Version 1.0.0-alpha03
August 7, 2019
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha03
is released. The commits included in this version can be found here .
Breaking Changes
-
lifecycle-viewmodel-savedstate
no longer depends onfragment
and the relatedSavedStateViewModelFactory(Fragment)
andSavedStateViewModelFactory(FragmentActivity)
constructors have been removed. Instead,SavedStateViewModelFactory
is now the default factory for Activity1.1.0-alpha02
, Fragment1.2.0-alpha02
, and Navigation2.2.0-alpha01
. ( b/135716331 )
ViewModel-SavedState Version 1.0.0-alpha02
July 2, 2019
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha02
is released. The commits included in this version can be found here .
Новые возможности
- Added
SavedStateHandle.getLiveData()
overload which accepts a default value.
Изменения API
-
SavedStateVMFactory
is renamed toSavedStateViewModelFactory
. -
AbstractSavedStateVMFactory
is renamed toAbstractSavedStateViewModelFactory
.
ViewModel-Savedstate Version 1.0.0-alpha01
March 13, 2019
androidx.lifecycle:lifecycle-viewmodel-savedstate:1.0.0-alpha01
is released. The full commit log for this initial release can be found here .
Новые возможности
- Now
ViewModels
can contribute to savedstate. To do that you use newly introduced viewmodel's factorySavedStateVMFactory
and your ViewModel should have a constructor that receivesSavedStateHandle
object as a parameter.
Version 2.1.0
Important changes since 2.0.0
- Added
LifecycleEventObserver
for the cases when a stream of lifecycle events is needed. It is a public API instead of a hiddenGenericLifecycleObserver
class. - Added ktx extensions for
LiveData.observe
methods andTransformations.*
methods. - Added
Transformations.distinctUntilChanged
, which creates a new LiveData object that does not emit a value until the sourceLiveData
value has been changed. - Added coroutine support in ViewModels by adding the extension property
ViewModel.viewModelScope
.
Version 2.1.0
5 сентября 2019 г.
androidx.lifecycle:lifecycle-*:2.1.0
is released. The commits included in this version can be found here .
Version 2.1.0-rc01
July 2, 2019
androidx.lifecycle:*:2.1.0-rc01
is released with no changes from androidx.lifecycle:*:2.1.0-beta01
. The commits included in this version can be found here .
Version 2.1.0-beta01
7 мая 2019 г.
androidx.lifecycle:*:2.1.0-beta01
is released. The commits included in this version can be found here .
Новые возможности
- Lifecycles are graduated to beta: api introduced in previous alphas such as
liveData
extension functions for transformations and observations,ViewModel
initialisation with property delegation and others are stabilised and not going to change.
Version 2.1.0-alpha04
3 апреля 2019 г.
androidx.lifecycle:*:2.1.0-alpha04
is released. The commits included in this version can be found here .
API changes
- Breaking change: the underlying API behind
by viewModels()
andby activityViewModels()
has been changed to support aViewModelStore
directly, rather than only aViewModelStoreOwner
. ( aosp/932932 )
Version 2.1.0-alpha03
March 13, 2019
androidx.lifecycle:*:2.1.0-alpha03
is released. The full list of commits included in this version can be found here .
API changes
-
ViewModelProvider.KeyedFactory
was removed. Second interface in addition toViewModelProvider.Factory
didn't compose well with new features as property delegation in Kotlinby viewmodels {}
. ( aosp/914133 )
Version 2.1.0-alpha02
30 января 2019 г.
androidx.lifecycle 2.1.0-alpha02
is released.
API changes
-
LifecycleRegistry
now contains asetCurrentState()
method that replaces the now deprecatedsetState()
method. ( aosp/880715 )
Исправление ошибок
- Fixed an issue where mock
ViewModel
instances would crash when the containingViewModelStore
was cleared. b/122273087
Version 2.1.0-alpha01
December 17, 2018
androidx.lifecycle 2.1.0-alpha01
is released.
Новые возможности
- Added
LifecycleEventObserver
for the cases when a stream of lifecycle events is needed. It is a public api instead of a hiddenGenericLifecycleObserver
class. - Added ktx extensions for
LiveData.observe
methods andTransformations.*
methods. - Method
Transformations.distinctUntilChanged
was added. It creates a newLiveData
object that does not emit a value until the source LiveData value has been changed. - Coroutine support in ViewModels: extension property
ViewModel.viewModelScope
was added. - Added
ViewModelProvider.KeyedFactory
, a factory for ViewModels that receiveskey
andClass
increate
method.
Version 2.0.0
Version 2.0.0
September 21, 2018
Lifecycle 2.0.0
is released with one bugfix from 2.0.0-rc01
in ViewModel.
Исправление ошибок
- Fixed a ViewModel proguard rule that incorrectly removed constructors b/112230489
Version 2.0.0-beta01
2 июля 2018 г.
Исправление ошибок
- Fixed LifecycleObserver proguard rule to keep only implementations, not subinterfaces b/71389427
- Fixed ViewModel proguard rules to allow obfuscation and shrinking
Pre-AndroidX Versions
For the pre-AndroidX versions of Lifecycle that follow, include these dependencies:
dependencies {
def lifecycle_version = "1.1.1"
// ViewModel and LiveData
implementation "android.arch.lifecycle:extensions:$lifecycle_version"
// alternatively - just ViewModel
implementation "android.arch.lifecycle:viewmodel:$lifecycle_version" // For Kotlin use viewmodel-ktx
// alternatively - just LiveData
implementation "android.arch.lifecycle:livedata:$lifecycle_version"
// alternatively - Lifecycles only (no ViewModel or LiveData).
// Support library depends on this lightweight import
implementation "android.arch.lifecycle:runtime:$lifecycle_version"
annotationProcessor "android.arch.lifecycle:compiler:$lifecycle_version" // For Kotlin use kapt instead of annotationProcessor
// alternately - if using Java8, use the following instead of compiler
implementation "android.arch.lifecycle:common-java8:$lifecycle_version"
// optional - ReactiveStreams support for LiveData
implementation "android.arch.lifecycle:reactivestreams:$lifecycle_version"
// optional - Test helpers for LiveData
testImplementation "android.arch.core:core-testing:$lifecycle_version"
}
Версия 1.1.1
21 марта 2018 г.
Only one small change: android.arch.core.util.Function
is moved from arch:runtime
to arch:common
. This allows it to be used without the runtime dependency, eg in paging:common
below.
lifecycle:common
is a dependency of lifecycle:runtime
, so this change doesn't affect lifecycle:runtime
directly, only modules that depend directly on lifecycle:common
, as Paging does.
Версия 1.1.0
January 22, 2018
Packaging Changes
New, much smaller dependencies are now available:
-
android.arch.lifecycle:livedata:1.1.0
-
android.arch.lifecycle:viewmodel:1.1.0
Изменения API
- The deprecated
LifecycleActivity
andLifecycleFragment
have now been removed - please useFragmentActivity
,AppCompatActivity
or supportFragment
. -
@NonNull
annotations have been added toViewModelProviders
andViewModelStores
-
ViewModelProviders
constructor has been deprecated - please use its static methods directly -
ViewModelProviders.DefaultFactory
has been deprecated - please useViewModelProvider.AndroidViewModelFactory
- The static
ViewModelProvider.AndroidViewModelFactory.getInstance(Application)
method has been added to retrieve a staticFactory
suitable for creatingViewModel
andAndroidViewModel
instances.