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

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”

실시간 알림 받기
언제 알림을 드릴까요?
0 Comments
Inline Feedbacks
View all comments
지구를 위한 책 읽기📗를 시작했다

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

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

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