KB-206 – Build and Compilation¶

Knowledge Base ID: KB-206 Project: BLACK ERP Version: 1.0 Status: Superseded Last Update: 2026-06-26 Superseded By: KB-208 – Core Development Lifecycle

1. Purpose¶

This document was created during the initial investigation of the ADempiere build and compilation process used by BLACK ERP.

It is retained for historical reference only.

The certified build, packaging, signing and deployment lifecycle is now documented in:

KB-208 – Core Development Lifecycle

2. Historical Context¶

During the first analysis, the following facts were identified:

The ADempiere source tree is located at:

/opt/adempiere/source

The production runtime is located at:

/opt/adempiere/Adempiere

The base module can be compiled safely using the Ant compile target.
Running RUN_build.sh directly is not recommended for validation because it invokes targets that depend on test execution.
The dist target depends on test phases that currently fail due to missing optional Ant/JUnit components.

3. Valid Historical Finding¶

The following command remains valid only for Java compilation validation:

cd /opt/adempiere/source/base

. ../utils_dev/myDevEnv.sh

$JAVA_HOME/bin/java \
-Dant.home="." \
$ANT_PROPERTIES \
org.apache.tools.ant.Main compile

Expected result:

BUILD SUCCESSFUL

This validates Java compilation only.

It does not generate a deployable production artifact.

4. Superseded Information¶

This document does not define the official deployment process.

The official lifecycle is now:

Modify Java Source
        │
        ▼
Compile base
        │
        ▼
Generate Adempiere.jar using clientDistribute
        │
        ▼
Generate signed runtime Adempiere.jar using setupALib
        │
        ▼
Deploy signed artifact
        │
        ▼
Validate runtime and business process

Refer to:

KB-208 – Core Development Lifecycle

KB-104 – Deployment Procedure
KB-207 – Core Java Build and Signed Deployment
KB-208 – Core Development Lifecycle

Revision History¶

Version	Date	Description
0.1	2026-06-26	Initial investigation draft.
1.0	2026-06-26	Marked as superseded by KB-208.