Skip to content

Gradle 설정 ​

이 페이지에는 각 플랫폼별 Gradle 의존성과 배포된 모든 Koin 아티팩트 목록이 나와 있습니다. 예제에서는 Kotlin DSL(build.gradle.kts)과 버전 카탈로그(Version Catalog)를 사용합니다. 컴파일 타임 검사와 컴파일러 플러그인 DSL을 추가하려면 컴파일러 플러그인 설정도 참조하세요.

버전 ​

koin-annotations를 포함한 모든 Koin 라이브러리는 동일한 버전을 공유합니다. 현재 안정화 버전은 4.2.2입니다.

  • Koin: Maven Central

모든 아티팩트는 Maven Central의 io.insert-koin 그룹에 게시되어 있습니다. 버전 이력과 업그레이드 정보는 릴리스에서 확인할 수 있습니다.

Koin BOM ​

Koin BOM(Bill of Materials)은 모든 Koin 라이브러리의 버전을 동일하게 고정합니다. BOM 버전을 한 번만 선언하면 Koin 라이브러리를 버전 명시 없이 추가할 수 있습니다. BOM을 업데이트하면 모든 Koin 라이브러리가 함께 업데이트됩니다.

gradle/libs.versions.toml:

toml
[versions]
koin = "4.2.2"

[libraries]
koin-bom = { module = "io.insert-koin:koin-bom", version.ref = "koin" }
koin-core = { module = "io.insert-koin:koin-core" }
koin-android = { module = "io.insert-koin:koin-android" }
koin-compose = { module = "io.insert-koin:koin-compose" }
koin-compose-viewmodel = { module = "io.insert-koin:koin-compose-viewmodel" }
koin-compose-viewmodel-navigation = { module = "io.insert-koin:koin-compose-viewmodel-navigation" }
koin-ktor = { module = "io.insert-koin:koin-ktor" }
koin-logger-slf4j = { module = "io.insert-koin:koin-logger-slf4j" }
koin-annotations = { module = "io.insert-koin:koin-annotations" }
koin-test = { module = "io.insert-koin:koin-test" }
koin-test-junit4 = { module = "io.insert-koin:koin-test-junit4" }

모듈의 build.gradle.kts:

kotlin
dependencies {
    implementation(platform(libs.koin.bom))
    implementation(libs.koin.android)
}

버전 카탈로그를 사용하지 않는 경우:

kotlin
dependencies {
    implementation(platform("io.insert-koin:koin-bom:4.2.2"))
    implementation("io.insert-koin:koin-android")
    testImplementation("io.insert-koin:koin-test-junit4")
}

개별 의존성에 버전을 직접 명시하면 해당 의존성에 대해서만 BOM 설정이 재정의(override)됩니다. 특정 라이브러리의 최신 릴리스에 포함된 수정 사항이 필요한 경우가 아니라면 이를 지양하세요.

BOM을 사용하지 않는 경우 ​

각 라이브러리에 직접 버전을 지정할 수도 있습니다. Koin 예제에서도 이 방식을 사용하며, Kotlin Multiplatform 소스 세트에서도 동일하게 작동합니다.

toml
[versions]
koin = "4.2.2"

[libraries]
koin-core = { module = "io.insert-koin:koin-core", version.ref = "koin" }
koin-android = { module = "io.insert-koin:koin-android", version.ref = "koin" }

모든 Koin 라이브러리에 대해 단일 koin 버전을 유지하세요. 버전을 혼용하는 것은 지원되지 않습니다.

Kotlin/JVM ​

kotlin
dependencies {
    implementation(platform(libs.koin.bom))
    implementation(libs.koin.core)
}

그런 다음 main에서 Koin을 시작하세요. Koin 시작하기와 Kotlin 튜토리얼을 참조하세요.

Android ​

kotlin
dependencies {
    implementation(platform(libs.koin.bom))
    implementation(libs.koin.android)
}

koin-android에는 koin-core와 ViewModel 지원이 포함되어 있습니다. Application 클래스에서 Koin을 시작하세요. 자세한 내용은 Android에서 Koin 시작하기를 참조하세요.

선택적 Android 라이브러리:

아티팩트추가 기능
koin-androidx-workmanagerWorkManager 워커: WorkManager 참조
koin-androidx-navigationNavigation 그래프 범위(Scope)의 ViewModel (Fragments)
koin-androidx-startupAndroidX App Startup으로 Koin 시작
koin-android-compatJava 클래스에서 주입하기 위한 Java 헬퍼
koin-dagger-bridge마이그레이션 중 Koin에서 Dagger 컴포넌트 사용

Jetpack Compose가 적용된 Android ​

kotlin
dependencies {
    implementation(platform(libs.koin.bom))
    implementation(libs.koin.android)
    implementation(libs.koin.compose)
    implementation(libs.koin.compose.viewmodel)
}

koin-androidx-compose는 koin-compose와 koin-compose-viewmodel을 하나의 의존성으로 제공하는 Android 전용 아티팩트입니다. 두 설정 방식 모두 작동합니다.

내비게이션의 경우 다음 중 하나를 추가하세요:

아티팩트내비게이션 라이브러리
koin-androidx-compose-navigationNavigation Compose 2, Android 전용
koin-compose-viewmodel-navigationNavigation Compose 2, 멀티플랫폼
koin-compose-navigation3Navigation 3: Navigation 3 참조

API에 대한 자세한 내용은 Koin for Compose를 참조하세요.

Compose Multiplatform ​

공유 모듈에서는 commonMain에 Compose 라이브러리를 추가하세요. 멀티플랫폼 소스 세트에서는 버전이 포함된 카탈로그 항목을 사용합니다(BOM을 사용하지 않는 경우 참조).

kotlin
kotlin {
    sourceSets {
        commonMain.dependencies {
            implementation(libs.koin.core)
            implementation(libs.koin.compose)
            implementation(libs.koin.compose.viewmodel)
            implementation(libs.koin.compose.viewmodel.navigation) // Navigation Compose를 사용하는 경우
        }
    }
}

Android에서 koin-compose는 koin-android를 포함하므로 별도로 추가할 필요가 없습니다. Compose Multiplatform 튜토리얼을 참조하세요.

Kotlin Multiplatform ​

공유 모듈의 build.gradle.kts에서 버전이 포함된 카탈로그 항목을 사용하는 예시입니다(BOM을 사용하지 않는 경우 참조).

kotlin
kotlin {
    sourceSets {
        commonMain.dependencies {
            implementation(libs.koin.core)
        }
        androidMain.dependencies {
            implementation(libs.koin.android)
        }
        commonTest.dependencies {
            implementation(libs.koin.test)
        }
    }
}

koin-core는 JVM, Android, Apple 타깃(iOS, macOS, tvOS, watchOS), Linux, Windows, JS 및 Wasm(wasmJs)을 지원합니다. 프로젝트 구조 및 플랫폼별 정의는 Kotlin Multiplatform 설정에서 다룹니다.

Ktor ​

kotlin
dependencies {
    implementation(platform(libs.koin.bom))
    implementation(libs.koin.ktor)
    implementation(libs.koin.logger.slf4j)
}

Ktor 애플리케이션에 Koin 플러그인을 설치하세요. 자세한 내용은 Koin for Ktor를 참조하세요.

테스팅 ​

kotlin
dependencies {
    testImplementation(libs.koin.test)
    testImplementation(libs.koin.test.junit4) // 또는 koin-test-junit5
}

Android 인스트루먼트 테스트(Instrumented test)의 경우, androidTestImplementation에 koin-android-test를 추가하세요. 테스트에서 주입하기 및 Android 인스트루먼트 테스트를 참조하세요.

전체 아티팩트 ​

아티팩트플랫폼설명
koin-bom모든 플랫폼아래의 모든 아티팩트를 위한 BOM(Bill of materials)
koin-core모든 플랫폼컨테이너, DSL, 스코프, 컴파일러 플러그인 DSL
koin-core-coroutines모든 플랫폼지연 로딩 모듈(Lazy module) 및 백그라운드 로딩
koin-core-viewmodel모든 플랫폼Android 및 Compose Multiplatform을 위한 ViewModel 정의
koin-annotations모든 플랫폼컴파일러 플러그인을 위한 어노테이션 (@Singleton, @Module, @Named 등)
koin-androidAndroidAndroid 컨텍스트, Activity 및 Fragment API, ViewModel
koin-android-compatAndroidJava 호환성 헬퍼
koin-androidx-navigationAndroidNavigation 그래프 범위의 ViewModel
koin-androidx-workmanagerAndroidWorkManager 연동
koin-androidx-startupAndroidAndroidX App Startup 연동
koin-dagger-bridgeAndroidKoin에서 Dagger 컴포넌트 접근
koin-compose모든 Compose 타깃koinInject(), KoinApplication 및 Compose 컨텍스트
koin-compose-viewmodel모든 Compose 타깃koinViewModel()
koin-compose-viewmodel-navigation모든 Compose 타깃Navigation Compose 백스택 엔트리 범위의 ViewModel
koin-compose-navigation3모든 Compose 타깃Navigation 3 연동
koin-androidx-composeAndroidAndroid용 koin-compose 및 koin-compose-viewmodel 번들
koin-androidx-compose-navigationAndroidAndroid용 Navigation Compose 2
koin-ktorJVM, JS, Wasm, iOS, macOS (Ktor 서버 타깃)Ktor 서버 플러그인
koin-logger-slf4jJVMSLF4J 로거
koin-test모든 플랫폼테스트 API: KoinTest, verify()
koin-test-coroutinesJVM지연 로딩 모듈에 대한 검증
koin-test-junit4JVMJUnit 4 룰(Rule)
koin-test-junit5JVMJUnit 5 확장(Extension)
koin-android-testAndroid인스트루먼트 테스트 헬퍼

Koin 컴파일러 플러그인은 라이브러리가 아닌 Gradle 플러그인이므로 자체 버전을 갖습니다. 컴파일러 플러그인 설정을 참조하세요.