Настройка Dependency Injection (Koin) в Android/KMM-приложении
Koin — DI-фреймворк на Kotlin DSL без кодогенерации. Подходит там, где Dagger/Hilt избыточен: небольшие-средние приложения, KMM-проекты где нужен общий DI для Android и iOS, команды, которым не нужен kapt или KSP в сборке.
Базовая настройка
// build.gradle.kts
implementation("io.insert-koin:koin-android:3.5.0")
implementation("io.insert-koin:koin-androidx-viewmodel:3.5.0")
Модуль зависимостей:
val appModule = module {
single<UserRepository> { UserRepositoryImpl(get()) }
single { ApiService(get()) }
factory { AuthUseCase(get()) }
viewModel { LoginViewModel(get()) }
}
single — синглтон на время жизни Koin-контейнера. factory — новый инстанс при каждом запросе. viewModel — создаёт ViewModel и регистрирует её в ViewModelStore.
Инициализация в Application:
class App : Application() {
override fun onCreate() {
super.onCreate()
startKoin {
androidContext(this@App)
modules(appModule)
}
}
}
В Fragment или Activity:
val viewModel: LoginViewModel by viewModel()
val repository: UserRepository by inject()
Koin в KMM
В Kotlin Multiplatform Koin позволяет объявить общие зависимости в commonMain и платформенные — в androidMain / iosMain:
// commonMain
val commonModule = module {
single { UserSyncService(get()) }
factory { SyncUseCase(get()) }
}
// androidMain
val androidModule = module {
single<DatabaseDriver> { AndroidSqliteDriver(Database.Schema, androidContext(), "app.db") }
}
// iosMain
val iosModule = module {
single<DatabaseDriver> { NativeSqliteDriver(Database.Schema, "app.db") }
}
На iOS Koin инициализируется через KoinApplication:
// Swift
KoinKt.doInitKoin(appDeclaration: { _ in })
Это главное преимущество перед Hilt: Hilt — Android-only, Koin работает в shared-коде.
Типичная ошибка
NoBeanDefFoundException в рантайме — Koin не нашёл биндинг для запрошенного типа. Причина: забыли добавить модуль при startKoin, или тип в inject<T>() не совпадает с тем, что зарегистрировано (interface vs implementation). В отличие от Dagger, ошибка проявляется не при сборке, а при первом обращении к зависимости. Для раннего обнаружения — checkModules() в тестах:
@Test
fun verifyKoinApp() {
koinApplication {
modules(appModule)
}.checkModules()
}
Настройка Koin для Android-проекта — 0.5-1 день. Для KMM с несколькими платформенными модулями — 2-3 дня. Стоимость рассчитывается индивидуально.