MSBuild 教程(2)

时间：2020-11-30 14:27:17

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

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

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

好了，看例子：

 <?xml version="1.0" encoding="utf-8" ?>

 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003" DefaultTargets="Run">

     <PropertyGroup>

         <OutputFolder>Output</OutputFolder>

     </PropertyGroup>

     <Target Name="Run">

         <CallTarget Targets="Clean" />

         <CallTarget Targets="Publish" />

     </Target>

     <Target Name="Clean">

         <ItemGroup>

             <BinFiles Include="bin\*.*" />

         </ItemGroup>

         <Delete Files="@(BinFiles)" />

     </Target>

     <Target Name="Publish">

         <RemoveDir Directories="$(OutputFolder)" ContinueOnError="true" />

         <MSBuild Projects="BuildDemoSite.csproj"

                  Targets="ResolveReferences;_CopyWebApplication"

                  Properties="WebProjectOutputDir=$(OutputFolder);OutDir=$(WebProjectOutputDir)\" />

     </Target>

 </Project>

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

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

MSBuild 教程(2)

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

MSBuild 教程(2)

现在这个网站基本上能够部署了，但是我们还需要把环境相关的配置复制到 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>

    <CompilationDebug />

    <OutputFolder>Output</OutputFolder>

</PropertyGroup>

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

 <Target Name="GetConfig">

     <XmlRead XPath="configuration/system.web/compilation/@debug"

     XmlFileName="$(Environment).config">

         <Output TaskParameter="Value" PropertyName="CompilationDebug" />

     </XmlRead>

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

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

 <Target Name="SetConfig" DependsOnTargets="GetConfig">

     <XmlUpdate XPath="configuration/system.web/compilation/@debug"

                 XmlFileName="Output\web.config"

                 Value="$(CompilationDebug)" />

 </Target>

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

msbuild Build.xml /t:SetConfig

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

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

相关文章