AgentSkillsCN

Android State Management

ViewModel、StateFlow 与 UI 状态模式的标准。

SKILL.md
--- frontmatter
name: Android State Management
description: Standards for ViewModel, StateFlow, and UI State Patterns
metadata:
  labels: [android, state, viewmodel, flow]
  triggers:
    files: ['**/*ViewModel.kt', '**/*UiState.kt']
    keywords: [viewmodel, stateflow, livedata, uistate]

Android State Management

Priority: P0

Implementation Guidelines

ViewModel Pattern

  • •Exposure: Expose ONE StateFlow<UiState> via .asStateFlow().
  • •Scope: Use viewModelScope for all coroutines.
  • •Initialization: Trigger initial load in init or LaunchedEffect (once).

UI State (LCE)

  • •Type: sealed interface UiState (Loading, Content, Error).
  • •Immutability: Data classes inside should be @Immutable.

Flow Lifecycle

  • •Collection: Use collectAsStateWithLifecycle() in Compose.
  • •Hot Flows: Use SharingStarted.WhileSubscribed(5000) for shared resources.

Anti-Patterns

  • •LiveData: **No LiveData**: Use StateFlow.
  • •Mutable State: **No Mutable Public**: Expose read-only Flow.
  • •Context: **No Context in VM**: Memory Leak Risk.

References