iPhone Duo 시뮬레이터에서 앱 확장이 시작되지 않는다면 프로젝트 설정을 바꾸기 전에 Xcode 27.1 beta의 알려진 제한부터 확인해야 합니다. 이 글은 빌드와 설치, 확장 실행을 구분하고 대체 시뮬레이터와 실기기, 원격 맥에서 검증 결과를 기록하는 방법을 설명합니다.
iPhone Duo 시뮬레이터에서 앱 확장이 시작되지 않는다면 프로젝트 설정을 바꾸기 전에 Xcode 27.1 beta의 알려진 제한부터 확인해야 합니다. 이 글은 빌드와 설치, 확장 실행을 구분하고 대체 시뮬레이터와 실기기, 원격 맥에서 검증 결과를 기록하는 방법을 설명합니다.
iPhone Duo 시뮬레이터에서는 앱이 열리지만 Widget이나 공유 확장만 실행되지 않습니다.
가장 빠른 해결은 프로젝트를 바로 고치는 대신 Xcode 27.1 beta의 알려진 제한을 먼저 확인하는 것입니다. 주 앱의 레이아웃과 기기 자세는 iPhone Duo 시뮬레이터에서 확인하고, 앱 확장은 다른 적합한 시뮬레이터나 연결된 실기기에서 검증합니다. 결과도 각각 따로 기록해야 합니다.
이 글은 Widget, 공유 기능 등 앱 확장을 유지하는 iOS 독립 개발자, 원격 맥에서 테스트하는 개발자, 출시 전 검증을 맡은 소규모 팀을 위한 안내입니다.
마지막 업데이트: 2026년 9월 25일. Xcode 27.1 beta의 알려진 문제와 개발 환경 정보는 Apple의 Xcode 27.1 beta 출시 노트 및 Xcode 시스템 요구 사항을 기준으로 확인했습니다.
“확장이 작동하지 않는다”는 결과만으로는 원인을 좁힐 수 없습니다. 앱 빌드가 실패했는지, 앱과 확장이 설치되지 않았는지, 아니면 설치 후 확장 시작이나 호스트 앱에서의 호출이 실패했는지 먼저 나눠야 합니다.
Xcode 27.1 beta 출시 노트에는 대부분의 App Extension이 iPhone Duo 시뮬레이터에서 실행되거나 디버깅되지 않는 문제가 알려져 있다고 적혀 있습니다. 이는 해당 beta의 알려진 제한입니다. 모든 확장이나 이후 버전에도 같은 문제가 계속된다는 뜻은 아닙니다. 오류를 확인하기 전에 서명을 바꾸거나 프로젝트를 다시 만드는 것은 피하는 편이 좋습니다. 출시 노트의 문제 설명을 현재 사용 중인 버전과 대조하세요.
아래처럼 실패 지점을 기록하면 설정 오류와 시뮬레이터 제한을 구분하기 쉽습니다.
빌드가 성공했다는 사실만으로 확장 실행까지 검증된 것은 아닙니다. 빌드, 설치, 실행, 호스트 호출은 별도 항목으로 판정하세요.
iPhone Duo 시뮬레이터에서 확장이 시작되지 않는다면, 먼저 Xcode 27.1 beta의 제한에 해당하는지 확인합니다. Apple이 밝힌 범위는 “대부분의 앱 확장”이며, 특정 확장 하나의 실패만으로 서명이나 프로젝트 설정 문제라고 단정할 수 없습니다. 반대로 모든 확장이 반드시 실패한다고 확대 해석해서도 안 됩니다.
Xcode의 Scheme은 실행할 앱과 Target을 정하는 설정입니다. 현재 Scheme이 주 앱을 실행하도록 되어 있는지, 테스트하려는 확장 Target이 포함돼 있는지 확인하세요. Xcode의 빌드 Scheme과 Target 설정 안내를 참고할 수 있습니다.
판단을 위해 같은 확장을 다른 적합한 시뮬레이터에서도 실행해 보세요. 다른 대상에서는 동작하고 iPhone Duo에서만 실패한다면, beta의 알려진 제한과 일치하는지 살필 근거가 됩니다. 다른 대상에서도 빌드나 실행이 실패한다면 그때 오류 내용에 따라 프로젝트 구성, 서명 또는 호스트 호출 경로를 조사합니다.
iOS 시뮬레이터 확장 테스트에서는 한 환경에 모든 검증을 맡기기보다, 검증하려는 항목에 맞춰 대상을 나눠야 합니다. 아래 표는 주 앱의 표시 확인과 확장 동작 확인을 분리하기 위한 선택 기준입니다.
| 테스트 환경 | 잘 맞는 검증 | 한계와 주의점 | 적합도 |
|---|---|---|---|
| iPhone Duo 시뮬레이터 | 주 앱 레이아웃, 창 크기와 기기 자세 | Xcode 27.1 beta에서는 대부분의 앱 확장 실행 및 디버깅이 제한될 수 있음 | 주 앱 표시 확인에 높음 |
| 다른 적합한 시뮬레이터 | 지원되는 대상에서의 확장 시작과 호스트 호출 | 확장 종류와 대상 런타임에 따라 검증 가능 여부가 달라짐 | 반복 확인에 높음 |
| 연결된 실기기 | 실제 기기에서의 확장 동작, 하드웨어와 연관된 경로 | 기기 연결과 페어링이 필요하며 시뮬레이터 결과와 별도로 기록해야 함 | 실제 동작 확인에 높음 |
Apple은 앱을 시뮬레이터와 실제 기기에서 실행하는 방법을 안내합니다. 실행 대상 선택 안내를 확인한 뒤, 지원되는 대상에서 확장의 시작과 주요 상호작용을 시험하세요. 베타 운영체제와 호환성을 살펴보는 작업이라면 beta 운영체제 테스트 안내도 참고합니다.
실기기 검증이 필요하면 맥과 기기를 연결하고 페어링 상태를 확인합니다. 기기를 맥에 페어링하는 방법과 등록된 기기에서 앱을 테스트하는 안내를 기준으로 테스트 대상을 준비하세요.
아래 순서대로 진행하면 원인을 불필요하게 넓히지 않고 확인할 수 있습니다.
원격 맥에서도 iPhone Duo 시뮬레이터를 실행할 수 있는지는 맥의 macOS와 Xcode가 해당 도구의 시스템 요구 사항을 충족하는지, 필요한 시뮬레이터 런타임이 준비되어 있는지에 달려 있습니다. 접속 화면에서 다른 Xcode나 다른 실행 대상이 선택되면 도구 선택 오류를 시뮬레이터 제한으로 오해할 수 있습니다. Xcode의 시스템 요구 사항과 시뮬레이터 실행 조건은 앞서 안내한 Apple의 Xcode 시스템 요구 사항을 기준으로 확인하세요.
원격 접속이 beta의 앱 확장 제한을 없애 주지는 않습니다. Xcode와 실행 대상이 같다면 로컬 맥이든 원격 맥이든, iPhone Duo 시뮬레이터에서 확장을 검증하는 데 같은 제한이 적용될 수 있습니다. 실기기 테스트를 원격으로 진행할 때는 기기가 해당 맥에 연결되고 페어링돼 있는지도 따로 확인해야 합니다.
원격 맥을 반복 테스트에 사용한다면 접속한 뒤 Xcode 버전, 선택된 Scheme, 런타임, 실행 대상, 기기 연결 여부를 매번 기록하세요. 원격 맥 환경 선택 안내에서 테스트 목적에 맞는 환경을 살펴볼 수 있습니다. 한국에서 접속할 환경을 비교하려면 한국 원격 맥 이용 안내도 참고할 수 있습니다.
출시 여부를 판단할 때는 테스트 결과를 항목별로 분리합니다.
대체 대상에서 주요 확장 동작을 확인하고 남은 미검증 항목까지 공개한 경우에만 그 결과를 출시 판단에 반영하세요. beta의 알려진 제한 때문에 시험하지 못한 항목은 프로젝트가 정상이라고 추정하지 말고, 테스트 범위의 제한으로 보고해야 합니다. 정식 배포 전 빌드 확인이 필요하면 출시 빌드 테스트 안내를 참조하세요.
개발용 맥 한 대에서 주 앱과 확장 테스트를 모두 처리하면 저장 공간과 도구 버전 관리가 부담이 될 수 있고, 여러 사람이 쓰는 환경에서는 Scheme과 실행 대상이 바뀌어 재현이 어려워질 수 있습니다. 반대로 실제 기기 연결이 꼭 필요한 검증은 원격 환경만으로 끝낼 수 없습니다. 반복 가능한 별도 macOS 테스트 환경이 필요할 때는 VNCMac의 원격 맥을 검토하고, 실기기 연결이 필요한 항목은 연결 방식과 검증 범위를 먼저 확인하세요.