Table of Contents
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 –
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:
After Xcode 4.3, it is installed as an normal app, so
symbolicatecrash should be under the path:
Added Xcode 6
Starting from Xcode 6, the location of
symbolicatecrash will be:
Fix the issue of Xcode path
In the terminal, run the following:
In Xcode 4.3 and above, it should display:
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:
- Right click the archive from organizer and choose “Show in Finder”.
- From the xcarchive file in finder, right click this file and choose “Show Package Contents”. You will then see a “dSYMs” folder.
- Inside the “dSYMs” folder you will find “YourAppName.app.dSYM” file that you will need to symbolicate files.