Configuración del recortador de ASP.NET Core Blazor

Nota

Esta no es la versión más reciente de este artículo. Para cambiar a la versión más reciente, use el selector de versión de ASP.NET Core en la parte superior de la tabla de contenido.

Selector de versión

Si no es posible ver el selector en una ventana estrecha del explorador, amplíe la ventana o seleccione los puntos suspensivos verticales () >Tabla de contenido.

Selector de tabla de contenido

En este artículo se explica cómo controlar el recortado de lenguaje intermedio al compilar una aplicación Blazor.

Blazor WebAssembly realiza un recorte de lenguaje intermedio (IL) para reducir el tamaño de la salida publicada. De forma predeterminada, el recorte se produce cuando se publica una aplicación.

El recorte podría tener efectos perjudiciales. En las aplicaciones que usan reflexión, el recortador a menudo no puede determinar los tipos necesarios para la reflexión en tiempo de ejecución. Para recortar las aplicaciones que usan reflexión, se debe informar al recortador sobre los tipos necesarios para la reflexión en el código de la aplicación y en los paquetes o marcos de los que esta depende. El recortador tampoco puede reaccionar a un comportamiento dinámico de la aplicación en tiempo de ejecución. Para asegurarse de que la aplicación recortada funciona correctamente una vez implementada, pruebe la salida publicada con frecuencia durante el desarrollo.

Para configurar el recortador, consulte el artículo Opciones de recorte en la documentación sobre aspectos básicos de .NET, que incluye instrucciones sobre los temas siguientes:

  • Deshabilitación del recorte para toda la aplicación con la propiedad <PublishTrimmed> en el archivo de proyecto
  • Control de la agresividad con la que el recortador descarta el IL sin usar
  • Interrupción del recorte de ensamblados específicos por parte del recortador
  • Ensamblados "raíz" para recortar
  • Obtención de advertencias para los tipos reflejados mediante el establecimiento de la propiedad <SuppressTrimAnalysisWarnings> en false en el archivo de proyecto
  • Control del recorte de símbolos y compatibilidad con el depurador.
  • Establecimiento de características del recortador para recortar características de la biblioteca de marcos.

Recursos adicionales