Фраза «Universal app» в Finder относится к основному приложению, но падение часто вызывает вложенный `x86_64`-only plug-in или helper. На Apple silicon система предпочитает arm64 slice. Если процесс стал arm64, Intel-модуль в него не загрузится: Apple указывает, что смешивать arm64 и x86_64 код в одном процессе нельзя.
Не начинайте с отключения Gatekeeper или снятия quarantine. Сначала получите точную архитектуру, режим процесса и первое имя binary в crash report. Так можно отличить несовместимый slice от повреждённой подписи и от обычной ошибки приложения.
Finder даёт только первую подсказку
| Kind/состав | Что запустит Apple silicon | Следующая проверка |
|---|---|---|
| Application (Apple silicon) | arm64 native | зависимости и minimum macOS |
| Application (Universal) | arm64 по умолчанию | все вложенные slices |
| Application (Intel) | x86_64 через Rosetta | наличие/политика Rosetta |
| Universal + Intel plug-in | native host не загрузит plug-in | Rosetta-тест или обновление plug-in |
Опция “Open using Rosetta” у universal app переводит весь процесс в Intel-режим и бывает полезна как диагностический тест для старого расширения. Это не финальное исправление: Apple рекомендует поставлять Universal или Apple silicon версию вместо постоянной зависимости от трансляции.
Инвентаризация начинается с реальных Mach-O файлов
APP=/Applications/Example.app
lipo -archs "$APP/Contents/MacOS/Example"
file "$APP/Contents/Frameworks/Legacy.framework/Legacy"
# ожидаемый universal результат:
# x86_64 arm64Команды выполняют на копии релизного `.app`, а путь берут из `Contents/MacOS` и вложенных bundles. Apple прямо рекомендует `lipo -archs` или `file` для определения slices. Не делайте вывод по имени архива `mac-universal.zip`: проверяется содержимое после упаковки и обновления.
Проверьте весь исполняемый граф
- Основной executable и XPC services.
- Frameworks, dylib и plug-ins, которые грузятся в процесс.
- Login item, updater, launch agent и CLI tools.
- Нативные модули Electron/Node, Python wheels или JNI-библиотеки.
- Бинарники, распакованные после первого запуска.
Статическая библиотека уже встроена в итоговый Mach-O, а динамическая остаётся отдельным участником. Для каждого файла фиксируйте путь, slices, deployment target, источник сборки и подпись. Один неизвестный vendor plug-in — отдельный риск релиза.
Матрица native/Rosetta локализует дефект
| Native arm64 | Rosetta x86_64 | Вероятная причина |
|---|---|---|
| не работает | работает | Intel-only модуль или arm64-ветка кода |
| работает | не работает | Intel slice/зависимость повреждены |
| не работает | не работает | подпись, notarization или общий дефект |
| работает без plug-in | работает с plug-in | plug-in только x86_64 |
Сравнивайте одну и ту же сборку и один набор настроек. Если параллельно меняются версия, plug-ins и пользовательский профиль, матрица перестаёт быть экспериментом.
Подпись проверяется после упаковки
Universal binary содержит отдельный code directory для каждой архитектуры. Изменение Mach-O после подписи — например, `install_name_tool` или strip в нестандартном pipeline — может нарушить seal. Проверяйте финальный app, dmg/pkg и результат автообновления, а не только Xcode archive.
codesign --verify --strict --verbose=2 /Applications/Example.app
spctl --assess --type execute --verbose=4 /Applications/Example.app
# затем открыть crash report и найти первый crashed binary/imageНе используйте ad-hoc переподпись как production-ремонт Developer ID релиза: она меняет доверенную цепочку. Цель команды — получить диагностику; исправление выполняется в build/sign/notarize pipeline с исходными entitlements.
Rosetta — временная ветка совместимости
Intel-only приложение может запускаться через Rosetta, если политика и версия macOS это позволяют. Документация Apple на дату проверки предупреждает о сроках общей поддержки Rosetta и советует обновлять приложения до Universal/Apple silicon. Поэтому «попросить всех установить Rosetta» не заменяет план сборки arm64 и обновления сторонних компонентов.
Release-тест выполняется на чистой машине
- Собрать Release с Standard Architectures и без случайных EXCLUDED_ARCHS.
- Проверить slices каждого вложенного исполняемого файла.
- Подписать вложенные компоненты и внешний bundle штатным pipeline.
- Установить артефакт через тот же канал, что использует клиент.
- Запустить native, открыть основные функции и plug-ins.
- Если поддерживается, отдельно проверить Intel slice под Rosetta.
- Обновить предыдущую версию и повторить проверку уже обновлённого bundle.
Для диагностики пригодятся модель Mac, версия macOS, Kind из Finder, вывод `lipo -archs` основного и упавшего модулей, первые строки crash report и результат проверки подписи. Сертификат, private key и полный пользовательский профиль передавать не нужно.