Skip to content

Ktor Gradle 플러그인을 사용하여 fat JAR 만들기

Ktor Gradle 플러그인을 사용하면 모든 코드 의존성을 포함하는 실행 가능한 JAR(fat JAR)를 생성하고 실행할 수 있습니다.

Ktor 플러그인 설정하기

fat JAR를 빌드하려면 먼저 Ktor 플러그인을 설정해야 합니다:

  1. build.gradle.kts 파일을 열고 plugins 블록에 플러그인을 추가합니다:

    kotlin
    plugins {
        id("io.ktor.plugin") version "3.4.3"
    }
  2. 메인 애플리케이션 클래스가 설정되었는지 확인합니다:

    kotlin
    application {
        mainClass.set("com.example.ApplicationKt")
    }
  3. 선택적으로, ktor.fatJar 확장을 사용하여 생성될 fat JAR의 이름을 설정할 수 있습니다:

    kotlin
    ktor {
        fatJar {
            archiveFileName.set("fat.jar")
        }
    }

Ktor Gradle 플러그인을 Kotlin Multiplatform Gradle 플러그인과 함께 적용하면 fat JAR 생성 기능이 자동으로 비활성화됩니다. 이들을 함께 사용하려면 다음 단계를 따르세요:

  1. 위에서 설명한 대로 Ktor Gradle 플러그인이 적용된 JVM 전용 프로젝트를 생성합니다.
  2. 해당 JVM 전용 프로젝트에 Kotlin Multiplatform 프로젝트를 의존성으로 추가합니다.

이 해결 방법으로 문제가 해결되지 않는 경우, KTOR-8464에 의견을 남겨 저희에게 알려주세요.

fat JAR 빌드 및 실행

Ktor 플러그인은 fat JAR를 생성하고 실행하기 위해 다음 태스크(task)들을 제공합니다:

  • buildFatJar: 프로젝트와 런타임 의존성이 결합된 JAR를 빌드합니다. 빌드가 완료되면 build/libs 디렉토리에 ***-all.jar 파일이 생성된 것을 확인할 수 있습니다.
  • runFatJar: 프로젝트의 fat JAR를 빌드하고 실행합니다.

ProGuard를 사용하여 생성된 JAR의 크기를 최소화하는 방법을 알아보려면 proguard 샘플을 참고하세요.