Difference between revisions of "HowTo compile on Mac-de"

Revision as of 22:04, 31 May 2008

Wie bekomme und installiere ich aMule-de auf Apple Mac OS X?

1. Du kannst einfach das fertige Programm herunterladen (Binärveröffentlichung) oder
2. Du kompilierst es aus einer CVS-Entwicklerversion.

Binärveröffentlichungen

Wenn du dich nicht mit kompilieren und installieren all dieser Werkzeuge und Quelltexte rumärgern willst, nimm einfach eins der vorkompilierten aMule Programme. Die offizielle Veröffentlichung wird als 'stabil' betrachtet, aber alle jetzigen und späteren Versionen werden aus den Quelltexten kompiliert, um mehr Menschen die Möglichkeit zu geben neue Funktionen zu testen.

1. Aktuelle stabile Veröffentlichung: aMule-2.1.3-Mac
2. Ab und zu kompilierte Entwicklerversion: aMule-Forum

Um das heruntergeladene Programm zu installieren musst du einfach das aMule in einem Ordner deiner Wahl (z.B. /Applications).

Um aMule zu starten, doppelklicke auf das Programmsymbol.

Bemerkung: Du solltest auch den Mac specific usage Artikel lesen.

Aus den Quelltexten kompilieren

Kompilieren erlaubt dir aussagekräftigere Fehlermeldungen zu verfassen, da du die CVS-Entwicklerversion des jeweiligen Tages verwenden kannst.

Zum kompilieren von aMule aus den Quelltexten benötigst du ein paar Entwicklungswerkzeuge, die wxWidgets Bibliothek und den aMule-Quelltext.

Quelltexte und Entwicklungswerkzeuge beziehen

Xcode

Xcode ist Apple's Entwicklungsumgebung. Diese brauchen wir für den GCC compiler. Du brauchst mindestens Version 2.1 von Xcode, eine aktuellere Version ist vorzuziehen. Xcode ist auf der OS X 10.4 DVD enthalten, aber frühe Versionen von 10.4 wurden mit Xcode 2.0 ausgeliefert, also musst du überprüfen ob die Version auf der DVD mindestens 2.1 ist. Möglicherweise hast du Xcode auf CD/DVD, z.B. ist es auf der OS X 10.4 DVD.

Andernfalls kannst du es von Apple herunterladen, du musst aber vorher einen kostenlosen Entwickler-Account registrieren. Dieses gibt es nur auf Englisch

1. XCode herunterladen von http://developer.apple.com/tools/download
2. "Member Site"->"Log In"->"Download Software"->"Developer Tools"->"Download Xcode Tools last release">"Install"

MacPorts (früher bekannt als DarwinPorts)

MacPorts ist ein freier Installer für freie Software die auf Mac OS X portiert wurde. aMule benötigt einige dieser Programme um kompiliert werden zu können. Alternativ kannst du auch Fink benutzen um diese Werkzeuge zu installieren, oder die Installation komplett von Hand vornehmen.

1. Lade die aktuelle Version von MacPorts herunter
2. Lese die MacPorts' Dokumentation um zu erfahren wie man mit MacPorts Programme installieren kann.

Die Werkzeuge die du installieren musst sind:

1. automake
2. flex
3. gettext (Wird nur benötigt wenn du eine andere Sprache als Englisch verwenden willst)
4. libpng
5. libcryptopp

wxMac

wxMac ist die Mac OS X Portierung der wxWidgets Bibliothek. Diese Bibliothek wird benutzt um aMule 'multi-platform' werden zu lassen.

1. Lade die Quelltexte herunter von: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac)
2. Entpacke das Archiv (einfach darauf doppelklicken)

Oder nimm die aktuelle WX-Entwicklerversion. Achtung: wxMac WX-CVS ist häfig in schlechtem Zustand (z.B. musst du die vswprintf Implementation die wx benutzt ändern, siehe hier für mehr Details).

bash: cd ~/Desktop
bash: cvs -d :pserver:anoncvs@cvs.wxwidgets.org:/pack/cvsroots/wxwidgets login
Note: password is 'anoncvs'
bash: cvs -d :pserver:anoncvs@cvs.wxwidgets.org:/pack/cvsroots/wxwidgets checkout wxMac

aMule selbst

1. Lade die aktuellste CVS-Entwicklerversion herunter: aMule CVS
2. Entpacke das Archiv (einfach darauf doppelklicken)

Quelltexte kompilieren

Paltziere das amule-Verzeichnis und das wxMac-Verzeichnis am selben Ort, z.B. auf dem Desktop (wenn du einen anderen Ort wählst, achte darauf, dass der Pfad keine Leerzeichen enthält, da es sonst zu "Datei nicht gefunden"-Fehlern bei wxMac kommen kann).

wxMac Kompilieren

Dieser Schritt wird nur einmal benötigt, und muss für spätere Versionen von aMule CVS nicht wiederholt werden.

Alles nachfolgende geht davon aus, das du die Verzeichnisse auf dem Desktop platziert hast. cd in das wxMac Verzeichnis, ./configure und make:

bash: cd ~/Desktop/wxMac-2.8.4/build
bash: ../configure --disable-shared --enable-unicode --enable-debug --enable-debug_gdb
bash: make

Anmerkung: Der zweite Befehl oben sorgt dafür, dass wxMac mit Debug-Informationen kompiliert wird. Diese Informationen erlauben es dir einen hilfreichen stacktrace zu für die aMule Entwickler zu erstellen, falls aMule CVS abstürzen sollte. Falls du keine Debugversion möchtest, benutze "--disable-debug --disable-debug_gdb".

Anmerkung: Falls du ein Universal Binary von aMule kompilieren willst (d.h. ein aMule Version die auf PowerPC und Intel basierenden Macs läuft), kannst du "--enable-universal_binary" als Parameter an das Ende des zweiten Befehls anhängen. Wenn du diesen Parameter weglässt werden wxMac und aMule nur für deine Architektur kompiliert.

Anmerkung: Der make Befehl kann bis zu 45 Minuten dauern, abhängig von deinem Prozessor und den gewählten Parametern.

aMule kompilieren

Jetzt cd in das amule-Verzeichnis, ./configure und make:

Anmerkung: Die 4 Zeilen für ./configure kannst du in einem Rutsch kopieren.

bash: cd ~/Desktop/amule-cvs
bash: ./configure --disable-systray --disable-gtk --enable-embedded_crypto    \
           --with-wx-config=../wxMac-2.8.4/build/wx-config    \
           --enable-cas --enable-webserver --enable-amulecmd    \
           --enable-debug --disable-optimize

bash: make
bash: ./src/utils/scripts/mac_packager

Anmerkung: Wenn du aMule nicht mit Debuginformationen kompilieren willst (siehe oben) solltest du "--disable-debug --enable-optimize" im configure Schritt verwenden.

Anmerkung: Um aMule als Universal Binary zu kompilieren (siehe oben) musst du folgendes an den configure Befehl anhängen:

           --disable-dependency-tracking \
           CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.4u.sdk" \
           CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.4u.sdk"

aMule starten

Wenn das mac_packager Script fertig ist, kannst du das aMule Programm aus dem amule-cvs Verzeichnis überall hin auf deiner Festplatte verschieben.