Runs the NAnt build tool.
You can either use an existing build file or nest a build file (snippet) as a child into the task. If you don't specify either, NAnt's default build file search algorithm will apply.
Attribute | Description | Required |
buildfile | External build file to invoke NAnt on. | No. |
vm | Same as dotnetexec's vm attribute. Specify the framework to use. | No. |
failOnError | Stops the build if NAnt returns with a code indicating an error. | No - defaults to true. |
errorProperty | Name of the Ant property to set if NAnt indicated an error. Only useful if the failOnError attribute is set to false. | No. |
target
has a single required attribute name -
specifies a target to be run.
property
has two required attributes. name and
value that specify name and value of a property that is to be
defined in the NAnt invocation.
This element allows no attributes. You can nest a NAnt build
file into it and NAnt will be executed on that. You can also nest
a build file snippet instead and Ant will wrap the necessary NAnt
<project> around it.
Let NAnt search for a *.build file in the (Ant) project's base directory and execute the default target in it:
<nant/>
Let NAnt execute the targets named foo and bar in the build
file nant.build in Ant's basedir and pass the property
-D:test=testvalue
to it:
<nant buildfile="nant.build"> <target name="foo"/> <target name="bar"/> <property name="test" value="testvalue"/> </nant>
Define a build file embeded into the task, let NAnt execute the echo target of that build file.
<nant> <target name="echo"> <build> <project basedir="." default="empty"> <target name="empty"/> <target name="echo"> <echo message="this is NAnt"/> </target> </project> </build> </nant>
Run NAnt's echo task:
<nant> <build> <echo message="this is NAnt"/> </build> </nant>
Apache Ant, Apache .NET Ant Library, Ant, .NET Ant Library, Apache, the Apache feather logo, and the Apache Ant project logos are trademarks of The Apache Software Foundation.