Maui iOS build error(s): The xcframework sentry.bindings.cocoa\5.10.0\lib\net8.0-ios17.0\Sentry.Bindings.Cocoa.resources.zip has an incorrect or unknown format and cannot be processed.

[WeaverSystems]

Package

Sentry

.NET Flavor

.NET

.NET Version

9.0

OS

iOS

OS Version

No response

Development Environment

Visual Studio v17.x

SDK Version

5.10

Self-Hosted Sentry Version

No response

Workload Versions

UseSentry or SentrySdk.Init call

                .UseSentry(options =>
                {
                    //The DSN is the only required setting
                    options.Dsn = **************;

#if DEBUG             
                    options.Debug = true;
                    options.TracesSampleRate = 1.0;
#else
                    options.TracesSampleRate = 0.2;
#endif

                    //All other Sentry options
                    options.IsGlobalModeEnabled = true;
                    options.IncludeTextInBreadcrumbs = true;
                    options.IncludeTitleInBreadcrumbs = true;
                    options.IncludeBackgroundingStateInBreadcrumbs = true;
                    options.AttachStacktrace = true;
                    options.CaptureFailedRequests = true;
                });

Steps to Reproduce

1. Update Visual Studio to 17.14.6 (June 2025).
2. Try and build a Maui app with iOS and/or MacCatalyst platforms included.

Expected Result

Everything should build with no errors.

Actual Result

When trying to build our Maui project we're getting the following 4 errors:

• The xcframework C:\Users******.nuget\packages\sentry.bindings.cocoa\5.10.0\lib\net8.0-ios17.0\Sentry.Bindings.Cocoa.resources.zip has an incorrect or unknown format and cannot be processed.
• Can't process the zip file 'C:\Users******..nuget\packages\sentry.bindings.cocoa\5.10.0\lib\net8.0-maccatalyst17.0\Sentry.Bindings.Cocoa.resources.zip' on this platform: the file 'Sentry-Dynamic.xcframework/ios-arm64_arm64e_x86_64-maccatalyst/Sentry.framework/PrivateHeaders' is a symlink.
• Can't process the zip file 'C:\Users******..nuget\packages\sentry.bindings.cocoa\5.10.0\lib\net8.0-maccatalyst17.0\Sentry.Bindings.Cocoa.resources.zip' on this platform: the file 'Sentry-Dynamic.xcframework/ios-arm64_arm64e_x86_64-maccatalyst/Sentry.framework/Resources' is a symlink.
• The xcframework C:\Users******..nuget\packages\sentry.bindings.cocoa\5.10.0\lib\net8.0-maccatalyst17.0\Sentry.Bindings.Cocoa.resources.zip has an incorrect or unknown format and cannot be processed.

Updating Visual Studio to 17.14.6 (June 2025) is the cause - I guarantee it. Everything built correctly yesterday, but clearly Microsoft have changed something in their Maui compilation that's caused this mismatch with Sentry.

(by the way I am aware of https://docs.sentry.io/platforms/dotnet/guides/maui/troubleshooting/#visual-studio-hot-restart-incompatibility, but I don't have Hot Restart enabled, so that's not a problem, this is definitely caused by the VS update).

[Flash0ver]

Thanks, @WeaverSystems, for the bug report. And thanks for sifting through troubleshooting.

To further help us triaging:

1. From which Visual Studio version have you been upgrading from?
   • v17.13.* or less
   • v17.14.0 or greater
2. Does this error only occur when building from Visual Studio
   • or does it also occur when trying to build from the .NET SDK (dotnet build)

My initial thoughts:

• Could this issue be related to an outdated/incompatible dotnet workload?
• May currently unreleased changes alleviate the issue?
  • chore(deps): update Native SDK to v0.9.0 #4260
  • Bump .NET SDK to 9.0.301 #4272

I'll try to reproduce the issue when I'm back on a Windows machine.

[WeaverSystems]

I was upgrading from the previous VS release, so 17.14.5.

I've just tried a CLI build, unfortunately with the same result.