Ant Properties dialog box

This is a feature of JBuilder Enterprise.

Ant Build File

Identifies the selected XML file as an Ant build file. When this option is selected, JBuilder recognizes the selected XML node as an Ant node and replaces the XML icon with an Ant icon in the project pane. An Ant node displays targets within the Ant file as children of the node. Files named build.xml are automatically recognized as Ant files. This option is automatically selected and disabled for files named build.xml.

Log Level

Determines the amount of information in the Ant message output.

Quiet

Prints a small amount of message output.

Normal

Prints a normal amount of message output.

Verbose

Prints additional message output.

Debug

Prints debugging information.

Use Log File

Redirects any message output from the JBuilder message pane to a log file. Select this option and choose the ellipsis button, browse to the current project directory, and enter a file name in the File Name field. To easily view the log file in JBuilder, choose Project|Add Files/Packages and add it to your project. Then, open it in the editor.

Properties

Add and remove Ant properties. Properties are a convenient mechanism used to pass parameters to tasks and targets without modifying the existing properties in the build file.

Add

Displays the Add New Property dialog box, where you can add a new property or override an existing one.

Remove

Removes the selected property.

Use Borland Java Compiler

Uses Borland Java compiler, bmj, to execute any javac tasks in your build.xml file. If this option is selected, the Borland compiler is displayed as a property in the Properties list.

Important: If you're using JBuilder features, such as refactoring, it's recommended that you accept the default option Use Borland Java Compiler. bmj puts additional information in its dependency files that allows refactoring to work for certain edge cases, where the necessary information for refactoring cannot be gleaned from .class files alone.

Additional Options

Enter any additional options to pass to Ant. See "Ant options" and the Ant documentation in the JBuilder extras/ant/docs/ directory for additional options you can pass to Ant.

VM Parameters

Specify any additional VM parameters when running Ant as an external process from within JBuilder. For example, if you want the maximum heap of the Java VM in which you are running Ant to be 256MB, enter -Xmx256m in the VM Parameters field.

Task Scheduling

Determines the build phase in which the Ant build file is executed and the targets that are executed before and after the Ant build file.

Phase

The phase in which the Ant build file is executed when building the project.

Prior Targets

Targets in the selected phase that execute before the Ant build file.

Subsequent Targets

Targets in the selected phase that execute after the Ant build file.

Always Run Ant When Building Project

Select this option to run the Ant node with Ant as part of the JBuilder build process. This option is off by default.

Once you've set this option, the Make Project and Rebuild Project commands run Ant as part of the JBuilder build process. If this option is off, the Make Project and Rebuild Project commands run the JBuilder build process without running Ant. See "Building Ant projects with the Run command."

Reset

Resets everything to the state they were in when the dialog box was displayed.