設定環境 (Kotlin Multiplatform)

Kotlin Multiplatform (KMP) 可跨平台共用 Kotlin 程式碼。開始使用 KMP 建構應用程式前,您必須按照本文件所述設定環境。您也可以參考 JetBrain 的官方說明文件

安裝或更新必要工具

  • 安裝或更新至最新的 Android Studio 穩定版。
  • 將 Android Studio 隨附的 Kotlin 外掛程式更新為最新版本,以免發生相容性問題。
  • (選用) 如果是 iOS 開發作業,請安裝 Xcode 來建構 UI,並視需要新增 Swift 或 Objective-C 程式碼。

建立 Kotlin Multiplatform 專案

您可以使用 JetBrains 的 Kotlin Multiplatform 精靈建立新的 KMP 專案。請務必選擇「Do not share UI」選項,保留原生 UI。

專案架構

KMP 專案採用類似 Android 專案的專案結構。

KMP 專案包含特定平台的模組和共用模組。將平台專屬程式碼新增至相關模組。舉例來說,請在 androidApp 模組中新增 Android 應用程式 UI,並在 iosApp 中新增 iOS 應用程式 UI。您想在不同平台之間共用的任何程式碼,都應放入「shared」模組。

共用模組會像專案的其他部分一樣,使用 Gradle 做為建構系統。您可以使用來源集宣告常見和平台專屬的依附元件。舉例來說,如果您的應用程式使用 Ktor 進行網路連線,就需要為 Android 新增 OkHttp 依附元件,並為 iOS 新增 darwin 依附元件。請注意,有些程式庫只需要一般依附元件,不需要平台專屬依附元件。

sourceSets {
   commonMain.dependencies {
       //put your multiplatform dependencies here
       //...
       implementation(libs.ktor.client.core)
       implementation(libs.ktor.client.content.negotiation)
       implementation(libs.ktor.serialization.kotlinx.json)
       //...
   }
   androidMain.dependencies {
       implementation(libs.ktor.client.okhttp)
   }
   iosMain.dependencies {
       implementation(libs.ktor.client.darwin)
   }
}

在應用程式的共用模組中新增程式庫時,請務必檢查每個平台的必要依附元件。