This repository hosts various tools and msbuild tasks which are used when trimming managed applications with .NET 5 and newer.
The IL Trimmer is the developer's tool that can be used to produce apps that contain only code and assembly dependencies which are necessary to run the app. It's fully integrated into
.NET SDKs via ILLink.Tasks build task and exposed via dotnet publish trimming settings.
The trimmer is always enabled for all size sensitive .NET workloads like Blazor WebAssembly, Xamarin or .NET mobile and can be manually enabled for other project types. The default apps trimming setting can be further customized by using a number of msbuild properties.
The analyzer is a tool to analyze dependencies which were recorded during trimmer processing. It tracks details about reasons and connection between elements to keep it in the resulting linked assembly. It can be used to better understand the dependencies between different types and members to help further reduce the linked output.
The tlens is another tool for developers which can be used to explore ways to reduce the size of trimmed apps or exploring libraries readiness for trimming. The tool produces a recommendation where the compiled source could be improved to produce even smaller outputs when trimmed using the trimmer.
Another tool available for developers is implemented as Roslyn Analyzer which runs on source code and warns developers about code patterns and APIs which are problematic when building code which could be used with trimmed apps.
We welcome contributions! Many developers have helped make this project better by reporting issues or contributing pull requests.
There is a shell script available in the root folder which can build the whole project and much more (build.cmd on Windows).
./build.shThe same script can be used to run all tests from the terminal. We also have integration into Visual Studio and individual tests or whole test suites can be run within IDE as well.
./build.sh -test