一、简介
Koin是一款轻量级的依赖注入框架,它允许Android应用程序轻松管理组件之间的依赖关系。
Koin的主要目标是使依赖注入变得简单,易于理解和使用。它采用纯Kotlin编写,无代理,无需代码生成或反射,而是基于函数式DSL和注解,提供了一个简单而强大的方式来声明和管理依赖项。
以下是 Koin 和 Hilt 的对比表:
功能 | Koin | Hilt |
---|---|---|
轻量级 | 是 | 否 |
易于使用 | 是 | 是 |
可用于 Android、Kotlin Native 和 JavaScript | 是 | 否 |
具有广泛的社区支持 | 是 | 是 |
与 Android 生命周期集成 | 否 | 是 |
支持自动注入 | 否 | 是 |
与 Jetpack 组件集成 | 否 | 是 |
具有 Google 的支持 | 否 | 是 |
二、使用
1、添加依赖
在build.gradle中添加依赖
//core为Koin的核心
implementation("io.insert-koin:koin-core:3.4.0")
//android是Koin为Android提供的一些扩展方法
implementation("io.insert-koin:koin-android:3.4.0")
//compat是Koin为Android组件提供的一些扩展方法
implementation("io.insert-koin:koin-android-compat:3.4.0")
}
2、注入对象定义
// 定义三个对象:分别是常规对象注入、单例对象注入、ViewModel对象注入
//1、常规对象定义及注入
class NormalKoin {
}
// normalMoudle就是来管理常规的对象注入
val normalModule = module {
factory { NormalKoin() }
}
//2、单例对象定义及注入
class SingletonKoin {
}
// singleModule则是用来单例对象注入
val singleModule = module {
single { SingletonKoin () }
}
// 3、有参ViewModel定义及注入
class KoinViewModel(private val repository: Repository): ViewModel() {
}
class Repository() {
}
//注意:有参数的注入,需要先在module中注入参数后,告诉koin它是一个注入对象,然后在注入ViewModel的时候通过get()方法就可以自动获取到。
val viewModelModule = module {
single { Repository() }
viewModel { KoinViewModel (get()) }
}
关键方法Koin中Module的方法:
factory :用来注入常规对象(每次使用都会创建新的对象)
single :用来注入单例对象
viewModel:用来注入ViewModel对象
3、开启Koin注入
在Application中开启koin注入
startKoin {
AndroidLogger(Level.DEBUG)
androidContext(context)
modules(
listOf(
viewModelModule,
singleModule,
normalModule
)
)
}
startkoin{}开启Koin功能,然后进行一些配置
- androidLogger()开启Koin的运行日志
- androidContext()绑定Application上下文,后面可以直接从Koin中获取
- module()传入Koin的模块,此模块就是我们定义的依赖注入项
4、注入获取实例
class MainActivity : BaseActivity<ActivityMainBinding>() {
// 使用Koin进行对象注入
private val normalKoin : NormalKoin by inject()
private val singletonKoin: SingletonKoinby inject()
private val koinViewModel: KoinViewModel by viewModel()
override fun initViewBinding(): ActivityMainBinding {
return ActivityMainBinding.inflate(layoutInflater)
}
override fun onCreate() {
super.onCreate()
}
}
Koin不仅可以使用by inject()来注入,也可以直接使用get()来注入一个对象,二者的区别在于一个是懒加载模式,一个是直接获取模式
- inject():返回的是一个Lazy对象,内部依旧调用的是get()方法
- get():返回的是需要注入的对象实例