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

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

<Target DependsOnTargets="Clean"> <MakeDir Directories="@(BuildArtifactsDir)" /> </Target>

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

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

<ItemGroup> <BuildArtifactsDir Include="BuildArtifacts\" /> <SolutionFile Include="HelloCI.sln" /> </ItemGroup> <PropertyGroup> <Configuration Condition=" '$(Configuration)' == '' ">Release</Configuration> <BuildPlatform Condition=" '$(BuildPlatform)' == '' ">Any CPU</BuildPlatform> </PropertyGroup> <Target DependsOnTargets="Init"> <MSBuild Projects="@(SolutionFile)" Targets="Rebuild" Properties="OutDir=%(BuildArtifactsDir.FullPath);Configuration=$(Configuration);Platform=$(BuildPlatform)" /> </Target>

上面的脚本做了几件事情。首先,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

编译结果的输出目录

Configuration

构建(调试、发布等)时要使用的配置

Platform

编译所用的平台(x86、x64等)

给上面这三个Property赋值用的就是先前定义的Item和Property。OutDir Property用的是BuildArtifacts目录的全路径。这里用了%(Item.MetaData) 语法。这个语法应该看起来很眼熟吧?就跟访问C#对象属性的语法一样。MSBuild创建出来的任何Item,都提供了某些元数据以供访问,例如FullPath和ModifiedTime。但这些元数据有时候也没啥大用,因为Item不一定是文件。

Configuration和Platform用到了先前定义好的Property,语法格式是$(PropertyName)。在这里可以看到系统保留的一些属性名,用户不能更改。定义Property的时候请不要用它们。

这里还有些东西值得提一下。用了Property以后,我们可以在不更改构建脚本的情况下使用不同的Configuration或者BuildPlatform,只要在运行的时候用 /property 传值进去就行。所以“msbuild HelloCI.msbuild /t:Compile /p:Configuration:Debug”这个命令会用Debug配置构建项目,而“msbuild HelloCI.msbuild /t:Compile /p:Configuration:Test;BuildPlatform:x86”会在x86平台下使用Test配置。

现在运行Compile,就可以编译solution下的两个项目,把编译结果放到BuildArtifacts目录下。在完成构建脚本之前,只剩下最后一个Target了:

<ItemGroup> <BuildArtifacts Include="BuildArtifacts\" /> <SolutionFile Include="HelloCI.sln" /> <NUnitConsole Include="C:\Program Files (x86)\NUnit 2.6\bin\nunit-console.exe" /> <UnitTestsDLL Include="BuildArtifacts\HelloCI.Web.UnitTests.dll" /> <TestResultsPath Include="BuildArtifacts\TestResults.xml" /> </ItemGroup> <Target DependsOnTargets="Compile"> <Exec Command='"@(NUnitConsole)" @(UnitTestsDLL) /xml=@(TestResultsPath)' /> </Target>

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/3766cdf148852688548331b029561d7e.html