De/OpenAnno Installation

From OpenAnno

(Redirected from SVN-Version)
Jump to: navigation, search

Der folgende Artikel beschreibt Download und Installation von Openanno.

Contents

Grundlegendes

  • Als allererstes, es soll sich bitte niemand abgeschreckt fühlen durch die Länge dieses Artikels. Er deckt einfach nur viele Themen ab.
  • Lest euch bitte vorher alles genau durch, was für euch relevant ist.
  • Das Kompilieren von Openanno ist generell nicht notwendig. Es werden lediglich die Bibliotheken benötigt um Python-Dateien auszuführen. Unter Linux sind diese meist vorinstalliert und unter Windows lassen sie sich leicht nachinstallieren. (Wie genau wird weiter unten beschrieben.)
  • Entwickler oder Leute, die es vielleicht werden wollen, können sich die aktuelle SVN-Revisionen von FIFE und OpenAnno runterladen und die Engine selbst kompilieren. (Wie genau wird ebenfalls weiter unten beschrieben.)

Letzte stabile Version herunterladen

Den letzten offiziellen Release von OpenAnno findet man immer hier.

  • Für Windows findet man dort einen Installer, der Python und OpenAL beinhaltet.
  • Für Linux jeweils ein tar.gz-Archiv mit den Binaries für FIFE und dem stabilen Release von OpenAnno für 32bit- und 64bit-Architektur.

Normale Anwender können hier bereits aufhören den Artikel zu lesen.

SVN-Version beziehen und kompilieren

Abhängigkeiten

Unterstützte Build Environments

Unterstützte Compiler

Framework

Zusätzliche SDL Bibliotheken

  • SDL_ttf >= 2.0
  • SDL_image

Sound-Bibliotheken

  • libvorbis
  • libvorbisfile
  • libogg
  • OpenAL

GUI/RAD - Bibliotheken

Scripting-bezogene Bibliotheken

Kompressionsbibliotheken

Optionale Bibliotheken

  • libopengl & libglu >= 1.3: für zusätzliche openGL-Unterstützung.

SVN Clients

Ein SVN-Client ist Vorraussetzung um die SVN-Version herunterladen zu können. Hier folgt eine Liste einiger empfohlener Applikationen. Eine ausführlichere Liste kann man auf Tigris.org finden.

SVN Web Interface

  • Der Code für OpenAnno kann online via Webinterface eingesehen werden.

Windows

Linux

Multi-platform

LINUX

Abhängigkeiten auflösen

Debian/Ubuntu

apt-get install -y build-essential scons libalsa-ocaml-dev libsdl1.2-dev libboost-dev libsdl-ttf2.0-dev⏎
libsdl-image1.2-dev libvorbis-dev libalut-dev python-dev libboost-regex-dev libboost-filesystem-dev⏎
libboost-test-dev swig zlib1g-dev libopenal-dev subversion

Gentoo

emerge --ask --verbose --noreplace libvorbis libogg media-libs/openal guichan boost libsdl sdl-image⏎
sdl-ttf scons subversion

SVN-Version beziehen

FIFE SVN:

OpenAnno SVN:

  • svn://openanno.org/openanno/trunk

Der einfachste Weg führt unter Linux - wie so oft - über die Konsole. Erfahrene Anwender werden selber wissen, was sie tun müssen. Deswegen folgt hier ein Beispiel für die weniger Erfahrenen unter uns:

  • Wir starten einen Terminal, gehen ins Home-Verzeichnis und erstellen eine Verzeichnistruktur für FIFE und OpenAnno:
:~$ mkdir openanno && cd openanno
:~/openanno$ mkdir fife openanno
  • Danach laden wir die SVN-Version von FIFE und OpenAnno in die entsprechenden Ordner herunter:
:~/openanno$ cd fife && svn co http://svn1.cvsdude.com/fife/engine/trunk
:~/openanno/fife$ cd ../openanno && svn co svn://openanno.org/openanno/trunk
  • Um die vorhandenen SVN-Versionen auf den neusten Stand zu bringen muss man lediglich ein SVN-Update in den entsprechenden Verzeichnissen ausführen:
:~/openanno/fife/trunk$ svn up
bzw.
:~/openanno/openanno/trunk$ svn up

FIFE kompilieren

Wurde alle Abhängigkeiten erfolgreich aufgelöst (siehe oben) sollte sich FIFE problemlos kompilieren lassen. Da es mehrfach Probleme mit einigen Bibliotheken gegeben hat, wurde das FIFE SVN-Repository um die Quelldateien einiger Bibliotheken erweitert, die sich bei Bedarf mit dem Befehlt scons ext=1 kompilieren und installieren lassen. (Das betrifft guichan, openAL-soft und libpng.) Im Allgemeinen handelt es sich dabei um die eher empfohlene Vorgehensweise, weswegen dieser Schritt im folgenden Beispiel auch aufgegriffen wird.

  • Zum Kompilieren von FIFE muss man lediglich in das trunk-Verzeichnis wechseln und folgenden Befehl eingeben:
:~/openanno/openanno$ cd ../fife/trunk
:~/openanno/fife/trunk$ scons ext=1 && scons
  • Optional lässt sich FIFE ohne Debug kompilieren, was deutlich mehr Leistung im Spiel bringt:
:~/openanno/fife/trunk$ scons ext=1 && scons debug=0
  • Ist FIFE einmal kompiliert und es wird ein SVN-Update eingespielt muss FIFE neu kompiliert werden.
  • OpenAnno selber muss nicht kompiliert werden, weil es sich dabei lediglich um Skripte und Medieninhalte (Grafik, Sound usw.) handelt.

Rundum-Sorglos-Skript

Dieses Skript läd die aktuelle FIFE SVN-Version herunter, kompiliert die Engine, läd anschliessend die aktuelle OpenAnno-Version herunter und verschiebt diese in einen separaten Unterordner. Für alle, die es eilig haben oder zu faul zum tippen sind.

OpenAnno starten

  • Um OpenAnno zu starten muss lediglich die openanno.py ausgeführt werden. Da gibt es dann verschiedene Möglichkeiten:
:~/openanno/openanno/trunk$ python openanno.py
oder
:~/openanno/openanno/trunk$ ./openanno.py
oder von überall
:/$ python ~/openanno/openanno/trunk/openanno.py
  • Wurde die Startdatei openanno.py ausführbar gemach, kann man sie auch im Dateienmanager mit einem Doppelklick starten.
  • Optional lässt sich OpenAnno auch so ins System einbinden, dass man einfach mit dem Befehl openanno starten kann. Dazu müssen folgende Befehle mit root-Rechten ausgeführt werden:
:~# echo '#!/bin/bash' > /usr/bin/openanno
:~# echo 'python ~/openanno/oa/openanno.py' >> /usr/bin/openanno
:~# chmod +x openanno

Windows

Abhängigkeiten auflösen

SVN-Version beziehen

FIFE SVN:

OpenAnno SVN:

  • svn://openanno.org/openanno/trunk

FIFE kompilieren

OpenAnno starten

Personal tools