Zack.DotNetTrimmer 使用教程

Zack.DotNetTrimmer 使用教程

项目介绍

Zack.DotNetTrimmer 是一个用于裁剪 .NET Core 应用程序的开源工具。尽管 .NET Core 本身具有裁剪未使用代码的能力，但由于其实现基于静态分析，裁剪效果并不理想。Zack.DotNetTrimmer 解决了这一问题，它不仅支持 Windows Forms 和 WPF，还支持反射，能够更有效地裁剪未使用的程序集和类。

项目快速启动

安装与配置

1. 下载 Zack.DotNetTrimmer 可执行文件：

   git clone https://github.com/yangzhongke/Zack.DotNetTrimmer.git
   

2. 发布待裁剪的项目： 请使用自包含（self-contained）部署模式发布项目。

3. 运行 Zack.DotNetTrimmer： 在命令行中运行 Zack.DotNetTrimmer，并传递待裁剪程序的完整路径作为 --file 参数。

   Zack.DotNetTrimmer.exe --file d:\a\ASPNETCore6WebAPI1.exe
   

代码示例

以下是一个简单的示例，展示如何使用 Zack.DotNetTrimmer 裁剪一个 ASP.NET Core WebAPI 项目：

1. 发布项目：

   dotnet publish -c Release -r win-x64 --self-contained
   

2. 运行 Zack.DotNetTrimmer：

   Zack.DotNetTrimmer.exe --file d:\a\ASPNETCore6WebAPI1.exe
   

应用案例和最佳实践

自动化测试

Zack.DotNetTrimmer 支持自动化测试。可以通过录制模式记录剪裁计划，并在多个自动化测试中重复使用同一个记录文件。

自动构建

在自动构建过程中，可以提前完成剪裁计划文件的生成，并在发布完成后以应用模式运行 Zack.DotNetTrimmer，实现自动化裁剪。

典型生态项目

TeeChart 控件的 WinForms 版演示程序

使用 Zack.DotNetTrimmer 对 TeeChart 控件的 WinForms 版演示程序进行裁剪，可以显著减小程序的大小。使用默认选项裁剪后，程序大小从 161.78 MB 压缩为 79.90 MB，而使用“贪婪剪裁”选项后，程序进一步压缩为 78.38 MB。

其他 .NET Core 项目

Zack.DotNetTrimmer 同样适用于其他类型的 .NET Core 项目，如 ASP.NET Core MVC 项目、WPF 项目等，能够有效减小发布包的大小，提高部署效率。

通过以上教程，您可以快速上手并有效利用 Zack.DotNetTrimmer 进行 .NET Core 应用程序的裁剪。希望这个工具能为您的开发工作带来便利。