Apple은 Xcode 추가 구성 요소를 Components 설정과 명령줄에서 관리하는 방법을 안내합니다. 공식 구성 요소 안내를 기준으로 보면, iOS 27 시뮬레이터 런타임 다운로드 실패는 먼저 다운로드, 설치, 실행 대상 인식 중 어디에서 멈췄는지 나눠야 합니다. 먼저 Xcode와 런타임 상태를 확인하고, 시스템 자산 폴더 삭제나 Xcode 재설치는 보류하세요. 원격 맥이라면 실제 작업을 실행하는 맥의 Xcode와 설치된 런타임을 확인해야 합니다.
이 글은 iOS 27 런타임이 없어 프로젝트를 실행하지 못하는 독립 개발자와 소규모 팀을 위한 안내입니다.
원격 맥이나 연속 통합 환경에서 Xcode 테스트를 실행하는 경우에도 사용할 수 있습니다.
Xcode를 업데이트한 뒤 시뮬레이터가 사라졌다면, 런타임 누락과 개발자 디렉터리 선택 오류를 구별해 보세요.
SECTION 01 첫 점검: 실패가 다운로드, 설치, 인식 중 어디에서 발생했나요?
기록할 정보부터 모으세요. Xcode 버전, 선택된 개발자 디렉터리, 런타임 상태, 오류 문구를 같은 실행 환경에서 확인해야 합니다. 다운로드가 멈춘 상태와 설치가 실패한 상태는 다음 조치가 다릅니다.
터미널에서 아래 명령을 실행해 결과를 보관합니다.
xcodebuild -version
xcode-select -p
xcrun simctl list runtimes
xcrun simctl list devices available
xcodebuild -version은 실행 중인 Xcode 정보를 확인하는 데 쓰고, xcode-select -p는 명령줄 도구가 참조하는 개발자 디렉터리를 확인하는 데 씁니다. simctl 결과는 런타임과 사용 가능한 시뮬레이터 기기를 따로 살펴보는 단서입니다. 명령줄 도구 설정은 Apple의 개발자 디렉터리 설정 안내와 명령줄 도구 참고 문서를 함께 확인하세요.
Xcode 27 또는 iOS 27이라는 이름만으로 지원 여부를 단정하지 마세요. 설치된 Xcode가 해당 런타임을 제공하는지, 실제 구성 요소 목록에 표시되는지 확인해야 합니다. Xcode 버전에 따른 요구 조건은 Apple 시스템 요구 사항에서 확인할 수 있습니다. 특정 오류가 모든 사용자에게 발생하는 공통 문제라고 볼 근거가 없다면, 개별 환경의 로그와 상태를 기준으로 판단하세요.
SECTION 02 다운로드가 시작되지 않거나 중단되면 Components 상태를 확인합니다
Xcode의 설정에서 Components 항목을 열고 iOS 플랫폼 구성 요소와 시뮬레이터 런타임이 표시되는지 확인하세요. 다운로드 진행 중인지, 실패했는지, 취소됐는지도 먼저 구분합니다. Apple은 추가 구성 요소의 확인과 다운로드 경로를 Xcode Components 관리 문서에서 안내합니다.
명령줄 다운로드는 Xcode의 구성 요소 화면에서 상태를 확인하기 어렵거나 자동화된 환경에서 같은 절차를 재현해야 할 때 검토할 수 있습니다. Apple 문서에 안내된 예시는 다음과 같습니다.
xcodebuild -downloadPlatform iOS
해당 명령이 현재 설치된 Xcode에서 유효한지, 요청한 플랫폼이나 런타임을 실제로 제공하는지는 명령 실행 결과와 Components 목록으로 확인하세요. 명령이 끝났다는 표시만으로 설치 완료를 확정하지 마세요. 런타임 목록에도 나타나는지 이어서 확인해야 합니다.
Xcode 27에서 iOS 27 런타임 다운로드가 실패할 때는 무엇을 확인하나요? 우선 Components에 해당 항목이 보이는지, 다운로드 작업이 진행 중인지, 실패 또는 취소 상태인지 확인합니다. 항목 자체가 없으면 임의의 설치 파일을 찾기보다 현재 Xcode가 제공하는 구성 요소와 Apple의 지원 안내를 대조하세요. 다운로드가 진행 중이면 작업을 반복 실행하지 말고 완료 또는 오류 상태가 될 때까지 기다린 뒤 로그를 남깁니다.
SECTION 03 다운로드는 됐지만 설치되지 않으면 도구 체인과 산출물을 분리합니다
설치 오류가 난 시점을 기록하세요. 다운로드 산출물을 사용할 수 없는 것인지, 설치 절차가 끝나지 않은 것인지, 다른 Xcode를 선택해 검사 중인 것인지 구별해야 합니다. 이 구분 없이 다시 받기만 반복하면 같은 조건에서 실패할 수 있습니다.
먼저 xcode-select -p 결과가 의도한 Xcode의 개발자 디렉터리인지 확인하고, Xcode 앱에서 선택한 도구 체인과 비교하세요. 여러 Xcode가 설치된 맥에서는 명령줄 도구가 다른 버전을 참조할 수 있습니다. 전역 개발자 디렉터리를 바꾸기 전에는 현재 경로와 오류 로그를 저장하세요. 변경이 필요한 경우에만 공식 설정 절차를 따르고, 문제가 생기면 기록해 둔 이전 경로로 되돌립니다.
실패한 다운로드를 다시 시도하기 전에는 원래 오류 문구와 Components 화면의 상태를 보관하세요. 런타임 제거, 캐시 삭제, 시스템 자산 폴더 변경은 범위와 복구 방법을 확인하지 못했다면 진행하지 않는 편이 안전합니다. 특히 런타임 제거는 그 런타임에 연결된 시뮬레이터 테스트 환경에도 영향을 줄 수 있습니다.
설치 중 오류가 한 번 발생했다고 곧바로 Xcode를 지우거나 시스템 폴더를 정리하지 마세요. 실행 중인 Xcode 경로와 런타임 목록이 서로 맞지 않는 문제라면, 재설치가 원인을 해결하지 못할 수 있습니다.
SECTION 04 설치 뒤에도 실행 대상에 없다면 프로젝트와 런타임 인식을 확인합니다
런타임 목록에는 있지만 Xcode의 실행 대상 목록에 기기가 없다면 다운로드 실패로 단정하지 마세요. 현재 Scheme이 iOS 앱을 대상으로 하는지, 선택한 Xcode가 예상한 도구 체인인지, 런타임과 기기가 해당 환경에서 인식되는지 차례로 살펴봅니다.
설치가 끝났는데 사용 가능한 기기가 보이지 않는다면 어떻게 확인하나요? 먼저 Xcode의 실행 대상 목록을 확인한 다음, xcrun simctl list runtimes와 xcrun simctl list devices available 결과를 비교하세요. 런타임은 보이지만 기기는 없다면 기기 등록 또는 실행 대상 선택을 확인합니다. 런타임 자체가 보이지 않으면 설치 완료 여부와 현재 선택된 Xcode를 다시 확인하세요.
명령줄로 받은 런타임이 무엇인지 어떻게 확인하나요? 다운로드 명령의 로그만으로 판단하지 말고, 명령을 실행한 맥에서 xcrun simctl list runtimes를 확인하세요. 이어서 Xcode 실행 대상 목록에도 같은 플랫폼이 나타나는지 확인합니다. 명령이 실행된 환경과 Xcode가 참조하는 개발자 디렉터리가 다르면 결과가 일치하지 않을 수 있습니다.
실행 대상 선택 방법은 Apple의 시뮬레이터 또는 실제 기기에서 앱 실행 안내에서 확인할 수 있습니다. 시뮬레이터 기기를 관리하는 절차는 Apple의 추가 시뮬레이터 안내도 참고하세요. 프로젝트 빌드가 실패했더라도 먼저 런타임과 실행 대상이 인식되는지 확인해야, 프로젝트 오류와 환경 오류를 혼동하지 않습니다.
SECTION 05 원격 맥과 연속 통합 환경에서는 실제 실행 맥을 점검합니다
화면을 보는 개발자 컴퓨터와 Xcode 빌드를 실행하는 원격 맥 또는 실행기가 서로 다르면, 로컬에서 확인한 런타임은 원격 환경의 상태를 증명하지 않습니다. 원격 환경에서 명령을 실행해 결과를 수집하고, 실행기 관리 권한이 없다면 환경 담당자에게 같은 정보를 요청하세요.
원격 맥에서 Xcode가 설치된 런타임을 찾지 못하면 어떻게 하나요? 빌드가 실제로 실행되는 맥에서 xcodebuild -version, xcode-select -p, xcrun simctl list runtimes를 확인하세요. 원격 접속을 시작한 컴퓨터에서 확인한 값은 참고 자료일 뿐입니다. 원격 맥의 Xcode 경로와 런타임 상태가 일치하지 않으면 환경 관리자에게 현재 도구 체인과 설치 상태를 전달하고, 프로젝트 설정 변경이나 런타임 삭제부터 시도하지 마세요.
아래 항목을 점검한 뒤에만 같은 빌드나 테스트를 다시 실행하세요.
- [ ] 빌드가 실행된 맥에서 Xcode 버전과 개발자 디렉터리를 기록했습니다.
- [ ] 해당 맥에서 iOS 런타임이 목록에 나타나는지 확인했습니다.
- [ ] Xcode의 실행 대상 목록과 명령줄의 런타임·기기 결과를 대조했습니다.
- [ ] 실패 단계와 원래 오류 문구를 보관했습니다.
- [ ] 개발자 디렉터리 변경이나 런타임 정리가 필요하다면 영향 범위와 되돌리는 방법을 확인했습니다.
- [ ] 프로젝트를 해당 시뮬레이터에서 빌드하고 실행해 복구 여부를 확인했습니다.
SECTION 06 복구 판정은 시뮬레이터 실행과 실제 기기 검증을 나눕니다
런타임이 표시되는 것만으로 복구가 끝난 것은 아닙니다. 올바른 Scheme과 실행 대상을 선택하고, 프로젝트를 빌드한 뒤 시뮬레이터에서 앱이 시작되는지 확인하세요. 화면에 나타나지 않는다면 빌드 로그와 실행 로그를 나눠 살펴봅니다. 문제가 런타임 인식인지 프로젝트 빌드인지 구별하는 데 도움이 됩니다.
시뮬레이터 검증은 실제 기기에서의 동작 검증을 대신하지 않습니다. 센서, 연결 상태, 실제 기기별 동작에 의존하는 기능은 별도로 실제 기기에서 확인해야 합니다. Apple도 앱을 시뮬레이터와 실제 기기에서 실행하는 절차를 각각 안내하므로, 기기별 실행 방법을 기준으로 테스트 범위를 나누세요.
문제가 개발자 컴퓨터에서는 재현되지 않고 원격 환경에서만 나타난다면, 우선 원격 맥의 Xcode와 런타임 상태를 비교하세요. 현재 환경을 직접 유지하면 도구 체인과 저장 공간을 관리해야 하고, 공유 실행기에서는 설정 권한이나 설치 상태를 직접 통제하지 못할 수 있습니다. 반대로 고정된 장비와 주변 기기 연결이 필요하거나 장기간 같은 환경을 운영해야 한다면 자체 맥이 더 맞을 수 있습니다. 짧은 기간 원격 macOS 테스트 환경이 필요하다면 VPSNIX의 원격 맥 이용 안내와 요금 안내를 살펴보고, 작업 방식에 맞는지 먼저 비교하세요. 원격 맥 환경 자체를 알아보려면 VPSNIX 안내 페이지에서 이용 방법을 확인할 수 있습니다.