【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文件,直接发送给别人即可使用。

相关推荐
Chris _data15 天前
WPF 学习第三天 — Modbus RTU 串口通信
hadoop·学习·wpf
布吉岛的石头15 天前
Java 程序员第 43 阶段05:微服务整合大模型,跨服务调用架构设计实战,Seata分布式事务实战
wpf
步步为营DotNet15 天前
基于.NET Aspire 实现云原生应用的高效监控与可观测性
云原生·.net·wpf
芒鸽16 天前
HarmonyOS 分布式开发实战:设备协同、数据共享与跨设备迁移
分布式·wpf·harmonyos
Volunteer Technology16 天前
Flink状态管理与容错(二)
大数据·flink·wpf
happyprince17 天前
07_verl-Trainer模块详解
人工智能·架构·wpf·强化学习
bugcome_com17 天前
WPF + Prism 技术指南与实战项目(二、模板搭建)
wpf
小满Autumn17 天前
log4net 日志框架 — 从配置到实战速查手册
笔记·c#·.net·wpf·上位机·log4net
政沅同学18 天前
基于 C# WPF + HALCON 的工业视觉算法工具框架(开源)
开发语言·c#·wpf
happyprince18 天前
03_verl-设计理念与核心原理
wpf