通用 ViewModel

Android 的 ViewModel 方法可用於建構 UI，並可透過 Compose Multiplatform 在通用程式碼中實作。

將通用 ViewModel 加入您的專案

若要使用多平台 ViewModel 實作，請將以下依賴項加入您的 commonMain 原始碼集：

kotlin {
    // ...
    sourceSets {
        // ...
        commonMain.dependencies {
            // ...
            implementation("org.jetbrains.androidx.lifecycle:lifecycle-viewmodel-compose:2.9.2")
        }
        // ...
    }
}

在通用程式碼中使用 ViewModel

Compose Multiplatform 實作了通用 ViewModelStoreOwner 介面，因此總體而言，在通用程式碼中使用 ViewModel 類別與 Android 最佳實踐沒有太大區別。

使用 導航範例：

1. 宣告 ViewModel 類別：

import androidx.lifecycle.ViewModel
import androidx.lifecycle.viewmodel.compose.viewModel

class OrderViewModel : ViewModel() {
   private val _uiState = MutableStateFlow(OrderUiState(pickupOptions = pickupOptions()))
   val uiState: StateFlow<OrderUiState> = _uiState.asStateFlow()
   // ...
}

2. 將 ViewModel 加入您的可組合函式：

@Composable
fun CupcakeApp(
   viewModel: OrderViewModel = viewModel { OrderViewModel() },
) {
   // ...
}

在 ViewModel 中執行協程時，請記住 ViewModel.viewModelScope 值綁定到 Dispatchers.Main.immediate 值，該值在桌面端預設情況下可能不可用。為了讓 ViewModel 協程與 Compose Multiplatform 正常運作，請將 kotlinx-coroutines-swing 依賴項加入您的專案。請參閱 Dispatchers.Main 文件以了解詳細資訊。

在非 JVM 平台，物件無法使用型別反射實例化。 因此在通用程式碼中，您不能不帶參數呼叫 viewModel() 函式：每次建立 ViewModel 實例時，您至少需要提供一個初始化器作為參數。

如果只提供一個初始化器，函式庫會在內部建立一個預設工廠。 但是您可以實作您自己的工廠，並呼叫通用 viewModel(...) 函式更明確的版本，就像 使用 Jetpack Compose 一樣。