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 via PayPal to keep this space ad-free.

👶 Some of the Apps I built

Travelopy - travel discovery and journal
LuaPass - offline password manager
WhatIDoNow - a public log of things I am working on now

👨‍💻 Is your company hiring?

I am a full stack engineer (Python, Flask, JavaScript, Vue.js, Kotlin, Android) open to remote or relocation job opportunity. Check out my portfolio.

By Desmond Lua

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

Tags:

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