Skip to main content

WorkManager

The koin-androidx-workmanager project is dedicated to bring Android WorkManager features.

WorkManager DSL

Setup WorkManager

At start, in your KoinApplication declaration, use the workManagerFactory() keyword to a setup custom WorkManager instance:

class MainApplication : Application(), KoinComponent {

override fun onCreate() {
super.onCreate()

startKoin {
// setup a WorkManager instance
workManagerFactory()
modules(...)
}

setupWorkManagerFactory()
}

It's also important that you edit your AndroidManifest.xml to prevent Android initializing its default WorkManagerFactory, as shown in https://developer.android.com/topic/libraries/architecture/workmanager/advanced/custom-configuration#remove-default . Failing to do so will make the app crash.

    <application . . .>
. . .
<provider
android:name="androidx.startup.InitializationProvider"
android:authorities="${applicationId}.androidx-startup"
android:exported="false"
tools:node="merge">
<meta-data
android:name="androidx.work.WorkManagerInitializer"
android:value="androidx.startup"
tools:node="remove" />
</provider>
</application>

Declare ListenableWorker

val appModule = module {
single { MyService() }
worker { MyListenableWorker(get()) }
}

Creating extra work manager factories

You can also write a WorkManagerFactory and hand it over to Koin. It will be added as a delegate.

class MainApplication : Application(), KoinComponent {

override fun onCreate() {
super.onCreate()

startKoin {
workManagerFactory(workFactory1, workFactory2)
. . .
}

setupWorkManagerFactory()
}
}

In case both Koin and workFactory1 provided WorkManagerFactory can instantiate a ListenableWorker, the factory provided by Koin will be the one used.

A few assumptions

Add manifest changes in koin lib itself

We can make it one step less for application developers if koin-androidx-workmanager's own manifest disables the default work manager. However, it can be confusing since if the app developer don't initialize koin's work manager infrastructure, he'll end up having no usable work manager factories.

That's something that checkModules could help: if any class in the project implements ListenableWorker we inspect both manifest and code and make sure they make sense?

DSL Improvement option:


val workerFactoryModule = module {
factory<WorkerFactory> { WorkerFactory1() }
factory<WorkerFactory> { WorkerFactory2() }
}

then have koin internals do something like

fun Application.setupWorkManagerFactory(
// no vararg for WorkerFactory
) {
. . .
getKoin().getAll<WorkerFactory>()
.forEach {
delegatingWorkerFactory.addFactory(it)
}
}