플러터 설치 시 나올 수 있는 오류 해결

재로미·2021년 3월 8일

flutter

목록 보기

1/1

대학에서 모바일 어플리케이션 개발 수업을 듣는 데 안드로이드 스튜디오 + 플러터를 사용한다고 하여 예전에 한번 써보고 지웠던 플러터를 다시 깔게 되었다. 최근 플러터 2.0 버전이 출시되면서 점점 react의 아성을 위협하는것 아닌가 싶은 플러터.

공식 홈페이지에서 mac 버전 zip 파일을 받고 install document를 따라 하는데 역시 예전처럼 한번에 깔끔하게 뙇! 하고 모든 설정이 완료되진 않는다 ^^

위에 링크를 눌러 Docs 배너의 Get started 로 들어가면 아래와 같이 사용하는 운영체제 별 flutter zip 파일을 받을 수 있으며, 용량이 좀 되기 때문에 설치 전 storage 용량부터 먼저 확인하자.

started2

다운을 받거나 flutter git repository를 클론하여 터미널 명령어로 설치하면 일차적으로 완료 된다.

오류 1. flutter 명령어 에러, 환경변수 설정

mac 유저라면 제일 처음 맞닥트릴 수 있는 문제는 flutter를 설치해서 flutter doctor 명령어를 치는데 flutter라는 명령어를 찾을 수 없다라고 뜨는 것이다. system preference -> Security & Privacy -> general로 이동해 아래 화면의 빨간 박스 안에 flutter 설치 관해서 경고가 없는지 확인 해보자. 시스템셋팅

그리고나서 터미널에서 사용하는 shell 을 확인하고 해당 shell의 rc file을 수정하여 주면 된다.

~$ echo $SHELL 			// zsh(Z-shell)을 쓰는지 bash 쓰는지 출력
~$ echo $PATH			// 시스템에 설정된 환경변수 목록 출력
~$ vi ~/.zshrc

여기에 환경변수 목록들이 뜨는데 아무 라인을 잡고
export PATH="$PATH:[저장 위치]/flutter/bin"
를 입력해주고 저장해서 나오면 된다.

이 후 터미널을 껐다가 켜서 echo $PATH 하면 설정한 환경변수가 나타나며 
flutter 명령어가 실행 될 것이다.

자 이제 $ flutter doctor 명령어를 치면 다음과 같은 화면을 출력해 낼 것이다.

flutter error

원래 네이버 웨일과 사파리를 주로 사용하는데 chrome을 따로 써야 하나보다. 이건 구글에 chrome 쳐서 dmg 파일 받아서 실행하면 설치 되니 금방 해결 할 수 있는데 주의해서 봐야 할 것은 toolchain 과 cocoaPods 부분이다. 아, 혹시 flutter 에서 에러가 난 사람들이라면 Android studio에서 flutter와 dart 플러그인을 따로 설치해줘야 한다!!

오류 2. Android toolchain 에러

toolchain 오류는 configure sdk manager 눌렀을 때 아래 화면 처럼 정상적으로 설치가 되어 있다고 나타나는 것 처럼 보일 수 있다.

문제는 여기서 그치는 게 아니라, 오른쪽 상단에 edit를 눌러서 아래 화면에서 installed가 되어 있는지 확인을 해볼 필요가 있다는 것이다.
installed or not

필자의 경우, Android SDK Platform이 uninstalled 되어 있어서 Next 버튼을 누르고 설치 진행하니 SDK 문제는 해결 되었다.

오류 3. mac cocoaPods 에러

rudy fallback 문제로 최신 OS로 업데이트를 하지 않아서 인지 brew install cocoapods을 하던, user install 옵션을 넣든 인터넷에서 제시하는 방법들을 하니 계속 에러가 해결 되지 않았다.

~$ sudo gem install cocoapods 	// cocoapods 사이트에서도 제시하는 기본 설치법
~$ brew install cocoapods 		// 이러면 cocoapods 만 설치 됨

cocoapods 버전만 잘 알면 사용 운영체제와 호환성이 좋은 버전을 명시적으로 설치 해서 해결할 수도 있다. 
~$ sudo gem install cocoapods -v 1.8.4

그러던 중 gitHub 토론 장에서 비슷한 경험을 한 사람들 중 CathyXian이라는 사람이 제시한 해결책대로 하니 말끔히 해결 되었다.

~$ brew install cocoapods --build-from-source
~$ brew link --overwrite cocoapods

위 명령어 두줄을 입력함으로써 해결할 수 있는데 의미를 간단히 요약하자면 설치하려는 프로그램 소스에서 직접 컴파일해서 설치 한 후 기존의 링크를 다시overwrite한다는 것이다. brew 를 통해서 cocoapods을 설치해서 문제를 맞닥뜨렸다면 아주 좋은 해결책이다.

flutter doctor명령어를 쳤을 때 정상적으로 보여야 하는 모습이다.

이로써 플러터를 활용한 어플리케이션 개발의 밑작업을 마치게 되었다.

Reference

구구리.(Oct 11, 2019) macOS Catalina 업데이트 후 cocoapod 오류가 나는 문제에 대하여. postype blog post. Retrieved from
https://bonoogi.postype.com/post/4887709
fluttor get started. flutter official dev site. Retrieved (Mar 8, 2021) from
https://flutter.dev/docs/get-started/install/macos

재로미