Compilation et installation

Se réferer à la page suivante pour la compilation de Thunderbird (utilisation de l'outil Mach recommandée) : Simple Thunderbird build

Ne commencez pas à compiler sans configurer vos options de compilation au préalable !

Build Instructions:

Compilation

Vous devez utiliser GNU make pour récupérer et compiler Mozilla. Aucun autre programme « make » n'est acceptable. Sous Windows, Mac OS X et Linux, utilisez « make » pour lancer GNU make ; sur la plupart des systèmes UNIX non-GNU, utilisez « gmake ».

Une fois les sources récupérées, assurez-vous de configurer une application comme décrit sur la page Configuration des options de compilation.

Pour Windows, Mac OS X et GNU/Linux, assurez-vous d'être dans le répertoire principal des sources (le répertoire « mozilla »), avant d'invoquer la commande make :

$ make -f client.mk build

Note pour Mac OS X : le chemin vers le répertoire des sources créé à la décompression du tarball des sources ne doit pas contenir d'espaces !

Pour la plupart des UNIX non-GNU, la commande est :

$ gmake -f client.mk build

Si vous désirez configurer et compiler manuellement, placez-vous (cd) dans votre répertoire objdir, lancez configure, et ensuite make/gmake. Configure récupèrera cependant toujours les options spécifiées dans votre fichier .mozconfig.

Lancement de votre nouvelle application

Il est possible d'exécuter votre nouvelle application directement depuis le répertoire dans lequel elle a été compilée. Cependant, le répertoire de compilation peut contenir des liens symboliques vers l'arbre de compilation ; vous devez passer par l'étape d'installation/packaging pour produire une applicationstandalone qui peut être partagée ou déplacée.

Windows et Linux

Sur les systèmes de compilation non-Macintosh, l'application finale peut être trouvée dansobjdir /dist/bin. Sur les plateformes POSIX (BSD, GNU/Linux, Solaris), vous devrez exécuter le fichier « mozilla » ou « firefox », pas le binaire « mozilla-bin » ou « firefox-bin ».

Mac OS X

Sous Macintosh, le système de compilation produit un bundle d'application dansobjdir /dist/AppName .app, par exempleobjdir /dist/Minefield.app.

Veuillez noter que lorsque vous compilez avec --enable-debug, l'application est placée dansobjdir /dist/AppName Debug.app, par exemple.objdir /dist/MinefieldDebug.app.

Vous pouvez exécuter l'application soit en ouvrant le bundle à partir du Finder, soit depuis la ligne de commande à l'aide de

$ objdir/dist/AppName[Debug].app/Contents/MacOS/appname

par exemple :

$ objdir/dist/MinefieldDebug.app/Contents/MacOS/firefox

Construction d'un .dmg pour une compilation XULRunner

Ces instructions concernent la construction d'un fichier .dmg depuis une compilation Mac OS X Universal binary.

Effectuez une compilation Universal Binary
Créez les fichiers source chown_root.c et chown_revert.c depuis mxr:chown_root.c et mxr:chown_revert.c
Utilisez gcc pour compiler ces fichiers quelque part : gcc -o chown_root chown_root.c et gcc -o chown_revert chown_revert.c
Rendez-vous dans «objdir»/«arch»/xulrunner/installer et entrez make CHOWN_ROOT=«chemin_absolu_vers_votre_root_chown» CHOWN_REVERT=«chemin_absolu_vers_votre_binaire_inverse_chown»

Ceci devrait vous construire un binaire dans «arch»/dist.

Installation de votre application

Sur les plateformes POSIX, vous pouvez installer votre application dans le système en lançantgmake install . Cependant, ce n'est pas recommandé et il est préférable de suivre les instructions suivantes pour créer un tarball, et de décompresser ensuite ce tarball.

Pour le tronc (Firefox 3)

Pour les compilations du tronc, vous pouvez simplement exécuter make package dans votre répertoire objet pour créer une compilation empaquetée. Ceci créera un fichier zip ou tar.gz dans objdir/dist que vous pourrez ensuite décompresser n'importe où. Pour compiler un installeur Windows, utilisez simplement make installer dans votre répertoire objet.

Pour la branche 1.8 (Firefox 2)

Pour la plupart des applications, préparez un tarball/zip de votre application en faisant dans un répertoire spécifique à l'application :

Firefox : $ make -C objdir/browser/installer
Thunderbird : $ make -C objdir/mail/installer
SeaMonkey : $ make -C objdir/xpinstall/packager

Pour créer un installeur Windows, lancez make avec le target « installer » dans le répertoire évoqué plus haut:

Firefox : $ make -C objdir/browser/installer installer
Thunderbird : $ make -C objdir/mail/installer installer
SeaMonkey : $ make -C objdir/xpinstall/packager installer

Note : Pour réaliser l'installeur fortement compressé utilisé par Firefox et Thunderbird avec un système de compilation basé sur Cygwin, vous devrez installer quelques programmes additionnels :

7-zip
UPX (pour les utilisateurs de Windows : ce programme est disponible dans l'installation de Cygwin, vous pouvez l'installer à partir de là (catégorie Utils). N'utilisez pas la version DOS, elle ne fonctionnera pas)

Ces deux utilitaires doivent être accessibles depuis le PATH. De plus, la variable MOZ_INSTALLER_USE_7ZIP doit être définie dans votre environnement. Si vous utilisez le système de compilation MozillaBuild, 7-Zip et UPX seront installés automatiquement.