Udostępnij za pośrednictwem

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ą, zobacz wersję tego artykułu platformy .NET 9.

Ostrzeżenie

Ta wersja ASP.NET Core nie jest już obsługiwana. Aby uzyskać więcej informacji, zobacz zasady pomocy technicznej platformy .NET i platformy .NET Core. Aby zapoznać się z bieżącą wersją, zobacz wersję tego artykułu platformy .NET 9.

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ą, zobacz wersję tego artykułu platformy .NET 9.

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. Przycinanie występuje 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ć przycinane i niedostępne w czasie wykonywania wywołań JS 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.

Konfigurowanie

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.

Domyślny stopień szczegółowości trymeru

Domyślny stopień szczegółowości trójściści dla Blazor aplikacji to partial. Aby przyciąć wszystkie zestawy, zmień stopień szczegółowości na full w pliku projektu aplikacji:

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

Aby uzyskać więcej informacji, zobacz Trimming options (Dokumentacja platformy.NET).

Dodatkowe zasoby