【WPF】使用Costura.Fody将工程打包为单个EXE文件

【软件介绍】

1. 什么是 Costura.Fody?

Costura.Fody 是 .NET 生态中一款极具人气的开源 NuGet 包,隶属于 Fody 工具集。它专门用于处理 .NET 应用程序的依赖项嵌入问题。对于 WPF、WinForms 或控制台应用程序,Costura.Fody 能够将项目引用的所有第三方 DLL 文件作为资源文件,直接嵌入到生成的 EXE 程序集中,从而实现"单文件"运行的效果。

2. 核心技术原理

Costura.Fody 的核心技术在于 IL Weaving(中间语言织入)。

  • 编译时处理: 当开发者编译项目时,Costura 会拦截构建过程,读取项目的引用列表。
  • 资源嵌入: 它会将所有标记为"复制本地"的 DLL 文件转换为字节数组,并作为非托管资源嵌入到 EXE 文件的内部。
  • 运行时加载: 程序运行时,Costura 会挂载到 AppDomain.AssemblyResolve 事件上。当系统试图加载某个 DLL 但在磁盘上找不到时,Costura 会自动从内存资源中读取并加载该程序集。
3. 为什么要使用它?(应用场景)

在以下场景中,Costura.Fody 是 WPF 开发者的得力助手:

  • 绿色便携软件: 希望用户下载后仅通过一个 EXE 文件即可运行,无需安装或解压,避免"DLL 地狱"。
  • 插件化开发: 防止用户误删核心 DLL 导致程序崩溃,确保程序完整性。
  • 代码保护: 相比于直接暴露在文件夹下的 DLL,嵌入到 EXE 内部的依赖项在一定程度上增加了反编译的难度(虽然不能完全替代混淆工具)。
4. 软件特点
  • 配置简单: 安装 NuGet 包后,通常会自动生成 FodyWeavers.xml 配置文件,开箱即用,绝大多数情况下无需额外配置。
  • 无运行时损耗: 依赖项嵌入是在编译时完成的,运行时的内存加载机制经过优化,对程序启动速度影响极小。
  • 兼容性强: 支持 .NET Framework 4.0+ 及 .NET Core/.NET 5+,完美兼容 WPF 项目。
  • 灵活性: 支持通过配置文件排除特定的 DLL(如某些不需要嵌入的原生库),或控制非托管 DLL 的加载方式。

【安装Costura.Fody插件】

打开nuget管理界面

在浏览页面中搜索【Costura.Fody】,添加到项目工程中

接受插件的协议

【使用Costura.Fody插件】

将工程切换为Release

点击运行等待执行完成

根据自己需要选择,建议选择停止调试。

进入工程的bin文件夹,即可看到Release文件夹,打开

文件夹中即可看到exe文件,直接发送给别人即可使用。

相关推荐
影寂ldy10 小时前
WPF导航窗体+Page页面跳转 知识点整理
wpf
He BianGu10 小时前
【WPF-Control教程】IOC 依赖注入
c#·wpf·wpf-control
He BianGu11 小时前
【WPF-Control教程】H.Extensions.Behvaiors 开发文档
c#·wpf·wpf-control
He BianGu11 小时前
【WPF-Control教程】H.Style 开发文档
c#·wpf·wpf-control
麻瓜code11 小时前
分布式锁演进:从一个用户下两单,到 Redisson,我改了四版
分布式·wpf
He BianGu12 小时前
【WPF-Control教程】MVVM 二次开发文档
c#·wpf·wpf-control
He BianGu12 小时前
【WPF-Control教程】Theme 主题系统二次开发文档
c#·wpf·wpf-control
小羊没烦恼!3 天前
分布式事务 | 使用DTM 的Saga 模式
java·linux·运维·数据库·wpf
samble4 天前
从零搭建半导体设备上位机(二):Prism + DryIoc,五个工程与区域导航怎么串起来
wpf·prism·dryioc
一条闲鱼_mytube4 天前
分布式 ID 生成方案:雪花算法与号段模式
分布式·算法·wpf