Important
This library is now archived as backtracing is built into Swift 5.9+
This Swift package provides support for automatically printing crash backtraces of Swift programs.
The library is designed to fill a gap in backtraces support for Swift on non-Darwin platforms. When this gap is closed at the language runtime level, this library will become redundant and be deprecated.
Note: You do not need this library on Linux as of Swift 5.9, which has built-in backtracing support.
Add https://github.com/swift-server/swift-backtrace.git as a dependency in your Package.swift.
In your main.swift, do:
import Backtrace
// Do this first
Backtrace.install()Finally, for Swift < 5.2, make sure you build your application with debug symbols enabled. Debug symbols are automatically included for Swift 5.2 and above.
$ swift build -c release -Xswiftc -g
When your app crashes, a stacktrace will be printed to stderr.
Please see SECURITY.md for details on the security process.
Ian Partridge (GitHub, Twitter) the original author of this package.
Johannes Weiss (GitHub, Twitter) for the signal handling code.