Skip to content

常見問題 ​

Kotlin Multiplatform ​

什麼是 Kotlin Multiplatform? ​

Kotlin Multiplatform (KMP) 是 JetBrains 推出的開源技術,用於靈活的跨平台開發。它允許你為各種平台建立應用程式,並在不同平台間高效重複使用程式碼,同時保有原生程式設計的優勢。透過 Kotlin Multiplatform,你可以開發適用於 Android、iOS、桌面、Web、伺服器端及其他平台的應用程式。

我可以使用 Kotlin Multiplatform 共用 UI 程式碼嗎? ​

可以,你可以使用 Compose Multiplatform 來共用 UI,這是 JetBrains 基於 Kotlin 和 Jetpack Compose 開發的宣告式 UI 架構。該架構允許你為 iOS、Android、桌面和 Web 等平台建立共用的 UI 元件,協助你在不同裝置和平台間維持一致的使用者介面。

若要了解更多,請參閱 Compose Multiplatform 小節。

Kotlin Multiplatform 支援哪些平台? ​

Kotlin Multiplatform 支援 Android、iOS、桌面、Web、伺服器端及其他平台。進一步了解支援的平台。

我應該使用哪款 IDE 來開發跨平台應用程式? ​

我們建議使用 IntelliJ IDEA 或 Android Studio 來進行 Kotlin Multiplatform 專案開發。

如果你的 Kotlin Multiplatform 專案以 iOS 為目標平台,你的電腦上需要安裝 Xcode,以便編寫 iOS 專屬程式碼並執行 iOS 應用程式。

如何建立新的 Kotlin Multiplatform 專案? ​

建立 Kotlin Multiplatform 應用程式教學提供了建立 Kotlin Multiplatform 專案的逐步說明。你可以決定要共用什麼——僅共用邏輯,或是同時共用邏輯與 UI。

我有一個現有的 Android 應用程式,該如何將其遷移至 Kotlin Multiplatform? ​

讓你的 Android 應用程式在 iOS 上執行逐步教學說明了如何讓你的 Android 應用程式搭配原生 UI 在 iOS 上運作。

將 Jetpack Compose 應用程式遷移至 Kotlin Multiplatform 是一篇進階教學,展示了將複雜 Android 應用程式轉換為多平台的完整路徑,包括將 UI 遷移至 Compose Multiplatform。

可以在哪裡取得完整的範例來試用? ​

這裡有一份真實範例清單。

哪裡可以找到真實 Kotlin Multiplatform 應用程式清單?有哪些公司在生產環境中使用 KMP? ​

請查看我們的案例研究清單,了解其他已經在生產環境中採用 Kotlin Multiplatform 的公司經驗。

哪些作業系統可以使用 Kotlin Multiplatform? ​

如果你要處理共用程式碼或特定平台的程式碼(iOS 除外),你可以在 IDE 支援的任何作業系統上工作。

如果你想編寫 iOS 專屬程式碼並在模擬器或實體裝置上執行 iOS 應用程式,請使用執行 macOS 的 Mac 電腦。這是因為根據 Apple 的要求,iOS 模擬器只能在 macOS 上執行,無法在 Microsoft Windows 或 Linux 等其他作業系統上執行。

進一步了解推薦的 IDE。

如何在 Kotlin Multiplatform 專案中編寫並行程式碼? ​

你仍然可以在 Kotlin Multiplatform 專案中使用協同程式 (coroutine) 與 Flow 來編寫非同步程式碼。如何呼叫這些程式碼取決於你從何處呼叫。從 Kotlin 程式碼呼叫掛起函式 (suspending functions) 與 Flow 有詳盡的文件記載,尤其是針對 Android。從 Swift 程式碼呼叫它們需要多做一些工作,詳情請參閱 KT-47610。

目前從 Swift 呼叫掛起函式與 Flow 的最佳方法,是使用像 KMP-NativeCoroutines 這類的外掛程式與程式庫,搭配 Swift 的 async/await 或 Combine 與 RxSwift 等程式庫。

目前,KMP-NativeCoroutines 是經過更多驗證的解決方案,並且支援 async/await、Combine 和 RxSwift 的並行處理方式。SKIE 則更容易設定且較不冗長。例如,它直接將 Kotlin Flow 對應至 Swift AsyncSequence。這兩個程式庫都支援協同程式的正常取消。

若要了解如何使用它們,請參閱原生 UI:REST API 請求的共用邏輯教學。

什麼是 Kotlin/Native,它與 Kotlin Multiplatform 有何關聯? ​

Kotlin/Native 是一項將 Kotlin 程式碼編譯為原生二進位檔的技術,無需虛擬機即可執行。它包含一個基於 LLVM 的 Kotlin 編譯器後端,以及 Kotlin 標準程式庫的原生實作。

Kotlin/Native 主要旨在允許針對不適合或無法使用虛擬機的平台(例如嵌入式裝置和 iOS)進行編譯。當你需要產生不需要額外執行時期或虛擬機的獨立程式時,它特別適用。

例如,在行動應用程式中,使用 Kotlin 編寫的共用程式碼會透過 Kotlin/JVM 編譯為 Android 的 JVM 位元組碼,並透過 Kotlin/Native 編譯為 iOS 的原生二進位檔。這使得與 Kotlin Multiplatform 在這兩個平台上的整合變得天衣無縫。

Kotlin/Native and Kotlin/JVM binaries

如何加快原生平台(iOS、macOS、Linux)的 Kotlin Multiplatform 模組編譯速度? ​

請參閱這些改善 Kotlin/Native 編譯時間的提示。

Compose Multiplatform ​

什麼是 Compose Multiplatform? ​

Compose Multiplatform 是由 JetBrains 開發的現代宣告式與響應式 UI 架構,提供了一種只需少量 Kotlin 程式碼即可建構使用者介面的簡單方法。它還允許你編寫一次 UI,即可在任何受支援的平台上執行——iOS、Android、桌面(Windows、macOS、Linux)和 Web。

它與 Android 的 Jetpack Compose 有何關聯? ​

Compose Multiplatform 與 Google 開發的 Android UI 架構 Jetpack Compose 共用大部分 API。事實上,當你使用 Compose Multiplatform 以 Android 為目標時,你的應用程式就只是在 Jetpack Compose 上執行。 Compose Multiplatform 所針對的其他平台,其底層實作細節可能與 Android 上的 Jetpack Compose 不同,但它們仍為你提供相同的 API。

有關詳細資訊,請參閱架構相互關係概觀。

可以在哪些平台之間共用 UI? ​

我們希望你能夠在主流平台的任意組合之間共用 UI——Android、iOS、桌面(Linux、macOS、Windows)和 Web(基於 Wasm)。目前 Compose Multiplatform 在 Android、iOS 和桌面平台上已達到穩定 (Stable) 狀態。有關更多詳細資訊,請參閱支援的平台。

我可以在生產環境中使用 Compose Multiplatform 嗎? ​

Compose Multiplatform 的 Android、iOS 和桌面目標平台皆已穩定 (Stable)。你可以在生產環境中使用它們。

基於 WebAssembly 的 Web 版 Compose Multiplatform 處於 Beta 階段,這意味著它已接近完成。你可以使用它,但仍可能遇到遷移問題。它具有與 iOS、Android 和桌面版 Compose Multiplatform 相同的 UI。

如何建立新的 Compose Multiplatform 專案? ​

建立具備共用邏輯與 UI 的 Compose Multiplatform 應用程式教學提供了建立適用於 Android、iOS 和桌面的 Compose Multiplatform 專案的逐步說明。你也可以觀看 Kotlin 技術傳教士 Sebastian Aigner 在 YouTube 上製作的教學影片。

使用 Compose Multiplatform 建置應用程式時應該使用哪款 IDE? ​

我們建議使用安裝了 KMP IDE 外掛程式的 IntelliJ IDEA 或 Android Studio IDE。

有關更多詳細資訊,請參閱推薦的 IDE 與程式碼編輯器。

我可以試用展示應用程式嗎?可以在哪裡找到? ​

你可以試用我們的範例專案。

Compose Multiplatform 是否隨附小工具? ​

是的,Compose Multiplatform 完整支援 Material 3 小工具。

我可以在多大程度上自訂 Material 小工具的外觀? ​

你可以使用 Material 的佈景主題功能來自訂顏色、字型與間距 (paddings)。如果你想打造獨特的設計,也可以建立自訂小工具與版面配置。

我可以在現有的 Kotlin Multiplatform 應用程式中共用 UI 嗎? ​

如果你的應用程式使用原生 API 來建構 UI(這是最常見的情況),你可以逐步將部分內容改寫為 Compose Multiplatform,因為它為此提供了互通性。你可以使用包裝了 Compose 編寫的通用 UI 的特殊互通視圖 (interop view) 來取代原生 UI。

我有一個使用 Jetpack Compose 的現有 Android 應用程式,該如何將其遷移至其他平台? ​

應用程式的遷移包含兩個部分:遷移 UI 與遷移邏輯。遷移的複雜度取決於應用程式的複雜度以及所使用的 Android 專屬程式庫數量。

有關複雜應用程式遷移的範例,請參閱將 Jetpack Compose 應用程式遷移至 Kotlin Multiplatform指南。

你可以將大部分畫面直接遷移至 Compose Multiplatform 而無需修改。所有 Jetpack Compose 小工具均受支援。然而,某些 API 僅能在 Android 目標平台上運作——它們可能是 Android 專屬的,或者尚未移植到其他平台。例如,資源處理是 Android 專屬的,因此你需要遷移至 Compose Multiplatform 資源程式庫或使用社群解決方案。有關僅適用於 Android 的元件詳細資訊,請參閱目前的僅限 Android 的 API 清單。

你需要將商業邏輯遷移至 Kotlin Multiplatform。當你嘗試將程式碼移至共用模組時,使用 Android 相依性的部分將無法編譯,你需要重新編寫它們。

  • 你可以改寫使用僅限 Android 相依性的程式碼,改為使用多平台程式庫。某些程式庫可能已經支援 Kotlin Multiplatform,因此不需要做任何修改。請查看 klibs.io 目錄或 KMP-awesome 程式庫清單。
  • 或者,你可以將通用程式碼與特定平台邏輯分離,並提供通用介面,根據平台的不同進行不同實作。在 Android 上,實作可以使用你現有的功能;而在 iOS 等其他平台上,你需要為這些通用介面提供新的實作。

我可以將 Compose 畫面整合到現有的 iOS 應用程式中嗎? ​

可以。Compose Multiplatform 支援不同的整合情境。有關與 iOS UI 架構整合的更多資訊,請參閱與 SwiftUI 整合以及與 UIKit 整合。

我可以將 UIKit 或 SwiftUI 元件整合到 Compose 畫面中嗎? ​

可以。請參閱與 SwiftUI 整合以及與 UIKit 整合。

當我的行動作業系統更新並變更系統元件的視覺樣式或行為時,會發生什麼事? ​

作業系統更新後,你的 UI 將保持不變,因為所有元件都是繪製在畫布上的。如果你在畫面中嵌入原生 iOS 元件,更新可能會影響它們的外觀。

未來規劃 ​

Kotlin Multiplatform 的未來演進計畫為何? ​

JetBrains 正投入大量資源,旨在為多平台開發提供最佳體驗,並消除多平台使用者現有的痛點。我們計劃改進 Kotlin Multiplatform 核心技術、與 Apple 生態系統的整合、工具鏈以及我們的 Compose Multiplatform UI 架構。請查看 Kotlin 藍圖中的多平台小節。

Compose Multiplatform 何時會達到穩定版 (Stable)? ​

Compose Multiplatform 在 Android、iOS 和桌面平台上已達到穩定 (Stable) 狀態,而基於 Wasm 的 Web 支援則處於 Beta 階段。我們正致力於推出 Web 平台的穩定版本,確切日期將在日後公佈。

有關穩定性狀態的更多資訊,請參閱支援的平台。

Kotlin 和 Compose Multiplatform 未來對 Web 目標的支援情況如何? ​

我們目前正將資源集中在極具潛力的 WebAssembly (Wasm) 上。你可以試用我們全新的 Kotlin/Wasm 後端以及由 Wasm 驅動的 Web 版 Compose Multiplatform。

至於 JS 目標平台,Kotlin/JS 後端已達到穩定 (Stable) 狀態。在 Compose Multiplatform 中,由於資源有限,我們已將焦點從 JS Canvas 轉移到我們認為更有前景的 Wasm 上。

我們也提供 Compose HTML(先前稱為 Web 版 Compose Multiplatform)。這是一個專為在 Kotlin/JS 中操作 DOM(文件物件模型)而設計的附加程式庫,其目的並非用於跨平台共用 UI。

是否有改善多平台開發工具的計畫? ​

有的,我們深知目前多平台工具所面臨的挑戰,並正在多個領域積極進行改進。

你們打算提供與 Swift 的互通性嗎? ​

是的。我們目前正在研究提供與 Swift 直接互通的各種方法,重點是將 Kotlin 程式碼匯出至 Swift。