對於PC桌面應用程序而言,自動升級功能往往是必不可少的。而自動升級可以作為一個獨立的C/S系統來開發,這樣,就可以在不同的桌面應用中進行復用。本文將著重介紹OAUS的相關背景、使用方法,至於詳細的實現細節,大家可以直接下載源碼研究。如果了解了OAUS的使用,源碼的理解就非常容易了。如果需要直接部署使用自動升級系統,那麼,可下載文末的可執行程序壓縮包。
目前主流的程序自動升級策略是,重新下載最新的安裝包,然後重新安裝整個客戶端。這種方式雖然簡單直觀,但是缺陷也很明顯。比如,即使整個客戶端有100M,而本次更新僅僅只是修改了一個1k大小的dll,那也意味著要重新下載100M的全部內容。這對帶寬是極大的浪費,而且延長了升級了時間,相應地也增加了客戶茫然等待的時間。
在上述的場景中,自動升級時,我們能否只更新那個被修改了的1k的dll了?當然,使用OAUS自動升級系統可以輕松地做到這一點。OAUS自動升級系統可以對被分發的客戶端程序中的每個文件進行版本管理,每次升級的基礎單元不再是整個客戶端程序,而是其中的單個文件。針對單個文件的更新,包括三種形式:
(1)文件被修改。
(2)文件被刪除。
(3)新增加某個文件。
OAUS對這三種形式的文件更新都是支持的。每次自動升級,都可以更改N個文件、刪除M個文件、新增加L個文件。
OAUS提供了可直接執行的服務端程序和客戶端程序:AutoUpdaterSystem.Server.exe 和 AutoUpdater.exe。 OAUS服務端的目錄結構如下所示:
OAUS的客戶端與服務器之間通過TCP通信,可以在AutoUpdaterSystem.Server.exe.config配置文件中配置服務器通過哪個TCP端口提供自動升級服務。
FileFolder文件夾初始是空的,其用於部署被分發的程序的各個文件的最新版本。注意,其下的文件結構一定要與被分發的程序正常部署後的結構完全一致 -- 即相當於在FileFolder文件夾下部署一個被分發的程序。
OAUS客戶端的目錄結構如下:
可以在AutoUpdater.exe.config配置文件中配置OAUS服務器的IP、端口等信息,其內容如下所示:
<configuration> <appsettings> <!--{cke_protected}{C}%3C!%2D%2D%E6%9C%8D%E5%8A%A1%E5%99%A8IP%20%2D%2D%3E--> <add key="ServerIP" value="127.0.0.1"> <!--{cke_protected}{C}%3C!%2D%2D%E6%9C%8D%E5%8A%A1%E5%99%A8%E7%AB%AF%E5%8F%A3%2D%2D%3E--> <add key="ServerPort" value="4530"> <!--{cke_protected}{C}%3C!%2D%2D%E5%8D%87%E7%BA%A7%E5%AE%8C%E6%88%90%E5%90%8E%EF%BC%8C%E5%B0%86%E8%A2%AB%E5%9B%9E%E8%B0%83%E7%9A%84%E5%8F%AF%E6%89%A7%E8%A1%8C%E7%A8%8B%E5%BA%8F%E7%9A%84%E5%90%8D%E7%A7%B0%2D%2D%3E--> <add key="CallbackExeName" value="Demo.exe"> <!--{cke_protected}{C}%3C!%2D%2D%E4%B8%BB%E7%AA%97%E4%BD%93%E7%9A%84Title%2D%2D%3E--> <add key="Title" value="文件更新"> </add></add></add></add></appsettings> </configuration>
請注意配置的CallbackExeName,其表示當升級完成之後,將被啟動的分發程序的exe的名稱。這個CallbackExeName配置的為什麼是名稱而不是路徑了?這是因為使用和部署OAUS客戶端時是有要求的:
(1)被分發的程序的可執行文件exe必須位於部署目錄的根目錄。
(2)OAUS的客戶端(即整個AutoUpdater文件夾)也必須位於這個根目錄。
如此,AutoUpdater就知道分發程序的exe相對自己的路徑,如此就可以確定分發程序的exe的絕對路徑,所以就可以在升級完成後啟動目標exe了。另外,根據上述的兩個約定,再結合前面講到的服務端的FileFolder文件夾的結構約定,當服務端更新一個文件時,AutoUpdater便可以確定該文件在客戶端機器上的絕對路徑了。
下面我們就詳細講講如何使用OAUS來構建自動升級系統,大概的步驟如下。
(1)運行OAUS服務端。
(2)將被分發的客戶端程序的所有內容放到OAUS服務端的FileFolder文件夾下,其結構與客戶端程序正常部署後的結構要完全一致。我們以部署VideoChatSystem為例。
(3)使用OAUS服務端為被分發的客戶端程序的每個文件生成默認版本號,並創建版本信息配置文件UpdateConfiguration.xml。這個配置文件也將被客戶端使用。
點擊服務端界面上的“文件版本管理”按鈕,將彈出用於管理各個文件版本的【文件版本信息】窗體。
當用新版本的文件覆蓋老的文件後,點擊“自動掃描”按鈕,服務端就會檢索FileFolder文件夾下文件的名稱、大小、最後更新時間,然後得出本次更新結果:變化了幾個文件、新增了幾個文件、刪除了幾個文件。 自動掃描功能把之前的手動操作全部簡化了。
如果需要手動操作,可以這樣做:
雙擊列表中的任意一行,可以修改其對應文件的版本的值(int類型的數值)。注意,此列表中的版本信息與文件的真實版本屬性(比如dll的版本屬性X.X.X.X)可以是沒有任何聯系的,列表中版本的值只是用於標記文件是否被修改,所以,文件每被修改一次,其列表中對應的版本的值就應該有所增大。
當關閉【文件版本信息】窗體時,只要有某個文件版本變化,則“最後綜合版本”的值(int類型)會遞增1。通過比較OAUS的客戶端保存的“最後綜合版本”的值與OAUS的服務端最新的“最後綜合版本”的值,就可以快速地識別客戶端是否已經是最新版本了。
另外,初次打開這個窗口時,將在OAUS服務端的目錄下,自動生成一個版本信息配置文件UpdateConfiguration.xml。而且,每當通過該窗體來設置某個文件的新版本時,UpdateConfiguration.xml會自動同步更新。
(4)將UpdateConfiguration.xml添加到OAUS的客戶端程序(即上述的AutoUpdater的文件夾)中。
(5)在創建被分發的客戶端的安裝程序時,將OAUS的客戶端(即AutoUpdater的文件夾)也打包進去,並且像前面說的一樣,要將其直接部署在運行目錄(BaseDirectory)下(與分發的exe同一目錄)。
如此,准備工作就完成了,當客戶端通過安裝包安裝好了VideoChatSystem之後,其目錄結構像下面這樣:
(6)當我們有新的版本要發布時,比如要更新某個文件(因為文件被修改),那麼可以這樣做:
a.將修改後的文件拷貝到OAUS服務端的FileFolder文件夾下的正確位置(或覆蓋舊的文件)。
b.在OAUS服務端打開【文件版本信息】窗體,雙擊被修改文件所對應的Row,在彈出的窗體上修改對應文件的版本號,將版本號的數值增加。(如果是刪除舊文件或添加新文件,此處也可進行相應的操作)
(7)如此,當客戶端再啟動AutoUpdater.exe時,就會自動升級,更新那些發生變化的文件。 以下是AutoUpdater.exe運行起來後的截圖。
(8)當升級完成後,將啟動前述的OAUS客戶端配置文件中配置的回調exe。(在本例中就是VideoChatSystem.exe)
(9)OAUS客戶端會在日志文件UpdateLog.txt(位於AutoUpdater的文件夾下,在OAUS客戶端首次運行時自動生成該文件)中,記錄每次自動升級的情況。
(10)如果升級的過程中,與服務端連接中斷,則會自動重連,在重連成功後,將啟動斷點續傳。
假設某個系統是下載客戶端形式的,那麼客戶端該如何知道是否有新版本了?然後又該何時啟動AutoUpdater.exe了?
我們的經驗是這樣的:客戶端登錄成功之後,從服務器獲取“最後綜合版本”的值,然後與本地的“最後綜合版本”的值相比較,如果本地的值較小,則表示客戶端需要更新。這個過程可以這樣做到:
(1)當在OAUS服務端的FileFolder文件夾下放置了新的文件,並通過【文件版本信息】窗體正確的更新了版本號,在關閉【文件版本信息】窗體時,“最後綜合版本”的值會自動加1。
(2)系統客戶端可以通過調用OAUS.Core.VersionHelper類的靜態方法HasNewVersion()來判斷是否有新版本。
(3)如果HasNewVersion方法返回true,則通常有兩種模式:由用戶選擇是否升級,或者是強制升級。
一般而言,如果最新客戶端程序與老版本兼容,不升級也影響不大,則可以交由用戶決定是否升級;如果最新客戶端程序不兼容老版本,或者是有重大更新,則將啟動強制升級。如果流程要進入啟動升級,那麼只要啟動AutoUpdater的文件夾下AutoUpdater.exe就可以了。要注意的是,啟動AutoUpdater.exe進程後,要退出當前的客戶端進程,否則,有些文件會因為無法被覆蓋而導致更新失敗。代碼大致如下所示:
if (VersionHelper.HasNewVersion(oausServerIP,oausServerPort)) { string updateExePath = AppDomain.CurrentDomain.BaseDirectory + "AutoUpdater\\AutoUpdater.exe"; System.Diagnostics.Process myProcess = System.Diagnostics.Process.Start(updateExePath); ......//退出當前進程 }