본문 바로가기
🖥 Programming/📱 Android (Kotlin)

[Android] Execution failed for task ':app:kaptGenerateStubsDebugKotlin'. 해결방법

by MinChan-Youn 2025. 3. 26.

안녕하세요~ 챠니입니다! :)

 

평화로운 어느날 안드로이드 스튜디오를 업데이트 하게 되었습니다. (Android Studio Meerkat)

Android Meerkat
Android Meerkat

 

 

그러고는 빌드를 하는데..

 

Execution failed for task ':app:kaptGenerateStubsDebugKotlin'. > A failure occurred while executing org.jetbrains.kotlin.compilerRunner.GradleCompilerRunnerWithWorkers$GradleKotlinCompilerWorkAction > Internal compiler error. See log for more details

 

 

Execution failed for task ':app:kaptGenerateStubsDebugKotlin'.
> A failure occurred while executing org.jetbrains.kotlin.compilerRunner.GradleCompilerRunnerWithWorkers$GradleKotlinCompilerWorkAction
   > Internal compiler error. See log for more details

* Try:
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.
> Get more help at https://help.gradle.org.

* Exception is:
org.gradle.api.tasks.TaskExecutionException: Execution failed for task ':app:kaptGenerateStubsDebugKotlin'.
    
    ...
    
    
	... 2 more


Deprecated Gradle features were used in this build, making it incompatible with Gradle 9.0.

You can use '--warning-mode all' to show the individual deprecation warnings and determine if they come from your own scripts or plugins.

For more on this, please refer to https://docs.gradle.org/8.7/userguide/command_line_interface.html#sec:command_line_warnings in the Gradle documentation.

BUILD FAILED in 957ms
31 actionable tasks: 1 executed, 30 up-to-date
Ask Gemini

 

역시 업데이트를 하고 조용히 넘어가지 않죠..?!

 

 

이래저래 찾아보니 저의 가장 큰 이유는 다음이였네요!

 

libs.versions.toml에서 kotlin 버전이 낮아 문제였네요

 

[AS-IS] version관리는 다음과 같습니다.

[versions]
...

kotlin = "1.9.0"

...

 

[TO-BE] version관리는 다음과 같습니다.

[versions]
...

kotlin = "2.0.21"

...

 

Sync Now 한번해주고 build하면 문제없이 돌아갔습니다 ㅎㅎㅎ

 

 

 

========================================================================

추가적으로... 해결이 안된다고하면 

* libs.version.toml의 agp(Android gradle plugin) 버전과

* gradle-wrapper.properties의 gradle 버전을 수정해줍니다!

 

 

보통은 AndroidStudio를 업데이트를 하면 그에 맞는 버전 셋팅을 해주는것이 좋은것 같습니다.

 

그렇다면! Android Developer에 확인을 해서 Meerkat버전의 맞는 버전은 무엇인지 확인해봅니다.

https://developer.android.com/build/releases/gradle-plugin#api-level-support

 

Android Gradle 플러그인 8.9 출시 노트  |  Android Studio  |  Android Developers

Android 스튜디오 빌드 시스템은 Gradle을 기반으로 하며 Android Gradle 플러그인에는 Android 앱을 빌드하는 데 사용하는 몇 가지 추가 기능이 있습니다.

developer.android.com

 

 

 

내용을 확인해보면 다음과 같이 이야기를 하고있네요

제가 이번에 설치한 Android Studio Meerkat 버전은 Minimum AGP version을 8.9.0으로 이야기하고 있고

 

https://developer.android.com/build/releases/gradle-plugin#api-level-support
https://developer.android.com/build/releases/gradle-plugin#api-level-support

 

 

Android Studio AGP(Android Gradle Plugin) 버전에 따른 최소 Gradle 버전은 다음과 같다고 말하고 있네요!

https://developer.android.com/build/releases/gradle-plugin?hl=ko

 

Android Gradle 플러그인 8.9 출시 노트  |  Android Studio  |  Android Developers

Android 스튜디오 빌드 시스템은 Gradle을 기반으로 하며 Android Gradle 플러그인에는 Android 앱을 빌드하는 데 사용하는 몇 가지 추가 기능이 있습니다.

developer.android.com

 

https://developer.android.com/build/releases/gradle-plugin?hl=ko

 

 

 

다음과 같이 수정해봅니다.

 

[AS-IS] lib.versions.toml

[versions]
agp = "8.5.0"
kotlin = "2.0.21"

 

[TO-BE] lib.versions.toml

[versions]
agp = "8.9.0"
kotlin = "2.0.21"

 

 

[AS-IS] gradle-wrapper.properties

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

[TO-BE] gradle-wrapper.properties

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

 

 

 

만약 이렇게까지 수정을 했는데도 안된다고 생각이 들면

댓글에 남겨주세요! 빠르게 확인하여 문제를 해결할 수 있도록 지원하겠습니다 ^^

 

 

 

 

 

 

 

질문 또는 궁굼한 부분은 댓글을 남겨주세요! 친절하게 답변드리겠습니다!

응원의 댓글은 저에게 큰 힘이 된답니다! :)

즐거운 하루되세요!

 

깃허브 보러 놀러오세요 👇 (맞팔환영)

https://github.com/younminchan

 

younminchan - Overview

•🇰🇷/👨🏻‍💻/🖥/⚽️/🎤/🥁/🏃‍♂️/🚴‍♂️/🏄🏻‍♂️/🤟 •TechBlog⬇️ •안드로이드 5년차 개발자 https://minchanyoun.tistory.com - younminchan

github.com