Kotlin 多平台快速入门

在本教程中，您将学习如何使用 Compose 多平台 UI 构建和运行一个简单的 Kotlin 多平台应用程序。

设置环境

首先需要一个集成开发环境（IDE）和必要的插件：

1. 选择并安装 IDE：IntelliJ IDEA 和 Android Studio 完全支持 Kotlin 多平台。

   JetBrains Toolbox App是安装 IDE 的推荐工具。它允许您管理多个产品或版本，包括抢先体验计划(EAP) 和每日构建版本。

   对于独立安装，请下载IntelliJ IDEA或Android Studio的安装程序。

   Kotlin Multiplatform 所需的插件至少需要IntelliJ IDEA 2025.2.2或Android Studio Otter 2025.2.1。

2. 安装Kotlin 多平台 IDE 插件。

   IDE 插件还会安装您的 IDE 尚未具备的任何必要依赖项。

如果尚未ANDROID_HOME设置该环境变量，请配置系统以识别它：

Bash 或 Zsh

Windows PowerShell 或 CMD

将以下命令添加到您的.profile或.zprofile：

export ANDROID_HOME=~/Library/Android/sdk

1. 要创建 iOS 应用，您需要一台安装了Xcode的 macOS 主机。您的 IDE 会在后台运行 Xcode 来构建 iOS 框架。

   在开始使用 KMP 项目之前，请务必至少启动一次 Xcode，以便完成初始设置。

   每次 Xcode 更新后，您都需要手动启动它并下载更新后的工具集。Kotlin 多平台 IDE 插件会进行预检，并在 Xcode 状态不正确时发出警报。

创建项目

Android Studio

使用IDE向导创建一个新的KMP项目：

1. 在主菜单中选择“文件” | “新建” | “新建项目” 。

2. 在默认的手机和平板电脑模板类别中选择Kotlin Multiplatform。

   

3. 根据需要设置项目的名称、位置和其他基本属性，然后单击“下一步”。

4. 要创建完整演示，请选择所有可用平台：Android、iOS、桌面、Web 和服务器。如果可用，请保持选中“共享 UI”选项，以便使用 Compose Multiplatform 作为相应目标的 UI 框架。

   桌面目标会自动包含Compose 热重载功能，让您在保存代码更改后立即看到 UI 变化。即使您不打算开发桌面应用程序，也可以将桌面目标添加到项目中，以加快 UI 代码的迭代速度。

5. 选择好平台后，点击“完成”按钮，等待 IDE 生成并导入项目。

请参阅飞行前检查清单

您可以通过打开“项目环境预检”工具窗口来确保项目设置不存在任何环境问题：单击右侧边栏或底部栏上的预检图标。

在这个工具窗口中，您可以查看与这些检查相关的消息、重新运行这些检查或更改它们的设置。

预检命令也可在“搜索所有位置”对话框中找到。双击Shift并搜索包含“预检”一词的命令：

运行示例应用程序

IDE向导创建的项目包含为iOS、Android、桌面和Web应用程序生成的运行配置，以及用于运行服务器应用程序的Gradle任务。每个平台的具体Gradle命令如下所示。

安卓

要运行 Android 应用，请启动androidApp运行配置：

要手动创建 Android 运行配置，请选择Android App作为运行配置模板，然后选择模块[项目名称].androidApp。

默认情况下，它会在第一个可用的虚拟设备上运行：

故障排除

Java 和 JDK

Java常见问题：

• 某些工具可能找不到可运行的 Java 版本，或者使用了错误的版本。要解决此问题：

  • 将环境变量设置JAVA_HOME为相应 JDK 的安装目录。

    我们建议使用JetBrains Runtime，它是 OpenJDK 的一个分支，支持类重新定义。

  • bin将文件夹路径添加JAVA_HOME到PATH变量中，以便在终端中使用 JDK 中包含的工具。

• 如果在 Android Studio 中使用 Gradle JDK 时遇到问题，请确保其配置正确：选择“设置” | “构建、执行、部署” | “构建工具” | “Gradle”。

Android 工具

与 JDK 类似，如果您在启动 Android 工具（例如 ）时遇到问题adb，请确保将ANDROID_HOME/tools、ANDROID_HOME/tools/bin和 的路径ANDROID_HOME/platform-tools添加到您的PATH环境变量中。

Xcode

如果您的 iOS 运行配置报告没有虚拟设备可供运行，或者预检失败，请确保启动 Xcode 并查看 iOS 模拟器是否有任何更新。

获取帮助

• Kotlin Slack。获取邀请并加入#multiplatform频道。

• Kotlin 多平台工具问题跟踪器。报告新问题。

接下来会发生什么？

了解更多关于KMP项目结构和编写共享代码的信息：

• 本系列教程将介绍如何使用 Compose Multiplatform 处理共享 UI 代码：创建您的 Compose Multiplatform 应用

• 本系列教程将介绍如何在具有原生 UI 的项目中处理共享代码：创建您的 Kotlin 多平台应用

• 深入阅读 Kotlin 多平台文档：

  • 项目配置

  • 处理多平台依赖项

• 了解 Compose Multiplatform UI 框架、其基本原理和平台特定功能：Compose Multiplatform 和 Jetpack Compose 之间的关系。

发现已为 KMP 编写的代码：

• 我们的示例页面，包含 JetBrains 官方示例以及精选的展示 KMP 功能的项目列表。

• GitHub 主题：

  • kotlin-multiplatform，使用 Kotlin Multiplatform 实现的项目。

  • kotlin-multiplatform-sample，一个使用 KMP 编写的示例项目列表。

• klibs.io – KMP 库的搜索平台，目前已收录超过 2000 个库，包括 OkHttp、Ktor、Coil、Koin、SQLDelight 等。

翻译来源：https://kotlinlang.org/docs/multiplatform/quickstart.html#what-s-next