前言

在內部開發和部署 WinForm 應用程序時，如何高效地進行程序更新一直是一個常見的痛點。傳統的更新方式往往依賴于 NAS、FTP 或 HTTP 文件服務器，不僅需要額外的硬件或軟件支持，還可能涉及復雜的網絡配置（如防火墻規則調整）。對于許多小型團隊或局域網環境來說，這些要求無疑增加了部署和維護的復雜性。

今天推薦一款專為局域網設計的 WinForm 程序更新工具。該工具支持增量更新，大幅減少更新文件的大小和傳輸時間，同時無需任何額外的服務器或復雜的網絡配置。不管是客戶端還是服務端功能，都可以通過一個獨立的程序完成，真正實現了"零依賴"的更新體驗。

項目介紹

UpdateTool是一款用于文件自動更新的工具，包含測試、服務端和客戶端三個模塊。它能夠幫助用戶自動檢測并更新文件，確保客戶端文件與服務端始終保持同步。

該工具使用 C# 7.3 開發，并基于.NET Framework 4.0 構建，以兼容 Windows 7及更高版本操作系統。

傳統方式下，在局域網內更新文件通常需要通過U盤逐臺電腦進行復制粘貼替換，過程繁瑣且耗時。而 UpdateTool解決了這一問題，實現了局域網內文件的自動化更新，極大地簡化了維護流程，提高了工作效率。

使用 UpdateTool，大家可以輕松管理和分發文件更新，無需復雜的操作或額外硬件支持，讓文件管理變得更加簡單高效。

項目特點

1、自動更新

客戶端能夠自動檢測本地文件與服務端文件之間的差異，并智能執行更新操作，確保所有文件始終保持最新版本。

2、文件校驗

采用 MD5 算法對文件進行校驗，確保傳輸和更新過程中的文件完整性，防止數據損壞或丟失。

3、日志記錄

詳細記錄程序運行過程中的關鍵信息至日志文件，便于后續問題排查和維護工作。

4、測試功能

內置測試模塊，方便開發人員在開發和調試階段快速驗證功能，提升工作效率。

項目使用

1、配置文件 Update.ini

在運行程序前，需要創建一個名為 Update.ini 的配置文件。

以下是文件內容的示例及參數說明：

business_app=Test.exe
server_ip_port=192.168.43.126:8888
listening_port=8888
ignore_regexp=\.pdb$;RobotList.txt$;UpdateServer.exe$;UpdateClient.exe;UpdateTool.exe$;app.publish\\;UpdateTool.log

business_app：指定業務程序的名稱（如 Test.exe）。

server_ip_port：服務端的 IP 地址和端口號（如 192.168.43.126:8888）。

listening_port：服務端監聽的端口號（如 8888）。

ignore_regexp：需要忽略的文件或文件夾的正則表達式，多個表達式用分號分隔（如忽略 .pdb 文件、日志文件等）。

2、運行測試

編譯程序后，將生成的可執行文件命名為 UpdateTool.exe。

運行該程序即可啟動測試模式。

測試過程中：

程序會自動創建服務端和客戶端的測試目錄。

將相關文件復制到測試目錄中，并啟動服務端和業務程序以模擬更新流程。

3、運行服務端

編譯程序后，將生成的可執行文件命名為 UpdateServer.exe。

運行該程序即可啟動更新服務器：

服務器會讀取 Update.ini 配置文件。

計算本地文件的 MD5 值并建立文件列表。

啟動監聽，等待客戶端連接。

4、運行客戶端

編譯程序后，將生成的可執行文件命名為 UpdateClient.exe。

運行該程序即可啟動更新客戶端：

客戶端會讀取 Update.ini 配置文件。

從服務器獲取文件列表，并計算本地文件的 MD5 值。

對比服務器與本地文件列表，若發現差異，則自動下載并更新文件。

項目框架

1、主程序入口

Main 方法是程序的入口點，根據當前可執行文件的名稱動態調用不同的功能模塊：

UpdateTool.exe：調用 RunTest 方法，用于測試環境的模擬。

UpdateServer.exe：調用 RunServer 方法，啟動更新服務器。

UpdateClient.exe：調用 RunClient 方法，啟動更新客戶端。

Test.exe：模擬業務程序，自動啟動 UpdateClient.exe。

2、日志記錄

提供日志記錄和控制臺輸出功能：

Console_WriteLine 和 Console_Write：將消息同時輸出到控制臺并記錄到日志文件中。

LogToFile：將日志信息追加寫入日志文件，便于后續問題排查。

3、測試功能

RunTest 方法用于模擬測試流程：

創建服務端和客戶端的測試目錄，并復制相關文件。

啟動服務端和業務程序，驗證更新功能是否正常。

4、服務端功能

RunServer 方法負責啟動更新服務器：

讀取配置文件，計算本地文件的 MD5 值并生成文件列表。

啟動 TCP 監聽器，等待客戶端連接。

HandleClient 方法處理客戶端請求，返回文件列表或文件內容。

5、客戶端功能

RunClient 方法實現客戶端的核心邏輯：

讀取配置文件，從服務端獲取文件列表。

計算本地文件的 MD5 值并與服務端文件列表進行對比。

若發現差異，自動下載新文件或刪除多余文件，完成更新。

6、輔助方法

提供一系列工具方法，支持核心功能的實現：

GetNativeIPv4Address：獲取本機非回環的 IPv4 地址。

GetServerFileList：從服務端獲取文件列表。

GenerateFileList：生成指定目錄下所有文件的 MD5 值列表。

ShouldIgnore：根據正則表達式判斷文件是否需要忽略。

CalculateMD5：計算文件的 MD5 值，確保文件完整性。

ReadConfig：解析配置文件，提取運行參數。

StopProcess：停止指定名稱的進程。

UpdateFiles：更新本地文件，包括刪除多余文件和下載新文件。

ParseFileList：將文件列表字符串解析為字典格式。

DownloadFile：從服務端下載指定文件。

GetRelativePath：獲取文件的相對路徑。

AppendDirectorySeparatorChar：在路徑末尾添加目錄分隔符，確保路徑正確性。

注意事項

1、配置文件要求

確保 Update.ini 配置文件存在且內容正確。錯誤的配置可能導致程序無法正常運行。

2、網絡環境要求

服務端和客戶端需處于同一網絡環境中，且客戶端能夠正常訪問服務端的 IP 地址和端口號。請確保網絡連接暢通，避免因防火墻或網絡限制導致通信失敗。

3、日志文件查看

程序運行過程中會生成日志文件 UpdateTool.log，記錄關鍵操作和運行狀態。如遇問題，可通過查看日志文件快速定位原因。

4、業務程序管理

在更新文件時，程序會自動停止業務程序（如 Test.exe）。請確保業務程序支持正常的停止和啟動操作，以避免更新過程中出現異常。

項目源碼

Gitee：https://gitee.com/spdf00/update-tool?

總結

以上僅展示了UpdateTool 局域網程序簡易增量更新工具的部分功能。更多實用特性和詳細信息，請大家訪問項目源碼。

希望通過本文能為 WinForm 應用程序自動更新開發方面提供有價值的參考。

閱讀原文：原文鏈接