Configurez l’outil de découpage (Trimmer) pour ASP.NET Core Blazor

Remarque

Ceci n’est pas la dernière version de cet article. Pour la version actuelle, consultez la version ASP.NET Core 8.0 de cet article.

Cet article explique comment contrôler l’outil de découpage (Trimmer) de langage intermédiaire (IL) pendant la génération d’une application Blazor.

Blazor WebAssembly effectue le découpage du langage intermédiaire (IL) pour réduire la taille de la sortie publiée. Par défaut, le découpage se produit lors de la publication d’une application.

Le découpage peut avoir des effets néfastes pour l’application publiée. Dans les applications qui utilisent la réflexion, l’outil de découpage IL est souvent incapable de déterminer les types nécessaires à la réflexion au moment de l’exécution, et de les découper. Ainsi, les types d’infrastructures complexes pour l’interopérabilité JS, par exemple KeyValuePair, peuvent être découpés par défaut, et ne pas être disponibles au moment de l’exécution pour les appels d’interopérabilité JS. Dans ce genre de situation, nous vous recommandons de créer vos propres types personnalisés à la place. L’outil de découpage IL n’est pas non plus capable de réagir au comportement dynamique d’une application au moment de l’exécution. Pour vous assurer que l’application découpée fonctionne correctement une fois déployée, testez fréquemment la sortie publiée lors du développement.

Pour configurer l’outil de découpage IL, consultez l’article Options de découpage dans la documentation relative aux notions de base de .NET, qui comprend des conseils d’aide sur les sujets suivants :

  • Désactivez le découpage pour l’ensemble de l’application avec la propriété <PublishTrimmed> dans le Fichier projet.
  • Contrôler l’intensité avec laquelle l’outil de découpage IL doit abandonner l’IL inutilisé.
  • Empêcher l’outil de découpage IL de découper des assemblys spécifiques.
  • Assemblys « racine » pour le découpage.
  • Les avertissements de surface pour les types réfléchis en définissant la propriété <SuppressTrimAnalysisWarnings> sur false dans le Fichier projet.
  • Contrôlez le découpage des symboles et la prise en charge du débogueur.
  • Définir des fonctionnalités d’outil de découpage IL pour le découpage des fonctionnalités de bibliothèque d’infrastructure.

Ressources supplémentaires