用MSBuild和Jenkins搭建持续集成环境(2)

　　这个Target会输出当前日期。它的命令要做的事情就是“echo %25date%25”，但是“%”字符在MSBuild中有特殊含义，所以这个命令需要被转义。当遇到转义字符的时候，“%”后面的十进制字符会被转成对应的ASCII码。MSBuild只会执行Project元素中的第一个Target。要执行其他Target的时候，需要把/target开关(可简写为 /t)加上Target名称传给MSBuild。你也可以指定MSBuild执行多个Target，只要用分号分割Target名字就可以。

　　C:\>msbuild basics.msbuild /nologo /verbosity:minimal /t:EchoGreeting;EchoDate

　　Hello from MSBuild

　　Thu 08/02/2012

　　更实用的构建脚本

　　演示就先到这里。下面来用MSBuild来构建一个真实项目。首先把示例代码下载下来，或是自己创建一个ASP.NET应用。给它添加一个MSBuild脚本，以solution或project名字给脚本命名，扩展名用“.msbuild”。照先前一样指定MSBuild命名空间。

　　开始写脚本之前，先把脚本要干的事情列出来：

　　创建BuildArtifacts目录

　　构建solution，把构建产物(DLL，EXE，静态内容等等)放到BuildArtifacts目录下。

　　运行单元测试。

　　因为示例应用叫做HelloCI，于是这个脚本也就命名为HelloCI.msbuild。先添加命名空间，然后就可以添加第一个Target了，我管它叫做Init。

　　这个Target会调用MakeDir Task创建一个新的目录，名叫BuildArtifacts，跟脚本在同一目录下。运行脚本，你会发现该目录被成功创建。如果再次运行，MSBuild就会跳过这个Task，因为同名目录已经存在了。

　　接下来写一个Clean Target，它负责删除BuildArtifacts目录和里面的文件。

　　理解了Init之后，这段脚本就应该很好懂了。试着执行一下，BuildArtifacts目录应该就被删掉了。下面再来把代码中的重复干掉。在Init和Clean两个Target里面，我们都把BuildArtifacts的目录名硬编码到代码里面了，如果未来要修改这个名字的话，就得同时改两个地方。这里可以利用Item或Property避免这种问题。

　　Item和Property只有些许差别。Property由简单的键值对构成，在脚本执行的时候还可以用 /property 赋值。Item更强大一些，它可以用来存储更复杂的数据。我们这里不用任何复杂数据，但需要用Items获取额外的元信息，例如文件全路径。

　　接下来修改一下脚本，用一个Item存放路径名，然后修改Init和Clean，让它们引用这个Item。

　　Item是在ItemGroup里面定义的。在一个Project中可以有多个ItemGroup元素，用来把有关系的Item分组。这个功能在Item较多的时候特别有用。我们在ItemGroup里定义了BuildArtifactsDir元素，并用Include属性指定BuildArtifacts目录。记得BuildArtifacts目录后面要有个斜杠。最后，我们用了@(ItemName)语法在Target里面引用这个目录。现在如果要修改目录名的话，只需要改BuildArtifactsDir的Include属性就好了。

　　接下来还有个问题要处理。在BuildArtifacts目录已经存在的情况下，Init是什么事都不干的。也是就说，在调用Init的时候磁盘上的已有文件还会被保留下来。这一点着实不妥，如果能每次调用Init的时候，都把目录和目录里面的所有文件都一起删掉再重新创建，就能保证后续环节都在干净的环境下执行了。我们固然可以在每次调用Init的时候先手工调一下Clean，但给Init Target加一个DependsOnTargets属性会更简单，这个属性会告诉MSBuild，每次执行Init的时候都先执行Clean。

　　现在MSBuild会帮我们在调Init之前先调Clean了。跟DependsOnTargets这个属性所暗示的一样，一个Target可以依赖于多个Target，之间用分号分割就行。

　　接下来我们要编译应用程序，把编译后的结果放到BuildArtifacts目录下。先写一个Compile Target，让它依赖于Init。这个Target会调用另一个MSBuild实例来编译应用。我们把BuildArtifacts目录传进去，作为编译结果的输出目录。

　　Release

　　Any CPU

　　Properties="OutDir=%(BuildArtifactsDir.FullPath);Configuration=$(Configuration);Platform=$(BuildPlatform)" />

　　上面的脚本做了几件事情。首先，ItemGroup添加了另一个Item，叫做SolutionFile，它指向solution文件。在构建脚本中用Item或Property代替硬编码，这算的是一个优秀实践吧。

　　其次，我们创建了一个PropertyGroup，里面包含两个Property：Configuration和BuildPlatform。它们的值分别是“Release”和“Any CPU”。当然，Property也可以在运行时通过/property(简写为/p)赋值。我们还用了Condition属性，它在这里的含义是，只有当这两个属性没有值的情况下，才用我们定义的数据给它们赋值。这段代码实际上就是给它们一个默认值。

　　接下来就是Compile Target了，它依赖于Init，里面内嵌了一个MSBuild Task。它在运行的时候会调用另外一个MSBuild实例。在脚本中定义了这个被内嵌的MSBuild Task要操作的项目。在这里，我们既可以传入另外一个MSBuild脚本，也可以传入.csproj文件(它本身也是个MSBuild脚本)。但我们选择了传入HelloCI应用的solution文件。Solution文件不是MSBuild脚本，但是MSBuild可以解析它。脚本中还指定了内嵌的MSBuild Task要执行的Target名称：“Rebuild”，这个Target已经被导入到solution的.csproj文件中了。最后，我们给内嵌的Task传入了三个Property。

　　OutDir

　　编译结果的输出目录

原文转自：http://www.ltesting.net