Xcode 16.3에서 발생하는 문제와 Xcode 다운그레이드 방법

❗️ Xcode 16.3 버전 문제

현재 Xcode 16.3에서 React Native 앱 빌드 시 undefined template 'std::char_traits<unsigned char>' prevent building the app 오류가 난다는 보고들이 여기저기서 올라오고 있습니다.
애플은 macOS와 Xcode를 자주 업데이트합니다만, 이 업데이트가 항상 개발자들에게 좋은 소식만은 아닙니다.

Xcode가 새롭게 업데이트되면 다음과 같은 문제가 생길 수 있습니다:

• 이전에 잘 되던 빌드 오류 발생

• 서드파티 라이브러리 호환 문제

• Flutter, React Native, Unity 등 툴체인과 충돌

• macOS 시스템 요구사항 때문에 이전 버전 설치 불가

🔧 해결 방법은? Xcode 버전 다운그레이드!

가장 확실한 해결책은 안정적으로 사용하던 이전 버전 Xcode로 되돌리는 것입니다.

1. 이전 버전 Xcode 다운로드

애플의 공식 개발자 사이트에서 원하는 버전의 Xcode를 다운로드할 수 있습니다.

👉 Apple Developer - More Downloads

로그인 후 Xcode를 검색하면 다양한 버전의 Xcode .xip 파일을 받을 수 있습니다.
지금은 16.3 버전이 문제이므로, Xcode 16.2 버전을 다운로드 받으면 되겠습니다.

2. 기존 Xcode 삭제

기존 Xcode는 /Applications/Xcode.app에 설치되어 있으므로, 아래 명령어로 삭제 가능합니다:

sudo rm -rf /Applications/Xcode.app 

또는 Finder에서 직접 Xcode.app를 휴지통에 버리셔도 됩니다.

3. .xip 파일 설치

다운받은 .xip 파일을 더블 클릭하면 자동으로 압축이 풀리고 Xcode.app 파일이 생성됩니다. 해당 앱을 다시 /Applications 폴더로 옮겨주세요.

4. Xcode 버전 설정

터미널에서 아래 명령어를 입력하면, 시스템에서 사용할 기본 Xcode 버전을 설정할 수 있습니다:

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

/Applications/Xcode.app는 새로 설치한 Xcode 위치에 따라 다를 수 있습니다.

5. Xcode 버전 확인

아래 명령어로 현재 설정된 Xcode 버전을 확인할 수 있습니다:

xcodebuild -version 

✅ 추가 팁: 여러 Xcode 버전 동시에 설치하기

만약 여러 프로젝트에서 다른 버전의 Xcode를 사용해야 할 경우, Xcode_13.4.1.app, Xcode_15.0.app 식으로 이름을 다르게 하여 /Applications 폴더에 두고, 필요할 때마다 xcode-select 명령어로 전환하면 됩니다.

sudo xcode-select -s /Applications/Xcode_13.4.1.app 

마무리하며

Xcode는 애플 개발의 필수 도구이지만, 버전 변화가 프로젝트에 영향을 줄 수 있습니다.
항상 업데이트 전에는 호환성 여부를 확인하고, 문제가 생겼을 때는 다운그레이드를 통해 빠르게 복구할 수 있도록 대비해두세요.