如何合并多個(gè) .NET 程序集

任何曾今尋找過(guò)一個(gè)將多個(gè)程序合并到一個(gè)文件中的解決方案的人，可能都聽(tīng)說(shuō)過(guò)項(xiàng) ILMerge, SmartAssembly, 等這樣的工具.

另外一個(gè)知名的方案是將DLL作為資源進(jìn)行嵌入(如果感興趣，這里有一篇描述這一方案的精彩文章:從嵌入的資源出載入DLL[^]).

而在某些情況中，我意識(shí)到有必要使用這些方法.如果我們有了這些匯編的源代碼，我們就能通過(guò)在編譯時(shí)將所有這些源代碼文件導(dǎo)入一個(gè)項(xiàng)目，來(lái)獲得這些東西的一個(gè)完美組合.

在這里我將嘗試對(duì)如何做到這件事進(jìn)行簡(jiǎn)要的描述.

為了進(jìn)行演示，讓我們假設(shè)我們有一個(gè)控制臺(tái)應(yīng)用程序 (這是我們的主程序) ，引用并且使用了兩個(gè)類庫(kù) (我們的二級(jí)程序)，而我們想把它們組合成一個(gè)文件:

我們按照設(shè)想構(gòu)建了這個(gè)解決方案，獲取了這三個(gè)程序:

注意 MyExecutable 的項(xiàng)目文件 (MyExecutable.csproj)是一個(gè)基于XML的文件，而如果我們查看它的內(nèi)容，會(huì)發(fā)現(xiàn)一些ItemGroup節(jié)點(diǎn). 這些節(jié)點(diǎn)博阿含定義了構(gòu)建過(guò)程輸入的子元素. 這些子元素可以引用需要被編譯的應(yīng)用程序的資源文件, 或者是一些需要被復(fù)制的資源，以及需要在構(gòu)建處理中被包含進(jìn)去的程序集 (如果對(duì)此感興趣，你可以在MSDN MSBuild上了解到更多有關(guān)Visual Studio項(xiàng)目文件的信息).

現(xiàn)在讓我們定位到 ItemGroup 節(jié)點(diǎn)，里面引用了要被包含進(jìn)來(lái)的程序集:

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>

這里，我們將添加一個(gè)條件，指示在Debug模式中構(gòu)建 MyExecutable 時(shí)要到MSBuild那里去使用這些項(xiàng)目引用:

ItemGroupCondition="'$(Configuration)'=='Debug'">

而對(duì)于發(fā)布（Release）模式，我們將來(lái)自 MyLibrary1 和 MyLibrary2 的所有源代碼文件都包含進(jìn)來(lái)，也進(jìn)行編譯. 我們會(huì)利用一個(gè)通配符文("\**\*.cs")將目錄及其子目錄匯總所有的CS文件都包含進(jìn)來(lái). 通配符文也會(huì)將一些我們不想要的資源代碼文件包含進(jìn)來(lái)(obj文件夾中的TemporaryGeneratedFile_[guid].cs 以及Property文件夾中的AssemblyInfo.cs文件就是這種情況) 因此我們將對(duì)它們進(jìn)行排除:

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 中的修改，并在發(fā)布模式中對(duì)解決方案進(jìn)行重新構(gòu)建:

我想要強(qiáng)調(diào)的最后一件事情就是，因?yàn)槲覀兪窃谛问缴蠈⑺械某绦蚣次募木幾g移到一個(gè)項(xiàng)目中, 項(xiàng)目需要能夠編譯那些文件才行. 因此你需要考慮下面這些事情:

為了能構(gòu)建成功，主程序需要有二級(jí)程序所有的引用，資源，設(shè)置等等.

所有的程序集都需要用同一種 .NET 語(yǔ)言編寫(xiě).

以上就是本文所述的全部?jī)?nèi)容了，希望大家能夠喜歡。