Xcode 빌드 에러: 'Could not locate device support files' (Using Xcodes)

최근에 Xcode를 사용하여 iOS 디바이스를 연결하고 빌드하려고 할 때, 아래와 같은 문제가 발생했습니다.

 

환경

• Xcode 버전: 16.2 (Xcodes 앱을 사용하여 설치)
• 디바이스 OS 버전: iOS 14.6

 

문제

디바이스를 케이블로 연결하고 빌드를 시도했으나, 아래와 같은 팝업 메시지가 나타나며 빌드가 실패했습니다.

 

Could not locate device support files
You may be able to resolve the issue by installing the latest version of Xcode from the Mac App Store or developer.apple.com.

 

원인

이 오류는 Xcode에 연결된 디바이스의 OS 버전에 대한 지원 파일이 없을 때 발생합니다. 이는 Xcode가 특정 iOS 버전에 대한 디바이스 지원 파일(Device Support Files)을 포함하지 않았기 때문입니다.

 

해결 방법

아래 단계를 따라 문제를 해결할 수 있습니다.

1. 필요한 파일 다운로드
   GitHub의 iOSDeviceSupport 저장소에서 디바이스의 OS 버전에 맞는 파일을 다운로드합니다.
   예: iOS 14.6을 사용하는 경우, 14.6.zip 파일을 다운로드합니다.
   
   
2. 압축 해제 및 파일 추가
   다운로드한 파일의 압축을 풀고, 아래 경로에 파일을 추가합니다:
   • ~는 사용자의 홈 디렉토리를 의미합니다.
   • 경로가 없으면 직접 폴더를 생성해야 할 수도 있습니다.
3. 아래 경로에 복사
   ~/Library/Developer/Xcode/iOS DeviceSupport/
   
   
4. Xcode 재시작
   Xcode를 종료한 뒤 다시 실행합니다. 디바이스를 다시 연결하고 빌드하면 문제가 해결됩니다.
   
   

참고 이미지

저의 경우에는 위 경로에 추가해주어 해결했습니다.

 

추가 팁

• Xcode 업데이트 고려:
  • 가급적 최신 버전의 Xcode를 사용하는 것이 가장 안정적입니다.
    하지만 현재 작업 환경이나 디바이스 OS 버전 때문에 특정 Xcode 버전을 유지해야 하는 경우,
    위와 같은 방법을 통해 임시로 문제를 해결할 수 있습니다.
• Xcodes 앱 활용:
  • Xcode 설치 및 관리를 편리하게 하기 위해 Xcodes 앱을 활용하는 것도 좋은 방법입니다.

 

---

Device Support Files가 필요한 이유

• 필요한 이유
  • Xcode는 연결된 디바이스의 운영체제를 이해하고 디버깅하기 위해 디바이스 지원 파일을 사용합니다.
    이러한 파일이 없으면 Xcode는 디바이스를 인식하지만 제대로 동작하지 않을 수 있습니다.
• 배경 정보
  • 새로운 iOS 버전이 출시될 때마다 Apple은 이 파일을 업데이트합니다.
    최신 Xcode에는 최신 디바이스 지원 파일이 포함되지만, 이전 버전의 Xcode에는 포함되지 않을 수 있습니다.

 

실수하기 쉬운 부분

• 정확한 경로에 추가되어야 합니다.
• 파일 또는 폴더 이름을 변경하지 않고 그대로 넣어야 Xcode가 내부적으로 정확히 매칭할 수 있기 때문에 잘못된 버전의 파일을 추가하지 않도록 주의합니다.