Flutter는 Google이 만든 크로스플랫폼 앱 프레임워크로, 하나의 코드로 iOS, Android, 웹, 데스크탑 앱을 동시에 개발할 수 있습니다.
iOS 앱 빌드·배포에는 Xcode가 필요하고, Xcode는 macOS에서만 동작합니다. Android와 iOS를 모두 출시하려면 Mac 환경이 사실상 필수입니다.
이 글에서는 Homebrew 설치부터 Flutter, Android Studio, Xcode 세팅까지 Mac에서 Flutter 개발 환경 구축 전 과정을 순서대로 정리합니다.
목차
1. Flutter란? Mac을 선택하는 이유
2. 사전 준비 - Homebrew 설치
3. Flutter 설치 및 상태 확인
4. Android Studio & Xcode 설치
5. flutter doctor 최종 점검 및 자주 발생하는 오류
#1. Flutter란? Mac을 선택하는 이유
1) Flutter 개요와 특징
Flutter는 Google이 2018년 공개한 오픈소스 UI 프레임워크로, Dart 언어 기반입니다. 단일 코드베이스에서 iOS, Android, 웹, 데스크탑 앱을 동시에 빌드할 수 있으며, 자체 렌더링 엔진(Skia/Impeller)을 사용해 네이티브에 가까운 성능을 제공합니다.
· · · · ·
2) Flutter vs 다른 프레임워크 비교
항목
Flutter
React Native
네이티브
언어
Dart
JavaScript
Swift / Kotlin
지원 플랫폼
iOS, Android, 웹, 데스크탑
iOS, Android
각 플랫폼 전용
렌더링 방식
자체 렌더링 엔진
브릿지 방식
OS 네이티브
성능
높음
중간
최고
※ 참고: flutter.dev 공식 문서, reactnative.dev 공식 문서 기반 비교 정리 (출처 명확성 보통)
· · · · ·
3) Mac에서 개발해야 하는 이유
① iOS 빌드는 macOS 전용: Xcode는 macOS에서만 실행되므로 iOS 앱 배포 시 Mac 필수
② Android와 iOS 동시 개발 가능: 두 플랫폼을 하나의 환경에서 관리
③ iOS Simulator 제공: 실기기 없이 iOS 앱 테스트 가능
④ Homebrew 기반 간편한 패키지 관리 지원
#2. 사전 준비 - Homebrew 설치
1) Homebrew란?
Homebrew는 Mac용 패키지 관리 도구입니다. 터미널 명령어 한 줄로 Flutter, Android Studio, CocoaPods 등 개발 도구를 설치·관리할 수 있어 Mac 개발 환경의 기반이 됩니다. 이미 설치된 경우 brew --version으로 확인 후 생략 가능합니다.
· · · · ·
2) Homebrew 설치 및 Apple Silicon 주의사항
# Homebrew 설치
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Apple Silicon(M1/M2/M3) Mac 필수 추가 작업: 설치 후 터미널 안내에 따라 PATH 환경 변수를 반드시 추가합니다.
# Apple Silicon Mac 전용 PATH 설정
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
#3. Flutter 설치 및 상태 확인
1) Flutter 설치 및 버전 확인
# Flutter 설치
brew install flutter
# 설치 확인
flutter --version
· · · · ·
2) flutter doctor로 환경 진단
flutter doctor 명령어로 개발 환경 상태를 진단합니다. Android Studio·Xcode 미설치 시 [✗] 표시가 나타나지만 이후 단계에서 해결합니다.
# 개발 환경 상태 진단
flutter doctor
① [✓] 정상 설치 완료 ② [✗] 설치 필요 또는 오류 ③ [!] 선택적 설치 또는 경고
· · · · ·
3) stable 채널 전환 권장
# stable 채널 확인 및 전환
flutter channel
flutter channel stable && flutter upgrade
#4. Android Studio & Xcode 설치
1) Android Studio 설치 및 설정
# Android Studio 설치
brew install --cask android-studio
① 실행 후 Install Type → Standard 선택 → Next
② License Agreement → android-sdk-license / android-sdk-arm-dbt-license 모두 Accept → Finish
③ More Actions → SDK Manager → SDK Tools 탭 → Android SDK Command-line Tools (latest) 체크 → OK
④ 설치 완료 후 아래 명령어로 Android 라이선스 수락
# Android 라이선스 수락
flutter doctor --android-licenses
· · · · ·
2) Xcode 설치 및 CocoaPods 설정
① Xcode 설치 전 macOS를 최신 버전으로 업데이트 권장 (구버전 시 iOS 빌드 오류 발생)
② App Store → Xcode 검색 → 설치 시 platform 선택에서 iOS 반드시 체크
③ iOS 미선택 시 → Xcode → Settings → Components 탭에서 나중에 추가 가능
④ Xcode 설치 완료 후 CocoaPods 설치
# iOS 의존성 관리 도구 CocoaPods 설치
brew install cocoapods
#5. flutter doctor 최종 점검 및 자주 발생하는 오류
1) 최종 flutter doctor 실행
모든 도구 설치 후 flutter doctor를 실행해 모든 항목이 [✓] 상태인지 확인합니다. 완료되면 Flutter 개발 환경 구축이 성공된 것입니다.
# 최종 환경 점검
flutter doctor
· · · · ·
2) 자주 발생하는 오류와 해결 방법
(1) Android toolchain 오류
① 원인: SDK Command-line Tools 미설치 또는 라이선스 미수락
② 해결: Android Studio → SDK Manager → SDK Tools → Android SDK Command-line Tools (latest) 설치
③ flutter doctor --android-licenses 실행하여 라이선스 수락
