ILMerge 使用教程

ILMerge 使用教程

ILMerge项目地址:https://gitcode.com/gh_mirrors/ilm/ILMerge

ILMerge 是一个用于.NET程序的静态链接器，它能够将多个.NET程序集合并到一个单一的可执行文件中。这个教程将引导您了解如何安装、配置并使用ILMerge。

1. 项目目录结构及介绍

在下载ILMerge源代码后，您会看到如下的基本目录结构：

ILMerge/
│   README.md
│   LICENSE.txt
│
├── src/
│   ├── ILMerge.csproj
│   └── ... 其他源代码文件
│
└── tools/
    └── net452/       # 包含适用于.NET 4.5.2的ILMerge可执行文件
        └── ILMerge.exe

• README.md: 项目的基本介绍和指南。
• LICENSE.txt: 项目的许可协议。
• src/: 源代码目录，包含ILMerge的主要实现。
• tools/net452/: 存放编译好的ILMerge可执行文件，根据不同.NET框架版本可能存在其他子目录。

2. 项目启动文件介绍

ILMerge 的启动文件是 tools/net452/ILMerge.exe（或其他对应版本的目录下）。这是一个命令行工具，可以用来运行合并操作。要执行合并，你需要通过命令行调用该文件，并提供相应的参数。例如：

ILMerge.exe /target:winexe /out:merged.exe original.exe assembly1.dll assembly2.dll

上述命令会把 original.exe, assembly1.dll 和 assembly2.dll 合并成名为 merged.exe 的单一可执行文件。

3. 项目的配置文件介绍

虽然ILMerge本身没有特定的配置文件，但它可以通过MSBuild任务集成到你的构建过程中，此时配置工作通常是在你的项目文件（.csproj或.vbproj）中完成。例如，你可以添加以下MSBuild目标来自动执行ILMerge:

<Project Sdk="Microsoft.NET.Sdk">
  <ItemGroup>
    <PackageReference Include="ILMerge" Version="3.0.29" />
  </ItemGroup>
  
  <Target Name="ILMerge" AfterTargets="Build">
    <Exec Command="$(ILMergePath) /out:$(OutDir)Merged.exe $(OutDir)MyApp.exe @(Compile->'%(FullPath)', ' ')"/>
  </Target>
</Project>

这段XML会在每次成功构建之后调用ILMerge，将所有编译后的类库合并到一个名为 Merged.exe 的文件中，路径基于$(OutDir)。

请注意，实际的配置可能因你的具体需求而异，包括指定不同的合并选项，以及确保ILMerge路径（$(ILMergePath)）正确指向已安装的ILMerge可执行文件。

以上就是ILMerge的基本使用和配置说明，通过这个工具，您可以轻松地管理.NET应用程序中的依赖关系，合并多个组件为单个部署单元。

ILMerge项目地址:https://gitcode.com/gh_mirrors/ilm/ILMerge