How to Manually Symbolicate an iOS Crash Log

Updated with Xcode 6 (2015-02-19)

The command “symbolicatecrash” (included in Xcode) is used to symbolicare the iOS crash log.

Here is the calling structure of symbolicatecrash command:

symbolicatecrash crash_log dSYM_file [> output.file]

The following way is also working:

symbolicatecrash -o output_file crash_log dSYM_file

Both of the commands will generate the output file – output_file.

Find symbolicatecrash

If the version of Xcode is less than 4.3, you will need to find symbolicatecrash under the folder “/Developer“:

find /Developer -name symbolicatecrash -type f

And you would probably find symbolicatecrash under the following path:

/Developer/Platforms/iPhoneOS.platform/Developer/Library/PrivateFrameworks/DTDeviceKit.framework/Versions/A/Resources/symbolicatecrash

After Xcode 4.3, it is installed as an normal app, so symbolicatecrash should be under the path:

/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/PrivateFrameworks/DTDeviceKit.framework/Versions/A/Resources/symbolicatecrash

Added Xcode 6

Starting from Xcode 6, the location of symbolicatecrash will be:

/Applications/Xcode.app/Contents/SharedFrameworks/DTDeviceKitBase.framework/Versions/A/Resources/symbolicatecrash 

Fix the issue of Xcode path

In the terminal, run the following:

/usr/bin/xcode-select -print-path

In Xcode 4.3 and above, it should display:

/Applications/Xcode.app/Contents/Developer/

If not, you should to run the following command to fix it:

sudo /usr/bin/xcode-select -switch /Applications/Xcode.app/Contents/Developer/

Find the Correct dSYM file

When doing the symbolication, it has to have the correct dSYM file which is from the archive used to generate the ipa file.

Here are the steps:

  1. Right click the archive from organizer and choose “Show in Finder”.
  2. From the xcarchive file in finder, right click this file and choose “Show Package Contents”. You will then see a “dSYMs” folder.
  3. Inside the “dSYMs” folder you will find “YourAppName.app.dSYM” file that you will need to symbolicate files.

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes:

<a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>