Apache NetBeans is an open source development environment, tooling platform, and application framework.
- GitHub actions
- Apache Jenkins:
- Linux:
- Windows:
- Linux:
- License Status ( Apache Rat and ant verify-libs-and-licenses )
- Git
- Ant
- JDK 17 or above (to build and run NetBeans)
- NetBeans license violation checks are managed via the rat-exclusions.txt file.
- Set JAVA_HOME and ANT_HOME appropriately or leave them undefined.
Build the default release config (See the cluster.config property.)
$ ant build
Build the basic project (mainly Java features):
$ ant -Dcluster.config=basic build
Build the full project (may include clusters which are not be in the release):
$ ant -Dcluster.config=full build
Build the NetBeans Platform:
$ ant -Dcluster.config=platform build
Cleanup:
$ git clean -Xdf
- You can also use
php,enterprise, etc. See the cluster.properties file. - Once built, you can simply open individual modules of interest with NetBeans and run/rebuild/debug them like any other project
- The
nbbuilddirectory should contain the portable NetBeans zip
Build javadoc:
$ ant javadoc
- On JDK 24 or later, building javadoc may require to raise the jaxp entity limit by setting
export ANT_OPTS=-Djdk.xml.totalEntitySizeLimit=200000 - Run
javadoc-nbtask in Netbeans to run the javadoc build and display it in a web browser.
Quick test run:
$ ant tryme
or run the portable zip distribution:
- extract the zip found in
nbbuildto a directory other thannbbuild - run the
netbeanslauncher found innetbeans/bin, optionally specifying a custom userdir
example:
$ netbeans --userdir /tmp/nbtestdir1
--jdkhome <path> path to JDK used as runtime (and default JDK for projects)
--userdir <path> use specified directory to store user settings
--cachedir <path> use specified directory to store user cache, must be different from userdir
--fontsize <size> set the base font size of the user interface, in points
-J<jvm_option> pass <jvm_option> to JVM
--help list more options
- Subscribe or mail the users@netbeans.apache.org list - Ask questions, find answers, and also help other users.
- Subscribe or mail the dev@netbeans.apache.org list - Join development discussions, propose new ideas and connect with contributors.
- Developer builds on Jenkins (NetBeans-dev-xxx.zip).
- Latest release (convenience binary of released source artifacts).
- start config (JVM settings, default JDK, userdir, cachedir location and more):
netbeans/etc/netbeans.conf - user settings storage (preferences, installed plugins, logs):
system dependent, seeHelp -> Aboutfor concrete location - cache files (maven index, search index etc):
system dependent, seeHelp -> Aboutfor concrete location - default log location (tip: can be inspected via
View -> IDE Log):
$DEFAULT_USERDIR_ROOT/var/log/messages.log
Note: removing/changing the user settings directory will reset NetBeans to first launch defaults
The origins of the code in this repository are older than its Apache existence. As such significant part of the history (before the code was donated to Apache) is kept in an independent repository. To fully understand the code you may want to merge the modern and ancient versions together:
$ git clone https://github.com/apache/netbeans.git
$ cd netbeans
$ git log platform/uihandler/arch.xmlThis gives you just few log entries including the initial checkin and change of the file headers to Apache. But then the magic comes:
$ git remote add emilian https://github.com/emilianbold/netbeans-releases.git
$ git fetch emilian # this takes a while, the history is huge!
$ git replace 6daa72c98 32042637 # the 1st donation
$ git replace 6035076ee 32042637 # the 2nd donationWhen you search the log, or use the blame tool, the full history is available:
$ git log platform/uihandler/arch.xml
$ git blame platform/uihandler/arch.xmlMany thanks to Emilian Bold who converted the ancient history to his Git repository and made the magic possible!
