[개발 환경 설정] React Native 앱을 .apk 파일로 빌드하여 공유하는 방법 (EAS Build) (2편)

헤이안나·2025년 5월 15일
0

Expo Go로 간단하게 앱을 체험하게 하는 것도 좋지만,
직접 설치 가능한 .apk 파일(Android) 을 제공하면 훨씬 직관적인 포트폴리오 경험을 줄 수 있습니다.
이를 위해 Expo의 EAS Build 기능을 사용합니다.


✅ 1. 필수 패키지 설치

npm install -g eas-cli
# 또는
yarn global add eas-cli

📌 eas-cli는 Expo 앱을 빌드하기 위한 전용 CLI입니다.


✅ 2. 프로젝트에 EAS 설정 추가

npx eas init
  • eas.json 파일이 생성됨
  • 기본 설정이면 수정 없이 사용 가능

✅ 3. expo-dev-client 설치 (필수)

EAS 빌드를 사용하려면 expo-dev-client가 필요합니다.

npx expo install expo-dev-client

✅ 4. Android .apk 파일 빌드 실행

npx eas build --platform android
  • 실행 후 Expo가 원격으로 빌드를 수행합니다
  • 완료되면 .apk 다운로드 링크가 생성됩니다
    예:
    ✔ Build complete!
    🔗 Download APK: https://expo.dev/artifacts/abcdefghij.apk

📎 포트폴리오에 넣을 예시 문구

📱 React Native 프로젝트 - Threads Clone

- 📦 설치용 APK 다운로드  
  [Download APK](https://expo.dev/artifacts/abcdefghij.apk)

- 📱 실행 방법  
  1) Android 기기에서 위 APK 파일을 다운로드  
  2) 설치 허용 후 앱 실행!

⚠️ 참고사항

  • Android 디바이스에서 APK 설치를 허용하려면
    ⚙️ 설정 > 보안 > "출처를 알 수 없는 앱 설치 허용" 옵션을 켜야 할 수 있습니다.
  • iOS는 .apk 설치가 불가능하며, App Store 배포나 TestFlight가 필요합니다. (별도 절차)

📝 정리 요약

단계설명
1단계eas-cli 설치 (npm install -g eas-cli)
2단계npx eas init 으로 설정 파일 생성
3단계expo-dev-client 설치
4단계npx eas build --platform android.apk 빌드
보너스포트폴리오에 APK 다운로드 링크 추가

👉 이어서 보세요: Expo Go로 포트폴리오 앱 공유하는 방법 (1편)

profile
리액트 공부하는 사람

0개의 댓글