macOS에서 Flutter 개발환경 세팅

 

1. Homebrew 설치 (필수 아님, 있으면 편함)

• 터미널 열고 아래 실행

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

• Homebrew 업데이트

$ brew update

 

2. Flutter SDK 설치

• 방법 1. Homebrew로 설치 (추천), 환경 변수 자동 등록까지 돼서 가장 편함.

$ brew install flutter

• 방법 2. 수동 설치
  공식 다운로드: https://flutter.dev/docs/get-started/install/macos
• 압축 풀고 원하는 폴더에 두고 PATH 등록

export PATH="$PATH:~/development/flutter/bin"

 

3. Xcode 설치 (iOS 개발 필수)

• App Store → Xcode 설치
• 그리고 아래 명령 실행

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

• iOS 시뮬레이터 확인

$ open -a Simulator

 

4. CocoaPods 설치 (iOS 의존성 관리)

• Flutter iOS 프로젝트 실행하려면 필요

$ sudo gem install cocoapods

• 또는 Homebrew로

$ brew install cocoapods

 

5. Android Studio 설치 (Android 개발 필요)

다운로드: https://developer.android.com/studio

5.1. Flutter doctor로 점검

$ flutter doctor

flutter doctor

5.2. Android Studio 설정

More Actions -> SDK Manager

 

5.2.1. Android SDK Command-line Tools (latest) 설치

SDK Tools -> Android SDK Command-line Tools (latest) - 설치

 

5.3. Google 라이선스 동의

$ flutter doctor --android-licenses

계속 y하면됨

 

5.4 플러그인 설치

• Flutter (Flutter 플러그인을 설치하면 Dart 플러그인도 자동으로 함께 설치됨)

Flutter 플러그인 설치

 

5.5. Flutter SDK path 설정

• SDK 경로확인

# 심볼릭 링크 따라가기
$ ls -l $(which flutter)
  >> /opt/homebrew/bin/flutter -> /opt/homebrew/Caskroom/flutter/3.38.3/flutter/bin/flutter

# 버전으로
$ flutter --version -v
$ flutter doctor -v


# !!! 최종 !!!
$ readlink -f $(which flutter)
  >> /opt/homebrew/share/flutter/bin/flutter

### 결론
  >> /opt/homebrew/Caskroom/flutter/3.38.3/flutter

Flutter SDK path 설정

 

6. Flutter doctor로 점검

$ flutter doctor

• 체크리스트
  • Flutter: SDK 설치 OK
  • Xcode: iOS 빌드 환경 OK
  • Android toolchain: Android SDK OK
  • Android Studio: IDE 연결 체크
  • VS Code (optional): 플러그인 설치 체크
  • Connected devices: 에뮬레이터/기기 상태

flutter doctor

 

7. VS Code, Cursor 또는 Android Studio 플러그인 설치

• VS Code 사용
  • Extensions → Flutter 설치
  • Extensions → Dart 설치
• Android Studio 사용
  • Plugins → Flutter 검색 → Install

 

8. iOS 시뮬레이터에서 Flutter 앱 실행

• 프로젝트 생성

$ flutter create my_app
$ cd my_app

• iOS 시뮬레이터 열기

$ open -a Simulator

• 실행

$ flutter run

 

9. Android 에뮬레이터에서 실행

• 에뮬레이터 켜고

$ flutter devices   // 목록 확인
$ flutter run       // 실행

 

 

10. PATH 자동 설정 확인

$ flutter --version