使用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编译过程不支持这些功能)。

该文章经过本人整理所得,欢迎转载,转载时请加上本文地址;本文基于署名 2.5 中国大陆许可协议发布,请勿演绎或用于商业目的,但是必须保留本文的署名张志涛(包含链接如您有任何疑问或者授权方面的协商,请给我留言

(0)
陈玉龙的头像陈玉龙
上一篇 2022年9月21日
下一篇 2022年9月21日

相关推荐