如何合并多个 .NET 程序集

任何曾今寻找过一个将多个程序合并到一个文件中的解决方案的人，可能都听说过项 ilmerge, smartassembly, 等这样的工具.

另外一个知名的方案是将dll作为资源进行嵌入(如果感兴趣，这里有一篇描述这一方案的精彩文章:从嵌入的资源出载入dll[^]).

而在某些情况中，我意识到有必要使用这些方法.如果我们有了这些汇编的源代码，我们就能通过在编译时将所有这些源代码文件导入一个项目，来获得这些东西的一个完美组合.

在这里我将尝试对如何做到这件事进行简要的描述.

为了进行演示，让我们假设我们有一个控制台应用程序 (这是我们的主程序) ，引用并且使用了两个类库 (我们的二级程序)，而我们想把它们组合成一个文件:

我们按照设想构建了这个解决方案，获取了这三个程序:

注意 myexecutable 的项目文件 (myexecutable.csproj)是一个基于xml的文件，而如果我们查看它的内容，会发现一些itemgroup节点. 这些节点博阿含定义了构建过程输入的子元素. 这些子元素可以引用需要被编译的应用程序的资源文件, 或者是一些需要被复制的资源，以及需要在构建处理中被包含进去的程序集 (如果对此感兴趣，你可以在msdn msbuild上了解到更多有关visual studio项目文件的信息).

现在让我们定位到 itemgroup 节点，里面引用了要被包含进来的程序集:

<itemgroup>
  <projectreference include="..\mylibrary1\mylibrary1.csproj">
    <project>{ea53ca82-13d7-4be1-b95a-4d9d7853d46e}</project>
    <name>mylibrary1</name>
  </projectreference>
  <projectreference include="..\mylibrary2\mylibrary2.csproj">
    <project>{c31d21f3-e86a-4581-b4e8-acae6644d19e}</project>
    <name>mylibrary2</name>
  </projectreference>
</itemgroup>

这里，我们将添加一个条件，指示在debug模式中构建 myexecutable 时要到msbuild那里去使用这些项目引用:

<itemgroupcondition="'$(configuration)'=='debug'">

而对于发布（release）模式，我们将来自 mylibrary1 和 mylibrary2 的所有源代码文件都包含进来，也进行编译. 我们会利用一个通配符文("\**\*.cs")将目录及其子目录汇总所有的cs文件都包含进来. 通配符文也会将一些我们不想要的资源代码文件包含进来(obj文件夹中的temporarygeneratedfile_[guid].cs 以及property文件夹中的assemblyinfo.cs文件就是这种情况) 因此我们将对它们进行排除:

<itemgroup condition=" '$(configuration)' == 'release' ">
  <compile include="..\mylibrary1\**\*.cs"
           exclude="..\mylibrary1\properties\assemblyinfo.cs;
                    ..\mylibrary1\obj\**;
                    ..\mylibrary1\bin\**">
    <link>mylibrary1\%(recursivedir)%(filename)%(extension)</link>
    <visible>false</visible>
  </compile>
  <compile include="..\mylibrary2\**\*.cs"
           exclude="..\mylibrary2\properties\assemblyinfo.cs;
                    ..\mylibrary2\obj\**;
                    ..\mylibrary2\bin\**">
    <link>mylibrary2\%(recursivedir)%(filename)%(extension)</link>
    <visible>false</visible>
  </compile>
</itemgroup>

这样就可以了，让我们保存 myexecutable.csproj 中的修改，并在发布模式中对解决方案进行重新构建:

我想要强调的最后一件事情就是，因为我们是在形式上将所有的程序集源文件的编译移到一个项目中, 项目需要能够编译那些文件才行. 因此你需要考虑下面这些事情:

为了能构建成功，主程序需要有二级程序所有的引用，资源，设置等等.

所有的程序集都需要用同一种 .net 语言编写.

以上就是本文所述的全部内容了，希望大家能够喜欢。