[개발 환경 설정] React Native (Expo) 앱 `.apk` 파일 외부 공유 및 설치 가이드

📱

React Native(Expo 기반)로 만든 앱을 포트폴리오용으로 외부에서 설치 가능한 .apk 파일로 빌드하고 공유해 설치까지 완료한 전체 과정을 정리합니다.

✅ 전제 조건

• Expo 기반 프로젝트
• EAS CLI 설치됨 → yarn global add eas-cli 또는 npm install -g eas-cli
• Expo 계정 로그인 완료 → eas login
• eas.json, app.json 설정 완료 (android.package, privacy: public, 등)

---

1. EAS Android 빌드 실행

eas build --platform android --profile preview
# 또는
yarn eas build --platform android --profile preview
# 또는
npx eas-cli build --platform android --profile preview

# 내부 테스트 목적 (디버깅용 빌드)
eas build --platform android --profile development

• .apk 파일을 생성하려면 preview 또는 development 프로필을 사용

• 내부 테스트용으로는 development나 internal 프로필을 지정(배포)

• 빌드 설정은 eas.json의 profile 값에서 지정(예: preview, development, production 등)

---

⬆️ eas build와 eas update 사용 시점 구분

사용 상황	명령어	설명
✅ 앱을 처음 배포할 때	eas build --platform android --profile preview	.apk 또는 .aab 파일을 생성하여 설치 가능한 앱 배포용으로 사용
🔁 기존 앱에 텍스트, UI만 수정 시	eas update --branch preview	앱을 다시 설치하지 않고, 설치된 앱에 빠르게 변경 내용을 반영할 때 사용

⚡️ eas update는 eas build로 앱을 설치한 이후, 변경점이 적은 UI/텍스트만 빠르게 반영할 수 있는 방식입니다. eas update만으로는 새로운 앱 설치는 불가능합니다.

📌 추가 정리:

• 처음 배포 = eas build --platform android --profile preview
• 텍스트, 스타일 등 간단 변경만 반영 = eas update --branch preview
• ☝️ 한 번도 eas build로 설치하지 않은 사람에게는 eas update는 아무런 효과가 없습니다. 설치된 앱이 있어야만 동작합니다!

---

2. 빌드 완료 후 공유 링크 확인

빌드가 완료되면 다음과 같은 메시지가 출력됩니다:

🤖 Open this link on your Android devices (or scan the QR code) to install the app:
https://expo.dev/accounts/your-account/projects/your-app/builds/xxxxxxx

• 위 링크를 카카오톡, 이메일, 메신저 등으로 외부에 공유하면 상대방이 .apk를 다운로드 가능

---

3. 외부 기기에서 설치 방법

📥 .apk 링크 클릭 후

• .apk 파일 다운로드 → "설치할 프로그램 선택" 팝업이 뜸
• 아래 중 하나 선택:
  • 패키지 설치 프로그램
  • 패키지 인스톨러
  • 앱 설치 관리자

🔐 설치가 막힐 경우 설정 열기

• 설정 > 앱 > 특별한 접근 > 알 수 없는 앱 설치
  • 예: '카카오톡' 또는 '파일' 앱 선택
  • 👉 이 출처 허용 켜기

📂 다운로드 위치

• 내 파일 > 다운로드 또는
  내 파일 > 내부 저장소 > Download 폴더에서 .apk 확인 가능

---

4. 앱 설치 및 실행

• 설치 완료 후, 앱 아이콘이 홈 화면 또는 앱 서랍에 생성됨
• 정상적으로 React Native 앱이 실행되는지 확인

---

🔁 요약 정리

단계	설명
1️⃣	.apk 빌드 명령어 실행 (eas build)
2️⃣	빌드 완료 후 공유 가능한 링크 제공
3️⃣	링크 전달 → 상대방은 .apk 다운로드
4️⃣	권한 허용 후 설치 진행
5️⃣	앱 실행 확인

---

📌 주의

• .apk는 안드로이드 기기에서만 설치 가능하며, 보안 설정에 따라 설치가 차단될 수 있습니다.
• iOS 기기는 .ipa 설치가 복잡하여 일반 포트폴리오 공유에는 적합하지 않습니다.
• .apk 공유는 개발·테스트 및 포트폴리오 용도로 활용하세요.

📮 이 정보는 GPT 기반으로 정리되었습니다.