Analyzing crash dumps

Prerequisites

• A crash dump file (usually with .crash extension but not necessarily, in order to use it more easily you should add .crash)
• The NativeScript.framework.dSYM bundle which can be downloaded from the Assets section of the respective release in github
• Xcode

Procedure

1. Download the crash dump file
2. Download the archive with the dSYM bundle and extract it
3. Locate the crash dump in Finder and using the context menu choose Open with / Xcode

Earlier versions of Xcode simply symbolicate the crash dump and open it in a text window that's why for a better experience I recommend using Xcode 11. It will ask you to choose the project in which to open the dump file and will present the threads in the debugger view just like in a live debugging session. If you open it in your local copy of the ios-runtime repository with the corresponding tag checked out, you will be able to navigate to the exact lines of source code.

References

• https://developer.apple.com/library/archive/technotes/tn2151/_index.html#//apple_ref/doc/uid/DTS40008184-CH1-SYMBOLICATION