Scribus-SVN-Versionen mit CMake komplilieren: Difference between revisions

From Scribus Wiki
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
[[Category:Scribus_development_DE]]
[[Category:Scribus_development_DE]]


[http://www.cmake.org CMake] wurde als Ersatz für das Autotools-System für Scribus ab 1.3.4cvs ausgewählt. Zwar ist noch nicht sicher, ob diese Entscheidung endgültig ist, doch es sieht so aus als sei damit leicht zu arbeiten. Es ist plattformübergreifend verfügbar, wird gut unterstützt, und das KDE-Projekt hat sich dafür entschieden, so daß wir sicher sein können, daß es in absehbarer Zukunft gepflegt wird.
Nachdem lange Zeit die klassischen Autotools verwendet wurden, haben sich die Scribus-Entwickler dazu entschlossen, [http://www.cmake.org CMake] als Ersatz einzusetzen. Es ermöglicht eine flexiblere Konfiguration und ist gleichzeitig weniger komplex. Außerdem ist es kompatibel mit den Compilern unter Linux/UNIX, Windows und OS X.


'''Sie benötigen die CVS-Version von CMake (2.3) oder CMake 2.4, sobald dies veröffentlicht worden ist!'''
'''Sie benötigen ein CMake-Version ab 2.4.3, um optimale Ergebnisse zu erzielen. Ältere Versionen werden nicht funktionieren!'''
 
==Der erste Schritt: Laden Sie die aktuelle SVN-Version herunter==
 
SVN ist das Versionskontrollsystem, das für Scribus verwendet wird. Lesen Sie [[Subversion|diesen]] Artikel, um mehr Informationen zur Bedienung zu erhalten.
 
Alle SVN-Links befinden sich unter der folgenden Adresse:
 
'''svn://scribus.info/Scribus/'''
 
Darüber hinaus gibt es die Adresse http://scribus.info/svn/Scribus/. Der Inhalt hier ist identisch, aber svn://scribus.info/Scribus/ ist normalerweise schneller. Der HTTP-Zugang könnte jedoch nützlich für diejenigen sein, die hinter paranoiden Firewalls oder Proxies sitzen.
 
Wenn Sie bisher mit <code>-r <Version></code> auf CVS zugegriffen haben, so verwenden Sie jetzt <code>SVN-Pfad</code>:
 
{| cellspacing="10" cellpadding="6"
! Version !! !! SVN-Pfad !! Status
|-
|Version135x ||          ||/trunk/Scribus || **instabil/Entwicklerversion**
|-
|Version13x  ||        ||/branches/Version13x/Scribus
|-
|Version133x ||        ||/branches/Version133x/Scribus || **stabile Version**
|-
|Version12x  ||      ||/branches/Version12x/Scribus || **veraltet**
|}
 
Wenn Sie also SVN verwenden möchten, um eine aktuelle Version der stabilen Reihe zu erhalten, geben Sie folgendes ein.
 
<tt><b>svn co svn://scribus.info/Scribus/branches/Version133x/Scribus scribus133x</b></tt>
 
Um Ihre Arbeitskopie zu aktualisieren, müssen Sie später im Quellverzeichnis <code>svn up</code> eingeben.
 
 
Weiterführende Hinweise zum Thema SVN im allgemeinen und zu Scribus-SVN im besonderen:
* Es gibt eine Online-Referenz zu SVN unter: http://svnbook.red-bean.com/nightly/en/index.html.
* Wenn Sie SVN installiert haben, können Sie Hilfe erhalten, indem Sie auf der Kommandozeile <tt>svn help</tt> eingeben.
* Siehe auch das Kapitel zur Installation in der [http://www.docs.scribus.net Online-Dokumentation].
* Craig Ringer hat auf der Mailingliste [http://nashi.altmuehlnet.de/pipermail/scribus/2007-May/024130.html  erklärt], wie man SVN mit Scribus verwendet.
 
Dank Anduin.net (http://anduin.net/) werden die anonymen SVN-Repositorien täglich aktualisiert.
 
'''Weitere Informationen zum Herunterladen von Scribus:'''
*[http://docs.scribus.net/index.php?lang=de&page=download Standard-Download]
*[http://docs.scribus.net/index.php?lang=de&page=install1 CVS-Download]
 
Wenn Sie zum erstenmal kompilieren, sollten Sie sich von der Kommandozeile nicht abschrecken lassen. Kopieren Sie einfach die jeweils relevanten Zeilen nacheinander in das Kommandozeilenfenster.
 
'''Seien Sie vorsichtig:'''
*Anfänger sollten darauf achten, daß nur das letzte Kommando &ndash; <code>make install</code> &ndash; Root-Rechte benötigt. Für die übrigen Schritte reichen einfache Benutzerrechte.
 
Sie ''können'' Scribus auch in ein Verzeichnis installieren, für das Sie Schreibrechte haben. Siehe dazu die Option <tt>-DCMAKE_INSTALL_PREFIX</tt>, die weiter unten erklärt wird.
* Und falls Sie bereits eine Scribus-Version installiert haben, vergessen Sie nicht die Option <code>WANT_VERSIONING=1</code>. Sie können sie mittels <code>-DWANT_VERSIONING=1</code> erzwingen.
 
Viel Glück!


==Kompilieren mit CMake in aller Kürze==
==Kompilieren mit CMake in aller Kürze==

Revision as of 20:58, 26 December 2007


Nachdem lange Zeit die klassischen Autotools verwendet wurden, haben sich die Scribus-Entwickler dazu entschlossen, CMake als Ersatz einzusetzen. Es ermöglicht eine flexiblere Konfiguration und ist gleichzeitig weniger komplex. Außerdem ist es kompatibel mit den Compilern unter Linux/UNIX, Windows und OS X.

Sie benötigen ein CMake-Version ab 2.4.3, um optimale Ergebnisse zu erzielen. Ältere Versionen werden nicht funktionieren!

Der erste Schritt: Laden Sie die aktuelle SVN-Version herunter

SVN ist das Versionskontrollsystem, das für Scribus verwendet wird. Lesen Sie diesen Artikel, um mehr Informationen zur Bedienung zu erhalten.

Alle SVN-Links befinden sich unter der folgenden Adresse:

svn://scribus.info/Scribus/

Darüber hinaus gibt es die Adresse http://scribus.info/svn/Scribus/. Der Inhalt hier ist identisch, aber svn://scribus.info/Scribus/ ist normalerweise schneller. Der HTTP-Zugang könnte jedoch nützlich für diejenigen sein, die hinter paranoiden Firewalls oder Proxies sitzen.

Wenn Sie bisher mit -r <Version> auf CVS zugegriffen haben, so verwenden Sie jetzt SVN-Pfad:

Version SVN-Pfad Status
Version135x /trunk/Scribus **instabil/Entwicklerversion**
Version13x /branches/Version13x/Scribus
Version133x /branches/Version133x/Scribus **stabile Version**
Version12x /branches/Version12x/Scribus **veraltet**

Wenn Sie also SVN verwenden möchten, um eine aktuelle Version der stabilen Reihe zu erhalten, geben Sie folgendes ein.

svn co svn://scribus.info/Scribus/branches/Version133x/Scribus scribus133x

Um Ihre Arbeitskopie zu aktualisieren, müssen Sie später im Quellverzeichnis svn up eingeben.


Weiterführende Hinweise zum Thema SVN im allgemeinen und zu Scribus-SVN im besonderen:

Dank Anduin.net (http://anduin.net/) werden die anonymen SVN-Repositorien täglich aktualisiert.

Weitere Informationen zum Herunterladen von Scribus:

Wenn Sie zum erstenmal kompilieren, sollten Sie sich von der Kommandozeile nicht abschrecken lassen. Kopieren Sie einfach die jeweils relevanten Zeilen nacheinander in das Kommandozeilenfenster.

Seien Sie vorsichtig:

  • Anfänger sollten darauf achten, daß nur das letzte Kommando – make install – Root-Rechte benötigt. Für die übrigen Schritte reichen einfache Benutzerrechte.

Sie können Scribus auch in ein Verzeichnis installieren, für das Sie Schreibrechte haben. Siehe dazu die Option -DCMAKE_INSTALL_PREFIX, die weiter unten erklärt wird.

  • Und falls Sie bereits eine Scribus-Version installiert haben, vergessen Sie nicht die Option WANT_VERSIONING=1. Sie können sie mittels -DWANT_VERSIONING=1 erzwingen.

Viel Glück!

Kompilieren mit CMake in aller Kürze

Bitte beachten Sie, daß ein "Out-of-source-Build" empfohlen wird. Trotzdem ...

Wenn Sie sich im Scribus-Verzeichnis befinden:

/pfad/zu/cmake . -DCMAKE_INSTALL_PREFIX:PATH=/pfad/zum/installationsverzeichnis

z. B. /usr/local/bin/cmake . -DCMAKE_INSTALL_PREFIX:PATH=/opt/scribus134cvs

Einige Optionen, welche die Scribus-CMake-Dateien kennen (es werden noch mehr hinzukommen!):

  • WANT_DEBUG=1: Erstellt eine Debug-Version und verwendet -O0 -g3 statt -O2 (Dies ist momentan die Standardeinstellung und kann nur abgestellt werden, wenn Sie die Datei CMakeFiles.txt bearbeiten)
  • WANT_CAIRO=1: Läßt CMake nach Cairo suchen und kompiliert damit anstatt mit LibArt_LGPL. Bitte beachten Sie, daß wir die Cairo-Version noch als im Beta-Status befindlich betrachten.
  • WANT_LIBART=1 (Standardeinstellung): Läßt CMake nach LibArt_LGPL anstatt Cairo suchen und kompiliert es damit.

Wenn Sie also eine Debug-Version mit Cairo kompilieren wollen, dann sollte Ihre Eingabe in etwa so aussehen:

/usr/local/bin/cmake . -DCMAKE_INSTALL_PREFIX:PATH=/opt/scribus134cvs -DWANT_CAIRO=1 -DWANT_DEBUG=1

Außerhalb des Quellverzeichnisses kompilieren ("Out-of-source-builds")

Einer der Vorteile von CMake ist die Möglichkeit, einen sogenannten "Out-of-source-build" durchzuführen. Was ist das? Er ermöglicht es Ihnen, eine Anwendung zu kompilieren, ohne daß irgend etwas in das Verzeichnis geschrieben wird, in dem sich die Quelltexte befinden. Das bedeutet, daß ihr Quellverzeichnis sauber bleibt, und zwar immer. Auf diese Weise lassen sich ihre Quellen schneller und einfacher aktuell halten, und Sie können mehrere Varianten aus dem gleichen Quelltext erzeugen.

Um Quelltexte auf diese Weise zu kompilieren, benötigen Sie ein neues Zielverzeichnis für die Installation. Angenommen, Ihre Quellen befinden sich in:

/home/username/scribuscmake/Scribus

Erstellen Sie folgendes Verzeichnis:

/home/username/scribuscmake/zielverzeichnis

Anstatt nun etwa

/usr/local/bin/cmake . -DCMAKE_INSTALL_PREFIX:PATH=/opt/scribus134cvs

auszuführen, würden Sie statt dessen in das Zielverzeichnis wechseln und

/usr/local/bin/cmake ../Scribus -DCMAKE_INSTALL_PREFIX:PATH=/opt/scribus134cvs

Einfach!

Die Kompilierung abschließen

Wenn dieser Vorgang erfolgreich abgeschlossen ist, führen Sie einfach make && make install aus.

Das auf CMake basierende Buildsystem ist noch sehr neu für Scribus, und es wird sich noch verändern und Verbesserungen benötigen. Bitte berichten Sie über Probleme auf der Mailingliste oder dem Bugtracker.

Die Liste der noch zu erledigenden Aufgaben für dieses Buildsystem ist noch lang. Sie enthält unter anderem:

  • Die Überprüfung auf plattformübergreifende Funktionalität
  • Die Überprüfung, ob es gleichermaßen unter verschiedenen Unix-Varianten funktioniert
  • Die Überprüfung auf 64-Bit-Distributionen
  • Unterstützung für Win32 und Mac OSX

Das Kompilieren schlägt bei installierten Qt4-Bibliotheken fehl

Systeme, auf denen Qt3 und Qt4 parallel installiert sind:

uic und moc aus Qt4 befinden sich im $PATH, was dazu führt, daß das Kompilieren scheitert. So läßt sich das Problem lösen:

Entfernen Sie vorherige Konfigurationsoptionen aus dem Cache, indem Sie rm CMakeCache.txt ausführen.

Ändern Sie dann die $PATH-Variable, für mein Gentoo etwa: export PATH=/usr/qt/3/bin/:$PATH

Rufen Sie dann cmake erneut auf:

/pfad/zu/cmake . -DCMAKE_INSTALL_PREFIX:PATH=/pfad/zum/installationsverzeichnis


Einen Tarball zum Verteilen erstellen

Um einen Tarball zu erstellen, haben Sie bisher folgendes eingegeben: make dist. Nun rufen Sie make package_source oder /path/to/cpack -G TBZ2 --config CPackSourceConfig.cmake auf, um ein Quellcode-Archiv zu erzeugen. CMake 2.4.1 unterstützt nur gzip (tar.gz), aber bzip2 (tar.bz2) ist mit der CVS-Version von CMake möglich.