Flutter (앱 개발)/Flutter기초

[앱 개발 기초] Mac 개발 환경 설정: Xcode 및 Homebrew 설치 ( 명령프롬프트 첨부 파일 제공)

Ize𓆜 2025. 2. 15. 20:15
728x90
728x90

 

Mac 개발 환경 설정:

Xcode 및 Homebrew 설치 🍏🔧

 

Flutter 개발을 위해서는

Xcode와 Homebrew를

설정하는 것이 필수적입니다.

 

특히 iOS 앱 개발을 위해서는

반드시 Xcode가 필요하며,

Homebrew는

여러 개발 도구를 쉽게 설치하고

관리할 수 있는 관리자 패키지 입니다.

 

이번 포스팅에서는

Mac에서 Xcode 및

Homebrew를 설치하고,

Flutter 개발을 위한

환경을 설정하는 방법

단계별로 설명하겠습니다. 🚀


Ⅰ. 서론: Xcode 및 Homebrew가 필요한 이유 🤔

 

Xcode란? 왜 Flutter 개발에서 필수적인가?

 

Xcode는

Apple에서 제공하는

공식 iOS 개발 도구입니다.


Flutter에서

iOS 앱을 개발하고

시뮬레이터에서 실행하려면

반드시 Xcode가 필요합니다.

Xcode가 필요한 이유

  • iOS 앱을 빌드하고 실행하기 위해 필수
  • iOS 시뮬레이터 실행 가능
  • Swift 및 Objective-C 기반의 네이티브 코드 지원
  • Flutter의 iOS 관련 오류 해결에 필요

➡️ 즉, iOS 앱을 개발하려면 Xcode 설치는 필수!

 


Homebrew란? Mac 개발 환경에서 필요한 이유

 

 

Homebrew는

Mac에서 필수적인

개발 도구를 쉽게 설치하고

관리할 수 있는 패키지입니다.

 

Homebrew가 필요한 이유

  • macOS에서 개발 도구를 쉽게 설치할 수 있음
  • CocoaPods, Git, Node.js 등 다양한 개발 도구 설치 가능
  • 명령어 한 줄로 최신 버전 유지 및 업데이트 가능

 

이제 본격적으로

Mac에서 Xcode 및

Homebrew를 설치하는 방법

알아보겠습니다! 🚀

 


Ⅱ. 본론: Mac에서 Xcode 및 Homebrew 설치 및 설정 🔧

 

Step 1: Homebrew 설치 및 환경 확인

 

1) Homebrew 설치

Homebrew는 터미널에서 다음 명령어 한 줄로 쉽게 설치할 수 있습니다

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

curl -fsSL.txt
0.00MB

 

설치 과정에서

"Press RETURN to continue"

메시지가 나오면

Enter 키를 눌러 계속 진행하세요.

 


 

2) Homebrew 설치 확인

 

설치가 완료되면,

다음 명령어로

정상적으로 설치되었는지 확인합니다.

brew --version

Homebrew 버전이 출력되면 설치 성공! 🎉

 


 

3) Homebrew 환경 변수 설정 (필요한 경우)

 

일부 Mac에서는

Homebrew가 자동으로

환경 변수에 추가되지 않을 수 있습니다.


이 경우

아래 명령어를 실행하여 .

zshrc 또는 .bash_profile에

환경 변수를 추가하세요.

 

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

echo.txt
0.00MB

 

Homebrew 설정 완료 후, 아래 명령어로 패키지를 최신 상태로 업데이트하세요.

brew update && brew upgrade

 

 


Step 2: Xcode 설치 및 필수 도구 설정

 

 

1) Xcode 설치 (Mac App Store 이용)

 

Xcode는

Mac App Store에서

쉽게 다운로드할 수 있습니다.

 

  1. Mac App Store 실행
  2. 검색창에 "Xcode" 입력 후 다운로드 및 설치
  3. 설치 후 Xcode 실행하여 필수 구성 요소 설치 진행

설치 완료 후, 아래 명령어로 버전 확인

xcode-select --version

정상적으로 버전이 출력되면 Xcode가 제대로 설치된 것입니다! 🎉

 

2) Xcode 명령어 도구 (Command Line Tools) 설치

 

터미널에서

다음 명령어를 실행하여

Xcode 명령어 도구를 설치합니다.

xcode-select --install

 

설치 완료 후,

다음 명령어로 정상적으로

설정되었는지 확인하세요.

 

xcode-select -p

 

 

출력 값이

/Applications/Xcode.app/Contents/Developer라면

정상적으로 설정된 것입니다!

 

 


Step 3: CocoaPods 설치 (iOS 빌드에 필요)

 

CocoaPods는

 iOS 앱에서

 네이티브 라이브러리를

 관리하는 도구입니다.


Flutter 프로젝트에서

 iOS 관련 패키지를 설치할 때 

필수적으로 사용됩니다.

 

 

1) CocoaPods 설치

터미널에서 다음 명령어 실행

brew install cocoapods

 

2) CocoaPods 설치 확인

설치 완료 후 버전 확인

pod --version

 

정상적으로 버전이 출력되면 CocoaPods 설치 완료! 🎉

 


Step 4: Flutter Doctor로 환경 확인

 

Flutter가 Xcode 및 Homebrew를 정상적으로 인식하는지 확인하려면 다음 명령어 실행

flutter doctor

➡ 실행하면 설치된 구성 요소를 검사하고, 누락된 항목을 표시합니다.

만약 "X" 표시가 있다면?

  • "iOS toolchain is missing" 오류 발생 시
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch

sudo xcode-select.txt
0.00MB

 

  • "CocoaPods not installed" 오류 발생 시
brew install cocoapods

 

 

✅ Flutter Doctor 결과에 

모두 "✓"가 표시되면, 

환경 설정이 정상적으로 

완료된 것입니다! 🎉

 

 

 


Ⅲ. 결론: Xcode 및 Homebrew 설치 후 해야 할 일

 

추가 Flutter 개발 환경 설정

 

✅ xcode-select --version 명령어로 Xcode 설정 확인
✅ brew --version 명령어로 Homebrew 설치 확인
✅ pod --version 명령어로 CocoaPods 설치 확인
✅ flutter doctor 실행하여 개발 환경 점검


iOS 앱 실행을 위한 추가 설정

 

✅ 실제 iOS 기기에서 Flutter 앱을 실행하려면 Apple 개발자 계정 등록 필요
✅ flutter run 실행 후 iOS 시뮬레이터에서 앱 실행 확인


🎯 마무리: Xcode 및 Homebrew 설치 완료! 🎉

 

이제 Mac에서

Xcode 및 Homebrew를 활용한

Flutter 개발 환경이 완성되었습니다!

 

Homebrew 설치 완료
Xcode 설치 및 설정 완료
CocoaPods 설치 완료
Flutter Doctor 실행하여 환경 점검 완료

 

더 궁금한 점이 있다면

댓글로 언제든 질문해 주세요! 🎯

728x90
728x90