本文不是介绍如何使用CCNET+MSBuild+SVN构建自动编译系统,相关的内容可以从很多地方获取,可以再园子里搜一下。
随着我们的SVN库日益壮大,容量达到10G,几十G 甚至更大时,我们发现自动构建速度越来越慢,直到有一天你发现入了很小一段代码却不得不等待几小时构建完成,程序员的忍受是有极限的,因此我们决定采取措施实施优化。
首先,我们必须分析哪些因素导致了我们构建速度的减慢,罗列一下,大概如下几个方面:
1. SVN库太大,使得构建服务器在更新SVN代码时花费大量时间。
2. SVN库里有很多工程,每当有SVN代码更新的时候,CCNET就会调用MSBuild将我们所有的工程都编译一遍。(即使入库的文件根本不需要编译,如python脚本)
3. SVN库中工程量越来越大,导致编译所有工程时间原来越长。
对于第三点,我们没有办法,但对于前两点,我们是有办法解决的,总结一下要做的事情:一是加快SVN更新速度,二是减少不必要的工程编译次数。
一、加快SVN更新速度
SVN的更新操作是有CCNET发起的,服务每隔一段时间查询一次SVN是否更新(看CCNET源码好像是调用svn --log来获取代码更新信息),如果有文件更新,则调用svn --update进行更新。从CCNET源码看来,CCNET对SVN代码的更新应该是针对性的,即,查询到哪部分代码有更新,就只更新那部分代码。这样的话效率应该不差。但在实际过程中,发现CCNET调用SVN更新速度异常的慢,甚至让我怀疑它是对整个SVN库执行了一次update操作。
要加快SVN更新速度,我们想到的是减少SVN更新的文件范围,假如你入库了一个python代码,或是QTP测试案例,因为无需编译,所以构建服务器甚至不需要更新那部分代码。因此,我们可以在CCNET的配置文件中只配置我们需要编译的工程:
<sourcecontrol type="multi"> <sourceControls> <svn> <trunkUrl>http://xxx/projectA</trunkUrl> <workingDirectory>x:ccnetsvnprojctA</workingDirectory> <username>name</username> <password>pwd</password> <executable>x:ccnetSubversionsvn.exe</executable> </svn> <svn> <trunkUrl>http://xxx/projectB</trunkUrl> <workingDirectory>x:ccnetsvnprojctB</workingDirectory> <username>name</username> <password>pwd</password> <executable>x:ccnetSubversionsvn.exe</executable> </svn> <svn> <trunkUrl>http://xxx/projectC</trunkUrl> <workingDirectory>x:ccnetsvnprojctC</workingDirectory> <username>name</username> <password>pwd</password> <executable>x:ccnetSubversionsvn.exe</executable> </svn> </sourceControls> </sourcecontrol>
通过上面的设置,CCNET就是监视我们上面指定的SVN路径的代码更新了,如果你的SVN库中有大量不需要编译的文件,这样的优化带来的效果是巨大的。
二、减少编译次数
上面解决了对入库不需要编译的代码文件的问题,但我们还需要面临一个问题是,当你入库工程A的代码时,你只希望编译工程A,而不是将工程A,B,C都编译一遍。甚至,可能还有更加严格的要求。比如,我们库中有个公共库的工程FrameworkA,工程ProjectA,ProjectB,ProjectC都使用到了该公共库工程。我们希望做到:
1. 当我入库的代码属于FrameworkA时,希望把ProjectA,ProjectB,ProjectC都编译一遍。(因为我修改了公共库,很有可能导致工程A,B,C编译不过。)
2. 当我入库的是ProjectA(或B,C)时,我只希望编译ProjectA(或B,C)就行了。
我们看到我们的工程之间多了一些内在的联系,如何才能处理这种复杂的编译关系呢?我想到的是,要么在CCNET上做手脚,要么在MSBuild上进行扩展。CCNET是一个开源项目,我完全可以修改它的代码为我所用,甚至修改出一个更适合使用的版本提交上去 ,但发现这样做的工程量太大,需要花费的精力太多。我需要找到一个简单的,又容易实现的方案,达到我们上面的两点需求。因此,我选择了对MSBuild进行扩展,而MSBuild本事又是支持这种扩展的,这给我带来了很大的方便。
熟悉MSBuild配置文件的朋友一定知道里面有很多Task供我们使用,比如:CallTarget,Exec,MakeDir,VCBuild等等。同时,也提供机制让我们实现自己的自定义Task。详细使用可以参考微软的文档:How to write a Task
现在,我们可以实现一个自己的Task了,那么在我们自定义的这个Task里,我们应该做些什么呢?恩,再来整理一下思路:
1. 我们需要知道更新的代码属于哪个工程。
2. 我们需要知道编译该工程的同时,还需要编译哪些与之相关的工程。
首先解决第一个问题,如何知道更新的代码属于哪个工程?其实,一个更加实际的问题,如何知道更新了哪些代码? 我曾经尝试过使用CCNET一样的办法,调用svn --log对入库记录进行查询,然后每次保存好上次更新的状态,再判断这次更新相对于上次改动了哪些。做到这些其实非常容易,但是,存在一个问题,CCNET本身也有一个机制在记录着SVN更新的状态(state文件),如果我又记录一个自己的SVN更新历史的文件,可能和CCNET本身记录的有时间差,使得整个流程下来对于要更新的和编译的代码文件变得非常不确定。因此,我最后打算直接使用CCNET获取到的文件更新列表。要获取CCNET获取的SVN更新列表,只需要在CCNET的配置文件中加入下面一段:
<prebuild> <modificationWriter> <filename>mods.xml</filename> <path>x:ccnetsvnuild</path> </modificationWriter> </prebuild>
这样,每当CCNET更新SVN代码时,都会将SVN的更新记录到mods.xml中,mods.xml的格式大致如下:
<?xml version="1.0" encoding="utf-8"?> <ArrayOfModification xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <Modification> <Type>Modified</Type> <FileName>xxx.cs</FileName> <FolderName>/trunk/ProjectA/</FolderName> <ModifiedTime>2009-04-05T16:09:58.545196+08:00</ModifiedTime> <UserName>coderzh</UserName> <ChangeNumber>8888</ChangeNumber> <Version /> <Comment>Upload My Greate Code</Comment> </Modification> </ArrayOfModification>
回到正题,通过读取mods.xml知道CCNET此次编译前更新的代码后,如何判断改代码文件属于哪个工程呢?很容易想到的就是通过路径判断,比如上面的代码的FolderName是/trunk/ProjectA,我们就能断定该代码文件属于ProjectA。当然,我们还需要一个配置文件,用于说明哪些目录下的代码属于哪个工程,即代码文件与工程的对应关系。这些信息我们可以直接在MSBuild的配置文件中设置:
<PropertyGroup> <FrameworkAPath> runkFramework</FrameworkAPath> <ProjectA> runkProjectA</ProjectA> <ProjectB> runkProjectB</ProjectB> <ProjectC> runkProjectC</ProjectC> </PropertyGroup> <ItemGroup> <SvnFolder Include="$(FrameworkAPath);"> <ProjectName>FrameworkA</ProjectName> </SvnFolder> <SvnFolder Include="$(ProjectAPath);"> <ProjectName>ProjectA</ProjectName> </SvnFolder> <SvnFolder Include="$(ProjectBPath);"> <ProjectName>ProjectB</ProjectName> </SvnFolder> <SvnFolder Include="$(ProjectCPath"> <ProjectName>ProjectC</ProjectName> </SvnFolder> </ItemGroup>
OK,我们的第一个问题解决了,接下来的问题是,如何设置工程间的这种关联关系。同样的,我们通过MSBuild配置文件中的Target来设置,我们看下面的配置就会明白了:
<Target Name="FrameworkA"> <MSBuild Projects="$(FrameworkAPath)FrameworkA.sln" Properties="Configuration=Release"/> <CallTarget Targets="ProjectA" /> <CallTarget Targets="ProjectB" /> <CallTarget Targets="ProjectC" /> </Target> <Target Name="ProjectA"> <MSBuild Projects="$(ProjectAPath)ProjectA.sln" Properties="Configuration=Release"/> </Target> <Target Name="ProjectB"> <MSBuild Projects="$(ProjectBPath)ProjectB.sln" Properties="Configuration=Release"/> </Target> <Target Name="ProjectC"> <MSBuild Projects="$(ProjectCPath)ProjectC.sln" Properties="Configuration=Release"/> </Target>
我们看到,我们通过Target的设置成功的将不同工程联系了起来,当我们需要编译FrameworkA时,我们只需要调用FrameworkA这个Target,它会先FrameworkA编译,然后再调用ProjectA,ProjectB,ProjectC的编译。
哈哈,一切准备工作都就绪了,我们需要在MSBuild的扩展Task里完成的任务就是:
1. 读取mods.xml,自动判断入库代码所属工程。
2. 返回需要编译的工程名列表。
我们在VS里建立一个DLL工程,然后添加Microsoft.Build.Utilities和Microsoft.Build.Framework的引用,然后编写我们自定义的Task类,我取名为MyTask,让它继承Task类,我们要做的是重写其中的Execute方法。MSBuild具体的Task写法请参照How to write a Task,我这里不再重复了,下面是的MyTask代码:
MyTask using System; using System.Collections.Generic; using System.Linq; using System.Text; using Microsoft.Build.Utilities; using System.Xml; using System.Collections; using Microsoft.Build.Framework; using System.IO; namespace CoderZh.MyTask { public class MyTask : Task { [Output] public ITaskItem[] Targets { get; set; } [Required] public ITaskItem[] Projects { get; set; } [Required] public string SvnModifyFile { get; set; } [Required] public string StateFile { get; set; } private DateTime curBuildTime; private DateTime lastBuildTime; private Boolean lastBuildResult = false; /**//// <summary> /// My Task Run From Here /// </summary> /// <returns></returns> public override bool Execute() { if ((this.Projects == null) || (this.Projects.Length == 0)) { return true; } //Read last build time and result this.ReadLastBuildStatus(); if (!this.lastBuildResult || this.lastBuildTime.Day != DateTime.Now.Day) {//If last build fail, or it is another day, then run all the targets Log.LogMessage("Last build fail, or it is another day, then run all the targets"); this.SetAllTargetsToRun(); } else {//check the svn and run the specify targets this.SetTargetsToRunBySvnModify(); } return true; } /**//// <summary> /// Read Last Build Result, Success Or Not /// </summary> private void ReadLastBuildStatus() { try { XmlDocument doc = new XmlDocument(); doc.Load(this.StateFile); XmlNode lastBuildTimeNode = doc.SelectSingleNode("/IntegrationResult/StartTime"); this.lastBuildTime = Convert.ToDateTime(lastBuildTimeNode.InnerText); XmlNode lastBuildResultNode = doc.SelectSingleNode("/IntegrationResult/LastIntegrationStatus"); this.lastBuildResult = lastBuildResultNode.InnerText.ToLower() == "success"; Log.LogMessage("Load from : {0}
LastBuild Time : {1}
LastBuild Result : {2}", this.StateFile,