開發程序的時候常常會引用一些第三方的DLL,而後編譯生成的exe文件就不能脫離這些DLL獨立運行了。git
可是,不少時候咱們本想開發一款只須要一個exe就能完美運行的小工具。那該怎麼辦呢?github
下文介紹一種超簡單的方法,不用寫一行代碼就可輕鬆實現。框架
這裏咱們須要用到一款名爲Fody.Costura的工具。Fody.Costura是一個Fody框架下的插件,可經過Nuget安裝到VS工程中。安裝以後,就能夠將項目所依賴的DLL(甚至PDB)文件所有打包到EXE文件裏。函數
構建完成後,到項目的輸出目錄下找到新生成的EXE文件,你同時會發現輸出目錄下仍然存在那些DLL。不過不用擔憂,這個EXE已經可以獨立運行了。你能夠把這些DLL所有刪除後再運行EXE試試。工具
另外,Fody.Costura還支持一些進階的特性,例如:ui
以上這些進階特性都須要你經過修改Fody.Costura的配置文件來實現,具體的操做步驟能夠參考它的官方文檔。spa
好了,Fody.Costura的使用方式已經介紹完了。若是你對Fody.Costura的實現原理感到好奇,能夠接着往下看。插件
當CLR試圖加載一個程序集但加載失敗時,它會引起AppDomain.AssemblyResolve事件。咱們的程序能夠監聽這個事件,而且在這個事件的處理函數中返回這個CLR試圖加載的程序集,從而使程序得以繼續正常運行。code
Fody.Costura在構建項目時會把EXE引用到的DLL所有嵌入到EXE文件中。當程序在運行的過程當中用到其中某個DLL的時候(此時因爲CLR沒法找到該DLL文件,致使AppDomain.AssemblyResolve事件被觸發)再從EXE文件的嵌入資源中提取所需的DLL。xml
下面這兩個函數就是Fody.Costura實現這部分邏輯的代碼。
public static void Attach() { var currentDomain = AppDomain.CurrentDomain; currentDomain.AssemblyResolve += (s, e) => ResolveAssembly(e.Name); }
public static Assembly ResolveAssembly(string assemblyName) { if (nullCache.ContainsKey(assemblyName)) { return null; } var requestedAssemblyName = new AssemblyName(assemblyName); var assembly = Common.ReadExistingAssembly(requestedAssemblyName); if (assembly != null) { return assembly; } Common.Log("Loading assembly '{0}' into the AppDomain", requestedAssemblyName); assembly = Common.ReadFromEmbeddedResources(assemblyNames, symbolNames, requestedAssemblyName); if (assembly == null) { nullCache.Add(assemblyName, true); // Handles retargeted assemblies like PCL if (requestedAssemblyName.Flags == AssemblyNameFlags.Retargetable) { assembly = Assembly.Load(requestedAssemblyName); } } return assembly; }
能夠看到,Attach方法監聽了AppDomain.AssemblyResolve事件。當CLR沒法成功加載某個程序集時, AssemblyResolve事件處理函數會被執行。AssemblyResolve會嘗試經過Common.ReadFromEmbeddedResources方法從已加載的程序集的嵌入資源中獲取目標程序集,並返回給CLR。
看到這裏,你可能會問,Attach方法是在何時執行的呢?
實際上是這樣的,對於C#語言來講,CLR隱藏了一個大招——CLR能夠在每一個模塊(每一個程序集都含有一個或多個模塊)加載以前執行一些初始化的代碼。可是很遺憾,C#語言沒法控制這部分代碼。Fody.Costura則是在內部將IL代碼直接注入到EXE程序集內部模塊的初始化函數中,而這部分IL代碼其實就是執行了Attach方法。這樣一來,EXE程序集被加載後,Attach方法就可以當即獲得調用了。
以上就是Fody.Costura實現原理的簡單介紹。
問題1:安裝完Costura.Fody以後再編譯解決方案,報錯:FodyWeavers.xml文件找不到;或者編譯後發現執行文件EXE仍是隻有幾十KB的大小(並未包含DLL文件)。
報錯緣由:Costura.Fody是依賴Fody的,一般在安裝Fody時,FodyWeavers.xml經過 NuGet的內容功能進行部署。然而,在高版本NuGet ,沒有自動建立FodyWeavers.xml文件。
解決方法:本身手動添加FodyWeavers.xml文件。將鼠標移動到你的解決方案上面,單擊右鍵,依次選擇「添加」 - 「新建項目」 - 「 XML文件 」,注意在新建XML文件時將文件命名爲「 FodyWeavers.xml 「,而後將下面這段代碼複製到 FodyWeavers.xml文件裏面便可。
<?xml version="1.0" encoding="utf-8" ?> <Weavers> </Weavers>
問題2:最近在用VS2013去生成獨立EXE文件的時候報錯:"Fody is only supported on MSBuild 16 and above. Current version: 15."
報錯緣由:由於VS2013版本過舊,如今Fody到5.0+,Costura.Fody到4.0+,不支持低版本VS。聽說是有意爲之,但願你們都使用最新的VS。
解決方法:卸載掉項目中的Fody和Costura.Fody,而後手動安裝低版本的Fody和Costura.Fody。
能夠在VS的程序包管理器控制檯中輸入Install-Package Fody -Version 4.2.1來安裝4.2.1版本的Fody,而後輸入Install-Package Costura.Fody -Version 3.3.3來安裝3.3.3版本的Costura.Fody。