Difference between revisions of "How to build Freeplane"
Line 9: | Line 9: | ||
#** <code>bzr update</code> | #** <code>bzr update</code> | ||
# Build the source code, by typing the following commands: | # Build the source code, by typing the following commands: | ||
− | #* <code>cd freeplane | + | #* <code>cd freeplane</code> |
#* <code>ant build</code> [see ant section below for more details] | #* <code>ant build</code> [see ant section below for more details] | ||
After the code finishes building, it can be found inside the <code>freeplane/freeplane_framework/build</code> directory. | After the code finishes building, it can be found inside the <code>freeplane/freeplane_framework/build</code> directory. | ||
− | + | ===Bazaar branches:=== | |
− | * bzr://freeplane.bzr.sourceforge.net/bzrroot/freeplane/freeplane_program/release_branches/ | + | * Current development: <code>bzr://freeplane.bzr.sourceforge.net/bzrroot/freeplane/freeplane_program/release_branches/trunk</code> |
− | * ... | + | * Maintenance branch for 1.1 releases: <code>bzr://freeplane.bzr.sourceforge.net/bzrroot/freeplane/freeplane_program/release_branches/1_0_x</code> |
Further information on the Bazaar repository used by Freeplane is available on the [[Bazaar howto]] wiki page. | Further information on the Bazaar repository used by Freeplane is available on the [[Bazaar howto]] wiki page. | ||
− | |||
== Using ant == | == Using ant == |
Revision as of 06:23, 27 July 2010
To build Freeplane, you must:
- Get the source code in one of the following ways:
- Download the freeplane_src archive from http://sourceforge.net/projects/freeplane/files/ (NOT the freeplane_srcpure archive -- this does not contain the external libraries required for the build.)
- Check out the latest source code from the bzr repository (for bzr repository URLs, see below). Do one of the following, depending on whether you prefer a small checkout-directory size, or a repository having full history:
bzr checkout --lightweight URL freeplane
[no history, directory size ~ 30MB] ORbzr clone URL freeplane
[full history, directory size ~ 150MB]
- Update to the latest source code in the bzr repository. From within the freeplane bzr directory:
bzr update
- Build the source code, by typing the following commands:
cd freeplane
ant build
[see ant section below for more details]
After the code finishes building, it can be found inside the freeplane/freeplane_framework/build
directory.
Bazaar branches:
- Current development:
bzr://freeplane.bzr.sourceforge.net/bzrroot/freeplane/freeplane_program/release_branches/trunk
- Maintenance branch for 1.1 releases:
bzr://freeplane.bzr.sourceforge.net/bzrroot/freeplane/freeplane_program/release_branches/1_0_x
Further information on the Bazaar repository used by Freeplane is available on the Bazaar howto wiki page.
Using ant
Building Freeplane requires that you have ant installed on your computer. From the ant directory you can run ant TARGET
where TARGET
is one of the following:
- build (create directory with binaries in freeplane/freeplane_framework/build)
- binzip (create binary zipfile in freeplane/freeplane_framework/dist)
- srczip (create source zipfile in freeplane/freeplane_framework/dist)
- installer (create windows installer in freeplane/freeplane_framework/dist)
- portableinstaller (create portable-windows installer in freeplane/freeplane_framework/dist)
- dmg4mac (create OS X DMG file in freeplane/freeplane_framework/dist)
Specifying no target will end up building all of the above targets.
If you wish to specify a destination build directory, you can do so by adding the build
property as a commandline argument to ant:
ant -Dbuild=<destination directory> build
.
Ant options for building freeplane for upload on Source Forge servers
Please consider following settings
For building test versions:
ant -Dminor=XX
- -Dminor=XX adds the testversion number to the file names for creating the test version.
For building stable versions:
ant-Dskip_bugreport=true
- -Dskip_bugreport=true excludes plugin bugreport from build.
Use option -Dskip_bugreport=true to exclude the bugreport plugin compiling the stable versions (not the testversions, alpha, beta and rc but only the final stable versions like the coming Freeplane 1.1.0).
- Similar -Dskip_PLUGIN options are available for skipping the other plugins like -Dskip_script=true but they are usually not needed.