v1.6.0

Compare Source

Note that this is a full changelog relative to the 1.5.2 version. Changelog relative to 1.6.0-RC3 can be found at the end.

kotlinx-coroutines-test rework

• kotlinx-coroutines-test became a multiplatform library usable from K/JVM, K/JS, and K/N.
• Its API was completely reworked to address long-standing issues with consistency, structured concurrency and correctness (#​1203, #​1609, #​2379, #​1749, #​1204, #​1390, #​1222, #​1395, #​1881, #​1910, #​1772, #​1626, #​1742, #​2082, #​2102, #​2405, #​2462
  ).
• The old API is deprecated for removal, but the new API is based on the similar concepts (README), and the migration path is designed to be graceful: migration guide.

Dispatchers

• Introduced CoroutineDispatcher.limitedParallelism that allows obtaining a view of the original dispatcher with limited parallelism (#​2919).
• Dispatchers.IO.limitedParallelism usages ignore the bound on the parallelism level of Dispatchers.IO itself to avoid starvation (#​2943).
• Introduced new Dispatchers.shutdown method for containerized environments (#​2558).
• newSingleThreadContext and newFixedThreadPoolContext are promoted to delicate API (#​2919).

Breaking changes

• When racing with cancellation, the future builder no longer reports unhandled exceptions into the global CoroutineExceptionHandler. Thanks @​vadimsemenov! (#​2774, #​2791).
• Mutex.onLock is deprecated for removal (#​2794).
• Dispatchers.Main is now used as the default source of time for delay and withTimeout when present(#​2972).
  • To opt-out from this behaviour, kotlinx.coroutines.main.delay system property can be set to false.
• Java target of coroutines build is now 8 instead of 6 (#​1589).
• Source-breaking change: extension collect no longer resolves when used with a non-in-place argument of a functional type. This is a candidate for a fix, uncovered after 1.6.0, see #​3107 for the additional details.

Bug fixes and improvements

• Kotlin is updated to 1.6.0.
• Kotlin/Native new memory model is now supported in regular builds of coroutines conditionally depending on whether kotlin.native.binary.memoryModel is enabled (#​2914).
• Introduced CopyableThreadContextElement for mutable context elements shared among multiple coroutines. Thanks @​yorickhenning! (#​2893).
• transformWhile, awaitClose, ProducerScope, merge, runningFold, runingReduce, and scan are promoted to stable API (#​2971).
• SharedFlow.subscriptionCount no longer conflates incoming updates and gives all subscribers a chance to observe a short-lived subscription (#​2488, #​2863, #​2871).
• Flow exception transparency mechanism is improved to be more exception-friendly (#​3017, #​2860).
• Cancellation from flat* operators that leverage multiple coroutines is no longer propagated upstream (#​2964).
• SharedFlow.collect now returns Nothing (#​2789, #​2502).
• DisposableHandle is now fun interface, and corresponding inline extension is removed (#​2790).
• FlowCollector is now fun interface, and corresponding inline extension is removed (#​3047).
• Deprecation level of all previously deprecated signatures is raised (#​3024).
• The version file is shipped with each JAR as a resource (#​2941).
• Unhandled exceptions on K/N are passed to the standard library function processUnhandledException (#​2981).
• A direct executor is used for Task callbacks in kotlinx-coroutines-play-services (#​2990).
• Metadata of coroutines artifacts leverages Gradle platform to have all versions of dependencies aligned (#​2865).
• Default CoroutineExceptionHandler is loaded eagerly and does not invoke ServiceLoader on its exception-handling path (#​2552).
• Fixed the R8 rules for ServiceLoader optimization (#​2880).
• Fixed BlockHound integration false-positives (#​2894, #​2866, #​2937).
• Fixed the exception handler being invoked several times on Android, thanks to @​1zaman (#​3056).
• SendChannel.trySendBlocking is now available on Kotlin/Native (#​3064).
• The exception recovery mechanism now uses ClassValue when available (#​2997).
• JNA is updated to 5.9.0 to support Apple M1 (#​3001).
• Obsolete method on internal Delay interface is deprecated (#​2979).
• Support of deprecated CommonPool is removed.
• @ExperimentalTime is no longer needed for methods that use Duration (#​3041).
• JDK 1.6 is no longer required for building the project (#​3043).
• New version of Dokka is used, fixing the memory leak when building the coroutines and providing brand new reference visuals (https://kotlin.github.io/kotlinx.coroutines/) (#​3051, #​3054).

Changelog relative to version 1.6.0-RC3

• Restored MPP binary compatibility on K/JS and K/N (#​3104).
• Fixed Dispatchers.Main not being fully initialized on Android and Swing (#​3101).