Android ViewModel & State Management

Instructions

ViewModel を使用して状態とビジネスロジックを保持します。設定変更を超えて存続する必要があります。

1. UI State (StateFlow)

• What: UI の永続的な状態を表します (例: Loading、Success(data)、Error)。
• Type: StateFlow<UiState>。
• Initialization: 初期値を持つ必要があります。
• Exposure: プライベートな MutableStateFlow をバックに、読み取り専用の StateFlow として公開します。

  private val _uiState = MutableStateFlow<UiState>(UiState.Loading)
  val uiState: StateFlow<UiState> = _uiState.asStateFlow()
  

• Updates: スレッドセーフのため .update { oldState -> ... } を使用して状態を更新します。

2. One-Off Events (SharedFlow)

• What: 「トーストを表示」、「画面に移動」、「スナックバーを表示」といった一時的なイベント。
• Type: SharedFlow<UiEvent>。
• Configuration: 画面回転時にイベントが再トリガーされるのを防ぐため、replay = 0 を使用する必要があります。

  private val _uiEvent = MutableSharedFlow<UiEvent>(replay = 0)
  val uiEvent: SharedFlow<UiEvent> = _uiEvent.asSharedFlow()
  

• Sending: .emit(event) (サスペンド) または .tryEmit(event) を使用します。

3. UI での収集

• Compose: StateFlow の場合は collectAsStateWithLifecycle() を使用します。

  val state by viewModel.uiState.collectAsStateWithLifecycle()
  

  SharedFlow の場合、LocalLifecycleOwner で LaunchedEffect を使用します。
• Views (XML): コルーチン内で repeatOnLifecycle(Lifecycle.State.STARTED) を使用します。

4. Scope

• ViewModel によって開始されるすべてのコルーチンに viewModelScope を使用します。
• 理想的には、具体的な操作は UseCase または Repository に委譲する必要があります。