Skip to content

설정 ​

이 섹션에서는 Koin을 사용하기 위해 Gradle 빌드에 추가해야 할 항목들을 설명합니다. 아래에서 대상 플랫폼을 선택한 후 링크된 Gradle 설정 섹션을 확인하세요. 아직 선언 스타일을 결정하지 않았다면 스타일 선택하기를 먼저 읽어보세요. 선택한 스타일에 따라 컴파일러 플러그인(Compiler Plugin)이 필요한지 여부가 결정됩니다.

설치 항목 ​

플랫폼아티팩트설정
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을 가져오고(import) 버전 명시 없이 Koin 아티팩트를 선언하여 버전이 항상 일치하도록 유지합니다. 자세한 내용은 Gradle 설정을 참조하세요.
  2. Koin 컴파일러 플러그인: io.insert-koin.compiler.plugin Gradle 플러그인을 적용하여 컴파일 타임 검사가 지원되는 컴파일러 플러그인 DSL 또는 어노테이션을 사용합니다. Kotlin 2.3.20 이상 버전이 필요합니다. 자세한 내용은 컴파일러 플러그인 설정을 참조하세요.

Constructor DSL 또는 Classic DSL만 사용하는 경우에는 1단계만으로도 충분합니다. 하지만 해당 정의에 컴파일 타임 검사가 추가되므로 2단계 적용을 여전히 권장합니다.

WARNING

KSP 프로세서인 koin-ksp-compiler는 더 이상 사용되지 않습니다(deprecated). 기존 프로젝트를 위해 KSP 프로세서 설정에 설정 방법이 유지되고 있습니다. 신규 프로젝트에는 컴파일러 플러그인을 사용하세요.

버전 정보 ​

컴포넌트현재 버전Kotlin
Koin (koin-annotations를 포함한 모든 라이브러리)4.2.22.3.20으로 빌드됨
Koin 컴파일러 플러그인1.2.12.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+미지원

버전 간 변경 사항 및 업그레이드 방법은 릴리스에서 확인할 수 있습니다.