HowTo compile on Mac-fr

2008-04-03T20:28:04Z

Alno: adding Crypto++

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

Comment obtenir et installer [[aMule]] sur [http://www.apple.com/macosx/ Mac OS X].

# Vous pouvez simplement télécharger l'application finie (déjà compilée) ('binary release') ou
# Vous pouvez la compiler à partir d'une [[aMule CVS | source CVS "snapshot"]].

''La version précédente de cette page couvrant [[aMule]] 2.0.0rc8 et versions antérieures est archivée [[HowTo_compile_on_Mac_v200rc8|ici]].''

== Releases Binaires (aMule déjà compilé) ==
Si vous ne souhaitez pas vous embêter à installer et compiler tous ces "outils" et sources, téléchargez et installez une version pré-compilée du logiciel [[aMule]]. La release officielle est considérée 'stable', mais tous les logiciels tels quels sont compilés à partir de la source "courrante" (current cource) pour permettre à plus de personnes de tester les nouvelles fonctionnalités.

# La dernière "release" officielle : [http://www.amule.org/files/files.php?cat=30 aMule-2.1.3-Mac]
# Consultez le forum Mac pour obtenir un binaire (logiciel déjà compilé) + récent : [http://forum.amule.org/index.php?board=49.0 aMule forum]

Pour Installer le logiciel aMule téléchargé (déjà compilé), glissez l'icône aMule vers le dossier ''/Applications''.

Pour lancer aMule, double-cliquez sur son icône.

'''N.B. :''' Vous pourrez lire l'article [[Mac specific usage | usage spécifique pour Mac]].

== Comment Compiler à partir d'une source ==
Compiler à partir d'une source résoud les bugs les plus courants, car vous pourrez compiler et tester les versions les plus récentes à partir des [[aMule CVS | versions CVS d'aMule]].

Pour compiler [[aMule]] depuis une source, il vous faudra
* les "developer tools" (outils de développement) (fournis avec Mac OS X ou depuis ADC sur le site d'Apple avec un compte developper Apple, inscription gratuite),
* la bibliothèque [[wxWidgets]]
* une [http://amule.hirnriss.net/ source aMule].

=== Pour obtenir les sources et les dev tools ===
==== [http://developer.apple.com/tools/xcode Xcode] ====
[http://developer.apple.com/tools/xcode Xcode] est l' IDE (Environment de Développement Intégré) d' [http://www.apple.fr Apple].
Il est nécessaire pour avoir le compilateur [http://gcc.gnu.org GCC].

Il vous faut au moins la version 2.1 d' Xcode, néanmoins, une version plus récente est préférable.
[http://developer.apple.com/tools/xcode Xcode] est inclus sur les DVD de Mac OS X 10.4, mais les premières versions de Tiger 10.4 n'ont que Xcode 2.0. Vérifiez donc que la version que vous avez sur le DVD est au moins la 2.1.

Autrement, vous pouvez télécharger la version plus récente d' Xcode depuis le site d'Apple, (mis à part une inscription préalable à un compte gratuit à ADC Apple Developer connection).

# Téléchargez Xcode sur http://developer.apple.com/tools/download
# "Member Site"->"Log In"->"Download Software"->"Developer Tools"->"Download Xcode Tools last release">"Install"

==== [http://www.macports.org MacPorts] (précédemment nommé DarwinPorts) ====
[http://www.macports.org MacPorts] est un installeur open source pour de nombreux logiciels open source portés pour [http://macos.apple.com Mac OS X]. aMule nécéssite quelques uns de ces logiciels pour se compiler correctement. Autrement, vous pouvez également installer [http://fink.sourceforge.net Fink] pour installer ces logiciels ou vous pouvez les installer un à un manuellement.

# Téléchargez la version la plus récente de [http://www.macports.org MacPorts]
# Lisez [http://trac.macosforge.org/projects/macports/wiki la Doc de MacPorts] pour savoir comment installer des applications gràce à [http://www.macports.org MacPorts].

bash: vi ~/.profile
bash: i
bash: export PATH=/opt/local/bin:/opt/local/sbin:$PATH
bash: export DISPLAY=:0.0
bash: [echap] :wq!
bash: logout
bash: relancer le Terminal

Les outils que vous devrez installer sont :
# automake
# flex
# gettext (si vous voulez utiliser une autre langue que l'Anglais dans aMule)
# libpng

bash: sudo port [-v] install automake
bash: sudo port -v flex
bash: sudo port -v libpng

====[http://www.cryptopp.com/ Crypto++]====
Il va aussi falloir la bibliothèque crypto++ pour disposer du cryptage (introduit dans les versions récentes). Sans cela, vous allez obtenir une erreur similaire à ce qui suit :
<pre>
checking for crypto++ version >= 5.1... configure: error:
Could not find cryptopp header file "cryptlib.h".
Please check if the path "/usr" is valid.
</pre>

Le MacPort est actuellement cassé et assez ancien (v5.1 alors que la v5.5.est la version courante). Donc il vaut mieux le recompiler soi-même.

# Pour obtenir les sources : http://www.cryptopp.com/#download
# Extraire l'archive (il suffit de la double-cliquer)

==== [[wxWidgets|wxMac]] ====
[[wxWidgets|wxMac]] est le portage de la bibliothèque [[wxWidgets]] pour [http://macos.apple.com Mac OS X]. Cette bibliothèque est utilisée pour rendre [[aMule]] 'multi-plateforme'. (Windows, Linux et Mac OS X sont des plateformes)

# La source de wxMac est dispo ici : [http://www.wxwidgets.org/downloads/]
# Décompressez l' archive (double-cliquez dessus)

==== [http://www.amule.org aMule] ====
# Obtenez quotidiennement la source [[aMule CVS| CVS]] d'aMule: [http://www.hirnriss.net/?area=cvs aMule CVS]
# Décompressez l' archive (double-cliquez dessus)

=== Compiler les sources ===
Mettez le dossier ''amule'' et le dossier ''wxMac'' au même endroit, par ex. sur le Bureau (si vous utlisez un autre dossier, assurez-vous qu'il n'y a pas d'espace dans le chemin d'accès au dossier [[WxWidgets|wxMac]]).

==== Compiler [[WxWidgets|wxMac]] ====
cette étape ne sera effectuée qu'un fois, même si par la suite, vous compilez [[aMule CVS | des CVS plus récents d' aMule]].

Les instructions suivantes considèrent que vous avez placé les packages dans le dossier Bureau.<br>
''cd ~/Desktop/wxMac'', ''configure'', ''make'':

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

'''N.B. :''' La seconde ligne de commande ci-dessus vous assure que wxMac est compilé en vous indiquant les instructions de débogage. Ces informations vous permettent de reporter [[aMule devs | aux développeurs ]] des indications utiles si [[aMule]] plante ou est lent.
Si vous ne souhaitez pas compiler une version avec débogage, ajoutez "--disable-debug --disable-debug_gdb" à la suite de la ligne de commande.

'''N.B. :''' Si vous souhaitez compiler une version [http://en.wikipedia.org/wiki/Universal_binary Universal Binary] d' aMule (c'est à dire une version qui tournera à la fois sur un Mac à base de PowerPC et Mac Intel) vous devrez ajouter le paramètre "--enable-universal_binary" à la fin de la 2ème ligne de commande.
Si vous n' incluez pas ce paramètre, wxMac et aMule ne seront comilés que pouyr votre type de processeur (PowerPC OU Intel).

'''N.B. :''' La durée d'exécution des commandes "make" ci-dessus peuvent durer jusqu'à 50 minutes sur un G4 fréquencé à 1.33 GHz, selon les paramètres que vous choisirez. Un processeur + rapide mettra moins de temps (évidemment !).

==== Compiler [[aMule]] ====
''cd ~/Desktop/amule'', ''configure'', ''make'':

'''N.B. :''' Vous pouvez copier-coller les 4 lignes pour ''./configure'' en une seule fois.

'''NB :''' Cela durera ±30 minutes sur un G4 à 1.33 GHz.

bash: cd ~/Desktop/amule-cvs
bash: ./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

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

'''NB :''' Si vous ne souhaitez pas compiler aMule avec les instructions de débogage (voir plus haut), vou pouvez taper "--disable-debug --enable-optimize" à la suite de la ligne de commande.

'''NB :''' Pour compiler aMule en Universal Binary (voir plus haut) vous devrez ajouter les paramètres suivants :
--disable-dependency-tracking \
CFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.4u.sdk" \
CXXFLAGS="-arch ppc -arch i386 -isysroot /Developer/SDKs/MacOSX10.4u.sdk"

==== Lancer [[aMule]] ====
Une fois que le script "mac_packager" est terminé, vous pouvez déplacer l' application aMule du dossier "amule-cvs" vers Applications (par exemple).

== Version ==
Traduit par "Alf-Red-Toshirô" le vendredi 22.01.2008 à 18:55<br>

AMule Project FAQ - User contributions [en]

HowTo compile on Mac-fr