React Native 환경 세팅 가이드 (Windows & macOS)

 

React Native 앱을 개발하기 위해서는 Node, Java Development Kit(JDK), Android Studio(안드로이드) 그리고 macOS 사용자의 경우 Xcode(iOS)가 필요합니다. 본인의 OS에 맞춰 아래 단계를 따라해 보세요.

---

1. OS별 필수 도구 설치

구분	Windows (Android 개발 전용)	macOS (iOS/Android 동시 개발)
패키지 관리자	Chocolatey 설치 권장	Homebrew 설치 권장
Node & JDK	choco install -y nodejs-lts microsoft-openjdk17	brew install node watchman brew install --cask zulu17

---

2. Android 개발 환경 설정 (공통)

안드로이드 앱 빌드를 위해 Android Studio 설정이 필요합니다.

1. Android Studio를 설치합니다.
2. SDK Manager에서 다음 항목을 체크하여 설치합니다.
3. 환경 변수 설정:

💻 Windows (시스템 속성 > 환경 변수)

• ANDROID_HOME: %LOCALAPPDATA%\Android\Sdk 신규 추가
• Path 변수에 %LOCALAPPDATA%\Android\Sdk\platform-tools 추가

🍎 macOS (Terminal)

# ~/.zshrc (또는 ~/.bash_profile) 편집
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools

# 설정 반영
source ~/.zshrc

 

3. iOS 개발 환경 설정 (macOS 전용)

1. Xcode 설치: App Store에서 최신 버전을 설치합니다.
2. CocoaPods 설치: iOS 라이브러리 관리 도구입니다.

sudo gem install cocoapods

---

4. 프로젝트 생성 및 실행 (CLI 명령어)

이제 본격적으로 앱을 만들고 실행해 볼 차례입니다.

🏗️ 프로젝트 생성

npx react-native@latest init MyFirstApp

▶️ 앱 실행하기

[Windows / Android]

cd MyFirstApp
npx react-native run-android

[macOS / iOS]

cd MyFirstApp/ios
pod install
cd ..
npx react-native run-ios

 

---

💡 팁: 환경 설정이 잘 되었는지 확인하려면?

터미널에서 아래 명령어를 입력하면 누락된 설정을 한눈에 파악할 수 있습니다.

 

npx react-native doctor