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 www.berlios.de (Details hier) vorhanden, hierauf kann jeder lesend zugreifen. Schreibrechte werden auf Anfrage erteilt. Nachfolgend ist beschrieben, wie man sich 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).

Die hier folgende Anleitung ist veraltet, bleibt aber zunächst hier stehen, weil sie auf Deutsch ist.

Benötigte Programme

• JDK von Sun , enthält auch die Java Laufzeitumgebung
• Ein Subversion (SVN) Client, z.B. Tortoise für WinXP , kdesvn für Linux (KDE) oder das subclipse-Plugin für eclipse
• Das Ewe-Developer-SDK

Java-Version

• Checkout der aktuellen Sourcen aus dem Repository (z.B. http://svn.berlios.de/svnroot/repos/cachewolf/trunk)
• Das Verzeichnis kann lokal umbenannt werden, z.B. in CacheWolf
• Es sollte bereits ein Verzeichnis bin/CacheWolf geben, falls nicht, bitte anlegen
• Die Linux-Scripte mit einem chmod 755 *.sh ausführbar machen
• Script compile.bat (WinXP) bzw. ./compile.sh (Linux) ausführen. Es gibt etwa 10 Warnings.
• Script getRes.bat bzw. ./getRes.sh ausführen. Damit werden u.a. die Image-Dateien in das Work-Verzeichnis kopiert
• Script runwolf.bat bzw. ./runwolf.sh ausführen. Damit wird der CacheWolf im Work-Verzeichnis gestartet. Das Datenverzeichnis sollte man irgendwo anders hinlegen, z.B. parallel zum CacheWolf-Verzeichnis.

Ausführbare Versionen erzeugen, z.B. für WinXP oder PPC

Parallel zum CacheWolf-Verzeichnis ein Verzeichnis Ewe/programs anlegen, die Dateien finden sich im Ewe-Developer-SDK. Da dieses Verzeichnis von den Scripten relativ (also per ../Ewe/programs) angesprochen wird, auf genaue Einhaltung der Namen achten. Der Inhalt des Verzeichnisses ist bei mir unter Linux wie folgt:

Code:
-rw-r--r-- 1 kalle kalle 29 2006-07-28 20:43 Ewesoft-Jewel.cfg
-rw-r--r-- 1 kalle kalle 3830895 2005-12-19 19:27 JavaEwe.zip
-rw-r--r-- 1 kalle kalle 2748046 2005-12-19 16:52 JewelData.jar
-rw-r--r-- 1 kalle kalle 254444 2005-11-26 23:53 Jewel.ewe
-rw-r--r-- 1 kalle kalle 47 2005-01-20 18:44 RunJewel.bat
-rwxr-xr-x 1 kalle kalle 47 2006-07-24 21:30 runjewel.sh
runjewel.sh habe ich mir selbst aus runJewel.bat erzeugt.

In dem Verzeichnis lib die folgenden Dateien rekursiv auspacken (.jar-Files sind zip-Dateien, falls der Entpacker muckt, einfach temporär in .zip umbenennen)

• ewesoft.zip
• EwesoftRegex.zip
• HTML.zip
• openmap.jar

Es gibt dann die Unterverzeichnisse com, ewesoft und HTML.

• Script buildexe.bat bzw. ./buildexe.sh aufrufen, es wird ein Verzeichnis CacheWolf erzeugt mit Unterverzeichnissen für die unterschiedlichen Plattformen.
• mit dem Script runjewel können Änderungen an der Datei cwberlios.jnf vorgenommen werden.

How to build your own development environment for CacheWolf
===========================================================

It is quite easy. All you need is 1. a java compiler (javac from sun or gcj) 2. a svn client 3. if you want comfortable programming: an integrated development environment (IDE). We recommend to use Eclipse.

For most easy installing, you can use the package "EasyEclipse Desktop" as it contains all 3 items in one installation package and is available for Windows, Linux and MacOS. (In eclipse the plugin "subclipse" is the svn client)

Steps:

1. goto http://www.easyeclipse.org/site/distributions/index.html and download the newest "EasyEclipse for java" (any version should work, I used "EasyEclipse Desktop v1.3.1.1").
2. install it.
3. start eclipse, you will be asked for an directory name where to store eclipse projects. Select / create an directory in your home dir.\\

4. In eclipse create a new projet from svn:

• a) click: File -> new -> Projet,
• b) select SVN, and "Check out projects from SVN" -> next
• c) select "Create a new repositoy location" -> next
• d) enter: http://svn.berlios.de/svnroot/repos/cachewolf -> next
• e) wait until the directories appear, select the first item, ending with "trunk" -> next
• f) select "Check out as project using new project wizard"
• g) new project wizard appears. Select Java Project and enter a project name, e.g. "cachewolf" -> finish, wait until all the source code and supplemental programs from the svn is downloaded
• h) if you still see the "welcome screen" click on "workbench"

5. Now we need to configure the project. Therefore:

• a) Click in the menu: project -> properties -> Run/Debug Settings, Click "New..." and choose "Java Application"
• b) In the "Name" field enter "CacheWolf" (or any other name that is convenient)
• c) in field "Main Class" enter "Ewe"
• d) click on the tab "Arguments" and enter as "Program arguments" "CacheWolf.CacheWolf", und "working directory" select "other", click on button "workspace" and select "work" -> ok.
• e) click on the tab "classpath", select "user entries" and remove all entries below.
• f) select "user entries", "Add projects", select "Cachewolf" -> ok
• g) select "user entries" and click on button "add JARs", select cachewolf/lib/JavaEwe.zip -> ok.
• h) select "user entries" and click on "Advanced", keep "Add Folder", click "Ok", select cachewolf/lib
• i) Click ok till all windows are closed.

6. copy the needed ressources into the working directory by double clicking on getres.bat or getres.sh on the filemanager (windows exploprer)

7. to compile and run cachewolf click in the menu in eclipse the menu run -> run or click the "play" icon or press ctrl-f11.