기쁘달

설치_가이드

4 min read

Kotlin 개발 환경 구축 가이드 (VSCode + Windows)

1. JDK 설치

Kotlin은 JVM에서 실행되므로 JDK가 필수입니다.

JDK 17 또는 21 설치 (추천)

  1. 다운로드: https://adoptium.net/ 접속
  2. 선택: “Temurin 21 (LTS)” 또는 “Temurin 17 (LTS)” 선택
  3. 다운로드: Windows x64용 .msi 설치 파일 다운로드
  4. 설치:
    • 설치 중 “Set JAVA_HOME variable” 옵션 체크
    • “Add to PATH” 옵션 체크
  5. 확인: 새 터미널에서 실행 
    java -version

2. Kotlin 컴파일러 설치 (옵션)

중요: Gradle을 사용할 경우 Kotlin 컴파일러가 자동으로 관리되므로 이 단계를 건너뛰어도 됩니다! 바로 4번 Gradle 설치로 넘어가세요.

독립적으로 Kotlin 컴파일러를 설치하고 싶다면:

방법 1: Scoop 사용 (Windows 권장)

# PowerShell에서 Scoop 설치
Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
 
# Kotlin 설치
scoop install kotlin
 
# 확인
kotlinc -version

방법 2: 수동 설치

  1. https://github.com/JetBrains/kotlin/releases/latest 에서 kotlin-compiler-x.x.x.zip 다운로드
  2. 압축 해제 (예: C:\kotlin)
  3. 시스템 환경 변수 PATH에 C:\kotlin\bin 추가
  4. 새 터미널에서 확인: 
    kotlinc -version

방법 3: SDKMAN 사용 (Git Bash - 복잡함)

주의: Windows에서는 zip/unzip 설치가 복잡하므로 권장하지 않습니다.

# zip/unzip이 설치되어 있어야 함
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk install kotlin

3. VSCode 확장 프로그램 설치

VSCode에서 다음 확장 프로그램을 설치하세요:

  1. Kotlin Language (by mathiasfrohlich)
  2. Kotlin (by fwcd) - 가장 인기 있는 확장
  3. Extension Pack for Java (by Microsoft) - Java 지원 필수
  4. Gradle for Java (by Microsoft)

4. Gradle 설치

Kotlin 프로젝트는 주로 Gradle로 빌드합니다.

방법 1: Scoop 사용 (Windows 권장)

# PowerShell에서
scoop install gradle
 
# 확인
gradle -version

방법 2: Chocolatey 사용

# PowerShell 관리자 권한으로 실행
choco install gradle

방법 3: 수동 설치

  1. https://gradle.org/releases/ 에서 최신 버전 다운로드 (Binary-only 선택)
  2. 압축 해제 (예: C:\Gradle\gradle-8.x)
  3. 시스템 환경 변수 설정:
    • GRADLE_HOME = C:\Gradle\gradle-8.x
    • PATH에 %GRADLE_HOME%\bin 추가

확인

gradle -version

참고: Gradle Wrapper를 사용하면 Gradle을 별도로 설치하지 않아도 됩니다!

5. 첫 Kotlin 프로젝트 생성

방법 1: Gradle로 프로젝트 생성 (추천)

# 원하는 디렉토리로 이동
cd C:/Users/SSAFY/Desktop
 
# Kotlin 프로젝트 생성
gradle init
 
# 선택 과정:
# 1. Select type of project: 2 (application)
# 2. Select implementation language: 4 (Kotlin)
# 3. Select build script DSL: 1 (Kotlin)
# 4. Generate build using new APIs: no
# 5. Project name: my-kotlin-app
# 6. Source package: com.example

방법 2: 수동으로 간단한 프로젝트 생성

프로젝트 구조:

my-kotlin-project/
├── build.gradle.kts
├── settings.gradle.kts
└── src/
    └── main/
        └── kotlin/
            └── Main.kt

build.gradle.kts

plugins {
    kotlin("jvm") version "1.9.21"
    application
}
 
group = "com.example"
version = "1.0-SNAPSHOT"
 
repositories {
    mavenCentral()
}
 
dependencies {
    implementation(kotlin("stdlib"))
    testImplementation(kotlin("test"))
}
 
application {
    mainClass.set("MainKt")
}

settings.gradle.kts

rootProject.name = "my-kotlin-project"

src/main/kotlin/Main.kt

fun main() {
    println("Hello, Kotlin!")
}

6. 프로젝트 실행

cd my-kotlin-app
./gradlew run  # Windows에서는 gradlew.bat run 또는 .\gradlew.bat run

7. 일반적인 문제 해결

JAVA_HOME이 설정되지 않음

# 시스템 환경 변수에서 설정
# 내 PC > 속성 > 고급 시스템 설정 > 환경 변수
# JAVA_HOME = C:\Program Files\Eclipse Adoptium\jdk-21.0.x-hotspot

Gradle Wrapper 권한 문제

# Git Bash에서
chmod +x gradlew

8. 다음 단계

환경 구축이 완료되면:

그래프 뷰