안녕하세요! 오늘은 Apple Silicon(M1, M2, M3) 칩을 탑재한 맥에서 Flutter 개발 환경을 구축하는 방법 을 상세히 알아보겠습니다.
인텔 맥과 달리 M1 이상의 맥에서는 CocoaPods 설치 시 Ruby 버전 호환성 문제로 인해 애를 먹는 경우가 많은데요. SDK 설치부터 환경 변수 설정, 그리고 악명 높은 Error installing cocoapods 해결법까지 깔끔하게 정리해 드릴게요.
1. Flutter SDK 설치 및 환경 변수 설정
가장 먼저 Flutter SDK를 다운로드하고 터미널에서 언제든 실행할 수 있도록 경로를 설정해야 합니다.
- Flutter 공식 홈페이지에서 Apple Silicon 용
.zip파일을 다운로드합니다. - 원하는 경로(예:
~/development)에 압축을 해제합니다. - 영구적인 사용을 위해
zshrc파일에 경로를 추가합니다.
# zsh 설정 파일 열기
vi ~/.zshrc
# 파일 하단에 아래 내용 추가 (사용자 경로는 본인에 맞게 수정)
export PATH="$PATH:/Users/[사용자계정]/development/flutter/bin"
# 설정 반영
source ~/.zshrc설정 후 터미널에 flutter doctor를 입력하여 현재 설치 상태를 확인해 보세요.
2. Xcode 및 CocoaPods 설정 (M1 오류 해결)
iOS 앱 빌드를 위해 Xcode 설치와 함께 의존성 관리 도구인 CocoaPods 가 필요합니다. 여기서 많은 분이 에러를 마주하게 됩니다.
Xcode 기본 설정
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch
sudo xcodebuild -license # 이후 'agree' 입력CocoaPods 설치 시 발생하는 Ruby 에러 해결
M1 맥의 기본 Ruby 버전(2.6.x)은 최신 CocoaPods와 호환되지 않아 Error installing cocoapods가 발생할 수 있습니다. 이럴 때는 Homebrew를 통해 Ruby를 업데이트 하는 것이 가장 확실합니다.
# 1. Homebrew로 최신 Ruby 설치
brew install ruby
# 2. Apple Silicon 전용 ffi 설치 및 CocoaPods 설치
sudo gem uninstall ffi && sudo gem install ffi -- --enable-libffi-alloc
sudo gem install cocoapods
# 만약 위 방법으로 안 된다면 brew로 직접 설치하세요
brew install cocoapods설치가 완료되면 pod --version으로 정상 작동 여부를 확인합니다.
3. 안드로이드 스튜디오 및 도구 설정
안드로이드 앱 개발을 위해 IDE와 필요한 라이선스 설정을 진행합니다.
- Android Studio 설치: 공식 사이트에서 다운로드 후 실행합니다.
- 명령줄 도구 설치:
Settings>Languages & Frameworks>Android SDK>SDK Tools탭에서 Android SDK Command-line Tools (latest) 를 체크하여 설치합니다. - 라이선스 동의: 터미널에서 아래 명령어를 실행하고 모든 항목에
y를 입력합니다.
flutter doctor --android-licenses- Flutter 플러그인: 안드로이드 스튜디오의
Plugins메뉴에서Flutter와Dart플러그인을 설치합니다.
4. 최종 점검: flutter doctor -v
이제 모든 준비가 끝났습니다. 터미널에 다시 한번 명령어를 입력해 보세요.
flutter doctor -v모든 항목에 초록색 체크 표시가 나타난다면 이제 M1 맥에서 즐겁게 플러터 코딩을 시작할 준비가 된 것입니다!
결론
M1 맥에서의 Flutter 설정은 특히 Ruby 버전과 CocoaPods의 호환성 을 맞추는 것이 핵심입니다. 시스템 기본 Ruby 대신 Homebrew를 적극 활용하면 의존성 지옥에서 빠르게 탈출할 수 있습니다.
설정 과정 중 막히는 부분이 있다면 언제든 댓글로 질문 남겨주세요!