> For the complete documentation index, see [llms.txt](https://choi-junsu.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://choi-junsu.gitbook.io/docs/dev/android/di/koin.md).

# Koin

![https://insert-koin.io/](https://insert-koin.io/img/koin_new_logo.png)

## Koin 이란?

Koin은 **Kotlin DSL**로 만들어진 런타임 시 종속항목을 연결하는 대표적인 DI 라이브러리중 하나이다.

*장점*

* 러닝커브가 다른 DI 라이브러리 보다 현저히 낮다.
* Annotation 과정이 없어서 컴파일이 빠르다.

*단점*

* **리플렉션**을 이용해 의존성 주입을 하다보니 앱 성능이 저하된다.
* 런타임 시 의존성을 주입하다보니 에러가 발생할 수 있다.

#### DSL

위에서 언급한 `DSL` 이란, **Domain Specific Language** 의 약자로 특정 도메인에 특화된 언어이다.\
DSL은 상대적으로 자연어에 가까워 가독성을 높일 수 있다.

* 람다 표현식 - 선언되지 않았지만 즉시 표현식으로 전달되는 함수
* 고차함수 - 함수를 매개변수로 취하거나 함수를 반환하는 함수
* 확장함수 - 기종에 정의된 클래스에 새로운 함수가 추가되는 기능

#### ~~다 적지는 않았지만, 코드를 간결하게 작성할 수 있는 기능을 많이 제공한다.~~

#### 리플렉션 (Reflection)

리플렉션이란 런타임에 클래스, 필드 및 메서드를 검사, 로드 및 상호 작용하는 기능의 이름이다.

*장점*

* 생성자, 메서드, 필드를 재귀적으로 조작

단점

* 컴파일 시점에 가능한 타입 확인이 불가능
* 재귀적인 접근을 필요로 하는 코드는 가독성이 떨어짐
* 처리 서능이 늦음

~~Koin에 관한 포스팅이므로 리플렉션의 대한 더 자세한 설명은~~ [~~https://kotlinlangorg/docs/reflection.html~~](https://kotlinlang.org/docs/reflection.html) ~~를~~ \
~~참고하면 된다.~~

### Koin 설정

```kotlin
// Add Maven Central to your repositories if needed
repositories {
    mavenCentral()
}

// build.gradle (:app)
dependencies {
    ..
    def koin_version = "3.2.0"
    implementation "io.insert-koin:koin-android:$koin_version"
}
```

### Koin 시작하기

`KoinApplication` 인스턴스는 Koin 컨테이너 인스턴스 구성이다. 로깅, 속성 로드, 모듈을 구성할 수 있다.

`KoinApplication { }`  - KoinApplication 컨테이너 구성 생성

`startKoin { }` - GlobalContext API를 사용할 수 있도록 KoinApplication 컨테이너 구성을 생성 및 등록

```kotlin
class MyApplication : Application() {

    override fun onCreate() {
        super.onCreate()

        initKoin()
    }

    private fun initKoin() {
        startKoin {
            //inject Android context
            // Context 인스턴스를 필요로 하는 표현식을 간단히 작성할 수 있다.
            androidContext(this@MyApplication)
            // default Logger - Level.Info
            androidLogger()
            /* androidFileProperties() -  use properties from assets/koin.properties */
            
            modules(appModule)
        }
    }
}
```

AndroidManifest.xml - name속성에 작성한 어플리케이션 적용

```kotlin
 <application
        android:name=".MyApplication" ... 
        
        
```

Koin 모듈은 어플리케이션 주입/결합할 정의를 수집한다.

`module { // module content }}` - 코인 모듈 생성

모듈에서 다음 기능을 사용할 수 있다.

* `factory { }` : 팩토리 빈 제공 (매번 새로 생성)
* `single { }` : 싱글톤 빈 제공 (하나만 생성하고 계속 재활용)
* `get()` : 구성 요소 종속성 해결(이름, 범위 또는 매개변수도 사용할 수 있음)
* `bind()` : 주어진 빈 정의에 대해 바인딩할 유형 추가
* `binds()` : 주어진 빈 정의에 대한 유형 배열 추가
* `scope { }` : 정의를 위한 논리적 그룹 정의
* `scoped { }` : 범위에만 존재하는 빈 정의 제공
* `name()` : 정의의 이름을 지정하는데 사용

#### 의존성 주입

```kotlin
class Service()
class Controller(val view: View)

val myModules = module {
    single { Service() }
    // get() 으로 View 인스턴스 해결한다.
    single { Controller(get()) }
}
```

```kotlin
interface Service {
    fun work()
}
class ServiceImpl() : Service {
    fun work() { ... }
}
class Controller(val view: View)

// DI
val modules = modules {
    // ServiceImpl 만 구현
    single { ServiceImpl() }
    // Service 만 구현 _ 1
    single { ServiceImpl() as  Service }
    // Service 만 구현 _ 2
    single<Service> { ServiceImpl() }
    // 하나의 정의에서 여러 유형을 일치
    single { ServiceImpl() } bind Service::class
    // 이름을 지어주어 구별할 수 있음(1-1)
    single(named("test")) { Test(get()) }
    // 파라미터 해결 1
    single { Controller(get()) }
    // 파라미터 해결(2-1)
    single { (view: View) -> Controller(get()) }
}

// 이름을 지어주어 구별할 수 있음(1-2)
// inject : Lazy injected Presenter instance
val service: Service by inject(qualifier = named("test"))

// 파라미터 해결(2-2)
val controller: Controller by inject { parameterOf(view) }

```

더 자세한 기능들에 대해서는 [Koin 공식문서](https://insert-koin.io/docs/reference/introduction) 를 통해 확인할 수 있다.<br>

{% embed url="<https://en.wikipedia.org/wiki/Domain-specific_language>" %}
Reference - DSL
{% endembed %}

{% embed url="<https://brunch.co.kr/@oemilk/172>" %}
Reference - Reflection
{% endembed %}

{% embed url="<https://insert-koin.io/docs/reference/introduction>" %}
Reference - Koin
{% endembed %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://choi-junsu.gitbook.io/docs/dev/android/di/koin.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.