编辑“︁Koin”︁

= Koin =

'''Koin'''是一个轻量级的[[依赖注入]]框架，专为[[Kotlin]]开发者设计，特别适合[[Android开发]]。它采用纯Kotlin编写，通过函数式DSL（领域特定语言）提供简单直观的API，无需代码生成或反射处理。

== 核心特性 ==
* 轻量级：仅约1MB大小
* 无反射：运行时不需要反射API
* 易用性：简洁的DSL配置方式
* 模块化：支持功能模块化组织
* 生命周期感知：与Android组件生命周期自动绑定

== 基本用法 ==

=== 定义模块 ===
使用<code>module</code>函数声明依赖项：

<syntaxhighlight lang="kotlin">
val appModule = module {
    // 注入单例实例
    single { NetworkService() }
    
    // 注入工厂实例（每次获取新实例）
    factory { DatabaseHelper(get()) }
    
    // 注入带参数的依赖
    factory { (id: Int) -> UserRepository(id) }
}
</syntaxhighlight>

=== 启动Koin ===
在Application类中初始化：

<syntaxhighlight lang="kotlin">
class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        startKoin {
            androidContext(this@MyApp)
            modules(appModule)
        }
    }
}
</syntaxhighlight>

=== 注入依赖 ===
在Android组件中使用：

<syntaxhighlight lang="kotlin">
class MainActivity : AppCompatActivity() {
    // 懒注入
    private val service: NetworkService by inject()
    
    // 直接注入
    private val repository: UserRepository by inject { parametersOf(123) }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 使用注入的依赖
        service.fetchData()
    }
}
</syntaxhighlight>

== 高级特性 ==

=== 作用域绑定 ===
Koin支持定义生命周期感知的作用域：

<syntaxhighlight lang="kotlin">
val sessionModule = module {
    // 创建一个与Activity生命周期绑定的作用域
    scope<MainActivity> {
        scoped { SessionManager(get()) }
    }
}
</syntaxhighlight>

=== 测试支持 ===
Koin提供专门的测试模块：

<syntaxhighlight lang="kotlin">
@Before
fun setup() {
    startKoin { modules(testModule) }
}

@After
fun tearDown() {
    stopKoin()
}
</syntaxhighlight>

== 性能考量 ==
* 启动时间：Koin初始化通常在50-100ms之间
* 内存占用：每个定义约占用0.5KB内存
* 注入速度：依赖获取通常在微秒级别

== 与Dagger比较 ==
{| class="wikitable"
|-
! 特性 !! Koin !! [[Dagger]]
|-
| 学习曲线 || 简单 || 陡峭
|-
| 配置方式 || DSL || 注解处理
|-
| 编译时检查 || 运行时发现错误 || 编译时检查
|-
| 性能 || 适合中小项目 || 适合大型项目
|}

== 实际应用案例 ==
* [[Jetpack Compose]]项目常用Koin管理UI依赖
* 中小型Android应用的快速开发
* [[Kotlin多平台]]项目的共享模块依赖管理

== 参见 ==
* [[依赖注入]]
* [[Android开发]]
* [[Kotlin]]
* [[Dagger]]

[[Category:Android开发]]
[[Category:Kotlin]]
[[Category:软件框架]]