Latest revision as of 04:14, 12 September 2012

⇐ DE/Inhaltsverzeichnis{{#if: | | [[{{{2}}}]] }}{{#if: | | [[{{{3}}}]] }}{{#if: | | [[{{{4}}}]] }}{{#if: | | [[{{{5}}}]] }} | Entwicklungsumgebung einrichten{{#if: Create your ADempiere development environment| | Create your ADempiere development environment }} ⇒

Die entsprechende engliche Seite ist schon betagt. Da ist noch von eclipse 3.4 (Ganymede) und Subversion als SCM für ADempiere die Rede. Daher übersetze ich sie nicht, sondern beschreibe den aktuellen Zustand. Vor kurzem habe ich mit der aktuellen Eclipse IDE (Indigo Win 64-bit) die letzten drei Versionen von ADempiere aus den Sourcen erstellt. Es ist also eine Art Erfahrungsbericht.

Source Code Management (SCM)

• Official Releases (sourceforge)
• Anfang 2011 wurde das SCM von ADempiere von Subversion (SVN) auf Mercurial (HG) umgestellt

java

für's build wird java 1.6 benötigt.

eclipse

http://www.eclipse.org/downloads/

Eclipse Indigo (3.7.2)

zum Download der Sourcen sinnvoll:

• Mercurial plugin for Eclipse IDE, http://cbes.javaforge.com/update

Dieses plugin läßt sich einfach nachinstellieren:

Download ADempiere source

ADempiere als Eclipse Projekt

• Clone Mercurial repository

In einem eclipse Workspace kann direkt aus dem Mercurial-SCM ein ADempiere Projekt erstellt werden.

Dazu wird zuerst die Repository-URL http://adempiere.hg.sourceforge.net/hgweb/adempiere/adempiere angegeben. Nach dem Download kann die Version (tag) ausgewählt werden.

Eine gutes Tutorial zu Mercurial-HG ist unter http://hginit.com/ (es ist kein Tutorial zum eclipse plugin).

read/write Access

Entwickler, die auch schreibenden Zugriff auf das Repository benötigen, müssen den Mercurial client mit URL ssh://USERNAME@adempiere.hg.sourceforge.net/hgroot/adempiere/adempiere konfigurieren (siehe [1] bzw. [2]).

Das führt manchmal zu
abort: no suitable response from remote hg!

Grund für dieses Problem ist, dass im Mercurial-Plugin per default kein ssh-Modul definiert ist. Siehe Mercurial.ini (zu finden in C:\Users\ich\.eclipse\org.eclipse.platform_3.7.0_578537893\plugins\com.intland.hgbinary.win32_1.9.3\os\win32):

; In order to push/pull over ssh you must specify an ssh tool
;ssh = "C:\Progra~1\TortoiseSVN\bin\TortoisePlink.exe" -ssh -2
;ssh = C:\cygwin\bin\ssh

Ich habe TortoisePlink.exe mit TortoiseSvn und mit TortoiseHg installiert und das ssh-Modul so definiert

ssh = "C:\Program Files\TortoiseSVN\bin\TortoisePlink.exe" -ssh -2

Damit war das Problem behoben.

Create Ant Builder

Create Ant Builder

Nach dem Download der Sourcen versucht eclipse sofort ein compile, weil "Build Automatically" standardmäßig eingestellt ist. Das wird nicht gut gehen, denn Adempiere wird per Ant compiliert. Die xml-Build-Datei ist utils_dev/build.xml. Für das ADempiere-Projekt muss also ein Ant Builder eingerichtet werden:

Ant Builder JRE 1.6

Folgende Punkte berücksichtegen

• Java 1.6 als JRE eintragen, falls eclipse mit einer anderen JRE betrieben wird
• den "default" Java Builder deaktiveren, oder den erstellten Ant Builder vor den Java Builder stellen

Build

Jetzt kann mit "Build All" der Compile angestossen werden. Das default build-target heißt complete:

<target name="complete" depends="build, install">

Das Ergebnis findet man in den Verzeichnissen ${workspace_loc:/adempiereTrunk}\adempiere\Adempiere
und schön verpackt in ${workspace_loc:/adempiereTrunk}\adempiere\install:

23.05.2012  14:18    <DIR>          .
23.05.2012  14:18    <DIR>          ..
23.05.2012  16:01       157.824.019 Adempiere_370LTS.tar.gz
23.05.2012  16:01                59 Adempiere_370LTS.tar.gz.MD5
23.05.2012  16:01       157.936.430 Adempiere_370LTS.zip
23.05.2012  16:01                56 Adempiere_370LTS.zip.MD5

Build Probleme

... hoffentlich mit Lösungen

Eclipse Helios (3.6)

... nicht gross anders

Eclipse (Linux)

...

Eclipse (Mac)

...

patches

siehe ADempiere_Deutsch_Integration, see Patches_Installation

customization

siehe ADempiere_Deutsch_Integration, see Create_your_ADempiere_customization_environment

Customize Probleme

... hoffentlich mit Lösungen :-)

customization.jar deaktiviert

Das beschriebene Verfahren zur Erstellung von customization.jar und patches.jar ist korrekt. Aber die Wirkung ist deaktiviert, weil die beiden libs nicht mehr im CLASSPATH sind.

Siehe Talk:Patches_Installation#customization.jar_and_patches.jar_not_in_CLASSPATH

Lösung kurzfristig

CLASSPATH in RUN_Adempiere.bat (RUN_Adempiere.sh) erweitern

Set CLASSPATH=lib\customization.jar;lib\patches.jar;lib\Adempiere.jar; ...
 ...
@Set CLASSPATH=%ADEMPIERE_HOME%\lib\customization.jar;%ADEMPIERE_HOME%\lib\patches.jar;%ADEMPIERE_HOME%\lib\Adempiere.jar; ...

Lösung langfristig

dto im SCM

links

• Create_your_ADempiere_development_environment
• Create_your_ADempiere_customization_environment
• De_DE/eclipse-setup
• Hacker's guide
• Compile
• Creating WebUI Workspace using Eclipse Webtool
• ADempiere_Deutsch_Integration
• http://www.frei-bier.org/wiki/Install_ADempiere_361_in_Eclipse