갓난애기도 배울 수 있는 React Native 가이드 ⑦ – 앱 완성 후 빌드 및 배포 전략 (Android & iOS)

갓난애기도 배울 수 있는 React Native 가이드 ⑦ – 앱 완성 후 빌드 및 배포 전략 (Android & iOS)

이제 앱은 완성됐습니다! 🎉
다음 단계는 빌드(Build) 와 배포(Distribute) 입니다.
이 글에서는 React Native CLI 방식으로 만든 앱을 Android와 iOS에서 빌드하고 테스트하는 방법,
그리고 APK/IPA 파일을 만들어 실제 기기나 앱스토어에 배포하는 흐름을 차근차근 정리해드릴게요.

---

✅ 1. React Native 앱 빌드 기본 개념

플랫폼 출력물 설명

Android	.apk, .aab	Android 설치 파일 / Play Store 제출용
iOS	.ipa	iPhone 설치 파일 / App Store 제출용

React Native CLI에서는 직접 네이티브 빌드 도구(Gradle, Xcode)를 사용합니다.

---

✅ 2. Android 앱 빌드 (Windows, mac 공통)

📦 release APK 빌드 준비

1. android/app/gradle.properties 에 아래 추가:

MYAPP_RELEASE_STORE_FILE=my-release-key.keystore
MYAPP_RELEASE_KEY_ALIAS=my-key-alias
MYAPP_RELEASE_STORE_PASSWORD=*****
MYAPP_RELEASE_KEY_PASSWORD=*****

1. android/app/build.gradle 수정:

signingConfigs {
    release {
        storeFile file(MYAPP_RELEASE_STORE_FILE)
        storePassword MYAPP_RELEASE_STORE_PASSWORD
        keyAlias MYAPP_RELEASE_KEY_ALIAS
        keyPassword MYAPP_RELEASE_KEY_PASSWORD
    }
}

1. 릴리즈 빌드 실행:

cd android
./gradlew assembleRelease

빌드 성공 시: android/app/build/outputs/apk/release/app-release.apk 생성 🎉

---

✅ 빌드된 APK 테스트 방법

1. 안드로이드 기기를 USB로 연결
2. 디버깅 허용 → APK 전송

adb install app-release.apk

또는 QR 코드로 파일 전송 서비스 사용 (Google Drive, 공유 링크 등)

---

✅ 3. iOS 앱 빌드 (macOS only)

📦 사전 준비

• Xcode 설치 (App Store)
• CocoaPods 설치:

sudo gem install cocoapods
cd ios && pod install && cd ..

✅ 시뮬레이터 실행

npx react-native run-ios

✅ 실제 기기 빌드 (IPA 만들기)

1. ios/Runner.xcworkspace 파일을 Xcode로 열기
2. Apple Developer 계정 로그인
3. 빌드 대상: 실제 iPhone 선택
4. 상단 ▶︎ 버튼으로 실행 or Product > Archive 메뉴에서 아카이브 생성
5. Export → .ipa 파일 만들기 → TestFlight or 직접 설치

---

✅ 4. Play Store & App Store 배포 흐름 요약

항목 Android iOS

스토어	Google Play Console	App Store Connect
파일	.aab (권장) / .apk	.ipa
제출 방식	콘솔 업로드 후 심사	Xcode → Archive → Upload
심사 시간	빠르면 수 시간	평균 1~3일 소요

이 글에서는 기기 테스트까지, 배포는 추후 상세 가이드에서 다룹니다.

---

✅ 5. 오류 발생 시 대처법

증상 원인 해결법

Keystore not found	서명 파일 없음	keytool로 키 생성 후 설정
No devices found	에뮬레이터/기기 인식 안 됨	USB 디버깅 / 에뮬레이터 확인
iOS 빌드 실패	Signing 문제	Apple 계정 로그인, 프로비저닝 설정 확인
CocoaPods 오류	환경 문제	pod repo update, arch -x86_64 pod install 시도

---

✅ 6. 이번 글에서 배운 것

• Android 앱의 .apk 빌드 및 테스트 방법
• iOS 앱의 시뮬레이터 실행 및 Xcode 빌드 흐름
• 실제 기기에 설치하기 위한 설정 흐름
• 앱 배포를 위한 스토어 준비 요약

---

📘 다음 글 예고

갓난애기도 배울 수 있는 React Native 가이드 ⏹️ 마무리 편 – 실전 앱 만들며 복습하기 (To-Do 앱 확장 프로젝트)

지금까지 배운 것들을 종합하여
기능 완성도 높은 To-Do 앱을 함께 만들어보며 마무리합니다!
삭제, 완료 체크, 저장까지 전부 넣어봅니다 ✅

---

 

React Native 빌드 방법,React Native APK 만들기,React Native iOS 빌드,Xcode 앱 배포,React Native 앱 출시 준비,React Native 배포 CLI,Android AAB 파일 생성,React Native run-ios 오류,React Native 빌드 오류 해결,React Native 앱 스토어 배포

---