시뮬레이터를 눌러도 반응이 없거나, 기기가 켜진 뒤 앱이 멈추나요?
Xcode를 다시 설치하기 전에 macOS 호환성, Simulator runtime 설치 여부, 프로젝트 문제 순서로 확인하세요. 원인을 나누면 불필요한 초기화를 피하고 다음 조치를 고를 수 있습니다.
Xcode 27로 Swift나 iOS 개발을 공부하다 시뮬레이터가 열리지 않는 학생을 위한 안내입니다.
수업 프로젝트가 실행되지 않는 초보자는 문제가 환경과 프로젝트 중 어디에 있는지 확인할 수 있습니다.
사용 중인 기기가 요구 조건을 충족하지 못할 때 살펴볼 대안도 설명합니다.
마지막 업데이트: 2026년 10월 15일. 호환성과 구성 요소 안내는 Apple의 Xcode 시스템 요구 사항, 구성 요소 설치 안내, Xcode 27 출시 노트를 기준으로 확인해야 합니다. 세부 요구 사항과 알려진 문제는 업데이트에 따라 달라질 수 있습니다.
먼저 확인할 오류 단계
시뮬레이터는 실제 아이폰이 아니라, 맥 안에서 앱을 시험하는 가상 기기입니다. 따라서 앱이 안 보인다는 증상만으로 시뮬레이터 자체가 고장 났다고 단정하면 안 됩니다. Xcode가 열리지 않는 경우, 가상 기기가 시작되지 않는 경우, 앱 설치나 실행이 실패하는 경우는 원인이 다를 수 있습니다.
Xcode 27 시뮬레이터가 열리지 않을 때 무엇부터 살펴보나요?
먼저 Xcode와 macOS 버전을 확인하고, 사용하려는 플랫폼과 시스템 버전의 Simulator runtime이 설치되어 있는지 살펴봅니다. 그다음 시뮬레이터 앱, 가상 기기, 프로젝트 가운데 어디서 멈추는지 기록합니다. 처음부터 Xcode를 지우거나 프로젝트를 초기화하지 마세요.
터미널에서 버전을 확인할 수 있습니다.
xcodebuild -version
sw_vers
두 명령의 출력에서 Xcode 버전과 macOS 제품 버전을 확인합니다. 결과를 과제 게시판이나 지원 요청에 공유할 때는 계정 이름처럼 불필요한 개인정보를 지우세요. Apple은 Xcode별 운영 체제 요구 사항을 시스템 요구 사항 페이지에 안내합니다. 실제 설치 버전과 해당 페이지에 적힌 조건을 대조하세요.
| 보이는 증상 | 먼저 확인할 항목 | 다음 판단 |
|---|---|---|
| Xcode가 열리지 않거나 실행 직후 종료됨 | macOS와 Xcode의 호환성 | 요구 조건을 충족하는지 공식 안내에서 확인 |
| 가상 기기 목록에 원하는 기기가 없음 | 플랫폼과 Simulator runtime 설치 상태 | 구성 요소 다운로드가 끝났는지 확인 |
| 기기는 켜지지만 앱이 설치되지 않음 | 프로젝트의 실행 대상과 대상 시스템 버전 | 빌드, 설치, 시작 중 실패 단계 확인 |
| 업데이트 뒤 기존 기기가 시작되지 않음 | 런타임 사용 가능 여부와 기기 상태 | 재시작 후에도 실패하는지 분리해 기록 |
Xcode가 지원하지 않는 macOS에서 실행되는 경우, 시뮬레이터 구성 요소를 다시 받아도 호환성 문제가 해결된다고 볼 수 없습니다. 먼저 Apple의 Xcode 시스템 요구 사항에서 현재 버전에 해당하는 항목을 확인하세요. 구체적인 요구 버전은 공식 페이지와 설치된 Xcode 버전을 기준으로 판단해야 합니다.
macOS 호환성과 실행 구성 요소
시뮬레이터 기기는 시험에 사용할 가상 아이폰 같은 기기 설정이고, Simulator runtime은 그 기기에서 앱을 실행할 운영 체제 구성 요소입니다. 기기 항목이 보인다고 해서 필요한 runtime까지 설치되었다는 뜻은 아닙니다.
Xcode 27에 iOS 시뮬레이터 실행 환경이 없으면 어떻게 하나요?
Xcode 설정에서 플랫폼 또는 구성 요소 관리 화면을 열어 필요한 iOS 버전의 설치 상태를 확인합니다. 목록에 없거나 다운로드가 진행 중이라면 완료될 때까지 기다린 뒤 다시 시도하세요. Apple의 추가 Xcode 구성 요소 다운로드 및 설치 안내는 구성 요소를 확인하고 설치하는 방법을 설명합니다.
구성 요소가 준비되지 않은 동안에는 프로젝트가 빌드되더라도 선택한 가상 기기에서 실행하지 못할 수 있습니다. 다운로드가 끝나지 않은 상태와 설치가 완료된 상태를 구별하세요. 추가 시뮬레이터를 관리하는 과정은 Apple의 시뮬레이터 추가 및 관리 안내에서도 확인할 수 있습니다.
| 확인 위치 | 확인할 내용 | 확인 결과에 따른 조치 |
|---|---|---|
| Xcode 버전 정보와 macOS 버전 | 현재 조합이 공식 요구 사항에 맞는지 | 조건이 맞지 않으면 구성 요소 재설치보다 환경 호환성을 먼저 해결 |
| Xcode의 플랫폼 또는 구성 요소 관리 화면 | 필요한 플랫폼과 Simulator runtime이 설치되었는지 | 없거나 진행 중이면 설치 완료를 기다린 뒤 재확인 |
| 프로젝트의 실행 대상 | 선택한 기기와 시스템 버전이 설치된 항목과 일치하는지 | 일치하지 않으면 사용 가능한 실행 대상으로 변경 |
시뮬레이터 기기 시작 문제
설치된 runtime이 있어도 가상 기기가 멈추거나 시작되지 않을 수 있습니다. 위험이 적은 조치부터 적용하세요. 먼저 사용하지 않는 시뮬레이터 창과 앱을 닫고, 해당 기기를 종료한 뒤 다시 시작합니다. 그래도 그대로라면 맥을 재시동하고 문제가 반복되는지 확인합니다.
macOS나 Xcode를 업데이트한 뒤 시작 오류가 생겼다면 어떻게 구분하나요?
업데이트 후에는 기존 기기와 runtime이 계속 사용 가능한지부터 확인합니다. Xcode의 구성 요소 관리 화면에서 필요한 항목이 남아 있는지 살펴보고, 해당 기기를 다시 시작해 봅니다. 업데이트가 원인이라고 바로 단정하지 말고, Xcode 27의 공식 출시 노트에서 해당 버전의 변경 사항과 알려진 문제를 확인하세요.
기기를 재시작하거나 상태를 초기화해야 한다면 무엇이 지워지는지 먼저 확인하세요. 특히 프로젝트 파일과 소스 코드는 프로젝트 폴더에 보관하고, 시뮬레이터 기기 삭제를 프로젝트 삭제와 혼동하지 마세요. Apple의 시뮬레이터 기기 환경 재시작 및 초기화 안내에 따라 조치를 고르고, 필요한 경우에만 초기화를 검토하세요.
기기는 켜지지만 프로젝트가 실행되지 않는 경우
가상 기기 화면이 열린다는 것은 시뮬레이터 시작 단계는 통과했을 가능성이 있다는 뜻입니다. 앱이 빌드되지 않는지, 빌드는 되지만 설치되지 않는지, 설치 뒤 실행 중 종료되는지 구분해야 합니다. Apple의 시뮬레이터 또는 실제 기기에서 앱 실행 안내를 참고해 실행 대상을 확인하세요.
시뮬레이터가 켜져 있는데 프로젝트가 실행되지 않으면 무엇을 확인하나요?
Xcode에서 선택한 실행 대상과 프로젝트가 요구하는 대상 시스템 버전을 대조합니다. 설치된 runtime이 그 버전을 지원하는지도 확인하세요. 빌드 오류라면 오류 메시지를 우선 읽고, 설치 오류라면 기기와 앱의 대상 조건을 살펴봅니다. 시작 직후 종료된다면 실행 단계의 로그를 기록합니다. 시뮬레이터 초기화는 이 확인을 마친 뒤에도 기기 상태가 원인일 때만 고려하세요.
원인 위치를 분리할 때 다음 항목을 하나씩 확인하면 됩니다.
- [ ]
xcodebuild -version으로 현재 Xcode 버전을 기록합니다. - [ ]
sw_vers로 현재 macOS 버전을 기록합니다. - [ ] 공식 시스템 요구 사항에서 두 버전의 호환 여부를 확인합니다.
- [ ] Xcode 설정에서 필요한 플랫폼과 Simulator runtime의 설치 상태를 확인합니다.
- [ ] 실패가 빌드, 앱 설치, 앱 시작 중 어느 단계에서 발생하는지 기록합니다.
- [ ] 재시작이나 초기화를 했다면 적용한 조치와 결과를 함께 적습니다.
다음 환경 선택과 문제 전달
사용 중인 맥이 Xcode 27의 요구 조건을 충족하지 못하면, 같은 환경에서 runtime을 반복 설치하는 것으로 해결되지 않을 수 있습니다. 먼저 이용 가능한 맥, 학교나 지인의 기기, 원격 맥을 비교하세요. 과제에 필요한 Xcode와 runtime을 실제로 설치할 수 있는지, 접속 방식이 수업 작업에 맞는지 확인해야 합니다.
| 선택지 | 확인할 조건 | 적합할 수 있는 상황 |
|---|---|---|
| 현재 사용 중인 맥 | Xcode와 macOS의 공식 호환 조건 | 요구 조건을 충족하고 저장 공간 등 필요한 환경을 확보할 수 있는 경우 |
| 빌리거나 학교에서 이용하는 맥 | 이용 가능한 시간과 계정 권한, 프로젝트 저장 방식 | 짧은 실습이나 제한된 기간의 과제 |
| 원격 맥 환경 | 실제 제공되는 운영 체제와 Xcode 사용 가능 여부, 접속 방식 | 보유 기기가 조건을 충족하지 못하고 원격 환경이 과제 요구에 맞는 경우 |
원격 환경이 있다고 해서 모든 Xcode 문제를 해결하는 것은 아닙니다. 이용 전에 필요한 Xcode 버전과 runtime을 설치할 수 있는지, 프로젝트 파일을 옮길 수 있는지 확인하세요. 환경 선택을 더 살펴보려면 맥 이용 방식 비교 안내를 확인하고, 실제 사용 가능 여부는 한국어 환경 안내에서 조건을 대조할 수 있습니다.
지원 요청을 보낼 때는 Xcode와 macOS 버전, 화면에 표시된 오류 문구, 실패한 단계, 이미 시도한 조치를 함께 적으세요. 추가 버전별 안내가 필요하면 Xcode 27.1 출시 후보 버전 노트도 참고할 수 있습니다. 출시 후보 정보는 설치된 정식 버전의 동작을 보장하는 자료가 아니므로, 현재 사용 중인 버전과 구분해서 읽어야 합니다.
현재 기기에서 계속 시도하면 macOS 호환성, runtime 설치 상태, 접근 권한을 직접 해결해야 하고, 학교 기기를 빌리면 이용 시간과 계정 설정이 제약이 될 수 있습니다. 반면 원격 맥은 실제 제공 환경이 수업에 필요한 조건을 만족할 때 대안이 됩니다. 아직 맥이 없고 과제 기간에만 Xcode 환경이 필요하다면 OnceMac의 이용 조건을 확인해 보세요. 필요한 버전과 실행 구성을 확인한 뒤 선택하면, 해결되지 않는 문제를 무작정 초기화하는 대신 적합한 환경에서 연습을 이어갈 수 있습니다.
시뮬레이터 점검을 이어갈 전용 개발 환경을 마련해 보세요
OnceMac은 주문마다 독립된 물리 노드를 제공해 다른 고객과 연산 자원과 저장 공간을 나누지 않고 사용할 수 있습니다.
