본문 바로가기
React Naitve/실습

[RN] React Native 앱을 Android에 설치하기 — assembleRelease 빌드부터 실제 기기 설치

by Angry Stock 2025. 3. 31.
반응형

🔧 1단계: Release APK 빌드하기

터미널에서 아래 명령어를 실행합니다:

cd android
./gradlew assembleRelease

📂 생성된 파일 위치:

android/app/build/outputs/apk/release/app-release.apk


⚠️ 빌드 전에 release 키가 설정되어 있어야 합니다. (android/gradle.properties, signingConfigs 등)


📲 2단계: 안드로이드 기기 준비

  1. USB 디버깅 활성화
    • 설정 > 휴대전화 정보 > 빌드 번호 연속 탭 → 개발자 모드 ON
    • 설정 > 개발자 옵션 > USB 디버깅 ON
  2. 알 수 없는 앱 설치 허용
    • 설정 > 보안 > 알 수 없는 출처 또는
    • 설정 > 앱 > 파일 관리자 > 알 수 없는 앱 설치 허용

🛠️ 3단계: ADB로 APK 설치하기

📌 기기 연결 확인

adb devices


기기가 목록에 보이면 준비 완료!

📦 APK 설치

adb install android/app/build/outputs/apk/release/app-release.apk

 

or

adb install ./app/build/outputs/apk/release/app-release.apk

✅ 성공 메시지: Success


❌ 실패 시: 기존 앱이 설치되어 있다면 먼저 삭제

adb uninstall com.yourpackagename

📁 4단계: APK를 파일로 옮겨 수동 설치 (선택)

APK 파일을 메신저, 이메일, USB 등으로 폰에 전송한 뒤:

  1. 파일을 클릭해서 설치
  2. 설치 차단 시, 알 수 없는 앱 설치 허용 설정으로 이동
  3. 설치 완료 후 앱 실행

5단계: ADB Logcat으로 React Native 로그 보기

✅ 로그 보기 명령어

 
adb logcat *:S ReactNative:V ReactNativeJS:V

 

*:S 모든 로그는 숨기고
ReactNative:V React Native 네이티브 로그 보기
ReactNativeJS:V JavaScript console.log 보기

🧩 자주 발생하는 문제

문제해결 방법

 

INSTALL_FAILED_VERSION_DOWNGRADE 기존 앱 삭제 후 재설치
adb: command not found Android SDK 설치 및 환경 변수 설정
설치는 되지만 앱 실행 안 됨 MainActivity, 패키지명 등 확인
반응형

댓글