AMule Project FAQ - User contributions [en]

HowTo compile on Win32-de

2006-03-18T16:44:19Z

82.83.249.124: Added a link to precompiled 2.1.1stable aMuleGUI executable

<center><h2>Ursprünglich in Englisch von '''Madcat'''</h2></center>
<center><h2>Überarbeitet von '''Sirius'''</h2></center>

<center>
[[HowTo compile on Win32|English]] | '''Deutsch'''
</center>

Diese wiki Seite bezieht sich nur auf die neueste [[aMule_CVS-de|CVS]]-Version des [[aMule-de|aMule]].

==Benötigte Programme==

Diese Programme werden benötigt:

'''Anmerkung:''' Einige dieser Progrogramme benötigen ein eigenhändiges verschieben von includes und Bibliotheken in die entsprechenden Verzeichnisse.

*[http://www.microsoft.com/windows Windows] port of [http://gcc.gnu.org GNU C compiler] -> [http://prdownloads.sf.net/mingw/MinGW-4.1.1.exe?download Download 4.1.1]

*Minimal [http://www.gnu.org GNU] shell for [http://www.microsoft.com/windows Windows] -> [http://prdownloads.sf.net/mingw/MSYS-1.0.10.exe?download Download 1.0.10]

*Developer toolkit for [http://www.mingw.org/msys.shtml MSys] (for [http://www.gnu.org/software/cvs CVS] & co) -> [http://prdownloads.sf.net/mingw/msysDTK-1.0.1.exe?download Download 1.0.1]

*[http://www.gnu.org/software/libiconv LibIConv] (required by [http://www.gnu.org/software/gettext gettext]) -> [http://prdownloads.sf.net/mingw/libiconv-1.8.0-2003.02.01-1.exe?download Download 1.8]

*[http://www.gnu.org/software/gettext GetText] (for [http://www.gnu.org/software/gettext po files], [http://www.gnu.org/software/automake/automake.html autogen.sh], etc) -> [http://prdownloads.sf.net/mingw/gettext-0.11.5-2003.02.01-1.exe?download Download 0.11.5]

*[http://www.zlib.org zlib] compression library dll Version -> [http://prdownloads.sourceforge.net/libpng/zlib123-dll.zip?download Download 123]

1. Install the supplied header files "zlib.h" and "zconf.h" into the INCLUDE directory of the MinGW directory. (copy *.h -> somepath/MinGW/include)

2. Copy the supplied library file "zdll.lib" as "libzdll.a" into the MinGW/lib folder (copy lib/zdll.lib -> lib/libzdll.a)

*[http://www.microsoft.com/windows Windows] port of [[wxWidgets]] library -> [http://prdownloads.sourceforge.net/wxwindows/wxMSW-2.6.1-Setup.exe Download 2.6.1]

==Schritt für Schritt-Anleitung==

(Ersetze '(Benutzername)' mit dem regulären Windowsbenutzernamen der im Ordner ''home'' zu finden ist)

1. Installiere die Programme der Reihe nach. Installiere sie in den vom Programm vorgeschlagenen Pfad. ''MSys'' fragt bei der Installation nach dem Pfad zu ''MinGW''. Sollte dabei was schief gehen und z.B. das ''./configure später fehlschlagen'', dann kann diese Angabe nachträglich korrigiert werden. Dazu im ''MSys'' Verzeichnis unter ''etc'' die Datei ''fstab'' anpassen zu: ''c:\MinGW /mingw ''

2. Erstelle in ''C:\msys\1.0\home\(Benutzername)\'' einen neuen Ordner namens aMule

3. Entpacke das [http://www.wxwidgets.org/manuals/2.5.2/wx_wxmswport.html wxMSW] Paket in diesen Ordner. Für [http://www.zlib.net zlib] erstelle zuerst einen Ordner namens ''zlibdll'' und entpacke dieses Paket hierhin.

4. Starte ''msys'' (die Shell du zuvor installiert hast).

5. Wechsle mit ''cd aMule'' in den zuvor angelegten Ordner.

6. Der Befehl ''ls'' sollte jetzt ''zlibdll'' und ''wxWidgets-'''(Version)''''' anzeigen.

7. Mit dem Befehl ''cd'' in den ''wxWidgets'' Ordner.

8. Gib den Befehl ''./configure --disable-shared --without-checklistbox'' ein.

9. Wenn dies geklappt hat den Befehl ''make'' und danach ''make install''

10. Mit dem Befehl ''cd ..'' kannst du in der Ordnerstruktur eine Ebene nach oben wechseln. Gib ihn einmal ein.

11. Als nächstes soll zlib kompiliert werden. Dazu zuerst mit ''cd zlibdll'' in den Ordner ''zlibdll'' wechseln.

12. Gib den Befehl ''./configure --prefix=/mingw'' ein.

13. Falls kein Fehler aufgetreten ist, gib ''make'' und anschliessend ''make install'' ein.

14. Besorg dir nun die aktuellen Sourcen von [[aMule]] von der [http://dl.amule.org Webseite] und enpacke sie in den gleichen Ordner wie zuvor [http://www.zlib.net zlib] und [[wxWidgets]].

15. ''cd aMule-'''(Version)'''''

16. ''./configure --with-zlib=/home/(Benutzername)/aMule/zlibdll/ --disable-debug --enable-optimize --enable-static''

17. ''make''

18. ''make install''

Schliese nun alle Fenster, starte die Shell ''msys'' neu und gib ''aMule.exe'' ein. Fertig. Die ''Temp'' und ''Incoming'' Ordner befinden sich in ''C:\msys\1.0\home\(Benutzername)\'' respektive ''C:\msys\1.0\home\(Benutzername)\.aMule\''

==Installation auf einem weiteren Computer==
Wer nun die kompilierte Version auf einem anderen Computer installieren möchte ohne die ganzen Tools zu installieren der kann dies mit folgenden Schritten erreichen.

1. Auf dem Desktop einen Ordner ''aMule-'''(Version)''''' erstellen.

2. Alle Ordner aus ''C:\msys\1.0\local'' in diesen Ordner kopieren.

3. Die Datei ''C:\MinGW\bin\mingwm10.dll'' in den bin Ordner kopieren.

4. Den Ordner mit einem Tool wie [http://www.rarlabs.com WinRAR] oder [http://www.winzip.com WinZIP] verpacken.

5. Auf dem Server enpacken.

6. Im Ordner bin auf ''aMule.exe'' doppelklicken.

7. Fertig!

Die Download und Tempordner befinden sich nun in ''C:\Dokumente und Einstellungen\(Benutzername)\aMule Downloads'' bzw. ''C:\Dokumente und Einstellungen\(Benutzername)\.aMule''. Diese Einstellungen können nun selbstverständlich über die Preference anders eingestellt werden. Viel Vergnügen.

==Fragen, Probleme==

Bei Fragen oder Problemen bekommst du im Forum Hilfe. Bitte gib dort alle Informationen an, die bis zu dem Fehler ausgegeben wurden. Nach der Problemlösung kannst du diese Anleitung verbessern, ergänzen, indem du auf den ''Edit this page''-Link ganz oben klickst.

==Download von kompilierten Versionen==

Eine kompilierte aMule-2.0.2 Version gibt es unter dem folgenden Ed2k-Link: ''ed2k://|file|amule-2.0.2.zip|10670377|D3B98E6D45BBCC677107EEF1A0412DE3|h=VTQSCK2M7HZXODHQ7W66ONBQLVLCT436|/''

Ein Installer von aMule-2.0.2: ''ed2k://|file|Setup-aMule-2.0.2.exe|6001771|6D31880ABFBF0A6EAD92D1A93A4AA753|/|h=FGTJRUUATH5X6QGOIFLMA5X2UPRGSJ35|/''

Nur die kompilierte aMuleGUI für win32 vom CVS 22-09-2005: ed2k://|file|amulegui-win32-cvs22-09-2005(incl.dll+readme).zip|1990063|8553F619C878E3F0C916B7FBF82EB934|h=KFB3RUSI65EE2WMIBWQ2WHXIIUEA57VZ|/

oder direkt:[http://s6.11mbit.de/7i5blmw6cmIxc8noy48nJ3deJgL01BLz1ogPvakPv1blHJx3dnJCLr6g/cf784ogC amulegui-win32-cvs22-09-2005(incl.dll+readme).zip] ([https://s6.11mbit.de/7i5blmw6cmIxc8noy48nJ3deJgL01BLz1ogPvakPv1blHJx3dnJCLr6g/cf784ogC SSL])

Funktioniert sehr gut unter WinXP + 2000! Bei fragen: therealfox AT gmail DOT com

Ausserdem gibt es einen stable build der aMuleGUI Version 2.1.1 unter
http://conrausch.elise.no-ip.com/aMuleGUI-2.1.1-all_lang.zip

(beinhaltet .exe + .dll + alle Sprachen, also alles was man braucht. Bei Problemen: conrausch at gmx de)

HowTo compile on Win32 with MinGW

2006-03-18T16:39:07Z

82.83.249.124: updated precompiled remote GUI link to new version

<center><h2>Originally by '''[[User:Madcat|Madcat]]'''</h2></center>

<center>
'''English''' | [[HowTo compile on Win32-de|Deutsch]]
</center>

This wiki page only covers the latest [[aMule_CVS|CVS]] version of [[aMule]], not releases in the 1.x.x or 2.x.x branches.

''For those of you that don't want to compile [[aMule]] from source, there is also the option of the [[Win32_binary|aMule Windows Installer]].''

== Requirements for compiling [[aMule]] ==

You will need the following packages:

*[http://www.microsoft.com/windows Windows] port of [http://gcc.gnu.org GNU C compiler], [http://www.mingw.org MinGW] -> [http://prdownloads.sourceforge.net/mingw/MinGW-4.1.1.exe?download Download (4.1.1)]
*Minimal [http://www.gnu.org GNU] shell for [http://www.microsoft.com/windows Windows], [http://www.mingw.org/msys.shtml MSys] -> [http://prdownloads.sf.net/mingw/MSYS-1.0.10.exe?download Download (1.0.10)]
*Developer toolkit for [http://www.mingw.org/msys.shtml MSys] (for [http://www.gnu.org/software/cvs CVS] & co) -> [http://prdownloads.sf.net/mingw/msysDTK-1.0.1.exe?download Download (1.0.1)]
*[http://www.gnu.org/software/libiconv LibIConv] (required by [http://www.gnu.org/software/gettext gettext]) -> [http://prdownloads.sf.net/mingw/libiconv-1.8.0-2003.02.01-1.exe?download Download (1.8)]
*[http://www.gnu.org/software/gettext GetText] (for [http://www.gnu.org/software/gettext po files], [http://www.gnu.org/software/automake/automake.html autogen.sh], etc) -> [http://prdownloads.sf.net/mingw/gettext-0.11.5-2003.02.01-1.exe?download Download (0.11.5)]
*[http://www.zlib.org zlib] compression library -> [http://www.zlib.net/zlib-1.2.3.tar.gz Download (1.2.3)]
*[http://www.microsoft.com/windows Windows] port of [[wxWidgets]] library (knows as [[wxWidgets|wxMSW]]) -> [http://prdownloads.sourceforge.net/wxwindows/wxMSW-2.6.1.zip Download (2.6.1)]
*[[aMule]]'s latest release sources or [[aMule CVS]] -> [http://dl.amule.org Download aMule]

Also, 800MB-1500MB free space on your hard disk (around 40MB to download the above packages and the rest for temporary compilation files and installations. The amount of space needed will largely depend on the configuration flags you use).

As a reference, the whole compilation process will take around 3 hours on a medium-high resourced computer.

== Installing the Minimal System ==

The first step is to create a [http://www.kernel.org Linux]-like environment, which is required in order to be able to perform the build. This can be done by following these steps '''in this order''':

#Install [http://www.mingw.org MinGW]. Select ''Compact installation'' unless you know what you are doing. When it prompts you for a folder, the default (''C:\mingw'') is slightly messy but the safer selection.
#Install [http://www.mingw.org/msys.shtml MSys]. When it prompts you for the [http://www.mingw.org MinGW] folder, it's very important to specify it correctly. Failure on this step will stop any compilation attempts. If for some reason you fail, install [http://www.mingw.org/msys.shtml MSys] again, or edit the file ''/etc/fstab'' in your [http://www.mingw.org/msys.shtml MSys] environment.
#Install the [http://www.mingw.org/msys.shtml MSys] developer toolkit.
#Install [http://www.gnu.org/software/libiconv LibIConv].
#Install [http://www.gnu.org/software/gettext GetText].

== Compiling the libraries ==

There are two libraries that [[aMule]] will need compiled: [http://www.zlib.org zlib] and [[wxWidgets]].

We will compile them from [http://www.mingw.org/msys.shtml MSys], so just run it. Once you are running [http://www.mingw.org/msys.shtml MSys], you'll be on your home folder. Copy the [http://www.zlib.org zlib] and [[wxWidgets]] files you downloaded above into this folder (something like ''C:\msys\1.0\home\'''user''''').

The steps for compiling them is:

#[http://www.zlib.org zlib]: Uncompress [http://www.zlib.org zlib], cd to the newly created directory and run ''./configure --prefix=/mingw && make && make install''
#[[wxWidgets]]: Uncompress [[wxWidgets]], cd to the newly created directory and run ''./configure --enable-unicode --disable-shared --without-checklistbox && make && make install''

If you want to help us developers, you can add ''--enable-debug'' flag to the [[wxWidgets]] configure command, right after ''--disable-shared'', but be warned it will result into an ''aMule.exe'' file bigger than 100MB.

== Compilation ==

Ok, we're all done with the compilation environment. Let's do the last step: compiling [[aMule]].

First of all, extract [[aMule]]'s sources and enter the newly created folder.

The compilation itself is actually just a matter of following the usual method: ''./configure && make''. Use your favorite flags on ''./configure'', for example, ''--disable-debug'' will remove debug info, but will also make it harder for us developers to understand the bugs you might find.

You might want to compile just the remote GUI: the flags would be ''--disable-monolithic --disable-ed2k --enable-amule-gui''

'''Beware:''' The following programs do not work yet on [http://www.microsoft.com/windows Windows]:
*[[aMuled|aMule Daemon]]: Doesn't even compile.
*[[CAS]]: Fails to find the [[signature]] file.

'''Note:''' To keep the size of the binnaries down, you can run ''strip'' from within [http://www.mingw.org/msys.shtml MSys].

== Running ==

To run the binnaries we've created you need ''mingwm10.dll''. This file can be found in ''C:\MinGW\bin\mingwm10.dll'' (or whatever path you used to install [http://www.mingw.org MinGW]).

You now have to place this file in some place so that the binnaries find it when they are executed. Here you have three options:

#Place it in the same folder where the binnaries are (if you have them spread in several different folders, copy this file once into each folder. Since it is a very small file, it is not much of a loss).
#Place it in ''C:\windows'' or some other any other path where [http://www.microsoft.com/windows Windows] might look for libraries (such as ''C:\Windows\System'' or ''C:\Windows\System32'').
#Add ''C:\MinGW\bin'' (or whatever path you used to install [http://www.mingw.org MinGW]) to your ''PATH'' environment variable.

Now... just run your binnaries and have fun with [[aMule]] on your [http://www.microsoft.com/windows Windows] box!

'''Note:''' By default, the binnaries are compiled to ''C:\MSys\1.0\home\'''user'''\amule-2.0.3\src\''.

== Having different languages ==

Now [[aMule]] will be successfully running, but you will not be able to use any other language but default english.

TO be able to choose between any of the lot of languages [[aMule]] is shipped with, from [http://www.mingw.org/msys.shtml MSys] go to [[aMule]]'s extracted folder and then into ''po/'' folder. Something like the following should do it:

cd
cd amule-2.0.3/po

Now install the languages:

make install-data-yes

This language files are now in ''C:\MSys\1.0\local\share\locale'', so exit [http://www.mingw.org/msys.shtml MSys], go to ''C:\msys\1.0\local\share\locale'' and copy that folder to the folder were you are keeping your compiled ''amule.exe'' and ''amulegui.exe'' files.

== Downloading precompiled win32 version ==

'''Keep in mind this is a user contributed build. Install it at your own risk'''

You can download aMuleGUI for win32 from CVS 22-09-2005 here: ed2k://|file|amulegui-win32-cvs22-09-2005(incl.dll+readme).zip|1990063|8553F619C878E3F0C916B7FBF82EB934|h=KFB3RUSI65EE2WMIBWQ2WHXIIUEA57VZ|/

or direct here: [http://s6.11mbit.de/7i5blmw6cmIxc8noy48nJ3deJgL01BLz1ogPvakPv1blHJx3dnJCLr6g/cf784ogC amulegui-win32-cvs22-09-2005(incl.dll+readme).zip] ([https://s6.11mbit.de/7i5blmw6cmIxc8noy48nJ3deJgL01BLz1ogPvakPv1blHJx3dnJCLr6g/cf784ogC SSL])

Comunication on an linux box with amuled and this gui works very good... maybe its a little bit slow, but, its working!

Feel free to contact me at: therealfox AT gmail DOT com, if you have problems.

If you prefer a stable (and more recent) build, you can grab amulegui from the stable 2.1.1 sources here:
http://conrausch.elise.no-ip.com/aMuleGUI-2.1.1-all_lang.zip

Again, this is a user contributed build, which you should not trust ;). It works pretty well though. It is a little big (almost 3MB), but it contains the .dll plus all language packs that were available with the release. For problems with this one, please contact conrausch [at] gmx de