Симптом: Xcode сообщает building for iOS Simulator but linking in object file built for iOS, хотя в ошибке фигурирует arm64.
Быстрое решение: найдите библиотеку, собранную только для iOS-устройства, и обновите её до версии с срезом iOS Simulator либо пересоберите зависимость в подходящий XCFramework. Не исключайте arm64 как универсальный обход: эта архитектура может использоваться симулятором на Apple silicon.
Эта инструкция для разработчиков, у которых ошибка появилась после перехода на Mac с Apple silicon.
Она пригодится, если проект подключает предварительно собранную библиотеку, сторонний SDK или собственный статический архив.
Инженерам, которые выпускают XCFramework для других команд, она поможет проверить, для каких платформ предназначены содержащиеся в нём бинарные файлы.
Как устранить ошибку Xcode «building for iOS Simulator but linking in object file built for iOS»
Сообщение говорит не просто о том, что «не совпала архитектура». В нём важны три части: Xcode собирает приложение для iOS Simulator, найденный объектный файл предназначен для iOS, а arm64 указывает на архитектуру процессора. Архитектура и платформа — разные характеристики. Поэтому одинаковое обозначение arm64 само по себе не делает библиотеку для iPhone подходящей для симулятора.
Практический вывод: сначала установите имя зависимости и её платформенный срез, затем замените или пересоберите несовместимый бинарный файл. Ошибка часто появляется потому, что пакет содержит arm64 для физического устройства, но не содержит подходящего варианта для симулятора. Apple описывает такой класс ошибок и рекомендует проверять предварительно собранные библиотеки в технической заметке о сборках для Apple silicon.
До изменения настроек зафиксируйте в журнале сборки:
- имя файла или библиотеки, на которую указывает linker;
- target приложения и выбранное назначение сборки — симулятор либо физическое устройство;
- конфигурацию, используемую для текущей сборки;
- источник зависимости и её версию.
Это отделяет проблему конкретной библиотеки от ошибки в основном target. Если изменить общие настройки проекта, не установив виновника, можно замаскировать первоначальную причину и получить отдельный сбой при архивировании или сборке для устройства.
Почему библиотека arm64 для iPhone не подходит симулятору
arm64 описывает набор инструкций процессора, а не то, какую платформу поддерживает бинарный файл. На Mac с Apple silicon симулятор может использовать arm64, но это не превращает библиотеку, собранную для iOS-устройства, в библиотеку для iOS Simulator. В бинарных файлах сохраняются сведения о целевой платформе; линковщик проверяет их, а не только текстовое имя архитектуры.
Сравните обозначения и содержание файлов, а не делайте вывод по имени каталога:
- iOS, arm64 — вариант для физического устройства.
- iOS Simulator, arm64 — вариант для симулятора на Apple silicon.
- iOS Simulator, x86_64 — вариант симулятора для соответствующей архитектуры Mac.
Наличие одного из этих вариантов не подтверждает наличие остальных. Например, универсальный архив может содержать несколько архитектур, но все они могут относиться к платформе iOS-устройства. Команда lipo -info помогает выяснить архитектуры внутри Mach-O-файла, но сама по себе не доказывает совместимость с симулятором: сведения о платформе проверяйте отдельно.
В XCFramework полезно изучить Info.plist. В числе важных полей — LibraryIdentifier, SupportedPlatform, SupportedPlatformVariant и SupportedArchitectures. Значение платформы и вариант платформы позволяют отличить iOS от iOS Simulator; список архитектур показывает, какие архитектуры доступны для найденного варианта. Apple описывает состав мультиплатформенного пакета в документации по созданию XCFramework.
Можно начать с такой проверки:
plutil -p Vendor.xcframework/Info.plist
Замените Vendor.xcframework на путь к своей зависимости. Сопоставьте содержимое файла с сообщением linker и выбранным назначением сборки. Если подключён не XCFramework, а .a или отдельный .framework, сначала определите, какой именно бинарный файл из пакета попал в сборку. Проверка только внешней папки недостаточна: внутри могут лежать файлы для разных платформ, а проект может ссылаться не на тот из них.
Как определить, чего не хватает в стороннем SDK
Если Xcode указывает на сторонний SDK, выясните, поставляет ли его разработчик вариант именно для симулятора. Не предполагайте, что в следующем выпуске он появится автоматически: проверьте описание выпуска, содержимое загруженного пакета и документы поставщика. При отсутствии подходящего среза правильное решение — получить обновлённый пакет с поддержкой нужной платформы или запросить у поставщика соответствующий артефакт.
Оценка способов исправления:
- Обновить SDK до выпуска с поддержкой iOS Simulator — высокая применимость. Предпочтительный путь для стороннего бинарного продукта: вы получаете подготовленные поставщиком варианты и избегаете ручного изменения содержимого пакета. Перед обновлением проверьте заметки к выпуску и повторите сборку для симулятора и устройства.
- Пересобрать библиотеку как XCFramework — высокая применимость, если доступны исходники. Нужна отдельная сборка зависимости для требуемых платформ и корректная упаковка результатов. В руководстве Apple по созданию мультиплатформенного бинарного фреймворка описан именно процесс формирования XCFramework, а не универсального архива, где один файл предполагается использовать для всех целей.
- Подключить зависимость из исходников — условно применимо. Это может решить проблему, когда пакет поддерживает сборку для текущей платформы, однако результат зависит от настроек проекта и доступности исходного кода. Проверьте, что менеджер зависимостей действительно собирает исходный код для симулятора, а не выбирает тот же несовместимый бинарный продукт.
- Исключить arm64 через
EXCLUDED_ARCHS— низкая оценка как постоянного исправления. Такая настройка не добавляет отсутствующий платформенный срез. Она меняет архитектуры, которые Xcode рассматривает при сборке, и может только переключить цель на другой доступный вариант или сделать её недоступной.
Если зависимость поставляется как бинарный Swift-пакет, проверяйте не только имя продукта в манифесте, но и фактически подключённый бинарный артефакт. Apple объясняет распространение таких пакетов в документации по бинарным фреймворкам в Swift Packages. Наличие Swift Package не гарантирует, что внутри есть срез для каждого назначения сборки.
Может ли EXCLUDED_ARCHS исправить ошибку линковки
Настройка EXCLUDED_ARCHS может помочь только в ограниченном случае: есть подтверждение, что конкретный компонент не поддерживает выбранную архитектуру, существует другой поддерживаемый вариант, а исключение действует только там, где его действительно требуется. Она не исправляет несоответствие платформы между iOS-устройством и симулятором.
До применения настройки задайте себе вопросы:
- Какой target и какая конфигурация получают это значение?
- Исключается ли архитектура только для нужного назначения или для всех сборок?
- Есть ли у зависимости совместимый вариант для оставшейся архитектуры?
- Собирается ли после изменения приложение для симулятора и физического устройства?
- Не затрагивает ли настройка архивирование, тестирование или другие targets?
Проверяйте фактические значения, заданные в проекте, конфигурационных файлах и настройках зависимостей. Руководство Apple по параметрам сборки Xcode описывает EXCLUDED_ARCHS как настройку архитектур; это не механизм конвертации бинарной библиотеки между платформами.
Если временное исключение нужно, ограничьте его наиболее узкой областью действия и зафиксируйте причину в проекте. Не переносите настройку автоматически на весь проект и все конфигурации. После изменения повторите сборку именно для назначения, которое вы пытались починить, а затем отдельно проверьте остальные используемые цели. Если зависимости по-прежнему не хватает подходящего среза, вернитесь к обновлению или пересборке библиотеки.
Порядок диагностики без случайных изменений проекта
Действуйте последовательно. Так вы быстрее поймёте, в какой части сборки возникло несоответствие, и не смешаете исправление зависимости с изменением настроек приложения.
- [ ] Определите назначение сборки. В Xcode проверьте, выбрано ли устройство-симулятор или физическое устройство. В сообщении linker зафиксируйте слова
iOS Simulator,iOSи имя объектного файла. Apple отдельно рассматривает запуск приложения в симуляторе и на физическом устройстве; это разные цели сборки, хотя проект приложения может быть один и тот же. - [ ] Найдите зависимость, вызвавшую сбой. Ищите в полном логе имя библиотеки, фреймворка или объектного файла, а не только верхнюю строку ошибки. Определите, включается ли зависимость напрямую, через другой пакет, CocoaPods или Swift Package.
- [ ] Установите происхождение файла. Отметьте, является ли он сторонним предварительно собранным продуктом, вашим статическим архивом или результатом сборки исходной зависимости. Для вложенного SDK проверьте фактический путь файла, который выбирает Xcode.
- [ ] Проверьте архитектуру и платформу раздельно. Используйте
lipo -infoдля архитектур Mach-O, а сведения о платформе смотрите в метаданных XCFramework или самого бинарного файла. Не считайте результатlipoдоказательством того, что библиотека предназначена для симулятора. - [ ] Сравните вариант с требуемой целью. В XCFramework сопоставьте значения
SupportedPlatform,SupportedPlatformVariantиSupportedArchitecturesс назначением сборки. Если варианта для iOS Simulator нет, остановитесь: настройки приложения не смогут добавить отсутствующий артефакт. - [ ] Выберите исправление по источнику. Для SDK запросите или установите версию поставщика с поддержкой симулятора. Для собственной библиотеки повторно соберите нужные варианты и упакуйте их в XCFramework. Для исходной зависимости сначала проверьте, может ли она собраться для выбранной цели.
- [ ] Повторите сборки для обеих целей. Сначала соберите приложение для нужного симулятора, затем для подходящего физического устройства. Успешная сборка только одной цели не подтверждает, что в пакете присутствуют оба необходимых варианта.
- [ ] Зафиксируйте происхождение исправления. Сохраните версию SDK, источник пакета и способ получения бинарного файла. При следующем обновлении инструментария эти сведения позволят быстрее обнаружить, если в проект снова попала библиотека без нужного платформенного варианта.
У этой проверки есть важное ограничение: успешное чтение Info.plist говорит о заявленных свойствах пакета, но не заменяет фактическую сборку проекта. И наоборот, сбой приложения может возникать по другой причине, если сообщение linker указывает на иной бинарный файл. Если после замены зависимости ошибка изменилась, разберите новый лог отдельно, а не применяйте старое исключение архитектуры вслепую.
Проверка XCFramework для устройства и симулятора
При выпуске собственного пакета проверяйте каждый вариант отдельно. Создайте артефакты для используемых платформ, объедините их в XCFramework и изучите получившийся Info.plist. В нём должны быть указаны платформенные варианты, соответствующие сборкам, которые вы намерены поддерживать. В частности, наличие arm64 в записи для iOS не заменяет запись для iOS Simulator.
После упаковки подключите полученный пакет в тестовый проект или в изолированную копию приложения. Соберите target для симулятора и физического устройства, проверьте, что Xcode выбирает ожидаемый компонент, а linker не подхватывает старую библиотеку из кэша или другого пути. При неясном выборе проверьте пути поиска фреймворков и библиотек в настройках сборки, а также фактические пути в логе.
Не публикуйте XCFramework, опираясь только на результат сборки исходников. Проверяйте именно тот пакет, который будет передан потребителям: упаковка, имена вариантов и содержимое могут отличаться от промежуточных продуктов. Сохраните сведения о версии исходника и процессе создания артефакта вместе с релизом. Это особенно важно, если SDK копируется вручную, хранится во внутреннем репозитории или обновляется отдельно от проекта.
Когда полезно повторить сборку в отдельной среде Mac
Если исправление прошло на вашем Mac, но ошибка проявляется у коллег или в другой конфигурации, повторите проверку в изолированной среде: с чистым состоянием проекта, тем же исходным кодом и явно записанной версией зависимости. Локальная рабочая копия может содержать ранее скачанные артефакты, а ручная замена бинарного файла не всегда очевидна из истории изменений. Отдельный запуск помогает проверить, воспроизводится ли результат без этих локальных условий.
При этом отдельная среда не заменит правильный XCFramework. Если в нём отсутствует платформа симулятора, перенос проекта на другой Mac не создаст недостающий срез. Сначала исправьте зависимость, а затем используйте повторную сборку как независимую проверку. Если для таких запусков вам нужен отдельный удалённый Mac, параметры аренды Mac mini в описании среды SSHMac можно оценить именно под задачу проверки сборок, а не как замену исправлению библиотеки. Перед выбором такого варианта можно также посмотреть общую информацию о SSHMac и доступных сценариях работы.
Текущая рабочая машина удобна для разработки, но повторная проверка на ней может зависеть от локальных кэшей, установленного набора инструментов и незадокументированных изменений. Переход на другой общий CI-сценарий тоже не решит отсутствующий платформенный срез и добавит собственные настройки окружения. Если вам нужно лишь проверить исправленную зависимость в отдельном состоянии, аренда Mac у SSHMac даёт возможность провести такую проверку на другом Mac; если же сборки идут постоянно, важны физические подключения или требуется полный контроль над машиной, собственное оборудование может оказаться уместнее. Ошибку Xcode building for iOS Simulator but linking in object file built for iOS устраняет совместимый артефакт — отдельная среда нужна, чтобы подтвердить, что исправление действительно воспроизводится.