commit | 241e74e6a2cdadaa2753f40a326c732e95fac2d0 | [log] [tgz] |
---|---|---|
author | Roman Elizarov <elizarov@gmail.com> | Fri Sep 14 15:17:12 2018 +0300 |
committer | Roman Elizarov <elizarov@gmail.com> | Sun Sep 16 17:53:36 2018 +0300 |
tree | fb72d6760f8bf6f3c6ba6aa81f09ba17497420c5 | |
parent | 6e3ffb1c50e71f56277acfb60c1a7c599c4fea1c [diff] |
CoroutineScheduler: fixed race between createNewWorker & shutdown for tests
Library support for Kotlin coroutines with multiplatform support. This is a companion version for Kotlin 1.2.61 release.
GlobalScope.launch { delay(1000) println("Hello from Kotlin Coroutines!") }
launch
and async
coroutine builders;Job
and Deferred
light-weight future with cancellation support;delay
and yield
top-level suspending functions;Channel
and Mutex
communication and synchronization primitives;produce
and actor
coroutine builders;select
expression support and more.Dispatchers.IO
dispatcher for blocking coroutines.Promise
support.runBlocking
single-threaded event loop.CompletableFuture
, Guava ListenableFuture
, and synchronous networking/IO.Note that these libraries are experimental and are subject to change.
The libraries are published to kotlinx bintray repository, linked to JCenter and pushed to Maven Central.
Add dependencies (you can also add other modules that you need):
<dependency> <groupId>org.jetbrains.kotlinx</groupId> <artifactId>kotlinx-coroutines-core</artifactId> <version>0.26.0</version> </dependency>
And make sure that you use the latest Kotlin version:
<properties> <kotlin.version>1.2.61</kotlin.version> </properties>
Add dependencies (you can also add other modules that you need):
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-core:0.26.0'
And make sure that you use the latest Kotlin version:
buildscript { ext.kotlin_version = '1.2.61' }
Make sure that you have either jcenter()
or mavenCentral()
in the list of repositories:
repository { jcenter() }
Core modules of kotlinx.coroutines
are also available for Kotlin/JS and Kotlin/Native. If you write a common code that should get compiled or different platforms, add org.jetbrains.kotlinx:kotlinx-coroutines-core-common:<version>
to your common code dependencies.
Add kotlinx-coroutines-android
module as dependency when using kotlinx.coroutines
on Android:
implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:0.26.0'
This gives you access to Android Dispatchers.Main coroutine dispatcher and also makes sure that in case of crashed coroutine with unhandled exception this exception is logged before crashing Android application, similarly to the way uncaught exceptions in threads are handled by Android runtime.
In obfuscated code, fields with different types can have the same names, and AtomicReferenceFieldUpdater
may be unable to find the correct ones. To avoid field overloading by type during obfuscation, add this to your config:
-keepclassmembernames class kotlinx.** { volatile <fields>; }
This library is built with Gradle. To build it, use ./gradlew build
. You can import this project into IDEA, but you have to delegate build actions to Gradle (in Preferences -> Build, Execution, Deployment -> Build Tools -> Gradle -> Runner)
JAVA_HOME
environment variable.JDK_16
environment variable.All development (both new features and bug fixes) is performed in develop
branch. This way master
sources always contain sources of the most recently released version. Please send PRs with bug fixes to develop
branch. Fixes to documentation in markdown files are an exception to this rule. They are updated directly in master
.
The develop
branch is pushed to master
during release.