[App] Android compileSdkVersion Error (ft. API 버전)

안드로이드 스튜디오 컴파일 에러

컴파일 에러 : 개발자에게 가장 싫어하는 에러

 

안드로이드 앱 개발 혹은 Cross Platform App 개발하면서, 아래와 같은 "CompileSdkVersion Error"를 종종 만나게 된다. 특히, 프로젝트 세팅을 처음부터 시작한 것이 아니라, Template 또는 Skeleton Project로 부터 시작하는 경우에서 발생이 빈번하다. 

Your project requires a higher compileSdkVersion. ㅜ_ㅜ

이런 컴파일류의 에러가 발생하면 처음에는 매우 당혹스럽기만 하다. 왜냐하면, 아직 아무것도 하지 않았기 때문이다. 아직 시작도 않해봤는데, 바로 컴파일 에러부터 발생하면, 환경 세팅 문제인데 이런류의 에러는 한번 꼬이면 잡아내기가 무척 까다롭기 때문이다. 

다행이 이번 CompileSdkVersion Error는 어려운 부분이 아니긴 하다. 

Android Studio. compileSdkVersion Error. Build Failed 이 발생한다.

해결 방안 

에러의 내용을 자세히 살펴 보면, 이런 에러의 경우, Java Native를 컴파일 해야 하는데 compile Version이 필요한 SDK 버전 보다 낮다는 것이 문제이다. 원인 파악은 되었고, 그렇다면 SDK 버전을 올려주면 될것 이다. 여기서 2가지 작업이 필요하다. 

1) 실제 상위버전의 SDK를 설치해 주는것 --> SDK Manager

2) 상위버전의 SDK를 사용할 수 있다고 표기 해 주는 것 --> build.gradle

 

 

SDK Manager

Android Studio의 메뉴중, SDK Manager를 열어주자. Android Studio의 버전에 따라 다르지만, 최상단 메뉴 > Tools > SDK Manager 메뉴에서 찾을 수 있다. 이번 에러의 경우, API 31 이상을 요구하고 있기 때문에 31 또는 그 상위의 버전을 추가 설치해 주면 된다. 

Android Studio SDK Manager. Android SDK API 31 이상을 필요로 하고 있다. 

android/app/build.gradle

API 31만 설치해 주면 끝날 줄 알았는데, Android를 Compile할 때 설계도와 같은 Builld.gradle에서 API 최저~최상에 대한 정의가 되어 있다. 여기에서 요구되는 구동 환경 보다 API 버전 설정이 절적하지 않으면, 위와 같은 에러가 발생하게 된다. 

주의할 점은, "android/app/build.gradle" 경로 위치에 주의하길 바란다.  동일 이름의 build.gradle은 "android/build.gradle"이 또 하나 존재한다. 

 

android/app/build.gradle의 하단쯤에 compileSdkVersion xx 의 버전을 요구하는 레벨 혹은 그 이상으로 수정해 주자.

설정에 따라서는 하단에 존재하는, defaultConfig 항목에 minSdkVersion, targetSdkVersion 도 조정해 주길 바란다. 

 

이제 다시 컴파일을 진행하면, 정상 동작함을 확인 할 수 있다.