= 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 ==

AlsDieses>> <<BasisBeispiel>> <<solltenwird>> <<folgendeauf>> <<Dingeeinem>> <<isnstalliertKUBUNTU>> <<werden:– System (Version 10.04) entwickelt.>>
<<
*Hier>> <<~JavaSEwurden>> <<6einige>> <<JDKProgramme>> <<vonbereits>> <<Sunvorab>> <<inklusiveinstalliert>> <<Sourcenum>> <<(http://java.oracle.com)
*das>> <<MercurialBeispiel>> <<(http://mercurial.selenic.com/)verwenden zu können.>>
<<*
Im>> <<Antersten>> <<(http://ant.apache.org/)Schritt wird JAVA von SUN (keine Alternative) installiert.>>
<<*
>> <<Eclipse, sudo>> <<z.Zt.apt-get>> <<Heliosinstall>> <<(http://www.eclipse.org)kubuntu-restricted-extras >>

<<
Genaueres(hier>> <<zurwerden>> <<Installationbereits>> <<dieserTeile>> <<Komponentenvon>> <<auchJava>> <<unterinstalliert)
Weitere>> <<verschiedenenInfos>> <<Betriebssystemenunter:>> <<kannhttp://wiki.ubuntuusers.de/ubuntu-restricted-extras

Die>> <<manrestliche>> <<unterJAVA-Installation>> <<[LugFrameworkEntwicklerInstallation.Basissystem]wird>> <<finden.recht gut bei ubuntuuser beschrieben:>>
<<http://wiki.ubuntuusers.de/Java/Installation>>

<<==''Bitte>> <<Installationsanweisungenbeachten:''
UNBEDINGT>> <<==mittels KONSOLE installieren.>>
<<
GrundsätzlichEs>> <<bestehterfolgt>> <<daseine>> <<FrameworkAbfrage>> <<inklusivezu>> <<Beispielapplikationenden>> <<ausLizenzbedingungen>> <<mehrerendie>> <<Projektverzeichnissen.nur>> <<Diesein>> <<kannder>> <<manKonsole>> <<entwedersichtbar>> <<einzelnund>> <<herunterladen,bestätigt>> <<z.B.werden.

>> <<in sudo>> <<Eclipseapt-get>> <<mittelsinstall>> <<dessun-java6-jdk

das>> <<MercurialJDK>> <<Pluginsfür>> <<oderEntwickler

>> <<mit sudo>> <<Hilfeapt-get>> <<desinstall>> <<'''sadomaso'''sun-java6-fonts

Die>> <<Skripts.Schriftart>> <<DiesesLucida>> <<lädt(normalerweise>> <<allenicht>> <<Teilprojektebenötigt)

*>> <<herunter(bereits>> <<undautomatisch>> <<stelltinstalliert:>> <<dabeisun-java6-jre>> <<sicher,das>> <<daßJRE>> <<jeweilsfür>> <<zueinandernormale>> <<passendeAnwender)
*>> <<Versionen(bereits>> <<heruntergeladenautomatisch>> <<werdeninstalliert:>> <<(imsun-java6-plugin>> <<allgemeinenJava-Plugin>> <<passenfür>> <<VersionenWebbrowser)

>> <<zueinander, sudo>> <<dieapt-get>> <<zurinstall>> <<gleichensun-java6-source

Quellpakete>> <<Zeitvon>> <<imJava>> <<Repository(wird>> <<obenz.B.>> <<standen).benötigt>> <<Sadomasoum>> <<ist~JavaDoc>> <<erstensder>> <<komfortablerStandardbibliothek>> <<undin>> <<stelltEclipse>> <<zweitensanzuzeigen>> <<sicher,(wie>> <<daßeine>> <<man.JAR>> <<auchhinzufügen)

Anschließend>> <<älterewerden>> <<Programmversionendie>> <<installierenrestlichen>> <<kann,Programme>> <<ohneinstalliert:

MERCURIAL >> <<dabeimittels:

>> <<völlig sudo>> <<durcheinanderapt-get>> <<zuinstall>> <<kommen.mercurial
>> <<Die 
ANT>> <<heruntergeladenendurch:

>> <<Projektverzeichnisse sudo>> <<mussapt-get>> <<maninstall>> <<dannant
ECLIPSE:>> <<anschließend???????>> <<inSiehe>> <<EclipseEclipseInstallation,>> <<alsentweder

>> <<Projekt sudo>> <<nochapt-get>> <<einbinden.install eclipse>>

<<Umoder>> <<dasVon:>> <<Build-Systemhttp://www.eclipse.org/downloads/>> <<(FlyingAnt) wird>> <<zubei>> <<konfigurieren,diesem>> <<istBeispiel>> <<zuerst"Eclipse>> <<folgendesIDE>> <<nötig: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.>>

<<EsAnschließend>> <<solltewird>> ein <<ersterneues>> <<TestArbeitsverzeichnis>> <<desangelegt.>> <<SSH-Zugangs(Workspace>> <<vonunter>> <<Eclipse genannt)
Das Verzeichnis trägt in diesem Beispiel den Namen: Eclipse-LUG
In dem Verzeichnis Eclipse-LUG wird folgender Befehl in >>der Konsole <<auseingegeben:

>> <<gemacht hg>> <<werden:clone -U ssh://benutzername@hg.javaproject.de:2222/repos/Vereinsverwaltung Vereinsverwaltung>>
<<
>>  <<#
ACHTUNG:>> <<sshHierbei>> <<benutzername@hg.javaproject.demuss>> <<-Pnatürlich>> <<2222das Wort benutzername durch Ihren benutzernamen ersetzt werden.....>>

Beim ersten Zugriff wird eine Sicherheitsabfrage erfolgen, die mit yes bestätigt werden muss:
<<{{
The{{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)?(yes/no)?}}>>
<<}}>>
<<
EinNach>> <<passwortlosesEingabe>> <<Logindes>> <<wirdPasswortes>> <<stark(für>> <<empfohlendas>> <<(sieheProjekt)>> <<OpenSSH),werden>> <<weildiverse>> <<manVerzeichnisse>> <<sonstangelegt.

Nun>> <<währendwird>> <<demdas>> <<SkriptlaufProjekt>> <<wachmittels>> <<danebenfolgender>> <<sitzenBefehle>> <<installiert >>und <<mehrmalsgestartet:

>> <<das cd>> <<PasswortVereinsverwaltung
>> <<eingeben hg>> <<muss.update>> <<-d 2010-05-23
 ant all
 ant sadomaso
 
>>Das Projekt besteht aus mehreren Teilprojekten. Diese werden nacheinander installiert. Für jedes Teilprojekt muss <<ggf.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.

<<NunÜbrigens>> <<erzeugtkö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


== Alternative Installationsanweisung (bitte testen) ==

Die "~/.build.properties"-Datei wird wie oben angelegt, dabei muss das Datums-Tag nicht mehr angegeben werden. Dann startet man >>folgendes Skript:

 #!/bin/bash
 #Beispielaufruf:
 #./sadomaso.sh tbayen 2010-06-03
 echo verwendeter Benutzername: "$1"
 echo verwendete Version: "$2"
 rm -r sadomaso
 mkdir -p sadomaso
 cd sadomaso
 hg clone -U ssh://$1@hg.javaproject.de:2222/repos/Vereinsverwaltung Vereinsverwaltung
 cd Vereinsverwaltung
 hg update -d $2
 ant all
 ant -Dhgdatum=$2 sadomaso

Dieses Skript startet man mit

 ./sadomaso.sh benutzername 2010-06-03

wobei man die Parameter entsprechend ändern sollte.<< Nimmt man das Datum von heute, so erhält man die aktuelle Version. Am Ende des Skripts sollte sich das Fenster einer Beispielapplikation öffnen. Voila!>>

<<

>>== Einzelner Start des Programms ==

Ist alles einmal installiert, kann man im Verzeichnis "Vereinsverwaltung/dist/" das Programm direkt starten mit:

 java -jar Vereinsverwaltung.jar



<<== wie geht's weiter? ==

Das sadomaso-Verzeichnis kann man nun als Eclipse-Workspace nehmen und dort per ''Datei/Import...'' alle einzelnen Sub-Projekte importieren. Ab nun sollte man die Pflege der Versionsstände mit dem Mercurial Plugin für Eclipse machen.

Ein wiederholter Aufruf des sadomaso-Skripts löscht den gesamten Workspace(!!!) und installiert alles neu. Sollte man also ganz von Vorne anfangen wollen, ist das die beste Lösung - sonst nicht!


-- ThomasThiessen und ThomasBayen

----
<<'''...ach noch was:''' Jetzt gerade (25.11.10) funktioniert das so genau nicht, weil im Source einige Abhängigkeiten buggy sind. Ich werde das heute abend beheben und dann diese Zeile entfernen. -- ThomasBayen

----
[{Tag Java LugFramework}]