使用 Kotlin Toolchain 0.13 启动你的下一个 KMP 应用
内容提要
Kotlin Toolchain 0.13 发布，官方推荐用于大多数新 KMP 项目。该版本统一 CLI 入口，简化环境配置、构建、测试与发布，并支持 AI 智能体工作流。新增 kotlin new 命令、iOS 引导优化、下载进度显示、Android SDK 自动配置、SPM 依赖导入、Compose 资源发布及 Kotlin/Native 编译缓存，提升构建速度。
延伸解读
从 Alpha 到推荐：0.13 的定位变化
Kotlin Toolchain 在今年早些时候进入 Alpha，经过社区反馈和内部试用后，0.13 版本被官方推荐用于大多数新 KMP 项目。这意味着它不再只是实验性工具，而是新项目启动的默认选择之一。官方还计划在 KMP 入门指南、Web 和 IDE 项目向导中突出该工具，方便开发者和 AI 智能体在合适场景下选用。
AI 智能体工作流：不只是开发者工具
文章提到，Kotlin Toolchain 的自动环境配置、声明式配置和清晰错误信息，同样适合 AI 智能体使用。0.13 引入了 Hot Reload MCP 服务器和专用 AI 智能体技能，可通过 npx skills add kotlin/kotlin-agent-skills 安装。官方基准测试显示，AI 智能体生成和维护 Kotlin Toolchain 项目更可靠，且消耗更少 token。这些技能最终会直接通过 Toolchain 提供。
0.13 关键改进：从创建到构建的体验优化
新版本增加了 kotlin new 命令，提供类似 KMP 向导的交互式创建流程；kotlin init 仍可用，但行为已对齐，且直接在当前目录生成文件。iOS 引导方面，改进了 Xcode 安装诊断，并自动下载模拟器运行时、自动创建模拟器。CLI 现在显示下载进度条，Android SDK 在项目导入时自动配置，并加强了对 namespace 和 application ID 的校验，避免误用示例 ID。
性能与发布：缓存和依赖管理增强
Kotlin/Native 编译缓存（KTC-5422）可缓存已编译的原生依赖，并在构建甚至项目间复用；项目代码支持按文件缓存，链接时只重建受影响代码，从而加快编辑-构建-运行循环。该功能使用现有 settings.kotlin.compileIncrementally 设置，支持兼容目标上的非优化调试二进制，但编译为 .klib 仍全量运行。此外，SPM 依赖导入和 Compose 资源随多平台库发布，也简化了依赖管理。
Q&A
Kotlin Toolchain 0.13 是什么？它有什么作用？
Kotlin Toolchain 是一个统一的 Kotlin 入口点，允许你通过简单的声明式配置构建 JVM、Android、iOS、多平台和服务器端应用程序。它是一个单一的 CLI 入口点，用于配置环境、创建、构建、测试和发布 KMP 应用和库。
Kotlin Toolchain 0.13 为什么被推荐用于新的 KMP 项目？
因为经过内部试用和积极的社区反馈，官方对它有信心。它简化了入门流程，提供自动环境设置、直观的 CLI，并且对 AI 智能体友好。官方将在 KMP 入门指南、Web 和 IDE 项目向导中推荐它。
Kotlin Toolchain 0.13 新增了哪些主要功能？
新增了 kotlin new 命令（交互式创建项目）、iOS 引导优化（Xcode 诊断、自动下载模拟器运行时）、CLI 下载进度显示、Android SDK 自动配置、SPM 依赖导入、Compose 资源发布改进以及 Kotlin/Native 编译缓存。
如何使用 kotlin new 命令创建新项目？
运行 kotlin new 会启动交互式设置流程，首先提示选择应用类型，对于 Kotlin Multiplatform 应用，第二步可选择目标平台。kotlin init 命令仍然可用，但已更新为与 kotlin new 行为一致，不过它直接在当前目录生成项目文件。
Kotlin Toolchain 0.13 如何支持 AI 智能体工作流？
它引入了 Hot Reload MCP 服务器和专用的 AI 智能体技能，可通过 npx skills add kotlin/kotlin-agent-skills 安装。这些技能最终将通过 Kotlin Toolchain 直接提供。基准测试显示，AI 智能体生成和维护 Kotlin Toolchain 项目更可靠且消耗更少 token。
Kotlin Toolchain 0.13 在 iOS 开发方面有哪些改进？
在干净机器上设置 iOS 应用更顺畅：提供更好的 Xcode 安装诊断（如许可证接受和首次运行状态），自动下载 iOS 模拟器运行时，并在没有模拟器时自动创建。
Kotlin Toolchain 0.13 如何提升 Kotlin/Native 的构建速度？
通过 Kotlin/Native 编译器缓存（KTC-5422），缓存已编译的原生依赖并在构建甚至项目间重用。项目代码获得按文件缓存，链接时只重新编译受影响的代码。该功能使用现有的 settings.kotlin.compileIncrementally 设置，支持兼容目标上的非优化调试二进制文件。
Kotlin Toolchain 0.13 对 Android 开发有哪些改进？
现在在项目导入时自动配置缺失的 Android SDK 组件，使 CLI 和 IDE 行为一致。此外，加强了对命名空间和应用程序 ID 定义的验证，防止意外发布带有 com.example.app 等示例 ID 的应用或库构建。
Kotlin Toolchain 0.13 如何支持 Swift Package Manager 依赖？
支持 Apple 平台的 Swift Package Manager 依赖。具有 Apple 平台支持的模块可以导入 Objective-C API。导入的 Objective-C API 使用 swiftPMImport 前缀命名空间并以模块名结尾。还支持使用 localSwiftPackage 键的本地 SwiftPM 包。
Kotlin Toolchain 0.13 在多平台库发布方面有什么改进？
发布多平台库时，Compose Resources 和 SwiftPM 依赖元数据会随构建产物一起发布。Compose Resources 也会从第三方多平台库中解析。
