AMule Project FAQ - User contributions [en]

HowTo compile on Mac

2010-12-13T23:11:41Z

Mirko.grewing:

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]] |
[[HowTo_compile_on_Mac-it|Italiano]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

Check the Mac forum for the most recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule SVN|SVN snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, <del>you can also use [http://www.finkproject.org/ Fink] to install these tools or</del> (Fink currently lacks many of the needed tools) you can install them manually .

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

You can upgrade all the packages installed with

$ sudo port upgrade installed

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

You can list all available variants with:

$ sudo port variants ''package_name''

===== Notes about Universal variant =====

As stated [http://guide.macports.org/chunked/internals.configuration-files.html here], MacPorts has different build_arch settings for ''universal'' variant. You can use this variant on Leopard to switch both ppc and i386 version on. Since Snow Leopard doesn't support ppc architecture anymore, the universal variant can be used to switch both i386 and x86_64 version on. Please note that default architecture on Snow Leopard is x86_64 if the CPU supports it, i386 otherwise.

'''WARNING''': ''binutils'' [https://svn.macports.org/ticket/21588 fails] building universal. So you should set ''build_arch'' to ''i386'' (about line 59) into ''/opt/local/etc/macports/macports.conf'' to be sure to build every port against i386 architecture (x86_64 is useless since 64-bit Carbon libraries does not exists and wxCocoa is not ready yet).

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# binutils
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

This should be enough:

$ sudo port install automake binutils flex libpng libcryptopp gd2 libgeoip libupnp

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop. 
Last stable version is 2.8.11 at now.
Type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd ~/Desktop/wxMac-2.8.11/

Press enter.
The basic command to configure and compile the package is the following:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

===== Snow Leopard =====

Building on Snow Leopard is tricky. You must focus on architecture, compiler version, compatibility. This should be enough to have compatibility with i386 Leopard and above:

CC="gcc-4.2 -arch i386" CXX="g++-4.2 -arch i386" \
./configure CFLAGS="-arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk -mmacosx-version-min=10.5" \
CXXFLAGS="-arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk -mmacosx-version-min=10.5" \
CPPFLAGS="-arch i386" LDFLAGS="-arch i386" OBJCFLAGS="-arch i386" OBJCXXFLAGS="-arch i386" \
--disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local

followed by:

make -j8

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd ~/Desktop/aMule-2.2.

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --with-wx-config=../wxMac-2.8.10/wx-config --enable-optimize --with-crypto-prefix=/opt/local \
--with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local --enable-cas --enable-webserver \
--enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon --enable-geoip \
--with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug

Take a look to the [[configure]] page for a complete list of options.
You should pay attention to these elements:

# The given example enables debug informations. To disable them exchange the option ''--enable-debug'' with ''--disable-debug --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

HowTo compile on Mac

2009-08-23T07:54:32Z

Mirko.grewing: /* Step 4: Compile wxMac */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

Check the Mac forum for the most recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule SVN|SVN snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, <del>you can also use [http://www.finkproject.org/ Fink] to install these tools or</del> (Fink currently lacks many of the needed tools) you can install them manually .

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

You can upgrade all the packages installed with

$ sudo port upgrade installed

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# binutils
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

This should be enough:

$ sudo port install automake binutils flex libpng libcryptopp gd2 libgeoip libupnp

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop. 
The installation of the TextCtrl patch is highly recommended: download [http://trac.wxwidgets.org/raw-attachment/ticket/9012/textctrl_optimization.diff this patch file] to your desktop, now open a Terminal and type

$ patch ~/Desktop/wxMac-2.8.10/src/mac/carbon/textctrl.cpp ~/Desktop/textctrl_optimization.diff

'''Note:''' This patch greatly increases performance of wxTextCtrl and prevents aMule from hanging under rapid logging. 
type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd ~/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd ~/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --with-wx-config=../wxMac-2.8.10/wx-config --enable-optimize --with-crypto-prefix=/opt/local \
--with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local --enable-cas --enable-webserver \
--enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon --enable-geoip \
--with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug

Take a look to the [[configure]] page for a complete list of options.
You should pay attention to these elements:

# The given example enables debug informations. To disable them exchange the option ''--enable-debug'' with ''--disable-debug --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

Warning, this section should be hardly revised since it doesn't work at all!

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard (change "MacOSX10.5.sdk" to "MacOSX10.4.sdk" if you are using Tiger):
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-08-23T07:25:20Z

Mirko.grewing: /* Step 2: Install MacPorts */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

Check the Mac forum for the most recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule SVN|SVN snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, <del>you can also use [http://www.finkproject.org/ Fink] to install these tools or</del> (Fink currently lacks many of the needed tools) you can install them manually .

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

You can upgrade all the packages installed with

$ sudo port upgrade installed

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# binutils
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

This should be enough:

$ sudo port install automake binutils flex libpng libcryptopp gd2 libgeoip libupnp

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop. 
Download [http://trac.wxwidgets.org/raw-attachment/ticket/9012/textctrl_optimization.diff this patch file] to your desktop. 
Now open a Terminal and type

$ patch ~/Desktop/wxMac-2.8.10/src/mac/carbon/textctrl.cpp ~/Desktop/textctrl_optimization.diff

'''Note:''' This patch greatly increases performance of wxTextCtrl and prevents aMule from hanging under rapid logging. 
type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd ~/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd ~/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --with-wx-config=../wxMac-2.8.10/wx-config --enable-optimize --with-crypto-prefix=/opt/local \
--with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local --enable-cas --enable-webserver \
--enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon --enable-geoip \
--with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug

Take a look to the [[configure]] page for a complete list of options.
You should pay attention to these elements:

# The given example enables debug informations. To disable them exchange the option ''--enable-debug'' with ''--disable-debug --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

Warning, this section should be hardly revised since it doesn't work at all!

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard (change "MacOSX10.5.sdk" to "MacOSX10.4.sdk" if you are using Tiger):
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-08-23T06:42:34Z

Mirko.grewing: /* Binary releases */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

Check the Mac forum for the most recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule SVN|SVN snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, <del>you can also use [http://www.finkproject.org/ Fink] to install these tools or</del> (it seems that fink lacks many of the needed tools) you can install them manually .

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# binutils
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

This should be enough:

$ sudo port install automake binutils flex libpng libcryptopp gd2 libgeoip libupnp

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop. 
Download [http://trac.wxwidgets.org/raw-attachment/ticket/9012/textctrl_optimization.diff this patch file] to your desktop. 
Now open a Terminal and type

$ patch ~/Desktop/wxMac-2.8.10/src/mac/carbon/textctrl.cpp ~/Desktop/textctrl_optimization.diff

'''Note:''' This patch greatly increases performance of wxTextCtrl and prevents aMule from hanging under rapid logging. 
type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd ~/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd ~/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --with-wx-config=../wxMac-2.8.10/wx-config --enable-optimize --with-crypto-prefix=/opt/local \
--with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local --enable-cas --enable-webserver \
--enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon --enable-geoip \
--with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug

Take a look to the [[configure]] page for a complete list of options.
You should pay attention to these elements:

# The given example enables debug informations. To disable them exchange the option ''--enable-debug'' with ''--disable-debug --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

Warning, this section should be hardly revised since it doesn't work at all!

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard (change "MacOSX10.5.sdk" to "MacOSX10.4.sdk" if you are using Tiger):
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-08-22T22:31:40Z

Mirko.grewing: /* Binary releases */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Check the Mac forum for the most recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule SVN|SVN snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, <del>you can also use [http://www.finkproject.org/ Fink] to install these tools or</del> (it seems that fink lacks many of the needed tools) you can install them manually .

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# binutils
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

This should be enough:

$ sudo port install automake binutils flex libpng libcryptopp gd2 libgeoip libupnp

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop. 
Download [http://trac.wxwidgets.org/raw-attachment/ticket/9012/textctrl_optimization.diff this patch file] to your desktop. 
Now open a Terminal and type

$ patch ~/Desktop/wxMac-2.8.10/src/mac/carbon/textctrl.cpp ~/Desktop/textctrl_optimization.diff

'''Note:''' This patch greatly increases performance of wxTextCtrl and prevents aMule from hanging under rapid logging. 
type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd ~/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd ~/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --with-wx-config=../wxMac-2.8.10/wx-config --enable-optimize --with-crypto-prefix=/opt/local \
--with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local --enable-cas --enable-webserver \
--enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon --enable-geoip \
--with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug

Take a look to the [[configure]] page for a complete list of options.
You should pay attention to these elements:

# The given example enables debug informations. To disable them exchange the option ''--enable-debug'' with ''--disable-debug --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

Warning, this section should be hardly revised since it doesn't work at all!

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard (change "MacOSX10.5.sdk" to "MacOSX10.4.sdk" if you are using Tiger):
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

Talk:HowTo compile on Mac

2009-05-05T06:45:46Z

Mirko.grewing:

wxWidgets from MacPorts is unusable since it misses some needed files... ;-) --[[User:Mirko.grewing|Mirko Grewing]]

----

Ah, good call, Mirko.grewing. Much more generic and versatile ;) --[[User:PacoBell|PacoBell]] 13:29, 28 April 2009 (CEST)

----

Is there any reason we're not using wxWidgets from MacPorts instead of wxMac? Which is more stable/feature complete? --[[User:PacoBell|PacoBell]] 00:05, 20 April 2009 (CEST)

----

I need to install newer versions of flex and automake to compile amule successfully on my machine. Maybe we should just add those as dependencies that should be installed through Fink. -- lionel77

i have this:
port installed
The following ports are currently installed:
autoconf @2.61_1 (active)
automake @1.10.1_0 (active)
expat @2.0.1_0 (active)
flex @2.5.34_0 (active)
gettext @0.17_3 (active)
help2man @1.36.4_1 (active)
libiconv @1.12_0 (active)
libpng @1.2.24_0 (active)
libtool @1.5.24_1 (active)
m4 @1.4.10_1 (active)
ncurses @5.6_0 (active)
ncursesw @5.6_1 (active)
p5-locale-gettext @1.05_0 (active)
perl5.8 @5.8.8_1 (active)
zlib @1.2.3_1 (active)

when i tried to "./configure" amule, i got this
<pre>
emac-bureau:amule-cvs maitedx$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto \
> --with-wx-config=../wxMac-2.8.7/build/wx-config \
> --enable-cas --enable-webserver --enable-amulecmd \
> --enable-debug --disable-optimize --with-cryptopp=/usr/local/cryptopp
checking build system type... powerpc-apple-darwin9.2.0
checking host system type... powerpc-apple-darwin9.2.0
checking for a BSD-compatible install... /usr/bin/install -c
checking whether build environment is sane... yes
checking for gawk... no
checking for mawk... no
checking for nawk... no
checking for awk... awk
checking whether make sets $(MAKE)... yes
checking whether to enable maintainer-specific portions of Makefiles... no
checking for g++... g++
checking for C++ compiler default output file name... a.out
checking whether the C++ compiler works... yes
checking whether we are cross compiling... no
checking for suffix of executables...
checking for suffix of object files... o
checking whether we are using the GNU C++ compiler... yes
checking whether g++ accepts -g... yes
checking for style of include used by make... GNU
checking dependency style of g++... gcc3
checking how to run the C++ preprocessor... g++ -E
checking for gcc... gcc
checking whether we are using the GNU C compiler... yes
checking whether gcc accepts -g... yes
checking for gcc option to accept ANSI C... none needed
checking dependency style of gcc... gcc3
checking how to run the C preprocessor... gcc -E
checking for gawk... (cached) awk
checking for egrep... grep -E
checking whether make sets $(MAKE)... (cached) yes
checking for flex... flex
checking for yywrap in -lfl... yes
checking lex output file root... lex.yy
checking whether yytext is a pointer... yes
checking for a BSD-compatible install... /usr/bin/install -c
checking for ranlib... ranlib
checking for bison... bison -y
checking for ranlib... (cached) ranlib
checking for strip... strip
checking for ar... ar
checking for ld... ld
checking for zlib >= 1.1.4... yes (version 1.2.3)
checking for ANSI C header files... yes
checking for sys/types.h... yes
checking for sys/stat.h... yes
checking for stdlib.h... yes
checking for string.h... yes
checking for memory.h... yes
checking for strings.h... yes
checking for inttypes.h... yes
checking for stdint.h... yes
checking for unistd.h... yes
checking for gdlib-config... no
configure:
WARNING: gd-lib >= 2.0.0, or a functional gd.h (from gd-devel) not found.
Please check that gdlib-config is in your default path, check out
LD_LIBRARY_PATH or equivalent variable.
Or this might also be that your gdlib-config has other name.
Please try again with --with-gdlib-config=/usr/bin/gdlib-config
(replace /usr/bin/gdlib-config with a valid path to your gdlib-config).
If you use compiled packages check if you have devel pack installed.
To download the latest version check http://www.boutell.com/gd
for sources.

checking for libpng-config... /opt/local/bin/libpng-config
checking for libpng version >= 1.2.0... yes (version 1.2.24)
checking for File::Copy... ok
checking whether we need the GUI... no
checking for exception-handling... yes
checking for the --with-toolkit option... will be automatically detected
checking for the --with-wxshared option... will be automatically detected
checking for the --with-wxdebug option... will be automatically detected
checking for the --with-wxversion option... will be automatically detected
checking for wx-config... ../wxMac-2.8.7/build/wx-config
checking for wxWidgets version >= 2.8.0 (--unicode=yes)... yes (version 2.8.7)
checking for wxWidgets static library... yes
checking if wxWidgets was built in DEBUG mode... yes
checking if wxWidgets was built in STATIC mode... yes
checking which wxWidgets toolkit was selected... mac
checking that wxWidgets has support for large files... yes
checking for crypto++ version >= 5.1... configure: error:
Specifying the cryptopp source files directory for "--with-crypto-prefix="
will not work because cryptopp uses headers with the same name of system
headers (e.g. zlib.h) and you must be able to distinguish the system
headers from cryptopp headers in an #include directive.
Please run "PREFIX=/home/YourUserName/usr/cryptopp make install" on
the cryptopp directory to properly install cryptopp in your system.
emac-bureau:amule-cvs maitedx$ make
make: *** No targets specified and no makefile found. Stop.
emac-bureau:amule-cvs maitedx$
</pre>
what do i have to do ?

Talk:HowTo compile on Mac

2009-05-05T06:44:21Z

Mirko.grewing:

Ah, good call, Mirko.grewing. Much more generic and versatile ;) --[[User:PacoBell|PacoBell]] 13:29, 28 April 2009 (CEST)

----

Is there any reason we're not using wxWidgets from MacPorts instead of wxMac? Which is more stable/feature complete? --[[User:PacoBell|PacoBell]] 00:05, 20 April 2009 (CEST)

----

I need to install newer versions of flex and automake to compile amule successfully on my machine. Maybe we should just add those as dependencies that should be installed through Fink. -- lionel77

i have this:
port installed
The following ports are currently installed:
autoconf @2.61_1 (active)
automake @1.10.1_0 (active)
expat @2.0.1_0 (active)
flex @2.5.34_0 (active)
gettext @0.17_3 (active)
help2man @1.36.4_1 (active)
libiconv @1.12_0 (active)
libpng @1.2.24_0 (active)
libtool @1.5.24_1 (active)
m4 @1.4.10_1 (active)
ncurses @5.6_0 (active)
ncursesw @5.6_1 (active)
p5-locale-gettext @1.05_0 (active)
perl5.8 @5.8.8_1 (active)
zlib @1.2.3_1 (active)

when i tried to "./configure" amule, i got this
<pre>
emac-bureau:amule-cvs maitedx$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto \
> --with-wx-config=../wxMac-2.8.7/build/wx-config \
> --enable-cas --enable-webserver --enable-amulecmd \
> --enable-debug --disable-optimize --with-cryptopp=/usr/local/cryptopp
checking build system type... powerpc-apple-darwin9.2.0
checking host system type... powerpc-apple-darwin9.2.0
checking for a BSD-compatible install... /usr/bin/install -c
checking whether build environment is sane... yes
checking for gawk... no
checking for mawk... no
checking for nawk... no
checking for awk... awk
checking whether make sets $(MAKE)... yes
checking whether to enable maintainer-specific portions of Makefiles... no
checking for g++... g++
checking for C++ compiler default output file name... a.out
checking whether the C++ compiler works... yes
checking whether we are cross compiling... no
checking for suffix of executables...
checking for suffix of object files... o
checking whether we are using the GNU C++ compiler... yes
checking whether g++ accepts -g... yes
checking for style of include used by make... GNU
checking dependency style of g++... gcc3
checking how to run the C++ preprocessor... g++ -E
checking for gcc... gcc
checking whether we are using the GNU C compiler... yes
checking whether gcc accepts -g... yes
checking for gcc option to accept ANSI C... none needed
checking dependency style of gcc... gcc3
checking how to run the C preprocessor... gcc -E
checking for gawk... (cached) awk
checking for egrep... grep -E
checking whether make sets $(MAKE)... (cached) yes
checking for flex... flex
checking for yywrap in -lfl... yes
checking lex output file root... lex.yy
checking whether yytext is a pointer... yes
checking for a BSD-compatible install... /usr/bin/install -c
checking for ranlib... ranlib
checking for bison... bison -y
checking for ranlib... (cached) ranlib
checking for strip... strip
checking for ar... ar
checking for ld... ld
checking for zlib >= 1.1.4... yes (version 1.2.3)
checking for ANSI C header files... yes
checking for sys/types.h... yes
checking for sys/stat.h... yes
checking for stdlib.h... yes
checking for string.h... yes
checking for memory.h... yes
checking for strings.h... yes
checking for inttypes.h... yes
checking for stdint.h... yes
checking for unistd.h... yes
checking for gdlib-config... no
configure:
WARNING: gd-lib >= 2.0.0, or a functional gd.h (from gd-devel) not found.
Please check that gdlib-config is in your default path, check out
LD_LIBRARY_PATH or equivalent variable.
Or this might also be that your gdlib-config has other name.
Please try again with --with-gdlib-config=/usr/bin/gdlib-config
(replace /usr/bin/gdlib-config with a valid path to your gdlib-config).
If you use compiled packages check if you have devel pack installed.
To download the latest version check http://www.boutell.com/gd
for sources.

checking for libpng-config... /opt/local/bin/libpng-config
checking for libpng version >= 1.2.0... yes (version 1.2.24)
checking for File::Copy... ok
checking whether we need the GUI... no
checking for exception-handling... yes
checking for the --with-toolkit option... will be automatically detected
checking for the --with-wxshared option... will be automatically detected
checking for the --with-wxdebug option... will be automatically detected
checking for the --with-wxversion option... will be automatically detected
checking for wx-config... ../wxMac-2.8.7/build/wx-config
checking for wxWidgets version >= 2.8.0 (--unicode=yes)... yes (version 2.8.7)
checking for wxWidgets static library... yes
checking if wxWidgets was built in DEBUG mode... yes
checking if wxWidgets was built in STATIC mode... yes
checking which wxWidgets toolkit was selected... mac
checking that wxWidgets has support for large files... yes
checking for crypto++ version >= 5.1... configure: error:
Specifying the cryptopp source files directory for "--with-crypto-prefix="
will not work because cryptopp uses headers with the same name of system
headers (e.g. zlib.h) and you must be able to distinguish the system
headers from cryptopp headers in an #include directive.
Please run "PREFIX=/home/YourUserName/usr/cryptopp make install" on
the cryptopp directory to properly install cryptopp in your system.
emac-bureau:amule-cvs maitedx$ make
make: *** No targets specified and no makefile found. Stop.
emac-bureau:amule-cvs maitedx$
</pre>
what do i have to do ?

wxWidgets from MacPorts is unusable since it misses some needed files... ;-)

HowTo compile on Mac

2009-04-28T07:54:36Z

Mirko.grewing: /* Step 5: Compile aMule */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.2.3-Mac]
# Check the Mac forum for a more recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, <del>you can also use [http://www.finkproject.org/ Fink] to install these tools or</del> (it seems that fink lacks many of the needed tools) you can install them manually .

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# binutils
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

This should be enough:

$ sudo port install automake binutils flex libpng libcryptopp gd2 libgeoip libupnp

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop. 
Download [http://trac.wxwidgets.org/raw-attachment/ticket/9012/textctrl_optimization.diff this patch file] to your desktop. 
Now open a Terminal and type

$ patch ~/Desktop/wxMac-2.8.10/src/mac/carbon/textctrl.cpp ~/Desktop/textctrl_optimization.diff

'''Note:''' This patch greatly increases performance of wxTextCtrl and prevents aMule from hanging under rapid logging. 
type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd ~/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd ~/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto --with-wx-config=../wxMac-2.8.10/wx-config \
--enable-optimize --with-crypto-prefix=/opt/local --with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local \
--enable-cas --enable-webserver --enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon \
--enable-geoip --with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug --enable-debug_gdb

Take a look to the [[configure]] page for a complete list of options.
You should pay attention to these elements:

# The given example enables debug informations. To disable them change the options ''--enable-debug --enable-debug_gdb'' with ''--disable-debug --disable-debug_gdb --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

Warning, this section should be hardly revised since it doesn't work at all!

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard (change "MacOSX10.5.sdk" to "MacOSX10.4.sdk" if you are using Tiger):
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-04-28T07:54:19Z

Mirko.grewing: /* Step 4: Compile wxMac */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.2.3-Mac]
# Check the Mac forum for a more recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, <del>you can also use [http://www.finkproject.org/ Fink] to install these tools or</del> (it seems that fink lacks many of the needed tools) you can install them manually .

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# binutils
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

This should be enough:

$ sudo port install automake binutils flex libpng libcryptopp gd2 libgeoip libupnp

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop. 
Download [http://trac.wxwidgets.org/raw-attachment/ticket/9012/textctrl_optimization.diff this patch file] to your desktop. 
Now open a Terminal and type

$ patch ~/Desktop/wxMac-2.8.10/src/mac/carbon/textctrl.cpp ~/Desktop/textctrl_optimization.diff

'''Note:''' This patch greatly increases performance of wxTextCtrl and prevents aMule from hanging under rapid logging. 
type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd ~/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd /Users/mirko/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto --with-wx-config=../wxMac-2.8.10/wx-config \
--enable-optimize --with-crypto-prefix=/opt/local --with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local \
--enable-cas --enable-webserver --enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon \
--enable-geoip --with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug --enable-debug_gdb

Take a look to the [[configure]] page for a complete list of options.
You should pay attention to these elements:

# The given example enables debug informations. To disable them change the options ''--enable-debug --enable-debug_gdb'' with ''--disable-debug --disable-debug_gdb --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

Warning, this section should be hardly revised since it doesn't work at all!

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard (change "MacOSX10.5.sdk" to "MacOSX10.4.sdk" if you are using Tiger):
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-04-21T08:05:20Z

Mirko.grewing: /* APPENDIX: Universal Binary */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.2.3-Mac]
# Check the Mac forum for a more recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, <del>you can also use [http://www.finkproject.org/ Fink] to install these tools or</del> (it seems that fink lacks many of the needed tools) you can install them manually .

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# binutils
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

This should be enough:

$ sudo port install automake binutils flex libpng libcryptopp gd2 libgeoip libupnp

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop.
Now open a Terminal and type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd /Users/mirko/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd /Users/mirko/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto --with-wx-config=../wxMac-2.8.10/wx-config \
--enable-optimize --with-crypto-prefix=/opt/local --with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local \
--enable-cas --enable-webserver --enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon \
--enable-geoip --with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug --enable-debug_gdb

Take a look to the [[configure]] page for a complete list of options.
You should pay attention to these elements:

# The given example enables debug informations. To disable them change the options ''--enable-debug --enable-debug_gdb'' with ''--disable-debug --disable-debug_gdb --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

Warning, this section should be hardly revised since it doesn't work at all!

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard (change "MacOSX10.5.sdk" to "MacOSX10.4.sdk" if you are using Tiger):
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-04-14T18:48:57Z

Mirko.grewing: /* Step 3: Install libraries and tools */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Check the Mac forum for a more recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, <del>you can also use [http://www.finkproject.org/ Fink] to install these tools or</del> (it seems that fink lacks many of the needed tools) you can install them manually .

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# binutils
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

This should be enough:

$ sudo port install automake binutils flex libpng libcryptopp gd2 libgeoip libupnp

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop.
Now open a Terminal and type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd /Users/mirko/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd /Users/mirko/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto --with-wx-config=../wxMac-2.8.10/wx-config \
--enable-optimize --with-crypto-prefix=/opt/local --with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local \
--enable-cas --enable-webserver --enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon \
--enable-geoip --with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug --enable-debug_gdb

Take a look to the [[configure]] page for a complete list of options.
You should pay attention to these elements:

# The given example enables debug informations. To disable them change the options ''--enable-debug --enable-debug_gdb'' with ''--disable-debug --disable-debug_gdb --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard (change "MacOSX10.5.sdk" to "MacOSX10.4.sdk" if you are using Tiger):
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-04-14T18:48:42Z

Mirko.grewing: /* Step 3: Install libraries and tools */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Check the Mac forum for a more recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, <del>you can also use [http://www.finkproject.org/ Fink] to install these tools or</del> (it seems that fink lacks many of the needed tools) you can install them manually .

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# binutils
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

This should be enough:

$ sudo port install automake binutils flex libpng libcryptopp gd2 libgeoip libupnp pkgconfig

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop.
Now open a Terminal and type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd /Users/mirko/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd /Users/mirko/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto --with-wx-config=../wxMac-2.8.10/wx-config \
--enable-optimize --with-crypto-prefix=/opt/local --with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local \
--enable-cas --enable-webserver --enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon \
--enable-geoip --with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug --enable-debug_gdb

Take a look to the [[configure]] page for a complete list of options.
You should pay attention to these elements:

# The given example enables debug informations. To disable them change the options ''--enable-debug --enable-debug_gdb'' with ''--disable-debug --disable-debug_gdb --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard (change "MacOSX10.5.sdk" to "MacOSX10.4.sdk" if you are using Tiger):
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-04-14T18:36:50Z

Mirko.grewing: /* Step 3: Install libraries and tools */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Check the Mac forum for a more recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, <del>you can also use [http://www.finkproject.org/ Fink] to install these tools or</del> (it seems that fink lacks many of the needed tools) you can install them manually .

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# binutils
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

This should be enough:

$ sudo port install automake binutils flex libpng libcryptopp gd2 jpeg libgeoip libupnp pkgconfig

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop.
Now open a Terminal and type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd /Users/mirko/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd /Users/mirko/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto --with-wx-config=../wxMac-2.8.10/wx-config \
--enable-optimize --with-crypto-prefix=/opt/local --with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local \
--enable-cas --enable-webserver --enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon \
--enable-geoip --with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug --enable-debug_gdb

Take a look to the [[configure]] page for a complete list of options.
You should pay attention to these elements:

# The given example enables debug informations. To disable them change the options ''--enable-debug --enable-debug_gdb'' with ''--disable-debug --disable-debug_gdb --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard (change "MacOSX10.5.sdk" to "MacOSX10.4.sdk" if you are using Tiger):
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-04-14T18:32:48Z

Mirko.grewing: /* Step 3: Install libraries and tools */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Check the Mac forum for a more recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, <del>you can also use [http://www.finkproject.org/ Fink] to install these tools or</del> (it seems that fink lacks many of the needed tools) you can install them manually .

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# binutils
# flex
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

You can copy and paste this line:

$ sudo port install automake binutils flex libpng libcryptopp libiconv gd2 jpeg libgeoip libupnp pkgconfig

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop.
Now open a Terminal and type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd /Users/mirko/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd /Users/mirko/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto --with-wx-config=../wxMac-2.8.10/wx-config \
--enable-optimize --with-crypto-prefix=/opt/local --with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local \
--enable-cas --enable-webserver --enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon \
--enable-geoip --with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug --enable-debug_gdb

Take a look to the [[configure]] page for a complete list of options.
You should pay attention to these elements:

# The given example enables debug informations. To disable them change the options ''--enable-debug --enable-debug_gdb'' with ''--disable-debug --disable-debug_gdb --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard (change "MacOSX10.5.sdk" to "MacOSX10.4.sdk" if you are using Tiger):
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-04-14T17:52:17Z

Mirko.grewing: /* Step 3: Install libraries and tools */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Check the Mac forum for a more recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, <del>you can also use [http://www.finkproject.org/ Fink] to install these tools or</del> (it seems that fink lacks many of the needed tools) you can install them manually .

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# binutils
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

You can copy and paste this line:

$ sudo port install automake binutils flex gettext libpng libcryptopp libiconv gd2 jpeg libgeoip libupnp pkgconfig

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop.
Now open a Terminal and type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd /Users/mirko/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd /Users/mirko/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto --with-wx-config=../wxMac-2.8.10/wx-config \
--enable-optimize --with-crypto-prefix=/opt/local --with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local \
--enable-cas --enable-webserver --enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon \
--enable-geoip --with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug --enable-debug_gdb

Take a look to the [[configure]] page for a complete list of options.
You should pay attention to these elements:

# The given example enables debug informations. To disable them change the options ''--enable-debug --enable-debug_gdb'' with ''--disable-debug --disable-debug_gdb --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard (change "MacOSX10.5.sdk" to "MacOSX10.4.sdk" if you are using Tiger):
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-04-14T12:41:49Z

Mirko.grewing: /* Step 3: Install libraries and tools */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Check the Mac forum for a more recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, <del>you can also use [http://www.finkproject.org/ Fink] to install these tools or</del> (it seems that fink lacks many of the needed tools) you can install them manually .

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

You can copy and paste this line:

$ sudo port install automake flex gettext libpng libcryptopp libiconv gd2 jpeg libgeoip libupnp pkgconfig

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop.
Now open a Terminal and type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd /Users/mirko/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd /Users/mirko/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto --with-wx-config=../wxMac-2.8.10/wx-config \
--enable-optimize --with-crypto-prefix=/opt/local --with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local \
--enable-cas --enable-webserver --enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon \
--enable-geoip --with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug --enable-debug_gdb

Take a look to the [[configure]] page for a complete list of options.
You should pay attention to these elements:

# The given example enables debug informations. To disable them change the options ''--enable-debug --enable-debug_gdb'' with ''--disable-debug --disable-debug_gdb --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard (change "MacOSX10.5.sdk" to "MacOSX10.4.sdk" if you are using Tiger):
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-04-14T05:58:14Z

Mirko.grewing: /* Step 2: Install [http://www.macports.org MacPorts] */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Check the Mac forum for a more recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, <del>you can also use [http://www.finkproject.org/ Fink] to install these tools or</del> (it seems that fink lacks many of the needed tools) you can install them manually .

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

You can copy and paste this line:

$ sudo port install automake flex gettext libpng libcryptopp libiconv gd2 jpeg kibgeoip libupnp pkgconfig

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop.
Now open a Terminal and type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd /Users/mirko/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd /Users/mirko/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto --with-wx-config=../wxMac-2.8.10/wx-config \
--enable-optimize --with-crypto-prefix=/opt/local --with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local \
--enable-cas --enable-webserver --enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon \
--enable-geoip --with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug --enable-debug_gdb

Take a look to the [[configure]] page for a complete list of options.
You should pay attention to these elements:

# The given example enables debug informations. To disable them change the options ''--enable-debug --enable-debug_gdb'' with ''--disable-debug --disable-debug_gdb --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard (change "MacOSX10.5.sdk" to "MacOSX10.4.sdk" if you are using Tiger):
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-04-14T05:51:43Z

Mirko.grewing: /* Step 5: Compile aMule */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Check the Mac forum for a more recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, you can also use [http://www.finkproject.org/ Fink] to install these tools or you can install them manually.

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

You can copy and paste this line:

$ sudo port install automake flex gettext libpng libcryptopp libiconv gd2 jpeg kibgeoip libupnp pkgconfig

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop.
Now open a Terminal and type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd /Users/mirko/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd /Users/mirko/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto --with-wx-config=../wxMac-2.8.10/wx-config \
--enable-optimize --with-crypto-prefix=/opt/local --with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local \
--enable-cas --enable-webserver --enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon \
--enable-geoip --with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug --enable-debug_gdb

Take a look to the [[configure]] page for a complete list of options.
You should pay attention to these elements:

# The given example enables debug informations. To disable them change the options ''--enable-debug --enable-debug_gdb'' with ''--disable-debug --disable-debug_gdb --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard (change "MacOSX10.5.sdk" to "MacOSX10.4.sdk" if you are using Tiger):
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-04-14T05:49:54Z

Mirko.grewing: /* APPENDIX: Universal Binary */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Check the Mac forum for a more recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, you can also use [http://www.finkproject.org/ Fink] to install these tools or you can install them manually.

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

You can copy and paste this line:

$ sudo port install automake flex gettext libpng libcryptopp libiconv gd2 jpeg kibgeoip libupnp pkgconfig

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop.
Now open a Terminal and type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd /Users/mirko/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd /Users/mirko/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto --with-wx-config=../wxMac-2.8.10/wx-config \
--enable-optimize --with-crypto-prefix=/opt/local --with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local \
--enable-cas --enable-webserver --enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon \
--enable-geoip --with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug --enable-debug_gdb

You should pay attention to these elements:

# The given example enables debug informations. To disable them change the options ''--enable-debug --enable-debug_gdb'' with ''--disable-debug --disable-debug_gdb --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard (change "MacOSX10.5.sdk" to "MacOSX10.4.sdk" if you are using Tiger):
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-04-14T05:48:04Z

Mirko.grewing: /* APPENDIX: Universal Binary */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Check the Mac forum for a more recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, you can also use [http://www.finkproject.org/ Fink] to install these tools or you can install them manually.

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

You can copy and paste this line:

$ sudo port install automake flex gettext libpng libcryptopp libiconv gd2 jpeg kibgeoip libupnp pkgconfig

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop.
Now open a Terminal and type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd /Users/mirko/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd /Users/mirko/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto --with-wx-config=../wxMac-2.8.10/wx-config \
--enable-optimize --with-crypto-prefix=/opt/local --with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local \
--enable-cas --enable-webserver --enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon \
--enable-geoip --with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug --enable-debug_gdb

You should pay attention to these elements:

# The given example enables debug informations. To disable them change the options ''--enable-debug --enable-debug_gdb'' with ''--disable-debug --disable-debug_gdb --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to build a [http://en.wikipedia.org/wiki/Universal_binary universal binary] app.

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard:
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-04-10T23:03:46Z

Mirko.grewing: /* APPENDIX: Universal Binary */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Check the Mac forum for a more recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, you can also use [http://www.finkproject.org/ Fink] to install these tools or you can install them manually.

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

You can copy and paste this line:

$ sudo port install automake flex gettext libpng libcryptopp libiconv gd2 jpeg kibgeoip libupnp pkgconfig

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop.
Now open a Terminal and type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd /Users/mirko/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd /Users/mirko/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto --with-wx-config=../wxMac-2.8.10/wx-config \
--enable-optimize --with-crypto-prefix=/opt/local --with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local \
--enable-cas --enable-webserver --enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon \
--enable-geoip --with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug --enable-debug_gdb

You should pay attention to these elements:

# The given example enables debug informations. To disable them change the options ''--enable-debug --enable-debug_gdb'' with ''--disable-debug --disable-debug_gdb --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to make a [http://en.wikipedia.org/wiki/Universal_binary universal binary].

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac (Step 4).
# Add the following options to the aMule ''config'', if you are using Leopard:
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-04-10T23:02:49Z

Mirko.grewing: /* Syntax of most important command */

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Check the Mac forum for a more recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, you can also use [http://www.finkproject.org/ Fink] to install these tools or you can install them manually.

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important commands =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

You can copy and paste this line:

$ sudo port install automake flex gettext libpng libcryptopp libiconv gd2 jpeg kibgeoip libupnp pkgconfig

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop.
Now open a Terminal and type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd /Users/mirko/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd /Users/mirko/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto --with-wx-config=../wxMac-2.8.10/wx-config \
--enable-optimize --with-crypto-prefix=/opt/local --with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local \
--enable-cas --enable-webserver --enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon \
--enable-geoip --with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug --enable-debug_gdb

You should pay attention to these elements:

# The given example enables debug informations. To disable them change the options ''--enable-debug --enable-debug_gdb'' with ''--disable-debug --disable-debug_gdb --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to make a [http://en.wikipedia.org/wiki/Universal_binary universal binary].

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac.
# Add the following options to the aMule ''config'', if you are using Leopard:
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"

HowTo compile on Mac

2009-04-10T23:02:19Z

Mirko.grewing: Page update...

<center>
'''English''' |
[[HowTo_compile_on_Mac-de|Deutsch]] |
[[HowTo_compile_on_Mac-es|Español]] |
[[HowTo_compile_on_Mac-fr|Français]]
</center>

How to get and install [[aMule]] on [http://www.apple.com/macosx/ Apple Mac OS X].

# You can simply download the finished application ('binary release');
# You compile it from a [[aMule SVN|SVN source snapshot]] or [http://www.amule.org/files/files.php?cat=42 stable release source].

== Binary releases ==
If you don't want to bother with installing and compiling all those tools and sources, then get one of the pre-compiled [[aMule]] applications. The official release is considered 'stable', but every now and then applications are built from the current source to allow more people to test new features or the like.

# Latest official binary release: [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Check the Mac forum for a more recent user posted binary: [http://forum.amule.org/index.php?board=49.0 aMule forum]

Now, to install the downloaded binary, just drag the aMule application to a folder of your choice (e.g., ''/Applications'').

To start aMule, double-click the application icon.

'''Note:''' You might want to take a look at the [[Mac specific usage]] article.

== Compiling from source ==
Compiling from source allows most current bug reports, because you can compile and test the [[aMule CVS|CVS snapshot]] of the very day.

To compile [[aMule]] from source you need some development tools, the [[wxWidgets]] library and the [http://www.amule.org/files/files.php?cat=42 aMule source].

=== Get the sources and development tools ===
==== Step 1: Download and install [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] is [http://www.apple.com Apple]'s development environment. We need it for the [http://gcc.gnu.org GCC] compiler.

You will need at least version 2.1 of Xcode, a more recent version is preferable though. You can download the most recent version of Xcode from Apple, but you will need to sign up for a free-of-charge developer account first or log-in using your iTunes Store account.

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

==== Step 2: Install [http://www.macports.org MacPorts]====
[http://www.macports.org MacPorts] is an open source installer for lots of open source tools ported to [http://macos.apple.com Mac OS X]. aMule needs a few of these tools to compile properly. Alternatively, you can also use [http://www.finkproject.org/ Fink] to install these tools or you can install them manually.

# Download the most recent version of [http://www.macports.org MacPorts]
# Read [http://guide.macports.org/ MacPorts' documentation] to learn how to install applications through [http://www.macports.org MacPorts].

===== Syntax of most important command =====
Packages list can be downloaded/updated through

$ sudo port selfupdate

Packages can be installed through

$ sudo port install ''package_name''

and removed with

$ sudo port uninstall ''package_name''

Port variants can be invoked with the plus sign:

$ sudo port install ''package_name'' +universal

==== Step 3: Install libraries and tools ====

These are the package that provides (with dependancies) all needed libraries and tools to build [[wxWidgets]] and [[aMule]] with most of feature:

# automake
# flex
# gettext
# libpng
# libcryptopp
# libiconv
# gd2
# jpeg
# libgeoip
# libupnp
# pkgconfig

You can copy and paste this line:

$ sudo port install automake flex gettext libpng libcryptopp libiconv gd2 jpeg kibgeoip libupnp pkgconfig

==== Step 4: Compile [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] is the port of the [[wxWidgets]] library for [http://www.apple.com/macosx Mac OS X]. This library is used to make [[aMule]] 'multi-platform'.

Get the source from: http://www.wxwidgets.org/downloads/ (Source Archives: wxMac) and extract the archive on your desktop.
Now open a Terminal and type

$ cd

leave a space after the command, than drag and drop the wxMac uncompressed folder into the Terminal window: the complete path of the folder will be printed on screen. For example:

$ cd /Users/mirko/Desktop/wxMac-2.8.10/

Press enter.
Now configure and compile the package with the command:

$ ./configure --disable-shared --enable-unicode --disable-debug --disable-debug_gdb --with-libiconv-prefix=/opt/local && make -j8

'''Note:''' The above command doesn't enable debug information. Debug informations allows you to submit a helpful stacktrace if [[aMule]] crashes or a sample if it hangs to the [[aMule devs|aMule developers]]. If you want to compile a debug version then you can use "--enable-debug --enable-debug_gdb" instead.

==== Step 5: Compile [[aMule]] ====
Download [http://www.amule.org/files/files.php?cat=42 aMule source] and extract archive into the same place of wxMac (i.e. your desktop if you are following out suggestion).
Open a Terminal and type:

$ cd

then leave a space and drag and drop aMule uncompressed folder whose path will be printed on screen, for example:

$ cd /Users/mirko/Desktop/aMule-2.2.4

Press Enter. Now it's possible to configure the sources: there are several options that can be used to activate or deactivate feature during compiling. This is only an example, that provide a full feature aMule build:

$ ./configure --disable-systray --disable-gtk --enable-embedded_crypto --with-wx-config=../wxMac-2.8.10/wx-config \
--enable-optimize --with-crypto-prefix=/opt/local --with-gdlib-config=/opt/local/bin/gdlib-config --with-libiconv-prefix=/opt/local \
--enable-cas --enable-webserver --enable-amulecmd --enable-amule-gui --enable-wxcas --enable-alc --enable-alcc --enable-amule-daemon \
--enable-geoip --with-geoip-lib=/opt/local/lib --with-geoip-headers=/opt/local/include --enable-geoip-static --enable-debug --enable-debug_gdb

You should pay attention to these elements:

# The given example enables debug informations. To disable them change the options ''--enable-debug --enable-debug_gdb'' with ''--disable-debug --disable-debug_gdb --enable-optimize''.
# The option ''--with-wx-config'' must point to the correct relative path of the compiled wxMac. The example assumes that aMule and wxMac folders are in the same directory (i.e. your desktop). You should also correct the wxMac folder's name according to its version (in the example is 2.8.10).
# The option ''--with-crypto-prefix'' should point to /usr/local/cryptopp if you compiled Crypto++ starting from its source, out of MacPorts.
# '''IMPORTANT!''' It seems that Mac OS version of ''ld'' tool is not able to make static library. So if you plan to run/install your compiled aMule on other Mac which doesn't have MacPorts installed you MUST remove the ''--enable-geoip-static'' option to avoid a crash when the program starts.

Now it's time to make you packages with:

$ make -j8

and

./src/utils/scripts/mac_packager

You should find the aMule package in the same source folder.

=== APPENDIX: Universal Binary ===

If no specific options are added, the system compile the packages for the native architecture (i.e. i386 if you are using a Mac Intel or ppc for PowerPcs).
If you plan to distribute your package or to use it on different platform you probably want to make a [http://en.wikipedia.org/wiki/Universal_binary universal binary].

To get a UB package you should

# Install all the libraries and tools (Step 3) through MacPorts invoking the ''+universal'' variant.
# Attache the option "--enable-universal_binary" to the ''configure'' command of wxMac.
# Add the following options to the aMule ''config'', if you are using Leopard:
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.5.sdk"