Set up an environment

Before you create your first Kotlin Multiplatform application, you need to set up an environment for KMP development.

Install the necessary tools

We recommend that you install the latest stable versions for compatibility and better performance.

Tool	Comments
Android Studio	You will use Android Studio to create your multiplatform applications and run them on simulated or hardware devices.
Xcode Xcode is required if you want to run iOS applications on a simulated or real device. If you use a different operating system, skip this tool.	Launch Xcode in a separate window to accept its license terms and allow it to perform some necessary initial tasks. Most of the time, Xcode will work in the background. You will use it to add Swift or Objective-C code to your iOS application. We generally recommend using the latest stable versions for all tools. However, Kotlin/Native sometimes doesn't support the newest Xcode right away. You can check supported versions in the compatibility guide, and if necessary, install an earlier version of Xcode.
JDK	To check whether Java is installed, run the following command in the Android Studio terminal or your command line: `java -version`
Kotlin Multiplatform plugin	In Android Studio, open Settings (Preferences) and find the Plugins page. Search the Marketplace tab for Kotlin Multiplatform, and then install it. The KMP plugin doesn't support K2 mode) yet. To use the plugin, disable K2 mode: in your IDE, go to Settings \| Languages & Frameworks \| Kotlin and uncheck the Enable K2 mode option.
Kotlin plugin	The Kotlin plugin is bundled and automatically updated with each Android Studio release.

Check your environment

To make sure everything works as expected, install and run the KDoctor tool:

In the Android Studio terminal or your command-line tool, run the following command to install the tool using Homebrew:
brew install kdoctor
If you don't have Homebrew yet, install it or see the KDoctor README for other ways to install it.
After the installation is completed, call KDoctor in the console:
kdoctor
If KDoctor diagnoses any problems while checking your environment, review the output for issues and possible solutions:
- Fix any failed checks ([x]). You can find problem descriptions and potential solutions after the * symbol.
- Check the warnings ([!]) and successful messages ([v]). They may contain useful notes and tips, as well.
You may ignore KDoctor's warnings regarding the CocoaPods installation. In your first project, you will use a different iOS framework distribution option.

Possible issues and solutions

Kotlin and Android Studio

Make sure that you have Android Studio installed. You can get it from its official website.
You may encounter the Kotlin not configured error. It's a known issue in Android Studio Giraffe 2022.3 that doesn't affect building and running projects. To avoid the error, click Ignore or upgrade to Android Studio Hedgehog 2023.1.

Java and JDK

Make sure that you have JDK installed. You can get it from its official website.
Android Studio uses a bundled JDK to execute Gradle tasks. To configure the Gradle JDK in Android Studio, select Settings/Preferences | Build, Execution, Deployment | Build Tools | Gradle.
You might encounter issues related to JAVA_HOME. This environment variable specifies the location of the Java binary required for Xcode and Gradle. If so, follow KDoctor's tips to fix the issues.

Xcode

Make sure that you have Xcode installed. You can get it from its official website.
If you haven't launched Xcode yet, open it in a separate window. Accept the license terms and allow it to perform some necessary initial tasks.
You may encounter Error: can't grab Xcode schemes or other issues regarding command line tools selection. In this case, do one of the following:
- In Terminal, run:
  sudo xcode-select --switch /Applications/Xcode.app
- Alternatively, in Xcode, select Settings | Locations. In the Command Line Tools field, select your Xcode version.
  Make sure that the path to Xcode.app is selected. Confirm the action in a separate window if required.

Kotlin plugins

Kotlin Multiplatform plugin

Make sure that the Kotlin Multiplatform plugin is installed and enabled. On the Android Studio welcome screen, select Plugins | Installed. Verify that you have the plugin enabled. If it's not in the Installed list, search Marketplace for it and install the plugin.
If the plugin is outdated, click Update next to the plugin name. You can do the same in the Settings/Preferences | Tools | Plugins section.
Check the compatibility of the Kotlin Multiplatform plugin with your version of Kotlin in the Release details table.

Kotlin plugin

Make sure that the Kotlin plugin is updated to the latest version. To do that, on the Android Studio welcome screen, select Plugins | Installed. Click Update next to Kotlin.

Command line

Make sure you have all the necessary tools installed:

command not found: brew — install Homebrew.
command not found: java — install Java.

Still having trouble?

Share your problems with the team by creating a YouTrack issue.

For a smoother multiplatform experience, you can also try JetBrains Fleet: it integrates with Compose Multiplatform and allows writing Swift code without switching to Xcode, with less IDE juggling overall.

Get help

Kotlin Slack. Get an invite and join the #multiplatform channel.
Kotlin issue tracker. Report a new issue.

Last modified: 05 December 2024