kotlinx.coroutines

Library support for Kotlin coroutines. This is a companion version for Kotlin 1.1.0 release.

Modules

Basic modules:

• kotlinx-coroutines-core -- core primitives to work with coroutines.
• kotlinx-coroutines-jdk8 -- additional libraries for JDK8 (or Android API level 24).
• kotlinx-coroutines-nio -- extensions for asynchronous IO on JDK7+.

Modules that provide builders and iteration support for various reactive streams libraries:

• kotlinx-coroutines-reactive -- utilities for Reactive Streams
• kotlinx-coroutines-rx1 -- utilities for RxJava 1.x
• kotlinx-coroutines-rx2 -- utilities for RxJava 2.x

Modules that provide coroutine dispatchers for various single-threaded UI libraries:

• kotlinx-coroutines-android -- UI context for Android applications.
• kotlinx-coroutines-javafx -- JavaFx context for JavaFX UI applications.
• kotlinx-coroutines-swing -- Swing context for Swing UI applications.

Documentation

• Guide to kotlinx.coroutines by example (read it first)
• Guide to UI programming with coroutines
• Change log for kotlinx.coroutines
• Coroutines design document (KEEP)
• Full kotlinx.coroutines API reference

Using in your projects

Note that these libraries are experimental and are subject to change.

The libraries are published to kotlin-eap-1.1 bintray repository.

These libraries require kotlin compiler version to be at least 1.1.0 and require kotlin runtime of the same version as a dependency.

Maven

Add the bintray repository to <repositories> section (and also add pluginRepository to <pluginRepositories>, if you're willing to get kotlin-maven-plugin from there):

<repository>
    <snapshots>
        <enabled>false</enabled>
    </snapshots>
    <id>dl</id>
    <name>bintray</name>
    <url>http://dl.bintray.com/kotlin/kotlin-eap-1.1</url>
</repository>

Add dependencies (you can also add other modules that you need):

<dependency>
    <groupId>org.jetbrains.kotlinx</groupId>
    <artifactId>kotlinx-coroutines-core</artifactId>
    <version>0.12</version>
</dependency>

And make sure that you use the right Kotlin version:

<properties>
    <kotlin.version>1.1.0</kotlin.version>
</properties>

Gradle

Add the bintray repository (and also add it to buildScript section, if you're willing to get kotlin-gradle-plugin from there):

repositories {
    maven {
        url "http://dl.bintray.com/kotlin/kotlin-eap-1.1"
    }
}

Add dependencies (you can also add other modules that you need):

compile 'org.jetbrains.kotlinx:kotlinx-coroutines-core:0.12'

And make sure that you use the right Kotlin version:

buildscript {
    ext.kotlin_version = '1.1.0'
}