리액트 네이티브 Expo vs CLI로 프로젝트 실행하기

개발 오답 노트·2026년 3월 12일

React Native

목록 보기
1/1

React Native CLI 프로젝트 실행 방법

1️⃣ 프로젝트 폴더 이동
cd 프로젝트폴더
2️⃣ 의존성 설치
npm install
🤖 Android 실행
npx react-native run-android

이 명령어가 React Native CLI 프로젝트 실행 명령어입니다.

동작 과정은 대략 이렇습니다.

  1. Gradle 빌드

  2. APK 생성

  3. 에뮬레이터 또는 연결된 기기에 설치

  4. 앱 실행

🍎 iOS 실행 (Mac만 가능)
npx react-native run-ios
📌 Expo vs React Native CLI 실행 명령어 차이
종류 실행 명령어

Expo npx expo start
Expo (native build) npx expo run:android
React Native CLI npx react-native run-android

🔎 프로젝트가 Expo인지 CLI인지 확인하는 방법
Expo 프로젝트 특징

app.json
expo

package.json

"dependencies": {
  "expo": "~50.0.0"
}

React Native CLI 특징

폴더 구조

android/
ios/

package.json

"dependencies": {
  "react-native": "0.73.x"
}

💡 추가로 하나 알려드리면 (중요)
실무에서 git clone 받은 프로젝트 실행할 때 90%는 아래 순서입니다.

git clone <repo>
cd project
npm install
npx react-native run-android

React Native CLI 기기 연결 이후 시작하는 법

1️⃣ npx react-native run-android (일반적으로 사용하는 것)
npx react-native run-android

이 명령어는 내부적으로 다음을 자동으로 다 합니다.

Metro bundler 실행 (JS 서버)

Android 앱 빌드 (Gradle)

연결된 기기 또는 에뮬레이터에 APK 설치

앱 실행

👉 그래서 실제 기기를 USB로 연결했다면 보통 이거 하나만 실행하면 끝입니다.

2️⃣ npx react-native start
npx react-native start

이건 Metro Bundler(React Native JS 서버) 만 실행합니다.

역할

JS 코드 번들링

Hot reload

앱에서 JS 가져오는 서버

즉 앱을 설치하거나 실행하지는 않습니다.

3️⃣ 실제 개발할 때 많이 쓰는 방식
처음 실행할 때
npx react-native run-android
이후 Metro만 따로 실행할 때
npx react-native start

그리고 Android Studio나 이미 설치된 앱에서 실행.

📱 실제 기기 연결 후 권장 순서

1️⃣ 기기 연결 확인

adb devices

기기가 나오면 OK

List of devices attached
R3CT12345 device

2️⃣ 앱 실행

npx react-native run-android

💡 React Native 처음 공부할 때 가장 헷갈리는 핵심

명령어 역할
npx react-native start JS 서버만 실행
npx react-native run-android 빌드 + 설치 + 실행

👉 그래서 보통은 run-android만 사용합니다.

profile
포토폴리오 https://wikidocs.net/book/10969 유튜브 링크 https://www.youtube.com/@%EC%B5%9C%EC%9B%90%EC%9D%BC-n5r

0개의 댓글