Skip to main content

Crash Report Symbolication Methods


DeployGate offers a crash report feature that allows you to view crash reports wirelessly.

  • It uses PLCrashReporter, and it is sent in the same format as crash reports generated by Apple.
  • Crash reports are saved to a file when a crash occurs and is sent on the next launch.
  • Currently, because pre-symbolication data is sent, you must perform symbolication on your Mac. DeployGate plans to implement Automatic Symbolication in the future.

Preparing symbolicatecrash

For the first time use of symbolicatecrash, you must set PATH. Add the following to the end of the ~/.bash_profile file.

Xcode 7.3 or later
export PATH="/Applications/Xcode.app/Contents/SharedFrameworks/DVTFoundation.framework/Versions/A/Resources:$PATH"
export DEVELOPER_DIR="/Applications/Xcode.app/Contents/Developer"
Xcode 6, 7
export PATH="/Applications/Xcode.app/Contents/SharedFrameworks/DTDeviceKitBase.framework/Versions/A/Resources:$PATH"
export DEVELOPER_DIR="/Applications/Xcode.app/Contents/Developer"
Xcode 5 or earlier
export PATH="/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/PrivateFrameworks/DTDeviceKitBase.framework/Versions/A/Resources:$PATH"
export DEVELOPER_DIR="/Applications/Xcode.app/Contents/Developer"

Symbolication Method

  1. Obtain Crash Report

The generated crash report will be sent automatically on the next launch.

Screenshot of iOS sdk crash report

Sent crash reports can be downloaded from each device’s page.

Screenshot of iOS sdk crash report

  1. Prepare dSYM file

Find the corresponding dsym file. Right click on the corresponding build from Organizer → Archive and select "Show in Folder." It is in the dSYMs directory in "Show Package Contents.”

Screenshot of iOS sdk crash report

  1. Run symbolicatecrash to obtain class name, method name, and line number

Run symbolicatecrash on the downloaded crash report/corresponding dSYM.

Shell
symbolicatecrash [CRASH_REPORT] [DSYM_FILE]

Screenshot of iOS sdk crash report