[Android Studio] SDK 문제 해결

프로젝트를 진행하면서 SDK 에러를 자주 만나는데 매번 찾아보기 귀찮아서 글로 남겨본다! 📝

🔍 에러 메시지

SDK location not found. Define a valid SDK location with an ANDROID_HOME environment variable 
or by setting the sdk.dir path in your project's local properties file at 'C:\Users\YourUsername\project\local.properties'.

이 에러는 SDK 경로를 찾을 수 없어서 발생하는데 아래 두 가지를 확인하면 쉽게 해결할 수 있다 👇

🔧 해결 방법 

1️⃣ ANDROID_HOME 시스템 환경 변수 설정

ANDROID_HOME 환경 변수가 제대로 설정되어 있는지 확인

 

설정 방법:

1. Windows 검색창에서 시스템 환경 변수 편집을 검색해 클릭하거나
   제어판 → 시스템 및 보안 → 시스템 → 고급 시스템 설정 → 환경 변수로 들어가서 편집하면 된다
2. 시스템 변수 영역에서 ANDROID_HOME이 설정되어 있는지 확인하고 없으면 새로 만들기를 눌러 추가
   • 변수 이름: ANDROID_HOME
   • 변수 값: SDK가 설치된 경로
   • 예: C:\Users\YourUsername\AppData\Local\Android\Sdk

 

 

결과 예시:

설정을 저장한 후, 명령 프롬프트에서 확인

아래 명령어를 실행했을 때, 올바른 경로가 출력되면 설정 완료 🎉

echo %ANDROID_HOME%

2️⃣ local.properties 파일에 sdk.dir 설정

local.properties 파일은 프로젝트의 루트 디렉토리에 있는 파일로, SDK 경로를 명시적으로 설정할 수 있다

 

설정 방법:

1. 프로젝트 루트 폴더에서 local.properties 파일을 찾고 없다면 새로 생성
2. 아래와 같이 SDK 경로를 설정

sdk.dir = C\:\\Users\\YourUsername\\AppData\\Local\\Android\\Sdk

⚠️ 경로에 있는 백슬래시(\)를 이중으로 입력할 것!

 

✅ 마무리

위 두 가지 방법 중 하나를 적용하면 SDK location not found 에러를 쉽게 해결할 수 있다

1. 환경 변수 ANDROID_HOME 설정
2. local.properties 파일에 sdk.dir 추가