Flutter란?
Flutter는 구글이 만든 크로스플랫폼 앱 개발 프레임워크이다. 코드 한 벌로 Android와 iOS 앱을 동시에 만들 수 있다는 게 가장 큰 장점이다. 사용 언어는 Dart인데, JavaScript나 Java와 문법이 비슷하다는 점이 있다.
내 Mac 칩 종류 확인
설치 방법이 칩에 따라 조금 다르므로 먼저 확인
화면 왼쪽 상단 애플 로고() → 이 Mac에 관하여 클릭
- Apple M1 / M2 / M3 라고 나오면 → Apple Silicon (ARM)
- Intel 이라고 나오면 → Intel Mac
Rosetta 2 관련
Mac 칩 종류가 뭔가요? 아까 확인 방법 알려드린 것처럼 애플 로고 → 이 Mac에 관하여에서 확인해 보면 된다.
- Apple Silicon (M1/M2/M3) 이면 Rosetta 2 설치가 필요하다. 일부 도구들이 아직 Intel 기반으로만 동작하기 때문에 Flutter 개발 환경에서 종종 필요하다.
- Intel Mac 이면 Rosetta 2 설치 불필요하다.
Apple Silicon이라면 아래 명령어 한 줄로 설치진행!
sudo softwareupdate --install-rosetta --agree-to-license
설치 후 별도로 뭔가 실행하거나 설정할 건 없고, 백그라운드에서 필요할 때 자동으로 동작한다.
1단계 — Homebrew 설치
Homebrew는 macOS의 패키지 관리자로, 개발 도구들을 명령어 한 줄로 설치할 수 있게 해준다. 터미널을 열고 아래 명령어를 붙여넣기
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
설치 중 비밀번호 입력을 요구하면 Mac 로그인 비밀번호를 입력한다. 입력해도 화면에 아무것도 표시되지 않는 게 정상이다.
Apple Silicon Mac 추가 작업 설치 완료 후 터미널에 아래 두 줄을 실행한다.
(Intel Mac은 건너뛰세요)
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
설치 확인
brew --version
버전 숫자가 나오면 잘 설치 된거다.
2단계 — Flutter SDK 설치
Homebrew로 Flutter를 한 번에 설치한다.
brew install --cask flutter
설치가 완료되면 아래 명령어로 확인한다.
flutter --version이렇게 나오면 성공이다.
Flutter 3.x.x • channel stable
Dart 3.x.x
3단계 — Xcode 설치 (iOS 빌드용)
iOS 앱을 빌드하려면 Xcode가 반드시 필요하다.
① App Store에서 Xcode 설치
App Store → 검색창에 Xcode 검색 → 설치 용량이 약 15GB로 크기 때문에 시간이 걸린다.
② Xcode 추가 설정
설치 완료 후 터미널에서 아래 명령어를 순서대로 실행한다.
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch
③ iOS 시뮬레이터 설치
xcodebuild -downloadPlatform iOS
④ CocoaPods 설치
iOS 앱의 패키지 관리에 필요한 도구이다.
brew install cocoapods
4단계 — Android Studio 설치 (Android 빌드용)
VS Code로 개발하더라도 Android SDK와 에뮬레이터는 Android Studio를 통해 설치해야 한다.
① 설치
brew install --cask android-studio
② Android Studio 첫 실행 및 SDK 설치
Android Studio 실행 → 초기 설정 마법사가 뜨면 Standard 선택 후 계속 진행합니다. 자동으로 Android SDK가 설치된다.
③ 에뮬레이터 생성
Android Studio → More Actions → Virtual Device Manager → Create Device
- 기기: Pixel 7 선택
- 시스템 이미지: 최신 API 버전 선택 후 Download → Next → Finish
④ Android 라이선스 동의
flutter doctor --android-licenses
질문이 나올 때마다 y 를 입력하고 Enter를 누르자
5단계 — VS Code 설치 및 Flutter 확장 설치
① VS Code 설치
brew install --cask visual-studio-code
② Flutter 확장 설치
VS Code 실행 → 왼쪽 사이드바 Extensions 아이콘 클릭 (Cmd+Shift+X) → 검색창에 Flutter 입력 → Flutter (by Dart Code) 설치
Flutter 확장을 설치하면 Dart 확장도 자동으로 함께 설치된다.
6단계 — flutter doctor로 전체 점검
flutter doctor
아래처럼 체크 표시가 나와야 한다.
[✓] Flutter (Channel stable)
[✓] Android toolchain
[✓] Xcode - develop for iOS and macOS
[✓] Chrome - develop for the web
[✓] Android Studio
[✓] VS Code
[✓] Connected device
모든 항목에 ✓ 가 표시되면 환경 설정이 완료된 것이다.
자주 나오는 경고 해결법
CocoaPods not installed 오류
brew install cocoapods
Android toolchain - cmdline-tools component is missing 오류: Android Studio → SDK Manager → SDK Tools 탭 → Android SDK Command-line Tools 체크 → Apply
Xcode - CocoaPods installed but not working 오류
sudo gem install cocoapods
pod setup