Costura.Fody

使用Costura.Fody将源DLL合并到目标EXE

本文为原创文章，如转载，请在网页明显位置标明原文名称、作者及网址，谢谢！

---

一、本文主要是使用Costura.Fody工具将源DLL合并到目标EXE，因此，需要从以下任一链接下载：

①从Github地址下载：

https://github.com/Fody/Costura/releases

②从百度网盘下载：

https://pan.baidu.com/s/1kV9W34b

③【推荐】从Nuget地址安装工具：

https://www.nuget.org/packages/Costura.Fody/

并从Visual Studio中的程序包管理器控制台进行安装：

PM> Install-Package Costura.Fody -Version 1.6.2

注：最新版本请打开Nuget地址进行获取

二、安装之后，Costura.dll等已经被引用进来，如下图所示：

三、新建一个引用Newtonsoft.Json.dll的解决方案，这个就借用上一篇内容【[C#]使用ILMerge将源DLL合并到目标EXE(.NET4.6.2)】的例子，解决方案下载地址：

https://pan.baidu.com/s/1jIzjpkU

代码如下：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Newtonsoft.Json;
using Newtonsoft.Json.Linq;

namespace ConsoleApp12
{
    class Program
    {
        static void Main(string[] args)
        {
            List<Person> list = new List<Person>()
            {
                new Person(){ ID = 1, Name = "ABC" },
                new Person(){ ID = 2, Name = "XYZ" },
            };
            var result = JsonConvert.SerializeObject(list);
            JArray jArray = JArray.Parse(result);
            foreach(var item in jArray)
            {
                Console.WriteLine($"ID:{(int)item["ID"]},Name:{(string)item["Name"]}");
            }
            Console.ReadKey();
        }
    }

    class Person
    {
        public int ID { set; get; }
        public string Name { set; get; }
    }
}

引用的Newtonsoft.Json.dll如上一张图片所示。

四、点击运行按钮，然后在bin/Debug文件夹下看能生成的文件如下：

从以上图片可以看出，生成的文件没有包含Newtonsoft.Json.dll与Costura.dll没有被生成，只有三个文件。

我们可以删除ConsoleApp.exe.config及ConsoleApp12.pdb文件，留下ConsoleApp12.exe文件即可，ConsoleApp12.exe能单独运行。

五、我们可以使用ILSpy.exe查看刚才生成之后的ConsoleApp12.exe，如下图所示：

从以上可以看出，可以使用Costura.Fody将源DLL合并到目标EXE。

本文主要是使用微软的ILMerge工具将源DLL合并到目标EXE，因此，需要下载以下工具：

https://www.microsoft.com/en-us/download/details.aspx?id=17630

或在百度网盘下载：

https://pan.baidu.com/s/1qYyqJCC

将该软件进行确定性安装即可。

工具安装完毕后，需使用cmd命令提示符进入该目录使用该工具，命令为：

CD C:\Program Files (x86)\Microsoft\ILMerge

如下图所示：

该工具的主要用法如下：

Usage: ilmerge [/lib:directory]* [/log[:filename]] [/keyfile:filename [/delaysign]] [/internalize[:filename]] 
[/t[arget]:(library|exe|winexe)] [/closed] [/ndebug] [/ver:version] [/copyattrs [/allowMultiple] [/keepFirst]] 
[/xmldocs] [/attr:filename] [/targetplatform:<version>[,<platformdir>] | /v1 | /v1.1 | /v2 | /v4] 
[/useFullPublicKeyForReferences] [/wildcards] [/zeroPeKind] [/allowDup:type]* [/union] [/align:n] 
/out:filename <primary assembly> [<other assemblies>...]

如下图所示：

打开Visual Studio 2017（或2015），引用Newtonsoft.Json.dll，并在控制台（该项目名称为：ConsoleApp12）编写以下代码：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Newtonsoft.Json;
using Newtonsoft.Json.Linq;

namespace ConsoleApp12
{
    class Program
    {
        static void Main(string[] args)
        {
            List<Person> list = new List<Person>()
            {
                new Person(){ ID = 1, Name = "ABC" },
                new Person(){ ID = 2, Name = "XYZ" },
            };
            var result = JsonConvert.SerializeObject(list);
            JArray jArray = JArray.Parse(result);
            foreach(var item in jArray)
            {
                Console.WriteLine($"ID:{(int)item["ID"]},Name:{(string)item["Name"]}");
            }
            Console.ReadKey();
        }
    }

    class Person
    {
        public int ID { set; get; }
        public string Name { set; get; }
    }
}

如下图所示：

以上源代码请在以下网盘下载：

https://pan.baidu.com/s/1pKROMh1

注意：

①Newtonsoft.Json.dll下载地址为：

https://pan.baidu.com/s/1o8gJPHo

②Newtonsoft.Json.dll的DotNetFrameWork必须运行在4.5及4.5版本以上。

点击IDE上的运行按钮，启动生成，如下图所示，将在bin/debug文件夹下生成以下文件：

如果要运行以上程序，ConsoleApp12.exe 与 Newtonsoft.Json.dll 是必不可少的，但这样子看起来好别扭，如果能合并成一个文件，多好啊。

下面的工作将对以上两个文件进行合并，会使用以上介绍的ILMerge.exe工具。

假如在D盘上的Test文件夹，将对以上两个文件进行合并，如下图所示：

现在返回到刚才的命令提示符窗体里，输入以下命令：

ilmerge /ndebug /target:exe /out:D:\Test\New_ConsoleApp12.exe /log D:\Test\ConsoleApp12.exe /log D:\Test\Newtonsoft.Json.dll /targetplatform:v4

注：/ndebug：为非调试版本，即发布版本，如果去掉，将会生成.pdb拓展名的调试文件

/target：为目标平台，此处输出为EXE

/out：合并之后输出的路径及文件名

/log：需要合并的DLL或EXE，需要把所有的合并的EXE或DLL囊括进来

/targetplatform：目标平台，此次为DotNet4.6.2，因此需要目标平台设为v4

运行之后，将会提示合并完成的信息，如下图所示：

点击新生成的New_ConsoleApp12.exe，程序将正常地运行，如下图所示：

我们可以使用ILSpy.exe查看刚才合并之后的New_ConsoleApp12.exe，如下图所示：

从以上可以看出，ConsoleApp12.exe 与 Newtonsoft.Json.dll已经合并成New_ConsoleApp12.exe。