Konfigurowanie programu Trimmer dla platformy ASP.NET Core Blazor

  • Artykuł

Uwaga

Nie jest to najnowsza wersja tego artykułu. Aby zapoznać się z bieżącą wersją, zapoznaj się z wersją tego artykułu platformy .NET 8.

Ważne

Te informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany, zanim zostanie wydany komercyjnie. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Aby zapoznać się z bieżącą wersją, zapoznaj się z wersją tego artykułu platformy .NET 8.

W tym artykule wyjaśniono, jak kontrolować trimmer języka pośredniego (IL) podczas kompilowania Blazor aplikacji.

Blazor WebAssembly wykonuje przycinanie języka pośredniego (IL), aby zmniejszyć rozmiar opublikowanych danych wyjściowych. Domyślnie przycinanie odbywa się podczas publikowania aplikacji.

Przycinanie może mieć szkodliwe skutki dla opublikowanej aplikacji. W aplikacjach, które używają odbicia, il trimmer często nie może określić wymaganych typów odbicia środowiska uruchomieniowego i przycinać je. Na przykład złożone typy struktur dla JS międzyoperacjności, takie jak KeyValuePair, mogą być domyślnie przycinane i niedostępne w czasie wykonywania JS wywołań międzyoperaowych. W takich przypadkach zalecamy utworzenie własnych typów niestandardowych. Program IL Trimmer nie może również reagować na dynamiczne zachowanie aplikacji w czasie wykonywania. Aby upewnić się, że przycięta aplikacja działa prawidłowo po wdrożeniu, przetestuj opublikowane dane wyjściowe często podczas opracowywania.

Aby skonfigurować program IL Trimmer, zobacz artykuł Opcje przycinania w dokumentacji podstaw platformy .NET, który zawiera wskazówki dotyczące następujących tematów:

  • Wyłącz przycinanie całej aplikacji za pomocą <PublishTrimmed> właściwości w pliku projektu.
  • Kontrolowanie, jak agresywnie nieużywane IL jest odrzucane przez IL Trimmer.
  • Zatrzymaj trymer IL od przycinania określonych zestawów.
  • Zestawy "Root" do przycinania.
  • Ostrzeżenia dotyczące powierzchni dla odzwierciedlone typy przez ustawienie <SuppressTrimAnalysisWarnings> właściwości na false wartość w pliku projektu.
  • Obsługa przycinania symboli i debugera.
  • Ustaw funkcje trymmera IL na potrzeby funkcji biblioteki platformy przycinania.

Dodatkowe zasoby