🛠️ 'EAS CLI를 업데이트했는데도 여전히 경고가 뜹니다!' 터미널 PATH의 비밀스러운 삶

Source: Dev.to

Introduction

Expo Application Services (EAS)를 사용해 본 적이 있고 다음과 같은 경고를 본 적이 있다면:

★ eas-cli@16.28.0 is now available. To upgrade, run npm install -g eas-cli. Proceeding with outdated version.

업그레이드 명령을 실행하고, 같은 터미널을 열어 다시 실행했는데 똑같은 경고가 뜨는 경우, 전형적인 개발 환경 함정에 빠진 것이다! 이 글에서는 왜 이런 일이 발생하는지와 간단한 해결책인 npx eas-cli build를 실행하면 즉시 문제가 해결되는 이유를 설명한다.

The Problem: When eas build Fails

사용자는 초기 빌드에서 다음과 같은 의존성 오류로 실패했다:

The 'expo-modules-autolinking' package has been found, but it seems to be incompatible with '@expo/prebuild-config'
Error: build command failed.

이 호환성 문제는 **최신 버전의 eas-cli**가 프로젝트 의존성을 올바르게 해결하도록 해야 자주 발생한다. 사용자는 올바른 업그레이드 명령을 실행했다:

npm install -g eas-cli

하지만 다시 빌드를 시도했을 때 CLI는 여전히 구버전이라고 경고했다:

cathy@Cathys-MacBook-Air-2 workout_app % eas build --platform ios --profile development
★ eas-cli@16.28.0 is now available.
To upgrade, run npm install -g eas-cli.
Proceeding with outdated version.

이 루프는 혼란스럽다! 도구는 업데이트 되었지만 명령은 여전히 옛 버전을 사용한다. 왜일까?

The Root Cause: The Terminal’s PATH Cache

eas build와 같은 명령을 입력하면, 쉘(zsh 또는 bash 등)은 eas 실행 파일이 어디에 있는지 모른다. 대신 $PATH 라는 환경 변수에 정의된 디렉터리 목록을 탐색한다.

• 옛 eas 위치: eas-cli를 전역으로 처음 설치했을 때, 쉘은 특정 경로(예: /usr/local/bin/eas)에서 찾았다.
• 쉘 캐시: 속도를 위해 터미널은 현재 세션에서 사용한 명령의 위치를 캐시(기억)한다.
• 업그레이드: npm install -g eas-cli를 실행하면 새로운 바이너리가 종종 같은 위치에 설치된다.
• 충돌: 그러나 현재 열려 있는 터미널 세션은 여전히 옛 eas 실행 파일에 대한 캐시된 정보를 사용한다. 파일 자체는 덮어써졌거나 시스템이 경로를 새로 고쳐야 함에도 불구하고, 구버전 위치를 가리키고 있다.

이 때문에 일반적인 트러블슈팅 단계인 터미널을 닫았다가 다시 여는 것이 보통 문제를 해결한다! 이렇게 하면 쉘이 캐시를 비우고 $PATH를 다시 스캔하게 된다.

The Elegant Solution: Using npx

캐시를 손대거나 터미널을 재시작하는 대신, 현대적인 Node.js 도구인 **npx**를 사용하면 신뢰할 수 있는 바로가기를 제공한다.

작동한 해결책:

npx eas-cli build --platform ios --profile development

How npx Saves the Day

• PATH 우회: npx(Node Package Execute)는 Node.js 패키지 실행 파일을 실행하도록 설계되었다. 핵심은 쉘의 캐시된 PATH를 사용하지 않는다는 점이다.
• 지능형 해석: npx eas-cli …를 실행하면 먼저 프로젝트의 로컬 node_modules에서 바이너리를 찾는다. 없을 경우(전역 도구인 eas-cli와 같은 경우) 즉시 전역에 설치된 최신 버전을 실행한다. 현재 쉘 세션에 남아 있는 오래된 캐시를 무시한다.

npx를 사용하면 시스템에 설치된 가장 최신 버전의 도구를 실행한다는 것을 보장할 수 있어, 쉘 캐시와 환경 변수로 인한 모든 골치를 피할 수 있다.

Key Takeaways for Developers

• 간단한 해결책: 전역 도구를 업데이트한 후 터미널을 닫았다가 다시 연다.
• 신뢰할 수 있는 해결책: 명령 앞에 npx를 붙인다(예: npx ).

계속 코딩하고, 즐거운 빌드 되세요! 🚀