[Flutter] 설치 및 환경설정(Mac)

플러터 설치

https://flutter.dev/ 접속

Flutter - Build apps for any screen

Get Started 클릭 MacOs 선택 한다

인텔 맥인 경우 아래 명령어를 실행시키지 않아도 되며 실리콘 맥인 경우 아래 명령어를 필수로 터미널에서 입력해야 한다

 

sudo softwareupdate --install-rosetta --agree-to-license

 

 

인텔 맥 또는 실리콘 맥에 맞는 플러터 압축파일 다운로드

원하는 경로에 압축 해제 후 아래 명령어를 통해 경로를 설정해 준다

 

export PATH="$PATH:`pwd`/flutter/bin"

 

위 명령어는 해당 터미널 창에서만 PATH변수를 설정하는 것이고 나중에 fvm을 통해 버전 관리를 할 것이기 때문에 현재 터미널에서만 PATH를 설정했다

[Flutter] FVM (Flutter Version Management) 설치

[Flutter] FVM (Flutter Version Management) 설치

 

 

영구적으로 추가할려면 아래 링크를 통해 확인 후 설정하면 된다

https://docs.flutter.dev/get-started/install/macos#update-your-path

macOS install

 

터미널 창에서 아래 명령어 실행

 

flutter

 

git이 설치되어 있지 않다면 git 설치 화면이 뜬다

 

git 설치 완료 또는 flutter 가 정상적으로 실행되면 아래 명령어로 flutter 버전 확인

 

flutter --version
# 정상적인 경우
Flutter 3.13.7 • channel stable • https://github.com/flutter/flutter.git
Framework • revision 2f708eb839 (4일 전) • 2023-10-09 09:58:08 -0500
Engine • revision a794cf2681
Tools • Dart 3.1.3 • DevTools 2.25.0

 

아래 명령어를 통해 flutter 설정을 완료하기 위해 설치해야하는 종속성이 있는지 확인한다

 

flutter doctor

 

안드로이드 스튜디오 설치

https://developer.android.com/studio

Download Android Studio & App Tools - Android Developers

인텔 맥 또는 실리콘 맥에 맞는 스튜디오를 설치한다

 

설치 후 안드로이드 스튜디오를 실행 후에 좌측 Plugins 탭 선택 후 Flutter 을 설치해준다

그 다음 안드로이드 스튜디오를 재시작 하면 플러터 프로젝트를 생성 할 수 있다

플러터 프로젝트 생성시 flutter sdk 경로를 잡아줘야 하는데

flutter 압축 해제한 경로를 넣어주면 된다

나 같은 경우 /Users/유저명/app 에 압축을 해제해 줬고 /Users/유저명/app/flutter 까지 경로를 입력해 주면 스튜디오가 자동으로 경로를 잡는다

 

cmdline-tools 설치

settings -> sdk 검색 후 command-line Tools 설치

 

xCode 설치

앱스토어에서 xCode 설치 (다소 시간이 걸릴 수 있음)

 

Cocoapods 설치

brew를 설치해 준다

https://brew.sh/

Homebrew

brew 설치 후 rbenv (ruby 버전 관리) 를 설치 한다

 

brew install rbenv

 

아래 명령어를 통해 gem 경로를 확인해 주는데 /usr/bin/gem 경로를 바라보는 것은 시스템 ruby를 사용중이라는 뜻이다

 

which gem
/usr/bin/gem

 

시스템 ruby는 문제점이 많기 때문에 rbenv로 원하는 ruby로 설치 후 설정을 해줘야 한다

 

# 설치 가능 버전 확인
rbenv install -l

# 설치
rbenv install {버전명}

# 적용
rbenv global {버전명}

# 초기화
rbenv init
# Load rbenv automatically by appending
# the following to ~/.zshrc:

eval "$(rbenv init - zsh)"

 

위 명령어로 원하는 버전에 ruby를 설치 후 초기화 까지 해준다음 

.zshrc 파일에 eval "$(rbenv init - zsh)" 추가해 준다

.zshrc 파일이 없으면 생성해 준 뒤 설정해주면 된다

그리고 터미널은 껐다 킨 후에 which gem 명령어를 통해 gem 경로가 바뀐 것을 확인한다

 

sudo gem install cocoapods

 

위 명령어를 통해 cocoapods 설치

gem으로 cocoapods 설치가 오류날 경우 그냥 brew로 설치해 줘도 된다

 

sudo gem uninstall cocoapds
brew cleanup -d -v
brew install cocoapods

 

gem으로 설치가 안될 경우 위 명령어를 통해 brew로 설치

cocoapods 설치 후 아래 명령어로 설치 및 버전 확인

 

pod --version
1.13.0

 

 

 

여기까지 MacOs 에서 flutter 설치가 완료 되었다

모두 정상적으로 설치가 되었다면

 

# flutter doctor 명령어 실행
flutter doctor

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.13.7, on macOS 13.6 22G120 darwin-arm64, locale ko-KR)
[✓] Android toolchain - develop for Android devices (Android SDK version 33.0.1)
[✓] Xcode - develop for iOS and macOS (Xcode 15.0)
[✓] Chrome - develop for the web
[✓] Android Studio (version 2022.3)
[✓] VS Code (version 1.82.2)
[✓] Connected device (2 available)
[✓] Network resources

• No issues found!

 

위와 같이 정상적으로 출력이 될 것이고 완료되지 않은 설정이 남아 있다면

flutter doctor 명령어를 통해 완성되지 않은 부분을 해결해 주면 된다