Device Hub에서 아이폰이 보이지 않거나, 페어링은 됐는데 앱이 실행되지 않나요?

가장 빠른 판단은 네트워크부터 확인하는 것입니다. 무선 페어링은 기기와 맥이 같은 Wi-Fi에서 서로 발견될 수 있어야 합니다. 인터넷 너머의 원격 맥에 바로 연결하는 기능으로 보면 안 됩니다.

이 안내는 Xcode 27로 아이폰, 아이패드, 애플 워치를 연결하는 개발자와 모바일 QA 담당자를 위한 절차입니다. 원격 맥이나 CI 노드의 실기기 연결을 승인해야 하는 엔지니어도 각 단계의 증거를 따라 판단할 수 있습니다.

마지막 업데이트: 2026년 10월 24일. Xcode 27과 Device Hub 조건은 Apple의 Xcode 27 출시 노트와 Device Hub 페어링 안내를 기준으로 확인했습니다.

시작 전: 실기기 연결과 시뮬레이터 테스트 구분

여기서 검수할 대상은 기기 발견, 페어링, 실제 앱 실행과 디버깅으로 이어지는 연결입니다. Device Hub에 기기가 표시되는지만 확인하는 것이 아니라, 앱이 기기에 설치되고 실행되는지까지 확인해야 합니다.

시뮬레이터는 맥에서 가상 기기를 실행하는 테스트 경로입니다. 실제 아이폰이나 아이패드와의 페어링, 기기 신뢰, 개발자 모드 상태를 대신 확인해 주지 않습니다. 원격 맥에 SSH나 화면 공유로 접속하는 것 역시 기기와 맥 사이의 무선 연결을 증명하지 않습니다.

Xcode 27의 대상 기기 및 네트워크 페어링 조건은 Apple의 공식 출시 노트와 기기 페어링 절차에서 확인하세요. 지원 여부는 설치된 Xcode와 각 기기의 운영체제 조합으로 검토해야 합니다.

준비 단계: 같은 Wi-Fi와 지원 조건 확인

먼저 실제로 실행 중인 Xcode 버전을 확인하고, 연결할 기기와 운영체제 버전, 목표 플랫폼을 기록하세요. 지원 조합은 추측하지 말고 Apple의 Xcode 시스템 요구 사항에서 대조합니다. Xcode의 표시 이름만으로 지원 조건을 판단하지 마세요.

그다음 맥과 기기가 서로 발견될 수 있는 Wi-Fi 환경인지 확인합니다. 회사나 테스트 시설의 네트워크가 기기 간 통신을 제한하는지, 게스트 Wi-Fi나 네트워크 분리 정책이 있는지도 담당자에게 확인하세요. 단, 발견 실패만으로 방화벽이나 특정 네트워크 장비를 원인으로 단정하지 마세요.

  • 검수할 맥과 기기의 운영체제 및 Xcode 버전을 기록합니다.
  • 맥과 기기가 같은 Wi-Fi에 연결되어 있는지 확인합니다.
  • 무선 발견이 되지 않을 때 비교할 유선 페어링 경로를 준비합니다.
  • 네트워크 변경이나 정책 예외가 있었다면 변경 시점과 결과를 함께 남깁니다.

이 정보가 없으면 무선 연결 실패와 버전 지원 문제를 구분하기 어렵습니다. 화면 공유가 된다는 사실만으로 기기와 맥이 서로 발견될 것이라고 가정하지 마세요.

페어링 단계: 기기 승인과 개발자 모드까지 완료

Device Hub에서 주변 기기를 선택하고, 화면에 나타나는 안내에 따라 페어링을 진행합니다. 기기 화면에서 신뢰나 연결을 확인하라는 요청이 나오면 해당 승인까지 마쳐야 합니다. 페어링 중 표시된 오류와 기기 쪽 안내는 별도로 기록하세요.

실기기 개발에는 페어링 외에도 기기에서 요구하는 개발자 모드 확인이 필요할 수 있습니다. 설정을 변경한 뒤 재시작과 추가 확인이 요구되면 기기에서 절차를 완료하세요. Apple의 개발자 모드 안내를 기준으로 확인하며, 이 단계를 끝내지 못한 상태를 곧바로 Xcode 결함으로 분류하지 않습니다.

주의: Device Hub 목록에 기기가 나타난 것은 발견과 페어링의 일부 증거일 뿐입니다. 앱 서명, 프로비저닝, 설치와 디버깅이 성공했다는 뜻은 아닙니다.

무선 발견이 실패하면 네트워크 조건을 재확인하고, 공식 안내에 맞춰 유선 페어링도 시험합니다. 유선에서는 되지만 무선에서만 실패한다면 두 경로의 결과와 네트워크 조건을 분리해 기록하세요. 근거 없이 원인을 특정하는 대신 재현 가능한 오류를 남기는 것이 다음 조치에 도움이 됩니다.

FAQ: 목록 표시와 원격 접속을 같은 뜻으로 보지 않기

무선 페어링에는 어떤 네트워크 조건이 필요한가요?
맥과 기기가 같은 Wi-Fi 네트워크에서 서로 발견될 수 있어야 합니다. 단순히 둘 다 인터넷에 연결되어 있는 것만으로는 충분하지 않습니다. 게스트 네트워크나 기기 간 통신 제한 여부를 확인하고, 실패하면 유선 경로로 비교하세요. 원인이 확인되지 않았다면 네트워크 장비 문제라고 단정하지 말고 오류를 보존하세요.

아이폰이 Device Hub에 표시되지 않을 때 어디서부터 확인하나요?
실행 중인 Xcode와 기기 운영체제의 지원 조합, 맥과 기기의 Wi-Fi 연결, 서로 발견 가능한 네트워크인지부터 확인합니다. 그다음 유선 페어링으로 기기 승인 절차가 가능한지 비교하세요. 이 단계에서 기기가 보이지 않는 현상은 앱 서명 오류와 구분해야 합니다. 각 화면의 오류를 따로 기록하면 원인을 잘못 분류할 가능성이 줄어듭니다.

페어링이 됐어도 개발자 모드 확인이 필요한가요?
기기에서 개발자 모드를 요구한다면 해당 설정과 뒤따르는 재시작 및 기기 확인까지 마쳐야 합니다. 페어링 완료와 개발자 모드 완료는 같은 상태가 아닙니다. 기기에서 보이는 상태, Xcode 실행 결과, 앱 설치 여부를 각각 확인하세요. 승인이나 재시작이 끝나지 않았다면 이를 먼저 처리한 뒤 다시 실행해야 합니다.

SSH로 원격 맥에 접속할 수 있으면 무선 디버깅도 가능한가요?
SSH 연결은 맥에 접속할 수 있다는 뜻일 뿐, 맥과 테스트 기기가 같은 Wi-Fi에서 서로 발견될 수 있다는 증거는 아닙니다. 원격 맥에서 실기기를 쓰려면 실제 호스트와 기기 사이의 네트워크 조건 및 페어링 경로를 따로 확인해야 합니다. 조건을 검증할 수 없다면 로컬 맥에서 실기기를 연결하고 원격 환경은 별도의 빌드나 시뮬레이터 작업에 사용하세요.

실행 단계: 페어링 이후 실제 앱으로 디버깅

Xcode에서 프로젝트의 대상 구성표를 선택하고, 실행 대상으로 페어링된 실제 기기를 지정합니다. 기기가 목록에 있는지 확인하는 데서 끝내지 말고 빌드, 설치, 앱 실행, 디버깅 세션까지 확인하세요. Apple의 실제 기기 및 시뮬레이터 실행 안내는 실행 대상 선택과 실제 기기 테스트의 공식 기준입니다.

실행 실패는 단계별로 나눠 봅니다.

  • 기기를 선택할 수 없다면 발견과 페어링 상태를 확인합니다.
  • 실행 전에 기기 승인이 요구되면 기기 화면에서 필요한 절차를 완료합니다.
  • 빌드는 되지만 설치나 실행이 실패하면 서명 및 프로비저닝 조건을 확인합니다.
  • 앱이 실행된 뒤 디버깅이 끊기면 기기 연결과 디버그 세션의 상태를 따로 기록합니다.

서명 문제를 페어링 문제로 오인하지 않도록 Apple의 코드 서명 및 프로비저닝 프로파일 설명을 대조하세요. 계정에 등록되지 않은 기기가 필요한 흐름이라면 단일 기기 등록 절차도 확인합니다. 등록 여부와 실제 무선 발견은 별개의 확인 항목입니다.

기록에는 빌드 결과, 기기에 표시된 앱 상태, Xcode의 오류 메시지, 사용한 실행 대상을 포함하세요. 그래야 다음 실행에서 환경 변화와 프로젝트 변경을 구별할 수 있습니다.

연결 복구 단계: 맥 접속 복구와 기기 복구를 따로 시험

무선 연결이 잠시 끊겼을 때 기기가 Device Hub에 다시 보이는지 확인하고, 필요하면 페어링 절차를 다시 진행합니다. 이어서 앱 실행과 디버깅 세션을 별도로 재개해 보세요. 기기가 다시 나타나는 것과 중단된 빌드나 디버그 작업이 복구되는 것은 서로 다른 결과입니다.

원격 맥을 사용한다면 SSH 접속 가능 여부와 기기 무선 연결 가능 여부를 각각 검증해야 합니다. 원격 데스크톱이 열리거나 셸 명령이 실행된다는 이유로 실기기 연결을 승인하지 마세요. 같은 Wi-Fi에서 발견되는 조건을 확인할 수 없으면 로컬 맥에서 기기를 연결하는 방식으로 전환하거나, 실기기 검증과 원격 빌드를 분리하세요.

최종 승인: 세 가지 실행 경로를 증거로 비교

아래 표는 연결 조건과 검수 목적에 따라 작업 위치를 선택하는 기준입니다. 원격 맥의 실제 네트워크 구성이나 기기 연결 지원 여부는 이 글만으로 확인할 수 없으므로, 확인되지 않은 경로를 사용 가능하다고 간주하지 마세요.

선택지 확인할 조건 적합한 작업 승인 기준
로컬 맥과 실기기 같은 Wi-Fi에서 기기 발견, 페어링, 기기 승인 가능 실제 기기 설치와 디버깅 앱 설치와 실행, 디버깅 세션까지 확인
원격 맥과 실기기 호스트와 기기의 실제 네트워크 경로 및 페어링 조건을 확인할 수 있음 원격 호스트에서 실기기 검증 원격 접속과 별개로 페어링부터 재실행까지 확인
맥 시뮬레이터 필요한 시뮬레이터 실행 환경을 준비할 수 있음 인터페이스 및 자동화 테스트 일부 시뮬레이터 결과만으로 실기기 승인을 대체하지 않음

다음 표에 검수 증거를 남기면 테스트 담당자와 플랫폼 담당자가 같은 기준으로 결과를 검토할 수 있습니다.

검수 항목 통과로 기록할 증거 통과로 볼 수 없는 증거
버전과 대상 Xcode와 기기 운영체제, 목표 플랫폼 기록 기기 이름만 확인
네트워크 발견 맥과 기기의 실제 Wi-Fi 조건 및 발견 결과 두 장치 모두 인터넷 사용 가능
페어링과 승인 Device Hub 상태와 기기 화면의 승인 완료 목록에 기기가 잠시 표시됨
앱 실행 실제 기기에 설치하고 실행한 결과 빌드 성공 또는 시뮬레이터 실행
연결 복구 재연결 후 기기와 앱 실행을 각각 확인 SSH 세션만 다시 연결됨
실행 경로 장점 주의할 제약 선택 기준
로컬 실기기 검수 기기와 맥의 연결 상태를 직접 확인 가능 로컬 맥과 기기를 준비해야 함 무선 실기기 검수가 필수라면 우선 검토
원격 맥 실기기 검수 원격 환경에서 실제 기기 실행을 검증할 수 있음 네트워크 발견과 연결 조건이 확인되어야 함 호스트와 기기 사이의 실제 경로를 입증할 수 있을 때만 승인
시뮬레이터 중심 CI 실제 기기 연결 없이 자동화할 수 있는 테스트에 활용 가능 기기별 동작과 실제 연결을 증명하지 못함 실기기 검수를 별도 단계로 유지할 때 선택

검수 결과에는 Xcode와 기기 운영체제, 네트워크 토폴로지, 페어링 방식, 기기 승인 상태, 앱 실행 결과, 연결 중단 뒤 복구 여부를 함께 남기세요. 실기기 테스트가 필수인 작업은 시뮬레이터 통과만으로 승인하지 마세요. 네트워크 조건이 불명확하면 먼저 로컬 실기기 검수를 수행하고, 원격 맥에서는 확인된 범위의 빌드나 시뮬레이터 작업만 맡기는 편이 안전합니다.

원격 맥은 기기를 직접 연결할 수 있는 네트워크 조건을 검증하지 못하면 실기기 무선 디버깅의 대체재가 아닙니다. 반대로 장기간 고정된 실기기 연결과 안정적인 네트워크가 늘 필요하다면 직접 보유한 맥과 기기를 운영하는 편이 더 적합할 수 있습니다. 로컬 환경이 부족하고 일시적인 원격 개발 환경이 필요하다면 VMSPIN의 원격 맥 이용 방식과 요금 안내을 먼저 확인한 뒤, 실제 호스트 접속 방식과 기기 네트워크 조건이 맞는지 판단하세요. 해당 조건이 확인되지 않은 상태에서는 원격 실기기 연결을 전제로 계획하지 마세요.