用途:为 .NET 8+ 应用提供完整的 Native AOT 编译与发布流程指导,覆盖 PublishAot 配置、类型保留、无反射编码、P/Invoke、二进制体积优化、自包含部署及诊断分析器。
主要能力:应用与库的 MSBuild 属性区分(应用用 PublishAot,库用 IsAotCompatible/IsTrimmable);启用 EnableAotAnalyzer 与 EnableTrimAnalyzer 分析器;用 ILLink 描述符 XML 或 [DynamicDependency] 保留类型;反射替代方案(如 JsonSerializer 源生成上下文);用 [LibraryImport] 替代 [DllImport];体积优化选项(StripSymbols、OptimizationPreference、InvariantGlobalization 等);基于 runtime-deps 镜像的自包含容器部署;ASP.NET Core Minimal API 的 AOT 支持与 CreateSlimBuilder。
使用方式:在 .csproj 设置 <PublishAot>true</PublishAot>,执行 dotnet publish -c Release -r linux-x64 等命令发布;不发布时可用 dotnet build /p:EnableAotAnalyzer=true /p:EnableTrimAnalyzer=true 获取 IL2xxx/IL3xxx 警告。
适用场景:控制台应用、ASP.NET Core Minimal API、需要小体积自包含二进制的服务。
限制:MVC 控制器、Blazor Server、SignalR 不支持 Native AOT;库项目不应设置 PublishAot;不要使用已废弃的 RD.xml;MAUI、WASM、裁剪库编写等属其他技能范围。具体版本行为以官方文档为准。