Maven 프로젝트에서 저장소 및 의존성 설정하기
Kotlin Maven 프로젝트의 경우, 기본 Maven Central 저장소 외에 Maven이 아티팩트를 찾을 위치를 구성하고 프로젝트가 의존하는 라이브러리를 정의할 수 있습니다.
저장소 선언
기본적으로 mavenCentral 저장소는 모든 Maven 프로젝트에서 사용할 수 있습니다. 다른 저장소의 아티팩트에 액세스하려면 <repositories> 섹션에 저장소 이름에 대한 사용자 지정 ID와 URL을 지정하세요.
<repositories>
<repository>
<id>spring-repo</id>
<url>https://repo.spring.io/release</url>
</repository>
</repositories>Gradle 프로젝트에서
mavenLocal()을 저장소로 선언하면 Gradle과 Maven 프로젝트 사이를 전환할 때 문제가 발생할 수 있습니다. 자세한 내용은 저장소 선언을 참고하세요.
일반적으로 라이브러리에 대한 의존성을 추가하려면 <dependencies> 섹션에 새로운 <dependency> 항목을 선언해야 합니다.
<dependencies>
<dependency>
<groupId>org.jetbrains.kotlinx</groupId>
<artifactId>kotlinx-serialization-json</artifactId>
<version>1.11.0</version>
</dependency>
</dependencies>의존성 설정
표준 라이브러리 의존성
Kotlin은 애플리케이션에서 사용할 수 있는 광범위한 표준 라이브러리를 제공합니다. 표준 라이브러리 의존성을 수동으로 추가하거나, <extensions> 옵션을 활성화하여 누락된 경우 자동으로 설정되도록 할 수 있습니다.
자동 설정
Kotlin Maven 플러그인에서 제공하는 <extensions> 옵션을 사용하면 수동 구성을 피할 수 있습니다. 이 옵션은 프로젝트에 kotlin-stdlib 의존성이 정의되어 있지 않은 경우 자동으로 추가합니다. 예를 들어, 새로운 Kotlin Maven 프로젝트를 생성하거나 기존 Java Maven 프로젝트에 Kotlin을 도입할 때 유용합니다.
다른 버전의 kotlin-stdlib 의존성을 이미 선언한 경우, <extensions>가 포함된 Kotlin Maven 플러그인은 이를 덮어쓰지 않습니다.
표준 라이브러리 자동 추가 기능을 사용하지 않도록 선택할 수도 있습니다. 이를 위해 <properties> 섹션에 다음 내용을 추가하세요.
<project>
<properties>
<kotlin.smart.defaults.enabled>false</kotlin.smart.defaults.enabled>
</properties>
</project>이 속성은 표준 라이브러리의 자동 추가뿐만 아니라 소스 루트 경로의 등록도 비활성화합니다. 다른
<extensions>기능에는 영향을 주지 않습니다.
수동 구성
프로젝트에 Kotlin 표준 라이브러리를 수동으로 추가하려면 pom.xml 파일의 dependencies 섹션을 다음과 같이 업데이트하세요.
<dependencies>
<dependency>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-stdlib</artifactId>
<!-- <properties/>에 지정된 kotlin.version을 사용합니다: -->
<version>${kotlin.version}</version>
</dependency>
</dependencies>다음보다 낮은 버전의 Kotlin으로 JDK 7 또는 8을 대상으로 하는 경우:
- 1.8 미만인 경우, 각각
kotlin-stdlib-jdk7또는kotlin-stdlib-jdk8을 사용하세요.- 1.2 미만인 경우, 각각
kotlin-stdlib-jre7또는kotlin-stdlib-jre8을 사용하세요.
테스트 라이브러리 의존성
프로젝트에서 Kotlin 리플렉션이나 테스트 프레임워크를 사용하는 경우 관련 의존성을 추가하세요. 리플렉션 라이브러리에는 kotlin-reflect를, 테스트 라이브러리에는 kotlin-test 및 kotlin-test-junit5를 사용하세요.
<dependencies>
<dependency>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-reflect</artifactId>
<version>${kotlin.version}</version>
</dependency>
<dependency>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-test-junit5</artifactId>
<scope>test</scope>
</dependency>
</dependencies>kotlinx 라이브러리 의존성
kotlinx 라이브러리의 경우 기본 아티팩트 이름을 추가하거나 -jvm 접미사가 붙은 이름을 추가할 수 있습니다. klibs.io에 있는 라이브러리의 README 파일을 참고하세요.
예를 들어, kotlinx.coroutines 라이브러리에 대한 의존성을 추가하려면:
<dependencies>
<dependency>
<groupId>org.jetbrains.kotlinx</groupId>
<artifactId>kotlinx-coroutines-core</artifactId>
<version>1.11.0</version>
</dependency>
</dependencies>kotlinx-datetime 라이브러리에 대한 의존성을 추가하려면:
<dependencies>
<dependency>
<groupId>org.jetbrains.kotlinx</groupId>
<artifactId>kotlinx-datetime-jvm</artifactId>
<version>0.8.0</version>
</dependency>
</dependencies>BOM으로 의존성 관리하기
BOM(Bill of Materials)은 프로젝트의 의존성 버전을 관리하는 특수한 POM 파일입니다. 이는 관련 아티팩트의 버전을 일치시키고 버전 충돌을 방지합니다.
Kotlin은 동일한 Kotlin 릴리스에 해당하는 kotlin-stdlib, kotlin-reflect, kotlin-test와 같은 Kotlin 라이브러리의 버전을 지정하는 kotlin-bom 아티팩트를 게시합니다. 이는 프로젝트의 다른 라이브러리가 Kotlin 아티팩트에 대한 전이 의존성을 가질 때 유용하며, 모든 의존성이 동일한 Kotlin 버전으로 결정되도록 보장합니다.
Kotlin BOM을 사용하려면 다음과 같이 pom.xml 파일의 <dependencyManagement> 섹션에 이를 가져오세요.
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.jetbrains.kotlin</groupId>
<artifactId>kotlin-bom</artifactId>
<version>2.4.10</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>BOM을 가져온 후에는 <dependencies> 섹션에서 버전을 지정하지 않고도 Kotlin 의존성을 선언할 수 있습니다. 버전은 BOM 파일에서 자동으로 가져옵니다.
- BOM을 가져오는 것 자체만으로는 프로젝트에 어떤 의존성도 추가되지 않습니다. 오직 명시적으로 선언된 의존성과 전이 의존성의 버전만 제어합니다.
- 의존성에 대해 여전히
<version>을 지정하는 경우, 해당 값이 BOM의 버전을 덮어씁니다.
프로젝트에서 함께 출시되는 여러 라이브러리를 게시하는 경우, 사용자가 동일한 방식으로 해당 라이브러리들의 버전을 일치시킬 수 있도록 자체 BOM을 제공할 수 있습니다. 자체 BOM을 작성하는 방법을 알아보려면 Maven 문서를 참고하세요.