設定環境 (Kotlin Multiplatform)

Kotlin Multiplatform (KMP) 可讓您在不同平台之間共用 Kotlin 程式碼。您必須先按照本文件的說明設定環境，再開始使用 KMP 建構應用程式。您也可以參閱 Jeetbrain 的官方說明文件。

安裝或更新必要工具

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

建立 Kotlin Multiplatform 專案

您可以使用 Jetbrains 的 Kotlin Multiplatform 精靈建立新的 KMP 專案。如要保留 UI 原生，請務必選擇「Do notshare UI」選項。

專案架構

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

KMP 專案含有平台專屬模組和共用模組。將平台專屬程式碼新增至相關模組。例如，將 Android 應用程式 UI 新增至 androidApp 模組，並在 iosApp 中新增 iOS 應用程式 UI。你要在平台之間共用的所有程式碼都會納入「共用」模組。

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

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