Android Academy · Урок

collectAsStateWithLifecycle

Безопасно собирайте потоки с учётом жизненного цикла

«collectAsStateWithLifecycle» — бесплатный урок Android Academy на CoddyKit. Это урок 4 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Android Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Android Academy содержит 4 уроков всего.

Безопасный сбор потоков

Когда компонуемая функция собирает поток, в идеале она должна прекращать сбор, пока экран находится в фоновом режиме, и возобновлять его после возвращения.

Для этого используется collectAsStateWithLifecycle().

Проблема collectAsState

Обычный collectAsState() продолжает сбор, пока компонуемая функция находится в композиции, — даже когда приложение работает в фоновом режиме.

Это может расходовать ресурсы и обрабатывать обновления, которые пользователь не видит.

Знакомьтесь: collectAsStateWithLifecycle

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

import androidx.lifecycle.compose.collectAsStateWithLifecycle

@Composable
fun Screen(vm: MyViewModel) {
    val state by vm.uiState
        .collectAsStateWithLifecycle()
    Text(state.title)
}

Зависимость

Она находится в артефакте androidx.lifecycle:lifecycle-runtime-compose. Добавьте его в свой модуль, чтобы импорт разрешился.

// build.gradle (module)
implementation(
  "androidx.lifecycle:lifecycle-runtime-compose:2.x.x"
)

Минимальное состояние по умолчанию: STARTED

По умолчанию сбор активен, пока жизненный цикл находится в состоянии STARTED или выше, то есть экран видим. Когда экран переходит в фоновый режим (ниже STARTED), сбор приостанавливается.

Настройка минимального состояния

Вы можете изменить порог с помощью minActiveState, например установить RESUMED.

val state by vm.uiState.collectAsStateWithLifecycle(
    minActiveState = Lifecycle.State.RESUMED
)

Сочетание с StateFlow

Это отлично работает с StateFlow, который Вы предоставляете из ViewModel. Поток всегда содержит текущее значение, поэтому повторный сбор мгновенно показывает последнее состояние.

private val _uiState = MutableStateFlow(UiState())
val uiState = _uiState.asStateFlow()

Почему это экономит ресурсы

Если Ваш поток запускает ресурсоёмкие вычисления (фильтрацию большого списка, преобразование потоков), приостановка сбора в фоновом режиме означает, что эта работа просто не выполняется, пока пользователь отсутствует.

Сочетание с viewModelScope

На стороне источника ViewModel часто выполняет свой конвейер обработки данных в viewModelScope. С помощью stateIn можно даже остановить исходный поток, когда сборщиков не осталось.

val uiState = repository.stream()
    .stateIn(
        scope = viewModelScope,
        started = SharingStarted.WhileSubscribed(5000),
        initialValue = UiState()
    )

Объяснение WhileSubscribed

WhileSubscribed(5000) поддерживает исходный поток активным в течение 5 секунд после ухода последнего сборщика. Это предотвращает перезапуск работы при кратковременных изменениях конфигурации и всё же останавливает её, когда пользователь действительно уходит.

Краткое описание рекомендуемого подхода

Для экранов Compose, работающих с ViewModel:

Предоставляйте StateFlow.
Собирайте его с помощью collectAsStateWithLifecycle().
При необходимости используйте выше по потоку stateIn(WhileSubscribed).

Быстрая проверка

Проверьте, насколько хорошо Вы поняли сбор с учётом жизненного цикла.

Повторение

Вы узнали:

collectAsStateWithLifecycle() приостанавливает сбор в фоновом режиме.
Порог по умолчанию — STARTED; его можно изменить через minActiveState.
Сочетайте его с StateFlow и stateIn(WhileSubscribed), чтобы получить эффективный конвейер обработки данных.

Часто задаваемые вопросы

Урок «collectAsStateWithLifecycle» бесплатный?

Да — полный текст урока «collectAsStateWithLifecycle» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Android Academy, подпишись на CoddyKit PRO. Курс Android Academy содержит 4 уроков всего.

Чему я научусь в уроке «collectAsStateWithLifecycle»?

Безопасно собирайте потоки с учётом жизненного цикла Ты практикуешь Android Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Android Academy?

Предыдущий опыт не требуется. Android Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 4 из 4.

Сколько времени занимает урок «collectAsStateWithLifecycle»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Android Academy?

Да. Каждый урок Android Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к Android Academy