앱 파일을 Device Hub에 끌어 놓았는데 설치된 건지, 링크가 열린 건지 헷갈리시나요?
빠른 해결: Xcode 27.3 Beta에서는 대상 기기를 먼저 선택한 뒤 .app이나 .ipa를 끌어 놓아 설치하고, 링크는 기기에서 엽니다. 설치 후에는 실행과 주요 기능까지 따로 확인합니다. Apple의 Xcode 27.3 Beta 릴리스 노트에 안내된 동작을 기준으로 정리했습니다.
이 글은 다음 개발자에게 적합합니다. Xcode 27.3 Beta에서 빌드 산출물을 설치하려는 독립 개발자와, 등록된 기기에서 .ipa를 확인하려는 작은 팀을 대상으로 합니다. 원격 맥에서 작업하려는 경우에도 실제 대상 기기 연결과 검증 환경을 따져볼 수 있습니다.
기능 확인 시점: 2026년 11월 10일. 동작은 Apple의 Xcode 27.3 Beta 릴리스 노트와 Xcode 시스템 요구 사항을 기준으로 확인했습니다. 베타 기능은 정식 버전에서 달라질 수 있으므로 작업 전 최신 문서를 다시 확인하세요.
Xcode 27.3 Beta Device Hub의 드래그 동작은 파일 종류와 대상에 따라 달라집니다
핵심은 드롭한 항목의 종류와 선택한 대상입니다. .app과 .ipa는 설치 대상이고, 링크는 기기에서 여는 주소입니다. 시뮬레이터에 일반 파일을 끌어 놓으면 앱 설치가 아니라 파일 앱에 저장될 수 있습니다. 릴리스 노트에 안내된 동작을 기준으로 목적을 먼저 구분하세요.
| 드롭하는 항목 | 대상과 결과 | 먼저 확인할 점 |
|---|---|---|
.app |
선택한 시뮬레이터 또는 지원되는 기기에 앱 설치 | 빌드가 대상 기기에 맞는지 확인 |
.ipa |
앱 설치 작업 시작 | 내보내기 방식, 서명, 기기 등록 조건 확인 |
| 링크 | 선택한 기기에서 주소 열기 | 예상한 페이지에 도달하는지 확인 |
| 일반 파일 | iOS 시뮬레이터에서는 파일 앱에 저장될 수 있음 | 실제 기기에서도 같은 결과라고 가정하지 않기 |
이 표는 지원 동작을 설명한 것이며, 모든 앱 파일이 모든 대상에서 설치된다는 뜻은 아닙니다. 특히 파일을 놓을 수 있는지와 그 파일을 실제로 실행할 수 있는지는 별개의 판단입니다.
시뮬레이터에서는 선택한 대상과 빌드 종류를 먼저 맞춥니다
시뮬레이터에 .app 또는 .ipa를 설치할 때는 Device Hub에서 대상 시뮬레이터를 선택한 뒤 파일을 놓습니다. 대상 선택을 놓치면 의도한 시뮬레이터에 설치했는지부터 불분명해집니다. 앱이 대상 환경에 맞게 빌드되었는지도 확인해야 합니다. Apple의 앱 빌드 및 실행 안내는 시뮬레이터와 실제 기기에서 앱을 실행하는 흐름을 설명합니다.
| 확인 단계 | 확인할 증거 | 통과로 단정할 수 없는 항목 |
|---|---|---|
| 설치 | 시뮬레이터 홈 화면에 앱이 표시됨 | 앱이 정상 실행된다는 보장 |
| 실행 | 앱이 열리고 첫 화면까지 도달함 | 로그인, 네트워크, 저장 기능 등 전체 동작 |
| 기능 점검 | 대표 사용자 흐름을 직접 수행함 | 다른 기기나 배포 환경에서의 결과 |
필요하면 명령줄에서도 부팅된 시뮬레이터와 앱 설치 상태를 확인할 수 있습니다. 아래는 경로와 앱 식별자를 실제 환경 값으로 바꿔 실행하는 예입니다.
xcrun simctl list devices booted
xcrun simctl install booted /경로/Example.app
xcrun simctl launch booted com.example.app
출력에서 부팅된 대상이 의도한 시뮬레이터인지 확인하고, 실행 명령이 앱 식별자를 찾는지 살펴봅니다. 이 확인은 Device Hub의 드래그 설치를 대신하는 설명이 아니라 설치와 실행 결과를 추가로 점검하는 방법입니다.
등록된 기기의 .ipa는 파일보다 배포 조건을 먼저 확인합니다
이미 내보낸 iOS .ipa를 테스트 기기에 설치하려면, 먼저 해당 기기가 배포 대상에 맞게 등록되어 있는지 확인합니다. 이어서 내보내기 방식과 서명 및 프로비저닝 설정이 해당 기기와 맞는지 검토합니다. Apple의 등록 기기용 앱 배포 안내와 기기 등록 설명을 함께 확인하면 등록 조건을 분리해 점검하기 쉽습니다.
| 확인 항목 | 점검 내용 | 설치 뒤 확인 |
|---|---|---|
| 대상 기기 | 배포에 필요한 기기 등록이 되어 있는지 확인 | 설치 작업이 대상 기기에서 끝났는지 확인 |
| 내보낸 파일 | 선택한 배포 방식이 테스트 목적과 맞는지 확인 | 실제 앱이 기기에 표시되는지 확인 |
| 서명과 프로파일 | 앱과 대상 기기 조건이 일치하는지 확인 | 앱을 열고 시작 화면까지 진행 |
| 개발용 기기 설정 | 필요하면 Developer Mode 설정 절차를 확인 | 실제 테스트가 가능한 상태인지 점검 |
설치 성공은 서명이 모든 테스트 조건을 통과했거나 기능 시험과 배포 검수가 끝났다는 뜻이 아닙니다. 설치 여부, 실행 여부, 주요 기능 검증을 서로 다른 결과로 기록하세요.
주의: Developer Mode는 실제 기기에서 개발용 앱을 시험할 때 확인해야 하는 설정입니다. 적용 대상과 활성화 방법은 Apple의 안내를 따르고, 설치 메시지만으로 기기의 개발 설정까지 확인되었다고 보지 마세요.
링크와 일반 파일은 설치 시나리오에서 분리합니다
Device Hub에 링크를 끌어 놓는 동작은 해당 기기에서 주소를 여는 것입니다. 페이지가 열렸는지, 예상한 화면에 도착했는지를 확인하면 링크 전달 결과를 검토할 수 있습니다. 이것만으로 유니버설 링크나 딥 링크가 앱 설치 상태와 여러 실행 경로에서 모두 검증된 것은 아닙니다.
시뮬레이터에서 앱 설치 파일이 아닌 항목을 끌어 놓으면 파일 앱에 저장될 수 있습니다. 파일이 예상 위치에 나타나는지 확인하세요. 이 결과를 실제 기기의 파일 처리 방식에 그대로 적용해서는 안 됩니다. Apple 릴리스 노트가 설명하는 시뮬레이터 동작과 실제 기기 동작은 따로 검증해야 합니다.
자주 찾는 설치 기준
시뮬레이터에 .app을 설치할 때 먼저 할 일은 무엇인가요?
Device Hub에서 대상 시뮬레이터를 선택하고, 그 환경에 맞는 빌드인지 확인합니다. .app을 놓은 뒤 홈 화면 표시와 실행을 각각 살펴보고, 대표 기능도 직접 시험합니다. 아이콘 표시만 확인하고 검증을 끝내지 않습니다.
이미 내보낸 .ipa도 Device Hub로 설치할 수 있나요?
릴리스 노트는 .ipa를 Device Hub에 끌어 놓아 설치하는 동작을 안내합니다. 다만 등록 기기 여부와 내보내기 방식, 서명 및 프로비저닝 설정이 맞아야 합니다. 설치가 끝난 뒤 앱이 실제로 열리는지도 별도로 확인합니다.
설치됐는데 앱이 실행되지 않으면 무엇을 확인하나요?
대상 기기에 맞는 빌드인지 확인하고, 등록 기기용 배포 조건과 서명 구성을 점검합니다. 개발용 앱을 시험하는 실제 기기라면 Developer Mode도 확인합니다. 이후 앱을 직접 열어 실패 단계와 로그를 기록합니다.
링크와 일반 파일을 끌어 놓으면 앱이 설치되나요?
링크는 대상 기기에서 열리고, 일반 파일은 시뮬레이터에서 파일 앱에 저장될 수 있습니다. 둘 다 앱 설치와 다른 결과입니다. 링크가 열린 것만으로 앱 링크 설정을 검증했다고 볼 수 없으며, 시뮬레이터의 파일 처리 결과로 실제 기기 동작을 추정해서도 안 됩니다.
원격 맥을 쓰기 전에는 실제 검증 경로를 대조합니다
원격 맥은 Xcode 작업 환경을 제공할 수 있지만, Device Hub에서 대상 기기를 실제로 연결하고 조작할 수 있는지는 선택한 환경과 작업 방식에 따라 확인해야 합니다. 기기 연결 방식, 파일 전달 경로, 설치 결과를 남길 방법이 필요한 테스트에 맞는지 먼저 살펴보세요. Xcode 시스템 요구 사항도 작업에 사용할 Xcode와 맥 환경을 대조하는 기준으로 활용할 수 있습니다.
로컬 맥은 직접 연결할 장비가 있거나 물리 인터페이스 접근이 중요한 테스트에 유리합니다. 반면 별도 장비 비용과 상시 실행 환경을 직접 관리해야 할 수 있습니다. 원격 맥은 구매 없이 필요한 기간 동안 환경을 사용할 수 있지만, 실제 기기 연결을 확인하지 않은 채 전체 배포 과정을 옮기면 연결과 파일 전달에서 막힐 수 있고, 원격 조작에는 네트워크 지연도 따릅니다.
한국에서 사용할 원격 맥 환경과 이용 조건을 확인하려면 서울 맥 미니 이용 안내도 참고할 수 있습니다. 원격에서 Xcode 작업을 이어갈 환경이 필요하다면 NodeMini 맥 미니 이용 안내를 살펴보고, 실제 기기 연결이 필수인 경우에는 필요한 연결 방식이 지원되는지 확인한 뒤 결정하세요. 전용 장비를 장기간 상시 운영하거나 물리 연결을 반드시 직접 관리해야 한다면 로컬 맥이 더 적합할 수 있습니다.