设置开发环境
在创建首个 Kotlin Multiplatform 应用前，您需要配置 KMP 开发环境。
安装必要工具
我们建议安装最新稳定版本以确保兼容性和最佳性能。
工具 | 说明 |
|---|---|
用于创建跨平台应用并在模拟器或实体设备上运行 | |
如需在iOS模拟器或真机运行应用则必须安装。使用其他操作系统可跳过 | 首次需单独启动Xcode接受许可协议并完成初始化配置 Xcode通常会在后台运行，主要用于为iOS应用添加Swift/Objective-C代码 |
在Android Studio终端或命令行执行以下命令检查Java是否安装： | |
在Android Studio中打开设置(偏好设置) ，进入Plugins页面，在Marketplace中搜索Kotlin Multiplatform并安装 | |
该插件已随Android Studio捆绑安装并自动更新 |
环境检查
建议通过KDoctor工具验证环境配置：
常见问题解决方案
- Kotlin与Android Studio问题
确认已从官网安装Android Studio
如遇
Kotlin not configured错误（Android Studio Giraffe 2022.3已知问题），点击忽略或升级至Hedgehog 2023.1版本
- Java与JDK问题
确认已从官网安装JDK
Android Studio使用内置JDK执行Gradle任务，如需配置请进入设置 | 构建工具 | Gradle
如遇
JAVA_HOME相关问题，按KDoctor提示设置该环境变量
- Xcode问题
确认已从官网安装Xcode
首次使用需单独启动Xcode完成初始化
如遇
Error: can't grab Xcode schemes等命令行工具问题：在终端执行：
sudo xcode-select --switch /Applications/Xcode.app或在Xcode的设置 | Locations中选择对应版本的Command Line Tools
确保选择的是
Xcode.app路径，必要时在弹窗中确认操作
- Kotlin插件问题
Kotlin Multiplatform插件
在欢迎界面进入Plugins | 已安装确认插件已启用，未安装则通过Marketplace搜索安装
插件过期时点击更新按钮，也可在设置 | 插件中操作
在版本详情表中核对插件与Kotlin版本的兼容性
Kotlin插件
在欢迎界面进入Plugins | 已安装 ，点击Kotlin旁的更新按钮确保使用最新版本
- 命令行问题
确保已安装必要工具：
command not found: brew— 安装Homebrewcommand not found: java— 安装Java
- 仍未解决？
通过创建YouTrack工单向团队反馈问题
获取帮助
Kotlin Slack ：获取邀请后加入#multiplatform频道
Kotlin问题追踪系统： 提交新问题