Skip to content

Commit 874148a

Browse files
Troubleshooting symbolication on Apple platforms - .NET (#14676)
<!-- Use this checklist to make sure your PR is ready for merge. You may delete any sections you don't need. --> ## DESCRIBE YOUR PR Adding troubleshooting documentation for: - getsentry/sentry-dotnet#4427 ## IS YOUR CHANGE URGENT? Not urgent but definitely better ASAP. cc: @bruno-garcia @Flash0ver - [ X ] None: Not urgent, can wait up to 1 week+ ## PRE-MERGE CHECKLIST *Make sure you've checked the following before merging your changes:* - [ ] Checked Vercel preview for correctness, including links - [ ] PR was reviewed and approved by any necessary SMEs (subject matter experts) - [ ] PR was reviewed and approved by a member of the [Sentry docs team](https://github.com/orgs/getsentry/teams/docs)
1 parent b2c61fb commit 874148a

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

docs/platforms/dotnet/common/troubleshooting.mdx

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,42 @@ sidebar_order: 9000
44
description: "Learn more about how to troubleshoot common issues with the .NET SDK. "
55
---
66

7+
<PlatformSection supported={["dotnet.maui", "dotnet.apple"]}>
8+
9+
## Stack traces are not symbolicated on iOS, macOS and Mac Catalyst
10+
11+
When building .NET MAUI applications in release mode for iOS, macOS, or Mac Catalyst, you may see unsymbolicated stack traces in Sentry, where function names appear as memory addresses instead of readable method names.
12+
13+
This is due to **a problem in the .NET SDK** that affects how debug information is handled when building for Apple platforms in release mode. This issue has been reported to Microsoft and is being tracked in the .NET runtime repository.
14+
15+
If this issue affects your application, please:
16+
1. Visit the [.NET runtime issue](https://github.com/dotnet/runtime/issues/118700)
17+
2. Add a reaction (👍) to indicate this affects you
18+
3. Consider adding a comment describing your use case
19+
20+
This will help Microsoft prioritize the fix based on community impact.
21+
22+
### Workarounds
23+
24+
Until the issue is resolved properly, symbolication on Apple platforms is only possible by disabling stripping. For example, by adding the following to your `*.csproj` file(s):
25+
26+
```xml
27+
<PropertyGroup>
28+
<EnableAssemblyILStripping>false</EnableAssemblyILStripping>
29+
</PropertyGroup>
30+
```
31+
32+
**Important Note**: This may significantly increase the size of your application.
33+
34+
### Affected versions
35+
36+
This issue affects:
37+
- .NET 9 applications targeting iOS, macOS, and Mac Catalyst
38+
- Applications built in release mode with trimming enabled
39+
- Specifically impacts the `net9.0-ios*` target frameworks
40+
41+
</PlatformSection>
42+
743
## Sentry CLI not configured
844

945
The following message may appear in your build output:

0 commit comments

Comments
 (0)