Installation requise

Pour générer l'installeur de Fudaa-Mascaret, les serveurs ( exécutable mascaret) doivent être disponible et être situé au même niveau que le dossier fudaa-mascaret contenant les sources java de mascaret.Voici un aperçu de l'arborescence:

Dans la suite du document, on suppose que les sources du projet Fudaa-Mascaret sont disposées dans le répertoire fudaa-mascaret.

Comment fonctionne la génération de l'installeur

Ressources

Toutes les ressources nécessaires sont présentes dans fudaa-mascaret/distrib/src.

• Le fichier fudaa-mascaret\distrib\src\assemble\all.xml contient la configuration nécessaire à Maven pour construire le jar exécutable de Fudaa-Mascaret
• Le répertoire fudaa-mascaret\distrib\src\dist contient toutes les ressources nécessaires pour construire l'installeur izpack.
• Le fichier fudaa-mascaret/build.xml contient la configuration ant permettant de lancer la génération de l'installeur depuis Maven

Comment générer un jar d'installation

Le profil release de Maven permet de générer le fichier jar d'installation. Il suffit de lancer la commande suivante dans le dossier fudaa-mascaret

mvn -Prelease clean install 

Le jar d'installation se trouve dans le dossier \fudaa-mascaret\distrib\target et se nomme Fudaa_Mascaret<Version>_Setup.jar

Le numéro de version et la date de génération sont automatiquement utilisé dans le jar d'installation. Le numéro de version est issu des fichiers pom du projet Fudaa-Mascaret.

Normalement, pour faire une version officielle, il faudrait utiliser le système de release de Maven: voir le chapitre "Faire une release" dans le document  Utilisation "basique" de Maven et de Hudson

mvn release:prepare
mvn -Prelease release:perform

Cette action incrémente automatiquement la version du projet et tag les sources dans le gestionnaire de sources de Fudaa.