31/12/2008

Créer un 'jar' avec Eclipse

Pour Créer l'archive 'jar' à partir d'un projet Eclipse, il faut commencer par faire un clic droit puis sélectionner 'Export'. On accède alors à la fenêtre de création de l'archive (cf. capture écran).

exportJar.png

Il est préférable de choisir un emplacement extérieur au projet pour sauvegarder le 'jar'. car le répertoire d'export doit être exclus du contenu du jar.

L'utilisation d'un fichier 'jardesc' permet de préciser et de sauvegarder les paramètres de création du jar d'un projet Eclipse. On gagne ainsi en simplicité et en fiabilité. Pour créer le fichier 'jardesc', il faut choisir l'emplacement du fichier dans la deuxième page du formulaire de création du jar (cf. capture écran):

jardesc.png

La troisième page permet de choisir les options relatives au 'manifest' associée à l'archive jar. Pour rappel, le manifest d'un jar contient principalement le nom de la classe qui contient la méthode 'main()', soit le point d'entrée de l'application.

Une fois que le fichier  'jardesc' est créé, il suffit alors de faire 'clic droit sur le fichier jardesc > create jar'.

Le fichier 'jardesc' peut être édité et modifié. Les paramètres inclus dans le fichier 'jardesc' sont:
  • L'emplacement pour le jar à exporter: <jar path="...">
  • Les fichiers et répertoires à exporter: <selectedElements>
  • Les options relatives au fichier 'manifest' du jar: <manifest>
  • Et diverses options: <options>

Références:

Auteur: Euan MATEO

18/07/2008

Le format JAR

JAR est en fait une abréviation pour 'Java ARchive'. Comme son nom l'indique, ce format permet de manipuler des archives qui regroupent plusieurs fichiers. C'est un format qui est comparable aux formats ZIP et RAR.  

Tout d'abord, avant de commencer, je vais préciser ce qu'est un fichier 'manifest', car ce sera très utile pour la suite. Le fichier manifest est un fichier texte dans lequel se trouve des informations sur le contenu de l'archive. Un fichier manifest est créé par défaut, mais il vaut mieux en créer un. Lors de l'archivage, le fichier manifest de l'utilisateur est automatiquement transformé en fichier 'META-INF/MANIFEST.MF'.

Le point d'entrée des classes de l'archive, c'est à dire la fonction 'main', sera spécifié dans le fichier 'manifest' avec la commande suivante: 'Main-Class: nomDeClasse'

Avec le format JAR il est possible de:

  •  Créer une archive JAR

Pour créer une archive au format JAR, il faut utiliser la commande 'jar' avec les options adéquates.  'c' pour créer une archive, 'f' pour spécifier le nom de l'archive qui sera créée, 'm' pour préciser le fichier 'manifest', et éventuellement 'C' pour que l'arborescence des fichiers inclus dans le jar ne soit pas conservée. Ce qui donne:
'jar cfm myManifest Hello.jar -C build/classes/monPackage/*.class'

  • Visualiser le contenu d'une archive

Toujours avec la commande jar, mais avec l'option 't', on peut afficher tout le contenu d'une archive:
'jar tf monArchive.jar'

  • Extraire le contenu d'une archive

L'option de la commande qui permet d'extraire le contenu d'une archive JAR, est 'x':
'jar xf monArchive.jar'

  • Mettre à jour le contenu

Avec l'option 'u': 'jar uf monArchive.jar fichersARajouter'
C'est expliqué plus en détail ICI

  • Exécuter une archive

Pour ce faire, il faut lancer la commande d'exécution 'java' avec l'option 'jar': 'java -jar monArchive.jar'

 

Ressources :

Auteur: Euan MATEO