Koin for Kotlin：完整指南与示例

Koin 简介：它是什么以及为什么需要它

Koin 是一个轻量级、强大且直观的 Kotlin 依赖注入 (Dependency Injection, DI) 框架。与 Dagger 或 Spring 等重量级解决方案不同，Koin 不使用反射、注解或代码生成。一切都基于简单的 DSL（领域特定语言）结构构建，使代码干净、可读且易于测试。

为什么需要 Koin？ 在现代复杂应用程序开发中，管理类之间的依赖关系是一项关键任务。没有 DI，您将手动创建对象，这会导致代码高度耦合，使测试和维护变得复杂。Koin 通过提供一种简单的方式来注册、配置和获取依赖关系，解决了这些问题。

Koin 的主要优势：

• 轻量级： 对 APK 大小和构建时间影响最小。
• 简单性： 不需要注解、反射或代码生成。
• Kotlin 优先： 充分利用语言特性（DSL、Lambda、协程）。
• 模块化： 允许将依赖关系分解为逻辑模块。
• 可测试性： 在测试中轻松替换依赖关系。
• Android 支持： 拥有针对 Android 的专用模块（ViewModel、Fragment、Compose）。

安装 Koin

Koin 通过 Maven Central 分发。要将其添加到项目中，请在 build.gradle.kts（或 build.gradle）文件中添加依赖项。

对于 Kotlin Multiplatform / JVM 项目：

// build.gradle.ktsdependencies {    // Koin 核心模块    implementation("io.insert-koin:koin-core:3.5.6")        // 用于测试    testImplementation("io.insert-koin:koin-test:3.5.6")}

对于 Android 项目：

// build.gradle.kts (app 模块)dependencies {    // 核心模块    implementation("io.insert-koin:koin-android:3.5.6")        // 用于 ViewModel    implementation("io.insert-koin:koin-androidx-viewmodel:3.5.6")        // 用于 Jetpack Compose    implementation("io.insert-koin:koin-androidx-compose:3.5.6")        // 用于 WorkManager    implementation("io.insert-koin:koin-androidx-workmanager:3.5.6")        // 用于测试    testImplementation("io.insert-koin:koin-test:3.5.6")    testImplementation("io.insert-koin:koin-test-junit5:3.5.6")}

重要提示： 版本可能会变化。始终可以在 Koin 的 GitHub 仓库 中查看最新版本。

Koin 快速入门

让我们看一个最简单的例子：我们有一个 UserService 服务，它依赖于 UserRepository。我们不是手动创建仓库，而是使用 Koin。

步骤 1：定义类

// 用户仓库class UserRepository {    fun getUsers(): List<String> = listOf("Alice", "Bob", "Charlie")}

// 使用仓库的服务class UserService(private val repository: UserRepository) {    fun printUsers() {        repository.getUsers().forEach { println(it) }    }}

步骤 2：创建 Koin 模块

// 模块是一个容器，我们在其中描述如何创建依赖关系val appModule = module {    // single — 为整个应用程序创建一个实例（单例）    single<UserRepository> { UserRepository() }        // factory — 每次请求时都会创建一个新实例    factory { UserService(get()) } // get() — 请求 UserRepository 依赖}

步骤 3：启动 Koin

// 在应用程序入口点（main 或 Application）fun main() {    // 启动 Koin