.NET 合并程序集（将 dll 合并到 exe 中）
背景：我们的应用程序通常都是由多个程序集组成，例如一个 exe 程序依赖于多个 dll 程序集。在某些情况下，我们希望程序的分发能够简单，单独一个 exe 就能正常运行。这种情况下，就需要将 dll 依赖项合并到 exe 主程序中。
本文章给大家讲下非常好用的NuGet 包，Costura.Fody
1.第一步：通过 NuGet 安装 Costura.Fody 和 Fody
Costura.Fody 是 Fody 中的工具（加载项）之一，通常情况下只需安装前者即可，后者会自动安装。
这这边先添加一个Newtonsoft.Json的包做实验，让结果看到更明显，后面有后面有生成前后的对比
第二步：添加 FodyWeavers.<?
第三步：编译项目
编译你的项目，看一下Debug输出目录，dll 是不是合并了
普通生成：
Costura.Fady生成：
从两张图片我们可以发现Newtonsoft的相关文件已经合并了，WindowsFormsApp1.exe的大小也发生了变化，从9KB变成了270KB
第四步：FodyWeavers.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' />
第三步：编译项目
编译你的项目，看一下Debug输出目录，dll 是不是合并了
普通生成：
Costura.Fady生成：
从两张图片我们可以发现Newtonsoft的相关文件已经合并了，WindowsFormsApp1.exe的大小也发生了变化，从9KB变成了270KB
第四步：FodyWeavers.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' />
没有评论:
发表评论