配置 ASP.NET Core Blazor 链接器Configure the Linker for ASP.NET Core Blazor

    重要

    Blazor WebAssembly 为预览版状态

    ASP.NET Core 3.0 支持 Blazor Server。Blazor WebAssembly 在 ASP.NET Core 3.1 中为预览版。

    Blazor WebAssembly 在生成期间执行 链接,以从应用的输出程序集中剪裁不必要的 IL。在调试配置中生成时,将禁用链接器。应用必须在发布配置中生成才能启用链接器。部署 Blazor WebAssembly 应用时,建议在发布中生成。

    若要确保剪裁后的应用在部署后正常工作,请务必在开发时经常对应用的发行版本进行测试。

    可以使用以下 MSBuild 功能配置 Blazor 应用的链接:

    在 配置中生成应用时,将启用链接。若要对此进行更改,请在项目文件中配置 BlazorWebAssemblyEnableLinking MSBuild 属性:

    使用配置文件控制链接Control linking with a configuration file

    通过提供 XML 配置文件并在项目文件中将该文件指定为 MSBuild 项,按程序集控制链接:

    有关详细信息,请参阅 IL Linker:xml 描述符语法

    配置链接器以实现国际化Configure the linker for internationalization

    默认情况下,用于 Blazor WebAssembly 应用的 Blazor 链接器配置会去除国际化信息(显式请求的区域设置除外)。删除这些程序集可最大程度地缩减应用的大小。

    要控制保留哪些国际化程序集,请在项目文件中设置 <MonoLinkerI18NAssemblies> MSBuild 属性:

    各个值之间用逗号分隔(例如:mideast,west)。