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

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”

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

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

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)

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

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

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

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