iOS 또는 macOS 개발자이거나 코드 편집을 위해 Xcode를 사용하는 경우 다음 오류 메시지가 표시될 가능성이 있습니다. "이 버전의 Xcode는 이 macOS 버전에서 지원되지 않습니다. ". 이 오류는 특히 중요한 프로젝트를 진행 중일 때 실망스러울 것입니다.
Xcode는 모든 플랫폼에서 앱을 개발하기 위한 Apple의 통합 개발 환경(IDE)입니다. 이제 Xcode 16에는 많은 새로운 기능이 있습니다. 원활한 개발 프로세스를 유지하려면 Xcode와 macOS 버전이 호환되는지 확인하는 것이 필수적입니다. 이 글에서는 이 문제의 원인에 대해 논의하고 이를 해결하는 여러 가지 방법을 살펴보겠습니다.
이 오류는 일반적으로 사용 중인 Xcode 버전이 현재 macOS 버전과 호환되지 않을 때 발생합니다. Apple은 macOS와 Xcode를 자주 업데이트하여 새로운 기능과 보안 패치를 도입합니다. macOS는 업데이트되었지만 Xcode는 업데이트되지 않거나 그 반대의 경우와 같이 이러한 업데이트가 동기화되지 않은 경우 시스템에서 이 오류가 발생합니다. 이러한 비호환성으로 인해 Xcode 실행, 빌드 실행 또는 최신 개발 도구 액세스가 실패할 수 있습니다.
이 오류의 몇 가지 일반적인 원인 Mac의 Xcode 경고 다음을 포함합니다:
- 새로 업데이트된 macOS에서 오래된 버전의 Xcode를 실행합니다.
- 오래된 macOS에 최신 Xcode 베타를 설치하려고 합니다.
- macOS 또는 Xcode에 대한 업데이트가 누락되거나 불완전합니다.
이 버전의 Xcode를 수정하는 방법에 대한 Reddit 토론은 지원되지 않습니다
이 버전의 Xcode는 지원되지 않습니다... 오류를 해결하는 방법을 요청하는 Mac 사용자가 많습니다. 예를 들어 Reddit 사용자가 Mac을 macOS Sequoia 베타로 업데이트할 때 이 오류가 발생하기 위해 도움을 구하고 있는데 Xcode에서 이 오류가 표시됩니다.
응답 중에는 Xcode 베타를 제거하거나 macOS Sequoia를 macOS Sonoma로 다운그레이드하라는 유용한 팁이 있습니다. 호환되지 않는 앱과 운영 체제로 인해 이 오류가 발생할 수 있기 때문입니다.
Macos 18 베타로 업데이트한 후 Xcode가 작동하지 않습니다.byu/OkBerry3600 iniOS프로그래밍
일부 사용자는 여러 Mac 터미널 명령에 새로운 Xcode를 활용하라고 조언하기도 합니다. 귀하의 요구 사항에 관계없이 이 가이드에서는 이 Xcode 버전은 지원되지 않습니다... 오류를 제거하기 위한 최선의 접근 방식을 간략하게 설명합니다. 자신에게 가장 적합한 옵션을 찾으려면 계속 읽어보세요~
오류 해결 방법 이 버전의 Xcode는 지원되지 않습니다...
이 Xcode 버전은 이 macOS 버전에서 지원되지 않습니다라는 오류 메시지가 표시되는 경우 많은 불편함을 주거나 정상적인 사용을 방해하는 경우, 아래의 방법으로 해결해 보세요:
방법 1:macOS 호환성 확인
업데이트나 설치를 시작하기 전에 첫 번째 단계는 사용 중인 Xcode 버전이 현재 macOS 버전과 호환되는지 확인하는 것입니다. Apple은 일반적으로 각 macOS 버전에서 작동하는 Xcode 버전을 보여주는 호환성 차트를 제공합니다. 예를 들어 Xcode 16 베타에는 최소 macOS 14.5가 필요합니다.
우리는 그것을 어떻게 알 수 있습니까? 이는 Apple의 공식 개발자 문서에서 확인할 수 있습니다. 귀하의 소프트웨어가 Apple의 요구 사항에 부합하는지 확인하면 불필요한 오류를 피할 수 있습니다.

macOS 버전/Xcode가 오래된 것으로 확인되면 둘 중 하나를 최신 릴리스로 업데이트하는 것이 중요합니다.
- macOS 업데이트의 경우:Apple 메뉴> 시스템 설정> 일반> 소프트웨어 업데이트, 새로운 것이 있으면 업데이트하세요.

- Xcode 업데이트:App Store> Xcode 검색> 업데이트가 있으면 업데이트를 클릭하세요.
또는 Apple 개발자 사이트에서 Xcode 베타를 다운로드한 경우 해당 사이트를 방문하여 최신 안정 릴리스를 다운로드하세요.
- Apple 개발자 웹사이트로 이동합니다.
- Apple ID로 로그인하세요.
- 이전 버전의 Xcode를 찾으려면 추가 다운로드 섹션을 찾아보세요.
- 적절한 버전을 다운로드하여 설치하세요.
그러므로 이전 macOS 버전에서 새로운 Xcode 베타를 열지 마세요~
방법 2:Xcode를 완전히 제거하고 다시 설치
경우에 따라 Xcode 설치가 불완전하거나 손상되어 호환성 문제가 발생할 수 있습니다. 전체 재설치를 통해 이러한 문제를 해결할 수 있습니다. Xcode를 완전히 제거하려면 Finder나 Launchpad에서 간단히 삭제하는 것만으로는 충분하지 않습니다. 관련 데이터가 라이브러리에 남아 있어 Mac 성능이 저하됩니다.
따라서 몇 번의 클릭만으로 원치 않는 앱을 완전히 제거할 수 있는 iBoysoft MagicMenu를 활용하는 것이 좋습니다. 이를 사용하면 라이브러리에서 폴더를 자주 열거나 터미널에 복잡한 명령줄을 입력할 필요가 없습니다~
- iBoysoft MagicMenu를 무료로 다운로드, 설치하고 엽니다.
- Finder> 애플리케이션> Xcode를 마우스 오른쪽 버튼으로 클릭하고> 제거를 선택합니다.
- Xcode 관련 파일을 선택한 다음 제거> 예를 클릭합니다. (이 동작처럼)

- 모든 항목이 삭제되면 App Store 또는 Apple 개발자 웹사이트를 통해 Xcode를 다시 설치할 수 있습니다.
쉽지요? 나는 당신이 이 섬세한 도구를 좋아할 것이라고 확신합니다! 더 많은 사람들을 돕기 위해 이 방법을 공유하세요.
방법 3:Xcode 명령줄 도구 사용
코드 컴파일이나 빌드를 위한 명령줄 도구와 같은 Xcode의 특정 측면만 사용하는 데 관심이 있는 경우 Xcode의 명령줄 도구를 설치하여 IDE를 완전히 우회할 수 있습니다. 방법은 다음과 같습니다:
- Finder> 애플리케이션> 유틸리티> 터미널.
- xcode-select --install 또는 open/Applications/Xcode-15.4.0.app/Contents/MacOS/Xcode를 입력한 다음 Enter 키를 누릅니다.
(15.4.0을 호환 가능한 버전으로 교체하세요.)

- 안내를 따르세요.
이제 이 Xcode 버전은 이 macOS 버전에서 지원되지 않습니다 오류를 수정했을 수도 있습니다. , 이 게시물을 다른 사람들과 공유해주세요~
결론
"이 버전의 Xcode는 이 버전의 macOS에서 지원되지 않습니다 " 오류는 실망스러울 수 있지만 일반적으로 Xcode와 macOS 버전 간의 호환성을 보장하면 쉽게 해결됩니다.
호환성 확인, 스마트 도구인 iBoysoft MagicMenu를 사용하여 제거 또는 대체 버전 설치 등 위의 단계를 수행하면 큰 중단 없이 개발 작업으로 돌아갈 수 있습니다.