[kotlin] 코틀린에서 NPM 라이브러리 연동하기

07 Dec 2023

kotlin

코틀린은 JVM에서 실행되는 언어이기 때문에 기본적으로 Java 라이브러리와의 연동이 원활합니다. 하지만 때로는 NPM(Node.js Package Manager)에서 제공하는 라이브러리를 사용해야 하는 경우도 있습니다. 이번 글에서는 코틀린에서 NPM 라이브러리를 어떻게 연동하는지 알아보겠습니다.

필요한 도구 설치하기

NPM 라이브러리를 사용하기 위해서는 Kotlin/JS와 Gradle을 이용해 프로젝트를 구성해야 합니다. 따라서 먼저 Kotlin/JS와 Gradle을 설치해야 합니다.

Kotlin/JS 설치: Kotlin 공식 웹사이트(https://kotlinlang.org/)에서 Kotlin 플랫폼을 다운로드하고 설치합니다.
Gradle 설치: Gradle 공식 웹사이트(https://gradle.org/)에서 Gradle을 다운로드하고 설치합니다.

프로젝트 생성 및 설정

프로젝트를 생성하기 위해 Kotlin/JS와 Gradle을 사용할 수 있습니다.

새로운 Kotlin/JS 프로젝트를 생성합니다. 프로젝트 디렉토리에 build.gradle.kts 파일을 생성하고 아래 내용을 추가합니다.

plugins {
    id("org.jetbrains.kotlin.js") version "1.5.21"
    id("org.jetbrains.kotlin.browser") version "1.5.21"
}

kotlin {
    js {
        browser()
    }
    sourceSets {
        configure("main") {
            dependencies {
                implementation(npm("library-name", "1.0.0"))
            }
        }
    }
}

gradle.properties 파일에 아래 내용을 추가합니다.

kotlin.browser.phantomjs=/path/to/phantomjs

위의 library-name 부분에 사용하고자 하는 NPM 라이브러리의 이름과 버전을 입력하면 됩니다.

NPM 라이브러리 사용하기

이제 코틀린 코드에서 NPM 라이브러리를 사용할 수 있습니다.

src 폴더에 Kotlin 파일을 생성하고 필요한 NPM 라이브러리를 import 합니다.

import module from "library-name"

라이브러리를 사용하여 코드를 작성하고, 실행하여 원하는 결과를 얻을 수 있습니다.

val result = module.functionName(argument)
println(result)

빌드 및 실행

프로젝트를 빌드하여 실행하여 NPM 라이브러리가 정상적으로 동작하는지 확인할 수 있습니다.

빌드 명령어를 실행하기 전에 settings.gradle.kts 파일에 아래 내용을 추가합니다.

sourceSets {
    browserMain {
        dependencies {
            dependsOn(":main")
        }
    }
}

그리고 아래 명령어를 실행합니다.

./gradlew :browserMainDevelopmentWebpack

빌드가 성공적으로 완료되면 build/distributions 폴더에 빌드 결과물이 생성될 것입니다.

결론

이제 코틀린에서 NPM 라이브러리를 연동하는 방법을 알아보았습니다. 코틀린과 NPM을 함께 사용하여 다양한 라이브러리를 활용하면 더 강력한 애플리케이션을 개발할 수 있습니다.

더 자세한 내용은 Kotlin 공식 문서 (https://kotlinlang.org/docs/js-project-setup.html)를 참고하시기 바랍니다.