Skip to content

Gradle 및 Kotlin/JVM 시작하기

이 튜토리얼에서는 IntelliJ IDEA와 Gradle을 사용하여 JVM 콘솔 애플리케이션을 만드는 방법을 설명합니다.

시작하려면 먼저 최신 버전의 IntelliJ IDEA를 다운로드하여 설치하세요.

프로젝트 생성

  1. IntelliJ IDEA에서 File | New | Project를 선택합니다.

  2. 왼쪽 패널에서 Kotlin을 선택합니다.

  3. 새 프로젝트의 이름을 지정하고, 필요한 경우 위치를 변경합니다.

    새 프로젝트를 버전 관리 시스템에 넣으려면 Create Git repository 체크박스를 선택하세요. 이 작업은 나중에 언제든지 수행할 수 있습니다.

    콘솔 애플리케이션 생성

  4. Gradle 빌드 시스템을 선택합니다.

  5. JDK 목록에서 프로젝트에 사용할 JDK를 선택합니다.

    • 컴퓨터에 JDK가 설치되어 있지만 IDE에 정의되어 있지 않은 경우, Add JDK를 선택하고 JDK 홈 디렉토리의 경로를 지정하세요.
    • 컴퓨터에 필요한 JDK가 없는 경우, Download JDK를 선택하세요.
  6. Gradle용 Kotlin DSL을 선택합니다.

  7. 샘플 "Hello World!" 애플리케이션이 포함된 파일을 생성하려면 Add sample code 체크박스를 선택합니다.

    Generate code with onboarding tips 옵션을 활성화하여 샘플 코드에 유용한 추가 주석을 추가할 수도 있습니다.

  8. Create를 클릭합니다.

Gradle을 사용하는 프로젝트를 성공적으로 생성했습니다!

프로젝트의 Gradle 버전 지정하기

Gradle 래퍼(Wrapper) 또는 로컬에 설치된 Gradle을 사용하여 Advanced Settings 섹션에서 프로젝트의 Gradle 버전을 명시적으로 지정할 수 있습니다:

  • Gradle Wrapper:

    1. Gradle distribution 목록에서 Wrapper를 선택합니다.
    2. Auto-select 체크박스를 해제합니다.
    3. Gradle version 목록에서 원하는 Gradle 버전을 선택합니다.
  • Local installation:

    1. Gradle distribution 목록에서 Local installation을 선택합니다.
    2. Gradle location에 로컬 Gradle 버전의 경로를 지정합니다.

    고급 설정

빌드 스크립트 살펴보기

build.gradle.kts 파일을 엽니다. 이것은 Gradle Kotlin 빌드 스크립트로, Kotlin 관련 아티팩트 및 애플리케이션에 필요한 기타 부분들을 포함하고 있습니다:

kotlin
plugins {
    kotlin("jvm") version "2.3.0" // 사용할 Kotlin 버전
}

group = "org.example" // 회사 이름(예: `org.jetbrains`)
version = "1.0-SNAPSHOT" // 빌드된 아티팩트에 할당할 버전

repositories { // 의존성 소스. 1️⃣ 참고
    mavenCentral() // Maven Central 저장소. 2️⃣ 참고
}

dependencies { // 사용할 모든 라이브러리. 3️⃣ 참고
    // 저장소에서 의존성을 찾은 후 이름을 복사하세요
    testImplementation(kotlin("test")) // Kotlin 테스트 라이브러리
}

tasks.test { // 4️⃣ 참고
    useJUnitPlatform() // 테스트용 JUnitPlatform. 5️⃣ 참고
}

보시다시피 Gradle 빌드 파일에 몇 가지 Kotlin 관련 아티팩트가 추가되었습니다:

  1. plugins {} 블록에는 kotlin("jvm") 아티팩트가 있습니다. 이 플러그인은 프로젝트에서 사용할 Kotlin 버전을 정의합니다.

  2. dependencies {} 블록에는 testImplementation(kotlin("test"))가 있습니다. 테스트 라이브러리에 대한 의존성 설정에 대해 더 자세히 알아보세요.

애플리케이션 실행

  1. View | Tool Windows | Gradle을 선택하여 Gradle 창을 엽니다.

    main 함수가 포함된 Main.kt

  2. Tasks\build\에서 build Gradle 태스크를 실행합니다. Build 창에 BUILD SUCCESSFUL이 나타납니다. 이는 Gradle이 애플리케이션을 성공적으로 빌드했음을 의미합니다.

  3. src/main/kotlin에서 Main.kt 파일을 엽니다.

    • src 디렉토리는 Kotlin 소스 파일과 리소스를 포함합니다.
    • Main.kt 파일은 Hello World!를 출력하는 샘플 코드를 포함하고 있습니다.
  4. 거터(gutter)에 있는 녹색 Run 아이콘을 클릭하고 Run 'MainKt'를 선택하여 애플리케이션을 실행합니다.

    콘솔 앱 실행

Run 도구 창에서 결과를 확인할 수 있습니다:

Kotlin 실행 결과

축하합니다! 첫 번째 Kotlin 애플리케이션을 성공적으로 실행했습니다.

다음 단계

다음에 대해 더 자세히 알아보세요: