為啥要把 WinForm 打包成獨(dú)立程序？

在開發(fā).NET 應(yīng)用程序時(shí)，我們常常會遇到這樣的情況：項(xiàng)目中引用了多個(gè) DLL 文件，發(fā)布程序時(shí)，這些 DLL 文件需要和主程序一起部署。這不僅使得文件管理變得繁瑣，還可能因?yàn)?DLL 文件的丟失或版本不匹配導(dǎo)致程序無法正常運(yùn)行。例如，當(dāng)我們將開發(fā)好的 WinForm 應(yīng)用程序分享給他人使用時(shí)，如果對方的電腦上缺少某個(gè) DLL 文件，程序就會報(bào)錯(cuò)崩潰。

為了解決這些問題，將多個(gè) DLL 文件打包成一個(gè)可獨(dú)立運(yùn)行的 EXE 文件是個(gè)不錯(cuò)的選擇。這樣做不僅可以簡化部署過程，讓用戶只需運(yùn)行一個(gè) EXE 文件就能啟動程序，提高了程序的可移植性，使其在不同的環(huán)境中都能穩(wěn)定運(yùn)行 。那么，如何實(shí)現(xiàn)這一目標(biāo)呢？這就輪到 Costura.Fody 登場啦！

Costura.Fody 是個(gè)啥

Costura.Fody 是一個(gè)針對.NET 應(yīng)用程序的強(qiáng)大打包工具，準(zhǔn)確來說，它是 Fody 的一個(gè)插件。Fody 是一個(gè)用于.NET 程序集編織的工具集，允許開發(fā)者在編譯時(shí)修改程序集 ，而 Costura.Fody 則利用這一特性，實(shí)現(xiàn)了將應(yīng)用程序的所有依賴項(xiàng)，包括 DLL 文件和資源文件，全部打包到一個(gè)單獨(dú)的可執(zhí)行文件中。

在以往，當(dāng)我們開發(fā)一個(gè).NET 應(yīng)用程序時(shí)，項(xiàng)目中引用的眾多 DLL 文件就像一個(gè)個(gè)零散的零件，需要小心翼翼地與主程序一起部署。稍有不慎，比如 DLL 文件丟失或者版本不匹配，程序就可能無法正常運(yùn)行。而 Costura.Fody 的出現(xiàn)，就像是給這些零散的零件找到了一個(gè)堅(jiān)固的收納盒，將它們整合在一起，形成一個(gè)獨(dú)立的整體。

使用 Costura.Fody，不僅能簡化部署過程，降低因依賴項(xiàng)問題導(dǎo)致程序出錯(cuò)的概率，還能提高程序的可移植性。你只需將這個(gè)單獨(dú)的 EXE 文件交給用戶，用戶無需再為繁瑣的依賴項(xiàng)配置而煩惱，直接運(yùn)行即可，就像使用一個(gè)無需額外組裝的成品一樣方便 。

實(shí)戰(zhàn)教程：用 Costura.Fody 打包 WinForm

新建項(xiàng)目

首先，我們需要在 Visual Studio 中新建一個(gè) WinForm 項(xiàng)目。打開 Visual Studio，點(diǎn)擊 “文件” -> “新建” -> “項(xiàng)目” 。在彈出的 “新建項(xiàng)目” 對話框中，選擇 “Windows 窗體應(yīng)用（.NET Framework）” ，然后輸入項(xiàng)目名稱，點(diǎn)擊 “確定” 。這就好比搭建一座房子，先為它選好一塊合適的 “地基” ，確定好項(xiàng)目的基本框架。

安裝 Costura.Fody 包

在解決方案資源管理器中，右鍵點(diǎn)擊項(xiàng)目名稱，選擇 “管理 NuGet 包” 。在彈出的 “管理 NuGet 包” 窗口中，切換到 “瀏覽” 選項(xiàng)卡，在搜索框中輸入 “Costura.Fody” ，然后點(diǎn)擊 “安裝” 。這里要注意，在安裝前務(wù)必確認(rèn)所選版本是否支持你的項(xiàng)目所使用的.NET Framework 版本，以及是否存在其他依賴項(xiàng)，以免后續(xù)出現(xiàn)兼容性問題。就像安裝軟件時(shí)，要先看看它是否與你的電腦系統(tǒng)匹配一樣 。

靜態(tài)編譯與配置文件處理

安裝完成后，重新編譯項(xiàng)目。此時(shí)，你會發(fā)現(xiàn)項(xiàng)目中多了一個(gè)隱藏的 FodyWeavers.xml 文件，這意味著配置文件已經(jīng)成功生成。通常情況下，這個(gè)文件的默認(rèn)配置就足以滿足我們的需求，無需進(jìn)行額外修改。但如果你的項(xiàng)目有特殊要求，也可以根據(jù)實(shí)際情況進(jìn)行調(diào)整。如果編譯后沒有發(fā)現(xiàn)這個(gè)文件，那就需要手動添加。具體步驟如下：在解決方案資源管理器中，右鍵點(diǎn)擊項(xiàng)目名稱，選擇 “添加” -> “新建項(xiàng)” 。在彈出的 “添加新項(xiàng)” 對話框中，選擇 “XML 文件” ，并將文件名命名為 “FodyWeavers.xml” ，然后點(diǎn)擊 “添加” 。接著，在新添加的 FodyWeavers.xml 文件中，輸入以下內(nèi)容：

<Weavers>
<Costura />
</Weavers>

這樣，就完成了手動添加配置文件的操作。

驗(yàn)證編譯結(jié)果

編譯項(xiàng)目后，打開項(xiàng)目的 bin/Debug/ 或 bin/Release/ 目錄，找到生成的 EXE 文件。此時(shí)，你可以檢查一下，看看所有依賴的 DLL 文件是否都已經(jīng)成功打包到這個(gè) EXE 文件中。如果在這個(gè)目錄下沒有發(fā)現(xiàn)其他多余的 DLL 文件，那就說明我們的配置成功了。這就好比檢查一個(gè)包裹，看看里面是不是裝好了所有需要的東西 。

解決可能遇到的問題

有時(shí)候，即使我們按照上述步驟進(jìn)行了配置，還是可能會出現(xiàn)某些 DLL 文件仍然存在于輸出目錄中的情況。這可能是因?yàn)檫@些 DLL 文件的加載方式比較特殊，Costura.Fody 默認(rèn)的配置無法將它們正確打包。遇到這種情況，我們可以嘗試以下解決方法：在項(xiàng)目中創(chuàng)建一個(gè)名為 Costura64（如果是 64 位程序）或 Costura32（如果是 32 位程序）的文件夾，然后將那些無法打包的依賴文件復(fù)制到這個(gè)文件夾中。接著，在解決方案資源管理器中，右鍵點(diǎn)擊這個(gè)文件夾，選擇 “添加” -> “現(xiàn)有項(xiàng)” ，將剛才復(fù)制的文件添加到項(xiàng)目中。最后，選中這些文件，在屬性窗口中將 “生成操作” 設(shè)置為 “嵌入的資源” 。通過這些步驟，通常可以解決 DLL 文件無法打包的問題 。

打包后的效果與優(yōu)勢

經(jīng)過上述步驟，我們成功地將 WinForm 項(xiàng)目打包成了一個(gè)獨(dú)立的 EXE 文件。現(xiàn)在，這個(gè)單獨(dú)的 EXE 文件就像是一個(gè) “超級程序”，它把原本零散的 DLL 文件和其他依賴項(xiàng)都整合在了一起。用戶拿到這個(gè) EXE 文件后，無需進(jìn)行繁瑣的安裝過程，也不用擔(dān)心缺少依賴文件而導(dǎo)致程序無法運(yùn)行，只需雙擊這個(gè)文件，就能直接啟動我們的 WinForm 應(yīng)用程序，就像使用一個(gè)簡單的綠色軟件一樣方便 。

這種打包方式大大簡化了部署流程，無論是將程序分享給同事、朋友，還是發(fā)布到網(wǎng)絡(luò)上供用戶下載使用，都變得更加便捷。同時(shí)，也提高了程序的安全性和穩(wěn)定性，因?yàn)闇p少了外部依賴，降低了因依賴文件被篡改或損壞而導(dǎo)致程序出錯(cuò)的風(fēng)險(xiǎn) 。

總結(jié)與互動

?

通過使用 Costura.Fody，我們成功地將 WinForm 項(xiàng)目打包成了獨(dú)立的桌面程序，大大簡化了部署流程，提高了程序的可移植性和穩(wěn)定性 。在這個(gè)過程中，我們從新建項(xiàng)目開始，一步步安裝 Costura.Fody 包，進(jìn)行靜態(tài)編譯和配置文件處理，最后驗(yàn)證編譯結(jié)果并解決可能遇到的問題，每一個(gè)步驟都至關(guān)重要。

閱讀原文：原文鏈接