Compose Multiplatform 與 Jetpack Compose
Compose Multiplatform 是由 JetBrains 開發的跨平台 UI 工具包。 它透過支援額外的目標平台來擴展 Google 針對 Android 的 Jetpack Compose 工具包。
Compose Multiplatform 將 Compose API 從共同 Kotlin 程式碼中提供，讓您能夠編寫可在 Android、iOS、桌面和網路上運行的共享 Compose UI 程式碼。
| Compose Multiplatform | Jetpack Compose | |
|---|---|---|
| 平台 | Android、iOS、桌面、網路 | Android |
| 支援者 | JetBrains |
Jetpack Compose 與可組合項
Jetpack Compose 是一個宣告式 UI 工具包，用於建立原生 Android 介面。 其基礎是使用 @Composable 註解標記的_可組合函式_ (composable functions)。 這些函式定義了 UI 的部分，並在底層資料變更時自動更新。 您可以組合可組合項 (composables) 來建立佈局、處理使用者輸入、管理狀態和應用動畫。 Jetpack Compose 包含 Text、Button、Row 和 Column 等常用 UI 元件，您可以使用修飾符 (modifiers) 進行自訂。
Compose Multiplatform 建立在相同的原則之上。 它與 Jetpack Compose 共享 Compose 編譯器和執行時 (runtime)，並使用相同的 API — @Composable 函式、remember 等狀態管理工具、佈局元件、修飾符和動畫支援。 這意味著您可以將您的 Jetpack Compose 知識應用於 Compose Multiplatform，以建立適用於 Android、iOS、桌面和網路的跨平台 UI。
Compose Multiplatform 與 Jetpack Compose 功能
您可以從幾乎所有 Jetpack Compose 資料中了解這兩個 UI 框架的基礎知識，包括 Google 的官方文件。
當然，Compose Multiplatform 具有平台專屬的功能和考量：
- 僅限 Android 的元件頁面列出了與 Android 平台緊密相關的 API，因此無法從共同 Compose Multiplatform 程式碼中取得。
- 某些平台專屬的 API，例如用於桌面的視窗處理 API 或用於 iOS 的 UIKit 相容性 API，僅在其各自的平台上可用。
以下是常用元件和 API 可用性的概述：
| Compose Multiplatform | Jetpack Compose | |
|---|---|---|
| Compose Animation | 是 | 是 |
| Compose Compiler | 是 | 是 |
| Compose Foundation | 是 | 是 |
| Compose Material | 是 | 是 |
| Compose Material 3 | 是 | 是 |
| Compose Runtime | 是，除了 androidx.compose.runtime.rxjava2 和 androidx.compose.runtime.rxjava3 | 是 |
| Compose UI | 是 | 是 |
| Jetpack Lifecycle | 是 | 是 |
| Jetpack ViewModel | 是 | 是 |
| Jetpack Navigation Compose | 是 | 是 |
| 資源 | Compose Multiplatform 資源函式庫 使用 Res 類別 | Android 資源系統 使用 R 類別 |
| Maps Compose | 否 | 是 |
| 第三方函式庫 (適用於 UI 元件、導航、架構等) | Compose Multiplatform 函式庫 | Jetpack Compose 和 Compose Multiplatform 函式庫 |
技術細節
Compose Multiplatform 建立在 Google 發佈的程式碼和版本之上。 雖然 Google 的重點是針對 Android 的 Jetpack Compose，但 Google 和 JetBrains 之間有密切合作以啟用 Compose Multiplatform。
Jetpack 包含 Foundation 和 Material 等第一方函式庫，Google 針對 Android 發佈了這些函式庫。 為了使這些函式庫提供的 API 可從共同程式碼中取得，JetBrains 維護了這些函式庫的多平台版本，這些版本針對 Android 以外的目標平台發佈。
在相容性和版本頁面上了解更多關於發佈週期的資訊。
當您為 Android 建置您的 Compose Multiplatform 應用程式時，您會使用 Google 發佈的 Jetpack Compose 構件。 例如，如果您將 compose.material3 新增到您的依賴項中，您的專案將在 Android 目標中使用 androidx.compose.material3:material3，並在其他目標中使用 org.jetbrains.compose.material3:material3。 這是根據多平台構件中的 Gradle 模組中繼資料自動完成的。
適用於 Compose Multiplatform 的函式庫
透過使用 Compose Multiplatform，您可以將使用 Compose API 的函式庫作為 Kotlin 多平台函式庫發佈。 這使得它們可從共同 Kotlin 程式碼中使用，目標是多個平台。
因此，如果您正在使用 Compose API 建立一個新函式庫，請考慮利用這一點，並將其作為使用 Compose Multiplatform 的多平台函式庫來建置。 如果您已經為 Android 建置了一個 Jetpack Compose 函式庫，請考慮將該函式庫多平台化。 生態系統中已經有許多 Compose Multiplatform 函式庫可用。
當函式庫與 Compose Multiplatform 一起發佈時，僅使用 Jetpack Compose 的應用程式仍然能夠無縫地使用它； 它們只是使用該函式庫的 Android 構件。
下一步
閱讀更多關於以下元件的 Compose Multiplatform 實作：