Skip to content

docs(unreal): Native backend support on Mac #17332

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
tustanivsky wants to merge 2 commits into
base: master
Choose a base branch
from
Open

docs(unreal): Native backend support on Mac #17332

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
213501a
docs(unreal): Native backend support on Mac
tustanivsky Apr 14, 2026
2a568c4
Remove sandbox limitation
tustanivsky Apr 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/platforms/unreal/configuration/app-hangs/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -94,3 +94,4 @@ public:
- **No early-startup detection**: Hangs that occur before `FEngineLoop::Tick()` starts (e.g. during `GameInstance::Init()`) are not detected, because threads must have sent at least one heartbeat before they can be monitored.
- **Requires engine configuration**: The `HangDuration` setting in `[Core.System]` must be set to a value greater than `0`. Without it, the engine's heartbeat monitor thread doesn't run.
- **One thread at a time**: If multiple threads become stuck simultaneously, only one hang is reported per episode. The engine's `FThreadHeartBeat` reports one stuck thread at a time, so additional stuck threads are only detected after the first one recovers.
- **Not supported on macOS with native backend**: Hang tracking is not available when using the <PlatformLink to="/configuration/native-backend/">native backend</PlatformLink> on macOS.
6 changes: 3 additions & 3 deletions docs/platforms/unreal/configuration/native-backend/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
---
title: Native Backend
sidebar_order: 12
description: "Learn how to use the experimental native crash backend as an alternative to Crashpad on Windows and Linux."
description: "Learn how to use the experimental native crash backend as an alternative to the default backend on Windows, Linux, and macOS."
---

The Sentry Unreal SDK uses Crashpad as the default crash reporting backend on Windows and Linux. As an alternative, you can enable the experimental native backend, which uses a different crash handling architecture built into the sentry-native SDK.
The Sentry Unreal SDK uses Crashpad as the default crash reporting backend on Windows and Linux, and the sentry-cocoa SDK on macOS. As an alternative, you can enable the experimental native backend, which uses a different crash handling architecture built into the sentry-native SDK.

<Alert level="warning">

Expand All @@ -14,7 +14,7 @@ The native backend is experimental and under active development. It may have inc

<Alert>

This feature is supported on Windows and Linux only.
This feature is supported on Windows, Linux, and macOS.

</Alert>

Expand Down
2 changes: 1 addition & 1 deletion docs/platforms/unreal/configuration/options.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -169,7 +169,7 @@ On Windows, capturing GPU crashes requires [modifying the Unreal Engine source c

<SdkOption name="UseNativeBackend" type="bool" defaultValue="false">

When enabled, the SDK uses the experimental native backend for crash reporting instead of the default Crashpad backend on Windows and Linux. This option requires a rebuild after changing.
When enabled, the SDK uses the experimental native backend for crash reporting instead of the default backend (Crashpad on Windows/Linux, sentry-cocoa on macOS). This option requires a rebuild after changing.

See <PlatformLink to="/configuration/native-backend/">Native Backend</PlatformLink> for details and additional configuration options.

Expand Down
Loading