dSYM file upload

Upload dSYM files to allow Bugsnag to show human-friendly function names, file paths, and line numbers in your iOS, macOS, and tvOS stacktraces.

Uploading dSYM files automatically

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.

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

API endpoint

Symbolicating crash reports requires the contents of contents of the dSYM binary. To upload, send a POST request to https://upload.bugsnag.com (or the address of your upload server, if using a private installation) with the following parameters:

  • dsym - The dSYM file to upload as a form-data file upload. Can be 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 iTunes connect if bitcode is enabled).
  • projectRoot (optional) - the root path of the project. This will be stripped off from the file name in the displayed stacktraces and improves error grouping for errors reported from the same location within the app but with a different project root

Here is an example request using cURL, where the @ sign indicates that the dsym parameter is an uploaded file:

curl https://upload.bugsnag.com/ \
  -F dsym=@MyApp.app.dSYM/Contents/Resources/DWARF/MyApp \
  -F projectRoot=/Users/joebloggs/workspace/MyApp