<!--
{
  "availability" : [
    "iOS: 27.0.0 -",
    "iPadOS: 27.0.0 -",
    "macOS: 27.0.0 -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "CrashReportExtension",
  "identifier" : "/documentation/CrashReportExtension/CrashReporterExtension",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "CrashReportExtension"
    ],
    "preciseIdentifier" : "s:20CrashReportExtension0a8ReporterC0P"
  },
  "title" : "CrashReporterExtension"
}
-->

# CrashReporterExtension

The base type for crash reporter extensions.

```
protocol CrashReporterExtension : AppExtension
```

## Overview

Conform to this protocol and implement [`processCrashReport(process:)`](/documentation/CrashReportExtension/CrashReporterExtension/processCrashReport(process:)) to create a crash reporter.
Your extension runs in its own process, separate from the crashed app.

The following example shows an implementation that accesses the crashed process’s [`corpsePort`](/documentation/CrashReportExtension/CrashedProcess/corpsePort) and [`binaryImages`](/documentation/CrashReportExtension/CrashedProcess/binaryImages) for use in generating a crash report.

```swift
@main
struct MyCrashExtension: CrashReporterExtension {
    func processCrashReport(process: CrashedProcess) {
        let corpsePort = process.corpsePort
        let images = process.binaryImages
        // Generate your crash report...
    }
}
```

After collecting the needed information from the crashed process, you can persist your
crash report or send it back to a server you control.

## Topics

### Processing a crash report

[`processCrashReport(process:)`](/documentation/CrashReportExtension/CrashReporterExtension/processCrashReport(process:))

A method the system calls when a crash report is ready to be processed.

[`CrashedProcess`](/documentation/CrashReportExtension/CrashedProcess)

A synchronous client for accessing crash data from the host process.

## Relationships

### Inherits From

[`AppExtension`](/documentation/ExtensionFoundation/AppExtension)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)