每次新版本build時，讓軟體的版本號碼自增

標籤：des   style   blog   http   color   os   使用   io   strong   

VC2005利用SVN的版本號碼，產生DLL和EXE檔案的版本號碼

TortoiseSVN下有一個SubWCRev程式，可以擷取任意個路徑對應的SVN版本庫的版本號碼。並替換到檔案對應位置。

VC2005的資源檔可以控制產生的二進位檔案版本號碼。

可以利用VC2005的產生前命令，調用SubWCRev來擷取最新的SVN版本號碼並寫入產生的二進位檔案中。

程式也可以判斷調用的DLL版本號碼是否比本身大。以控制不會調用不對應的動態庫。可以使依賴多了一層運行時保證。

實現該目的，需要

• 每次編譯前，從svn擷取目前的版本庫的版本號碼，並寫入資源檔
• 編譯完成後，打安裝包時，讀取版本資訊

需要注意兩點：

1，svn的工具可擷取版本號碼並更新到專案檔

如果提供了源檔案和目的檔案，SubWCRev 會複製源檔案到目標檔案，執行如下所屬的關鍵字替換:

表 5.2. 列出可用的命令列開關

關鍵字	描述
$WCREV$	用工作副本中最高的提交版本來替換
$WCDATE$	用最高提交版本的日期/時間替換。預設使用國際化格式：yyyy-mm-dd hh:mm:ss。作為選擇，你可以指定strftime()使用自訂格式，例如：$WCDATE=%a %b %d %I:%M:%S %p$。格式字元的列表參見線上引用。
$WCNOW$	Replaced with the current system date/time. This can be used to indicate the build time. Time formatting can be used as described for$WCDATE$.
$WCRANGE$	在工作目錄用更新版本範圍替換。如果工作目錄處於一致的狀態，它是一個單一版本。如果工作目錄包含混合版本，或者是過時，或者是故意更新到版本，那麼這個範圍會用象100:200這樣的格式來顯示。
$WCMIXED$	當有混合版本時用TText替換$WCMIXED?TText:FText$，否則用FText替換。
$WCMODS$	若本地存在修改，就用TText替換$WCMODS?TText:FText$，否則用FText替換。
$WCURL$	用傳遞給SubWCRev的工作目錄的版本庫地址替換。
$WCINSVN$	$WCINSVN?TText:FText$is replaced withTTextif the entry is versioned, orFTextif not.
$WCNEEDSLOCK$	$WCNEEDSLOCK?TText:FText$is replaced withTTextif the entry has thesvn:needs-lockproperty set, orFTextif not.
$WCISLOCKED$	$WCISLOCKED?TText:FText$is replaced withTTextif the entry is locked, orFTextif not.
$WCLOCKDATE$	Replaced with the lock date. Time formatting can be used as described for$WCDATE$.
$WCLOCKOWNER$	Replaced with the name of the lock owner.
$WCLOCKCOMMENT$	Replaced with the comment of the lock.

下面的例子顯示了模版檔案中的關鍵字是如何在輸出檔案中被替換的。

// Test file for SubWCRev: testfile.tmplchar *Revision = "$WCREV$";char *Modified = "$WCMODS?Modified:Not modified$";char *Date     = "$WCDATE$";char *Range    = "$WCRANGE$";char *Mixed    = "$WCMIXED?Mixed revision WC:Not mixed$";char *URL      = "$WCURL$";#if $WCMODS?1:0$#error Source is modified#endif// End of file

After runningSubWCRev.exe path\to\workingcopy testfile.tmpl testfile.txt, the output filetestfile.txtwould looks like this:

// Test file for SubWCRev: testfile.txtchar *Revision = "3701";char *Modified = "Modified";char *Date     = "2005/06/15 11:15:12";char *Range    = "3699:3701";char *Mixed    = "Mixed revision WC";char *URL      = "http://project.domain.org/svn/trunk/src";#if 1#error Source is modified#endif// End of file

 

SubWCRev.exe從命令列或指令碼中運行，使用命令列參數控制。

SubWCRev WorkingCopyPath [SrcVersionFile DstVersionFile] [-nmdfe]

WorkingCopyPath是要檢查的工作複本路徑，你可以只對工作複本使用SubWCRev，而不是直接對版本庫，這個路徑可以是絕對路徑，也可以是工作目錄的相對路徑。

如果你想讓SubWCRev執行關鍵字替換，象版本庫版本，地址等欄位儲存到文字檔，就需要提供一個模版檔案SrcVersionFile，輸出檔案DstVersionFile就是模版替換之後的版本。

有幾個開關影響 SubWCRev工作。如果使用多個，必須用單個組指定，例如要用-nm，不能用-n -m。

表 5.1. 列出可用的命令列開關

切換	描述
-n	If this switch is given, SubWCRev will exit withERRORLEVEL 7if the working copy contains local modifications. This may be used to prevent building with uncommitted changes present.
-m	If this switch is given, SubWCRev will exit withERRORLEVEL 8if the working copy contains mixed revisions. This may be used to prevent building with a partially updated working copy.
-d	If this switch is given, SubWCRev will exit withERRORLEVEL 9if the destination file already exists.
-f	如果給出這個開關，SubWCRev 就會包含檔案夾的最後修改版本。預設行為是取得版本號碼時只考慮檔案。
-e	If this switch is given, SubWCRev will examine directories which are included withsvn:externals, but only if they are from the same repository. The default behaviour is to ignore externals.
-x	If this switch is given, SubWCRev will output the revision numbers in HEX.
-X	If this switch is given, SubWCRev will output the revision numbers in HEX, with ‘0X‘ prepended.

參考這個文檔http://tortoisesvn.net/docs/nightly/TortoiseSVN_zh_CN/tsvn-subwcrev.html

2，每次編譯版本前執行一次擷取版本號碼操作

 

以 vc6 為例, 檔案的版本資訊儲存在 rc 檔案. 編譯成 res 檔案, 然後和其他 obj 一起 link. 現在的思路就是. 編輯 rc 檔案, 將版本號碼比如 2.2.4.0 改成 2.2.4.$WCREV$, 在每次 link 之前, 先用 subwcrev.exe 處理 rc 檔案, 進行宏替換. 然後調用 rc.exe 編譯替換後的新檔案. 產生 res 之後一起 link.

. 修改 rc 檔案的 versioninfo 段成如下:
#ifdef _AUTOVERSION
FILEVERSION 2,2,4,$WCREV$
PRODUCTVERSION 2,2,4,$WCREV$
#else
FILEVERSION 2,2,4,0
PRODUCTVERSION 2,2,4,0
#endif
...
#ifdef _AUTOVERSION
VALUE "FileVersion", "2, 2, 4, $WCREV$\0"
VALUE "ProductVersion", "2, 2, 4, $WCREV$\0"
#else
VALUE "FileVersion", "2, 2, 4, 0\0"
VALUE "ProductVersion", "2, 2, 4, 0\0"
#endif

其實也就是加上了條件編譯. 預設情況下沒有定義 _AUTOVERSION, 則使用原來的 fileversion, productversion. 如果定義了 _AUTOVERSION, 則使用新的版本資訊.

. 在項目屬性找到 pre-link 頁. 在其中增加:
subwcrev\subwcrev.exe . myprogram.rc myprogram.rc_
rc.exe /l 0x804 /fo"\release\myprogram.res" /d "_AUTOVERSION" /d "_AFXDLL" "myprogram.rc_"

第一條命令處理 myprogram.rc , 產生 myprogram.rc_
第二條命令編譯 myprogram.rc_ 為 myprogram.res, 注意它的路徑. 這裡是 release 版的預設路徑. 原則就是這裡產生的 res 替換原來的 res 檔案.

按 f7, build. 現在版本資訊已經重新整理了. 每次向 svn 提交. 版本都會更新.

不過我們還可以更進一步. 將版本資訊, 編譯時間等寫入到關於對話方塊中. 其實關鍵還是 pre-link.
. 建立一個檔案 buildtime.cpp, 內容如下:
const char*szBuildTime = "Build on $WCNOW$";
const char*szFullVersion="MyProgram 2.2.4.$WCREV$$WCMODS?+:$$WCMIXED?#:$";

. 在關於對話方塊 OnInitDialog() 中加入:
extern const char* szBuildTime;
extern const char* szFullVersion;
SetDlgItemText(IDC_BUILDTIME, szBuildTime);
SetDlgItemText(IDC_VERSION, szFullVersion);

. 在 pre-link 再加上兩條:
subwcrev\subwcrev.exe . buildtime.cpp buildtime_.cpp
cl /c /nologo /Fo\Release\buildtime.obj /MT buildTime_.cpp

原理和 rc 檔案一樣. 先替換, 後編譯. 同樣要保證產生的 buildtime.obj 覆蓋原來的 buildtime.obj

大功告成.
不過有一點要注意. vc6 的資源編輯器在每次編輯資源之後都重建 rc 檔案. 也就是說, 會刪除我們對 rc 的修改. 還沒有找到好的辦法, 現在只能是每次編輯資源之後再手工添加一下條件編譯的部分. 建議在項目進入 beta 之後再加上版本資訊. 因為這個時候程式的資源一般都不會變動了.

另外, 雖然這裡是以 vc6 為例, 但也可以應用到 vc2003, vc2005 等編譯環境.

後記: 還可以考慮用程式自動修改. 找到 FILEVERSION, 將後面的版本替換成 FILEVERSION 2,2,4,$WCREV$, 然後再用 subwcrev 替換. 再用 rc 編譯. 這樣還不用定義 _AUTOVERSION 宏

 

每次新版本build時，讓軟體的版本號碼自增