Skip to content

Debug Symbol (dSYM)

When Xcode compiles your source code into machine code, it generates a list of symbols in your app—class names, global variables, and method and function names. These symbols correspond to the file and line numbers where they’re defined; this association creates a debug symbol, so you can use the debugger in Xcode, or refer to line numbers reported by a crash report. Debug builds of an app place the debug symbols inside the compiled binary file by default, while release builds of an app place the debug symbols in a companion Debug Symbol file (dSYM) to reduce the size of the distributed app.

Each binary file in an app—the main app executable, frameworks, and app extensions—has its own dSYM file.

Before building your app for distribution, verify that your build settings generate the necessary dSYM files, so you can diagnose crashes after releasing your app.

  1. Open your project in Xcode and select the project file in the Xcode Navigator.
  2. Select your main build target.
  3. Open the target's Build Settings tab, then click All.
  4. Search for "debug information format".
  5. Set Debug Information Format to DWARF with dSYM File for the release build type.

Follow the steps in Managing Symbol File (iOS) to upload dSYM files in SAP Mobile Services.


You must retain the Xcode archive for each build of your app you distribute. Without this archive, which includes any app-specific dSYM files, SAP Mobile Services is not able to fully symbolicate crash reports.

Last update: November 18, 2021