Build page (Project Properties dialog box)

Use the Build page of the Project Properties dialog box to set compiler options and project-wide resources by file extension.

Choose Project|Project Properties to open the Project Properties dialog box and click the Build tab. You can also right-click the project file in the project pane and choose Properties.

To undo any changes made to this dialog box during this session, click the Reset button.



Build page: Java tab

To set compiler options for the current project, select the Java tab of the Build page. The options are applied to all files in the project, as well as to files referenced by these files, stopping at packages which are marked "stable."

To set these options for all new projects, choose Project|Default Project Properties and click the Build tab.

See also

Debug Options

Note: If the debug information does not include variable information, you won't be able to debug variable members.

Source, Line, And Variable Information

Includes debugging information with source name, line number, and local variable information in the .class file when you compile, make, or rebuild a node.

Source And Line Information Only

Includes debugging information with source name and line number only in the .class file when you compile, make, or rebuild a node.

Source Information Only

This is a feature of JBuilder Professional and Enterprise.

Includes debugging information with source name only in the .class file when you compile, make, or rebuild a node.

None

This is a feature of JBuilder Professional and Enterprise.

Does not include any debugging information. By selecting this option, you can significantly reduce the class to the smallest possible size. This class size reduction ability is very useful when deploying a J2ME application. Space requirements for J2ME may be as low as 260K.

Target VM

Restricts the class files to work only on a specific VM version.

All Java SDKs

Generates the class files to work with versions 1.1 and all VMs in the Java 2 SDK. When you select this as the target VM, your class files can be loaded by any VM. This is the default.

Java 2 SDK, v 1.2 And Later

Generates the class files to run only on VMs in the Java 2 SDK, v 1.2 and later, but won't run on 1.1 VMs.

Java 2 SDK, v 1.3 And Later

Generates the class files to run only on VMs in the Java 2 SDK, v 1.3 and later, but won't run on 1.1 or 1.2 VMs.

Java 2 SDK, v 1.4 And Later

Generates the class files to run only on VMs in the Java 2 SDK, v 1.4 and later, but won't run on 1.1, 1.2, or 1.3 VMs.

Other Compiler Options

Show Warnings

Displays compiler warning messages.

Show Deprecations

Displays all deprecated classes, methods, properties, events, and variables used in the API. When a warning is displayed that deprecated APIs were used, turn this option on to see specifically what is deprecated.

Synchronize Output Dir

Deletes class files on the out path that you don't have source files for before compiling. The out path directory is specified in the Output Path field on the Paths page of the Project Properties dialog box. The location of source files are specified on the Source tab of the Paths page.

Check Stable Packages

When this option is on, the compiler checks packages marked "stable," as well as packages marked "unstable," to determine whether they and their imported classes need to be recompiled. This option is on by default.

If this option is off, a given branch of the checking process halts when it reaches a package marked "stable;" it does not look for unstable packages imported by the stable packages. Therefore, you might need to specify a greater number of modules to compile by adding them to your project. Turning this option off shortens the edit/recompile cycle by not re-checking stable packages, but it is not recommended.

Make Stable Packages

If this option is on, the compiler will compile or check all the classes of a package on the first build and mark the package "stable." If this option is off, only the referenced classes of this package will be made, and the package will not be marked "stable."

This option should be off when working with partial projects.

This option is especially useful for working with a library of classes with no source available, when some of the class files are not consistent, but not used.

Obfuscate

Obfuscation makes your programs less vulnerable to reverse engineering. After decompiling your obfuscated code, the generated source code contains altered symbol names for private symbols.

Exclude Class

Excludes all calls to static void methods in the selected .class file from a compile. This also excludes the evaluation of the parameters passed to those methods.

For example, excluding class A removes all calls to static void methods of A from OTHER classes. These are some of the implications:

If you compile and run it, you will get the expected behavior. If you compile it after excluding class Debug the COMPLETE call to ensure() will be removed from your code, including incrementing "i", which will print the "OOPS".

One side effect is that the thread executes faster without the ensure() which may expose problems in other parts of the code. If you construct the message during the call - ensure(test, "Number of Arguments = " + args.length) - it may run faster after excluding Debug, because constructing the String takes some time.

Autosave All Files Before Compiling

Automatically saves all files in the project before each compile.

Generate Source To Output Path

Causes source code generated from an RMI or IDL file during a make to be saved in the out path. The out path is specified in the Output Path field on the Paths Page of the Project Properties dialog box and defaults to the /<home>/<username>/jbproject/<project-folder-name>/classes/ directory.

Autocancel Build On Error

If set, a Make or Rebuild terminates at the end of the current build task (as if the Cancel button had been used) if any non-warning error message was output. Since canceling a build is only implemented between build tasks, this option prevents having to wait for a lengthy following build task to complete. This option is off by default.



Build page: IDL tab

This is a feature of JBuilder Enterprise.

To set these options for the current project, choose Project|Project Properties, then select the Build tab, then the IDL tab.

To set these options for all new projects, choose Project|Default Project Properties, and select the Build tab.

IDL Compiler

Select one of the following options from the list.

In order for JBuilder to work with the selected IDL compiler, you must first set up the ORB for use with JBuilder by configuring options on the CORBA tab of the Enterprise Setup dialog box (Tools|Enterprise Setup). If you have added a different ORB in the Enterprise Setup dialog box, it will display as an option here.

Generated Code Options

Package

Code is generated in the specified package. The package name for definitions is prepended with the specified package name. If a directory with the specified package name does not exist, it will be created. If the package directory exists, its contents will be updated. code is generated that uses CORBA package resolution rules.

Include Path

Specifies the location where other files that are referenced from IDL files reside. Click the ellipsis button beside this field to open a dialog box that lets you browse the directory structure for the location of the files.

In the example below, the include directory should point to the location where the howdy.idl file can be found.

#include "howdy.idl"
module x {
     interface P {
          string getThis();
     };
};

Additional Options

Enter any additional options for your IDL compiler, as you would enter them when running the compiler from the command line.

Symbols Defined For Conditional IDL Compilation

Lists the symbols that have been defined for conditional IDL compilation. Click the New button to display the Define New Symbol dialog box, where you can define a new conditional symbol. To remove a symbol from the list, select it then choose the Delete button.



Build page: JSP tab

This is a feature of JBuilder Professional and Enterprise.
To set build options for a JSP, select the JSP tab of the Build page.

Check JSPs For Errors At Build-Time

Compiles JSPs into servlets at build-time, allowing errors to be reported during development, instead of at runtime.

You can set this property for each JSP file in your project, so that you can exclude certain files from compilation. For example, JSPs that are intended to be included in other JSPs probably would not compile successfully on their own, so you would exclude those files.

See also



Build page: Resource tab

This is a feature of JBuilder Professional and Enterprise.

JBuilder copies all known resource types from the source path to the output path during the compile process. By default, JBuilder recognizes all images, sound, and properties files as resources and copies them to the output path. You can override these default resource definitions on individual files or by file extension project wide. See "Setting the output path" for more information on the output path.

On the Build page of the Project Properties dialog box you can set project-wide resources by file extension.

You can access the Resource tab on the Build page two ways:

Project-wide Defaults By Extension

The list of project-wide defaults by extension displays the known file extensions and their default deployment behavior. These defaults can be changed on a project-by-project basis. Select one or more extensions and use the radio buttons on the right to change the default behavior for these extensions in the current project. You can also change these defaults for all future projects in the Default Project Properties dialog box (Project|Default Project Properties).

Copy

Copies the file types selected in the list to the output path. The Copy options selects an absolute behavior: always copy to the output path when the project is built, regardless of whether or not the file type is normally considered a resource.

If the selected extensions do not all share the same setting, none of the radio buttons in the group are selected. Selecting one of the radio buttons changes everything to the same value, while leaving none selected allows the differing values to be left alone.

Do Not Copy

Does not copy the the file types selected in the list to the output path. The Do Not Copy option selects an absolute behavior: never copy to the output path when the project is built, regardless of whether or not the file type is normally considered a resource.

If the selected extensions do not all share the same setting, none of the radio buttons in the group are selected. Selecting one of the radio buttons changes everything to the same value, while leaving none selected allows the differing values to be left alone.

Reset

Returns all files in the file extension list to the state they were in when the dialog box was displayed.