什么是 ASP.NET Core 静态 Web 资产？

Question

HostBuilder.ConfigureWebHostDefaults()（最终调用ConfigureWebDefaults）中有很多隐藏的魔法。我想更好地理解它，因为我找不到关于它的文档。

This code 似乎正在加载一些静态文件。什么是静态网络资产，我们为什么需要它们？这与将静态资产嵌入 Blazor 库有关吗？

builder.ConfigureAppConfiguration((ctx, cb) =>
{
    if (ctx.HostingEnvironment.IsDevelopment())
    {
        StaticWebAssetsLoader.UseStaticWebAssets(ctx.HostingEnvironment, ctx.Configuration);
    }
});

Answer 1

静态网络资产是从Razor Class Library (RCL) 提供的静态文件：

RCL 可能需要可被 RCL 的消费应用引用的伴随静态资产。 ASP.NET Core 允许创建包含可供消费应用使用的静态资产的 RCL。

UseStaticWebAssets 插入额外的file providers（StaticWebAssetsFileProvider 的实例），使用清单文件（{environment.ApplicationName}.StaticWebAssets.xml，如果未通过IConfiguration 设置）来确定从路径到基本路径的映射列表。

例如，当使用 ASP.NET Core Identity UI RCL 时，您的应用的清单文件如下所示：

<StaticWebAssets Version="1.0">
    <ContentRoot BasePath="/Identity" Path="\path\to\.nuget\packages\microsoft.aspnetcore.identity.ui\3.0.0\staticwebassets\V4" />
</StaticWebAssets>

这一切都以CompositeFileProvider 为IWebHostEnvironment.WebRootFileProvider 结束。这个复合提​​供者做了两件事：

1. 照常处理wwwroot/ 静态文件（假设默认配置）。
2. 将从wwwroot/Identity 请求的任何文件委托给已提取的用于标识 UI 的 NuGet 包内容文件夹。

正如您问题中的代码 sn-p 所示，这只发生在 Development 环境中运行时。当您的应用发布时，相关文件会被复制到wwwroot 文件夹中，就好像它们是您应用的一部分一样。