Kotlin依赖注入框架Koin

一、简介

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对象
scope{ } - 定义一个作用域
scoped{ } - 为一个定义指定其作用域
get() - 获取依赖对象
bind() - 增加一个类型绑定到给定的定义
binds() - 增加一个类型的数组绑定到给定的定义
named() - 命名定义

3、开启Koin注入

在Application中开启koin注入

startKoin {
  AndroidLogger(Level.DEBUG)
  androidContext(context)
  modules(
    listOf(
      viewModelModule,
      singleModule,
      normalModule
    )
  )
}

startkoin{}:开启Koin功能,然后进行一些配置

  • androidLogger():开启Koin的运行日志,指定日志的等级
  • androidContext():绑定Application上下文,后面可以直接从Koin中获取
  • module():传入Koin的模块,此模块就是我们定义的依赖注入项
  • properties() :加载给定的键值对到容器。(Map形式)
  • fileProperties() :从给定文件中加载键值对到容器。(Android通常用androidFileProperties()替代,文件一定要放在assets目录下,默认文件名为koin.properties,可传入自定义文件名)
  • environmentProperties():从操作系统环境加载键值对到容器。
  • createEagerInstances():创建以createAtStart标记的单例定义。

4、注入获取实例

class MainActivity : BaseActivity<ActivityMainBinding>() {

    // 使用Koin进行对象注入
    private val normalKoin : NormalKoin by inject()//方法一
    private val normalKoin by inject<NormalKoin>()//方法二
    private val singletonKoin: SingletonKoinby inject()
    private val koinViewModel: KoinViewModel by viewModel()

    override fun initViewBinding(): ActivityMainBinding {
        return ActivityMainBinding.inflate(layoutInflater)
    }

    override fun onCreate() {
        super.onCreate()
        val normalKoin = get<NormalKoin>()//方法三
    }
}

Koin不仅可以使用by inject()来注入,也可以直接使用get()来注入一个对象,二者的区别在于一个是懒加载模式,一个是直接获取模式

  • inject():返回的是一个Lazy对象,内部依旧调用的是get()方法
  • get():返回的是需要注入的对象实例
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容