{"id":52337,"date":"2026-06-22T16:51:40","date_gmt":"2026-06-22T20:51:40","guid":{"rendered":"https:\/\/mjtsai.com\/blog\/?p=52337"},"modified":"2026-06-22T16:54:24","modified_gmt":"2026-06-22T20:54:24","slug":"crashreportextension","status":"publish","type":"post","link":"https:\/\/mjtsai.com\/blog\/2026\/06\/22\/crashreportextension\/","title":{"rendered":"CrashReportExtension"},"content":{"rendered":"

CrashReportExtension<\/a>:<\/p>\n

\n

The Crash Report Extension framework allows you to perform analysis and produce a report when your app crashes. Your crash-handling code executes out-of-process, rather than from a signal handler or other in-process techniques.<\/p>\n

You implement your handler by writing an app extension that conforms to the CrashReporterExtension<\/code><\/a> protocol. The system calls your processCrashReport(process:)<\/code><\/a> method when the app crashes. Use the CrashedProcess<\/code><\/a> parameter to inspect the state of the crashed app by retrieving a crash reason, symbolicating relevant addresses, and communicating with the process over a read-only Mach port. After collecting the crash data, you can send a report back to your own server.<\/p>\n

[…]<\/p>\n

Crash Report Extension is available on iOS 27 and later. It isn’t available to Catalyst-based macOS apps, or on iOS apps running on Mac computers with Apple silicon.<\/p>\n<\/blockquote>\n\n

The top of the page says “macOS 27.0+,” so I guess<\/a> this means it does<\/em> work for regular AppKit and SwiftUI Mac apps. It’s great to finally have a supported way to do this.<\/p>\n\n

I don’t know why they can’t just give you the crash report text or .ips<\/tt> JSON directly, though. It looks like you have to use Mach IPC with the corpsePort<\/code> to get the backtrace for each thread and then use the extension API to symbolicate the addresses. Even then, I’m not sure you can get all the information that’s in a standard crash report, such as the Application Specific Backtrace. Maybe you can find the address for gCRAnnotations<\/code>\/__crashreporter_info__<\/code><\/a> and load it with mach_vm_read<\/code>?<\/p>\n\n

Previously:<\/p>\n