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に低下すると、スコープはキャンセルされます。

Lifecycleの状態

lifecycleScopeの内部構造

lifecycleScopeはCoroutineScope(SupervisorJob() + Dispatchers.Main.immediate)として作成され、Lifecycle内に格納されます。LifecycleがDESTROYED状態に移行すると、scope.cancel()が呼び出されます。このメカニズムはLifecycleEventObserverを介して実装され、スコープへの最初のアクセス時にライフサイクルイベントを購読します。

回転時の動作

画面が回転すると、Activityは破棄（onDestroy）され、再作成されます。lifecycleScopeは古いActivityとともにキャンセルされ、新しいActivityに対して新しいスコープインスタンスが作成されます。これは、回転後も存続する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の3つの実際のシナリオを見てみましょう。

例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：使用シナリオ

両方のスコープはライフサイクルにバインドされていますが、その異なる側面にバインドされています。違いを理解することは、Androidアプリケーションの適切なアーキテクチャにとって重要です。

主な違い

viewModelScopeはViewModelにバインドされており、画面の回転後も存続します。lifecycleScopeはLifecycleOwner（Activity/Fragment）にバインドされており、回転時に破棄され再作成されます。これによって使用シナリオが決まります。

lifecycleScopeを使用する場合

• システムイベントの購読（位置情報、センサー、カメラ）
• 特定の画面に紐づくアニメーションやUI効果
• 画面の表示状態に基づくチャンクデータ読み込み
• 画面を離れるときに停止すべき操作

viewModelScopeを使用する場合

• Repositoryからのデータ読み込み
• 回転後も存続すべきビジネスロジック
• データのキャッシュと処理
• 回転後に結果が必要な操作

組み合わせ使用

実際には、両方のスコープの組み合わせが一般的です：viewModelScopeがデータを読み込み状態を管理し、lifecycleScopeがライフサイクルを意識してViewModelからのFlowを購読します。この責任の分離は、現代のAndroid開発においてベストプラクティスと見なされています。

lifecycleScope使用時のよくある間違い

lifecycleScopeを使用する際に開発者が犯す4つの最も一般的な間違いを見てみましょう。

間違い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と同期する唯一の正しい方法です。