Chemmy's Blog

MSBuild 教程(2)

2014-06-27 11:40  yanqinqiang  阅读(2145)  评论()  编辑  收藏

如果你没有看过第一部分教程，请先看完后再回到这里来继续我们的第二部分。

我们下一步的工作是发布我们的网站，也就是创建Publish target. 为了能使我们的target工作，我们需要给它传递两个属性，WebProjectOutputDir 和 OutDir, 这两个变量将确保我们能把我们的网站文件发布到正确的目录下面。

MSbuild 允许我们声明一个PropertyGroup， 在这个PropertyGroup中，我们可以创建一些中间变量用来存储一些设置数据，当我们进行读写操作的时候，我们会需要这些设置数据。

好了，看例子：

1
2 <Project xmlns=“http://schemas.microsoft.com/developer/msbuild/2003“ DefaultTargets=“Run”>
3 <PropertyGroup>
4 <OutputFolder>Output</OutputFolder>
5 </PropertyGroup>
6
7 <Target Name=“Run”>
8 <CallTarget Targets=“Clean” />
9 <CallTarget Targets=“Publish” />
10 </Target>
11
12 <Target Name=“Clean”>
13 <ItemGroup>
14 <BinFiles Include=“bin\*.*“ />
15 </ItemGroup>
16 <Delete Files=“@(BinFiles)” />
17 </Target>
18
19 <Target Name=“Publish”>
20 <RemoveDir Directories=“$(OutputFolder)” ContinueOnError=“true” />
21 <MSBuild Projects=“BuildDemoSite.csproj”
22 Targets=“ResolveReferences;_CopyWebApplication”
23 Properties=“WebProjectOutputDir=$(OutputFolder);OutDir=$(WebProjectOutputDir)\“ />
24 </Target>
25 </Project>

正如你看到的，ResolveReferences target也被调用了，这是为了确保第三方的依赖也能够复制到Output目录下。

执行命令：msbuild build.xml, 结果如下

但是你也许注意到，在Output目录下，一些我不想复制的文件也一并复制了进来，比如Build.xml脚本本身，还有一些环境相关的配置文件：Live.Config & Test.Config. 那是因为它们的build action设置成了content, 你只要把build action设置成None,然后在重新执行下脚本，就不会出现上面的问题了。

现在这个网站基本上能够部署了，但是我们还需要把环境相关的配置复制到 web.config中来，那我们现在就开始这个教程

正如我们在 第一部分教程中提到的，除了web.config 文件，我们还有live.config 和 test.config文件。 同时web.config包含关于网站的所有配置，live.config和 test.config包含一些与部署环境相关的一些配置，接下来的工作就是要把部署环境相关的值正确的复制到web.config中来。

为了实现这个目的，我们通常的思路是用XPath从一个文件中读取配置信息，然后再通过XPath把这个信息写到另一个文件中去。但是快速浏览下内置的Task,没有找到有这个功能的，庆幸的是，MSBuild Community Tasks Project拯救了我们，它提供了XmlRead 和 XmllUpdate task。那先让我们下载，安装它。

在用他们之前，我们要确保下面的XML已经插入到我们的build.xml的根节点上了

<Import Project=“C:\Program Files (x86)\MSBuild\MSBuildCommunityTasks\MSBuild.Community.Tasks.Targets”/>

然后我们增加一个Environment的中间变量在PropertyGroup中，当前它是被硬编码的写成了Test,我们会在以后的教程成修改这个，让它可以配置。

<PropertyGroup>
<Environment>Test</Environment>

<OutputFolder>Output</OutputFolder>
</PropertyGroup>

好，我们第一步是用XmlRead task去获取环境配置的数据,当前我只列举了XmlRead的一个例子, 你可以添加更多

1 <Target Name=“GetConfig”>
2 <XmlRead XPath=“configuration/system.web/compilation/@debug”
3 XmlFileName=“$(Environment).config”>
4 <Output TaskParameter=“Value” PropertyName=“CompilationDebug” />
5 </XmlRead>
6 </Target>

1. GetConfig target包含所有的Xmlread task
2. XmlFileName属性有个变量 $(Environment).config，这个变量指向的是我们的前面硬编码的Test.
3. Output是用来把XmlRead的返回值存储到CompilationDebug属性中。

几乎同样的，我们的XmlUpdate采用同样的语法， 其中注意的是 DependsOnTargets=”GetConfig”是确保复制数据的时候，要先读再写。

1 <Target Name=“SetConfig” DependsOnTargets=“GetConfig”>
2 <XmlUpdate XPath=“configuration/system.web/compilation/@debug”
3 XmlFileName=“Output\web.config”
4 Value=“$(CompilationDebug)” />
5 </Target>

好了，让我们开始见证奇迹的时候，执行下面的命令

msbuild Build.xml /t:SetConfig

检查一下是不是所有的命令都工作，打开output文件下的web.config文件，看看数据是不是跟Test.config中的一致。

你可以查看整个build.xml的代码

• 标签 MSbuild