Skip to content

Make native the default crash backend on Windows, Linux and Xbox - #1717

Draft
tustanivsky wants to merge 12 commits into
v2from
feat/crash-backend-option
Draft

tustanivsky wants to merge 12 commits into
v2from
feat/crash-backend-option

Conversation

@tustanivsky

@tustanivsky tustanivsky commented Nov 20, 2026 •

Copy link
Copy Markdown
Collaborator

This PR replaces the UseNativeBackend bool with a CrashBackend enum (Auto, Native, Platform) and makes the native backend the default on Windows, Linux and Xbox.

A bool can't express "native by default, but Cocoa on macOS", and Auto allows changing per-platform defaults later without touching saved settings.

Key Changes

  • Breaking: UseNativeBackend is removed and no longer read. Projects that set it need to switch to CrashBackend (covered in the migration guide).
  • Auto (default) resolves to native on Windows, Linux and Xbox, and Cocoa on macOS. Platform keeps Crashpad, Breakpad or Cocoa. Native forces native everywhere it's supported.
  • Build.cs resolves the backend to link from the same setting. The config value is matched case-insensitively, like the engine does at runtime. Console extensions resolve their backend in their own Build.cs.
  • At runtime, the backend is resolved from the same setting via the new USentrySettings::IsNativeBackendEnabled(). A runtime selection that differs from the linked backend remains possible, as before.
  • Remove the experimental label and add per-value tooltips.
  • Sample uses CrashBackend=Auto. CI builds the default backend first and then switches to the alternative one (Platform on Windows/Linux, Native on macOS). Console jobs set the backend explicitly.

Documentation

@tustanivsky tustanivsky changed the title Replace UseNativeBackend with CrashBackend option and default to native backend Make native the default crash backend on Windows, Linux and Xbox Nov 21, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant