Why make donate

Environnement de développement

Environnement d'exécution

Bien entendu, il est indispensable d'installer l'application comme spécifié dans .

Maven

SimExplorer-IS utilise Maven2 comme outil de build. Ainsi, il est nécessaire d'installer Maven 2.0.8 sur le poste de développement. Aucune configuration spéciale n'est à prévoir.

Voir http://maven.apache.org/download.html

Maven suffit pour compiler et packager l'application.

Eclipse

Le développement du projet a été en partie réalisée avec Eclipse 3.3. La version simple Java est suffisante pour ce projet.

Tous les modules sont inclus dans un seul projet, chaque module ayant ses entrées dans le classpath. Ce fichier est présent dans Subversion, le fichier généré par le plugin Maven n'étant pas compatible avec certains aspects des fonctionnalités Maven utilisées.

Plugins

Les dépendances sont gérées avec le plugin Maven pour Eclipse. Il est nécessaire de l'installer via l'update site http://m2eclipse.codehaus.org/update-dev

La gestion de version se fait avec le plugin Subclipse, installable via l'update site http://subclipse.tigris.org/update_1.2.x

Enfin, le module web peut être lancé en mode debug depuis Eclipse grâce à Jetty Launcher (update site : http://run-jetty-run.googlecode.com/svn/trunk/updatesite). Le "Webapp dir" étant simexplorer-is-web/src/main/webapp/META-INF quand on créé une configuration de debug. Ce plugin permet d'éditer le site Tapestry en appliquant les modifications en temps réél (modification de classe, de page, de properties, ...).

Débuggage

Le module Swing avec le débugger natif d'Eclipse. Le module Web est débuggé par le plugin RunJettyRun.

Le module Service est débuggé via une connexion tcp sur le serveur JBoss. Dans le module simexplorer-is-ear, on peut trouver trois scripts :

  • rundebug.sh : ce fichier est à copier dans le dossier de JBoss (/opt/java/jboss-4.2.2.GA/bin/)
  • deploy.sh : exécute la commande Maven mvn -o clean package jboss:harddeploy. Il va ainsi construire l'EAR et le mettre dans le dossier deploy du serveur
  • debug.sh : lance le script rundebug.sh, avec le serveur simexplorer. Ainsi, un port 8787 est ouvert, permettant à Eclipse de s'y connecter afin de permettre le débuggage.

Packaging

Liste des principales commandes Maven :
  • mvn clean : nettoye le dossier target
  • mvn compile : génère et compile les classes
  • mvn package : créé les archives des modules
  • mvn install : installe les modules dans le dépôt Maven local
  • mvn deploy : déploie les modules dans le dépôt Maven Libre-Entreprise
Options générales :
  • -U : force la mise à jour de tous les artifacts
  • -o : travail hors ligne, pour utiliser uniquement le dépôt local
reStructuredText
google analytics