Kotlin 语言参考文档 中文版 Help

Kotlin Multiplatform IDE Plugin 的发布版本

Kotlin Multiplatform IDE plugin 能够帮助你开发针对 Android, iOS, Desktop, 和 Web 的跨平台应用程序. 请确认你安装了这个 plugin 最新发布版本, 以便使用 Kotlin Multiplatform 项目.

这个 plugin 兼容 IntelliJ IDEA 和 Android Studio:

  • IntelliJ IDEA 的 macOS 版从 2025.1.1.1 开始支持这个 plugin, Windows 和 Linux 版从 2025.2.2 开始支持.

  • Android Studio 的 macOS 版从 Narwhal 2025.1.1 开始支持这个 plugin, Windows 和 Linux 版从 Otter 2025.2.1 开始支持.

关于 Kotlin Multiplatform Gradle plugin, 更多详情请参见它的 DSL 参考文档兼容性指南.

更新到最新发布版

如果出现了新的 Kotlin Multiplatform plugin 发布版, IDE 会建议你更新. 如果你接受建议, plugin 会更新到最新版本. 要完成 plugin 的安装, 请重新启动你的 IDE.

你可以通过菜单 Settings | Plugins, 查看 plugin 的版本, 并手动更新它.

为了让 plugin 正确工作, 你需要一个兼容的 Kotlin 版本. 你可以在 发布版本详情 中找到对应的兼容版本. 要查看和更新你的 Kotlin 版本, 请选择菜单 Settings | Plugins, 或 Tools | Kotlin | Configure Kotlin in Project.

发布版本详情

下表列出了 Kotlin Multiplatform IDE plugin 发布版信息:

发布版

主要功能

兼容的 Kotlin 版本

0.9

发布日期: 2025/05/19

Kotlin Multiplatform plugin 已经彻底重建:

  • 对支持的 IDE 集成了 New Project 向导.

  • 预先检查环境, 有助于发现和解决设置问题, 包括 Java, Android, Xcode, 和 Gradle.

  • 对所有支持的平台自动生成运行配置, 并带有用于 iOS 和 Android 的设备选择器.

  • 跨语言支持: 针对 Swift 和 Kotlin 的跨语言导航和调试, 以及 Swift 语法高亮和快速文档.

  • Compose Multiplatform 支持: Kotlin Multiplatform IDE plugin 现在支持 Compose Multiplatform 资源, 自动完成, 以及共通代码的 UI 预览 (可以安全的删除 以前的 Compose Multiplatform plugin).

  • Compose 热重载(Hot Reload): 不需要重启 App, 即可立即查看 UI 的变更 (使用 Desktop JVM 目标平台). 详情请参见 Hot Reload 文档.

已知的问题:

  • 在 Android Studio 中, Compose 调试器目前不支持 Kotlin 2.1.20 和 2.1.21. 这个问题将在 Kotlin 2.2.0-RC2 中修正.

plugin 支持 任何 Kotlin 版本, 但它的大部分功能依赖于 Kotlin 2.1.21. 请更新到 Kotlin 的最新稳定版本, 以确保获得最好的体验.

这个版本还需要 K2 模式, 请确认启用了 K2 模式: 在 Settings | Languages & Frameworks | Kotlin, 选择 Enable K2 mode.

0.8.4

发布日期: 2024/12/06

  • 支持 Kotlin 的 K2 模式, 改进了稳定性和代码分析.

Kotlin plugin 的任何版本

0.8.3

发布日期: 2024/07/23

  • 修正了对 Xcode 的兼容性问题.

Kotlin plugin 的任何版本

0.8.2

发布日期: 2024/05/16

  • 支持 Android Studio Jellyfish, 以及新的 Canary 版, Koala.

  • 在共用模块中添加 sourceCompatibilitytargetCompatibility 声明.

Kotlin plugin 的任何版本

0.8.1

发布日期: 2023/11/09

  • Kotlin 更新到 1.9.20.

  • Jetpack Compose 更新到 1.5.4.

  • 默认启用 Gradle 构建和配置的缓存.

  • 对新的 Kotlin 版本重构了构建配置.

  • iOS framework 默认为静态模式.

  • 修正了 iOS 设备上使用 Xcode 15 时的一个问题.

Kotlin Plugin 的任何版本

0.8.0

发布日期: 2023/10/05

  • KT-60169 迁移到 Gradle 版本目录.

  • KT-59269 android 重命名为 androidTarget.

  • KT-59269 更新了 Kotlin 和其他依赖项的版本.

  • KTIJ-26773 重构, 使用 -destination 参数, 代替 -sdk-arch.

  • KTIJ-25839 重构了生成的文件名.

  • KTIJ-27058 添加了 JVM 构建目标配置.

  • KTIJ-27160 支持 Xcode 15.0.

  • KTIJ-27158 将新的模块向导移动到实验状态.

Kotlin Plugin 的任何版本

0.6.0

发布日期: 2023/05/24

  • 支持新的 Canary Android Studio Hedgehog.

  • 更新 Kotlin, Gradle, 以及 Multiplatform 项目中库的版本.

  • 在 Multiplatform 项目中使用了新的 targetHierarchy.default().

  • 在 Multiplatform 项目中, 对平台特定的文件使用源代码集名称后缀.

Kotlin Plugin 的任何版本

0.5.3

发布日期: 2023/04/12

  • 更新了 Kotlin 和 Compose 的版本.

  • 修正了 Xcode 项目 scheme 解析的一个问题.

  • 添加了 scheme 的 product 类型检查.

  • 如果 iosApp scheme 存在, 默认选中.

Kotlin Plugin 的任何版本

0.5.2

发布日期: 2023/01/30

Kotlin Plugin 的任何版本

0.5.1

发布日期: 2022/11/30

Kotlin 1.7.0—*

0.5.0

发布日期: 2022/11/22

Kotlin 1.7.0—*

0.3.4

发布日期: 2022/09/12

Kotlin 1.7.0—1.7.*

0.3.3

发布日期: 2022/06/09

  • 依赖项更新为 Kotlin IDE plugin 1.7.0.

Kotlin 1.7.0—1.7.*

0.3.2

发布日期: 2022/04/04

  • 修正在 Android Studio 2021.2 和 2021.3 上的 iOS 应用程序调试性能问题.

Kotlin 1.5.0—1.6.*

0.3.1

发布日期: 2022/02/15

Kotlin 1.5.0—1.6.*

0.3.0

发布日期: 2021/11/16

Kotlin 1.6.0

0.2.7

发布日期: 2021/08/02

Kotlin 1.5.10

0.2.6

发布日期: 2021/06/10

  • 兼容 Android Studio Bumblebee Canary 1.

  • 支持 Kotlin 1.5.20: 在项目向导中为 Kotlin/Native 使用新的框架打包任务.

Kotlin 1.5.10

0.2.5

发布日期: 2021/05/25

Kotlin 1.5.10

0.2.4

发布日期: 2021/05/05

对 Android Studio 4.2 或 Android Studio 2020.3.1 Canary 8 或 更高版本, 请使用这个 plugin 版本.

Kotlin 1.5.0

0.2.3

发布日期: 2021/04/05

Kotlin 1.4.30

0.2.2

发布日期: 2021/03/03

Kotlin 1.4.30

0.2.1

发布日期: 2021/02/15

对 Android Studio 4.2, 请使用这个 plugin 版本.

Kotlin 1.4.30

0.2.0

发布日期: 2020/11/23

Kotlin 1.4.20

0.1.3

发布日期: 2020/10/02

  • 添加了对 iOS 14 和 Xcode 12 的兼容性.

  • 修正了 Kotlin Multiplatform Mobile 向导创建的平台测试中的名称.

0.1.2

发布日期: 2020/09/29

  • 修正了对 Kotlin 1.4.20-M1 的兼容性.

  • 默认启用向 JetBrains 发送错误报告.

0.1.1

发布日期: 2020/09/10

  • 修正了对 Android Studio Canary 8 和更高版本的兼容性.

0.1.0

发布日期: 2020/08/31

  • 这是 Kotlin Multiplatform Mobile plugin 的第 1 个版本. 详情请参见这篇 Blog.

2026/07/03