오늘은 개발하는남자의 핸즈온 플러터에서 개발환경설정 파트에서 언급하고 싶은 부분이 있어서 이렇게 준비하게 되었습니다. 개발자로 일하시는 분들중 앱 개발자분들 중에는 맥에서 개발을 하는 경우가 많습니다. 이유는 iOS 대응 때문입니다. 저 역시 맥에서만 개발을 하다보니 윈도우 환경에서의 발생될 수 있는 문제에 대해서 크게 인지를 하지 못했었습니다. 그래서 책에도 개발환경 설정에 대한 가이드만 있었고 이슈에 대한 내용은 추가하지 못했습니다. 하지만 윈도우로 개발환경 설정하는 분들중 많은 분들이 윈도우 PC를 사용하시면서 사용자 이름을 한글로 설정하시는 분들이 많다는 것을 느꼈습니다. 그런경우 개발공부를 호기롭게 시작했는데 시작하기도전에 개발환경 세팅하면서 진을 다 빼시는 분들에게 이 포스팅이 도움이 되었으면 좋겠습니다.
Q : PC에 한글을 사용한 경우 왜 개발에서 문제가 발생될까?
A : 여러 가지 IDE나 개발 sdk의 경우 대부분이 영문 기반으로 설계되어 있어서 비 ASCII 문제들이 경로에 있을 경우 해석하는 데에 문제가 발생되곤 합니다. 특히 Android SDK나 Gradle과 같은 Java 기반의 툴들은 비 ASCII 문자가 있는 경우 파일을 찾지 못하는 문제가 있습니다
3. 안드로이드 스튜디오 위저드 설정 창이 활성화가 자동으로 되며 Next버튼으로 설치를 이어서 진행합니다.
Android SDK 설치 위치를 설정하는 창에서 오류가 발생하게 됩니다.
이유는 Android에서 기본적으로 default SDK 설치 위치를 C:\Users\[컴퓨터 사용자이름]\AppData\Local\Android\Sdk 로 설정되어있기 때문입니다. 이때 컴퓨터의 설정한 사용자 이름을 한글로 지정한 경우 ASCII 문자오류로 인해 설치를 할 수 없다고 오류를 발생시키고 있는 것입니다.
해결방법
android sdk 설치 경로를 C:\하위에 sdk 폴더를 플러터 sdk 설치했던 대로 위치를 변경해주면 됩니다.
3-1. Android SDK Location 경로 우측 폴더 아이콘 클릭
3-2. C:\의 sdk 폴더를 선택한 뒤 상단의 폴더 생성 아이콘 클릭합니다.
3-3. 폴더 생성창에 android 라는 이름을 입력하고 OK버튼을 눌러줍니다.
3-4. 생성된 android폴더가 C:\sdk\ 폴더 내부에 생성되었는지 확인하고 android 폴더를 선택하고 OK 버튼을 눌러줍니다.
3-5. 이전과 달리 새로운 경로에는 한글이 포함되어있지 않아 오류가 없어진 모습을 확인할 수 있습니다.
4. 라이선스 동의
5. 설치가 진행됩니다.
설치가 완료 되고 나면 안드로이드 스튜디오가 실행되며 안드로이드 스튜디오가 설치가 완료 된 것입니다.
4. 다른 sdk 경로와 마찬가지로 C:\의 sdk 폴더를 선택해주고 확인 버튼눌러줍니다.
5. 다음과 같이 경로가 설정되었다면 다음버튼틀 통해 설치를 진행합니다.
6. 설치가 정상적으로 되는 것을 확인합니다.
4 . Flutter Doctor 이슈 대응
안드로이드 SDK를 찾을 수 없는 문제
flutter에서 android sdk를 통해 명령실행을 수행하게 되는데 기본적으로 flutter에서 android sdk 위치를 C:\\Users\\[컴퓨터 사용자 이름] 하위에서 sdk를 찾기 때문에 발생되는 문제로 우리는 한글 폴더가 포함되어있어서 android sdk의 설치 위치를 변경해줬기 때문에 flutter에서는 찾을 수 없는 현상입니다.
친절하게 android-sdk 경로를 새로 지정하는 방법에대해서 가이드를 해주고 있습니다.
flutter config —android-sdk 명령어를 사용하라고 flutter doctor가 알려주고 있습니다.
android sdk를 C:\\sdk\\android 위치로 설정한 사실을 기억하기 때문에 위 명령어를 다음과 같이 실행하면 문제가 해결이됩니다.
flutter config —android-sdk="C:\\sdk\\android" 실행 이후 다시 flutter doctor를 사용하면 android sdk 경로를 찾지 못한다는 경고 메세지는 없어진것을 확인 할 수 있습니다.
