此页面由 Cloud Translation API 翻译。

将 Kotlin Multiplatform 添加到现有项目

如需在 Android 项目中创建 Kotlin Multiplatform (KMP) 模块，请使用 Kotlin Multiplatform Shared Module 模板，该模板可在 Android Studio Meerkat 和 Android Gradle 插件 8.8.0 版及更高版本中使用。

该模块模板会自动创建一个以 Android 和 iOS 平台为目标平台且配置要求极低的新模块。

设置共享 KMP 模块

如需创建共享 KMP 模块，请按以下步骤操作：

依次选择 File > New > New Module
在 Templates 面板中选择 Kotlin Multiplatform Shared Module 模板：

该模板中的字段如下：

Module name - 定义 Gradle 模块名称以及 iOS 框架名称（稍后可以更改）
软件包名称 - 定义此模块中文件的软件包名称
1. 点击 Finish（完成），并允许 Gradle 与项目同步。系统可能还会提示您将新创建的模块文件添加到源代码控制工具中。

完成后，Android Studio Project View 会显示新的共享模块以及每个平台的源代码集。

将共享模块关联到 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
  }
}