Configurer mozilla pour developper

Environnement de développement

Pour développer, on ne fait pas de package XPI pour son extension. Ce serait beaucoup trop lourd. À la place, on dépose ses fichiers dans un répertoire/dossier quelconque (ou directement dans le répertoire chrome) et on déclare ce répertoire/dossier dans l'application.

Pour le développement, il faut obligatoirement utiliser un profil spécifique si vous utilisez déjà l'application en question pour vos besoins personnels. Par exemple, pour développer une extension pour Firefox, vous aurez besoin d'une première instance de (Firefox) pour pouvoir surfer, consulter de la documentation et d'une deuxième instance pour développer et tester votre application. L'utilisation de deux navigateurs permet de ne pas à avoir à recharger toutes les pages web que l'on consulte en parallèle du développement. En effet, les tests de l'application nécessitent de la relancer souvent, suite à un plantage ou pour prendre en compte vos modifications.

Pour avoir "deux" firefox, vous aurez donc besoin de deux profils : un pour surfer, l'autre pour développer. Cela évite en plus d'une éventuelle destruction de vos données personnelles si dans votre extension vous manipulez les données du profil.

Installation de Firefox

Sous linux

Si vous êtes sous Linux, évitez, pour le développement, d'utiliser le paquetage Firefox fourni avec votre distribution. Vous utiliserez le Firefox de votre distribution uniquement pour le surf et autre activité. En effet, il y a déjà eu des problèmes (notamment pour la déclaration dans le chrome) car les fichiers des paquetages ne sont pas accessibles en écriture, ou ils sont éparpillés sur le disque, ce qui n'est pas pratique.

Il vous faut donc installer une autre version Firefox fournie sous forme d'un fichier tar.gz sur le ftp de Mozilla.org. Vous l'installerez dans votre répertoire home, avec votre login afin d'avoir tous les privilèges sur les fichiers de cette installation.

Sous Windows

L'installateur de Firefox n'est disponible que sous forme d'exécutable (pas de zip). Cependant ce n'est pas un problème. Installez-le si ce n'est pas déjà fait.

Création d'un profil de test

Quand on lance deux instances d'une même application Mozilla, elles utilisent le même profil. Pour éviter d'éventuels dégâts dans votre profil personnel, il vaut mieux utiliser un profil de test pour le Firefox qui sert au développement (nous l'appellerons le profil « firefoxdev »).

Pour créer un profil de test, ouvrez une ligne de commande :

 # firefox -CreateProfile test

Ensuite, pour utiliser le firefox avec votre profil :

 # firefox -P default

Et pour celui qui sert au développement

 # firefox -P test

Dans votre environnement graphique (windows, kde,...), vous pouvez vous créer deux icônes sur le bureau pour lancer Firefox et spécifier ces paramètres supplémentaires.

Configuration du profil de test

Dans le fichier prefs.js du profil test, il faut spécifier quelques options qui facilitent le déboggage. Elles sont indispensables si on ne veut pas tourner en rond pendant des heures à rechercher la cause d'un dysfonctionnement.

(Les profils sont stockés dans /home/votrecompte/.mozilla/firefox/ pour Linux, et dans c:\Documents and Settings\votrecompte\Application Data\Mozilla\Firefox\Profiles pour Windows)

Ajoutez au fichier les lignes suivantes :

 user_pref("nglayout.debug.disable_xul_cache", true); // désactive le cache XUL
 user_pref("nglayout.debug.disable_xul_fastload", true); // lié au précédent, facultatif
 user_pref("javascript.options.strict", true); // active l'affichage de toutes les erreurs d'exécutions
 user_pref("javascript.options.showInConsole", true); // active l'affichage de toutes les erreurs de syntaxe
 user_pref("browser.dom.window.dump.enabled", true); // active le dump sur la console

Lancement de l'application dans le navigateur

Cette solution est la plus pratique car l'application va s'afficher comme une page web, et on pourra faire des rafraîchissements de la fenêtre pour recharger instantanément l'application en cours de modification.

On lance donc Firefox comme suit :

 firefox -P test -console -jsconsole -no-remote -chrome [[chrome://browser/content/]]

Remarque : on peut créer un raccourci sous windows ou KDE

Ensuite, dans la barre d'URL du navigateur, tapez :

 [[chrome://monappli/content/monappli.xul]]

L'application s'affiche dans la fenêtre de votre navigateur.

Vous pouvez aussi déclarer un overlay, qui ajoutera un bouton dans la toolbar, ou un item de menu, et sur les commandes de ces boutons, faire un window.open("chrome://monappli/content/monappli.xul",(..); pour ouvrir votre application dans une nouvelle fenêtre indépendante.

Lancement de l'application seule

La procédure est sensiblement la même, à la différence de l'adresse du chrome au démarrage :

 firefox -P test -console -jsconsole -no-remote -chrome [[chrome://monappli/content/monappli.xul]]

Ce mode de lancement peut être utile dans certains cas, quand vous n'avez pas d'overlay (donc affichez l'application dans la partie browser), et lorsque vous voyez que certains événements ou commandes ne sont pas générés, lorsque des glisser-déposer s'avèrent difficiles etc. En effet, le navigateur intercepte certains événements pour ses propres besoins, ce qui peut empêcher votre application de fonctionner correctement. Il faut donc la lancer hors navigateur comme indiqué.

Lancement de l'application après le développement

Quand votre extension/application est terminée, vous pouvez créer ce raccourci :

 firefox -chrome [[chrome://monappli/content/]] -nosplash

Vous pouvez aussi, grâce aux overlays, ajouter un élément de menu (menuitem) ou un bouton dans la barre des boutons (toolbar) de Firefox pour lancer l'application.