Bagikan melalui

Mengonfigurasi Pemangkas untuk ASP.NET Core Blazor

  • Artikel

Catatan

Ini bukan versi terbaru dari artikel ini. Untuk rilis saat ini, lihat versi .NET 9 dari artikel ini.

Peringatan

Versi ASP.NET Core ini tidak lagi didukung. Untuk informasi selengkapnya, lihat Kebijakan Dukungan .NET dan .NET Core. Untuk rilis saat ini, lihat versi .NET 8 dari artikel ini.

Penting

Informasi ini berkaitan dengan produk pra-rilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Untuk rilis saat ini, lihat versi .NET 9 dari artikel ini.

Artikel ini menjelaskan cara mengontrol Pemangkas Bahasa Perantara (IL) saat membuat Blazor aplikasi.

Blazor WebAssembly melakukan pemangkasan Bahasa Perantara (IL) untuk mengurangi ukuran output yang diterbitkan. Pemangkasan terjadi saat menerbitkan aplikasi.

Pemangkasan mungkin memiliki efek yang merugikan untuk aplikasi yang diterbitkan. Dalam aplikasi yang menggunakan refleksi, Pemangkas IL sering tidak dapat menentukan jenis yang diperlukan untuk refleksi runtime dan memangkasnya. Misalnya, jenis kerangka kerja kompleks untuk JS interop, seperti KeyValuePair, mungkin dipangkas dan tidak tersedia saat runtime untuk JS panggilan interop. Dalam kasus ini, sebaiknya buat jenis kustom Anda sendiri sebagai gantinya. Pemangkas IL juga tidak dapat bereaksi terhadap perilaku dinamis aplikasi saat runtime. Untuk memastikan aplikasi yang dipangkas berfungsi dengan benar setelah disebarkan, uji output yang diterbitkan secara sering saat mengembangkan.

Konfigurasi

Untuk mengonfigurasi Pemangkas IL, lihat artikel Opsi pemangkasan dalam dokumentasi .NET Fundamentals, yang mencakup panduan tentang subjek berikut:

  • Nonaktifkan pemangkasan untuk seluruh aplikasi dengan <PublishTrimmed> properti dalam file proyek.
  • Kontrol bagaimana IL yang tidak digunakan secara agresif dibuang oleh Pemangkas IL.
  • Hentikan Pemangkas IL dari pemangkasan rakitan tertentu.
  • Rakitan "Root" untuk pemangkasan.
  • Peringatan permukaan untuk jenis yang tercermin dengan mengatur <SuppressTrimAnalysisWarnings> properti ke false dalam file proyek.
  • Mengontrol pemangkasan simbol dan dukungan debugger.
  • Atur fitur IL Trimmer untuk memangkas fitur pustaka kerangka kerja.

Granularitas pemangkas default

Granularitas pemangkas default untuk Blazor aplikasi adalah partial. Untuk memangkas semua rakitan, ubah granularitas menjadi full dalam file proyek aplikasi:

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

Untuk informasi selengkapnya, lihat Opsi pemangkasan (dokumentasi.NET).

Sumber Daya Tambahan: