daohualiuxiang
/
AspNetCore.Docs
mirror of https://github.com/dotnet/AspNetCore.Docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Clarify Blazor trim mode (#32884)

pull/32889/head
Luke Latham 2024-06-18 17:17:04 -04:00 committed by GitHub
parent 6d657ad241
commit 31ae211961
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 14 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
aspnetcore/blazor/host-and-deploy/configure-trimmer.md
View File

@ -18,6 +18,8 @@ Blazor WebAssembly performs [Intermediate Language (IL)](/dotnet/standard/glossa
Trimming may have detrimental effects for the published app. In apps that use [reflection](/dotnet/csharp/advanced-topics/reflection-and-attributes/), the IL Trimmer often can't determine the required types for runtime reflection and trim them away. For example, complex framework types for JS interop, such as <xref:System.Collections.Generic.KeyValuePair>, might be trimmed by default and not available at runtime for JS interop calls. In these cases, we recommend creating your own custom types instead. The IL Trimmer is also unable to react to an app's dynamic behavior at runtime. To ensure the trimmed app works correctly once deployed, test published output frequently while developing.
## Configuration
To configure the IL Trimmer, see the [Trimming options](/dotnet/core/deploying/trimming/trimming-options) article in the .NET Fundamentals documentation, which includes guidance on the following subjects:
* Disable trimming for the entire app with the `<PublishTrimmed>` property in the project file.
@ -28,6 +30,18 @@ To configure the IL Trimmer, see the [Trimming options](/dotnet/core/deploying/t
* Control symbol trimming and debugger support.
* Set IL Trimmer features for trimming framework library features.
## Default trimmer granularity
The default trimmer granularity for Blazor apps is `partial`. To trim all assemblies, change the granularity to `full` in the app's project file:
```xml
<ItemGroup>
<TrimMode>full</TrimMode>
</ItemGroup>
```
For more information, see [Trimming options (.NET documentation)](/dotnet/core/deploying/trimming/trimming-options#trimming-granularity).
## Additional resources
* [Trim self-contained deployments and executables](/dotnet/core/deploying/trimming/trim-self-contained)