Crusta-Installationsanweisungen aus dem Quellcode

Voraussetzungen

Zur Kasse gehen Code:

  • GIT (Mac OS X: brew install git; Ubuntu: sudo apt-get install git)

Zum Bauen:

  • CMAKE Version 2.8 oder besser (Mac OS X: brew install cmake; Ubuntu: sudo apt-get install cmake)
  • Vrui Version 3.1 mit Entwicklungsdateien(KeckCAVES Vrui Seite)
  • GLU mit Entwicklungsdateien (Mac OS X: in XQuartz enthalten; Ubuntu: sudo apt-get install libglu-dev)
  • GDAL Version 1.8 oder besser mit Entwicklungsdateien (Mac OS X:brew install gdal; Ubuntu: sudo apt-get install libgdal-dev)

Für Mac OS X müssen Sie auch den XQuartz X-Server installieren:

Schnelle Erstellung und Installation

Angenommen, Sie haben auch Vrui aus dem Quellcode an einem nicht standardmäßigen Ort installiert:

git clone git://github.com/KeckCAVES/crusta.git
cd crusta
PKG_CONFIG_PATH=/path/to/Vrui/pkgconfig cmake . -DCMAKE_INSTALL_PREFIX=/path/for/crusta
make install

(Das Verzeichnis pkgconfig von Vrui sollte sich irgendwo unterhalb des Verzeichnisses lib befinden).

crusta Befehle landen in /path/for/crusta/bin

Entwickler erstellen und installieren

Befolgen Sie diese Anweisungen, wenn Sie möglicherweise mit dem Quellcode herumspielen wollen.

Prüfen Sie die Quelle

Der Quellcode von Crusta ist als Git-Repository auf Github verfügbar.

Bitte verwenden Sie die folgende Adresse, um eine Kopie des Repositorys zu erhalten:

git clone git://github.com/KeckCAVES/crusta.git

Wenn Sie Schreibrechte auf GitHub haben, können Sie auf diese Weise klonen:

git clone [email protected]:KeckCAVES/crusta.git

Konfigurieren und erstellen

Crusta verwendet cmake als Build-Management-System. Ausführliche Informationen zu cmake finden Sie auf der cmake-Webseite. Die Build-Dateien befinden sich im Unterordner „build“ des Quellordners.

Unter der Annahme, dass der Quellordner ~/src/crusta ist, würde ein typischer Release-Build wie folgt aufgebaut sein:

Schritt 1: Erstellen Sie einen neuen Ordner für das spezifische Build

cd ~/src/crusta
mkdir build
cd build

Schritt 2: Erstellen Sie eine Make-Datei. Bitte beachten Sie die beiden Punkte am Ende, da sie Teil der Befehlszeile sind.

cmake .. -DCMAKE_BUILD_TYPE=<Debug|Release> -DCMAKE_INSTALL_PREFIX=<crusta install path>

Wenn Sie Vrui im Standardpfad installiert haben und eine Release-Version von Crusta in Ihrem Home-Ordner (/home/username unter Linux und /Users/username unter Mac OS; im Beispiel werden diese mit $HOME bezeichnet) installieren möchten, lautet der Beispiel-CMake-Befehl:

PKG_CONFIG_PATH=$HOME/Vrui-3.1/lib/x86_64-linux-gnu/pkgconfig cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=$HOME/crusta

(Das pkgconfig-Verzeichnis von Vrui kann an einem anderen Ort liegen, je nachdem, wie Ihr System konfiguriert ist).

(Der Build-Typ „Release“ ist voreingestellt, Sie müssen ihn also nicht angeben, wenn Sie das wollen).

Schritt 3: Bauen und installieren

make install

Oder für eine schnellere Kompilierung z.B. auf einem Computer mit zwei Kernen:

make -j2 install

Die Crusta-Dateien sollten nun unter $HOME/crusta verfügbar sein

Aktualisieren auf die neueste Version

Sobald Sie den Git-Klon der Quellen haben, ist das Abrufen der neuesten Updates sehr schnell und einfach:

Schritt 1: Verwenden Sie das Terminal, um zum Ordner Crusta zu navigieren. In unserem Beispiel:

cd ~/src/crusta

Schritt 2: Verwenden Sie git, um die neuesten Quelltextaktualisierungen abzurufen:

git pull

Schritt 3: Navigieren Sie zum Release-Build-Ordner und erstellen Sie die ausführbare Datei neu:

cd build
make install

Sie haben jetzt einen Crusta mit Blutspuren.