當(dāng)前位置：首頁 > 编程语言 > asp.net >内容正文

asp.net

.NET 使用 ILRepack 合并多个程序集（替代 ILMerge），避免引入额外的依赖

發(fā)布時間：2023/12/4 asp.net 32 豆豆

生活随笔收集整理的這篇文章主要介紹了 .NET 使用 ILRepack 合并多个程序集（替代 ILMerge），避免引入额外的依赖小編覺得挺不錯的,現(xiàn)在分享給大家,幫大家做個參考.

我們有多種工具可以將程序集合并成為一個。比如 ILMerge、Mono.Merge。前者不可定制、運行緩慢、消耗資源（不過好消息是現(xiàn)在開源了）；后者已被棄用、不受支持且基于舊版本的 Mono.Cecil。

而本文介紹用來替代它們的 ILRepack，使用 ILRepack 來合并程序集。

ILRepack 提供了可供你項目使用的 NuGet 包。如果你在團隊項目當(dāng)中安裝了 ILRepack 的 NuGet 包，那么無論團隊其他人是否安裝了 ILRepack 的工具，都可以使用 ILRepack 工具。這可以避免要求團隊所有成員安裝工具或者將工具內(nèi)置到項目的源代碼管理中。

要以 NuGet 包的形式來使用 ILRepack，需要首先安裝 ILRepack 的 NuGet 包：

[NuGet Gallery ILRepack](https://www.nuget.org/packages/ILRepack/)

或者直接在你的項目的 csproj 文件中添加?PackageReference：

我現(xiàn)在有一個項目 Walterlv.Demo.AssemblyLoading，這是一個控制臺程序。這個程序引用了一個 NuGet 包 Ben.Demystifier。為此帶來了三個額外的依賴。

- Walterlv.Demo.AssemblyLoading.exe
- Ben.Demystifier.dll
- System.Collections.Immutable.dll
- System.Reflection.Metadata.dll

而我們可以使用 ILRepack 將這些依賴和我們生成的主程序合并成一個程序集，這樣分發(fā)程序的時候只需要一個程序集即可。

那么，我們現(xiàn)在需要編輯我們的項目文件：

我們只增加了三行，添加了一個名稱為 ILRepack 的 Target。（注意到項目文件中我有額外引用一個其他的 NuGet 包 Ben.Demystifier，這是為了演示將依賴進行合并而添加的 NuGet 包，具體是什么都沒有關(guān)系，我們只是在演示依賴的合并。）在這個 Target 里面，我們使用 Exec 的 Task 來執(zhí)行 ILRepack 命令。具體這個命令代表的含義我們在下一節(jié)介紹 ILRepack 工具的時候會詳細(xì)介紹。如果你希望在你的項目當(dāng)中進行嘗試，可以把后面那些代表程序集的名稱改為你自己項目中依賴程序集的名稱。

現(xiàn)在在編譯的時候使用命令?msbuild /t:ILRepack?就可以完成程序集的合并了。

注意，你普通編譯的話是不會進行 IL 合并的。

如果你希望常規(guī)編譯也可以進行 IL 合并，或者說希望在 Visual Studio 里面點擊生成按鈕的時候也能完成 IL 合并的話，那么你還需要增加一個跳板的編譯目標(biāo) Target。

我將這個名為?_ProjectRemoveDependencyFiles?的 Target 增加到了下面。它的目的是在?AfterBuild?這個編譯目標(biāo)完成之后（AfterTargets）執(zhí)行，然后執(zhí)行前需要先執(zhí)行（DependsOnTargets）ILRepack 這個 Target。在這個編譯目標(biāo)執(zhí)行的時候還會將原本的三個依賴刪除掉，這樣在生成的目錄下我們將只會看到我們最終期望的程序集 Walterlv.Demo.AssemblyLoading.exe 而沒有其他依賴程序集。

最終生成的輸出目錄下只有我們最終期望生成的程序集：

相比于 ILMerge，ILRepack 的命令行在盡量貼近 ILMerge 的情況下做得更加簡化了。

ilrepack /out:Walterlv.Demo.AssemblyLoading.exe Walterlv.Demo.AssemblyLoading.exe Ben.Demystifier.dll System.Collections.Immutable.dll System.Reflection.Metadata.dll

其中，/out?表示最終的輸出程序集的名稱或路徑，后面沒有前綴的參數(shù)都是需要合并的程序集的名稱或路徑。這些需要合并的參數(shù)中，第一個參數(shù)是主程序集，而后續(xù)其他的都是待合并的程序集。區(qū)別主程序集和其他程序集的原因是輸出的程序集需要有名稱、版本號等等信息，而這些信息將使用主程序集中的信息。

如果希望使用 ILRepack 的其他命令，可以考慮使用幫助命令：

或者直接訪問 ILRepack 的 GitHub 倉庫來查看用法：

gluck/il-repack: Open-source alternative to ILMerge

如果你在使用 ILRepack 合并程序集的過程中出現(xiàn)了缺少依賴的錯誤，例如下面這樣：

Mono.Cecil.AssemblyResolutionException: Failed to resolve assembly: 'xxxxxxxxx'

那么你需要做以下兩種事情中的任何一種：

將所有依賴合并；

將依賴加入搜索目錄。

將所有依賴合并指的是將缺少的依賴也一起作為命令行參數(shù)傳入要合并的程序集中。

而另一種是增加一個參數(shù)?/lib，即添加一個被搜索的依賴程序集的目錄。將這個目錄指定后，則可以正確解析依賴完成合并。而且這些依賴將成為合并后的程序集的依賴，不會合并到程序集中。

ilrepack /lib:D:\Dependencies /out:Walterlv.Demo.AssemblyLoading.exe Walterlv.Demo.AssemblyLoading.exe Ben.Demystifier.dll System.Collections.Immutable.dll System.Reflection.Metadata.dll

參考資料

gluck/il-repack: Open-source alternative to ILMerge

原文地址：https://blog.walterlv.com/post/merge-assemblies-using-ilrepack.html

.NET社區(qū)新聞，深度好文，歡迎訪問公眾號文章匯總?http://www.csharpkit.com?

總結(jié)

以上是生活随笔為你收集整理的.NET 使用 ILRepack 合并多个程序集（替代 ILMerge），避免引入额外的依赖的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。

上一篇： Dapper.Common基于Dappe
下一篇： asp.net ajax控件工具集 Au