HowTo Compile In Ubuntu

2010-07-10T19:15:00Z

Lonnie:

This page describes how to compile aMule and its required libraries CryptoPP and wxWidgets on Ubuntu 9.04. We will install everything in our home directory in this example. Make a directory where you want to build and install aMule (we will use <code>/home/me/amule</code> and I'll call it <code>"amule"</code>).

= Install packages =
Use [http://en.wikipedia.org/wiki/Synaptic_Package_Manager Synaptic Package Manager] (if you use [http://en.wikipedia.org/wiki/GNOME GNOME]) or [http://en.wikipedia.org/wiki/KPackageKit KPackageKit]/[http://en.wikipedia.org/wiki/Adept_Manager Adept] (if you use [http://en.wikipedia.org/wiki/KDE KDE]) to install the following packages:

* g++
* binutils-dev
* libcrypto++-dev
* libgtk2.0-dev
* libgd2-xpm-dev
* libgeoip-dev
* libupnp3-dev
* zlib1g-dev

= Build CryptoPP =
You shouldn't try to build CryptoPP on Ubuntu from source. The original CryptoPP headers are broken and cause a zillion warnings later building aMule. The Ubuntu developers provide fixed headers so you should use the lib that comes with it. However you should also install the cryptest tool and verify if CryptoPP really runs on your machine:

<code>sudo apt-get install libcrypto++-utils</code>

<code>cd /usr/share/crypto++</code>

<code>cryptest v</code>

If you still want to build it, download [http://www.cryptopp.com/cryptopp560.zip CryptoPP 5.6.0]. Unzip it to <code>/home/me/amule/cryptopp</code> . Run <code>make</code>. Then run <code>./cryptest.exe v</code> to validate it (it must print <code>All tests passed!</code>).

= Build wxWidgets =
Make directory <code>amule/wx</code>. Download [http://www.wxwidgets.org/downloads/ latest stable wxGTK] (2.8.10 writing this). Wx 2.9 is still experimental, if you feel adventurous you can try it (but only with aMule 2.3).

Extract it with <code>tar xzf wxGTK-2.8.10.tar.gz</code>. Make and cd to wx/build and run

<code>../wxGTK-2.8.10/configure --prefix=/home/me/amule/wx --with-gtk --enable-unicode --enable-optimise --disable-shared</code>

then <code>make</code> and <code>make install</code> .

Note: wxGTK 2.8.10 needs a patch for Ubuntu Karmic, see [http://trac.wxwidgets.org/changeset/61009 here].

You can also simply install libwxgtk2.8-dev .

= Build aMule =
Make dir and download and unpack aMule's source ([http://www.amule.org/files/ Release] or [[AMule_SVN|current SVN]]), then

<code>./configure --prefix=/home/me/amule/bin --enable-debug --enable-optimize --with-denoise-level=3 --enable-upnp --enable-geoip --enable-nls --enable-amule-gui --enable-amule-daemon --enable-amulecmd --enable-webserver --enable-alcc --enable-alc --enable-cas --enable-wxcas --enable-mmap --with-wx-config=/home/me/amule/wx/bin/wx-config --with-crypto-prefix=/home/me/amule/cryptopp</code>

Leave out the --with-crypto-prefix when using the Ubuntu CryptoPP. Also leave out the --enable-upnp if you don't need UPnP (that is if you are able to set up port forwarding in your router).

Now just run make and that's it! You can start aMule with command "/home/me/amule/bin/amule".

= Build from repository export =
If your aMule source doesn't come with a configure script you have a direct export from the development repository. To set up configure you need to run ./autogen.sh first. You need additional packages:

*autoconf
*cvs

AMule Project FAQ - User contributions [en]

HowTo Compile In Ubuntu