Merge pull request #35 from PSPDFKit/christoph/stacktrace-readme

Add readme entry for getting stacktrace with lldb

Author: ChrisixFlash

README.md

@@ -174,6 +174,8 @@ The `XFSample.iOS` project is an example showcasing how to build an app with PSP
 
 # Troubleshooting
 
+## Swift Runtime Support
+
 Apple started shipping the Swift Runtime with iOS 12.2. To deploy apps using Swift (which includes PSPDFKit) on iOS 12.1 and 12.0, the Swift Runtime needs to be added manually via adding the `Xamarin.iOS.SwiftRuntimeSupport` NuGet dependency: https://www.nuget.org/packages/Xamarin.iOS.SwiftRuntimeSupport
 
 However, only doing this will then get your app rejected by the App Store due to the following error:
@@ -194,6 +196,19 @@ Since Xcode properly supports wrapping Swift libraries, we can just submit it fr
 
 This is only an issue if you must support iOS < 12.2.
 
+## Generating a Stack Trace (Device only)
+
+If you experience a crash on your end it's very valuable for us to have as much information as possible to provide you with the best support experience.
+Such valuable information includes a stack trace of the crash. Here's a quick step-by-step guide, showing how to generate a stack trace in Visual Studio 2019:
+
+1. In the Terminal app enter the following command: `touch ~/.mtouch-launch-with-lldb`. This will essentially let you use lldb to debug your application when it launches.
+2. Launch your app in debug mode in Visual Studio for Mac.
+3. Open the Application Output window in Visual Studio. It will ask you to execute another command in the Terminal.
+4. Once lldb is set up in the terminal window, you can simply use it like you would in Xcode.
+5. To get a stack trace you need to type `bt all`.
+
+If you want to remove lldb from your debug setup again you can simply run `rm ~/.mtouch-launch-with-lldb` in your Terminal.
+
 # Contributing
 
 Please ensure [you signed our CLA](https://pspdfkit.com/guides/web/current/miscellaneous/contributing/) so we can accept your contributions.