CW selbst bauen
Diese Anleitung richtet sich an alle, die den CW
- selbst erstellen wollen,
- eine aktuelle Version wollen oder benötigen,
- ...
Wie bekomme ich eine brandaktuelle Version des CacheWolf?
Die Sourcen von CacheWolf sind in einem Subversion-Repository bei Code.Google.Com (Details hier) vorhanden, kann jeder lesend zugreifen. Schreibrechte werden auf Anfrage erteilt. Nachfolgend ist beschrieben, wie man sich genau die aktuelle Entwicklerversion besorgen kann und zum Laufen bekommt. Es gibt auch eine Mailingliste, wenn man sich hier einträgt, bekommt man eine Mail, sowie eine Änderung am Code erfolgt ist.
CacheWolf wurde für und mit Ewe in Java programmiert. Ewe bietet für viele Plattformen sogenannte virtuelle Maschienen an, außerdem können für Ewe geschriebene Programme auf allen Plattformen laufen, die eine Java-Laufzeitumgebung haben (nicht zu verwechseln mit dem "Handy-Java" J2ME).
wenn man nicht selber programmieren möchte
Mit dem Java JDK
Benötigte Programme
- JDK , enthält auch die Java Laufzeitumgebung
- Ein Subversion (SVN) Client, z.B. Tortoise für WinXP , kdesvn für Linux (KDE)
Aktionen
- Checkout der aktuellen Sourcen aus dem Repository (z.B. http://cachewolf.googlecode.com/svn/trunk/) in ein beliebiges Verzeichnis.
- Dazu lege ein Verzeichnis an und klicke mit der rechten Maustaste und wähle "SVN Checkout"
- Für Linux : Die Scripte mit einem chmod 755 *.sh ausführbar machen.
- Script compile.bat (WinXP) bzw. ./compile.sh (Linux) ausführen. geht nach bin/CacheWolf. Warnungen ignorieren.
- Script buildexe.bat bzw. ./buildexe.sh ausführen.
- Dabei werden alle notwendigen Hilfsdateien in das Arbeitsverzeichnis work kopiert.
- Die erzeugten Programme stehen unterhalb des Verzeichnisses CacheWolf. Aus dem Unterverzeichnis Jar die Datei CacheWolf.jar in das Verzeichnis work kopieren.
- Script runwolf.bat bzw. ./runwolf.sh ausführen. Damit wird CacheWolf.jar (der CacheWolf) im Work-Verzeichnis gestartet.
- Beim ersten Start wird nach einem Datenverzeichnis gefragt. Das Datenverzeichnis kann beliebig bestimmt werden.
wenn man auch mal was programmieren möchte
Mit Eclipse
Benötigte Programme
- Für Eclipse wird das JDK nicht benötigt, da Eclipse mit einem eigenen Compiler kommt. JRE muss aber vorhanden sein.
- Zum Auschecken wird das Plugin Subclipse benötigt.
Am einfachsten ist es das Paket "EasyEclipse" zu verwenden. Es enthält alle notwendigen Module.
Die einzelnen Schritte :
- von easyeclipse.org Easy Eclipse Desktop Java herunterladen
- und installieren.
- Eclipse starten, ein "Workspace" - Verzeichnis bestimmen. Unter diesem werden die Projekte angelegt.
- Ein neues Projekt anlegen
- (File -> new -> Project)
- erweitere "SVN", wähle "Check out projects from SVN", Klick Schaltfläche "next"
- Eclipse weiss noch nicht woher die Daten kommen sollen : "Create a new repositoy location", Klick Schaltfläche "next"
- Seite "check out as" erscheint. Auswahl belassen "Check out as project using new project wizard", Klick Schaltfläche "Finish"
- Schon wieder erscheint der "new Project" Wizard. Es geht jetzt um die lokale Projektdefinition.
- Erweitere "Java", wähle "Java Project", Klick Schaltfläche "next"
- Gefragt ist der Projektname. Gebe bitte "CacheWolf" ein. "Bitte genau so schreiben!"
- Den Rest kann man sich sparen und gleich auf Schaltfläche "Finish" klicken.
- Jetzt werden alle Dateien aus dem "Repository" heruntergeladen. Das dauert etwas.
- Es werden die Dateien unterhalb des "Workspace" - Verzeichnisses in das Verzeichnis mit dem Projektnamen (CacheWolf) kopiert.
- Jetzt kann CacheWolf fast gestartet werden.
- Kopiere mit Hilfe des Scripts "getres.bat" bzw "getres.sh" die notwendigen Dateien in das Arbeitsverzeichnis "work".
- nachsehen ob (Project -> Build Automatically) angehakt ist
- und vorsichtshalber einmal neu compilieren mit (Project -> Clean), mit Schaltfläche "ok" bestätigen.
- (Run -> Run Configurations) links "Java Application" erweitern und "CacheWolf" auswählen, klicke Schaltfläche "Run"
- Falls CacheWolf dort nicht erscheint: siehe *1
- alternativ
- (Run -> Debug Configurations) links "Java Application" erweitern und "CacheWolf" auswählen, klicke Schaltfläche "Debug"
- Beim ersten Start des CacheWolf wird man nach dem Datenverzeichnis für CacheWolf gefragt. Das weitere sollte bekannt sein.
- Danach sollte ein Eintrag "CacheWolf" in der Historie der Symbolleiste unter dem Debugsymbol bzw Runsymbol sein. Das kann für zukünftige Starts verwendet werden.
fertig
- *1 Falls man nicht das EasyEclipse installiert hat sind noch die Rahmenbedingungen für den Start des "CacheWolf" - Projektes festzulegen (stehen in der Datei CacheWolf.launch):
- (File -> Import)
- erweitere "Run/Debug", wähle "Launch Configurations", Klick Schaltfläche "next"
- Klick Schaltfläche "Browse ..." und klicke bis ins Verzeichnis <workspace>/CacheWolf
- Klick unterhalb links auf "CacheWolf", dann erscheint rechts "CacheWolf.launch", setze Haken, klicke Schaltfläche "Finish"
- Alternativ kann man sich eine neue Konfiguration auch zusammenklicken und schreiben:
- Reiter Main: Project: CacheWolf, Main class: Ewe
- Reiter Arguments: Program arguments: CacheWolf.CacheWolf, VM arguments: -Xms64M -Xmx1024M, working dir other:${workspace_loc:CacheWolf/work}
- Reiter Classpath: User entries: 1.ewe.jar (\CacheWolf\lib) 2.CacheWolf (default classpath) 3.JavaEwe.zip (\CacheWolf\lib)
- *2 Um die lauffähigen Dateiversionen zu erzeugen wird wie oben das Script "buildexe.bat" bzw "buildexe.sh" verwendet.
Mit Ant lauffähige Versionen erzeugen
Es wird die Datei "build.xml" des "CacheWolf" Verzeichnisses benutzt.
- pfeffer oder greiol im Forum fragen
Die NBs (nightly builds) werden damit erzeugt
Mit fwrtsnapshot.sh lauffähige Versionen erzeugen.
Es wird die Datei "fwrtsnapshot.sh" des "CacheWolf" Verzeichnisses benutzt.
Die NBs (nightly builds) wurden damit erzeugt.
