Installation and setup of Eclipse IDE/de

Einleitung

Openbravo's letzter source code wurde so modifiziert das er mit Eclipse's projects schema arbeitet. Die Hauptänderungen sind:

• src-core, src-trl y src-wad: sind nun Verzeichnisse, welche komplette Eclipse Unterprojekte enthalten, mit komplilier-Ausgaben (build) und source code (src), und die Bibliotheken für alle.
• The build of source root for the ERP compilation.
• WebContent: Ein neues Verzeichniss in der root source enthält alle notwendigen Dateien für den Apache Tomcat context, alles ausser den kompilierten klassen.

Minimale Anforderungen

Man braucht ein paar tools um Eclipse als Entwicklungsumgebung zu verwenden:

• A SVN client
• JDK 1.5
• Apache Tomcat 5.5
• Oracle XE
• Eclipse: Muss eine Distribution mit folgenden Plugins sein: WTP, Java EE und Subclipse. Diese Distribution enthält auch Ant für tasks execution.

Installation Oracle XE

Wir installieren Oracle XE wie [hier]. HINWEIS: Verwende einen anderen HTTP Port als 8080 für Oracle, welcher während des Ausführens des Befehls

/etc/init.d/oracle-xe configure

angegeben werden muss. Der Tomcat Server aus dem Debian repository, welchen wir nicht verwenden, verwendet von sich aus Port 8180, aber den Tomcat welchen wir verwenden, nimmt standardmäßig Port 8080, welches zu konflikten mit der Oracle Datenbank kommt. Verwende z.b. Port 8280.

Download des Source Code

Mit einem SVN client (nicht subclipse), welchen man mit

aptitude install subversion

installieren kann, kann man den Quellcode vom Hauptrepository herunterladen, indem man folgendes Kommando verwendet

svn co https://dev.openbravo.com/svn/openbravo/trunk/ [your_folder]

[your_folder] ist der Verzeichnissname wohin der Quellcode heruntergeladen wird, z.b.

svn co https://dev.openbravo.com/svn/openbravo/trunk/ openbravo

HINWEIS: Führe diesen Befehl mit dem Systembenutzer aus, mit dem man auch später eclipse/subclipse benutzt.

Installation der Eclipse Projekte

In der Eclipse IDE:

• Gehe zu File/Import menü element.
• Unter General, wähle die option Existing projects into workspace von der Liste.
• Dann drücke den Next button.

Im folgenden Fenster muss man den Projekt Pfad wählen, welchen wir importieren wollen, wiederhole diese Schritte für jedes Projekt (4 im gesamten) in dieser Reihenfolge:

• openbravo/src-core
• openbravo/src-trl
• openbravo/src-wad
• openbravo

Wenn man alle Projekte importiert hat, ist die Entwicklungsumgebung fertig zum kompilieren.

Definieren des Tomcat Server

Man kann tomcat5.5 aus dem Debian repository leider nicht so ohne weitere Veränderungen in Eclipse verwenden, deshalb laden wir uns [hier] apache-tomcat-5.5.25.tar.gz herunter und kopieren in nach /usr/local/. Danach entpacken wir tomcat mit

tar -xzf apache-tomcat-5.5.25.tar.gz

Nun haben wir einen fertigen tomcat.

Um diesen Tomcat server zu definieren, wählen wir in der IDE den Menüpunkt Window/Preferences . Die Kategorie welche wir konfigurieren müssen ist Server/Installed Runtimes

• Wähle Add um einen neuen Server zu erstellen

• Im folgenden Fenster wählen wir den Typ von Server: Apache/Apache Tomcat v5.5 und klicken auf Next

• Im nächsten Fenster muss man den Namen des Servers angeben name, den path wo der Server installiert ist, und das JRE welches der luncher benutzen wird. Klick auf den Next button.

Nach diesen Schritten, muss man das Projekt gegen den neuerstellten Server linken. In Eclipse öffne die Servers view.

• Rechtsklick in eine leere zone, um ein Kontextmenü zu öffnen.
• Wähle New/Server option

• Im folgenden Fenster kann man den vorher erstellten Server auswählen. Wähle ihn und klicke auf den Next button.
• In diesem Fenster kann man die Projekte wählen, welche man an den Server linken möchte. Wähle das openbravo projekt. Klick auf den Finish button.

Kompilieren mit Eclipse

Als erstes müssen wir einige Parameter in den konfigurationsdateien ändern. Von einer Konsole, im openbravo Verzeichniss, führen wir folgenden Befehl aus:

ant -f build.xml.template setup

Dann modifiziere die openbravo/config/Openbravo.properties Datei und setze die Werte für eine angepasste installation.

Der install.source task, welchen man von dem Run/External Tools/install.source menü laufen lassen kann, erledigt all die notwendigen operationen, von der Datenbankerstellung, bis zum Kompilieren aller Projekte.

Ein anderer Weg zu kompilieren ist es, die ant task in folgender Reihenfolge aufzurufen:

Datenbank

Task welcher verwendet wird um die Datenbank zu erstellen vom Run/External Tools/create.database Menü.

OpenbravoCore

• Wähle das Projekt aus der Project Explorer Ansicht.
• Wählen die Project/Build Project menü option. Man kann kompilierfehler in der Problems Ansicht sehen.

OpenbravoTrl

• Wähle die Run/External Tools/eclipse.trl.lib menü option. Dieser ant task generiert die java source Dateien basierend auf xsql Definitionen.
• Wähle das Projekt von der Projects Explorer Ansicht.
• Wähle die Project/Build Project menü option. Man kann kompilierungsfehler in der Problems Ansicht sehen.

OpenbravoWAD

• Wähle die Run/External Tools/eclipse.wad.lib menü option. Dieser ant task generiert die java source Dateien basierend auf xsql Definition.
• Wähle das Projekt von der Project Explorer Ansicht.
• Wähle die Project/Build Project menü option. Man kann kompilierungsfehler in der Problems Ansicht sehen.

openbravo

• Wähle die Run/External Tools/eclipse.compile.complete menü option. Dieser ant task generiert alle Fenster und java sources definiert in xsql Dateien.
• Wähle das Projekt von der Project Explorer Ansicht.
• Wähle die Project/Build Project menü option. Man kann kompilierungsfehler in der Problems Ansicht sehen.