Skip to content

配置 ​

本节说明了使用 Koin 时需要向 Gradle 构建中添加的内容。请在下方选择你的平台,然后按照 Gradle 配置中对应的链接章节进行操作。如果你尚未选择声明样式,请先阅读选择你的样式:该内容决定了你是否还需要编译器插件。

需要安装的内容 ​

平台构件配置
Kotlin/JVMkoin-coreKotlin/JVM
Androidkoin-androidAndroid
带有 Jetpack Compose 的 Androidkoin-android, koin-compose, koin-compose-viewmodelJetpack Compose
Compose Multiplatformkoin-compose, koin-compose-viewmodelCompose Multiplatform
Kotlin MultiplatformcommonMain 中的 koin-coreKotlin Multiplatform
Ktorkoin-ktor, koin-logger-slf4jKtor
测试koin-test、koin-test-junit4 或 koin-test-junit5测试

对于新项目:

  1. Koin BOM:导入 io.insert-koin:koin-bom 并声明不带版本的 Koin 构件,以确保它们始终匹配。请参阅 Gradle 配置。
  2. Koin 编译器插件:应用 Gradle 插件 io.insert-koin.compiler.plugin 以获取编译器插件 DSL 或注解,并获得编译时检查。它需要 Kotlin 2.3.20 或更高版本。请参阅编译器插件配置。

如果你仅使用 Constructor 或 Classic DSL,则执行步骤 1 就足够了。但仍推荐执行步骤 2:它会为这些定义添加编译时检查。

WARNING

KSP 处理器 koin-ksp-compiler 已弃用。其配置仅在 KSP 处理器配置中针对现有项目保留。新项目请使用编译器插件。

版本 ​

组件当前版本Kotlin
Koin(所有库,包括 koin-annotations)4.2.2使用 2.3.20 构建
Koin 编译器插件1.2.1已在 2.3.20、2.4.0、2.4.10、2.4.20 上验证(需要 Koin 4.2.0+)

最新发布的版本:

  • Koin: Maven Central
  • Koin 编译器插件: Maven Central

较旧的 Koin 系列:

KoinKotlin编译器插件
4.2.x2.3.20+是
4.1.x2.1+否,仅限 KSP 处理器
4.0.x1.9+否,仅限 KSP 处理器
3.5.x1.8+否

版本之间的变更及升级方法请参阅发布版本。