All 7 Troubleshooting & Common Errors questions
More in Troubleshooting & Common Errors
Why does my binding show nothing and how do I debug it? How do you fix 'Java heap space'/build OutOfMemory errors on Android? Why is my CollectionView not updating when data changes? Why do I get a 'handler not found' or blank custom control? How do you troubleshoot layout issues where views are cut off or misaligned? How do you resolve iOS provisioning and code-signing errors?
Advertisement
Back to results for “Startup”
.NET MAUI › Troubleshooting & Common Errors

Why does my app crash on startup only in Release builds?

Beginner

Answer

Release enables trimming/AOT, which can strip types used via reflection (JSON models, DI by reflection, XAML resolved dynamically). Fix by using source generators, [DynamicDependency]/[DynamicallyAccessedMembers], TrimmerRootAssembly, or disabling trimming for the assembly. Reproduce with a Release build and read the native crash log.
<ItemGroup>
    <TrimmerRootAssembly Include="MyApp.Models" />
</ItemGroup>
Real-world example A Release-only crash deserializing a model is fixed by rooting the models assembly so trimming keeps its members.

Common follow-ups: Why only in Release? | How do you preserve reflected types?

Trimming Deployment Troubleshooting & Common Errors
All 7 Troubleshooting & Common Errors questions