Difference between revisions of "Building iDempiere without Eclipse"

Latest revision as of 21:38, 9 March 2026

⇐ Table of Contents | Running iDempiere within Eclipse | Building iDempiere without Eclipse

It is possible to build iDempiere without Eclipse, you just need the openjdk-17-jdk.

Clone iDempiere code

Clone the repository you downloaded on Download the Code step (you can also use your actual installation, but I prefer to clone it to avoid mixing environments)

cd $HOME/sources  # Or use the folder where you downloaded the idempiere project
git clone idempiere testheadless

Materialize and build the project

Navigate to the folder

cd $HOME/sources/testheadless

Position in the branch you want to compile

# if building development (master) branch
git switch master

# if building release 13 branch
git switch release-13

Build

./mvnw verify

After this step the uncompressed servers can be found at:

# linux 64 bit version
$HOME/sources/testheadless/org.idempiere.p2/target/products/org.adempiere.server.product/linux/gtk/x86_64

# windows 64 bit version
$HOME/sources/testheadless/org.idempiere.p2/target/products/org.adempiere.server.product/win32/win32/x86_64

You can compress those folders with your preferred compressor to use them as installers.

This tutorial is brought to you by Carlos Ruiz from BX Service GmbH. Feel free to improve directly or suggest using the Discussion tab.

⇐ Table of Contents | Running iDempiere within Eclipse | Building iDempiere without Eclipse

@@ Line 3: / Line 3: @@
 &lArr;
 [[Installing_iDempiere|Table of Contents]] |
-[[Creating Installers from Eclipse]] |
+[[Running iDempiere within Eclipse]] |
 Building iDempiere without Eclipse
 </font>
-It is possible to build iDempiere without Eclipse.
+It is possible to build iDempiere without Eclipse, you just need the openjdk-17-jdk.
-This is possible thanks to the [http://wiki.eclipse.org/Buckminster_Headless Buckminster headless] functionality.
+==Clone iDempiere code==
-Instructions:
-Following instructions from http://www.eclipse.org/buckminster/downloads.html
-* Download director_latest.zip from this [http://www.eclipse.org/downloads/download.php?file=/tools/buckminster/products/director_latest.zip link]
-* Unzip it into $DIRECTOR_HOME folder (you decide which folder)
- cd $DIRECTOR_HOME  # replace DIRECTOR_HOME with your preferred folder for this
- unzip director_latest.zip
-* Using director download buckminster headless into $BUCKMINSTER_HOME folder (you decide which folder)
- director -r http://download.eclipse.org/tools/buckminster/headless-4.4/ -d $BUCKMINSTER_HOME -p Buckminster -i org.eclipse.buckminster.cmdline.product
- # Note: replace $BUCKMINSTER_HOME with your preferred folder for this
-* Install the prerequisites (Core, PDE, Maven) into buckminster
- cd $BUCKMINSTER_HOME
- buckminster install http://download.eclipse.org/tools/buckminster/headless-4.4/ org.eclipse.buckminster.core.headless.feature
- buckminster install http://download.eclipse.org/tools/buckminster/headless-4.4/ org.eclipse.buckminster.pde.headless.feature
- buckminster install http://download.eclipse.org/tools/buckminster/headless-4.4/ org.eclipse.buckminster.maven.headless.feature
 * Clone the repository you downloaded on [[Download the Code]] step (you can also use your actual installation, but I prefer to clone it to avoid mixing environments)
   cd $HOME/sources  # Or use the folder where you downloaded the idempiere project
-  hg clone idempiere testheadless
+  git clone idempiere testheadless
-* Create the target platform (replace below $HOME/sources with the folder where you have your cloned repositories)
-  cd $BUCKMINSTER_HOME
+==Materialize and build the project==
- buckminster -data $HOME/sources/testheadless importtargetdefinition -A "$HOME/sources/testheadless/org.adempiere.sdk-feature/build-target-platform.target"
-* Materialize the project
+* Navigate to the folder
-  buckminster -L DEBUG -consoleLog -data $HOME/sources/testheadless import "$HOME/sources/testheadless/org.adempiere.sdk-feature/adempiere.cquery"
+  cd $HOME/sources/testheadless
-* Download zk libraries (this is not always required, but sometimes the download of zk libraries fail and it can be run by hand with these commands):
-  cd $HOME/sources/testheadless/org.zkoss.zk.library
+* Position in the branch you want to compile
-  ant -f copyjars.xml
+  # if building development (master) branch
-  ant -f copysources.xml
+ git switch master
+  # if building release 13 branch
+  git switch release-13
 * Build
-  cd $BUCKMINSTER_HOME
+  ./mvnw verify
- buckminster -L DEBUG -consoleLog -data $HOME/sources/testheadless build -t
-* Perform site.p2 action
- buckminster -L DEBUG -consoleLog -data $HOME/sources/testheadless perform \
-     -D 'qualifier.replacement.*=generator:buildTimestamp' \
-     -D "generator.buildTimestamp.format='v'yyyyMMdd-HHmm" \
-     -D 'target.os=*'      \
-     -D 'target.ws=*'     \
-     -D 'target.arch=*'      \
-     'org.adempiere.server:eclipse.feature#site.p2'
-* Perform create.product.zip action for linux x86_64
- buckminster -L DEBUG -consoleLog -data $HOME/sources/testheadless perform \
-     -D 'qualifier.replacement.*=generator:buildTimestamp' \
-     -D "generator.buildTimestamp.format='v'yyyyMMdd-HHmm" \
-     -D 'target.os=linux'  \
-     -D 'target.ws=gtk'   \
-     -D 'target.arch=x86_64' \
-     -D product.features=org.idempiere.eclipse.platform.feature.group \
-     -D product.profile=DefaultProfile \
-     -D product.id=org.adempiere.server.product \
-     'org.adempiere.server:eclipse.feature#create.product.zip'
-* After this step the server installer must be found at:
- /tmp/buckminster/build/org.adempiere.server_3.1.0-eclipse.feature/idempiereServer.gtk.linux.x86_64.zip
-''This tutorial is brought to you by [[User:CarlosRuiz|Carlos Ruiz]] from [http://globalqss.com GlobalQSS].  Feel free to improve directly or suggest using the Discussion tab.
+* After this step the uncompressed servers can be found at:
+ # linux 64 bit version
+ $HOME/sources/testheadless/org.idempiere.p2/target/products/org.adempiere.server.product/linux/gtk/x86_64
+ # windows 64 bit version
+  $HOME/sources/testheadless/org.idempiere.p2/target/products/org.adempiere.server.product/win32/win32/x86_64
+You can compress those folders with your preferred compressor to use them as installers.
+''This tutorial is brought to you by [[User:CarlosRuiz|Carlos Ruiz]] from [https://www.bx-service.com/ BX Service GmbH].  Feel free to improve directly or suggest using the Discussion tab.
+[[Category:HowTo]]
 [[Category:User Manual|I]]
 [[Category:Installation|E]]
@@ Line 71: / Line 47: @@
 [[Category:Development‏‎]]
 [[Category:Developer documentation‏‎]]
+<!-- breadcrumb -->
+<font size=-2>
+&lArr;
+[[Installing_iDempiere|Table of Contents]] |
+[[Running iDempiere within Eclipse]] |
+Building iDempiere without Eclipse
+</font>