Apple은 Xcode 27.2 RC 릴리스 정보에 해당 버전을 올렸고, 개발자 문서는 xcodebuild를 이용한 시뮬레이터 런타임 다운로드와 가져오기를 안내합니다. 따라서 Xcode 27.2 RC 시뮬레이터 런타임 오프라인 설치는 가능합니다. 다만 대상 Xcode에서 런타임을 확인하고 프로젝트 테스트까지 통과해야 합니다. 런타임을 가져온 것만으로 macOS CI가 준비된 것은 아닙니다.
방화벽이나 네트워크 정책 때문에 macOS Runner에서 런타임을 받기 어려운 CI 엔지니어를 위한 안내입니다.
여러 Mac의 빌드 환경을 관리하는 엔지니어는 다운로드 파일을 재사용할 때 확인할 점을 살펴볼 수 있습니다.
원격 Mac에서 iOS 시뮬레이터 테스트를 실행하려는 개발자는 프로젝트 검증 절차를 참고하세요.
마지막 업데이트: 2026년 10월 29일. Apple의 릴리스 정보, Xcode 27.2 릴리스 노트, 시뮬레이터 구성요소 설치 안내를 대조했습니다. 실제 다운로드 가능 여부와 대상 Xcode의 지원 상태는 작업 시점에 다시 확인해야 합니다.
독립 개발자는 먼저 막힌 지점을 구분합니다
오프라인 설치가 필요한 이유부터 확인하세요. 런타임 자체가 설치되지 않은 상태인지, 네트워크가 다운로드를 막는지, 아니면 앱이 현재 테스트 대상에서 실행되지 않는지에 따라 해결 순서가 달라집니다.
런타임이 이미 있고 프로젝트 설정이 원인이라면 파일을 옮겨도 문제가 해결되지 않습니다. 먼저 사용할 Xcode와 프로젝트가 요구하는 테스트 대상을 확인하세요. 네트워크가 원인일 때만 연결된 Mac에서 런타임을 준비하는 편이 낫습니다.
Apple의 추가 시뮬레이터 설치 안내는 시뮬레이터 추가 절차를 설명합니다. 시뮬레이터 또는 실제 기기에서 앱 실행하기도 함께 확인해 테스트 대상 선택이 프로젝트 요구와 맞는지 살펴보세요.
CI 엔지니어는 연결된 Mac에서 내려받아 반입합니다
다운로드와 설치를 같은 Mac에서 할 필요는 없습니다. 연결된 Mac에서 Apple이 지원하는 방식으로 런타임을 준비한 다음, 대상 Runner로 옮겨 가져올 수 있습니다. 하지만 사용할 수 있는 플랫폼과 빌드는 실제 명령 결과로 확인하세요. Xcode 버전 번호를 런타임 빌드 버전으로 바꾸어 입력하면 안 됩니다.
먼저 대상 Xcode를 선택하고 버전을 확인합니다.
sudo xcode-select --switch /Applications/Xcode.app
xcodebuild -version
Xcode 앱의 위치가 다르면 --switch 뒤의 경로를 해당 설치 경로로 바꾸세요. 여러 Xcode를 유지한다면 파일 경로가 맞는지만 볼 것이 아니라, 실제로 선택된 도구 체인을 확인해야 합니다. Apple의 Xcode 시스템 요구 사항과 해당 릴리스 노트에서 적용 대상의 요구 사항과 지원 정보를 대조하세요.
그다음 Apple의 구성요소 안내에 따라 실제로 사용할 수 있는 플랫폼과 빌드를 확인하고 다운로드합니다. 아래는 명령 형태를 보여주는 예시입니다. 괄호 안의 값은 그대로 입력하지 말고, 사용 중인 Xcode의 명령 도움말과 확인된 버전에 맞춰 지정하세요.
xcodebuild -downloadPlatform iOS -buildVersion <확인한_빌드_버전> -exportPath <내보낼_경로>
가져오기를 수행할 Mac에서는 대상 Xcode를 다시 선택한 후, Apple이 안내하는 가져오기 명령을 사용합니다.
xcodebuild -importPlatform <다운로드한_항목_경로>
명령 옵션과 동작은 설치된 Xcode에서 xcodebuild -help로 확인하세요. 명령을 실행할 수 있다는 것과 특정 iOS 런타임을 내려받을 수 있다는 것은 다릅니다. 빌드 버전이 조회되지 않으면 임의의 버전을 넣지 말고, 해당 릴리스의 지원 정보와 명령 결과부터 확인합니다.
주의: 다운로드 파일은 대상 Xcode가 지원하는지 확인하기 전까지 운영 Runner에 바로 배포하지 마세요. 파일의 출처와 내려받은 도구 체인을 기록해 두면 실패 원인을 좁히기 쉽습니다.
런타임 재사용은 Xcode 선택 상태까지 확인합니다
다운로드 파일을 여러 Mac에 배포하면 각 Mac이 네트워크에서 구성요소를 다시 받는 절차를 줄일 수 있습니다. 그렇다고 하나의 파일이 서로 다른 Xcode 버전에서 모두 작동하는 공용 캐시가 되는 것은 아닙니다. 호환성은 대상 Xcode의 지원 정보와 실제 인식 결과로 판단해야 합니다.
| 배포 방식 | 적합한 상황 | 확인할 점 |
|---|---|---|
| 각 Mac에서 직접 다운로드 | Runner가 필요한 구성요소에 접근할 수 있을 때 | Mac마다 다운로드가 성공하는지, 선택된 Xcode가 맞는지 확인합니다. |
| 연결된 Mac에서 준비해 반입 | 대상 Runner의 네트워크가 제한될 때 | 파일 출처, 적용 대상 Xcode, 가져오기 결과를 기록합니다. |
| 준비한 파일을 여러 Mac에 배포 | 여러 호스트의 구성을 관리할 때 | 호스트마다 런타임 인식과 시뮬레이터 기기 대상을 따로 확인합니다. |
현장에서 가장 흔한 오판은 디스크에 관련 파일이 있다는 이유만으로 테스트 준비가 끝났다고 보는 것입니다. SDK, 시뮬레이터 런타임, 시뮬레이터 기기는 서로 다른 확인 대상입니다. 런타임이 인식되더라도 프로젝트가 요구하는 기기 대상이 없거나, 선택한 Xcode와 호환되지 않을 수 있습니다.
여러 버전의 Xcode가 설치된 Mac에서는 다음을 차례로 확인합니다.
- 선택된 Xcode가 의도한 설치 경로인지 확인합니다.
- 릴리스 정보와 시스템 요구 사항에서 해당 도구 체인의 지원 범위를 확인합니다.
- 런타임 목록과 사용 가능한 기기 대상을 각각 확인합니다.
- 실제 프로젝트에서 빌드 또는 테스트를 실행합니다.
Apple의 Xcode 명령줄 도구 참고 자료에서 명령 옵션을 확인한 뒤, 대상 Mac에서 결과를 수집하세요.
xcrun simctl list runtimes
xcrun simctl list devices available
두 목록을 각각 확인하면 런타임이 보이지만 테스트에 쓸 기기가 없는 경우를 구별할 수 있습니다. 필요하다면 프로젝트의 실제 xcodebuild 테스트 명령을 실행하고 실패 로그를 보관하세요. 런타임 인식 결과와 프로젝트 테스트 결과가 함께 있어야 Runner의 준비 상태를 판단할 수 있습니다.
운영 담당자는 반입과 승인 절차를 기록합니다
다운로드 파일의 전달, 설치 권한, 불필요한 런타임 정리를 호스트 유지 관리 절차에 포함하세요. 출처를 확인하지 않은 파일을 운영 Runner에 설치하면 실패 원인을 추적하기 어렵습니다. 가져오기 오류와 기기 대상 누락은 같은 문제로 취급하지 마세요. 먼저 파일 상태, 선택된 Xcode, 런타임 목록, 기기 목록을 분리해 점검합니다.
아래 항목을 모두 확인한 뒤에만 해당 Runner의 테스트 준비가 끝난 것으로 판단하세요.
- [ ] 연결된 Mac에서 사용할 수 있는 플랫폼과 빌드 버전을 확인했습니다.
- [ ] 다운로드 파일의 출처와 적용할 Xcode를 기록했습니다.
- [ ] 대상 Mac에서 올바른 Xcode를 선택했습니다.
- [ ] 런타임 목록에서 필요한 항목을 확인했습니다.
- [ ] 기기 목록에서 프로젝트가 사용할 대상을 확인했습니다.
- [ ] 프로젝트의 실제 빌드 또는 테스트 결과와 실패 로그를 남겼습니다.
이 기록은 다른 Mac에 같은 구성요소를 배포할 때도 유용합니다. 다만 한 호스트에서 성공한 테스트를 모든 Runner의 호환성 보장으로 확대하지 마세요. 새 도구 체인 조합은 배포 전에 해당 환경에서 별도로 검증해야 합니다.
자주 확인하는 설치 및 검증 항목
Xcode 27.2 RC에서 iOS 시뮬레이터 런타임은 어떻게 받나요?
인터넷에 연결된 Mac에서 대상 Xcode를 선택하고, xcodebuild의 플랫폼 다운로드 명령을 사용합니다. 어떤 iOS 플랫폼 빌드를 받을 수 있는지는 명령 결과로 확인해야 합니다. 내려받기 전에 Apple의 추가 구성요소 안내를 확인하고, 다운로드 후에는 대상 Mac에서 가져오기와 프로젝트 테스트를 진행하세요.
인터넷이 없는 Mac에는 런타임을 어떻게 가져오나요?
연결된 Mac에서 런타임을 준비하고, 출처와 대상 Xcode를 기록한 뒤 관리 중인 전달 경로로 대상 Mac에 옮깁니다. 대상 Mac에서는 맞는 Xcode를 선택하고 공식 가져오기 절차를 실행합니다. 런타임 목록, 기기 목록, 프로젝트 테스트가 모두 기대한 결과인지 확인해야 합니다.
서로 다른 Xcode 버전에서 같은 런타임을 쓸 수 있나요?
항상 가능하다고 가정하지 마세요. 파일이 존재하는지와 선택된 Xcode가 그 런타임을 지원하는지는 다른 문제입니다. 해당 Xcode의 릴리스 정보와 시스템 요구 사항을 확인한 뒤, 실제 Mac에서 런타임 인식과 기기 대상 선택을 점검합니다. 결과가 불분명하면 여러 Runner에 배포하기 전에 별도 환경에서 검증하세요.
설치가 끝나면 CI에서도 바로 테스트할 수 있나요?
아닙니다. 선택된 Xcode가 런타임을 인식하는지, 프로젝트가 쓸 기기 대상이 있는지, 실제 빌드와 테스트가 완료되는지 확인해야 합니다. 설치 과정의 성공은 CI 작업의 성공을 보장하지 않습니다. 각 확인 결과와 오류 로그를 남겨 두면 Mac 간 차이를 추적할 수 있습니다.
반복해서 런타임을 내려받아야 하는 자체 Runner 방식은 네트워크 제한, Xcode 버전 불일치, 호스트별 유지 관리 부담을 함께 다뤄야 합니다. 원격 Mac을 사용하면 macOS 환경을 확보하면서도 장비 구매와 사내 Mac 호스트 관리를 피할 수 있지만, 장기간 일정한 고부하 작업이나 물리 연결 장치가 필요한 경우에는 직접 보유한 Mac이 더 적합할 수 있습니다. 테스트가 통과한 환경을 지속적으로 운영해야 한다면 DebugMac의 원격 Mac 환경을 살펴보고, macOS 개발 가이드에서 접속과 운영 방식을 확인해 보세요.
자주 묻는 질문
Xcode 27.2 RC에서 iOS 시뮬레이터 런타임은 어떻게 내려받나요?
인터넷에 연결된 Mac에서 대상 Xcode를 선택한 뒤, Apple 문서에 나온 xcodebuild의 플랫폼 다운로드 절차를 사용합니다. iOS 플랫폼과 실제로 내려받을 수 있는 빌드 버전을 확인하고, 필요한 경우 내보내기 경로를 지정합니다. 명령이 끝났다는 사실만으로 대상 Runner에서 쓸 수 있다고 판단하지 말고, 다운로드한 항목을 격리된 테스트 Mac에 가져와 확인합니다.
인터넷이 차단된 Mac에 시뮬레이터 런타임을 가져오려면 어떻게 하나요?
연결된 Mac에서 Apple이 지원하는 절차로 런타임을 내려받아 관리 가능한 저장소로 옮깁니다. 파일 출처와 적용 대상 Xcode를 기록하고, 대상 Mac에서 해당 Xcode를 선택한 뒤 공식 가져오기 명령을 사용합니다. 설치 후 런타임 목록과 사용 가능한 시뮬레이터 기기를 확인하고, 프로젝트 테스트까지 통과해야 오프라인 환경에서의 설치가 완료된 것으로 볼 수 있습니다.
서로 다른 Xcode 버전이 같은 시뮬레이터 런타임을 함께 쓸 수 있나요?
항상 함께 쓸 수 있다고 가정하면 안 됩니다. 런타임이 디스크에 보이는지와 선택된 Xcode가 해당 런타임을 지원하는지는 별개의 확인 항목입니다. Apple의 해당 Xcode 릴리스 정보와 시스템 요구 사항을 살펴보고, 실제 대상 Mac에서 런타임 인식 및 기기 대상 선택을 확인합니다. 호환 여부가 불분명하면 팀 전체에 배포하기 전에 별도 검증 환경에서 조합을 시험합니다.
시뮬레이터 런타임 설치가 끝나면 CI에서도 바로 쓸 수 있나요?
아닙니다. 설치된 런타임이 선택한 Xcode에서 인식되는지, 필요한 기기 대상이 사용 가능한지, 프로젝트가 그 대상을 지정해 빌드와 테스트를 완료하는지 각각 확인해야 합니다. xcodebuild 실행 로그와 시뮬레이터 목록을 보관하면 Runner 간 차이를 조사하기 쉽습니다. 실제 프로젝트 테스트가 실패한다면 런타임 설치 성공만으로 네트워크나 도구 체인 문제가 해결됐다고 결론 내리지 마세요.
시뮬레이터 설치 후 검증까지 이어가 보세요
DebugMac의 전용 물리 맥 노드에서 엑스코드 빌드와 시뮬레이터 검증을 진행할 수 있습니다.