Need help with kotlin-native?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

6.9K Stars 620 Forks Apache License 2.0 6.7K Commits 92 Opened issues


Kotlin/Native infrastructure

Services available


Need anything else?

Contributors list

official project version


Kotlin/Native is an LLVM backend for the Kotlin compiler, runtime implementation, and native code generation facility using the LLVM toolchain.

Kotlin/Native is primarily designed to allow compilation for platforms where virtual machines are not desirable or possible (such as iOS or embedded targets), or where a developer is willing to produce a reasonably-sized self-contained program without the need to ship an additional execution runtime.

Prerequisites: * install JDK for your platform, instead of JRE. The build requires

, which is not included in JRE; * on macOS install Xcode 11 (Xcode 12.0 is required to compile Kotlin/Native from sources) * on Fedora 26+
yum install ncurses-compat-libs
may be needed * on recent Ubuntu
apt install libncurses5
is needed

To compile from sources use following steps:

First, download dependencies:

./gradlew dependencies:update

Then, build the compiler and libraries:

./gradlew bundle

To build with experimental targets support compile with


The build can take about an hour on a Macbook Pro. To run a shorter build with only the host compiler and libraries, run:

./gradlew dist distPlatformLibs

To include Kotlin compiler in composite build and build against it, use the

project property:
./gradlew dist -PkotlinProjectPath=path/to/kotlin/project

It's possible to include in a composite build both Kotlin compiler and Kotlin/Native Shared simultaneously.

After that, you should be able to compile your programs like this:

export PATH=./dist/bin:$PATH
kotlinc hello.kt -o hello

For an optimized compilation, use

kotlinc hello.kt -o hello -opt

For tests, use:

./gradlew backend.native:tests:run

To generate interoperability stubs, create a library definition file (refer to

), and run the

tool like this:
cinterop -def lib.def

See the provided samples and
for more details.

The Interop tool generates a library in the

library format. See
for more details on this file format.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.