iOS 또는 macOS 개발자라면, 혹은 코드 편집을 위해 Xcode를 사용하는 분이라면 한 번쯤 다음과 같은 오류 메시지를 마주한 적이 있을 것입니다. 바로 "이 버전의 Xcode는 이 버전의 macOS에서 지원되지 않습니다(This version of Xcode isn't supported in this version of macOS)"라는 문구입니다. 특히 중요한 프로젝트를 진행 중이라면 이 오류는 정말 답답하게 느껴질 수밖에 없죠.
Xcode는 애플의 통합 개발 환경(IDE)으로, 애플의 모든 플랫폼에서 앱을 개발할 때 사용됩니다. 최신 Xcode 16에는 다양한 새로운 기능이 추가되었는데요. 원활한 개발 환경을 유지하려면 Xcode와 macOS 버전 간의 호환성을 확보하는 것이 무엇보다 중요합니다. 이 글에서는 해당 오류의 발생 원인을 살펴보고, 여러 가지 해결 방법을 자세히 안내해 드리겠습니다.
오류가 발생하는 원인
이 오류는 대개 사용 중인 Xcode 버전이 현재 macOS 버전과 호환되지 않을 때 발생합니다. 애플은 새로운 기능과 보안 패치를 포함해 macOS와 Xcode를 자주 업데이트하는데, 두 업데이트의 시점이 어긋나면 문제가 생깁니다. 예를 들어 macOS만 업데이트하고 Xcode를 업데이트하지 않았거나, 그 반대의 경우 시스템이 이 오류를 표시합니다. 이러한 비호환성으로 인해 Xcode가 실행되지 않거나, 빌드가 불가능하거나, 최신 개발 도구에 접근할 수 없게 됩니다.
Mac에서 나타나는 Xcode 경고의 일반적인 원인은 다음과 같습니다.
- 새로 업데이트된 macOS에서 구버전의 Xcode를 실행하는 경우
- 구버전의 macOS에 최신 베타 버전의 Xcode를 설치하려는 경우
- macOS 또는 Xcode의 업데이트가 누락되거나 불완전하게 완료된 경우
레딧(Reddit) 커뮤니티의 해결 사례
실제로 많은 Mac 사용자들이 "이 버전의 Xcode는 지원되지 않습니다" 오류의 해결 방법을 찾고 있습니다. 예를 들어, 레딧의 한 사용자는 Mac을 macOS Sequoia 베타로 업데이트한 후 Xcode에서 이 오류가 발생했다며 도움을 요청했습니다.
이에 달린 답변 중 유용한 조언으로는 호환되지 않는 앱과 운영체제의 조합이 원인이므로, Xcode 베타를 삭제하거나 macOS Sequoia를 macOS Sonoma로 다운그레이드하라는 의견이 있었습니다.
또한 일부 사용자들은 Mac 터미널(Terminal) 명령어를 활용해 새로운 Xcode를 사용하는 방법도 추천했습니다. 어떤 상황이든 이 가이드에서 소개하는 방법들을 통해 "이 버전의 Xcode는 지원되지 않습니다" 오류를 제거할 수 있습니다. 본인에게 가장 적합한 방법을 찾아보세요.
"이 버전의 Xcode는 지원되지 않습니다" 오류 해결 방법
"이 버전의 Xcode는 이 버전의 macOS에서 지원되지 않습니다"라는 오류 메시지 때문에 곤란을 겪고 있다면, 아래의 방법들로 문제를 해결해 보세요.
방법 1: macOS 호환성 확인하기
업데이트나 설치 작업을 시작하기 전에, 먼저 사용 중인 Xcode 버전이 현재 macOS 버전과 호환되는지 확인해야 합니다. 애플은 각 macOS 버전과 호환되는 Xcode 버전을 보여주는 호환성 차트를 제공합니다. 예를 들어 Xcode 16 베타는 최소 macOS 14.5 이상을 요구합니다.
이 정보는 애플 공식 개발자 문서에서 확인할 수 있습니다. 소프트웨어가 애플의 요구 사항에 맞는지 미리 확인하면 불필요한 오류를 예방할 수 있습니다.
확인 결과 macOS 또는 Xcode 버전이 구버전이라면, 둘 중 하나를 최신 릴리스로 업데이트하는 것이 필수입니다.
- macOS 업데이트: Apple 메뉴 > 시스템 설정 > 일반 > 소프트웨어 업데이트로 이동하여 새로운 업데이트가 있다면 진행하세요.
- Xcode 업데이트: App Store > Xcode 검색 > 업데이트가 있는 경우 '업데이트' 버튼을 클릭하세요.
또는 애플 개발자 사이트에서 Xcode 베타를 다운로드했다면, 해당 사이트를 방문해 최신 안정화(stable) 버전을 내려받으세요.
- 애플 개발자 웹사이트에 접속합니다.
- Apple ID로 로그인합니다.
- 'More Downloads(추가 다운로드)' 섹션에서 기존 버전의 Xcode를 찾습니다.
- 적절한 버전을 다운로드하여 설치합니다.
기억하세요! 구버전의 macOS에서 새로운 Xcode 베타를 열지 마세요.
방법 2: Xcode 완전 삭제 후 재설치하기
경우에 따라 Xcode의 불완전하거나 손상된 설치가 호환성 문제를 일으킬 수 있습니다. 이 경우 전체 재설치로 문제를 해결할 수 있습니다. Xcode를 완전히 제거하려면 Finder나 Launchpad에서 단순히 삭제하는 것만으로는 부족합니다. 관련 데이터가 라이브러리(Library)에 남아 Mac 성능 저하의 원인이 되기 때문입니다.
따라서 iBoysoft MagicMenu를 활용하는 것이 좋습니다. 몇 번의 클릭만으로 원하지 않는 앱을 잔여 파일까지 완전히 제거할 수 있어서입니다. 이 도구를 사용하면 라이브러리 폴더를 일일이 열어볼 필요 없이, 터미널에 복잡한 명령어를 입력할 필요도 없습니다.
- iBoysoft MagicMenu를 무료로 다운로드하여 설치 후 실행합니다.
- Finder > 응용 프로그램 > Xcode 우클릭 > '제거(Uninstall)'를 선택합니다.
- Xcode의 관련 파일을 선택한 후 '제거' > '예'를 클릭합니다.
- 모든 파일이 삭제되면 App Store 또는 애플 개발자 웹사이트를 통해 Xcode를 다시 설치합니다.
정말 간단하죠? 이 편리한 도구가 마음에 드실 거라 확신합니다. 주변에 알려 더 많은 사람들이 도움을 받을 수 있게 해주세요!
방법 3: Xcode 명령줄 도구(Command-Line Tools) 활용하기
컴파일이나 코드 빌드 같은 Xcode의 특정 기능, 즉 명령줄 도구만 필요하다면 IDE 전체를 거치지 않고 Xcode의 명령줄 도구만 설치하여 문제를 우회할 수 있습니다. 방법은 다음과 같습니다.
- Finder > 응용 프로그램 > 유틸리티 > 터미널을 엽니다.
xcode-select --install또는open /Applications/Xcode-15.4.0.app/Contents/MacOS/Xcode를 입력한 후 Enter 키를 누릅니다.
(15.4.0 부분은 호환되는 버전 번호로 변경하세요.)
- 화면의 안내에 따라 설치를 완료합니다.
이제 "이 버전의 Xcode는 이 버전의 macOS에서 지원되지 않습니다" 오류가 해결되었기를 바랍니다. 도움이 되었다면 이 글을 다른 분들과 공유해 주세요.
마무리
"이 버전의 Xcode는 지원되지 않습니다" 오류를 만나면 당황스럽지만, 대부분의 경우 Xcode와 macOS 버전 간의 호환성만 확보하면 쉽게 해결할 수 있습니다.
위에서 소개한 단계들, 즉 호환성 확인, 스마트 도구 iBoysoft MagicMenu를 활용한 완전 재설치, 또는 대체 버전 설치 등을 따르면 큰 차질 없이 개발 업무에 복귀할 수 있습니다.