JavaFXHowToBuild

How To Build JavaFX in the NetBeans trunk
The main goal of this page is specification of the optimal set of actions a developer has to do to create an environment appropriated for developing the JavaFX Plugin for NetBeans IDE.

This is living document. Note: This document is a subject to changes until status of the the JavaFX Plugin is not finalized.
If you are interested in changes in this document you might want to sign to this page RSS feed.

Cloning Contrib Repository

After completion of the actions a <WORKING_DIR>/<MAIN_REPO_NAME>/hg.clone.contrib.log file will contain the cloning log, where <MAIN_REPO_NAME> is either main or release61. Please, check the log before next step. The log should not contain any error messages.

Note: It is possible to execute both tasks (i.e. "Cloning Main Repository" and "Cloning Contrib Repository") in parallel. You can start the "Cloning Contrib Repository" task immediately after a <WORKING_DIR>/<MAIN_REPO_NAME> directory will be created during execution of the "Cloning Main Repository" task.

Download Binary Files & Build

Note: The ANT build procedures require an Internet connection to the http://hg.netbeans.org server. The procedures will have downloaded additional binary files during execution.

Build JavaFX Cluster

check that BUILD SUCCESSFUL in the <WORKING_DIR>/<MAIN_REPO_NAME>/ant.build.cluster.javafx.log file.

Run NetBeans IDE with the JavaFX Plugin

To attach the JavaFX Plugin and to make the javafx cluster visible for the NetBeans IDE at run time you need modify the file <WORKING_DIR>/<MAIN_REPO_NAME>/nbbuild/netbeans/etc/netbeans.clusters.
The new record javafx should be added at the end of the file. Note, it should be done only once.

Workaround: To avoid an issue with running JavaFX application in the NetBeans IDE (Main Menu / Run / Run Main Project F6) you need change the -J-ea option to the -J-da in the netbeans_default_options property value declared in the <WORKING_DIR>/main/nbbuild/netbeans/etc/netbeans.conf file.

Trouble Shooting Tips

TODO: The section should be revised from viewpoint of using the Mercurial.

It is preferable to check out in empty dir. Updating of old repository often leads to multiple errors while building sources.

If you are periodically getting the following error while checking out:

The most probable reason of this error is the antivirus software worked in the real time file protection mode (examples of software that may cause such errors are Symantec AntiVirus and TortoiseSVN Client)

If the last version of CVS hangs executing 'login' command use the older version (1.11.9 for example)