.NET 合并程序集（将 dll 合并到 exe 中）

背景：我们的应用程序通常都是由多个程序集组成，例如一个 exe 程序依赖于多个 dll 程序集。在某些情况下，我们希望程序的分发能够简单，单独一个 exe 就能正常运行。这种情况下，就需要将 dll 依赖项合并到 exe 主程序中。

本文章给大家讲下非常好用的NuGet 包，Costura.Fody

1.第一步：通过 NuGet 安装 Costura.Fody 和 Fody

Costura.Fody 是 Fody 中的工具（加载项）之一，通常情况下只需安装前者即可，后者会自动安装。

这这边先添加一个Newtonsoft.Json的包做实验，让结果看到更明显，后面有后面有生成前后的对比

第二步：添加 FodyWeavers.xml 文件

<?xml version="1.0" encoding="utf-8" ?>
<Weavers>
  <Costura>
    <ExcludeAssemblies>
      Foo
      Bar
    </ExcludeAssemblies>
  </Costura>
</Weavers>

　　

第三步：编译项目

编译你的项目，看一下Debug输出目录，dll 是不是合并了

普通生成：

Costura.Fady生成：

从两张图片我们可以发现Newtonsoft的相关文件已经合并了，WindowsFormsApp1.exe的大小也发生了变化，从9KB变成了270KB

第四步：FodyWeavers.xml 文件的进阶讲解

1.ExcludeAssemblies

默认情况下，Costura.Fody 会将所有 Copy Local 的程序集进行合并。ExcludeAssemblies 用于指定不需要合并的程序集，注意文件名中不要后缀。

<Costura>
  <ExcludeAssemblies>
    Foo
    Bar
  </ExcludeAssemblies>
</Costura>

或者

<Costura ExcludeAssemblies='Foo|Bar' />

2.IncludeDebugSymbols

控制是否将程序集的相应 pdb 文件嵌入，默认值为 true 。

<Costura IncludeDebugSymbols='false' />

3.CreateTemporaryAssemblies

在程序运行时，将被嵌入的程序集生成到本地，默认值为 false 。如果该程序集的正常运行依赖于其物理地址，一定要启用此功能。

<Costura CreateTemporaryAssemblies='true' />

4.DisableCleanup

默认情况下，被嵌入的程序集将从编译的输出目录中清除，可通过该属性来禁用清理。

<Costura DisableCleanup='true' />

5.非托管程序集的嵌入

<Costura Unmanaged32Assemblies='Foo32|Bar32' Unmanaged64Assemblies='Foo64|Bar64'/>

6.本地库和预加载顺序

<Costura PreloadOrder='Foo|Bar' />