本頁面由 Cloud Translation API 翻譯而成。

將 Kotlin Multiplatform 新增至現有專案

如要在 Android 專案中建立 Kotlin Multiplatform (KMP) 模組，請使用 Kotlin Multiplatform 共用模組範本，該範本可在 Android Studio Meerkat 和 Android Gradle 外掛程式 8.8.0 版以上版本中使用。

模組範本會自動建立新模組，並以 Android 和 iOS 平台為目標設定最低配置。

設定共用 KMP 模組

如要建立共用 KMP 模組，請按照下列步驟操作：

依序選取「File」>「New」>「New Module」
在「Templates」面板中選取「Kotlin Multiplatform Shared Module」範本：

範本中的欄位如下：

模組名稱：定義 Gradle 模組名稱和 iOS 架構名稱 (可在稍後變更)
套件名稱：定義此模組中檔案的套件名稱
1. 按一下「Finish」，讓 Gradle 與專案同步。系統可能也會提示您將新建立的模組檔案加入來源控制項。

完成後，Android Studio 的「Project View」會顯示新的共用模組，以及每個平台的來源組合。

顯示新共用模組的專案檢視畫面 — **圖 2.** 專案檢視畫面顯示新的共用模組

將共用模組連結至 Android 應用程式

模組精靈不會將新建立的模組新增為任何現有模組的依附元件。接下來，您需要將共用模組連結至現有 Gradle 模組，這與其他 Android 依附元件類似

dependencies {
    ...
    implementation(project(":shared"))
}

啟用後，您就能照常存取代碼。您可以透過 Android 應用程式存取 androidMain 或 commonMain 中的程式碼。

如要進一步瞭解 Kotlin Multiplatform 專案結構，請參閱 Kotlin Multiplatform 專案結構的基本概念

在 iOS 應用程式中設定共用模組

Swift 無法直接使用 Kotlin 模組，因此必須產生已編譯的二進位架構。

Android Studio 中的新模組範本會設定共用模組，為每個 iOS 架構產生架構。您可以在共用模組的 build.gradle.kts 檔案中找到下列程式碼：

val xcfName = "sharedKit"

iosX64 {
  binaries.framework {
    baseName = xcfName
  }
}

iosArm64 {
  binaries.framework {
    baseName = xcfName
  }
}

iosSimulatorArm64 {
  binaries.framework {
    baseName = xcfName
  }
}