|
|
(27 intermediate revisions by 9 users not shown) |
Line 1: |
Line 1: |
− | To build Freeplane, you must:
| + | [[Category:Coding]] |
| | | |
− | # Get the source code in one of the following ways:
| + | == Requirements == |
− | #* 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.)
| + | * You need java 11 or later and gradle >= 6.0 |
− | #* 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:
| |
− | #** <code>bzr checkout --lightweight URL freeplane</code> [no history, directory size ~ 30MB] '''OR'''
| |
− | #** <code>bzr clone URL freeplane</code> [full history, directory size ~ 150MB]
| |
− | #* Update to the latest source code in the bzr repository. From within the freeplane bzr directory:
| |
− | #** <code>bzr update</code>
| |
− | # Build the source code, by typing the following commands:
| |
− | #* <code>cd freeplane/freeplane_framework/ant</code>
| |
− | #* <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.
| + | == Download gradle == |
| + | * Download gradle: https://gradle.org/releases/ |
| + | * Unzip to your home directory |
| | | |
− | Possible bzr URLs to use include:
| + | == Clone the freeplane repository == |
− | * bzr://freeplane.bzr.sourceforge.net/bzrroot/freeplane/freeplane_program/release_branches/1_0_x
| + | git clone https://github.com/freeplane/freeplane.git |
− | * ... (TODO: others?)
| + | cd freeplane |
| | | |
− | Further information on the Bazaar repository used by Freeplane is available on the [[Bazaar howto]] wiki page.
| + | == Run gradle == |
| + | * Gradle wrapper files are intentionally not committed to the sources but git ignored so that you can add them yourself if you need them. |
| + | $ ~/Downloads/gradle-6.0.1/bin/gradle build |
| | | |
| + | == Run freeplane == |
| + | cd BIN |
| + | ./freeplane.sh # linux |
| + | freeplane.bat |
| + | |
| + | == Create package == |
| + | ~/git2/freeplane(1.7.x u=)$ ~/Downloads/gradle-6.0.1/bin/gradle clean build dist |
| + | ls DIST |
| | | |
− | == Using ant == | + | == Configuring an IDE == |
− | Building Freeplane requires that you have [http://ant.apache.org/ ant] installed on your computer. From the ant directory you can run <code>ant TARGET</code> where <code>TARGET</code> is one of the following:
| + | * See [[IDE setup| how to set up IDE]] |
− | * 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 <code>build</code> property as a commandline argument to ant:
| |
− | * <code>ant -Dbuild=<destination directory> build</code> .
| |
− | | |
− | === Build options ===
| |
− | ant -Dminor=01 -Dskip_bugreport=true
| |
− | *-Dminor=XX adds the testversion number to the file names for creating the test version | |
− | *-Dskip_bugreport=true excludes pluginf bugreport from build.
| |
− | * Similar -Dskip_PLUGIN options are available for skipping the other plugins like -Dskip_script=true
| |
− | '''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)
| |
− | | |
− | [[Category:Developer_Documentation]] | |