맥북프로에서 React Native 개발환경 완벽 설정 가이드 (2025년 최신)

맥북프로에서 React Native 개발을 시작하려는 개발자를 위한 2025년 최신 설정 가이드입니다. Apple Silicon (M1/M2/M3)과 Intel 기반 맥 모두를 지원하며, iOS와 Android 앱을 개발할 수 있는 완전한 환경을 구축합니다.

시작하기 전에

시스템 요구사항

macOS: 최신 버전 권장 (macOS 13 Ventura 이상)
저장 공간: 최소 50GB 이상 (Xcode 및 Android Studio 포함)
메모리: 8GB 이상 (16GB 권장)
프로세서: Apple Silicon (M1/M2/M3) 또는 Intel 기반

Expo CLI vs React Native CLI: 어떤 것을 선택할까?

React Native 프로젝트를 시작할 때 가장 먼저 결정해야 할 것은 Expo CLI와 React Native CLI 중 무엇을 사용할지입니다.

Expo CLI (2025년 권장)

장점:

🚀 빠른 시작: 복잡한 네이티브 설정 없이 즉시 개발 시작
☁️ 클라우드 빌드: Mac 없이도 iOS 앱 빌드 가능 (EAS Build)
🔄 OTA 업데이트: 앱스토어 없이 즉시 업데이트 배포
📱 Expo Go: 실제 디바이스에서 QR 코드로 즉시 테스트
🛠️ 풍부한 SDK: 카메라, 위치, 알림 등 사전 구성된 모듈

단점:

일부 네이티브 모듈 제한 (하지만 2025년 현재 대부분 지원)
앱 크기가 약간 더 큼

React Native CLI

장점:

🎯 완전한 제어: 모든 네이티브 코드 접근 가능
📦 커스텀 네이티브 모듈: 모든 서드파티 라이브러리 사용 가능
🔧 세밀한 최적화: 네이티브 레벨 성능 튜닝

단점:

복잡한 초기 설정 (Xcode, Android Studio 필수)
iOS 빌드를 위해 Mac 필수
네이티브 지식 필요

2025년 공식 권장사항: React Native 공식 팀은 기본적으로 Expo CLI 사용을 권장합니다. 특별한 네이티브 커스터마이징이 필요하지 않다면 Expo로 시작하세요.

1단계: 필수 도구 설치

1.1 Homebrew 설치

Homebrew는 macOS의 패키지 관리자로, 개발 도구를 쉽게 설치하고 관리할 수 있게 해줍니다.

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

# 설치 확인
brew --version

1.2 Node.js 설치

React Native는 Node.js가 필요합니다. Homebrew를 통해 설치하는 것이 가장 간단합니다.

# Node.js 설치 (LTS 버전)
brew install node

# 버전 확인
node --version  # v20.x.x 이상 권장
npm --version

대안: nvm 사용 (여러 Node.js 버전 관리가 필요한 경우)

# nvm 설치
brew install nvm

# nvm 환경 설정 (~/.zshrc에 추가)
export NVM_DIR="$HOME/.nvm"
[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && . "/opt/homebrew/opt/nvm/nvm.sh"

# 쉘 재시작 후
nvm install --lts
nvm use --lts

1.3 Watchman 설치

Watchman은 파일 시스템 변경을 감지하는 Facebook의 도구로, 소스 코드 변경 시 자동으로 리빌드를 트리거합니다.

# Watchman 설치
brew install watchman

# 버전 확인
watchman --version

2단계: iOS 개발 환경 설정

2.1 Xcode 설치

iOS 앱을 개발하려면 Xcode가 필수입니다.

App Store에서 Xcode 설치 (약 10-15GB, 시간이 오래 걸립니다)
Xcode를 한 번 실행하여 추가 컴포넌트 설치 완료
Command Line Tools 설정 확인:

# Xcode 선택
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer

# 설치 확인
xcode-select -p

Xcode Preferences 설정:

Xcode > Settings > Locations > Command Line Tools에서 현재 Xcode 버전 선택

2.2 CocoaPods 설치

CocoaPods는 iOS 프로젝트의 의존성 관리자입니다. React Native iOS 프로젝트에 필수적입니다.

Apple Silicon (M1/M2/M3) 사용자:

# Homebrew로 CocoaPods 설치 (ARM 네이티브 버전)
brew install cocoapods

# 버전 확인
pod --version

Intel Mac 사용자:

# Ruby gem으로 설치
sudo gem install cocoapods

# 버전 확인
pod --version

CocoaPods 초기 설정:

# CocoaPods 저장소 설정
pod setup

3단계: Android 개발 환경 설정 (선택사항)

Android 앱도 개발하려면 다음 도구가 필요합니다.

3.1 Java Development Kit (JDK) 설치

# Azul Zulu JDK 설치 (React Native 권장)
brew install --cask zulu@17

# 버전 확인
java -version

3.2 Android Studio 설치

Android Studio 공식 사이트에서 다운로드
Android Studio 실행 후 초기 설정:
- Android SDK
- Android SDK Platform
- Android Virtual Device

3.3 환경 변수 설정

~/.zshrc 또는 ~/.zprofile 파일에 다음 추가:

# Android 환경 변수
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools

설정 적용:

source ~/.zshrc

4단계: React Native 프로젝트 생성

옵션 A: Expo CLI로 시작 (권장)

# Expo CLI로 새 프로젝트 생성
npx create-expo-app MyAwesomeApp

# 프로젝트 디렉토리로 이동
cd MyAwesomeApp

# 개발 서버 시작
npx expo start

Expo Go 앱으로 테스트:

모바일 디바이스에 Expo Go 앱 설치:
- iOS: App Store에서 다운로드
- Android: Google Play에서 다운로드
QR 코드 스캔하여 앱 실행

옵션 B: React Native CLI로 시작

# 전역 CLI가 설치되어 있다면 제거 (충돌 방지)
npm uninstall -g react-native-cli

# 새 프로젝트 생성
npx @react-native-community/cli@latest init MyAwesomeApp

# 프로젝트 디렉토리로 이동
cd MyAwesomeApp

# iOS 의존성 설치
cd ios && pod install && cd ..

# iOS 시뮬레이터에서 실행
npx react-native run-ios

# Android 에뮬레이터에서 실행 (Android Studio에서 에뮬레이터 실행 후)
npx react-native run-android

5단계: 환경 검증

React Native Doctor 사용

개발 환경이 올바르게 설정되었는지 확인:

npx @react-native-community/cli doctor

이 명령어는 누락된 도구나 설정 문제를 자동으로 감지하고 해결 방법을 제시합니다.

수동 확인 체크리스트

# Node.js 확인
node --version  # ✅ v18.x.x 이상

# npm 확인
npm --version   # ✅ 9.x.x 이상

# Watchman 확인
watchman --version  # ✅ 설치 확인

# Xcode 확인
xcodebuild -version  # ✅ Xcode 14.x 이상

# CocoaPods 확인
pod --version  # ✅ 1.12.x 이상

# Java 확인 (Android 개발 시)
java -version  # ✅ JDK 17

# Android SDK 확인 (Android 개발 시)
echo $ANDROID_HOME  # ✅ 경로 출력 확인

문제 해결 (Troubleshooting)

일반적인 이슈

1. CocoaPods 설치 오류 (Apple Silicon)

# Rosetta를 사용하지 않고 네이티브 ARM 버전 설치
arch -arm64 brew install cocoapods

2. “Command not found: pod”

# PATH에 CocoaPods 추가
export PATH=$PATH:/opt/homebrew/bin

# 또는 gem으로 재설치
sudo gem install cocoapods

3. Xcode Command Line Tools 오류

# Command Line Tools 재설치
sudo rm -rf /Library/Developer/CommandLineTools
xcode-select --install

4. Watchman 버전 경고

# Watchman 업데이트
brew upgrade watchman

# 캐시 삭제
watchman watch-del-all

5. “Unable to boot simulator” (iOS)

# 시뮬레이터 재설정
xcrun simctl erase all

# Xcode 재시작

6. Android Emulator 느린 실행

Android Studio > AVD Manager에서 하드웨어 가속 확인
Apple Silicon Mac: ARM64 시스템 이미지 사용
RAM 할당 늘리기 (최소 4GB)

추가 유용한 도구

VS Code 확장 프로그램

# React Native Tools
# ES7+ React/Redux/React-Native snippets
# Prettier - Code formatter
# ESLint

개발 도구

# React Native Debugger
brew install --cask react-native-debugger

# Flipper (디버깅 도구)
brew install --cask flipper

다음 단계

이제 React Native 개발 환경이 완벽하게 설정되었습니다! 다음과 같은 주제를 학습해보세요:

React Native 기초: Components, Props, State
네비게이션: React Navigation 사용법
상태 관리: Redux, Zustand, Context API
네이티브 모듈: 카메라, 위치, 알림 등
성능 최적화: 렌더링 최적화, 메모리 관리
배포: App Store와 Google Play 출시 준비

마무리

2025년 현재 React Native는 성숙한 크로스 플랫폼 프레임워크로, 특히 Expo의 발전으로 진입 장벽이 크게 낮아졌습니다. 이 가이드를 따라 환경을 설정했다면, 이제 iOS와 Android 앱을 동시에 개발할 수 있는 강력한 도구를 갖춘 것입니다.

팁: 처음 시작한다면 Expo로 시작해서 React Native의 기본을 익힌 후, 필요에 따라 Bare Workflow로 전환하거나 React Native CLI로 이동하는 것을 추천합니다.

즐거운 앱 개발 되세요! 🚀