[bobbyg603]

Summary

The public-package half of the Xbox work in #261. The GDKX build of bugsplat-windows has the same BugSplat_* C API as the desktop build, so the existing Windows bindings now also compile for UNITY_GAMECORE. The GDKX binaries are only for verified Xbox developers and ship in a separate add-on. This package doesn't reference anything from it.

• Fallback when the add-on is missing. BugSplat_Init throws DllNotFoundException, which is caught once at startup. The player logs where to get the add-on and keeps reporting managed exceptions. Every later native call already checks nativeCrashReportingEnabled.
• Desktop-only features stay desktop-only. On Xbox the crash dialog is forced off. The WER status check, SetWindowsCrashDialogEnabled and SetWindowsHangDetectionTimeout stay UNITY_STANDALONE_WIN only.
• New option. BugSplatOptions.UseNativeCrashReportingForXbox defaults to true, matching the other platforms.
• Sample. The crash scenario menu now works with a gamepad or keyboard, which it needs on Xbox. It selects the first runnable row, outlines the focused button and scrolls it into view. The feedback dialog takes focus when it opens and closes on B or Escape.
• Docs. The README gets a Consoles note and the CHANGELOG an Added entry.

Verification

This machine has no GameCore module, so the Xbox branches were exercised by adding #define UNITY_GAMECORE to a scratch copy of BugSplat.cs and building a Windows player (Unity 6000.5, Mono):

Run	Result
Normal Windows build	Builds
Windows build with the Xbox code path, desktop BugSplat.dll present	Builds and runs: native reporting starts, the WER warning is skipped
Same build with BugSplat.dll removed (no add-on)	Logs the add-on warning, native=False, managed reporting still initialized

EditMode tests pass 18/18 and PlayMode tests pass 158/158, including a new default test for UseNativeCrashReportingForXbox.

Still to do on a devkit (#261)

• A Unity GameCore build compiles with the real module (Series and Xbox One).
• A native crash uploads and symbolicates from an Xbox player with the add-on installed.
• Check the crash type. Native crashes are tagged 15 (Unity native) so the backend applies the IL2CPP line mappings; confirm that's right for Xbox dumps.
• Check the crash-completion behavior (hard terminate after upload) against the platform's process rules.
• Gated add-on: the GDKX binaries, their import settings, the post-build layout and symbol upload.

🤖 Generated with Claude Code

https://claude.ai/code/session_0153YxLptnAqnBKq5T1hyrtC

[Copilot]

🔵 Needs a closer look

Testing was limited to a desktop Mono simulation, leaving real GameCore builds and Xbox devkit validation of native-library loading/fallback, crash upload/symbolication, and process termination outstanding.

No open issues 🎉

What changed in this PR

Adds the public-package support for native Xbox crash reporting by reusing the Windows bindings with the separately distributed BugSplat Xbox add-on. Real GameCore builds and devkit validation remain pending.

Changes:

• Enables native bindings for UNITY_GAMECORE, with managed-only fallback when the native library is missing.
• Adds a default-enabled Xbox option while keeping desktop-specific controls off Xbox.
• Documents console support and tests the new option’s default.

File	Description
Tests/​Runtime/​BugSplatInitializationTests.cs	Tests that native Xbox reporting defaults to enabled.
Runtime/​Client/​BugSplatOptions.cs	Adds the Xbox native reporting option and add-on guidance.
Runtime/​BugSplat.cs	Extends Windows bindings to Xbox and handles a missing native library.
README.md	Explains console support and gated add-on access.
CHANGELOG.md	Records Xbox support, fallback behavior, and desktop-only options.

_{Review effort: Balanced}