NAnt 是一個(gè)
Visual Studio .Net
應(yīng)用程序的連編工具，對(duì)大而負(fù)責(zé)的工程而言，使用
NAnt
很方便。
1.?????
安裝
從
http://nant.sourceforge.net
上可以下載源代碼或者編譯好的二進(jìn)制文件，一般下載
nant-bin.zip
，解壓，注冊(cè)系統(tǒng)環(huán)境變量后，就可以使用
nant
命令了。
2.?????
Build
文件
XML
格式，每個(gè)
build
文件包含一個(gè)
project
，
project
有若干
target
，每個(gè)
target
包含若干
task
。
Task
不被包含在
target
中，即直接包含在
project
中。
???????
Projects
（工程）
三個(gè)特性，
name
、設(shè)置工程名稱，
default
、設(shè)置默認(rèn)
target
，和
basedir
、如果不設(shè)置，默認(rèn)為
build
文件的父目錄。
執(zhí)行
nant
時(shí)，可以知道
targets
，如果未指定，執(zhí)行默認(rèn)得
target
，如果
build
文件中未指定默認(rèn)得
target
，僅僅執(zhí)行全局的
task
（全局的
task
總是執(zhí)行），如果沒(méi)有全局的
task
，那就什么都不執(zhí)行了。
???????
Targets
（目標(biāo)、對(duì)象）
有五個(gè)特性，
name
、指定名稱，
depends
、此
target
所依賴的
targets
（多個(gè)用“，”隔開(kāi)），
if
、如果條件為
true
執(zhí)行此
target
，
unless
、如果條件為
true
跳過(guò)此
target
，
description
、功能的簡(jiǎn)短描述。其中
name
必須指定。
執(zhí)行某個(gè)
target
時(shí)，首先執(zhí)行此
target
所依賴的
targets
。一個(gè)
target
可能被
depends
多次，僅執(zhí)行一次，但是通過(guò)
<call>
任務(wù)（
task
）執(zhí)行一個(gè)
target
時(shí)，此
target
及其所依賴的
targets
要重新執(zhí)行一次。另外，當(dāng)
target
的名稱被設(shè)置為“
*
”時(shí)，稱為
wild target
，一個(gè)
build
文件僅僅有一個(gè)
wild target
，在目前的
build
文件中，當(dāng)且僅當(dāng)被調(diào)用的
target
不存在時(shí)，才執(zhí)行
wild target
，主要用來(lái)處理無(wú)效的請(qǐng)求。
???????
Task
（任務(wù)）
一塊可執(zhí)行的代碼，一個(gè)
task
可有多個(gè)特性和參數(shù)。特性的值可包含對(duì)屬性的引用，在
task
執(zhí)行前，這些引用會(huì)被解釋出來(lái)。
???????
Properties
（屬性）
一個(gè)
project
可有很多屬性，這些屬性可以通過(guò)
<property
任務(wù)設(shè)置在
build
文件中，也可以設(shè)置在
Nant
外。一個(gè)屬性有一個(gè)
name
和一個(gè)
value
，可用于
task
的特性中，也可用于表達(dá)式，用在
task
的特性中時(shí)，使用
${property name}
格式。
Nant
有很多內(nèi)建屬性（與
nant
有關(guān)的，與框架有關(guān)的，與平臺(tái)有關(guān)的等）。
<property>
任務(wù)有
readonly
和
overwrite
等特性，
readonly
指定屬性是否是只讀到，默認(rèn)
false
，
overwirte
指定如果屬性已經(jīng)存在，屬性值是否可以重寫，默認(rèn)
true
，對(duì)于只讀屬性，是不能被重寫的。注意：在
Nant
命令行指定的屬性，先于在
build
文件中指定的屬性，并且這些屬性往往是只讀的。
另外可以在
NAnt.exe.config
文件中定義全局屬性。
???????
Loggers & Listeners
Nant
通過(guò)
Loggers
和
Listeners
來(lái)監(jiān)控連編過(guò)程。
Listeners
記錄了
build started
，
build finished
，
target started
，
target finished
，
task started
，
task finished
，
message logged
事件，
Loggers
擴(kuò)展了
Listeners
，可以按
-quiet
（靜態(tài)的，平穩(wěn)的）
, -verbose
（詳細(xì)的）
, -debug
三個(gè)層次記錄連編信息，可輸出到控制臺(tái)或者文件中。
Nant
內(nèi)建了三個(gè)類：
NAnt.Core.DefaultLogger
、
NAnt.Core.MailLogger
和
NAnt.Core.XmlLogger
。使用時(shí)：
-logger
：類
-logfile
：文件名。可以是普通道文本文件或者
XML
文件。
???????
Expressions
（表達(dá)式）
表達(dá)式是一種簡(jiǎn)單而強(qiáng)大的機(jī)制，允許寫高級(jí)的公式，用于
task
的參數(shù)和條件式中，這樣就可以控制連編過(guò)程了。表達(dá)式能夠訪問(wèn)
project
的屬性、調(diào)用內(nèi)建的或者用戶定義的
functions
。
表達(dá)式通過(guò)
${…}
符號(hào)，可用于
task
的參數(shù)中。也可以使用標(biāo)準(zhǔn)的算術(shù)、邏輯和關(guān)系運(yùn)算符。通過(guò)
prefix::function-name(argument1, ..., argumentN)
語(yǔ)法調(diào)用函數(shù)。訪問(wèn)屬性，僅需指定其
name
（
${…}
）
例子：
訪問(wèn)屬性
<property name="build.version" value="3" />
<echo message="The current date is: ${build.version}" />
調(diào)用函數(shù)
<echo message="The current date is: ${datetime::now()}" />
表達(dá)式結(jié)果存儲(chǔ)
<property name="autoexec-present" value="${file::exists('c:\autoexec.bat')}" />
Real-life expression use
<property name="myprj.basedir" value="c:\" />
<property name="filename" value="${path::combine(myprj.basedir,'version.txt')}" />
?
<if test="${not file::exists(filename) or file::get-length(filename) = 0}">
??? <echo message="The version file ${filename} doesn't exist or is empty!" />
</if>
有條件執(zhí)行
task
<property name="myprj.basedir" value="c:\" unless="property::exists('myprj.basedir')" />
<csc target="library" output="out.dll" ...
???? if="${datetime::now() - file::get-last-write-time('out.dll')) > timespan::from-hours(1)}">
...
</csc>
Functions
Nant
提供了操作字符串、日期時(shí)間和路徑名字的函數(shù)，還提供讀取文件或者目錄屬性，訪問(wèn)目前的連編信息等函數(shù)。
調(diào)用函數(shù)語(yǔ)法
prefix::function-name(argument1, ..., argumentN)
，需要的情況下會(huì)進(jìn)行參數(shù)類型轉(zhuǎn)換，如果轉(zhuǎn)換有誤，會(huì)報(bào)告錯(cuò)誤。
自定義函數(shù)可以使用任何
.Net
語(yǔ)言實(shí)現(xiàn)，此外還可以通過(guò)
<script>
任務(wù)實(shí)現(xiàn)。
3.?????
運(yùn)行
Nant
命令
Nant
，此外還可以指定
build
文件名、
targets
和
properties
等。
Nant
NAnt -buildfile:..\fileName.build
NAnt clean
NAnt -D:debug=false clean dist