1️⃣ 프로젝트 폴더 이동
cd 프로젝트폴더
2️⃣ 의존성 설치
npm install
🤖 Android 실행
npx react-native run-android
이 명령어가 React Native CLI 프로젝트 실행 명령어입니다.
동작 과정은 대략 이렇습니다.
Gradle 빌드
APK 생성
에뮬레이터 또는 연결된 기기에 설치
앱 실행
🍎 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
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만 사용합니다.