VdrAssisant aus Quellen erstellen

Die Repositories verwende ich auch als Sicherungsmedium bei längeren Arbeiten, d.h. es ist nicht sichergestellt, dass der Stand aus dem Repository immer funktionstüchtig ist, geschweige denn, sich übersetzen läßt.

Mein Desktop ist ein Linux-System, d.h. ich verwende auch ganz selbstverständlich bash- und perl-scripte für die Entwicklung. Wer also unter Windows VdrAssistant übersetzen will, sollte für entsprechende Unterstützung der Tuhls sorgen (cygwin o.ä.).

Wer sich trotzdem nicht davon abschrecken läßt ...

• Ein subversion-client, denn das Repository ist ein svn-Repository
• Ein aktuelles, echtes JDK (1.6.x), d.h. gcj funktioniert definitiv nicht und ich werde auch keine Zeit investieren, um daran was zu ändern!
• ant (ab 1.6.5) wird zum Bau benötigt.
• das Framework SRJRCFrames

Das Framework SRJRCFrames bringt eine Menge an Hilfsmittel und Bibliotheken mit, die von VdrAssistant lediglich verwendet werden. Um jetzt das Framework nicht für jedes Projekt neu kopieren zu müssen, habe ich folgende Vorgehensweise als angenehm empfunden:

Ich lege die Projekte auf gleicher Ebene, wie das Framework an und verlinke das "common" Verzeichnis des Frameworks.

Angenommen, das Basisverzeichnis für Quelltext-Projekte wäre /usr/local/src, dann sieht die Installation wie folgt aus:

$ ls -l /usr/local/src
lrwxrwxrwx  1 x x common -> srjrcframes/common
drwxrwxr-x 16 x x srjrcframes
drwxrwxr-x 33 x x vdrassistant
... 

• Das Framework kann vom Quelltext-Archiv ausgepackt werden, oder auch vom subversion-repository verwendet werden. Das Quelltext-Archiv hat den Vorteil, dass es sich übersetzen lässt, wogegen die Quältexte aus dem repository etwas neuer sein können.

  Falls das Archiv verwendet wird, sollte dafür ein Verzeichnis srjrcframes erstellt werden und das Archiv in diesem Verzeichnis ausgepackt werden (xxx bitte gegen die gewünschte Version ersetzen).

  mkdir srjrcframes
  cd srjrcframes
  unzip ../srjrcframes_src-xxx.zip

  Ansonsten ...

• ausfassen der neuesten Quellen mit
  

  svn co https://srjrcframes.svn.sourceforge.net/svnroot/srjrcframes srjrcframes 

• um nicht mit Eclipse oder Netbeans zu kollidieren, heißen die Buildscripte nicht build.xml, sondern srbuild.xml

• In das Verzeichnis srjrcframes wechseln
  

  ant -f srbuild.xml [Befehl]

  Wobei "Befehl"
  • clean
  • build
  • apidoc
  • dist
  sein kann.

  Beim ersten Mal bietet sich "dist" an. Dabei werden dann gleich alle notwendigen Verzeichnisse angelegt und alle möglichen Zieldateien erzeugt.

• egal ob per Quelltext-Archiv oder per repository - das Framework muss zuerst übersetzt und gebaut werden!.

• ausfassen der neuesten Quellen mit

  svn co https://srjrcframes.svn.sourceforge.net/svnroot/vdrassistant vdrassistant

• um nicht mit Eclipse oder Netbeans zu kollidieren, heißen die Buildscripte nicht build.xml, sondern srbuild.xml

• Bevor VdrAssistant gebaut werden kann, gilt es die Bibliotheken des Frameworks einzubinden. Dafür gibt es ein Script "createLinks.sh". Wir wechseln also in das Verzeichnis vdrassistant und führen das Script aus (das Script muss natürlich nur beim ersten Mal ausgeführt werden):

  cd vdrassistant
  ./createLinks.sh

• Zum Bau der Anwendung rufen wir ant wie folgt auf:

  ant -f srbuild.xml [Befehl]

  Wobei Befehl
  • clean
  • build
  • apidoc
  • dist
  sein kann.

  Beim ersten Mal bietet sich "dist" an, denn dabei werden alle notwendigen Verzeichnisse angelegt und es werden auch alle Installateure erzeugt.

Viel Spaß beim Basteln!