Skip to content
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.

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

unity: android crash handler #11757

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
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
3 changes: 3 additions & 0 deletions docs/platforms/unity/native-support/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,9 @@ The native crash support for Android and iOS is achieved by modifying the genera

When choosing Android as a build target, Unity creates a Gradle project. During the Unity build process, the SDK embeds the [Android SDK](/platforms/android/), as well as the provided options, by adding it to the generated project's Android Manifest.

Note that [Unity has an Android crash handler which takes treats the crash information as a string](https://docs.unity3d.com/6000.0/Documentation/Manual/android-handle-crashes.html). This doesn't allow Sentry to symbolicate the crash and in result becomes a very low quality crash dump.
We recomment disalbing that through: `-androidChainedSignalHandlerBehavior:disabled`. For more information, [read the Unity documentation on this topic](https://docs.unity3d.com/6000.0/Documentation/Manual/android-handle-crashes.html).

Comment on lines +29 to +31
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Note that [Unity has an Android crash handler which takes treats the crash information as a string](https://docs.unity3d.com/6000.0/Documentation/Manual/android-handle-crashes.html). This doesn't allow Sentry to symbolicate the crash and in result becomes a very low quality crash dump.
We recomment disalbing that through: `-androidChainedSignalHandlerBehavior:disabled`. For more information, [read the Unity documentation on this topic](https://docs.unity3d.com/6000.0/Documentation/Manual/android-handle-crashes.html).
Note, that Unity has an [Android crash handler](https://docs.unity3d.com/6000.0/Documentation/Manual/android-handle-crashes.html), which treats crash information as a string. This doesn't allow Sentry to symbolicate the crash, which becomes a very low-quality crash dump as a result. We recommend disabling it through: `-androidChainedSignalHandlerBehavior:disabled`. For more information, [read the Unity documentation](https://docs.unity3d.com/6000.0/Documentation/Manual/android-handle-crashes.html).

### iOS

When building your game for iOS, Unity exports it as an Xcode project. By modifying that generated project, the SDK adds the [iOS SDK](/platforms/apple/guides/ios/) to provide native support. It adds the initialization code to the `main.m` and generates the options provided by the editor configuration window as `SentryOptions.m`. The SDK also copies the `SentryNativeBridge` that enables the C# layer to communicate with the iOS SDK. This means that there's no need to use the Unity [built-in crash reporting](https://docs.unity3d.com/ScriptReference/CrashReport.html) functionality.
Expand Down
Loading