Jar mn

Structure du fichier

On y indique les fichiers .jar, suivit des fichiers à y inclure. Un fichier par ligne. Chaque ligne est composé de 3 parties.

1. un symbole facultatif + des espaces.
2. le nom du fichier sous lequel le fichier sera stocké et son chemin qu'il y aura dans le fichier jar
3. le fichier lui même et son chemin dans le repertoire des sources, relatif au fichier jar.mn

extrait d'un fichier jar.mn que l'on peut trouver dans les sources de Mozilla :

 comm.jar:
 *   content/cookie/contents.rdf                    (resources/content/contents.rdf)
     content/cookie/cookieTasksOverlay.xul          (resources/content/cookieTasksOverlay.xul)
     content/cookie/cookieNavigatorOverlay.xul      (resources/content/cookieNavigatorOverlay.xul)

 modern.jar:
     skin/modern/communicator/cookie/taskbar-cookie.gif          (resources/skin/modern/taskbar-cookie.gif)
     skin/modern/communicator/cookie/status-cookie.gif          (resources/skin/modern/status-cookie.gif)

 classic.jar:
     skin/classic/communicator/cookie/taskbar-cookie.gif         (resources/skin/classic/taskbar-cookie.gif)
     skin/classic/communicator/cookie/status-cookie.gif          (resources/skin/classic/status-cookie.gif)

Signification du symbole, au choix :

• une étoile pour indiquer qu'il faut que le fichier passe par le preprocesseur avant l'inclusion dans l'archive (on peut ainsi mettre des directives de "compilation" dans les fichiers XUL, CSS etc..)
• un plus pour indiquer que ce fichier remplace une version déjà incluse par d'autres fichiers jar.mn.
• juste des espaces : rien de spécial à faire

Noter que le chemin peut être un chemin absolu , pris à partir de la racine des sources de mozilla :

  chemin/dans/jar/nom_du_fichier.xul     (/chemin/dans/sources/nom_du_fichier.xul)

En ce qui concerne le preprocesseur, on peut y mettre bien sur des #ifdef, #ifndef ou #endif. Attention à ne pas mettre d'éspace à la fin de ces lignes de preprocesseurs, sinon le preprocesseur indiquera une erreur.

Pour la doc des directives que l'on peut inclure dans ses fichiers XUL : http://lxr.mozilla.org/seamonkey/source/(..)

Enregistrement Chrome

Les instructions d'enregistrement chrome sont marquées avec signe de pourcentage au début de la ligne, et doivent faire partie de la définition d'un fichier JAR. Les signes de pourcentage supplémentaires rencontrés dans la ligne sont remplacés avec l'URL relative du fichier JAR qui est traité.

 % content global %chemin/dans/jar/
 % overlay [[chrome://blah/content/blah.xul]] [[chrome://foo/content/overlay.xul]]

Il ya deux emplacements possibles pour un fichier manifest. Si le chrome est construit pour une application indépendante, le processeur de jar.mn crée un <fichierjar>.manifest avec le fichier lui-même. Il s'agit du comportement par défaut.

Si le Makfile spécifie USE_EXTENSION_MANIFEST = 1, le processeur crée un simple chrome.manifest adapté à l'enrgistrement chrome comme une extension.