README.md

Lifecycle Coroutines

Coroutines integration with Lifecycles.

Extension properties:

Name	Description
Lifecycle.coroutineScope	A scope that dispatches on Android Main thread and is active until the Lifecycle is destroyed.
LifecycleOwner.coroutineScope	A scope that dispatches on Android Main thread and is active until the LifecycleOwner is destroyed.
Lifecycle.job	A job that is cancelled when the Lifecycle is destroyed.

Extension functions:

Name	Description
Lifecycle.createJob	A job that is active while the state is at least the passed one.
Lifecycle.createScope	A scope that dispatches on Android Main thread and is active while the state is at least the passed one.

Example

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        lifecycle.coroutineScope.launch {
            someSuspendFunction()
            someOtherSuspendFunction()
            someCancellableSuspendFunction()
        }
    }
    
    override fun onStart() {
        super.onStart()
        val startedScope = lifecycle.createScope(activeWhile = Lifecycle.State.STARTED)
        startedScope.launch {
            aCancellableSuspendFunction()
            yetAnotherCancellableSuspendFunction()
        }
        startedScope.aMethodThatWillLaunchSomeCoroutines()
    }
}

Note that this split includes a workaround for this performance issue in kotlinx.coroutines caused by ServiceLoader doing I/O. An alternative to Dispatchers.Main is used internally so it doesn't cause slow cold starts for your app. You can use it directly too as it is defined as Dispatchers.MainAndroid, but note that it will be removed when a fix in kotlinx.coroutines or in the Android toolchain is released.

Download

implementation "com.louiscad.splitties:splitties-lifecycle-coroutines:$splitties_version"