[개발 환경 설정]`expo-dev-client` 삭제 및 다시 추가하는 방법 (`eas.json` 설정 포함)

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

Expo Go에서 앱을 실행하기 위해 expo-dev-client를 삭제하고,
추후 다시 사용할 경우를 대비한 설정 방법까지 함께 정리했습니다.


✅ 1. expo-dev-client 삭제 (Expo Go 실행 목적)

yarn remove expo-dev-client

📌 expo-dev-client는 커스텀 네이티브 모듈을 사용할 수 있는 개발 클라이언트입니다.
하지만 이 패키지가 설치되어 있고 eas.jsondevelopmentClient: true가 설정되어 있으면,
해당 앱은 Expo Go에서 실행되지 않습니다.
(→ Expo Go는 커스텀 빌드된 네이티브 코드를 실행할 수 없기 때문입니다)

👉 따라서 Expo Go로 테스트하려는 경우, expo-dev-client는 제거해야 합니다.


✅ 2. eas.json 설정 정리(회고 내용 - 건너 뛰기)

developmentClient 옵션을 false로 변경하거나 삭제합니다.
(→ 초기 세팅 기준으로는 developmentClient 항목이 아예 없습니다. 초기 세팅 후 착각해서 preview에 잘 못 넣은거 기존 초기세팅(Git) 보면은 없음.)

✅ 초기 설정 예시 (Expo Go 사용 가능 상태 = 기존 초기 세팅):

```jsonc
{
  "cli": {
    "version": ">= 16.6.1",
    "appVersionSource": "remote"
  },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal"
    },
    "preview": {
      "distribution": "internal"
    },
    "production": {
      "autoIncrement": true
    }
  },
  "submit": {
    "production": {}
  }
}

✅ 3. 추후 다시 사용하고 싶다면?(회고 내용 - 건너 뛰기)

필요할 때는 expo-dev-client를 다시 설치하고 eas.json 설정도 복원하면 됩니다.
(→ 고로 복원할 필요도 없다)

yarn add expo-dev-client
{
  "build": {
    "preview": {
      "developmentClient": true,
      "distribution": "internal"
    }
  }
}

✅ 정리

  • expo-dev-clientExpo Go에서는 작동하지 않음
  • Expo Go로 앱을 열어보고 싶다면 반드시 제거 필요
  • 단순히 웹 미리보기 또는 기본 앱 실행만 필요하면 삭제해도 무방
  • 이후 필요시 언제든 다시 설치 및 설정 가능
profile
리액트 공부하는 사람

0개의 댓글