Building From Source

Stephen Oliver edited this page Aug 13, 2016 · 1 revision
Clone this wiki locally

Building with Eclipse

If you don't have it already, obtain the Eclipse IDE and install it.

The bonus when using Eclipse compared to other IDEs is that we host working Eclipse-projects in our repositories. With other IDEs you will have to set up your own project.

  1. Install the EGit plugin to Eclipse. This is an official plugin for the latest Eclipse:

    • Go to Help / Install New Software
    • Select All Available Sites in the Work with dropdown.
    • Type EGit in the filter box.
    • Chose EGit from the search results and install it (and its dependencies).
  2. In Eclipse select File / Import to import the Freenet project - Web Of Trust needs some of it to compile:

    • In the Select dialog chose Git / Projects from Git, click Next
    • In the Select a git repository dialog click Clone
    • In the Source Git repository screen enter the following into URI: git://github.com/freenet/fred.git
    • Click Next.
    • In the Branch selection screen chose the branches which you want. Master branch is usually the only which you need, it is the main development branch. Click Next.
    • Local destination screen: Select master as the initial branch. Click Finish to import the Freenet project. This might take some time as the source code of Freenet is rather large. Have a coffee now.
    • Now you will be back to the Import projects from Git wizard where you had pressed clone.
    • Select fred if there are multiple projects in the list
    • Click Next
    • In the Select a wizard to use for importing projects select Import existing projects if it is not selected already
    • Click Next
    • In the Import projects screen select the fred project. Click Finish
    • Now the fred project should be important and compile fine already.

Building manually on command line interface

To get the latest source from Github, build Freenet, run the test and build Javadoc:

git clone git://github.com/freenet/fred.git
cd fred
ant

You need the optional ANT tasks installed. On Debian, you can use aptitude install ant-optional for this. For more advanced build options, see README.clean-build.

The impatient can use the following to skip the tests and the Javadoc:

ant -Dtest.skip=true -Ddoc.skip=true

For Help use

ant -p
ant help

To get the latest version of the source use

git pull

Using the verify-build script

We provide a script to verify that the official jar corresponds to the official source code, "verify-build" in the Maintenance scripts repository. It takes a bit of setting up, so see here for details:

https://github.com/freenet/scripts/blob/master/README.md#verifying-fred-builds

See also

Coding standards