Building jInfer from sources
Target audience: jInfer power users. Anyone who needs to build jInfer from sources.
This document assumes that your computer is set to use jInfer, meaning you have correct version of NetBeans installed and you can run jInfer.
Getting jInfer sources
There are two main ways of obtaining jInfer source files: from a version distribution, or from the Subversion repository. The first way might be more convenient and secure (version distributions are usually more stable than the bleeding edge code in repository), however you might prefer to build the latest code.
The first way, obtaining sources from version distribution:
- Go to https://sourceforge.net/projects/jinfer/files/.
- Download the latest jInfer sources (jInfer-X.Y-src.zip).
- Unpack the ZIP, you'll get a few directories. One of them will be
- Continue by building jInfer.
Second way, checking out Subversion repository: you will need a Subversion client, such as the command line client or TortoiseSVN. In any case, http://subversion.apache.org/ might be a good place to start. To check out jInfer, use the following URL:
Building from NetBeans
This is perhaps the easier, more user friendly way of building jInfer. If you however wish to automate the building process, you might want to try using Ant - in that case, see the next section.
- Start NetBeans, select File > Open Project... from the main menu.
- In the dialog window, navigate to the root folder with jInfer sources. Its icon should look like two brown puzzle pieces.
- You should see the name "jInfer" in the dialog window.
- Make sure the Open Required Projects check box is checked.
- You might want checking the Open as Main Project checkbox.
- Click Open Project. After a while, all jInfer projects should open and be visible in the Projects window.
At this moment, you might want to look around, play with the
code a bit or apply some patches. If you want to try modified jInfer in a
running NetBeans, select Run from project jInfer (two brown puzzle
pieces icon) context menu. If jInfer is the main project, clicking the
green "Play" icon in the toolbar should work too.
If you want to build jInfer, for example to test if your changes didn't break something, select Build from the context menu. Sometimes it might be necessary to run Clean & Build, try this if it "stops working". If you want to run JUnit test, select Test from the same context menu.
If you now want to create your own distribution (= NBM modules), select Create NBMs from the context menu. They will be created in build/updates directory.
Building with Ant
Each jInfer module and jInfer suite itself has
build.xml Ant build file. The most important one, for the
whole jInfer suite, is located in the
It is possible to use vanilla Ant from Apache, but perhaps safer to resort to the Ant bundled with NetBeans. This one should be located in NetBeans install directory >
Whichever Ant is chosen, to build jInfer do the following on command line:
Change directory to jInfer's
ant [chosen target]. Interesting targets include:
clean: removes any build artefacts.
build: compiles and builds jInfer.
clean build: performs a clean build, useful if something "stops working".
nbms: creates a distribution by packaging jInfer modules in NBM files.
Chosen target may be empty, which should default to