[Flutter] iOS 앱 개발 환경 설정 ( Xcode 및 CocoaPods )

이 글은 Flutter 개발 환경 설정 가이드의 하위 포스트로, Flutter로 iOS 앱을 개발하기 위한 환경을 설정하는 방법을 설명합니다.

(2025년 01월 12일 기준) Flutter로 iOS 앱을 개발하려면 Xcode 16 버전 및 CocoaPods 1.16 버전이 필요합니다. 이번 포스팅에서는 맥북(macOS)에서 iOS 앱 개발 환경 설정 방법에 대해서 알아보겠습니다.

iOS 앱 개발 환경 설정

Xcode 설치 및 환경 설정

iOS 앱 개발을 위해 Xcode를 설치해야 합니다.

Xcode 설치

1. App Store를 열고, Xcode를 검색하여 설치합니다.
2. 설치가 완료되면 Xcode를 실행하여 필요한 구성 요소를 다운로드합니다.

Xcode 라이선스 동의

Xcode를 처음 사용할 때는 사용 라이선스에 동의해야 합니다. Xcode 실행 후 라이선스 동의하거나 터미널 명령어를 통해 라이선스 동의할 수 있습니다.

터미널을 열고 아래 명령을 입력하고 라이선스 내용을 확인한 뒤, agree를 입력하여 라이선스에 동의합니다.

sudo xcodebuild -license

명령줄 도구(Command Line) 설정

설치된 Xcode 버전을 명령줄 도구(Command Line)로 설정하기 위해 터미널에서 아래 명령어를 입력합니다.

sudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch'

루비(Ruby) 버전 확인 및 업데이트

CocoaPods를 설치하려면 최신 버전의 Ruby가 필요합니다.

루비 버전 확인

터미널에서 아래 명령어로 현재 설치된 Ruby 버전을 확인합니다.

ruby -v

ruby 2.6.10p210 (2022-04-12 revision 67958) [universal.arm64e-darwin24]

(2025년 01월 12일 기준) CocoaPods 1.16버전은 Ruby 3.1.0 버전이 필요합니다.Homebrew와 rbenv를 사용하여 Ruby 3.1.0을 설치합니다.

1. rbenv 설치

brew install rbenv

2. ruby 3.1.0 설치

rbenv install 3.1.0
rbenv global 3.1.0

3. ruby 버전 확인

ruby -v

환경 변수 설정

루비 버전이 반영되지 않았다면 환경 변수를 설정합니다.
~/.zshrc 파일에 아래 내용을 추가하고 source ~/.zshrc 명령을 입력하여 적용합니다.

eval "$(rbenv init -)"

CocoaPods 설치

CocoaPods는 iOS 프로젝트의 의존성을 관리하는 도구입니다.

CocoaPods 설치

터미널에서 아래 명령을 입력하여 CocoaPods를 설치합니다. 관리자 패스워드를 입력하고, 시간이 조금 지나면 설치가 시작됩니다.

sudo gem install cocoapods

환경 변수 설정

CocoaPods 설치 후, 환경 변수를 추가합니다.
~/.zshrc 파일에 아래 내용을 추가하고 source ~/.zshrc 명령을 입력하여 적용합니다.

export PATH=$HOME/.gem/bin:$PATH

iOS 시뮬레이터 설정

가상 디바이스 다운로드

아래 명령어로 필요한 iOS 플랫폼 파일을 다운로드합니다.

xcodebuild -downloadPlatform iOS

시뮬레이터 실행

터미널에서 아래 명령어로 iOS 시뮬레이터를 실행합니다.

open -a Simulator

시뮬레이터가 정상적으로 실행되면 설치가 완료된 것입니다.

개발 환경 체크

Flutter Doctor 실행

터미널에서 아래 명령을 실행하여 환경 구성이 정상적으로 완료되었는지 확인합니다.

flutter doctor

Running flutter doctor...
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.27.0, on macOS 15.2 24C101 darwin-arm64, locale ko-KR)
[✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
[✓] Xcode - develop for iOS and macOS (Xcode 16.2)
[!] Chrome - develop for the web
[✓] Android Studio (version 2024.2)
[✓] IntelliJ IDEA Ultimate Edition (version 2024.3.1.1)
[✓] Connected device (1 available)
[✓] Network resources

Xcode - develop for iOS and macOS (Xcode 16.2) 항목이 정상적으로 체크되었다면 iOS 앱 개발 환경 설정이 완료된 것입니다.

마치며

Flutter에서 iOS 앱 개발을 시작하기 위해 필요한 환경 설정을 마쳤습니다. 이제 Flutter로 iOS 앱 개발을 시작해보세요.!!

참고 자료