【亲测免费】 ILMerge 使用指南

ILMerge 是一款强大的工具，用于将多个 .NET 组件合并成一个单独的程序集，特别适合希望减少应用程序部署时文件数量的情况。本文档旨在指导您完成 ILMerge 的安装、使用以及基础API的调用方法。

安装指南

通过NuGet包管理器

1. 打开Visual Studio中的解决方案。
2. 在“解决方案资源管理器”中选择您的项目。
3. 右键点击“管理NuGet包”。
4. 确保选择了正确的包源（通常是“nuget.org”）。
5. 搜索ILMerge，然后选择并安装最新版本（例如3.0.29）。

命令行安装

在Visual Studio的“NuGet包管理器控制台”里运行以下命令：

Install-Package ilmerge -Version 3.0.29

项目的使用说明

ILMerge一旦安装到项目中，可以作为构建过程的一部分来使用，或者在批处理脚本中独立执行。

MSBuild集成

编辑您的.csproj文件，添加ILMerge的集成，确保ILMerge操作发生在编译后的步骤：

<Target Name="ILMerge" AfterBuild="true">
    <Exec Command="$(ILMergeConsolePath) /out:CombinedAssembly.dll $(TargetPath) OtherDependency.dll" />
</Target>

这里，$(ILMergeConsolePath)指向ILMerge的位置，而$(TargetPath)自动代表当前项目的输出DLL路径。

命令行使用

在项目目录下创建一个批处理文件(merge.bat)，包含以下内容：

@echo off
SET ILMERGE_EXE_PATH=%USERPROFILE%\.nuget\packages\ilmerge\3.0.29\tools\net452\ILMerge.exe
SET OUTPUT_DLL=MergedApp.exe
SET INPUT_DLLS=bin\Debug\App.exe;lib\MyLibrary.dll

"%ILMERGE_EXE_PATH%" /out:%OUTPUT_DLL% %INPUT_DLLS%

echo 合并完成!

这将合并指定的应用程序及其依赖库。

API使用文档

虽然ILMerge主要以命令行形式提供服务，但它的功能也支持程序化调用。具体使用需查阅其SDK文档或源代码示例，由于篇幅限制，此处不展开细节，但一般涉及调用ILMerge的公共接口进行定制合并逻辑。

小结

ILMerge简化了.NET应用程序的发布流程，通过合并多个DLL为一个来减小部署复杂度。确保在使用过程中遵循.NET框架版本兼容性和强命名策略，并仔细测试合并后的结果，以避免潜在的类型冲突或运行时错误。对于更深入的自定义需求，深入了解ILMerge提供的丰富命令行选项或是探索其程序化的API将是必要的。