通过 TSVN 自动更新程序集版本信息

  自从有了版本控制，Coder 似乎就多了一剂后悔药，让人爽的不行。有时我们会需要在程序中嵌入程序的编译信息，比如，版本修订号、编译日期等，这些对于发行程序和黑盒测试都是很有用的，可以让我们快速定位到数个发行版中的准确版本或者BUG所在。
  这里就是介绍如何"自动"同步SVN和程序集的版本信息，Coding 的目的就是让 Coder 更懒。
  要完成这个工作，首先要安装 TortoiseSVN及 Subversion，并让你的项目处于 SVN 的版本控制之下。
  P.S : 这里推荐 TortoiseSVN 和 AnkhSVN 一起管理项目，TortoiseSVN 做常见任务，AnkhSVN 主要用于在IDE中跟踪状态。
  
  首先，我们需要 SubWCRev.exe，这是由 TortoiseSVN 提供的实用工具，可以获取工作拷贝或版本库的一些信息并通过模板替换。
  这里我写了一个类似于函数的 AutoRevision.bat 脚本来直接简化我们的工作。
   
AutoRevision.bat :

::<code>
::  <revsion>$Rev: 4 $</revision>
::  <owner name="Zealic" mail="rszealic@gmail.com" />
::</code>
::-----------------------------
::<summary>
::  根据指定的 SVN 工作目录的信息和模板生成目标文件。
::</summary>
::<param name="workDir">要获取信息的 SVN 工作目录。</param>
::<param name="template">模板文件路径。</param>
::<param name="target">生成的目标文件路径。</param>
::<returns>装载量</returns>
::<remark>
::   当生成项目时 Visual Studio 如果已经打开 %target% 参数指向的文件，那么可能导致模板替换更新不精确。
:: 导致该问题的原因是：SubWCRev.exe 修改了 %target%，但是 VS 检测到了这一情况，会弹出对话框询问用户。
:: 必须重新加载才可以，否则 VS 将会编译未替换过的 %target% 文件。
::</remark>
::=============================


::-----------------------------
::** Initialize
@ECHO OFF
SETLOCAL ENABLEEXTENSIONS
REM Initialize Constants
SET TSVN_INFO_FILE=.\TSVN_INFO.tmp
REM Initialize script arguments
SET workDir=%1
SET template=%2
SET target=%3

REM Goto main entry
GOTO MAIN
::=============================


::-----------------------------
::** Main entry
:MAIN
pushd %workDir%
SET workDir=.\

REM 检查参数
IF %workDir%=="" GOTO ARGUMENT_ERROR
IF %template%=="" GOTO ARGUMENT_ERROR
IF %target%=="" GOTO ARGUMENT_ERROR

REM 查询注册表
reg query HKLM\SOFTWARE\TortoiseSVN /v Directory > %TSVN_INFO_FILE% 2>NUL

REM 查找 TSVN 路径
FOR /F "tokens=*" %%i IN (%TSVN_INFO_FILE%) DO (
  ECHO %%i | find "Directory    REG_SZ" > NUL
  IF %ERRORLEVEL% == 0 (
    ECHO %%i > %TSVN_INFO_FILE%
  )
)
SET /P TSVN_PATH= < %TSVN_INFO_FILE%
SET TSVN_PATH=%TSVN_PATH:~23,-1%

REM 调用 TSVN 替换模板
IF NOT %ERRORLEVEL% == 0 GOTO UNKNOW_ERROR
"%TSVN_PATH%bin\SubWCRev.exe" %workDir% %template% %target%
IF NOT %ERRORLEVEL% == 0 GOTO UNKNOW_ERROR
GOTO SUCESSED
::=============================


::-----------------------------
::** Error handlers

:ARGUMENT_ERROR
ECHO 传入的参数无效。
GOTO FAIL

:NOT_FOUND_TSVN
ECHO 查询TortoiseSVN 的安装信息失败。
GOTO FAIL

:UNKNOW_ERROR
ECHO 未知错误。
:FAIL
::=============================

::-----------------------------
::** Program exit
:FAIL
DEL /Q %TSVN_INFO_FILE% 2>NUL
ECHO 模板替换失败。
popd
EXIT 1

:SUCESSED
DEL /Q %TSVN_INFO_FILE% 2>NUL
ECHO 成功进行了模板替换。
popd
EXIT 0
::=============================

 
然后创建一个供脚本使用的模板 AssemblyInfo.tpl，内容如下：
AssemblyInfo.tpl

/**//**
<code>
  <revsion>$Rev$ </revision>
  <owner name="Zealic" mail="rszealic@gmail.com" />
</code>
**/
using System.Reflection;
using System.Runtime.CompilerServices;
using System.Runtime.InteropServices;

[assembly: AssemblyTitle(ThisAssembly.Title)]
[assembly: AssemblyDescription(ThisAssembly.Information)]
[assembly: AssemblyConfiguration("From Mars.")]
[assembly: AssemblyCompany("Google")]
[assembly: AssemblyCopyright("版权所有 (C) Baidu 2007")]
[assembly: AssemblyDefaultAlias("Live")]
[assembly: AssemblyProduct("RevTest")]
[assembly: AssemblyTrademark("Yahoo!")]
[assembly: AssemblyCulture("")]
[assembly: ComVisible(false)]
[assembly: Guid("3FBDB8EE-61FB-46ef-8B61-CC28F46C08B9")]
[assembly: AssemblyVersion(ThisAssembly.Version)]
[assembly: AssemblyFileVersion(ThisAssembly.FileVersion)]

internal static class ThisAssembly
{
    public const string Title = "RevTest";
    public const string Version = "1.2.0." + Revision;
    public const string FileVersion = Version;

    public const string BuildTime = "$WCNOW$";
    public const string Revision = "$WCREV$";
    public const string RevisionRange = "$WCRANGE$";
    public const string RevisionMixed = "$WCMIXED?True:False$";
    public const string RevisionModified = "$WCMODS?True:False$";

    public const string Information = "Name=" + Title + "\r\n"
#if DEBUG
 + "Build=DEBUG\r\n"
#elif RELEASE
        + "Build=RELEASE\r\n"
#else
        + "Build=UNKNOW\r\n"
#endif
 + "Revision=" + Revision + "\r\n"
        + "RevRange=" + RevisionRange + "\r\n"
        + "RevMixed=" + RevisionMixed + "\r\n"
        + "Modified=" + RevisionModified + "\r\n\r\n"
        + BuildTime + "\r\n";

}

  之后为项目添加预生成事件处理命令：
  在 属性->项目生成事件->预生成事件命令行 中键入如下代码 :

"$(ProjectDir)\Properties\AutoRevision.bat" "$(ProjectDir)" .\Properties\AssemblyInfo.tpl .\Properties\AssemblyInfo.cs

这样，程序就可以在每次编译的时候自动更新程序集信息了，我们可以在 <AssemblyFile>.exe->属性->版本->备注中看到如下信息:

Name=RevTest
Build=DEBUG
Revision=4
RevRange=4
RevMixed=False
Modified=False

2007/12/05 19:00:35

示例工程下载 :  RevTest.rar