[Flutter] M1/M2 Mac에서 CocoaPods 오류부터 iOS 앱 실행까지 전체 구성기

1. 문제 상황 및 원인 분석

Flutter 환경을 macOS(M1/M2)에서 구성하던 중, gem install cocoapods 실행 시 다음과 같은 오류 발생:

ERROR:  Error installing cocoapods:
The last version of securerandom (>= 0.3) to support your Ruby & RubyGems was 0.3.2.
securerandom requires Ruby version >= 3.1.0.
The current ruby version is 2.6.10.210.

이는 macOS 기본 Ruby가 너무 구버전이라 CocoaPods의 의존성을 만족하지 못한 것이며, 시스템 Ruby 디렉토리에 대한 쓰기 권한 문제도 함께 발생했다.

2. 전체 구성 명령어 (Flutter 설치부터 iOS 앱 실행까지)

✅ 1) Flutter SDK 설치 및 환경 설정

cd ~
mkdir -p development
cd development
git clone https://github.com/flutter/flutter.git -b stable
echo 'export PATH="$PATH:$HOME/development/flutter/bin"' >> ~/.zshrc
source ~/.zshrc
flutter doctor

✅ 2) Xcode 설치 및 초기화

# App Store에서 Xcode 설치 후 아래 명령 실행
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch
sudo xcodebuild -license accept

✅ 3) rbenv로 최신 Ruby 설치

brew install rbenv ruby-build
echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrc
source ~/.zshrc
rbenv install 3.3.0
rbenv global 3.3.0
ruby -v     # → ruby 3.3.0 확인

✅ 4) CocoaPods 설치

gem install cocoapods
pod --version  # 정상 출력 확인

✅ 5) Flutter 테스트 프로젝트 생성 및 iOS 시뮬레이터 실행

flutter create hello_flutter
cd hello_flutter

# iOS 시뮬레이터 수동 실행 (선택)
open -a Simulator

# 앱 실행
flutter run

정상 실행되면 iOS 시뮬레이터에 "Flutter Demo Home Page" 앱이 뜬다.

3. 핵심 전환 지점: 실패한 접근 vs 성공한 구조

🚫 실패한 기본 시스템 Ruby 사용 (권한/버전 오류)

gem install cocoapods

# 오류 메시지:
ERROR: You don't have write permissions for the /Library/Ruby/Gems/2.6.0 directory.

✅ 성공한 구성 (rbenv + 최신 Ruby)

brew install rbenv ruby-build
rbenv install 3.3.0
rbenv global 3.3.0
gem install cocoapods
flutter run

4. 정리 및 교훈

• macOS 기본 Ruby는 실제 개발에 적합하지 않다.
• rbenv를 통한 최신 Ruby 설치는 Flutter + iOS 개발의 필수 조건이다.
• flutter run 실행 전, 시뮬레이터가 켜져 있어야 빠르게 실행된다.

시뮬레이터 실행 이미지