개발 빌드 만들기

프로젝트의 개발 빌드를 만드는 방법을 알아본다.

개발 빌드는 EAS Build를 사용하거나 Android Studio와 Xcode가 설치된 컴퓨터에서 로컬로 만들 수 있다.

이 가이드에서는 EAS로 개발 빌드를 만들고 에뮬레이터/시뮬레이터 또는 실제 기기에 설치하는 방법을 알아본다.

사전 준비

EAS Build를 사용하는 React Native Android/iOS 프로젝트가 필요하다. 아직 프로젝트를 구성하지 않았다면 이 문서를 참조한다.

방법

다음 지침은 Android와 iOS, 실제 기기와 에뮬레이터를 모두 다룬다. 여러분의 프로젝트에 맞는 지침을 사용할 수 있다.

1. expo-dev-client 설치

npx expo install expo-dev-client

2. eas.json 설정 확인

처음 eas build 명령을 실행하면 프로젝트 디렉토리 루트에 eas.json 파일이 생성된다. eas.json 에는 development , preview , production 의 세 가지 기본 빌드 프로필이 포함되어 있다. eas.json 을 처음 초기화한 이후 development 프로필을 제거했다면 지금 다시 추가해야 한다.

최소 설정은 다음과 같다:

// eas.json
{
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal"
    },
    "preview": {
      "distribution": "internal"
    },
    "production": {}
  }
}

위의 development 프로필에서 설정한 옵션은 다음과 같다:

• developmentClient 를 true 로 설정하여 디버그 빌드를 생성한다. 또한 Android 기기나 에뮬레이터 또는 iOS 기기에 설치할 수 있는 빌드 아티팩트를 생성한다(내부 배포).
• iOS 기기용 빌드에는 Apple Developer Program 멤버십이 필요하다. 없다면 iOS 시뮬레이터용으로만 빌드할 수 있다. 자세한 내용은 다음 단계를 참조한다.

3. 에뮬레이터/시뮬레이터용 빌드 생성

아래 단계에 따라 Android 에뮬레이터 또는 iOS 시뮬레이터에 개발 빌드를 생성하고 설치한다.

각 플랫폼마다 따라야 할 특정 지침이 있다:

eas build --profile development --platform android

{
  "build": {
    "development-simulator": {
      "developmentClient": true,
      "distribution": "internal",
      "ios": {
        "simulator": true
      }
    }
  }
}

eas build --profile development-simulator --platform ios

4. 기기용 빌드 생성

아래 단계에 따라 Android 또는 iOS 기기에 개발 빌드를 생성하고 설치한다.

eas build --profile development --platform android

eas device:create

eas build --profile development --platform ios