[G1-Sync] Manual knowledge update

10_Wiki/Topics/Coding/Android_Flow_StateFlow_SharedFlow.md

@@ -0,0 +1,103 @@
+---
+id: android-flow-stateflow-sharedflow
+title: Flow / StateFlow / SharedFlow — 어떤 걸 언제
+category: Coding
+status: draft
+source_trust_level: B
+verification_status: conceptual
+created_at: 2026-05-09
+updated_at: 2026-05-09
+tags: [android, kotlin, flow, vibe-coding]
+tech_stack: { language: "Kotlin Coroutines", applicable_to: ["Android", "Server"] }
+applied_in: []
+aliases: [cold flow, hot flow, replay, state vs event]
+---
+
+# Flow / StateFlow / SharedFlow
+
+> 셋 다 비동기 stream 이지만 의미 다름: **Flow = 1회성 cold**, **StateFlow = 현재 상태 (hot, 1 replay)**, **SharedFlow = 이벤트 버스 (hot, configurable replay)**. 잘못 고르면 이벤트 손실 또는 중복 emit.
+
+## 📖 핵심 개념
+- Cold flow: collect 시작할 때 producer 시작. collector 0 = 비활성. 각 collector 별 독립.
+- Hot flow: producer 가 계속 동작. collector 수와 무관. 다수 collector 공유.
+- StateFlow: 현재 값 보유. 새 collector → 즉시 현재 값 받음. distinctUntilChanged 자동.
+- SharedFlow: 이벤트 list. replay 옵션 (새 collector 가 받을 옛 emission 수).
+
+## 💻 코드 패턴
+
+### Flow — DB / network result
+```kotlin
+fun getUser(id: String): Flow<User> = flow {
+    val u = api.fetch(id)
+    emit(u)
+}
+```
+
+### StateFlow — UI state
+```kotlin
+class ViewModel : ViewModel() {
+    private val _state = MutableStateFlow(UiState.Idle)
+    val state: StateFlow<UiState> = _state.asStateFlow()
+
+    fun load() {
+        viewModelScope.launch {
+            _state.value = UiState.Loading
+            // ...
+        }
+    }
+}
+```
+
+### SharedFlow — 일회성 이벤트
+```kotlin
+private val _events = MutableSharedFlow<Event>(replay = 0, extraBufferCapacity = 1)
+val events: SharedFlow<Event> = _events.asSharedFlow()
+
+fun showError(msg: String) {
+    _events.tryEmit(Event.Error(msg))
+}
+```
+
+### stateIn — Flow → StateFlow 변환
+```kotlin
+val state: StateFlow<UiState> = repo.observeUser(id)
+    .map { UiState.Success(it) }
+    .stateIn(
+        scope = viewModelScope,
+        started = SharingStarted.WhileSubscribed(5000), // 5s 후 unsubscribe
+        initialValue = UiState.Loading,
+    )
+```
+
+### combine, flatMapLatest, debounce
+```kotlin
+val results = combine(query.debounce(300), filters) { q, f -> q to f }
+    .flatMapLatest { (q, f) -> repo.search(q, f) }
+    .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), emptyList())
+```
+
+## 🤔 의사결정 기준
+| 데이터 | 권장 |
+|---|---|
+| 1회성 fetch (사용자 정보, network call) | Flow |
+| UI 가 항상 봐야 할 현재 state | StateFlow |
+| Snackbar / Navigation 같은 일회성 이벤트 | SharedFlow (replay=0) |
+| 다수 구독자 + buffered | SharedFlow + replay/buffer |
+| Database (Room flow) | Flow → stateIn |
+| 화면 회전 시 이벤트 재실행 막기 | SharedFlow + STARTED 만 collect |
+
+## ❌ 안티패턴
+- **이벤트 (Snackbar) 를 StateFlow 로**: state 라 회전 시 재실행. SharedFlow + replay=0.
+- **state 를 SharedFlow 로**: 새 collector 가 옛 값 못 받음 (replay=0). StateFlow 가 맞음.
+- **stateIn 없이 cold flow 를 UI 에서 collect**: 회전 시 새 collect = 새 fetch. stateIn(WhileSubscribed) 권장.
+- **collectLatest 대신 collect** (검색 같은 케이스): 이전 결과가 늦게 도착해 새 결과 덮어씀. flatMapLatest / collectLatest.
+- **MutableStateFlow 를 외부 노출**: 외부 mutate 가능. asStateFlow().
+- **emit 대신 tryEmit 인데 buffer 0**: drop. 버퍼 또는 emit (suspend).
+
+## 🤖 LLM 활용 힌트
+- "현재 상태 = StateFlow, 일회성 이벤트 = SharedFlow(replay=0), Room/network = Flow + stateIn" 명시.
+- WhileSubscribed(5000) 이 표준.
+
+## 🔗 관련 문서
+- [[Android_Kotlin_Coroutines_Scopes]]
+- [[Android_ViewModel_State_Persistence]]