How to symbolicate crash/error logs from a Xamarin Forms iOS project?

by

When you build your iOS project, you should have the .app file in the bin/iPhone/Release directory. Or, if you have the .ipa file, you can extract the .app from that with. You can rename the file to have .zip and extract. The .app will be in the Payload folder. On Windows, it can be a little confusing because the icon might look like a Folder or Directory. Check the file extension. On Mac, it should recognize a .app and it might not show the extension at all. Instead, it looks like this:

enter image description here

Important: You need to use the same .app file that generated the crash report. This means you would have to use the .app from the package you installed on the device that generated the crash report. Hopefully, you archived that or saved it somewhere. Simply rebuilding the project to get a new .app will not match up with the .crash file during symbolication and will not work. If you don’t have access to that, you will need to publish again and this time keep the .app around for the next time you get a .crash to analyze.

To manually symbolicate, I have a blog post about doing this here. To summarize, here are the steps:

Create an Alias

Open Terminal and run one of these commands for your version of Xcode:

Xcode 7.X
alias symbolicate="/Applications/Xcode.app/Contents/SharedFrameworks/DVTFoundation.framework/Versions/A/Resources/symbolicatecrash -v"

This just makes using the symbolicatecrash tool easier by aliasing it to a symbolicate command so we don’t have to navigate to that directory to run the command.

Update the Developer Directory

Run this command:

export DEVELOPER_DIR="/Applications/Xcode.app/Contents/Developer"

Symbolicate

Open Terminal again and cd to the directory where you placed your files in the step above. Run the symbolicate command we aliased before with your .crash and .app files as the parameters like this:

symbolicate -o "symbolicatedCrash.txt" "MyAppName 2-12-14, 9-44 PM.crash" "MyAppName.app"

This will symbolicate the crash file and spit out the result in a new file named “symbolicatedCrash.txt”. Make sure that correct the file names from my example to match yours.

More Related Contents:

  1. Hamburger Menu Xamarin Forms (MasterDetailPage)
  2. Global Exception Handling in Xamarin Cross platform
  3. What is the difference between Xamarin.Forms and Xamarin Native? [closed]
  4. How to log in to Facebook in Xamarin.Forms
  5. How to view PDF file using Xamarin Forms
  6. How to make long press gesture in Xamarin Forms?
  7. Xamarin Forms Android Error: Please install package ‘Android Support Library’
  8. Write device platform specific code in Xamarin.Forms
  9. How can I publish my Tizen app from Xamarin forms visual studio 2015
  10. Check if string is null
  11. Symbolicating iPhone App Crash Reports
  12. iOS crash reports: atos not working as expected
  13. Xamarin.Android Proguard – Unsupported class version number 52.0
  14. Access the Android Special Folder Path by using Environment
  15. How to implement INotifyPropertyChanged in Xamarin.Forms
  16. Xamarin-System.UnauthorizedAccessException: Access to the path is denied
  17. Xamarin project not running, assembly not found
  18. What is the difference between Xamarin.Form’s LayoutOptions, especially Fill and Expand?
  19. Xamarin Forms Android App Crashes Running Debug with VS Android Emulator
  20. Xamarin – Requesting camera permissions in WebView
  21. Newtonsoft.Json deserialize object in Xamarin iOS project
  22. The SSL connection could not be established
  23. How to use Font Awesome icons in project as an icon of ImageButton
  24. Is this a bug in MonoTouch GC?
  25. Xamarin Studio – can not login – One of the identified items was in an invalid format
  26. Horizontal ListView Xamarin.Forms
  27. Xamarin Forms Swipe Left/Swipe Right Gestures
  28. How do overlap in Xamarin forms?
  29. How to symbolicate crash report from Apple received in .txt format not .crash format
  30. mach_vm_map failed (error code=3)

Leave a Comment