使用Nant构建入门
前言:
NAnt是一项开源的项目,利用NAnt,你可以方便快捷地对自己.NET项目或解决方案进行自动构建。与VS中可视化化极强的项目和解决方案管理相比,NAnt只能命令行的方式操作,但是这并不影响Nant的流行。NAnt可以根据我们的需要,帮我们自动构建项目,比如创建文件夹,移动文件,运行指定的程序等等,这些都是VS无法办到的。
1U+jM xz^b:NP0范例代码:/Files/gpcuster/NAntDemo.rar
:@ A-wu!x0
正文:
如果你的机器上没有安装NAnt,请先到http://nant.sourceforge.net下载,并安装到机器上。
由于NAnt是基于命令行的工具,所以,我们第一步需要配置环境变量:在环境变量设置窗口中找到Path目录,将Nant.exe所在的目录(如C:"Program Files"nant-0.85"bin)添加进去即可。
如果你对配置环境变量不熟悉,也可以在系统目录(如C:"Windows)下添加一个nant.bat文件,
nant.bat文件的内容如下:
@echo off
`5P&cy,x
q0"C:\Program Files\nant-0.85\bin\NAnt.exe" %*
然后,你打开CMD窗口,输入nant后可以看到:
然后,我们在D盘的根目录下新建一个NAnt的构建文件,命名为my.build(NAnt的构建文件的后缀名是build)
虽然NAnt构建文件的后缀名不是XML,但是他的文档格式还是基于XML的,所以改文件的开头需要注明<?xmlversion="1.0"?>。在下面我们再加入其他的元素,整个文件的内容如下:
<?xmlversion="1.0"?>
<projectname="Aaron.Guo.NAnt.Project"default="show"basedir=".">
<targetname="show">
<echomessage="Hello NAnt"/>
</target>
</project>
保存以后,我们在CMD窗口中来运行这个构建文件,如下图所示:
我们用-buildfile:来指定需要构建的文件的地址(D:"my.build)。可以看到,这个文件就是显示了一个字符串:Hello NAnt。
下面,我们来看看这个文件中的3个重要标志:
1. project表示构建文件的项目,每个构建文件有且尽有一个项目,他包括一系列的target,name="Aaron.Guo.NAnt.Project"说明项目名称是Aaron.Guo.NAnt.Project,这是可选的default="show "表示项目的默认目的(target)是show,basedir="."表示基准目录为当前目录。
2. target表示一个目的,他包括一系列的task,name="show"指定目的的名称,这个是必选的。
3. echo是一个任务(task)他用来显示一个特定的字符串,message="Hello NAnt"表示要显示的字符串为Hello NAnt。
下面,我们用这个构建文件来编译生成一个简单的CS文件。
对my.build文件修改后的内容如下:
<?xmlversion="1.0"?>
<projectname="Aaron.Guo.Second.Project"default="show"basedir=".">
<propertyname="basename"value="HelloNAnt"/>
<propertyname="debug"value="true"/>
<!--显示消息-->
<targetname="show">
<echomessage="Hello NAnt"/>
</target>
<!--编译文件-->
<targetname="build">
<mkdirdir="${basename}/bin"/>
<csctarget="exe"output="${basename}/bin/${basename}-cs.exe"debug="${debug}">
<sources>
<includename="${basename}/${basename}.cs"/>
</sources>
</csc>
</target>
<!--运行文件,run基于build-->
<targetname="run"depends="build">
<execprogram="${basename}/bin/${basename}-cs.exe"basedir="."/>
</target>
</project>
然后D盘根目录下新建一个HelloNant文件夹,并在里面添加一个HelloNant.cs文件,该文件的内容如下:
namespaceAaron.Guo.Second.Project
{
publicclassHelloNAntCS
{
staticvoidMain()
{
System.Console.WriteLine("Hello NAnt using C#");
}
}
}
好,我们在CMD窗口中运行nant
–buildfile:D:"my.build
可以看见,显示的东西还是和上次一样,而且CS文件也没有被编译也没有被运行。
原因是这个项目默认的target是show,所以编译和运行的target都没有执行。因此,我们需要显示的指定相应执行的target。
下面,为了执行build,我们输入nant –buildfile:D:"my.build
build 执行的输出如下图所示:
并且我们可以在D:\HelloNAnt\bin中找到生成的可执行文件HelloNAnt-cs.exe
然后,我们再来输入nant –buildfile:D:\my.build run结果如下:
如果我们希望先显示消息,在运行程序,可以执行一下的命令:nant –buildfile:D:\my.build show run 结果如下:
现在,相信大家已经对NAnt的使用有了一定的了解了。
后记:
相信在不久的将来,NAnt也会拥有漂亮方便的图形界面操作方式,功能也将越来越完善。
nant
nant不像目前版本的visual studio .net,他是个基于.net的编译(build)工具,能够使项目的编译过程非常容易。当项目研发者非常多时,不可能依靠某个人去执行编译过程,你也不想经常去手工编译项目,而是代之以创建一个每天晚上自动运行的编译过程。nant允许你执行编译解决方案、复制文件、运行nunit测试、发送e-mail等工作。遗憾的是,nant没有漂亮的图像化界面,但他包括一个控制台应用程式和xml文件,xml文件指定了编译过程中应当完成的任务。注意visual
studio 2005新的编译平台msbuild,他提供非常稳健的编译功能并且同样是由基于xml的项目文件驱动的。
使用nant
在这个例子中,我将为前面创建的nunitexample解决方案创建一个nant编译文件。首先创建一个以.build 为扩展名的xml文件,将他置于项目的根目录下,然后在文件顶部添加一个xml声明。第一个添加的标记是项目标记:
the nunit example project
项目标记设置了项目名称、缺省目标和基目录。描述标记设置了该项目的简要描述。
接下来是添加属性标记,用于存储可从文件所有地方访问的设置值。在本例中,我要创建一个名为debug的属性,他能设置为true或false,用于决定项目是否在调试时被编译(这个特别的属性最后实际上不影响项目的编译,他是你设置的一个简单变量,能在实际决定怎么编译项目后读取。)属性标记如下:
然后,创建一个目标标记。一个项目能包含多个标记,他们在nant运行时指定。如果没有指定目标,则使用项目元素中缺省的设置值。在本例中,缺省目标是“build”。让我们看一看目标元素,他包含大部分编译信息:
在目标元素中,我设置了要编译的目标名并创建一个任务描述。下面还要创建一个csc元素,他指定应当传递给c#编译器csc的内容。让我们看一看csc元素:
debug="${debug}">
首先,必须设置csc元素的目标。在本例中我将创建一个.dll文件,因此我将目标设置为“library”。接下来设置csc元素的输出,他指定.dll文件的创建位置。最后,需要设置debug属性,他决定项目是否在调试时被编译。因为前面已创建了一个属性来存储这个值,所以能使用下列字符串来访问该属性的值:${debug}。csc元素还包含一些子元素,这里需要创建两个元素:引用元素告知nant需要为这个项目引用的程式集,源文件元素告诉nant编译所包括的文件。在本例中,我引用nunit.framework.dll程式集并包括hashtabletest.cs文件。最终的编译文件见图8。(正常情况下你还应当创建一个用于删除生成的文件的clean目标,但我为了文章简短而省略了。)
图8 nant编译文件
要编译这个文件,需要在.build文件所在的项目根目录下执行nant.exe。如果编译成功,应用程式的bin目录下能找到.dll和.pdb文件。尽管使用nant确实不如在visual
studio中点击“build”那么容易,但对于研发按进度自动运行的编译过程,他是个功能非常强大的工具。nant还包括一些有用的功能,例如,运行单元测试或复制其他文件(目前的visual studio编译过程不支持这些功能)。