Injection library for Compose, wrapping Koin. Configures dependency injection using `@Composable` functions, supports scoped dependencies, ViewModel integration, and Compose navigation enhancements.
Injection library for Compose (Multiplatform and Jetpack), Koin wrapper. It uses @Composable
functions to configure KoinContext.
Library is hosted on Maven Central. Add following the packages to your module build.gradle.kts or build.gradle:
dependencies {
implementation("dev.burnoo:cokoin:1.0.0")
implementation("dev.burnoo:cokoin-android-viewmodel:1.0.0") // for Androidx ViewModel
implementation("dev.burnoo:cokoin-android-navigation:1.0.0") // for Compose Navigation
// REMOVE "org.koin:koin-androidx-compose:X.Y.Z" if you were using it
}
The library is using Koin's Application and Modules. The Koin documentation can be found here: https://insert-koin.io/.
The core library contains @Composable Koin function, which is used to configure Koin application. It can be used with @Preview.
val appModule = module {
factory { "Hello, DI!" }
}
@Preview
@Composable
fun App() {
Koin(appDeclaration = { modules(appModule) }) {
val text = get<String>()
Text(text)
}
}
Scopes are created by wrapping composables in @Composable KoinScope:
data class A(val value: String)
val scopedModule = module {
scope<ScopeTypeA> {
scoped { A("scopeA") }
}
scope<ScopeTypeB> {
scoped { A("scopeB") }
}
}
@Preview
@Composable
fun Test() {
Koin(appDeclaration = { modules(scopedModule) }) {
Column {
KoinScope(getScope = { createScope<ScopeTypeA>() }) {
Text(<A>().value)
}
KoinScope(getScope = { createScope<ScopeTypeB>() }) {
Text(<A>().value)
}
}
}
}
dev.burnoo:cokoin-android-viewmodel:x.y.zCall getViewModel to obtain ViewModel inside @Composable:
class MainViewModel : ViewModel() {
val data = "Hello, DI!"
}
private val viewModelModule = module {
viewModel { MainViewModel() }
}
@Composable
fun ViewModelSample() {
Koin(appDeclaration = { modules(viewModelModule) }) {
val viewModel = getViewModel<MainViewModel>()
Text(viewModel.data)
}
}
getViewModel
supports Koin's injection parameters
and SaveStateHandle. Advanced examples can be
found here.
dev.burnoo:cokoin-android-navigation:x.y.zFirst replace NavHost with KoinNavHost:
@Composable
fun Sample() {
val navController = rememberNavController()
Koin(appDeclaration = { modules(viewModelModule) }) {
KoinNavHost(navController, startDestination = "1") {
composable("1") {
Screen1()
}
}
}
}
Then use getNavController and getNavViewModel inside composable screen.
@Composable
fun Screen1() {
val navController = getNavController()
Button(onClick = { navController.navigate("2") }) {
val navViewModel = getNavViewModel<MainViewModel>()
//...
}
}
If you don't want to wrap navigation with KoinNavHost,
you can achieve similar results with getViewModel using viewModelStoreOwner parameter:
@Composable
fun Screen1(navController: NavController) {
Button(onClick = { navController.navigate("2") }) {
val viewModel = getViewModel<MainViewModel>(
viewModelStoreOwner = navController.getBackStackEntry("root")
)
//...
}
}
Copyright 2021 Bruno Wieczorek
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance the License.
You may obtain a copy of the License at
http:
Unless applicable law agreed to writing, software
distributed under the License distributed an BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express implied.
See the License the specific language governing permissions
limitations under the License.
Surfaced from shared tags and platforms — no rankings paid for.