**
WinForm项目打包成一个可执行的Exe文件(非安装包)
**
前言
前段时间自己开发了一些实用的小工具,但是开发过程中引入了较多的动态链接库,有托管的,有非托管的,最终弄出来,一个可执行的exe文件另外加一堆dll,并且这个exe必须得跟这一堆dll放在同一个文件夹里面才可以执行,这显然不符合我的使用要求,这时候我们就需要用到一个插件Costura.Fody,将这个工具程序变成一个可独立运行的exe文件
插件获取
1/GitHub:
https://github.com/Fody/Costura
2/从Nuget地址安装工具
lhttps://www.nuget.org/packages/Costura.Fody/.
3/从visual studio中Nuget包中直接安装
官方文档
我们可以从GitHub的官网中可以基本看到使用的方法。
里面的功能我大部分都测试了一次,有些功能有些效果,有些没有,反正我没测试出来实际用法
1/CreateTemporaryAssemblies 建立临时的程序集
我个人理解为,我们那些合并的dll,在程序使用的过程中,会临时解压出来,会让我们看得到,当程序关闭的时候,临时程序集会消失
用法:
<Costura CreateTemporaryAssemblies='true' />
2/IncludeDebugSymbols
是否合并pdb格式的调试文件
用法:
<Costura IncludeDebugSymbols='false' />
3/IncludeRuntimeReferences
是否合并含Core的dll
用法:
<Costura IncludeRuntimeReferences='false' />
4/DisableCompression
合并的dll在默认情况下是被压缩的,在加载时是否解压
用法:
<Costura DisableCompression='true' />
5/DisableCleanup
是否将dll合并,当为true时,所有dll都不再合并
用法:
<Costura DisableCleanup='true' />
6/LoadAtModuleInit
是否自动启用Costura,如果不启用的话,可以手动在代码中启用
用法:
<Costura LoadAtModuleInit='false' />
7/IgnoreSatelliteAssemblies
忽略什么程序集信息,这个我也不太懂,有懂的可以补充
用法:
<Costura IgnoreSatelliteAssemblies='true' />
8/ExcludeAssemblies / ExcludeRuntimeAssemblies
排除不合并的dll,意思是不合并的dll放在该标签内,标签名不能包含sysytem,dll,exe关键字
并且不能和IncludeAssemblies同时一起用
用法:
<Costura>
<ExcludeAssemblies>
Foo
Bar
</ExcludeAssemblies>
</Costura>
<Costura ExcludeAssemblies='Foo|Bar' />
9/IncludeAssemblies / IncludeRuntimeAssemblies
选择要合并的dll,注意,此处是合并托管dll,非托管dll不在这里合并
用法:
<Costura>
<IncludeAssemblies>
Foo
Bar
</IncludeAssemblies>
</Costura>
<Costura IncludeAssemblies='Foo|Bar' />
10/Unmanaged32Assemblies & Unmanaged64Assemblies
混合模式程序集的合并,有些dll能在x86和x64的环境都能运行,但是要设置混合模式,在用这个插件合并这混合模式dll,不能用普通dll的合并方法
用法:
<Costura>
<Unmanaged32Assemblies>
Foo32
Bar32
</Unmanaged32Assemblies>
<Unmanaged64Assemblies>
Foo64
Bar64
</Unmanaged64Assemblies>
</Costura>
<Costura
Unmanaged32Assemblies='Foo32|Bar32'
Unmanaged64Assemblies='Foo64|Bar64' />
11/PreloadOrder
预加载dll,目前没有遇到过要预加载的情况,实际效果也不知道
用法:
<Costura>
<PreloadOrder>
Foo
Bar
</PreloadOrder>
</Costura>
12/Native Libraries
本地库,该功能用于合并非托管程序集
用法:在执行项目中创建两个文件夹costura32和costura64,分别对应x86和x64的环境,在不同环境下要执行的dll分别放进去这两个文件夹上,即可进行合并
项目举例
这里我以sqlite的实现为例子 ,从Sqlite的官网得知,基于.net实现sqlite功能,我们需要以下几个dll
System.Data.SQLite.dll:托管程序集核心
x86 \ SQLite.Interop.dll:x86运行环境下非托管程序集
x64 \ SQLite.Interop.dll:x64运行环境下非托管程序集
这三个dll我们可以从官网下载,接下来我们创建一个工程,直接通过微软的Nuget工具安装Fody工具
右边选择项目,然后安装
安装完毕后,编译,VS提示栏有警告
因为真正要用到这个插件的功能,我们需要手动添加Fody插件包里面的一些文件FodyWeavers.xml
这个才是Fody真正的配置文件,上述提到的官方文档的十二个功能均在该配置文件实现。
此时我们右键单击项目,添加现有项,将FodyWeavers.xml添加进来
双击打开这个xml文件,看到如下内容
此时,我们实现将托管dll合并,将内容修改如下:(上述有提到System.Data.SQLite.dll是托管程序集核心,无论哪个环境下都需要用到)
此时我 们可以重新生成一下程序,看看debug文件下有没有生成System.Data.SQLite.dll这个文件
此时,我们已经成功将托管dll成功合并到exe里(大家可以将 标签内的 System.Data.SQLite删除掉,然后重新生成一下,对比两者的效果)
然后,我们要合并非托管程序集,我们在项目上创建两个文件夹,分别命名Costura32和Costura64,分别将x86 \ SQLite.Interop.dll和x64 \ SQLite.Interop.dll放进对应文件夹下
然后将两个dll属性中的生成操作改为嵌入的资源
这时候我们重新生成一下程序
在生成文件夹中,我们会发现没有任何dll的产生
我们将单独的exe文件拖到另外一个文件夹中,双击执行,sqlite功能正常使用!
上述步骤一定要做完,不然会发现连接sqlite数据库时会产生如下异常
有兴趣的朋友另外可以按照非托管dll合并的方法,来尝试一下合并其余文件,如配置文件,图片等,但是不确定 该方法是否能成功