Expo 프로젝트에서 Xcode 인식 문제 해결하기

Expo 프로젝트에서 Xcode 인식 문제 해결하기

문제 상황

맥북에 이미 Xcode가 설치되어 있음에도 불구하고 Expo 프로젝트에서 iOS 시뮬레이터를 실행하려고 할 때 다음과 같은 메시지가 계속 표시되었습니다:

Xcode must be fully installed before you can continue. Continue to the App Store?

 

심지어 Xcode 스플래시 화면이 보이는 상태에서도 이런 메시지가 나타났습니다.

원인 분석

이 문제는 Expo CLI가 시스템에 설치된 Xcode의 경로를 올바르게 인식하지 못해서 발생합니다. 로그를 보면 다음과 같이 Xcode: /undefined로 표시되어 있었습니다:

IDEs:
  Xcode: /undefined - /usr/bin/xcodebuild

해결 방법

문제 해결을 위해 xcode-select 명령어를 사용하여 Xcode의 경로를 명시적으로 설정해 주었습니다:

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

이 명령어는 시스템에게 Xcode의 개발자 도구 경로를 정확히 알려주는 역할을 합니다.

세부 과정

1. 터미널을 열고 위의 명령어를 실행
2. 관리자 비밀번호 입력
3. Expo 프로젝트 재실행 (npx expo start -c --ios)
4. iOS 시뮬레이터가 정상적으로 실행됨

유용한 팁

새 Mac을 설정하거나 Xcode를 업데이트한 후에는 항상 다음 단계를 확인하는 것이 좋습니다:

1. Xcode가 완전히 설치되었는지 확인
2. Xcode Command Line Tools 설치 상태 확인
3. xcode-select -p 명령어로 현재 설정된 경로 확인
4. 필요한 경우 위의 해결 방법으로 경로 재설정

 

결론

개발 환경 설정 문제는 종종 단순한 경로 설정이나 환경 변수 문제로 발생합니다. 이러한 문제는 공식 문서나 GitHub 이슈를 참고하면 빠르게 해결할 수 있습니다.

---

참고 자료:

• Expo GitHub Issue #21727
• iksflow 블로그

"Xcode must be fully installed before you can continue". · Issue #21727 · expo/expo

 

[오류해결 | React Native] Xcode must be fully installed before you can continue.