每次新版本build時，讓軟體的版本號自增
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.tmpl char *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.txt char *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. |
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 巨集