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