Ant

This page contains reference information about the Ant Build Runner fields.

Option	Description
Build runner	Select Ant from the drop-down list.
Artifact Paths	Use this field to specify directories containing Build Artifact or file names as a comma-separated string. If a directory is specified its contents will be uploaded to the server. In version 3.1 this field is located on the 1.General Settings page.

Ant Parameters

Option	Description
Path to build.xml file	If you choose this radio button, the text field is enabled, where you can type the path to the build.xml file of the project. The path is relative to the project root directory.
Build file content	If you choose this radio button, click the link Type build file content, and enter source code of your custom build file in the text area. Use Hide link to close the text area. Note that the text area is resizeable.
Targets	Use this text field to specify valid Ant targets as a list of space-separated strings. If this field is left empty, default target specified in build.xml file will be run.
Ant home path	Use this optional parameter to specify path to the distributive of your custom Ant. You do not need to specify this parameter, if you are going to use Ant distributive that comes bundled with TeamCity (Ant 1.7). Please note, that you should use Ant 1.7 if you want to run JUnit4 tests in your builds.
Additional command line parameters	Optionally, specify additional command line parameters as a space-separated list.

Java Parameters

Option	Description
JDK home path	Use this field to specify the path to your custom JDK which should be used to run the build. If the field is left blank, the path to JDK Home is read either from the JAVA_HOME environment variable on agent computer, or from env.JAVA_HOME property specified in the build agent configuration file (buildAgent.properties). If these both values are not specified, TeamCity uses Java home of the build agent process itself. If you have multiple build agents, it is recommended to specify value of this property as a reference to a property defined on specific build agent: %system.JDK_1_4%. After that you can specify the value of property system.JDK_1_4 in build agent's configuration file (buildAgent.properties) to the specific path to JDK 1.4 on this build agent: `system.JDK_1_4=/home/local/jdk_1.4.11` For all run parameters with values specified in terms of other properties (for example, %system.JAVA_1_4%), an implicit Agent Requirements is added (ensuring the referenced property is either defined on the agent machine or specified in the build parameters).
JVM command line parameters	You can specify such JVM command line parameters as, for example, maximum heap size or parameters enabling remote debugging. These values are passed by the JVM used to run your build. Example: `-Xmx512m -Xms256m`
Build working directory	Specify the Build Checkout Directory.

Option

Description

JDK home path

Use this field to specify the path to your custom JDK which should be used to run the build. If the field is left blank, the path to JDK Home is read either from the JAVA_HOME environment variable on agent computer, or from env.JAVA_HOME property specified in the build agent configuration file (buildAgent.properties). If these both values are not specified, TeamCity uses Java home of the build agent process itself.

JVM command line parameters

You can specify such JVM command line parameters as, for example, maximum heap size or parameters enabling remote debugging. These values are passed by the JVM used to run your build. Example:

-Xmx512m -Xms256m

Build working directory

Specify the Build Checkout Directory.

Last modified: 20 April 2023