안드로이드스튜디오 해결: 한글 경로 때문에 설치 안될 때

1줄 요약: mklink 사용하기

👩 이 글은 영어로도 작성되었습니다.

문제: 안드로이드 스튜디오 설치 진행안됨

안드로이드 스튜디오 설치 과정의 SDK 요소 셋업에서 많은 한글 사용자들은 Next 버튼이 비활성화되어 다음으로 넘어가지 않는다. “Your SDK location contains non-ASCII characters”라는 에러 메시지가 뜬다.

안드로이드스튜디오 해결: 한글 경로 때문에 설치 안될 때

원인: 설치경로가 영어만 가능함

안드로이드 스튜디오는 특이하지만 설치 경로에 영어 알파벳만을 허용한다.(á, à, â 등등도 안됨. 한국어Korean 사용자 뿐만 아니라 스페인어, 러시안어 등등 외국어 사용자들도 겪는 문제)

아, 띄어쓰기도 안된다(또다른 에러: “your path contains white space etc.”). 언제쯤 유니코드를 지원해 줄지 😓

가장 쉬운 해결법: mklink 명령어 사용

이 문제에 가능한 해결법은 크게 4가지가 있는데, 4번을 추천하는 이유는 다음과 같다.

  1. 아예 Windows 사용자 계정 이름을 바꾸기 (“C:\Users\Username”의 Username)
    오래 걸리고 이미 설치된 다른 경로들에 문제가 생길 수 있어 백업 필수. 바로가기 파일들 전부 초기화됨. (문제가 언급된 블로그)
  2. 영어 이름으로 윈도우 계정 새로 파기
    윈도우10 자동 로그인이 안되고 켤 때마다 계속 비번쳐서 입력하게 됨 (문제가 언급된 블로그)
  3. C:\ 아래 영어 이름으로 폴더 만들어서 설치하기
    가장 단순한 해결 방법이나, 처음엔 잘 실행될 수 있어도 나중에 에뮬레이터/코틀린 실행에서 문제 발생 (문제가 언급된 블로그)
  4. mklink 명령어를 사용하기
    가장 깔끔한 해결방법이자 해외에서 가장 많이 사용되는 방법!

명령어를 사용해야 한다니 어려울 것 같지만 진짜 간단하다(누구나 할 수 있다). 한국 블로그에는 이 방법이 소개된 글이 없어서 직접 정리해 봤다. 딱 3단계!


1. 기본 설치 경로 만들기

만약 우리의 윈도우 유저네임이 영어였다면 아무 문제 없이 설치되었을 그 기본 설치 경로를 만들어주자. 윈도우 탐색기에서 “C:\Users(=사용자)\나의 계정이름\AppData\Local\” 에 들어가자. 폴더명 “Android”을 만들고, 그 안에 폴더명 “Sdk”을 만들자.

안드로이드스튜디오 해결: 한글 경로 때문에 설치 안될 때

이때 Appdata 폴더가 안보인다면 그냥 주소창에 “C:\Users\나의 계정이름\AppData\Local” 치면 된다.

안드로이드스튜디오 해결: 한글 경로 때문에 설치 안될 때

2. 명령 프롬프트(cmd)에 mklink 명령어로 바로가기 폴더 만들기

윈도우 검색창에 cmd 입력후 관리자 권한으로 실행하고, 다음 명령어를 입력한다.
mklink /D “C:\android-sdk” “C:\Users\나의 계정이름\AppData\Local\Android\sdk”

안드로이드스튜디오 해결: 한글 경로 때문에 설치 안될 때
안드로이드스튜디오 해결: 한글 경로 때문에 설치 안될 때

성공하면, “기호화된 링크를 만들었습니다”하고 뜬다. mklink란 기호화된 링크(symbolic link)=정션(junction)를 만드는 명령어다.

이 때 “You do not have sufficient privilege to perform this operation.” 에러가 뜬다면 cmd를 켤 때 “우클릭>관리자 권한으로 실행”을 까먹은 거다.

3. 이제 경로를 “C:\android-sdk”로 하면 설치 성공!

안드로이드스튜디오 해결: 한글 경로 때문에 설치 안될 때

성공! 오늘도 힘찬 하루!

+ 새 프로젝트 만들 때도 경로 바꾸기, 잊지 말자!

안드로이드스튜디오 해결: 한글 경로 때문에 설치 안될 때

새 프로젝트를 만들 때 위치에서 똑같은 에러가 뜬다. 위치를 “C:\android-sdk” 아래로 바꿔주는걸 잊지 말자. 그냥 저기에 새 폴더 “AndroidStudioProjects”를 만들어 주고, 이미지와 같이 경로를 입력하면 된다. “C:\android-sdk\AndroidStudioProjects\app1”

+13
실시간 알림 받기
언제 알림을 드릴까요?
11 Comments
oldest
newest most voted
Inline Feedbacks
View all comments
yoo
2021-04-24 2:51 오후

선생님 윈도우 창에선 android-sdk 폴더가 생성이 되었는데 안드로이드 스튜디오에서는 인식이 되질 않습니다 어떻게 해야 할까요?

..
2021-11-15 6:56 오후
Reply to  소희

저분처럼 비슷한 증상인데(안드로이드 설치화면 에는 제가만든 풀더가 보이지않아서 설치가 불가해여) 안드로이드 재부팅 해봐도 안되고. 2번쨰 말은 이해가 안가서… 참고클릭해서 보는데 그것도 이해가 가지않네요 .. ㅠ

raaaa
2021-05-07 2:35 오후

감사합니다ㅠㅠㅠㅠ

질문
2021-05-23 10:06 오후

안녕하세요. 질문 하나만 드려도 될까요?
android\Sdk 폴더를 만들고 명령어를 쳤어야하는데,
실수로 Sdk 폴더만 만들고 명령어를 입력해서,
링크 경로가 \D로 걸렸습니다 ㅠㅠ

해제하려고 rmdir \d 를 입력해봤는데 디렉터리 이름이 올바르지 않다고하여서… 어떻게 하면 좋을까요? ㅠ

PizzaKing
2021-07-14 3:24 오후

심성이 고우시군요 따봉드립니다.(최고)

익명
2021-07-16 1:18 오후

감사합니다! 예전에 이 프로그램 설치한다고 사용자 이름 바꾼다고 포멧했던 기억이 있어서 정말 힘들었는데, 이런 간단한 방법이 있었다니! ㅠㅠ 정말 감사합니다!

주니
2021-07-17 2:44 오후

감사합니다. 해당문제를 적어주신 글로 인해 잘 해결하였습니다.
헌데 플러터에서 개발하는 와중 AVD manager를 통해 가상머신으로 핸드폰을 설정하고
상단의 <device selected> 에서 가상머신으로 설정한 핸드폰(Android Emulator)를 클릭하게되면,
Error Opening Emulator라고 뜨면서 연결이 되지 않습니다.

해당 오류를 고쳐보기위해 구글링을 해보았지만 신통한 방법이 없네요.

해당문제가 한글경로 문제일것같다는 생각도 드는데. 그런걸까요?
주인장님께선 어떻게 생각하시나요?

▼에러의 전문은 아래와 같습니다.

emulator: WARNING: FeatureControlImpl.cpp:198: Failed to load advanced feature default setting:C:\Users\�븞二쇱��쁽\AppData\Local\android\sdk\emulator\lib\advancedFeaturesCanary.ini handleCpuAcceleration: feature check for hvf added library vulkan-1.dll emulator: WARNING: encryption is off emulator: INFO: load_config.cpp:248: Could not open C:\Users\�븞二쇱��쁽\AppData\Local\android\sdk\system-images\android-30\google_apis_playstore\x86\\VerifiedBootParams.textproto: Unknown error Failed to open /qemu.conf, err: 2 HAX is working and emulator runs in fast virt mode. qemu: could not load PC BIOS ‘bios-256k.bin’ emulator: Android emulator version 30.7.5.0 (build_id 7491168) (CL:N/A)

김삿갓
2021-08-10 9:29 오후

정말 큰 도움 받았습니다 감사합니다 ㅠㅠ

Andy
2021-08-24 4:08 오후

안녕하세요, 안드로이드 스튜디오 (version 2020.3.1 for Windows 64-bit) SDK 설치에 애를 먹고 있어 문의 드립니다. 안드로이드 스튜디오 프로그램 설치 진행시 “SDK Components Setup”이 제대로 되질 않습니다. 그대로 진행하면 마지막에 “SDK emulator directory is missing”이라는 문구가 뜹니다. 설치 후 프로그램을 실행하면 첫 화면에 “No Android SKD found” 라 뜨는데 SDK manager로 들어가도 모두 비어 있습니다. 경로 추척해서 users/사용자/AppData/Local로 가면 Android 폴더 자체가 형성이 되질 않습니다. 물론 SDK path 경로명에 한글은 없습니다. 5번 정도 지웠다 설치했다를 반복해도 같은 상황이라 선생님께 문의 드립니다. (PC 환경 윈도우10 64비트이고 메모리는 12G 정도 여유 있습니다)

지구를 위한 책 읽기📗를 시작했다

지구를 위한 책 읽기📗를 시작했다

안드로이드스튜디오 해결: 한글 경로 때문에 설치 안될 때

3-STEPS to Fix Android Studio’s “Your SDK location contains non-ASCII characters” Error