Apache Ant Tasks - Fail

Description

Fail task is used to exit the current build by throwing a BuildException, optionally printing additional information. The message of the Exception can be set via the message attribute or character data nested into the element.

Properties

Sr.No	Attributes & Description
1	Message A message giving further information on why the build exited.
2	If Only fail if a property of the given name exists in the current project
3	Unless Only fail if a property of the given name doesn t exist in the current project
4	Status Exit using the specified status code; assuming the generated Exception is not caught, the JVM will exit with this status.

Example

Usage

Create build.xml with the following content −


<?xml version="1.0"?>
<project name="TutorialPoint" default="info">
   <property name="build.dir" value="build" />
   <target name="info">
      <fail unless="src.dir"/>
   </target>
</project>

Above script will fail the build as src.dir is not set.

Output

Running Ant on the above build file produces the following output −