使用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表示构建文件的项目,每个构建文件有且尽有一个项目,他包括一系列的targetname="Aaron.Guo.NAnt.Project"说明项目名称是Aaron.Guo.NAnt.Project,这是可选的default="show "表示项目的默认目的(target)是showbasedir="."表示基准目录为当前目录。

 

2.  target表示一个目的,他包括一系列的taskname="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文件也没有被编译也没有被运行。

 

 

原因是这个项目默认的targetshow,所以编译和运行的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的属性,他能设置为truefalse,用于决定项目是否在调试时被编译(这个特别的属性最后实际上不影响项目的编译,他是你设置的一个简单变量,能在实际决定怎么编译项目后读取。)属性标记如下:


然后,创建一个目标标记。一个项目能包含多个标记,他们在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编译过程不支持这些功能)。

原文地址:https://www.cnblogs.com/zhangzt/p/1828196.html