Настройка средства обрезки для ASP.NET Core Blazor

  • Статья

Примечание.

Это не последняя версия этой статьи. В текущем выпуске см . версию .NET 8 этой статьи.

Предупреждение

Эта версия ASP.NET Core больше не поддерживается. Дополнительные сведения см. в статье о политике поддержки .NET и .NET Core. В текущем выпуске см . версию .NET 8 этой статьи.

Внимание

Эта информация относится к предварительному выпуску продукта, который может быть существенно изменен до его коммерческого выпуска. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

В текущем выпуске см . версию .NET 8 этой статьи.

В этой статье объясняется, как управлять триммером промежуточного Blazor языка (IL) при создании приложения.

Blazor WebAssembly выполняет обрезку промежуточного языка (IL) для уменьшения размера публикуемых выходных данных. Обрезка возникает при публикации приложения.

Обрезка может иметь негативные последствия для опубликованного приложения. В приложениях, использующих отражение, триммер IL часто не может определить необходимые типы для отражения среды выполнения и обрезать их. Например, сложные типы платформ для JS взаимодействия, например KeyValuePair, могут быть обрезаны и недоступны во время выполнения для JS вызовов взаимодействия. В этих случаях рекомендуется создать собственные пользовательские типы. Триммер IL также не может реагировать на динамическое поведение приложения во время выполнения. Чтобы обеспечить правильную работу обрезанного приложения после его развертывания, следует часто тестировать публикуемые выходные данные во время разработки.

Настройка

Сведения о настройке триммера IL см . в статье "Параметры обрезки " в документации по основам .NET, которая содержит рекомендации по следующим темам:

  • Отключение обрезки для всего приложения со свойством <PublishTrimmed> в файле проекта.
  • Контроль того, как агрессивно неиспользуемый IL удаляется триммером IL.
  • Остановите триммер IL от обрезки определенных сборок.
  • "Корневые" сборки для усечения.
  • Отображение предупреждений для отраженных типов путем присвоения свойству <SuppressTrimAnalysisWarnings> значения false в файле проекта.
  • Управление обрезкой символов и поддержкой отладчика.
  • Настройка функций триммера IL для обрезки функций библиотеки платформы.

Степень детализации триммера по умолчанию

Степень детализации триммера по умолчанию для Blazor приложений partial. Чтобы обрезать все сборки, измените степень full детализации в файле проекта приложения:

<ItemGroup>
  <TrimMode>full</TrimMode>
</ItemGroup>

Дополнительные сведения см. в разделе "Параметры обрезки" (документация по .NET).

Дополнительные ресурсы