.NET 合并程序集(将 dll 合并到 exe 中)

0
13

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

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

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

Costura.FodyFody中的工具(加载项)之一,通常情况下只需安装前者即可,后者会自动安装。

这这边先添加一个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' />

<

发布回复

请输入评论!
请输入你的名字