SuperAPI AI 工具集

dotnet-aot-wasm

通用与其它

查看项目

更新于 10-16 02:32

技能介绍

用途:为 Blazor WASM 和 Uno WASM 应用提供 WebAssembly AOT 编译指导,覆盖编译管线、下载体积与运行速度的权衡、裁剪配合、程序集懒加载和 Brotli 预压缩。版本基线为 .NET 8.0+,Blazor WASM AOT 自 .NET 6 起提供,Uno WASM 使用类似管线。

主要能力:分析体积与速度权衡(IL 解释器体积最小、启动最快但执行最慢;全量 AOT 体积最大、执行最快但启动较慢;选择性 AOT 加裁剪较为均衡)。Blazor WASM 通过 RunAOTCompilation 启用 AOT,仅在 dotnet publish 时生效,dotnet run/build 不生效。可用 BlazorWebAssemblyLazyLoad 标记非关键程序集,使其走 IL 解释而非 AOT,实现选择性 AOT。Uno 5+ 与 .NET 8+ 使用标准 WASM 工作负载,配置方式与 Blazor 相同;旧版 Uno.Wasm.Bootstrap 使用 WasmShellMonoRuntimeExecutionMode。

使用方式:在 .csproj 中设置 RunAOTCompilation 为 true,配合 PublishTrimmed 与 EnableTrimAnalyzer;发布命令为 dotnet publish -c Release。懒加载通过 LazyAssemblyLoader 按需加载,可结合 Router 的 OnNavigateAsync 做路由级懒加载。Brotli 预压缩在发布时自动生成 .br 与 .gz 文件,需服务器正确提供,如 ASP.NET Core 的 UseBlazorFrameworkFiles、Nginx 的 brotli_static on。

适用场景:CPU 密集型负载、需要可预测性能的热路径、多模块应用按路由或功能懒加载。限制与注意:AOT 会增大产物体积,带宽受限或简单 CRUD 应用可跳过;不要混淆 RunAOTCompilation 与 PublishAot;不要懒加载启动即需的程序集;需验证服务器返回 content-encoding: br。原生 AOT、AOT 优先设计、裁剪安全库编写、MAUI AOT 等不在本技能范围内。