Apple Debug Symbols (dSYM)

Symbolicating crash reports requires the contents of the dSYM binary. Upload these dSYM files to show human-readable function names, file paths, and line numbers in your stacktraces on iOS, macOS and other Apple platforms.

Use the POST /dsym endpoint to upload either:

• A single dSYM binary file. Within a .dSYM directory, the binary is located in Contents/Resources/DWARF and generally has the same base name as the .dSYM file itself.
• An archive (zip) containing multiple .dSYM directories (as downloaded from App Store Connect).

The symbolication guide provides instructions for configuring your app release process to automate finding and uploading dSYM files to BugSnag, based on your project settings. Once configured, dSYM files will be uploaded automatically.

cURL example

Symbolication guides

See our symbolication guides for a higher-level overview of integrating uploads into your build systems to see full stacktraces for all your releases:

• iOS

• macOS

• tvOS

• watchOS

Locating missing dSYM files

To locate dSYM files for upload, see the symbolication guide section on troubleshooting missing dSYM files. The guide breaks down the different steps required for configuring symbolication based on project settings