[Flutter 트랙] 앱개발 종합반 1-5 - Mac 환경설정

맥(Mac)에서 플러터(Flutter) 개발 환경 설정 – 완벽 가이드

플러터는 크로스 플랫폼 앱 개발을 위한 강력한 프레임워크로, Mac에서도 원활하게 개발이 가능하다.
이번 포스팅에서는 Mac 환경에서 플러터 개발을 위한 환경 설정 방법을 단계별로 정리한다.

---

1. Mac에서 플러터 개발 환경 설정 – 전체 과정

✅ Homebrew 설치
✅ Git 설치
✅ Flutter SDK 다운로드 및 환경 변수 설정
✅ VS Code 설치 및 확장 플러그인 설정
✅ Android Studio 설치 및 설정
✅ Xcode 설치 및 설정
✅ Flutter Doctor 실행 및 오류 해결
✅ iOS 시뮬레이터 및 Android 에뮬레이터 실행

---

2. Homebrew 및 Git 설치

📌 1) Homebrew 설치

Homebrew는 macOS에서 필수적인 패키지 관리 도구로, 플러터 개발 환경을 설정하는 데 필요하다.

1️⃣ 터미널(Terminal) 실행
2️⃣ 아래 명령어를 입력하여 Homebrew 설치

bash

CopyEdit

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3️⃣ 설치가 완료되면 Homebrew 버전 확인

bash

CopyEdit

brew --version

→ 버전 정보가 정상적으로 출력되면 설치 완료

📌 2) Git 설치

Git은 플러터 프로젝트 관리 및 버전 관리를 위해 필요하다.

1️⃣ Homebrew를 이용해 Git 설치

bash

CopyEdit

brew install git

2️⃣ 설치 확인

bash

CopyEdit

git --version

→ 정상적으로 버전 정보가 표시되면 Git 설치 완료

---

3. Flutter SDK 설치 및 환경 변수 설정

📌 1) Flutter SDK 다운로드

1️⃣ Flutter 공식 사이트 접속
2️⃣ "macOS" 버전 선택
3️⃣ M1/M2/M3 칩셋 사용자는 "Apple Silicon" 버전 다운로드
4️⃣ Intel Mac 사용자는 "Intel Processor" 버전 다운로드
5️⃣ 다운로드한 ZIP 파일을 압축 해제 후 /Users/사용자이름/development/flutter 경로에 이동

⚠ 경로 설정 시 한글이 포함되지 않도록 주의
(예: /Users/홍길동/development/flutter ❌ → /Users/user/development/flutter ⭕)

📌 2) 환경 변수 설정 (Path 설정)

1️⃣ 터미널에서 환경 변수 설정 파일 열기

bash

CopyEdit

vi ~/.zshrc

2️⃣ 아래 내용을 추가 (사용자 환경에 맞게 수정)

bash

CopyEdit

export PATH="$PATH:/Users/user/development/flutter/bin"

3️⃣ 변경된 환경 변수를 적용

bash

CopyEdit

source ~/.zshrc

4️⃣ Flutter 버전 확인

bash

CopyEdit

flutter --version

→ 정상적으로 버전이 출력되면 환경 변수 설정 완료

---

4. VS Code 설치 및 플러그인 설정

1️⃣ VS Code 공식 사이트에서 다운로드
2️⃣ 다운로드한 ZIP 파일을 실행 후 /Applications 폴더로 이동
3️⃣ VS Code 실행 후 "Extensions" (확장 기능) 메뉴 이동
4️⃣ Flutter & Dart 플러그인 설치

---

5. Android Studio 설치 및 설정

1️⃣ Android Studio 공식 사이트 접속 후 다운로드
2️⃣ "Apple Silicon" 또는 "Intel" 버전 선택 후 설치
3️⃣ 설치 완료 후 Android SDK 경로 설정

• Android SDK 경로: /Users/user/Library/Android/sdk
  4️⃣ SDK 설정 후 환경 변수에 추가

bash

CopyEdit

export ANDROID_HOME=$HOME/Library/Android/sdk export PATH=$PATH:$ANDROID_HOME/tools export PATH=$PATH:$ANDROID_HOME/platform-tools

5️⃣ 환경 변수 적용

bash

CopyEdit

source ~/.zshrc

---

6. Xcode 설치 및 설정

Xcode는 iOS 앱 개발 및 iOS 시뮬레이터 실행을 위해 필요하다.

📌 1) Xcode 설치

1️⃣ Mac App Store에서 "Xcode" 검색 후 다운로드
2️⃣ 다운로드 완료 후 실행
3️⃣ iOS 및 macOS 개발을 위한 필수 패키지 설치
4️⃣ 터미널에서 아래 명령어 실행하여 Xcode CLI 도구 설치

bash

CopyEdit

sudo xcode-select --install

5️⃣ 설치 완료 후 Xcode 라이선스 동의

bash

CopyEdit

sudo xcodebuild -license

---

7. Flutter Doctor 실행 및 오류 해결

설치가 정상적으로 완료되었는지 확인하기 위해 Flutter Doctor를 실행한다.

bash

CopyEdit

flutter doctor

→ 오류 메시지가 표시되면 해결 방법을 참고하여 수정

✅ Android SDK 라이선스 오류 해결

bash

CopyEdit

flutter doctor --android-licenses

모든 질문에 "y" 입력 후 진행

✅ CocoaPods 설치 (iOS 개발 필수)

bash

CopyEdit

brew install cocoapods

✅ Xcode 관련 설정 오류 해결

bash

CopyEdit

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer sudo xcodebuild -runFirstLaunch

✅ Flutter Doctor 재실행 후 확인

bash

CopyEdit

flutter doctor

→ 모든 항목이 체크(✔) 표시되면 정상적으로 설정 완료

---

8. iOS 시뮬레이터 및 Android 에뮬레이터 실행

📌 1) iOS 시뮬레이터 실행

bash

CopyEdit

open -a Simulator

또는 Xcode 실행 후 Simulator 메뉴에서 실행

📌 2) Android Emulator 실행

1️⃣ Android Studio 실행 → More Actions → AVD Manager 이동
2️⃣ "Create Virtual Device" 클릭
3️⃣ Pixel 7 등 원하는 모델 선택 후 설치 진행
4️⃣ API 35 버전 선택 후 실행
5️⃣ VS Code에서 Flutter 프로젝트 실행 후 "Run" 버튼 클릭

🔥 이제 플러터를 활용한 iOS & Android 앱 개발을 시작할 준비가 완료되었다! 🚀

---

9. 결론 – Mac에서 플러터 개발 환경 설정 정리

✔ Homebrew 및 Git 설치 후 Flutter SDK 다운로드 및 환경 변수 설정
✔ VS Code & Android Studio & Xcode 설치 후 필수 패키지 설정
✔ Flutter Doctor 실행하여 모든 설정 점검 후 오류 해결
✔ iOS 시뮬레이터 & Android 에뮬레이터 실행하여 개발 환경 테스트

💡 Mac에서도 플러터를 활용해 iOS와 안드로이드 앱을 동시에 개발할 수 있다.
환경 설정을 꼼꼼히 진행한 후, 본격적으로 플러터 앱 개발을 시작해보자! 🚀