Skip to content

Commit dfdad54

Browse files
authored
feat(Unity): Added WebGL limitations (#13637)
1 parent a65f480 commit dfdad54

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

docs/platforms/unity/troubleshooting/known-limitations.mdx

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,3 +44,20 @@ This is also why you might end up with very high line numbers (in the several th
4444
## Cysharp
4545

4646
Currently, the SDK fails to provide line numbers and source context in combination with Cysharp. For context, the SDK relies on Unity's IL2CPP backend to provide it with instruction addresses for Sentry generate line numbers in events. When using Cysharp, those instruction addresses default back to `0x0` once the stacktrace goes into the library. There is no known workaround for this.
47+
48+
## WebGL Support
49+
50+
When targeting WebGL, you have the option of setting the `PlayerSettings.WebGL.exceptionSupport`, but be mindful of the following limitations:
51+
52+
- Setting it to `WebGLExceptionSupport.None` is not supported by the SDK.
53+
- For the SDK to be able provide stack traces, the support needs to be set to `WebGLExceptionSupport.FullWithStacktrace`.
54+
- The SDK is currently not able to provide line numbers due to the IL2CPP backend not being available.
55+
56+
## Managed Stripping Level
57+
58+
When building with Unity 2019, the `ManagedStrippingLevel` needs to be set to `ManagedStrippingLevel.Low`. Otherwise, the build will fail throwing the following error:
59+
60+
```
61+
Fatal error in Unity CIL Linker
62+
System.ArgumentException: Member 'System.Void System.Runtime.CompilerServices.NullableAttribute::.ctor(System.Byte)' is declared in another module and needs to be imported
63+
```

0 commit comments

Comments
 (0)