Entwickler-Installation des LUG-Framework #

Diese Anleitung dient dazu, daß man das erweiterte Lug-Projekt (also inklusive Datenbank-Oberfläche und Vereinsverwaltung als Beispiel) im Sourcecode herunterlädt und mit Eclipse daran mitarbeiten kann.

Basissystem #

Dieses Beispiel wird auf einem KUBUNTU – System (Version 10.04) entwickelt. Hier wurden einige Programme bereits vorab installiert um das Beispiel verwenden zu können.

Im ersten Schritt wird JAVA von SUN (keine Alternative) installiert.

  sudo apt-get install kubuntu-restricted-extras 

(hier werden bereits Teile von Java installiert) Weitere Infos unter: http://wiki.ubuntuusers.de/ubuntu-restricted-extras

Die restliche JAVA-Installation wird recht gut bei ubuntuuser beschrieben: http://wiki.ubuntuusers.de/Java/Installation

Bitte beachten: UNBEDINGT mittels KONSOLE installieren. Es erfolgt eine Abfrage zu den Lizenzbedingungen die nur in der Konsole sichtbar und bestätigt werden.

  sudo apt-get install sun-java6-jdk

das JDK für Entwickler

  sudo apt-get install sun-java6-fonts

Die Schriftart Lucida (normalerweise nicht benötigt)

• (bereits automatisch installiert: sun-java6-jre das JRE für normale Anwender)
• (bereits automatisch installiert: sun-java6-plugin Java-Plugin für Webbrowser)

  sudo apt-get install sun-java6-source

Quellpakete von Java (wird z.B. benötigt um JavaDoc der Standardbibliothek in Eclipse anzuzeigen (wie eine .JAR hinzufügen)

Anschließend werden die restlichen Programme installiert:

MERCURIAL mittels:

  sudo apt-get install mercurial

ANT durch:

  sudo apt-get install ant ECLIPSE: ??????? Siehe EclipseInstallation, entweder

  sudo apt-get install eclipse

oder Von: http://www.eclipse.org/downloads/ wird bei diesem Beispiel "Eclipse IDE for Java Developers" benutzt.

Installationsanweisungen #

Im ersten Schritt wird im /home/benutzername/ Verzeichnis die Datei: ".build.properties" (bitte auf den PUNKT am Anfang achten) erzeugt.

In dieser Datei werden folgende 3 Zeilen eingetragen;

  hguser=benutzername
  hgserver=hg.javaproject.de:2222
  hgdatum=2010-05-23

Als hguser wird der von ThomasBayen vergebene Benutzername auf dem Mercurial-Server eingegeben. hgdatum wird immer aktuell mitgeteilt, wenn es eine neue Version gibt.

Anschließend wird ein neues Arbeitsverzeichnis angelegt. (Workspace unter Eclipse genannt) Das Verzeichnis trägt in diesem Beispiel den Namen: Eclipse-LUG In dem Verzeichnis Eclipse-LUG wird folgender Befehl in der Konsole eingegeben:

  hg clone -U ssh://benutzername@hg.javaproject.de:2222/repos/Vereinsverwaltung Vereinsverwaltung

ACHTUNG: Hierbei muss natürlich das Wort benutzername durch Ihren benutzernamen ersetzt werden.....

Beim ersten Zugriff wird eine Sicherheitsabfrage erfolgen, die mit yes bestätigt werden muss: The authenticity of host '[hg.javaproject.de]:2222 ([91.41.155.54]:2222)' can't be established. RSA key fingerprint is 5d:01:17:cf:ca:ca:d7:88:73:d6:e3:f7:eb:e1:38:17. Are you sure you want to continue connecting (yes/no)?

Nach Eingabe des Passwortes (für das Projekt) werden diverse Verzeichnisse angelegt.

Nun wird das Projekt mittels folgender Befehle installiert und gestartet:

  cd Vereinsverwaltung
  hg update -d 2010-05-23
  ant all
  ant sadomaso

Das Projekt besteht aus mehreren Teilprojekten. Diese werden nacheinander installiert. Für jedes Teilprojekt muss zur Zeit jeweils das Passwort eingegeben werden. Hierfür haben Sie ca. 1 Minute Zeit, d.H. Sie sollten während der Installation weder einen Kaffee holen gehen noch ein Telespiel in einem anderen Task machen.

Besser ist es, wenn man sich passwortlos per ssh public key auf dem Server einloggen kann: http://www.lug-kr.de/wiki/OpenSSH#section-OpenSSH-EinloggenPerSSHSchl_C3_BCssel - dann kann man den Kaffee beruhigter trinken.

Übrigens könnte man große Teile dieser Prozedur in ein Skript verpacken, dem man dann nur noch das Versionsdatum als Parameter übergibt. Wer hat Lust, das zu machen und auszuprobieren?

-- ThomasThiessen und ThomasBayen