시뮬레이터 빌드가 “building for iOS Simulator but linking in object file built for iOS, for architecture arm64” 오류로 멈춥니다.
가장 빠른 해결은 오류에 표시된 라이브러리에 시뮬레이터용 플랫폼 슬라이스가 있는지 확인한 뒤, 지원되는 XCFramework로 갱신하거나 다시 빌드하는 것입니다.

이 글은 Apple silicon으로 옮긴 뒤 시뮬레이터 링크 오류를 만난 iOS 개발자를 위한 내용입니다.
미리 빌드된 라이브러리나 타사 SDK를 사용하는 엔지니어, XCFramework 산출물을 관리하는 빌드 담당자도 확인할 수 있습니다.

iOS 시뮬레이터 빌드 중 iOS arm64 링크 오류의 뜻

오류 문구에 나온 Simulator, iOS, arm64는 서로 다른 정보를 가리킵니다. Simulator는 현재 빌드 목적지, iOS는 링크하려는 오브젝트 파일이 만들어진 플랫폼, arm64는 바이너리의 CPU 아키텍처입니다. 따라서 arm64가 표시됐다는 이유만으로 “시뮬레이터가 arm64를 지원하지 않는다”고 판단하면 원인을 잘못 짚을 수 있습니다.

Apple silicon에서 실행하는 시뮬레이터도 arm64를 사용할 수 있습니다. 핵심은 라이브러리에 arm64가 있느냐만이 아니라, 해당 바이너리가 iOS 시뮬레이터를 대상으로 만들어졌느냐입니다. Apple은 Apple silicon에서 발생하는 아키텍처 빌드 오류와 대응 방법에서 미리 빌드된 라이브러리에 시뮬레이터용 아키텍처 슬라이스가 없을 때 이 계열의 오류가 발생할 수 있다고 설명합니다.

먼저 오류 전문에서 다음을 확인하세요.

  • 링크에 실패한 라이브러리 또는 프레임워크 이름
  • 오류를 낸 앱이나 테스트 타깃
  • 현재 선택한 빌드 목적지가 시뮬레이터인지 실제 기기인지

오류가 특정 SDK 이름을 지목한다면, 앱의 전체 빌드 설정을 바꾸기 전에 그 SDK의 산출물부터 살펴보는 편이 좋습니다.

플랫폼 슬라이스와 빌드 경로를 비교해 원인을 좁히기

같은 arm64라도 실제 iOS 기기용 산출물과 iOS 시뮬레이터용 산출물은 서로 바꿔 쓸 수 있다고 가정하면 안 됩니다. Apple의 XCFramework 생성 안내는 서로 다른 플랫폼 및 대상 환경의 바이너리를 하나의 배포 번들로 구성하는 방식을 설명합니다.

의존성의 출처 확인할 항목 우선 조치 판단
타사에서 받은 미리 빌드된 SDK XCFramework에 시뮬레이터 대상 산출물이 있는지 공급자의 호환 산출물로 갱신 플랫폼 슬라이스가 없다면 공급자에게 요청
프로젝트에서 직접 만든 정적 라이브러리 빌드 설정과 산출물이 만들어진 대상 플랫폼 시뮬레이터 대상으로 다시 빌드 기기용 산출물만 있다면 재생성 필요
소스 형태로 포함한 의존성 실제 링크에 사용되는 산출물과 빌드 목적지 소스로 다시 빌드되는지 확인 미리 빌드된 바이너리가 남아 있는지 점검

단일 바이너리의 아키텍처 정보를 확인하는 것만으로는 플랫폼 호환성을 확정하기 어려울 수 있습니다. 오류에 나온 경로가 XCFramework 안의 어느 산출물을 가리키는지 확인하고, 공급자 설명이나 빌드 산출물의 플랫폼 정보를 함께 대조하세요. 바이너리 배포 형태에 따른 차이는 Apple의 바이너리 Swift 패키지 배포 설명도 참고할 수 있습니다.

판정 기준: 시뮬레이터용 슬라이스가 확인되면 Xcode가 그 산출물을 선택하는지 점검합니다. 없다면 의존성 갱신 또는 재빌드가 우선입니다. arm64 제외 설정은 이 확인을 대신하지 못합니다.

아키텍처 제외 설정은 제한적인 우회책입니다

EXCLUDED_ARCHS는 빌드 대상에서 특정 아키텍처를 제외하는 설정입니다. 특정 라이브러리가 특정 시뮬레이터 아키텍처를 지원하지 않고, 제외했을 때 다른 빌드 목적지가 정상 동작한다는 점까지 확인한 경우에만 임시 대응으로 검토하세요. Apple의 Xcode 빌드 설정 참고 자료에서 이 설정의 적용 방식과 빌드 설정 범위를 확인할 수 있습니다.

반대로 실제 기기용 바이너리만 존재하는 상황이라면, arm64를 제외해도 빠진 시뮬레이터 플랫폼 슬라이스가 생기지 않습니다. 프로젝트 전체의 공통 설정에 제외 값을 넣으면 의도하지 않은 타깃까지 영향을 받을 수 있으므로, 적용한다면 문제를 일으키는 타깃과 SDK별로 범위를 좁히고 임시 조치라는 점을 기록하세요.

EXCLUDED_ARCHS를 넣은 뒤 오류가 사라졌더라도 원인이 해결됐다고 단정하지 마세요. 빌드가 다른 아키텍처를 선택했거나 해당 경로를 우회했을 수 있습니다. 배포 대상과 테스트 대상까지 다시 확인해야 합니다.

자주 묻는 내용

실제 기기용 arm64 라이브러리를 시뮬레이터에 연결할 수 없는 이유는 무엇인가요?

arm64는 CPU 아키텍처를 말하고, iOS 기기와 시뮬레이터는 빌드 대상 플랫폼이 다릅니다. 아키텍처 이름이 같아도 플랫폼 정보가 맞지 않으면 링크할 수 없습니다. 시뮬레이터 대상 산출물이 포함된 XCFramework를 확인하세요.

타사 SDK에 시뮬레이터용 arm64 슬라이스가 없다면 어떻게 하나요?

공급자가 시뮬레이터용 XCFramework를 제공하는지 먼저 확인한 뒤, 지원되는 버전으로 갱신하세요. 대체 산출물이 없다면 공급자에게 문의하거나 해당 SDK가 실제로 시뮬레이터 빌드에 필요한지 검토해야 합니다. 직접 만든 바이너리라면 시뮬레이터 대상으로 다시 빌드하세요.

EXCLUDED_ARCHS로 아키텍처 오류를 해결해도 되나요?

제한된 상황에서는 임시 우회책이 될 수 있지만, 플랫폼 슬라이스가 없는 문제를 고치지는 않습니다. 적용 범위를 특정 타깃으로 한정하고, 변경 후 시뮬레이터와 실제 기기 빌드가 모두 통과하는지 확인하세요. 장기적으로는 호환되는 산출물로 교체하는 편이 안전합니다.

수정 뒤에는 빌드 목적지를 바꿔 검증합니다

Apple은 앱을 시뮬레이터와 실제 기기에서 실행하는 절차를 빌드 및 실행 안내에서 구분해 설명합니다. 의존성 변경 후에는 한쪽 목적지의 성공만으로 검증을 끝내지 말고, 다음 순서로 확인하세요.

  • [ ] 오류 전문에서 라이브러리 이름, 빌드 타깃, 현재 목적지를 기록합니다.
  • [ ] 해당 의존성이 미리 빌드된 SDK인지, 직접 만든 라이브러리인지, 소스 의존성인지 확인합니다.
  • [ ] XCFramework가 있다면 시뮬레이터용 플랫폼 산출물이 포함됐는지 확인합니다.
  • [ ] 타사 SDK라면 공급자의 지원 산출물로 갱신하고, 자체 라이브러리라면 대상 플랫폼에 맞춰 다시 빌드합니다.
  • [ ] 필요한 경우에만 EXCLUDED_ARCHS를 제한된 타깃에 적용하고, 설정 변경을 기록합니다.
  • [ ] 시뮬레이터 목적지에서 빌드한 뒤 실제 기기 목적지에서도 빌드해 각 플랫폼용 슬라이스가 링크되는지 확인합니다.
  • [ ] 의존성 버전과 산출물 출처를 기록해 도구 체인 변경 뒤에도 같은 조합을 재검증할 수 있게 합니다.

둘 중 하나만 통과한다면 성공한 목적지에서 실패한 목적지로 산출물이 잘못 재사용되지 않는지 다시 확인하세요. 특히 설정 변경으로 오류 메시지만 사라진 경우에는 다른 타깃의 빌드와 실행까지 확인해야 합니다.

재현 환경을 분리하면 설정 문제를 가려낼 수 있습니다

기존 개발 환경에서만 오류가 반복되면 의존성 문제와 프로젝트 설정 문제를 구분하기 어려울 수 있습니다. 현재 Mac의 프로젝트 설정을 보존한 채 다른 Mac이나 격리된 환경에서 동일한 의존성 버전으로 시뮬레이터와 실제 기기 빌드를 재현하면, 환경에 남은 설정이 원인인지 비교하는 데 도움이 됩니다.

다만 물리 기기 연결이나 장시간의 지속적인 빌드가 필요한 작업이라면 원격 환경이 적합하지 않을 수 있습니다. 그런 조건이 아니라 오류를 분리해 재현하고 수정한 산출물을 교차 검증하려는 경우라면, SSHMac의 Mac 환경을 별도로 활용하는 선택지도 있습니다. 접근 및 환경 관련 조건은 SSHMac 도움말 센터와 SSHMac 회사 소개에서 확인한 뒤, 현재 작업에 필요한 검증 방식과 맞는지 판단하세요.