為啥要把 WinForm 打包成獨立程序？

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

為了解決這些問題，將多個 DLL 文件打包成一個可獨立運行的 EXE 文件是個不錯的選擇。這樣做不僅可以簡化部署過程，讓用戶只需運行一個 EXE 文件就能啟動程序，提高了程序的可移植性，使其在不同的環境中都能穩定運行 。那么，如何實現這一目標呢？這就輪到 Costura.Fody 登場啦！

Costura.Fody 是個啥

Costura.Fody 是一個針對.NET 應用程序的強大打包工具，準確來說，它是 Fody 的一個插件。Fody 是一個用于.NET 程序集編織的工具集，允許開發者在編譯時修改程序集 ，而 Costura.Fody 則利用這一特性，實現了將應用程序的所有依賴項，包括 DLL 文件和資源文件，全部打包到一個單獨的可執行文件中。

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

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

實戰教程：用 Costura.Fody 打包 WinForm

新建項目

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

安裝 Costura.Fody 包

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

靜態編譯與配置文件處理

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

<Weavers>
<Costura />
</Weavers>

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

驗證編譯結果

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

解決可能遇到的問題

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

打包后的效果與優勢

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

這種打包方式大大簡化了部署流程，無論是將程序分享給同事、朋友，還是發布到網絡上供用戶下載使用，都變得更加便捷。同時，也提高了程序的安全性和穩定性，因為減少了外部依賴，降低了因依賴文件被篡改或損壞而導致程序出錯的風險 。

總結與互動

?

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

閱讀原文：原文鏈接