合并多个 .NET 程序集 已翻译 100%

oschina 投递于 2015/03/21 07:30 (共 3 段, 翻译完成于 03-22)
阅读 4986
收藏 75
2
加载中

任何曾今寻找过一个将多个程序合并到一个文件中的解决方案的人,可能都听说过项 ILMerge, SmartAssembly, 等这样的工具.

另外一个知名的方案是将DLL作为资源进行嵌入(如果感兴趣,这里有一篇描述这一方案的精彩文章: 从嵌入的资源出载入DLL[^]).

而在某些情况中,我意识到有必要使用这些方法.
如果我们有了这些汇编的源代码,我们就能通过在编译时将所有这些源代码文件导入一个项目,来获得这些东西的一个完美组合.

在这里我将尝试对如何做到这件事进行简要的描述.

为了进行演示,让我们假设我们有一个控制台应用程序 (这是我们的主程序) ,引用并且使用了两个类库 (我们的二级程序),而我们想把它们组合成一个文件:

我们按照设想构建了这个解决方案,获取了这三个程序:

LeoXu
LeoXu
翻译于 2015/03/21 11:03
1

注意 MyExecutable 的项目文件 (MyExecutable.csproj)是一个基于XML的文件,而如果我们查看它的内容,会发现一些ItemGroup节点. 这些节点博阿含定义了构建过程输入的子元素. 这些子元素可以引用需要被编译的应用程序的资源文件, 或者是一些需要被复制的资源,以及需要在构建处理中被包含进去的程序集 (如果对此感兴趣,你可以在 MSDN MSBuild 上了解到更多有关Visual Studio项目文件的信息).

现在让我们定位到 ItemGroup 节点,里面引用了要被包含进来的程序集:

<ItemGroup>
  <ProjectReference Include="..\MyLibrary1\MyLibrary1.csproj">
    <Project>{ea53ca82-13d7-4be1-b95a-4d9d7853d46e}</Project>
    <Name>MyLibrary1</Name>
  </ProjectReference>
  <ProjectReference Include="..\MyLibrary2\MyLibrary2.csproj">
    <Project>{c31d21f3-e86a-4581-b4e8-acae6644d19e}</Project>
    <Name>MyLibrary2</Name>
  </ProjectReference>
</ItemGroup>

这里,我们将添加一个条件,指示在Debug模式中构建 MyExecutable 时要到MSBuild那里去使用这些项目引用:

<ItemGroup Condition=" '$(Configuration)' == 'Debug' ">
LeoXu
LeoXu
翻译于 2015/03/21 11:30
1

而对于发布(Release)模式,我们将来自 MyLibrary1 和 MyLibrary2 的所有源代码文件都包含进来,也进行编译. 我们会利用一个通配符文("\**\*.cs")将目录及其子目录汇总所有的CS文件都包含进来. 通配符文也会将一些我们不想要的资源代码文件包含进来(obj文件夹中的TemporaryGeneratedFile_[guid].cs 以及Property文件夹中的AssemblyInfo.cs文件就是这种情况) 因此我们将对它们进行排除:

<ItemGroup Condition=" '$(Configuration)' == 'Release' ">
  <Compile Include="..\MyLibrary1\**\*.cs"
           Exclude="..\MyLibrary1\Properties\AssemblyInfo.cs;
                    ..\MyLibrary1\obj\**;
                    ..\MyLibrary1\bin\**">
    <Link>MyLibrary1\%(RecursiveDir)%(Filename)%(Extension)</Link>
    <Visible>false</Visible>
  </Compile>
  <Compile Include="..\MyLibrary2\**\*.cs"
           Exclude="..\MyLibrary2\Properties\AssemblyInfo.cs;
                    ..\MyLibrary2\obj\**;
                    ..\MyLibrary2\bin\**">
    <Link>MyLibrary2\%(RecursiveDir)%(Filename)%(Extension)</Link>
    <Visible>false</Visible>
  </Compile>
</ItemGroup>

这样就可以了,让我们保存 MyExecutable.csproj 中的修改,并在发布模式中对解决方案进行重新构建:

我想要强调的最后一件事情就是,因为我们是在形式上将所有的程序集源文件的编译移到一个项目中, 项目需要能够编译那些文件才行. 因此你需要考虑下面这些事情:

  • 为了能构建成功,主程序需要有二级程序所有的引用,资源,设置等等.

  • 所有的程序集都需要用同一种 .NET 语言编写.

LeoXu
LeoXu
翻译于 2015/03/21 11:56
1
本文中的所有译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接。
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。
加载中

评论(13)

BinSys
BinSys
其实微软有现成的工具ILMerge~我都用这个。
Knixly
Knixly
改天试一下
web天空
web天空
之前研究过,是将DLL嵌入程序里,使用的时调出来
KBlackcn
KBlackcn
这个方法不好,还会丢失其他程序集的元数据,影响程序集级别的反射,正确的姿势应该是Costura.Fody
blu10ph
blu10ph
这些节点博阿含定义了构建过程输入的子元素. 阿含应该是包含吧?~
JRoger_
JRoger_
亲自试了一下,这种方式就是将别的项目的 cs 文件以链接的方式添加到当前项目中。大点儿的项目这样搞一下,会多出好多文件链接啊
Tian_Ya
Tian_Ya
新方法,收下
t
tsdyy
这个前提是有其他dll的源文件
JRoger_
JRoger_
这个第一次见
noo-noo
noo-noo
微软有合并程序集的工具,但这个方法是第一次见
返回顶部
顶部