React Native 윈도우 환경에서 개발 시 NODE_ENV 설정 오류 해결하기 : CROSS-ENV

 

React Native 프로젝트를 Windows에서 개발할 때, 환경 변수 설정(NODE_ENV) 문제로 인해 실행 오류가 발생할 수 있습니다. 이 문서에서는 해당 오류의 원인과 이를 해결하는 방법을 정리했습니다.

 

1. 오류 내용

React Native 프로젝트의 package.json 파일에 다음과 같이 스크립트를 작성했습니다.

{
  "scripts": {
    "android:dev": "NODE_ENV=development npx react-native start"
  }
}

 

명령어를 실행하면 다음과 같은 오류가 발생합니다.

$ NODE_ENV=production npx react-native start
'NODE_ENV'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는
배치 파일이 아닙니다.
error Command failed with exit code 1.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command

 

오류 원인:
Windows는 NODE_ENV=development와 같은 Unix 스타일의 환경 변수 설정 방식을 기본적으로 지원하지 않습니다.

 

 

2. 해결 방법

Windows 환경에서 환경 변수를 설정하려면 별도의 도구가 필요합니다. 아래 두 가지 방법 중 하나를 사용하면 문제를 해결할 수 있습니다.

2-1. win-node-env 패키지 사용

win-node-env는 Windows 환경에서 Unix 스타일의 환경 변수 설정을 지원하도록 돕는 패키지입니다.

 

1. 패키지 설치
전역으로 win-node-env를 설치합니다.

npm install -g win-node-env

 

2. 스크립트 작성
설치 후, 기존 스크립트를 그대로 사용하면 됩니다.

{
  "scripts": {
    "android:dev": "NODE_ENV=development npx react-native start",
    "android:dev:c": "NODE_ENV=development npx react-native start --reset-cache"
  }
}

 

2-2. cross-env 패키지 사용

cross-env는 운영 체제에 관계없이 환경 변수를 설정할 수 있도록 도와주는 패키지입니다.

1. 패키지 설치
전역 또는 로컬로 cross-env를 설치합니다.

npm install -g cross-env

 

2. 스크립트 작성
환경 변수 설정 부분을 cross-env로 감싸줍니다.

{
  "scripts": {
    "android:dev": "cross-env NODE_ENV=development npx react-native start",
    "android:dev:c": "cross-env NODE_ENV=development npx react-native start --reset-cache"
  }
}

 

3. 요약 및 결론

Windows 환경에서 React Native 개발 시 NODE_ENV 환경 변수 설정 오류는 흔히 발생하는 문제입니다. 이를 해결하려면 다음 두 가지 중 하나를 선택하여 사용하세요.

• win-node-env: Windows 환경에 특화된 솔루션.
• cross-env: 운영 체제에 관계없이 사용 가능한 범용 솔루션.

이 도구들을 활용하면 Windows에서도 안정적으로 React Native 개발 환경을 유지할 수 있습니다.

 

---

 

 

* 이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다.