[Mac] ReactNative 설치하기

React Native는 iOS와 Android 앱을 동시에 개발할 수 있는 강력한 프레임워크입니다.

Mac에서 React Native 개발 환경을 설정하는 방법에 대해 알아보겠습니다.

반응형

1. 사전 준비 사항

React Native를 설치하기 전에 다음 사항을 준비해야 합니다:

• Mac 컴퓨터: macOS Ventura 또는 최신 버전을 권장합니다.
• Apple ID: iOS 앱 개발을 위해 필요합니다.
• Xcode: iOS 시뮬레이터 실행에 필요합니다.
• Node.js: JavaScript 런타임.
• Watchman (선택 사항): 파일 변경을 감지해 개발 환경을 빠르게 만듭니다.
• Android Studio (선택 사항): Android 시뮬레이터 실행에 필요합니다.

---

2. Homebrew 설치하기

Homebrew는 macOS에서 소프트웨어를 설치하고 관리하기 위한 패키지 관리 도구입니다. Terminal을 열고 아래 명령어를 입력해 Homebrew를 설치합니다:

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

설치가 완료되면 아래 명령어로 Homebrew가 제대로 설치되었는지 확인하세요:

brew --version

---

3. Node.js 설치하기

React Native는 Node.js를 사용하므로 최신 LTS(Long Term Support) 버전을 설치해야 합니다. Homebrew를 사용해 설치합니다:

brew install node

설치 후, 아래 명령어로 Node.js와 npm(Node Package Manager)의 버전을 확인하세요:

node -v
npm -v

---

4. Watchman 설치하기 (선택 사항)

Watchman은 파일 변경을 감지하여 React Native 개발 속도를 향상시킬 수 있습니다. 다음 명령어로 설치합니다:

brew install watchman

---

5. Xcode 설치 및 설정하기

iOS 앱을 개발하려면 Xcode가 필요합니다. App Store에서 Xcode를 다운로드하여 설치하세요.

설치 후, Xcode를 열고 다음 단계를 따라 설정하세요:

1. Preferences > Locations로 이동합니다.
2. Command Line Tools를 선택합니다.

또한, 아래 명령어를 실행하여 Xcode의 라이센스를 동의하세요:

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch

---

6. Android Studio 설치하기 (Android 개발용)

Android 앱을 개발하려면 Android Studio가 필요합니다.

1. Android Studio 공식 웹사이트에서 다운로드 후 설치합니다.
2. 설치 후, Android Studio를 열고 SDK Manager에서 다음 항목을 설치하세요:
   • Android SDK
   • Android SDK Platform-Tools
   • Android Virtual Device (AVD) Manager

---

7. React Native CLI 설치하기

React Native CLI(Command Line Interface)는 React Native 프로젝트를 생성하고 관리하는 데 사용됩니다. npm을 사용하여 설치합니다:

npm install -g react-native-cli

설치 후, 아래 명령어로 React Native CLI가 제대로 설치되었는지 확인하세요:

react-native --version

---

8. 새로운 React Native 프로젝트 생성하기

다음 명령어를 사용하여 새 프로젝트를 생성합니다:

npx react-native init MyReactNativeApp

MyReactNativeApp은 프로젝트 이름으로 원하는 이름으로 변경할 수 있습니다.

---

9. 프로젝트 실행하기

iOS에서 실행

프로젝트 디렉토리로 이동한 후 아래 명령어를 실행하세요:

cd MyReactNativeApp
npx react-native run-ios

iOS 시뮬레이터가 자동으로 열리고 앱이 실행됩니다.

Android에서 실행

Android Studio에서 가상 장치를 실행한 후 아래 명령어를 실행하세요:

npx react-native run-android

---

10. 설치 문제 해결

설치 중 문제가 발생하면 다음을 확인하세요:

1. React Native 공식 문서: https://reactnative.dev/docs/environment-setup
2. 터미널 오류 메시지 확인: 설치 로그에 오류 원인이 표시됩니다.
3. 의존성 충돌 해결: 최신 버전의 Node.js, Xcode, Android Studio 사용을 권장합니다.

---

이제 React Native 설치가 완료되었습니다! 첫 프로젝트를 실행하고 앱 개발을 시작해보세요. 🚀