使用 Kotlin Toolchain 创建并发布 Kotlin Multiplatform 应用程序
Kotlin Toolchain 是 JetBrains 推出的一款用于构建、测试、运行和发布 Kotlin 项目的工具。 它提供了 CLI 和声明式配置,因此你可以在终端、IDE 或 AI 辅助开发工具中工作: Kotlin Toolchain 允许你的编码 Agent(coding agent)只需极少设置和配置即可从新建项目一路推进到应用发布。
Kotlin AI skills 官方仓库包含了专门针对 Kotlin Toolchain 的 skills。
本页面将指导你使用 Kotlin Toolchain 从头开始搭建 Kotlin Multiplatform 项目。
你也可以直接向你的 Agent 提问:
Create a new Kotlin Multiplatform app for Android, iOS, desktop, and web with the Kotlin Toolchain CLI (https://kotlin-toolchain.org/latest).Kotlin Toolchain 目前处于 Alpha 阶段。 欢迎在你的 Kotlin Multiplatform 项目中试用它。 期待你在 YouTrack 以及专属 Slack 频道中提供反馈。
前提条件
安装 Kotlin Toolchain CLI
你的 Agent 可以自行安装 Kotlin Toolchain,但你也可以使用安装脚本手动进行安装:
curl -fsSL https://kotl.in/install.sh | shpowershell -ExecutionPolicy ByPass -c "irm 'https://kotl.in/install.ps1' | iex"安装脚本会下载 Kotlin Toolchain CLI,将其放置在 ~/.local/bin 中,并确保它已添加到你的 PATH。无需使用 sudo 命令。
运行 kotlin --version 检查 CLI 是否可用。
构建 iOS 应用
借助 Kotlin Toolchain,你可以直接在 CLI 或 IDE 中处理绝大部分 iOS 开发工作流程,包括构建、运行和发布应用,无需打开 Xcode。
当需要 Xcode 时,Kotlin Toolchain 会提示安装它并说明如何进行配置。推荐的方式是从 App Store 安装 Xcode。
安装 Xcode 是必要的,以便为 Kotlin Toolchain 提供用于 iOS 构建的 CLI 以及偶尔需要的特定项目工作流。
创建项目
要使用 Kotlin Toolchain 生成新项目:
导航到你希望 Kotlin Toolchain 创建项目的目录,例如 Projects。
运行以下命令:
shellkotlin new当提示输入项目路径时,输入目录名称,例如
ktc-kmp。在模板列表中,选择 Kotlin Multiplatform application。
使用空格键选择或取消选择目标平台。按 Enter 键确认。
即使你的最终应用只面向 Android 和 iOS,也建议考虑添加桌面目标。 它可以实现更快的开发与迭代循环,并支持 Compose Hot Reload, 让你无需重启应用即可查看 UI 更改。
输入项目 ID,或留空以根据目录名称生成默认 ID。
该 ID 在整个项目中用于标识应用:包括 Kotlin 包名、Android 命名空间与 application ID,以及 iOS bundle ID。
确认安装 AI Agent 配置:这将创建包含通用建议和 MCP 服务器配置的项目专用 AGENTS.md。
使用空格键选择你偏好的 AI Agent。按 Enter 键确认。
Kotlin Toolchain 会生成项目,包括配置文件、源代码和包装器脚本。默认情况下,它还会初始化一个 Git 仓库。
生成的项目包含多个带有各平台应用程序入口点的 *App 模块,以及一个带有通用代码的 shared 模块。每个模块都会在全局 project.yaml 文件中列出,并通过其各自的 module.yaml 文件进行配置。每个应用程序模块都显式依赖于 shared 模块。例如,对于 Android 模块:
# androidApp/module.yaml
product: android/app
dependencies:
# Shared 模块依赖项
- //shared
# Android 专属依赖项
- $libs.androidx.activity.compose
- $compose.preview
- $compose.uiTooling
settings:
compose: enabled
android:
namespace: org.example.ktckmp
applicationId: org.example.ktckmp每个模块的基本结构遵循 KMP 源集模型,不同之处在于,例如不是 androidMain,而是 src@android。
运行项目
要运行项目:
导航到项目目录(上述示例中的
ktc-kmp)。运行
kotlin run以调出可运行的应用程序列表。可用模块与你在生成项目时选择的目标平台相对应:shell$ kotlin run Multiple modules are available to run, please choose: ❯ desktopApp (with Hot Reload 🔥) androidApp iosApp webApp你也可以使用
-m(--module)选项直接运行某个模块,例如:shell# 构建并运行桌面 JVM 应用 kotlin run -m desktopApp
发布应用程序
当你对应用的运行效果满意后,就可以发布应用程序了。
针对 iOS
Kotlin Toolchain 可帮助你简化发布到 TestFlight 的配置流程。要发布你的 iOS 应用,请运行:
kotlin publish testflight该命令会启动一个带有详细说明的向导。它会引导你使用 App Store Connect API 密钥配置发布流程,只需极少的手动操作。对于后续版本,使用同一命令即可自动进行发布。
有关手动设置和发布的说明,请参阅 Kotlin Toolchain 文档。
针对 Android
要配置并发布你的 Android 应用,请按照 Kotlin Toolchain 文档中的说明进行操作。
其他目标平台
你也可以打包 JVM 应用或 Wasm 应用,但尚未完全支持发布到这些平台。
在 IntelliJ IDEA 或 Android Studio 中开发项目
你可以在 IntelliJ IDEA 或 Android Studio 中处理并运行该项目。
要在 Android Studio 中使用完整的 Kotlin Toolchain 功能,请使用最新稳定版本, 至少为 Android Studio Rabbit。
安装 Kotlin Multiplatform 插件,即可为 Kotlin Multiplatform 项目添加 IDE 支持,同时支持 Kotlin Toolchain 的项目结构和运行配置。
直接在 IDE 中创建项目
安装 Kotlin Multiplatform 和 Kotlin Toolchain 插件后,你还可以直接在 IDE 中创建新项目:
- 打开 IntelliJ IDEA 或 Android Studio。
- 选择 File | New | Project。
- 选择 Kotlin Multiplatform,并在构建系统开关中选择 Kotlin Toolchain。
- 填写其余的项目详细信息,然后点击 Create。
当项目创建并导入后,IDE 会自动为所有已声明的模块注册运行配置,以便你可以直接从 IDE 工具栏运行相应的应用程序。
