Expo에서 pod install 오류: "cannot load such file -- ./scripts/autolinking" 해결 방법

Expo로 iOS 빌드를 준비하거나 expo prebuild를 실행할 때, pod install 과정에서 아래와 같은 오류가 발생할 수 있습니다:

[!] Invalid `Podfile` file: cannot load such file -- ./scripts/autolinking.

#  from [프로젝트 디렉토리]/ios/Podfile:1
#  -------------------------------------------
>  require File.join(File.dirname(`node --print "require.resolve('expo/package.json')"`), "scripts/autolinking")
#  require File.join(File.dirname(`node --print "require.resolve('react-native/package.json')"`), "scripts/react_native_pods")
#  -------------------------------------------

저는 Expo GitHub 이슈의 한 코멘트를 통해 문제를 해결할 수 있었습니다. 이 문제의 원인과 해결 방법을 정리해 보겠습니다.

---

오류 원인

이 오류는 CocoaPods 버전이 오래되어 Podfile과 호환되지 않기 때문에 발생합니다. Expo의 최신 프로젝트에서는 최신 CocoaPods 버전을 요구하기 때문에, 오래된 버전을 사용하는 경우 문제가 발생할 수 있습니다.

---

해결 방법

1. CocoaPods 최신 버전으로 업데이트

CocoaPods를 최신 버전으로 업데이트하세요. 업데이트 방법은 사용 중인 설치 방법에 따라 다릅니다.

Ruby Gems를 사용하는 경우

gem install cocoapods

Homebrew를 사용하는 경우

brew install cocoapods

이미 설치된 경우 덮어씌우기

brew link --overwrite cocoapods

2. CocoaPods 버전 확인

업데이트가 완료되면 아래 명령어로 현재 CocoaPods 버전을 확인해 보세요:

pod --version

최신 버전이라면 다음 단계로 넘어갑니다.

3. pod install 다시 실행

CocoaPods를 업데이트한 후, iOS 디렉토리에서 pod install을 다시 실행하거나 expo prebuild 명령어를 재시도해 보세요. 오류가 해결되었다면 빌드가 정상적으로 진행될 것입니다.

---

그래도 안 될 때는?

만약 위 방법으로도 문제가 해결되지 않는다면, 다음 단계를 시도해 보세요:

1. node_modules와 ios/ 디렉토리 삭제

   rm -rf node_modules ios

2. 다시 설치 및 설정

   npm install
   expo prebuild

3. 이후 pod install을 실행하세요.

---

끝으로

다른 문제가 있거나, 궁금한 점이 있다면 댓글로 남겨주세요!