dSYM (Debug Symbols) — это файл, генерируемый при компиляции iOS-приложения, который содержит отладочные символы. Он связывает адреса в скомпилированном (оптимизированном) бинарном коде с именами функций, переменных и строк исходного кода.
Основные цели использования dSYM:
Каждый бинарный файл (приложение .app, фреймворк, библиотека) имеет свой уникальный UUID. Соответствующий dSYM-файл (содержащий символы для этого бинарного файла) также имеет тот же UUID. При анализе крэш-репорта система или инструменты (например, Xcode Organizer, Crashlytics, Sentry) используют UUID из крэш-репорта для поиска нужного dSYM-файла и выполнения десимволизации.
dSYM-файлы обычно находятся в директории Products после сборки проекта в Xcode или могут быть экспортированы вместе с архивом приложения. Важно сохранять dSYM-файлы для каждой опубликованной версии приложения, чтобы иметь возможность десимволизировать крэши от пользователей.