lifecycleScope — 개념, Lifecycle 연동 및 Android에서의 활용

Android에서 lifecycleScope란?

lifecycleScope는 LifecycleOwner 인터페이스(Activity, Fragment, Service)의 확장 속성으로, 구성 요소의 전체 수명 주기에 바인딩된 즉시 사용 가능한 CoroutineScope를 제공합니다. LifecycleOwner가 DESTROYED 상태에 도달하면 lifecycleScope는 활성 코루틴을 모두 자동으로 취소합니다.

// In Fragment or Activity
lifecycleScope.launch {
    delay(1000)
    showSnackbar("안녕하세요!")
}

viewModelScope와 달리 lifecycleScope는 LifecycleOwner가 소멸될 때마다 취소됩니다(화면 회전 포함). 따라서 특정 화면이 표시되는 동안만 유지되어야 하는 작업에 이상적입니다.

lifecycleScope를 사용할 수 있는 곳

lifecycleScope는 LifecycleOwner가 있는 모든 곳에서 사용할 수 있습니다:

• Activity — AppCompatActivity가 LifecycleOwner를 상속
• Fragment — Fragment가 LifecycleOwner를 상속
• LifecycleService — 수명 주기가 있는 서비스
• ProcessLifecycleOwner — 전체 애플리케이션의 수명 주기
• 커스텀 LifecycleOwner — LifecycleOwner를 구현하는 모든 객체

lifecycleScope 작동 방식: Lifecycle 및 자동 취소

lifecycleScope의 자동 취소 메커니즘은 Lifecycle 이벤트 구독을 기반으로 합니다. Lifecycle이 CREATED 아래로 DESTROYED로 떨어지면 Scope가 취소됩니다.

Lifecycle 상태

lifecycleScope의 내부 구조

lifecycleScope는 CoroutineScope(SupervisorJob() + Dispatchers.Main.immediate)로 생성되어 Lifecycle 내부에 저장됩니다. Lifecycle이 DESTROYED 상태로 전환되면 scope.cancel()이 호출됩니다. 이 메커니즘은 Scope에 처음 액세스할 때 수명 주기 이벤트를 구독하는 LifecycleEventObserver를 통해 구현됩니다.

회전 시 동작

화면이 회전되면 Activity가 소멸(onDestroy)되고 다시 생성됩니다. lifecycleScope는 이전 Activity와 함께 취소되고 새 Activity를 위해 새 Scope 인스턴스가 생성됩니다. 이는 회전 시 유지되는 viewModelScope와의 근본적인 차이점입니다.

lifecycleScope API: launch, launchWhen 및 repeatOnLifecycle

lifecycle 라이브러리는 lifecycleScope를 통해 코루틴을 실행하는 여러 방법을 제공합니다. 더 이상 사용되지 않는 메서드에서 최신 API로의 진화를 살펴보겠습니다.

lifecycleScope.launch — 기본 실행

가장 간단한 방법은 lifecycleScope.launch { ... }입니다. 코루틴이 즉시 시작되고 DESTROYED에서 취소됩니다. 그러나 UI가 표시되지 않는 경우에도 코드를 실행할 수 있습니다(onStop 후 백그라운드 등). 이것이 항상 바람직한 것은 아닙니다.

더 이상 사용되지 않음: launchWhenCreated / launchWhenStarted / launchWhenResumed

이 메서드들은 Lifecycle이 지정된 상태 아래로 떨어지면 코루틴 실행을 일시 중지하고 돌아오면 재개했습니다. 그러나 lifecycle-runtime-ktx 2.6.0에서 @Deprecated로 표시되었습니다. 이유는:

• 코루틴을 취소하지 않고 일시 중지만 함
• 메모리를 소비하는 일시 중단된 코루틴이 축적됨
• 빠른 상태 전환 시 경합 상태가 발생함

최신 API: repeatOnLifecycle

repeatOnLifecycle은 Google이 권장하는 수명 주기와 동기화된 코루틴 실행 방식입니다. Lifecycle이 지정된 상태에 도달할 때마다 코루틴을 취소하고 다시 시작합니다.

lifecycleScope.launch {
    repeatOnLifecycle(Lifecycle.State.STARTED) {
        viewModel.uiState.collect { state ->
            updateUI(state)
        }
    }
}

repeatOnLifecycle에 전달된 코루틴은 Lifecycle이 STARTED에 도달하면 시작되고 STARTED 아래로 떨어지면 취소됩니다. STARTED로 돌아오면 코루틴이 처음부터 다시 시작됩니다. 이는 안전하고 효율적입니다 — 일시 중단된 코루틴이 남지 않습니다.

flowWithLifecycle — Flow용

수명 주기를 인식하며 Flow에서 데이터를 수집하려면 flowWithLifecycle 연산자가 있습니다. Lifecycle 상태가 변경되면 자동으로 수집을 중지하고 재개합니다:

viewModel.uiState
    .flowWithLifecycle(lifecycle, Lifecycle.State.STARTED)
    .onEach { state -> updateUI(state) }
    .launchIn(lifecycleScope)

flowWithLifecycle 연산자는 UI 계층에서 Flow를 안전하게 구독하는 가장 간결한 방법입니다.

lifecycleScope 사용 예제

Kotlin을 사용한 Android 애플리케이션에서 lifecycleScope의 세 가지 실제 시나리오를 살펴보겠습니다.

예제 1: 화면이 표시될 때만 위치 업데이트 구독

class MapFragment : Fragment() {

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)

        lifecycleScope.launch {
            repeatOnLifecycle(Lifecycle.State.STARTED) {
                locationProvider.observeLocation().collect { loc ->
                    updateMapMarker(loc)
                }
            }
        }
    }
}

코루틴은 프래그먼트가 표시될 때(STARTED) 시작되고 화면을 떠날 때(STOPPED) 취소됩니다. 사용자가 다른 앱으로 전환하면 위치 업데이트가 배터리를 소모하지 않습니다.

예제 2: 프래그먼트 시작 시 애니메이션 실행

lifecycleScope.launch {
    repeatOnLifecycle(Lifecycle.State.RESUMED) {
        animateFadeIn(titleView)
        delay(200)
        animateSlideUp(contentView)
    }
}

애니메이션은 프래그먼트가 포그라운드에 있을 때만(RESUMED) 실행됩니다. 애니메이션 중에 사용자가 앱을 최소화하면 코루틴이 취소되고 돌아오면 애니메이션이 다시 시작됩니다.

예제 3: 표시 화면에서 주기적 데이터 동기화

lifecycleScope.launch {
    repeatOnLifecycle(Lifecycle.State.STARTED) {
        while (isActive) {
            syncData()
            delay(30_000L)
        }
    }
}

데이터는 30초마다 동기화되지만 화면이 표시될 때만 동기화됩니다. isActive는 코루틴이 취소되었는지 확인하여 화면을 떠날 때 루프에서 안전하게 빠져나올 수 있는 방법을 제공합니다.

lifecycleScope vs viewModelScope: 사용 시나리오

두 Scope 모두 수명 주기에 바인딩되어 있지만 다른 측면에 바인딩되어 있습니다. 차이점을 이해하는 것은 올바른 Android 애플리케이션 아키텍처에 중요합니다.

주요 차이점

viewModelScope는 화면 회전 시 유지되는 ViewModel에 바인딩됩니다. lifecycleScope는 회전 시 소멸되고 다시 생성되는 LifecycleOwner(Activity/Fragment)에 바인딩됩니다. 이에 따라 사용 시나리오가 결정됩니다.

lifecycleScope를 사용해야 하는 경우

• 시스템 이벤트 구독(위치, 센서, 카메라)
• 특정 화면에 바인딩된 애니메이션 및 UI 효과
• 화면 가시성에 기반한 청크 데이터 로딩
• 화면을 떠날 때 중지되어야 하는 작업

viewModelScope를 사용해야 하는 경우

• Repository에서 데이터 로딩
• 회전 시 유지되어야 하는 비즈니스 로직
• 데이터 캐싱 및 처리
• 회전 후 결과가 필요한 모든 작업

결합 사용

실제로는 두 Scope의 조합이 일반적입니다: viewModelScope가 데이터를 로드하고 상태를 관리하며 lifecycleScope가 수명 주기를 인식하여 ViewModel의 Flow를 구독합니다. 이러한 책임 분리는 현대 Android 개발에서 모범 사례로 간주됩니다.

lifecycleScope 사용 시 흔한 실수

lifecycleScope 사용 시 개발자들이 흔히 저지르는 네 가지 실수를 살펴보겠습니다.

실수 1: 데이터 로딩에 viewModelScope 대신 lifecycleScope 사용

lifecycleScope.launch에서 데이터 로딩을 시작하면 화면 회전 시 코루틴이 취소되어 데이터를 다시 로드해야 합니다. 장기 실행 작업에는 viewModelScope를 사용하세요. lifecycleScope는 UI에 바인딩된 작업에만 사용합니다.

실수 2: repeatOnLifecycle 없이 Flow 수집

lifecycleScope.launch 내에서 직접 viewModel.someFlow.collect { ... }를 호출하면 화면이 표시되지 않을 때도 데이터 수집이 계속됩니다. 이로 인해 백그라운드에서 UI 업데이트와 불필요한 오버헤드가 발생할 수 있습니다. 항상 repeatOnLifecycle 또는 flowWithLifecycle을 사용하세요.

실수 3: 화면을 떠날 때 취소를 잊음

lifecycleScope는 DESTROYED에서 취소되지만 갑작스러운 취소 시 일시 중단 지점 이후의 코드가 실행되지 않을 수 있습니다. NonCancellable을 사용하지 않는 한 일시 중단 호출 후의 코드 실행에 의존하지 마세요.

실수 4: repeatOnLifecycle 대신 더 이상 사용되지 않는 launchWhenStarted 사용

launchWhenStarted와 그 유사 메서드는 코루틴을 취소하지 않고 일시 중지만 합니다. 화면이 포그라운드와 백그라운드를 여러 번 전환하면 코루틴이 지연된 호출을 축적합니다. repeatOnLifecycle로 전환하세요 — 이것이 Lifecycle과 동기화하는 유일한 올바른 방법입니다.