Quassel IRC

h1. Build Quassel on Linux

Schrittweise Anleitung zum Compilieren des Projekts unter Linux 

{{toc}}

h2. Vorbereitung des Systems

Der Buildprozess benötigt 

 - den Compiler, Linker, cmake, make 

 - KDE4-, QT4-, OpenSSL- und zlib-Development-Libraries 

 - und git für die Verwaltung des Quassel-Quellcodes

Unter DEBIAN GnU/Linux Squeeze/Sid werden die benötigten Pakete beispielsweise folgendermaßen installiert (als root ausführen):

<pre><code># apt-get update && apt-get install build-essential git-core cmake qt4-dev-tools libqt4-dev libqt4-sql-psql zlib1g-dev kdelibs4-dev libphonon-dev kdevelop-dev checkinstall

</code></pre>

(bitte für andere Distributionen hier Befehle einfügen)

h2. Verwaltung des Quellcodes

Diese Aufgabe wird mit "git":http://de.wikipedia.org/wiki/Git unter einem normalen Benutzerkonto durchgeführt. 

Der Quellcode wird einmalig mit 'git clone $URL' in der aktuellen Version heruntergeladen

und im verzeichnis ~/quassel abgelegt. (git könnte auch eigene Beiträge hochladen). 

<pre><code>$ cd ~ && git clone git://git.quassel-irc.org/quassel.git </code></pre>

Nachdem Erscheinen von Aktualisierungen des Projekts (meist täglich) 

wird nur noch mit 'git pull origin' die lokale Kopie auf den neuesten Stand abgeglichen.

<pre><code>$ cd ~/quassel && git pull origin</code></pre>

h2. Compilieren!

Nach Aktualisierungen des Quellcodes kann ein neuer Build erstellt werden.

Jeder Build sollte in seinem eigenen Verzeichnis erzeugt werden,

das ermöglicht bei Misserfolgen die Rückkehr zur funktionsfähigen Version im vorherigen Buildverzeichnis.

<pre><code>$ cd ~/quassel

$ mkdir build

</code></pre>

Im Buildverzeichnis werden mit cmake die eigentlichen make-files erzeugt.

Die dabei verwendeten Optionen werden in der Datei quassel/INSTALL erläutert.

<pre><code>$ cd ~/quassel/build

$ cmake ~/quassel -DWANT_CORE=ON -DWANT_QTCLIENT=ON -DWANT_MONO=ON -DWITH_KDE=ON -DWITH_OPENSSL=ON -DWITH_DBUS=ON -DWITH_PHONON=ON -DWITH_WEBKIT=ON -DLINGUAS="de en_US"

</code></pre>

Der anschließende Aufruf von make führt automatisch die benötigten Aufrufe des Compilers aus.

<pre><code>$ make</code></pre>

h2. Installieren mit checkinstall

Die Installation erfolgt angemeldet als root mit dem Tool checkinstall,

dadurch wird ein Paket (deb, rpm oder tgz) für den Paketmanager (apt, rpm oder installpkg) erzeugt

und quassel bleibt deinstallierbar.

checkinstall hat Optionen für verschiedene Distributionen: -D für Debian, -R für RPM, -S für Slackware.

checkinstall stellt interaktiv einige Fragen, unter anderem zur Paket-Beschreibung:

Beispiel für Debian:

<pre><code>$  checkinstall -D --pkgname quassel-all --pkgversion 0.5.0 --pkgrelease $(date +%y%m%d%H%M%S) make install</code></pre>

Ausgabe:

 Bitte geben Sie eine Beschreibung für das Paket ein.

 Beenden Sie Ihre Beschreibung mit einer leeren Zeile oder EOF.

Eingabe:

 >> [quassel-all enthält quassel-core, quassel-client und quassel (monolithisch).]                                           

 >> [enter]

Ausgabe:

 Das Paket wird entsprechend dieser Vorgaben erstellt:

  0 -  Maintainer: [ dein.name@irgendwo.test ]

  1 -  Summary: [ quassel-all enthält core, client und quassel (monolithisch). ]

  2 -  Name:    [ quassel-all ]

  3 -  Version: [ 0.5.0 ]

  4 -  Release: [ 091021181559 ]

  5 -  License: [ GPL ]

  6 -  Group:   [ checkinstall ]

  7 -  Architecture: [ i386 ]

  8 -  Source location: [ build_091021181559 ]

  9 -  Alternate source location: [  ]

 10 - Requires: [  ]

 11 - Provides: [ quassel-all ]

 Geben Sie die betreffende Nummer ein, um die Vorgaben zu ändern:

Eingabe:

 [ hier einfach [enter] zum Erstellen des Pakets]

Das Ergebnis (hier für Debian):

<pre><code>Done. The new package has been installed and saved to

  /home/$(user)/quassel/build/quassel-all_0.5.0-091021103522_i386.deb

  You can remove it from your system anytime using:

  dpkg -r quassel-all

</code></pre>

h2. Entwurf eines Buildscripts

Dieser sich häufig wiederholende Ablauf ist im folgenden Buildscript zusammengefasst:

<pre><code>#!/usr/bin/bash

# quick quassel buildscript (Entwurf)

#

# einmalige Initialisierung mit diesem Befehl:

# git clone git://git.quassel-irc.org/quassel.git ~/quassel

#

# Aktuellen Stand mit dem Repo abgleichen:

cd ~/quassel

git pull origin

#

#Neues Buildverzeichnis erstelllen

export date=$(date +%y%m%d%H%M%S)

mkdir build_$date

#

# cmake: Optionen siehe ~/quassel/INSTALL

cd build_$date

cmake ~/quassel -DWANT_CORE=ON -DWANT_QTCLIENT=ON -DWANT_MONO=ON -DWITH_KDE=ON -DWITH_OPENSSL=ON -DWITH_DBUS=ON -DWITH_PHONON=ON -DWITH_WEBKIT=OFF -DLINGUAS="de en_US"

make

# statt 'make install' den Paketmanager verwenden, Paket mit checkinstall erzeugen

echo  bitte als root im Verzeichnis ~/quassel/build_$date den folgende Befehle ausführen:

echo  dpkg -r quassel-all

echo  checkinstall -D --pkgname quassel-all --pkgversion 0.5.0 --pkgrelease $date make install

</code></pre>