設定環境 (Kotlin Multiplatform)

Kotlin Multiplatform (KMP) 可提供跨多個平台共用 Kotlin 程式碼的功能 平台。開始使用 KMP 建構應用程式前,您需要完成 按照本文件所述的方式設定環境。你也可以參閱 Jetbrain 的官方文件

安裝或更新必要工具

  • 安裝或更新至最新的 Android Studio 穩定版。
  • 更新 Android Studio 隨附的 Kotlin 外掛程式 升級至最新版本,以免發生相容性問題。
  • (選用) 針對 iOS 開發作業,安裝 Xcode 即可建立 UI,並視需要新增 Swift 或 Objective-C 程式碼。

建立 Kotlin Multiplatform 專案

您可以使用 Kotlin Multiplatform 精靈從 Jetbrains 至 建立新的 KMP 專案請務必選擇 [不要] 分享 UI 選項,保持 UI 原生。

專案架構

KMP 專案的專案結構與 Android 專案類似。

KMP 專案包含平台專屬模組及共用模組。 將平台專屬程式碼新增至相關模組。舉例來說,您可以將 androidApp 模組中的 Android 應用程式使用者介面,以及 iosApp 中的 iOS 應用程式使用者介面。 要在平台之間分享的任何程式碼,都會放在「共用」模組中。

共用模組使用 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)
   }
}

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