Préalables à la compilation sous Windows

NOTE: Do not make substantive changes to this document without consulting Benjamin Smedberg <[email protected]> or one of the build-config peers.

Ce document est un guide de l'environnement MozillaBuild, qui fonctionne avec les versions suivantes du code source de Mozilla :

• Tronc (1.9/Firefox 3)
• MOZILLA_1_8_BRANCH (1.8.1.2/Firefox 2.0.0.2 ou supérieur)
• MOZILLA_1_8_0_BRANCH (1.8.0.10/Firefox 1.5.0.10 ou supérieur)

Cet environnement fonctionne avec les compilateurs suivants :

Pour la compilation de versions plus anciennes du code source, consultez les Préalables à la compilation sous Windows avec cygwin. Si vous désirez compiler de très anciennes version du code source de Mozilla, depuis la branche 1.0 ou plus anciennes, suivez les instructions de compilation avec nmake.

Matériel nécessaire

Mozilla prend du temps à compiler. Vous aurez besoin d'un système adapté au développement :

• Processeur Pentium III ou équivalent, 1 GHz ou plus
• 512 Mo de RAM, 1 Go ou plus recommandés
• 1,5 Go d'espace disque NTFS ou 3 Go d'espace disque FAT, ou plus
• Windows 2000 SP4 ou plus

Logiciels nécessaires

Les logiciels suivants doivent être installés pour une compilation Windows standard.

Mozilla peut ne pas compiler si certains de ces outils sont installés dans un chemin contenant des espaces ou d'autres caractères non alphanumériques comme des plus, des guillemets ou caractères spéciaux. Les outils Visual C++ peuvent cependant être installés dans un répertoire contenant des espaces (préférez l'emplacement d'installation par défaut).

Microsoft Visual C++ et le SDK Windows

L'édition professionnelle de Microsoft Visual C++ version 7.1 et 8 (Visual Studio 2003 et 2005) sont des solutions complètes.

Pour Microsoft Visual C++ version 6, vous aurez besoin du Service Pack 5 et du processor pack. Notez que, même s'il intègre le Processor Pack, le Service Pack 6 ne fonctionnera pas !

L'édition gratuite de Microsoft Visual C++ 8 (ou Visual C++ 2005 Express Edition) fonctionnera aux conditions suivantes :

• Vous devrez installer l'environnement de développement graphique en plus des outils en ligne de commande.
• Vous aurez également besoin du Windows Platform SDK. Vous devrez installer le « Windows Core SDK » (outils, environnement de compilation et composants redistribuables) ainsi que le « Web Workshop SDK » (environnement de compilation).

MozillaBuild

Le package MozillaBuild contient tous les autres logiciels nécessaires pour compiler Mozilla. Parmi ceux-ci, on retrouve l'environnement de compilation MSYS, python, NSIS, UPX, ainsi que certains outils optionnels/utiles comme wget, autoconf-2.13 et xemacs.

Téléchargement du package MozillaBuild actuel.

Par défaut, le package s'installe dans c:\mozilla-build. Il est recommandé d'utiliser le chemin par défaut. Le programme d'installation ne modifie pas la base de registres de Windows.

Lancement d'une ligne de commande pour compiler

Une fois tous les logiciels nécessaires installés, lancez un des fichiers batch suivants depuis le répertoire c:\mozilla-build :

• start-msvc6.bat
• start-msvc71.bat
• start-msvc8.bat

Si vous compilez sous Windows Vista, lancez le fichier batch en tant qu'Administrateur (Cliquez avec le bouton de droite et sélectionnez « Exécuter comme administrateur ») pour prévenir des erreurs de compilation.

Problèmes courants, astuces et restrictions

• Consultez la FAQ suir la compilation de Mozilla, vous y trouverez une liste des problèmes de compilation les plus courants.
• La compilation peut échouer si votre variable d'environnement PATH contient des guillemet ("). Les guillemets ne sont pas correctement transformés lorsqu'ils sont passés aux sous-shells cygwin. Ils ne sont habituellement pas nécessaires et peuvent donc être enlevés.
• FAQ sur le débogage de Mozilla sous Windows : astuces sur le débogage de Mozilla sous Windows.