HowTo compile on Mac-fr

From AMule Project FAQ
Jump to: navigation, search

English | Deutsch | Español | Français | Italiano

Comment obtenir et installer aMule sur Mac OS X.

  1. Vous pouvez simplement télécharger l'application finie (déjà compilée) ('binary release') ou
  2. Vous pouvez la compiler à partir d'une source SVN "snapshot".

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.

  1. La dernière "release" officielle : aMule-2.1.3-Mac
  2. Consultez le forum Mac pour obtenir un binaire (logiciel déjà compilé) + récent : 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 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 versions SVN 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 source aMule.

Pour obtenir les sources et les dev tools

Xcode

Xcode est l' IDE (Environment de Développement Intégré) d' Apple. Il est nécessaire pour avoir le compilateur GCC.

Il vous faut au moins la version 2.1 d' Xcode, néanmoins, une version plus récente est préférable. 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).

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

MacPorts (précédemment nommé DarwinPorts)

MacPorts est un installeur open source pour de nombreux logiciels open source portés pour Mac OS X. aMule nécéssite quelques uns de ces logiciels pour se compiler correctement. Autrement, vous pouvez également installer Fink pour installer ces logiciels ou vous pouvez les installer un à un manuellement.

  1. Téléchargez la version la plus récente de MacPorts
  2. Lisez la Doc de MacPorts pour savoir comment installer des applications gràce à MacPorts.
cat << "EOF" >> ~/.profile 
export PATH=/opt/local/bin:/opt/local/sbin:$PATH
export DISPLAY=:0.0
EOF
.  ~/.profile


Les outils que vous devrez installer sont :

  1. automake
  2. flex
  3. gettext (si vous voulez utiliser une autre langue que l'Anglais dans aMule)
  4. libpng
bash: sudo port [-v] install automake
bash: sudo port -v flex
bash: sudo port -v libpng

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 :

checking for crypto++ version >= 5.1... configure: error:
        Could not find cryptopp header file "cryptlib.h".
        Please check if the path "/usr" is valid.

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.

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

wxMac

wxMac est le portage de la bibliothèque wxWidgets pour Mac OS X. Cette bibliothèque est utilisée pour rendre aMule 'multi-plateforme'. (Windows, Linux et Mac OS X sont des plateformes)

  1. La source de wxMac est dispo ici : [1]
  2. Décompressez l' archive (double-cliquez dessus)

aMule

  1. Obtenez quotidiennement la source SVN d'aMule: aMule SVN
  2. 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 wxMac).

Compiler wxMac

cette étape ne sera effectuée qu'un fois, même si par la suite, vous compilez des SVN plus récents d' aMule.

Les instructions suivantes considèrent que vous avez placé les packages dans le dossier Bureau.
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 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 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-svn
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-svn" vers Applications (par exemple).