msbuild构建时用SVN修改版本号代替AssemblyVersion的Revision版本号

持续构建需要标识出每次构建的版本,而每次构建的时候人工去修改版本是不现实的。靠程序去添加版本号,有3种可选:1) 顺序流水号;2) 时间戳;3) SVN检出代码的修订版本号


1) 顺序流水号。需要每次构建将上次记录的流水号+1,再更新到版本中去。如果要记录每次构建的版本号,需要提交到代码器,不仅会造成代码修订版本+1,而且在构建时提交东东总是件不爽的事情。

2) 时间戳。对比流水号来说,靠谱多了,就是太长,就算以秒为单位,一天也是86400的增量

3) SVN检出代码时的修订版本号。最靠谱的还是这个,代码有更新,版本号增加,代码没更新,版本号不变。通常情况下,代码不变,构建结果基本上不需要有差异,所以选这个啦!


当然这篇博文的关键不在这里,关键是咋才能让MSBuild在构建的时候去取得版本号,并且替换掉AssemblyInfo.cs中的AssemblyVersion或AssemblyFileVersion。这要靠原生的MSBuild Task似乎是办不到,自己写Task太累。所以找了个第三方的Task:MSBuild Community Tasks。


其实这已经不是第一次接触 MSBuild Community Tasks 了,上次使用它是因为需要在项目构建时将生成的结果打包成压缩文件,所以用到了它的 Zip Task。而这次,需要用到它两个Task:


SvnVersion Task,用来获取代码的SVN修订版本号

FileUpdate,用来更新AssemblyInfo.cs文件


下面是实验环境和代码:


首先是项目目录结构(test.xml就是 MSBuild 构建脚本)

C:.
├─build
│  │  test.xml
│  │
│  └─msbuildtasks
│          MSBuild.Community.Tasks.dll
│          MSBuild.Community.Tasks.Targets
│
└─MyProject
    └─Properties
            AssemblyInfo.cs


构建脚本只干了一件事件,就是更新 AssemblyInfo.cs 中两个版本号的最后一位(修订版本号)。

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" DefaultTargets="Test" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
    <Import Project="msbuildtasks\MSBuild.Community.Tasks.Targets" />
    <PropertyGroup>
        <MSBuildCommunityTasksLib>$([MSBUILD]::Unescape(MSBuild.Community.Tasks.dll))</MSBuildCommunityTasksLib>
    </PropertyGroup>

    <Target Name="Test">
        <ItemGroup>
            <AssemblyInfos Include="..\MyProject\**\AssemblyInfo.cs" />
        </ItemGroup>

        <SvnVersion LocalPath=".">
            <Output TaskParameter="Revision" PropertyName="Revision" />
        </SvnVersion>

        <Message Text="Revision: $(Revision)" />

        <FileUpdate Files="@(AssemblyInfos)"
            Regex="\(&quot;(\d+\.\d+\.\d+\.)\d+&quot;\)\]"
            ReplacementText="(&quot;${1}$(Revision)&quot;)]" />
    </Target>
</Project>


稍稍解释一下脚本:


    <Import Project="msbuildtasks\MSBuild.Community.Tasks.Targets" />
    <PropertyGroup>
        <MSBuildCommunityTasksLib>$([MSBUILD]::Unescape(MSBuild.Community.Tasks.dll))</MSBuildCommunityTasksLib>
    </PropertyGroup>

这里是引入 MSBuild Community Tasks 的动态库,官方写法,照抄就是了


        <ItemGroup>
            <AssemblyInfos Include="..\MyProject\**\AssemblyInfo.cs" />
        </ItemGroup>

这里把所有 AssemblyInfo.cs 找出来,这样可以将一个解决方案中多个项目的版本号一起更新了。


        <SvnVersion LocalPath=".">
            <Output TaskParameter="Revision" PropertyName="Revision" />
        </SvnVersion>

这里很明显就是在取当前代码的SVN修订版本号了,LocalPath指定了取哪个目录的版本号,Output则将取到的修订版本号输出到“Revision”这个属性中,关于Output,可以参考 http://msdn.microsoft.com/zh-cn/library/ms164287.aspx


需要注意的是,在 PATH 路径中可以找到 svnversion 命令。如果没有设置 PATH,可以使用 ToolPath 参数指定 svnversion 所在目录。


        <FileUpdate Files="@(AssemblyInfos)"
            Regex="\(&quot;(\d+\.\d+\.\d+\.)\d+&quot;\)\]"
            ReplacementText="(&quot;${1}$(Revision)&quot;)]" />

这部分就是通过正则表达式查找替换版本号了。有时有两点需要注意,一是在写引号的时候,需要用&quot;代替;二是在替换字符串中最好用${1}代替$1这种写法,因为后面的$(Revision)也是数字,如果不用大括号连起来就可能变成 $1123 这样,不能被正确识别,用一大括号就是 ${1}123 这样了,不会出错。



你可能感兴趣的:(正则表达式,subversion,revision,community,MSBuild)