기본 콘텐츠로 건너뛰기

React Native | 맥(Mac) 개발환경 세팅

⚙️ React Native 맥(Mac) 개발환경 세팅 가이드


macOS에서 React Native 개발환경을 구축하기 위한 전체 과정입니다. 하이브리드 앱 개발을 준비하며 반드시 설치해야 하는 필수 도구들을 단계별로 정리했습니다.

(최종 업데이트: 2025년 11월 19일)


🚀 1. Homebrew 설치

Homebrew는 macOS에서 필요한 패키지를 설치하고 관리하기 위한 필수 도구입니다.
공식 사이트: https://brew.sh/

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

🟩 2. Node.js 설치

React Native 실행을 위한 JavaScript 런타임입니다.
다운로드: https://nodejs.org/ko/

$ brew install node
$ node -v
$ npm -v

👀 3. Watchman 설치

파일 변경을 감지해 Metro Bundler가 자동으로 리빌드할 수 있도록 도와주는 툴입니다.
링크: https://facebook.github.io/watchman/

$ brew install watchman
$ watchman -v

📦 4. React Native CLI 설치

React Native 프로젝트 생성 및 관리에 필요한 CLI(명령어 도구)입니다.
GitHub: React Native CLI

$ npm install -g react-native-cli
$ react-native -v

💻 5. Xcode 설치

iOS 앱 개발 및 시뮬레이터 실행을 위해 Xcode가 필요합니다.

[Xcode → Preferences → Locations] 메뉴에서 Command Line Tools가 설정되어 있는지 반드시 확인하세요.

📚 6. Cocoapods 설치

iOS 프로젝트 라이브러리 의존성을 관리하는 필수 도구입니다.
공식 사이트: https://cocoapods.org/

$ sudo gem install cocoapods
$ pod --version

☕ 7. JDK 설치 (Android 개발용)

Android 빌드를 위해 JDK(Java Development Kit)가 필요합니다.
다운로드: https://adoptopenjdk.net/

$ brew tap AdoptOpenJDK/openjdk
$ brew install --cask adoptopenjdk8
$ java -version

🤖 8. Android Studio 설치

Android SDK, 에뮬레이터, Gradle 환경을 모두 포함하고 있습니다.
다운로드: https://developer.android.com/studio


🛠️ 9. Android 환경변수 설정

~/.zshrc 또는 ~/.bash_profile 파일에 다음 내용을 추가합니다.

export ANDROID_HOME=[Android SDK 경로]/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 ~/.bash_profile
$ source ~/.zshrc

📱 10. React Native 프로젝트 생성

$ npx react-native init MyApp
$ cd MyApp
iOS 실행: npx react-native run-ios
Android 실행: npx react-native run-android

여기까지 완료하면 macOS에서 React Native 개발환경이 완벽하게 구성된 상태입니다.


썸네일
React Native | 이미지에서 얼굴인식(Face Detection) 하기
Face Detection, Face Recognition

댓글