Android Studio 버전에 맞는 Kotlin, AGP, Gradle 버전 정리

현재 사용 중인 Android Studio 버전 (본인은 Iguana (2023.2.1)) 에서 Kotlin, Android Gradle Plugin(AGP), Gradle 버전 호환성을 맞춰야 컴파일 오류 없이 정상적으로 빌드할 수 있습니다.

 

✅ 1. 올바른 Kotlin, AGP, Gradle 버전 조합

Android Studio Iguana (2023.2.1)에 가장 적합한 버전 조합은 다음과 같습니다.

라이브러리 권장 버전

Kotlin	1.9.22
Compose Compiler	1.5.10
AGP (Android Gradle Plugin)	8.2.1
Gradle	8.3

 

 

 

✅ 2. Kotlin 버전 확인 및 업데이트

📌 build.gradle (Project-level) 파일 수정

plugins {
    id("com.android.application") version "8.2.1" apply false
    id("com.android.library") version "8.2.1" apply false
    id("org.jetbrains.kotlin.android") version "1.9.22" apply false
}

 

또는, dependencies 블록에 포함된 경우:

dependencies { 
	classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.9.22" 
}​

 

✅ 3. Gradle 버전 업데이트

위에서 변경한 AGP 8.2.1을 사용하려면 Gradle 버전을 8.3으로 맞춰야 합니다.

📌 gradle-wrapper.properties 파일 수정

 

distributionUrl=https\://services.gradle.org/distributions/gradle-8.3-all.zip

📌 Gradle 8.3이 최신 버전이므로, 8.3으로 업데이트하세요.

 

 

✅ 4. Jetpack Compose Compiler 버전 확인

📌 Compose를 사용 중이라면 compose-compiler 버전도 Kotlin과 맞춰야 합니다.

 

android { composeOptions { kotlinCompilerExtensionVersion = "1.5.10" } }

kotlinCompilerExtensionVersion은 Kotlin 1.9.22와 호환되는 최신 버전 (1.5.10)을 사용하세요.

 

 

✅ 5. Gradle 캐시 정리 후 클린 빌드

버전 변경 후, Gradle 캐시를 정리하고 클린 빌드하세요.

./gradlew --stop 
./gradlew clean 
rm -rf ~/.gradle/caches/ 
./gradlew build

---

✅ 6. 최종적으로 해야 할 작업

☑ Kotlin을 1.9.22로 업데이트
☑ AGP(Android Gradle Plugin)를 8.2.1로 변경
☑ Gradle을 8.3으로 업데이트
☑ Jetpack Compose Compiler를 1.5.10으로 설정
☑ Gradle 캐시 삭제 후 ./gradlew clean build 실행

이제 다시 빌드하면 오류 없이 정상적으로 실행될 것입니다! 🚀

 

 

Q.

Android Studio Iguana | 2023.2.1 Build #AI-232.10227.8.2321.11479570, built on February 22, 2024 Runtime version: 17.0.9+0-17.0.9b1087.7-11185874 aarch64 VM: OpenJDK 64-Bit Server VM by JetBrains s.r.o. macOS 15.1.1 GC: G1 Young Generation, G1 Old Generation Memory: 2048M Cores: 8 Metal Rendering is ON Registry: documentation.show.toolbar=true Non-Bundled Plugins: Dart (232.10305) io.flutter (78.2.2)

 

Check for Update 해보니까 이렇게 나오는데, Kotlin, AGP, Gradle 등 버전을 어떻게 맞춰야 오류가 안 날까?