Chapter 4. Configure builders

Table of Contents

Configure Ant/NAnt builder
Configure Maven/Maven2 builder
Configure Rake builder
Configure Command builder
The dummy builder

This chapter describes how to configure various builders.

Configure Ant/NAnt builder

Ant is a widely used build tool in Java world. NAnt is an Ant clone in .NET area. Here is list of properties you should configure for Ant/NAnt builder:

Path to Ant/NAnt executable

Specify command to run ant. For example, C:\apache-ant-1.6.2\bin\ant.bat

[Note]Note

Command or arguement with spaces should be quoted.

Build script path

The path for the Ant build script. If this path is not an absolute path, it is assumed that it is relative to the current configuration's checkouts directory. Click here for details about how to write a new Ant build file or how to modify your existing Ant build script.

Build targets

Specify the targets to build. Use space to separate different targets (target name containing spaces should be quoted in order not to be interpreted as multiple targets). You can also use ${...} to pass variables to the target name. For example you can use ${name} to reference name of current configuration.

Build properties

Define build properties here to pass into the ant build script. For example:

buildVersion=${build.version}
configurationName=${name}

You should set one variable per line. OGNL expression can be inserted to form the value provided they are enclosed by ${...}.

[Note]Note

Properties with blank value will be ignored.

Directory to run Ant/NAnt in

Optionally specify the directory to run Ant/NAnt in. If not specified, Ant/NAnt will be executed in the directory containing the build script you specified.

Extra Ant options

Optionally specify extra Ant/NAnt options.

Wait until this builder finishes?

Specifies whether or not QuickBuild should wait for this builder to finish.

[Warning]Warning

If this property is set to no, execution of this builder will always be considered successful in regardless of value of property build success condition.

Build success condition

The build success condition is an OGNL expression used to determine if the build of the current project was successful. Refer to the user's guide for details.

Environment variables

Environment variables to set before running this builder. For example:

buildVersion=${build.version}
configurationName=${name}

You should set one variable per line. OGNL expression can be inserted to form the value provided they are enclosed by ${...}.

[Tip]Tip

For Ant/Maven builder, you can define JAVA_HOME here to build with your choosed JDK.