Vodcatcher Helper/Entwickler

Diese Seite beschreibt, wie man die Entwicklungsumgebung für VCH aufsetzt. Ich habe dazu Videos "gedreht" mit einem frisch installierten Ubuntu 10.10. Für andere Betriebssysteme kann man aber analog vorgehen.

Installation der Werkzeuge

Video: Installation unter Ubuntu 10.10

Für die Entwicklung von VCH wird ein Java Development Kit (JDK 1.6), Maven 2 und Git benötigt.

apt-get install openjdk-6-jdk maven2 git

Anlegen der settings.xml für Maven

Folgende Datei

~/.m2/settings.xml

mit folgendem Inhalt anlegen

<settings>
 <profiles>
   <profile>
       <id>default</id>
       <activation>
           <activeByDefault>true</activeByDefault>
       </activation>
       <repositories>
         <repository>
           <id>hampelratte</id>
           <name>hampelratte.org</name>
           <url>http://hampelratte.org/nexus/content/groups/public</url>
           <layout>default</layout>
           <releases>
             <enabled>true</enabled>
             <updatePolicy>always</updatePolicy>
             <checksumPolicy>warn</checksumPolicy>
           </releases>
           <snapshots>
             <enabled>true</enabled>
             <updatePolicy>always</updatePolicy>
             <checksumPolicy>fail</checksumPolicy>
           </snapshots>
         </repository>
         <repository>
           <id>hampelratte-snapshots</id>
           <name>hampelratte.org</name>
           <url>http://hampelratte.org/nexus/content/groups/public-snapshots</url>
           <layout>default</layout>
           <releases>
             <enabled>true</enabled>
             <updatePolicy>always</updatePolicy>
             <checksumPolicy>warn</checksumPolicy>
           </releases>
           <snapshots>
             <enabled>true</enabled>
             <updatePolicy>always</updatePolicy>
             <checksumPolicy>fail</checksumPolicy>
           </snapshots>
         </repository>
       </repositories>
       <pluginRepositories>
           <pluginRepository>
               <id>hampelratte</id>
               <name>hampelratte.org</name>
               <url>http://hampelratte.org/nexus/content/groups/public</url>
               <layout>default</layout>
               <snapshots>
                   <enabled>true</enabled>
               </snapshots>
               <releases>
                   <updatePolicy>never</updatePolicy>
               </releases>
           </pluginRepository>
           <pluginRepository>
               <id>hampelratte-snapshots</id>
               <name>hampelratte.org</name>
               <url>http://hampelratte.org/nexus/content/groups/public-snapshots</url>
               <layout>default</layout>
               <snapshots>
                   <enabled>true</enabled>
               </snapshots>
               <releases>
                   <updatePolicy>never</updatePolicy>
               </releases>
           </pluginRepository>
       </pluginRepositories>
   </profile>
 </profiles>
 <activeProfiles>
   <activeProfile>local</activeProfile>
   <activeProfile>default</activeProfile>
 </activeProfiles>
</settings>

Installation von Eclipse

Video: Installation unter Ubuntu 10.10

Um Eclipse Plug-ins leichter installieren zu können, nehmen wir Eclipse Helios, was unter Ubuntu noch nicht zur Verfügung steht. Die manuelle Installation beschränkt sich auf das Auspacken des heruntergeladenen Archivs und Anpassen der PATH-Variablen.

cd /tmp
wget http://mirror.netcologne.de/eclipse//technology/epp/downloads/release/helios/SR1/eclipse-jee-helios-SR1-linux-gtk.tar.gz
cd /opt
tar xzf /tmp/eclipse-jee-helios-SR1-linux-gtk.tar.gz
nano ~/.profile

Zeile

export PATH=$PATH:/opt/eclipse 

am Ende hinzufügen

Eclipse Plug-ins installieren

Video: Eclipse Plug-ins installieren

Es werden die Eclipse Plug-ins M2Eclipse, EGit und Freemarker IDE benötigt. Die Plugins können über den Eclipse Marketplace bzw. "Install New Software" installiert weden.

VCH mit Git auschecken

Video: VCH klonen

Man kann VCH in der Konsole oder wie im Video mit EGit in Eclipse auschecken. Danach kann man die VCH Module als "Existing Maven Projects" in Eclipse importieren.

mkdir ~/workspace
cd ~/workspace
git clone git://git.berlios.de/vch

Bauen und Starten

Video: Bauen und Starten

sudo nano `which mvn`

Oben unter dem einleitenden Kommentar die Zeile

MAVEN_OPTS="-XX:MaxPermSize=128m -Xmx512m"

hinzufügen. Danach folgende Befehle ausführen:

cd ~/workspace/vch/vch
mvn clean install
cd target
tar xzf vch-1.0.0-bin.tar.gz
cd vch-1.0.0
bash vch.sh

Turnaround

Video: Turnaround

Wenn man eine neue Version eines Moduls ausprobieren möchte, muss man es von Hand installieren. Da das auf Dauer sehr mühsam ist, habe ich ein OSGi bundle und ein Maven-Plug-in geschrieben, die es zusammen erlauben, VCH Module direkt aus Eclipse heraus zu installieren / aktualisieren. Das Video zeigt, welche Schritte nötig sind. Der erste Schritt ist leider etwas schwer zu erkennen. Es wird das bundle-hotswap Projekt markiert und mit Rechtsklick ein Run As -> maven install ausgeführt.