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:

❤️ Is this article helpful?

Buy me a coffee☕ or support my work to keep this space 🖖 and ad-free.
If you can't, do send some 💖 to @d_luaz or help to share this article.

👶 Apps I built

COVID-19 - data, chart, information & news.
暖心芽 (WIP) 🌞❤️🌱 - reminder of hope, warmth, thoughts and feelings.
Travelopy - travel discovery and journal
LuaPass - offline password manager
WhatIDoNow - a public log of things I am working on now

By Desmond Lua

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

Tags:

Related entries:

Kotlin Serialization and Json (Android)

Android Kotlin Coroutine Scope for Activity, Fragment and ViewModel (Architecture Components)

Setup Android Kotlin Coroutines (1.1) With Coroutine Scope

Setup Dagger 2 For Android Kotlin

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

CoroutineWorker: Use Kotlin Coroutines in WorkManager

Kotlin Coroutines Wait Task to Complete

Convert Callback to Kotlin Coroutines