AMule Project FAQ - User contributions [en]

HowTo compile on Mac-de

2008-04-13T17:44:18Z

85.178.119.109: /* [http://www.macports.org MacPorts] (früher bekannt als DarwinPorts) */

<center>[[HowTo_compile_on_Mac|English]] | '''Deutsch''' | [[HowTo_compile_on_Mac-es|Español]] | [[HowTo_compile_on_Mac-fr|Französisch]]</center>

Wie bekomme und installiere ich [[aMule-de]] auf [http://www.apple.com/macosx/ Apple Mac OS X]?

# Du kannst einfach das fertige Programm herunterladen (Binärveröffentlichung) oder
# Du kompilierst es aus einer [[aMule CVS-de|CVS-Entwicklerversion]].

''Die Vorgängerversion dieser Anleitung, die [[aMule-de|aMule]] 2.0.0rc8 und früher behandelt findest du [[HowTo_compile_on_Mac_v200rc8|hier (englisch)]].''

== 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-de|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.

# Aktuelle stabile Veröffentlichung: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Ab und zu kompilierte Entwicklerversion: [http://forum.amule.org/index.php?topic=5051.0 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 [[aMule CVS-de|CVS-Entwicklerversion]] des jeweiligen Tages verwenden kannst.

Zum kompilieren von [[aMule-de|aMule]] aus den Quelltexten benötigst du ein paar Entwicklungswerkzeuge, die [[wxWidgets-de|wxWidgets]] Bibliothek und den [http://dl.amule.org aMule-Quelltext].

=== Quelltexte und Entwicklungswerkzeuge beziehen ===

==== [http://developer.apple.com/tools/xcode Xcode] ====

[http://developer.apple.com/tools/xcode Xcode] ist [http://www.apple.com Apple]'s Entwicklungsumgebung. Diese brauchen wir für den [http://gcc.gnu.org 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 [http://developer.apple.com/tools/xcode Xcode] auf CD/DVD, z.B. ist es auf der [http://www.apple.com/macosx/ OS X] 10.4 DVD.

Andernfalls kannst du es von [http://www.apple.com/de/ Apple] herunterladen, du musst aber vorher einen kostenlosen Entwickler-Account registrieren. Dieses gibt es nur auf Englisch

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

==== [http://www.macports.org MacPorts] (früher bekannt als DarwinPorts) ====

[http://www.macports.org MacPorts] ist ein freier Installer für freie Software die auf [http://macos.apple.com Mac OS X] portiert wurde. aMule benötigt einige dieser Programme um kompiliert werden zu können. Alternativ kannst du auch [http://fink.sourceforge.net Fink] benutzen um diese Werkzeuge zu installieren, oder die Installation komplett von Hand vornehmen.

# Lade die aktuelle Version von [http://www.macports.org MacPorts] herunter
# Lese die [http://trac.macosforge.org/projects/macports/wiki MacPorts' Dokumentation] um zu erfahren wie man mit [http://www.macports.org MacPorts] Programme installieren kann.

Die Werkzeuge die du installieren musst sind:
# automake
# flex
# gettext (Wird nur benötigt wenn du eine andere Sprache als Englisch verwenden willst)
# libpng
# libcryptopp

==== [[wxWidgets-de|wxMac]] ====

[[wxWidgets-de|wxMac]] ist die [http://macos.apple.com Mac OS X] Portierung der [[wxWidgets-de|wxWidgets]] Bibliothek. Diese Bibliothek wird benutzt um [[aMule-de|aMule]] 'multi-platform' werden zu lassen.

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

Oder nimm die aktuelle [[wx-cvs-de|WX-Entwicklerversion]]. Achtung: [[wxMac-de|wxMac]] [[wx-cvs-de|WX-CVS]] ist häfig in schlechtem Zustand (z.B. musst du die vswprintf Implementation die wx benutzt ändern, siehe [http://forum.amule.org/index.php?topic=9915.msg58058#msg58058 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

==== [http://www.amule.org aMule selbst] ====

# Lade die aktuellste [[aMule CVS-de|CVS-Entwicklerversion]] herunter: [http://www.hirnriss.net/?area=cvs aMule CVS]
# 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-de|wxMac]] kommen kann).

==== [[wxMac-de|wxMac]] Kompilieren====

Dieser Schritt wird nur einmal benötigt, und muss für spätere Versionen von [[aMule CVS-de|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 devs-de|aMule Entwickler]] zu erstellen, falls [[aMule-de|aMule CVS]] abstürzen sollte. Falls du keine Debugversion möchtest, benutze "--disable-debug --disable-debug_gdb".

'''Anmerkung:''' Falls du ein [http://en.wikipedia.org/wiki/Universal_binary 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-de|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-de|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.

HowTo compile on Mac-de

2008-04-13T17:44:06Z

85.178.119.109: /* [http://www.macports.org MacPorts] (früher bekannt als DarwinPorts) */

<center>[[HowTo_compile_on_Mac|English]] | '''Deutsch''' | [[HowTo_compile_on_Mac-es|Español]] | [[HowTo_compile_on_Mac-fr|Französisch]]</center>

Wie bekomme und installiere ich [[aMule-de]] auf [http://www.apple.com/macosx/ Apple Mac OS X]?

# Du kannst einfach das fertige Programm herunterladen (Binärveröffentlichung) oder
# Du kompilierst es aus einer [[aMule CVS-de|CVS-Entwicklerversion]].

''Die Vorgängerversion dieser Anleitung, die [[aMule-de|aMule]] 2.0.0rc8 und früher behandelt findest du [[HowTo_compile_on_Mac_v200rc8|hier (englisch)]].''

== 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-de|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.

# Aktuelle stabile Veröffentlichung: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Ab und zu kompilierte Entwicklerversion: [http://forum.amule.org/index.php?topic=5051.0 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 [[aMule CVS-de|CVS-Entwicklerversion]] des jeweiligen Tages verwenden kannst.

Zum kompilieren von [[aMule-de|aMule]] aus den Quelltexten benötigst du ein paar Entwicklungswerkzeuge, die [[wxWidgets-de|wxWidgets]] Bibliothek und den [http://dl.amule.org aMule-Quelltext].

=== Quelltexte und Entwicklungswerkzeuge beziehen ===

==== [http://developer.apple.com/tools/xcode Xcode] ====

[http://developer.apple.com/tools/xcode Xcode] ist [http://www.apple.com Apple]'s Entwicklungsumgebung. Diese brauchen wir für den [http://gcc.gnu.org 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 [http://developer.apple.com/tools/xcode Xcode] auf CD/DVD, z.B. ist es auf der [http://www.apple.com/macosx/ OS X] 10.4 DVD.

Andernfalls kannst du es von [http://www.apple.com/de/ Apple] herunterladen, du musst aber vorher einen kostenlosen Entwickler-Account registrieren. Dieses gibt es nur auf Englisch

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

==== [http://www.macports.org MacPorts] (früher bekannt als DarwinPorts) ====

[http://www.macports.org MacPorts] ist ein freier Installer für freie Software die auf [http://macos.apple.com Mac OS X] portiert wurde. aMule benötigt einige dieser Programme um kompiliert werden zu können. Alternativ kannst du auch [http://fink.sourceforge.net Fink] benutzen um diese Werkzeuge zu installieren, oder die Installation komplett von Hand vornehmen.

# Lade die aktuelle Version von [http://www.macports.org MacPorts] herunter
# Lese die [http://trac.macosforge.org/projects/macports/wiki MacPorts' Dokumentation] um zu erfahren wie man mit [http://www.macports.org MacPorts] Programme installieren kann.

Die Werkzeuge die du installieren musst sind:
# automake
# flex
# gettext (Wird nur benötigt wenn du eine andere Sprache als Englisch verwenden willst)
# libpng
# libryptopp

==== [[wxWidgets-de|wxMac]] ====

[[wxWidgets-de|wxMac]] ist die [http://macos.apple.com Mac OS X] Portierung der [[wxWidgets-de|wxWidgets]] Bibliothek. Diese Bibliothek wird benutzt um [[aMule-de|aMule]] 'multi-platform' werden zu lassen.

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

Oder nimm die aktuelle [[wx-cvs-de|WX-Entwicklerversion]]. Achtung: [[wxMac-de|wxMac]] [[wx-cvs-de|WX-CVS]] ist häfig in schlechtem Zustand (z.B. musst du die vswprintf Implementation die wx benutzt ändern, siehe [http://forum.amule.org/index.php?topic=9915.msg58058#msg58058 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

==== [http://www.amule.org aMule selbst] ====

# Lade die aktuellste [[aMule CVS-de|CVS-Entwicklerversion]] herunter: [http://www.hirnriss.net/?area=cvs aMule CVS]
# 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-de|wxMac]] kommen kann).

==== [[wxMac-de|wxMac]] Kompilieren====

Dieser Schritt wird nur einmal benötigt, und muss für spätere Versionen von [[aMule CVS-de|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 devs-de|aMule Entwickler]] zu erstellen, falls [[aMule-de|aMule CVS]] abstürzen sollte. Falls du keine Debugversion möchtest, benutze "--disable-debug --disable-debug_gdb".

'''Anmerkung:''' Falls du ein [http://en.wikipedia.org/wiki/Universal_binary 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-de|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-de|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.