| Part |
Holds |
XxxRoute |
ViewModel, state collection, side effects. Navigation callbacks only |
XxxScreen |
private. uiState + lambdas. No ViewModel |
XxxSideEffect |
One-off events (toast, navigate, dialog). <screen>/model/ next to UiState |
@Composable
internal fun FeatureRoute(
onItemClick: (Long) -> Unit, // ์ด๋์ entry builder๊ฐ ๊ฒฐ์
viewModel: FeatureViewModel = hiltViewModel(),
) {
val uiState by viewModel.uiState.collectAsStateWithLifecycle()
viewModel.sideEffect.CollectSideEffect { sideEffect -> // ํ๋ฉด์ด ๋ณด์ผ ๋(STARTED)๋ง ์์ง
when (sideEffect) {
is FeatureSideEffect.NavigateToDetail -> onItemClick(sideEffect.itemId)
FeatureSideEffect.ShowDeleteToast -> { /* ํ ์คํธ */ }
}
}
FeatureScreen(
uiState = uiState,
onItemClick = viewModel::onItemClick,
onDeleteClick = viewModel::onDeleteClick,
)
}
@Composable
private fun FeatureScreen(
uiState: FeatureUiState,
onItemClick: (Long) -> Unit, // ๊ธฐ๋ณธ์ ์ด๋ฒคํธ๋ง๋ค ๋๋ค
onDeleteClick: (Long) -> Unit,
modifier: Modifier = Modifier,
) { ... }
// ์ด๋ฒคํธ๊ฐ ๋ง์ผ๋ฉด ์ ํ: onEvent ํ๋๋ก ๋ฌถ๊ธฐ
// private fun FeatureScreen(uiState: FeatureUiState, onEvent: (FeatureEvent) -> Unit, modifier: Modifier = Modifier)
// <screen>/model/FeatureSideEffect.kt
internal sealed interface FeatureSideEffect {
data class NavigateToDetail(val itemId: Long) : FeatureSideEffect
data object ShowDeleteToast : FeatureSideEffect
}
// ViewModel: ์์ง์ด ๋ฉ์ถ ๋์ ๋ณด๋ธ ์ด๋ฒคํธ๋ ๋์์ค๋ฉด ์ ๋ฌ (์ต๋ ํ ๋ฒ)
private val _sideEffect = Channel<FeatureSideEffect>(Channel.BUFFERED)
val sideEffect = _sideEffect.receiveAsFlow()
fun onDeleteClick(itemId: Long) {
viewModelScope.launch { _sideEffect.send(FeatureSideEffect.ShowDeleteToast) }
}
| Don't |
Do |
MutableSharedFlow(replay = 0) for side effects |
Channel(BUFFERED).receiveAsFlow() |
LaunchedEffect(Unit) { flow.collect { } } |
CollectSideEffect { } (core:ui) |
| Toast/navigation state in UiState |
XxxSideEffect |
| Dialog visibility as a side effect |
isXxxDialogVisible in UiState (navigation) |
State: ui-state