.NET MAUI 中如何为全裁剪TrimModefull应用配置 Feature Switches【免费下载链接】maui.NET MAUI is the .NET Multi-platform App UI, a framework for building native device applications spanning mobile, tablet, and desktop.项目地址: https://gitcode.com/GitHub_Trending/ma/maui当你把 .NET MAUI 应用切换到全裁剪TrimModefull或 NativeAOTPublishAottrue构建时MAUI 会在构建阶段自动调整一批功能开关Feature Switches一些依赖反射或动态代码的特性被默认关闭另一些则被强制开启。如果你的应用用到了HybridWebView、[QueryProperty]、SearchHandler.DisplayMemberName或隐式类型转换运算符就需要在 csproj 中显式声明对应的 MSBuild 属性并同步调整代码。本文基于 MAUI 仓库中的设计文档 FeatureSwitches.md 和构建目标 Microsoft.Maui.Controls.targets给出全裁剪应用下 Feature Switches 的配置路径。配置入口把 MSBuild 属性写进应用的 csprojFeature Switches 的控制方式是把对应的 MSBuild 属性放进应用的项目文件csproj中。每个 MSBuild 属性映射到一个AppContext开关Microsoft.Maui.RuntimeFeature.*构建时通过RuntimeHostConfigurationOption项写入运行时配置运行时由 RuntimeFeature.cs 中的属性读取。docs/design/FeatureSwitches.md中列出的开关与映射关系如下节选与裁剪相关的条目MSBuild 属性AppContext 开关作用MauiEnableIVisualAssemblyScanning...IsIVisualAssemblyScanningEnabled启用后MAUI 会扫描程序集中实现IVisual的类型及[assembly: Visual(...)]特性并注册这些类型MauiShellSearchResultsRendererDisplayMemberNameSupported...IsShellSearchResultsRendererDisplayMemberNameSupported禁用后SearchHandler必须始终设置ItemTemplate通过DisplayMemberName显示搜索结果不再有效MauiQueryPropertyAttributeSupport...IsQueryPropertyAttributeSupported禁用后导航时不再用[QueryProperty(...)]特性给属性赋值MauiImplicitCastOperatorsUsageViaReflectionSupport...IsImplicitCastOperatorsUsageViaReflectionSupported禁用后MAUI 在类型转换时不再查找隐式转换运算符该特性本身不兼容裁剪_MauiBindingInterceptorsSupport...AreBindingInterceptorsSupported启用时默认启用源码生成器识别SetBindingTSource, TProperty(...getter...)调用并生成优化的编译绑定MauiEnableXamlCBindingWithSourceCompilation...IsXamlCBindingWithSourceCompilationEnabled启用后XamlC 会编译所有绑定包括设置了Source的绑定MauiHybridWebViewSupported...IsHybridWebViewSupported启用HybridWebView它依赖动态 System.Text.Json 序列化特性MauiNamescopesSupported...AreNamescopesSupported控制 Namescopes/FindByName支持关闭可减小方法体大小EnableDiagnostics/EnableMauiDiagnostics...EnableDiagnostics/...EnableMauiDiagnostics开启运行期诊断VisualDiagnostics、BindingDiagnostics默认false_EnableMauiAspire...EnableMauiAspire控制 MAUI Aspire 集成特性各 MSBuild 属性到开关的默认值映射定义在Microsoft.Maui.Sdk.Before.targets中RuntimeFeature.cs 注释中的说明而TrimModefull/PublishAottrue下的覆盖逻辑在构建目标_MauiPrepareForILLink中实现。TrimModefull 时 MAUI 自动做了什么在_MauiPrepareForILLink目标里条件为$(PublishAot) true or $(TrimMode) full当对应属性未被显式设置时构建会强制采用以下默认值PropertyGroup Condition$(PublishAot) true or $(TrimMode) full MauiShellSearchResultsRendererDisplayMemberNameSupportedfalse/MauiShellSearchResultsRendererDisplayMemberNameSupported MauiQueryPropertyAttributeSupportfalse/MauiQueryPropertyAttributeSupport MauiImplicitCastOperatorsUsageViaReflectionSupportfalse/MauiImplicitCastOperatorsUsageViaReflectionSupport MauiEnableXamlCBindingWithSourceCompilationtrue/MauiEnableXamlCBindingWithSourceCompilation MauiHybridWebViewSupportedfalse/MauiHybridWebViewSupported ... /PropertyGroup也就是说全裁剪应用默认会关闭Shell 搜索结果DisplayMemberName、[QueryProperty]、隐式转换运算符反射查找、HybridWebView强制开启XamlC 对Source绑定的编译。此外MauiEnableIVisualAssemblyScanning的构建默认值为false自定义/第三方的IVisual类型不会被自动发现注册_EnableMauiAspire在优化构建Optimizetrue下自动置为false非优化构建Debug下自动置为true_MauiBindingInterceptorsSupport运行时默认就是true文档明确全裁剪和 NativeAOT 应用中必须使用它代替字符串绑定。在 csproj 中显式配置开关要覆盖上述默认行为直接在应用 csproj 中写 MSBuild 属性即可例如保留 Aspire 集成文档给出的示例并标注了风险PropertyGroup _EnableMauiAspiretrue/_EnableMauiAspire /PropertyGroup各开关按你的实际功能取舍配置。结合文档说明的典型场景要用到HybridWebView设置MauiHybridWebViewSupportedtrue/MauiHybridWebViewSupported。注意它依赖动态 System.Text.Json 序列化这正是全裁剪下默认关闭的原因。依赖[QueryProperty(...)]接收导航参数设置MauiQueryPropertyAttributeSupporttrue/MauiQueryPropertyAttributeSupport更推荐的做法是改为实现IQueryAttributable接口保持开关关闭。依赖SearchHandler.DisplayMemberName设置MauiShellSearchResultsRendererDisplayMemberNameSupportedtrue/MauiShellSearchResultsRendererDisplayMemberNameSupported替代方案是始终为SearchHandler设置自定义ItemTemplate来定义搜索结果外观。类型转换依赖隐式转换运算符设置MauiImplicitCastOperatorsUsageViaReflectionSupporttrue/MauiImplicitCastOperatorsUsageViaReflectionSupport文档建议优先改为定义自定义TypeConverter并用[TypeConverter(typeof(MyTypeConverter))]挂到类型上因为TypeConverterAttribute有助于裁剪器在某些场景下获得更好的二进制体积。自定义IVisual类型需要自动注册设置MauiEnableIVisualAssemblyScanningtrue/MauiEnableIVisualAssemblyScanning否则需要自行注册这些类型。代码适配关闭反射特性后必须改的写法_MauiBindingInterceptorsSupport启用时源码生成器会识别编译形式的SetBinding调用并生成优化绑定。全裁剪应用中要用这种绑定替代字符串绑定字符串绑定全裁剪下应避免label.BindingContext new PageViewModel { Customer new CustomerViewModel { Name John } }; label.SetBinding(Label.TextProperty, Customer.Name);编译绑定文档给出的写法label.SetBindingPageViewModel, string(Label.TextProperty, static vm vm.Customer.Name); // or with type inference: label.SetBinding(Label.TextProperty, static (PageViewModel vm) vm.Customer.Name);XAML 中的编译绑定Label Text{Binding Customer.Name} x:DataTypelocal:PageViewModel /验证与边界全裁剪配置的验证主要发生在构建期XamlC Source 编译。MauiEnableXamlCBindingWithSourceCompilation在全裁剪下默认开启后之前被 XamlC 跳过的、带Source的绑定现在会参与编译——文档提示部分绑定可能会开始产生构建错误或开始运行期失败。成功条件是构建通过且所有需要编译的绑定都带正确的x:DataType。对不应编译的绑定按文档写法显式清除数据类型{Binding MyProperty, Source{x:Reference MyTarget}, x:DataType{x:Null}}Aspire 属性的构建警告。在优化构建Optimizetrue中手动设置_EnableMauiAspire会触发构建警告MA002提示该属性不应手动设置、且在 Debug 之外使用 Aspire 可能带来生产环境的性能与安全风险。如果你构建时看到 MA002说明你正在覆盖构建系统的自动配置。裁剪生效范围。文档说明_EnableMauiAspirefalse且启用裁剪时.NET trimmer 可以消除 MAUI Aspire 相关代码路径从而减小最终应用体积——这是关闭非必要开关、配合TrimModefull减小应用体积的目标。两点边界需要留意MauiNamescopesSupported在 .NET 10 起默认true以保持完全兼容关闭它会同时影响FindByName和依赖IReferenceProvider的 MarkupExtensionEnableMauiDiagnostics未显式设置时跟随EnableDiagnostics默认false生产构建不需要额外打开诊断。配置完成后应用按TrimModefull发布即可构建系统会把你在 csproj 中设置的每个 MSBuild 属性写进运行时开关未被你覆盖的特性则保持上表中的裁剪默认值。开关清单及各特性的禁用后果参见 FeatureSwitches.md 全文。【免费下载链接】maui.NET MAUI is the .NET Multi-platform App UI, a framework for building native device applications spanning mobile, tablet, and desktop.项目地址: https://gitcode.com/GitHub_Trending/ma/maui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考