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

进入存放刚才那个脚本的目录后,以文件名当作参数调用MSBuild,就可以执行脚本了。在我的机器上可以看到下面的执行结果:

C:\>msbuild basics.msbuild Microsoft (R) Build Engine Version 4.0.30319.1 [Microsoft .NET Framework, Version 4.0.30319.269] Copyright (C) Microsoft Corporation 2007. All rights reserved. Build started 8/2/2012 5:59:45 AM. Build succeeded. 0 Warning(s) 0 Error(s) Time Elapsed 00:00:00.03

执行完脚本以后,MSBuild会首先显示一个启动界面和版权信息(用 /nologo 开关可以隐藏掉它们)。接下来会显示一个启动时间,然后便是真正的构建过程。因为咱们的脚本啥都没干,所以构建就直接成功了。总计用时也会显示在界面上。下面咱们来给EchoGreeting Target添加一个Task,让脚本真的干点事。

<Target> lt;Exec Command="echo Hello from MSBuild" /> </Target>

现在EchoGreeting Target有了一个Exec Task,它会执行Command属性中定义的任何命令。再运行一次脚本,你应该能看到更多信息了。在大多数时候,MSBuild的输出信息都很长,你可以用 /verbosity 开关来只显示必要信息。不过无论怎样,MSBuild都会把我们的文字显示到屏幕上。下面再添加一个Target。

<Target> <Exec Command="echo %25date%25" /> </Target>

这个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 Directories="BuildArtifacts" /> </Target>

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

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

<Target> <RemoveDir Directories="BuildArtifacts" /> </Target>

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

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

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

<ItemGroup> <BuildArtifactsDir Include="BuildArtifacts\" /> </ItemGroup> <Target> <MakeDir Directories="@(BuildArtifactsDir)" /> </Target> <Target> <RemoveDir Directories="@(BuildArtifactsDir)" /> </Target>

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

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

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