프론트엔드

[Flutter] Flutter Android NDK install 에러

곽곽 2025. 4. 11. 16:00

Flutter 프로젝트를 안드로이드 휴대폰으로 직접 빌드를 해보기 위해 flutter run을 실행해보았으나, 갑자기 이런 에러가 나타나며 빌드가 종료되었습니다.

FAILURE: Build failed with an exception.

* Where:
Build file 'C:\Users\user\kwak-21\Flutter\SilentCameraApp\android\build.gradle.kts' line: 16 

* What went wrong:
A problem occurred configuring project ':app'.
> cohttp://m.android.builder.sdk.InstallFailedException: Failed to install the following SDK components:
      ndk;26.3.11579264 NDK (Side by side) 26.3.11579264
  Install the missing components using the SDK manager in Android Studio.

BUILD FAILED in 10m 25s
Error: Gradle task assembleDebug failed with exit code 1

실제로 에러가 발생한 곳은 바로 NDK를 설치하는 부분이었습니다.

Preparing "Install NDK (Side by side) 26.3.11579264 v.26.3.11579264".
"Install NDK (Side by side) 26.3.11579264 v.26.3.11579264" failed.

이와 같이 NDK 설치에서 에러가 발생하며 안드로이드 빌드가 비정상 종료되는 경우는 다음의 방법으로 쉽게 해결될 수 있습니다.


android/app/build.gradle.kts에서 NDK 부분 삭제하기

android/app/build.gradle.kts 혹은 build.gradle 파일에서, android 블럭 안에 ndkVersion에 해당하는 부분을 찾아줍니다.

android {
    ...
    ndkVersion = flutter.ndkVersion
    ...
}

해당 줄을 주석 처리하거나 삭제한 뒤, 다시 flutter run을 실행하면 새롭게 NDK가 자동 설치되며, 빌드도 성공적으로 이뤄지는 것을 확인할 수 있습니다.