From d8204c52d706955f8dbe3a20b6623f0fa3d75aa9 Mon Sep 17 00:00:00 2001 From: Bobby Galli Date: Thu, 21 May 2026 17:55:32 -0400 Subject: [PATCH] docs(unity): document mobile hang detection (Android ANR + iOS) Add ANR Detection and Hang Detection subsections to the Unity Android and iOS docs, covering automatic reporting when native crash reporting is enabled. Also correct the stale bugsplat-ios reference to bugsplat-apple. Co-Authored-By: Claude Opus 4.7 (1M context) --- .../integrations/game-development/unity.md | 22 ++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/introduction/getting-started/integrations/game-development/unity.md b/introduction/getting-started/integrations/game-development/unity.md index bda639e..c30f4f2 100644 --- a/introduction/getting-started/integrations/game-development/unity.md +++ b/introduction/getting-started/integrations/game-development/unity.md @@ -292,9 +292,29 @@ When you build your app for Android, be sure to set `Create symbols.zip` to `Deb
+#### ANR Detection + +When native crash reporting is enabled, the bugsplat-unity plugin also reports ANRs (Application Not Responding events). No additional configuration is required. + +On the next app launch, the SDK queries the OS for ANRs that occurred during the previous session, reads the system-provided thread dump, and uploads it to BugSplat. ANR reports appear alongside crashes with the **`Android.ANR`** type. The sample project's **Hang / ANR** button triggers an ANR for testing. + +{% hint style="info" %} +ANR detection requires Android 11 (API level 30) or higher at runtime. On older versions it is silently disabled, while native crash reporting continues to work. +{% endhint %} + ### 🍎 iOS -The bugsplat-unity plugin supports crash reporting for native C++ crashes on iOS via bugsplat-ios. To configure crash reporting for iOS, set the `UseNativeCrashReportingForIos` and `UploadDebugSymbolsForIos` properties to `true` on the BugSplatManager instance. +The bugsplat-unity plugin supports crash reporting for native C++ crashes on iOS via bugsplat-apple. To configure crash reporting for iOS, set the `UseNativeCrashReportingForIos` and `UploadDebugSymbolsForIos` properties to `true` on the BugSplatManager instance. + +#### Hang Detection + +When native crash reporting is enabled, the bugsplat-unity plugin also detects fatal main-thread hangs. No additional configuration is required. + +If the main thread stays unresponsive past the detection threshold and the app is then terminated without recovering — by the OS watchdog at launch or resume, or by the user force-quitting — BugSplat uploads a hang report on the next launch. Hangs the app recovers from are not reported. Hang reports carry the exception name **`App Hang (Fatal)`**. The sample project's **Hang / ANR** button triggers a hang for testing. + +{% hint style="info" %} +Hang detection is suppressed while a debugger is attached. Test it on a build run without the Xcode debugger. +{% endhint %} ### 🧩 API