Android Kotlin Coroutines Setup and Basic Usage

October 5, 2018

Why use Kotlin Coroutines?

My favourite reason: Kotlin Coroutines allow writing asynchronous code in a sequential manner (no more callbacks, and sequential codes are very readable). I used to use RxJava.
Coroutine is more lightweight than a thread.
Really nice syntax.

Setup Android Kotlin Coroutines

Edit Module build.gradle.

dependencies {
    ...
    // https://mvnrepository.com/artifact/org.jetbrains.kotlinx/kotlinx-coroutines-android
    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:0.23.4'
}

Edit gradle.properties.

kotlin.coroutines=enable

Basic Usage

Launch a background coroutine.

launch {
    // do something
}

Launch a couroutine in UI Thread.

launch(UI) {
    // update UI
}

You can launch a background coroutine for some heavy task, then launch UI coroutine to update the UI.

launch {
    // do some heavy processing

    launch(UI) {
        // update UI
    }
}

If you need to wait for a result from a coroutine, use async.

launch(UI) {
    var deferred = async(CommonPool) {
        getRemoteName()
    }

    val name = deferred.await()
    nameEditText.text = name
}

You can write a cancellable coroutine.

You can write suspend function which must be called within coroutines.

Use coroutines to delay a job.

Convert Callback Into Kotlin Coroutines Suspend or Deferred.

Kotlin Android Coroutine Context: Default Dispatcher, CommonPool and UI

You can use Retrofit2 with Kotlin Coroutines to remove all the messy callbacks.

References:

By Desmond Lua

A dream boy who enjoys programming and travelling, maker of Travelopy. Follow me on @d_luaz.

Tags:

Related entries:

Setup Dagger 2 For Android Kotlin

Guide to learning Android Dev with Kotlin and Architecture Components (ViewModel, LiveData and Room)

Kotlin Coroutines Wait Task to Complete

Convert Callback to Kotlin Coroutines

Migrating to Android Kotlin 1.3 Coroutines

Android Standardize Context and Activity Property for Activity and Fragment

Kotlin Android Extentions ViewBinding for RecyclerView ViewHolder (LayoutContainer)

Convert Callback Into Kotlin Coroutines Suspend or Deferred

Kotlin Coroutines Delay Job (Synchronized)

Kotlin Android Coroutine Context: Default Dispatcher vs Commonpool

Android Check File Exist (Kotlin)

Syntax To Inject Constructor For Kotlin