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

DiesesAls>> <<BeispielBasis>> <<wirdsollten>> <<auffolgende>> <<einemDinge>> <<KUBUNTUisnstalliert>> <<– System (Version 10.04) entwickelt.werden:>>
<<Hier
*>> <<wurden~JavaSE>> <<einige6>> <<ProgrammeJDK>> <<bereitsvon>> <<vorabSun>> <<installiertinklusive>> <<umSourcen>> <<das(http://java.oracle.com)
*>> <<BeispielMercurial>> <<verwenden(http://mercurial.selenic.com/)
*>> <<zuAnt>> <<können.(http://ant.apache.org/)>>
<<
Im*>> <<erstenEclipse,>> <<Schrittz.Zt.>> <<wirdHelios>> <<JAVA von SUN (keine Alternative) installiert.(http://www.eclipse.org)>>

<<  sudo apt-get install kubuntu-restricted-extras >>
<<
(hierGenaueres>> <<werdenzur>> <<bereitsInstallation>> <<Teiledieser>> <<vonKomponenten>> <<Javaauch>> <<installiert)
Weitereunter>> <<Infosverschiedenen>> <<unter:Betriebssystemen>> <<http://wiki.ubuntuusers.de/ubuntu-restricted-extras

Diekann>> <<restlicheman>> <<JAVA-Installationunter>> <<wird[LugFrameworkEntwicklerInstallation.Basissystem]>> <<recht gut bei ubuntuuser beschrieben:finden.>>
<<http://wiki.ubuntuusers.de/Java/Installation>>

<<''Bitte==>> <<beachten:''
UNBEDINGTInstallationsanweisungen>> <<mittels KONSOLE installieren.==>>
<<Es
Grundsätzlich>> <<erfolgtbesteht>> <<einedas>> <<AbfrageFramework>> <<zuinklusive>> <<denBeispielapplikationen>> <<Lizenzbedingungenaus>> <<diemehreren>> <<nurProjektverzeichnissen.>> <<inDiese>> <<derkann>> <<Konsoleman>> <<sichtbarentweder>> <<undeinzeln>> <<bestätigtherunterladen,>> <<werden.

z.B.>> << sudoin>> <<apt-getEclipse>> <<installmittels>> <<sun-java6-jdk

dasdes>> <<JDKMercurial>> <<fürPlugins>> <<Entwickler

oder>> << sudomit>> <<apt-getHilfe>> <<installdes>> <<sun-java6-fonts

Die'''sadomaso'''>> <<SchriftartSkripts.>> <<LucidaDieses>> <<(normalerweiselädt>> <<nichtalle>> <<benötigt)

*Teilprojekte>> <<(bereitsherunter>> <<automatischund>> <<installiert:stellt>> <<sun-java6-jredabei>> <<dassicher,>> <<JREdaß>> <<fürjeweils>> <<normalezueinander>> <<Anwender)
*passende>> <<(bereitsVersionen>> <<automatischheruntergeladen>> <<installiert:werden>> <<sun-java6-plugin(im>> <<Java-Pluginallgemeinen>> <<fürpassen>> <<Webbrowser)

Versionen>> << sudozueinander,>> <<apt-getdie>> <<installzur>> <<sun-java6-source

Quellpaketegleichen>> <<vonZeit>> <<Javaim>> <<(wirdRepository>> <<z.B.oben>> <<benötigtstanden).>> <<umSadomaso>> <<~JavaDocist>> <<dererstens>> <<Standardbibliothekkomfortabler>> <<inund>> <<Eclipsestellt>> <<anzuzeigenzweitens>> <<(wiesicher,>> <<einedaß>> <<.JARman>> <<hinzufügen)

Anschließendauch>> <<werdenältere>> <<dieProgrammversionen>> <<restlicheninstallieren>> <<Programmekann,>> <<installiert:

MERCURIAL ohne>> <<mittels:

dabei>> << sudovöllig>> <<apt-getdurcheinander>> <<installzu>> <<mercurial
kommen.>> << 
ANTDie>> <<durch:

heruntergeladenen>> << sudoProjektverzeichnisse>> <<apt-getmuss>> <<installman>> <<ant
ECLIPSE:dann>> <<???????anschließend>> <<Siehein>> <<EclipseInstallation,Eclipse>> <<entweder

als>> << sudoProjekt>> <<apt-getnoch>> <<install eclipseeinbinden.>>

<<oderUm>> <<Von:das>> <<http://www.eclipse.org/downloads/Build-System>> << wird(FlyingAnt)>> <<beizu>> <<diesemkonfigurieren,>> <<Beispielist>> <<"Eclipsezuerst>> <<IDEfolgendes>> <<for Java Developers" benutzt.nötig:>>

<<

== 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ßendEs>> <<wirdsollte>> ein <<neueserster>> <<ArbeitsverzeichnisTest>> <<angelegt.des>> <<(WorkspaceSSH-Zugangs>> <<untervon>> <<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:

aus>> << hggemacht>> <<clone -U ssh://benutzername@hg.javaproject.de:2222/repos/Vereinsverwaltung Vereinsverwaltungwerden:>>
<<
>>  <<
ACHTUNG:#>> <<Hierbeissh>> <<mussbenutzername@hg.javaproject.de>> <<natürlich-p>> <<das Wort benutzername durch Ihren benutzernamen ersetzt werden.....2222>>

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)?>>
<<}}>>
<<Nach
Ein>> <<Eingabepasswortloses>> <<desLogin>> <<Passworteswird>> <<(fürstark>> <<dasempfohlen>> <<Projekt)(siehe>> <<werdenOpenSSH),>> <<diverseweil>> <<Verzeichnisseman>> <<angelegt.

Nunsonst>> <<wirdwährend>> <<dasdem>> <<ProjektSkriptlauf>> <<mittelswach>> <<folgenderdaneben>> <<Befehlesitzen>> <<installiert >>und <<gestartet:

mehrmals>> << cddas>> <<Vereinsverwaltung
Passwort>> << hgeingeben>> <<updatemuss.>> <<-d 2010-05-23
 ant all
 ant sadomaso
 
>>Das Projekt besteht aus mehreren Teilprojekten. Diese werden nacheinander installiert. Für jedes Teilprojekt muss <<zurggf.>> <<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.

<<ÜbrigensNun>> <<könnteerzeugt>> 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

----
[{Tag Java LugFramework}]